docs: add migration guide for 1.4

[willkill07]

Description

• Adds per-user functions to notable new features in README
• Adds migration guide notes for the 1.4 release

Closes

By Submitting this PR I confirm:

• I am familiar with the Contributing Guidelines.
• We require that all contributors "sign-off" on their commits. This certifies that the contribution is your original work, or you have rights to submit it under the same license, or a compatible license.
  • Any contribution which contains commits that are not Signed-Off will not be accepted.
• When the PR is ready for review, new or existing tests cover these changes.
• When the PR is ready for review, the documentation is up to date with these changes.

Summary by CodeRabbit

• Documentation
  • Added "Per-User Functions" documentation describing deferred instantiation and per-user stateful resources.
  • Published v1.4.0 migration guide covering namespace and naming changes, function group migrations, secret-handling guidance, API and model migration notes, packaging updates, and frontend/refactor guidance.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Walkthrough

Added two documentation entries: a "Per-User Functions" item in README and a new v1.4.0 "Version Specific Changes" section in the migration guide detailing migration notes and configuration/namespace updates. No code or API behavior changes.

Changes

Cohort / File(s)	Summary
Documentation Updates README.md, docs/source/resources/migration-guide.md	Inserted "Per-User Functions" documentation link and added a comprehensive v1.4.0 migration section covering namespaces, function-group naming, secret handling, Zep Cloud and LLM/embedder model changes, per-user instantiation notes, config field removals, frontend/package relocation, and packaging/dependency notes.

Sequence Diagram(s)

(omitted)

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'docs: add migration guide for 1.4' is concise, descriptive, uses imperative mood, and directly summarizes the main changes (migration guide additions) in the pull request.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@README.md`:
- Line 52: Add a user-facing changelog entry for the new "Per-User Functions"
feature to CHANGELOG.md: locate the current release section where user-visible
features are documented (e.g., the "Unreleased" or the matching version heading)
and add a short bullet noting "Per-User Functions: NeMo Agent Toolkit now
supports per-user functions for deferred instantiation, enabling per-user
stateful functions, per-user resources, and other features" so the README change
is reflected in the project changelog.

🧹 Nitpick comments (1)

docs/source/resources/migration-guide.md (1)

30-111: Avoid hard-coded version numbers in docs.

This new block hard-codes versions (e.g., “v1.4.0”, “v3”, “3.0”), which conflicts with the guideline that version numbers must not be hard-coded in documentation. Please rephrase to avoid explicit version strings or use a docs substitution/variable if available.

♻️ Possible rewrite approach

-### v1.4.0
+### Current release

-#### Zep Cloud v3 Migration
+#### Zep Cloud major-version migration

-- Upgrade your dependency to `zep-cloud~=3.0`.
+- Upgrade your dependency to the latest supported `zep-cloud` major release.

As per coding guidelines: “Version numbers are derived automatically by setuptools-scm; never hard-code them in code or docs.”

[willkill07]

/merge