npm - veryfront - Versions diffs - 0.1.996 → 0.1.998 - Mend

veryfront 0.1.996 → 0.1.998

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (380) hide show

package/esm/cli/templates/manifest.js CHANGED Viewed

@@ -53,7 +53,7 @@ export default {
                 "app/api/uploads/[id]/route.ts": "import { createUploadHandler } from \"veryfront/embedding\";\nimport { store } from \"../../../../store.ts\";\n\nexport const { DELETE } = createUploadHandler(store, {\n  auth: { type: \"none\", allowUnauthenticated: true },\n});\n",
                 "app/api/uploads/route.ts": "import { createUploadHandler } from \"veryfront/embedding\";\nimport { store } from \"../../../store.ts\";\n\nexport const { POST, GET } = createUploadHandler(store, {\n  auth: { type: \"none\", allowUnauthenticated: true },\n});\n",
                 "app/layout.tsx": "import \"../globals.css\";\nimport { Head } from \"veryfront/head\";\n\nexport default function RootLayout({ children }: { children: React.ReactNode }): React.ReactNode {\n  return (\n    <>\n      <Head><title>Docs Agent</title></Head>\n      <div className=\"flex flex-col h-screen\">\n        {children}\n      </div>\n    </>\n  );\n}\n",
-                "app/page.tsx": "'use client'\n\nimport { useState, useEffect, useCallback, useMemo } from 'react'\nimport { ChatWithSidebar, useChat, type QuickAction } from 'veryfront/chat'\n\nconst UPLOAD_API = '/api/uploads'\nconst ACCEPT = '.pdf,.doc,.docx,.xls,.xlsx,.ppt,.pptx,.csv,.txt,.md,.mdx,.html,.rtf,.epub,.json,.xml'\n\nconst QUICK_ACTIONS: QuickAction[] = [\n  { id: 'ask-question', label: 'Ask Question', prompt: 'I have a question about this document: ' },\n  { id: 'extract-insights', label: 'Extract Insights', prompt: 'Extract the key insights from the uploaded documents.' },\n  { id: 'find-sources', label: 'Find Sources', prompt: 'Find relevant sources and references in the documents for: ' },\n]\n\ninterface Doc { id: string; title: string; source: string; url?: string }\n\nfunction useUploads(api: string) {\n  const [docs, setDocs] = useState<Doc[]>([])\n  const [uploading, setUploading] = useState(false)\n  const [error, setError] = useState<string | null>(null)\n\n  const refresh = useCallback(async () => {\n    try {\n      const res = await fetch(api)\n      if (res.ok) {\n        const data = await res.json()\n        setDocs(Array.isArray(data) ? data : data.uploads ?? [])\n      }\n    } catch { /* ignore */ }\n  }, [api])\n\n  useEffect(() => { refresh() }, [refresh])\n\n  const upload = useCallback(async (file: File) => {\n    setUploading(true)\n    setError(null)\n    try {\n      const form = new FormData()\n      form.append('file', file)\n      const res = await fetch(api, { method: 'POST', body: form })\n      if (!res.ok) throw new Error(await res.text())\n      await refresh()\n    } catch (e) {\n      setError(e instanceof Error ? e.message : 'Upload failed')\n    } finally {\n      setUploading(false)\n    }\n  }, [api, refresh])\n\n  const remove = useCallback(async (id: string) => {\n    await fetch(`${api}/${id}`, { method: 'DELETE' })\n    await refresh()\n  }, [api, refresh])\n\n  const uploads = useMemo(\n    () => docs.filter((d) => d.source.startsWith('upload:')),\n    [docs],\n  )\n\n  return { uploads, uploading, error, upload, remove }\n}\n\nexport default function DocsChat() {\n  const chat = useChat({ api: '/api/ag-ui' })\n  const docs = useUploads(UPLOAD_API)\n\n  const attachmentItems = useMemo(() => {\n    const items = docs.uploads.map((d) => ({\n      id: d.id,\n      name: d.title,\n      status: 'ready' as const,\n    }))\n    if (docs.uploading) {\n      items.push({ id: '__uploading', name: 'Uploading...', status: 'uploading' as const })\n    }\n    return items\n  }, [docs.uploads, docs.uploading])\n\n  const uploadFiles = useMemo(\n    () => docs.uploads.map((d) => ({ id: d.id, name: d.title, url: d.url })),\n    [docs.uploads],\n  )\n\n  const handleAttach = useCallback((files: FileList) => {\n    for (const file of Array.from(files)) {\n      docs.upload(file)\n    }\n  }, [docs.upload])\n\n  const handleQuickAction = useCallback((action: QuickAction) => {\n    if (action.prompt) chat.setInput(action.prompt)\n  }, [chat.setInput])\n\n  return (\n    <ChatWithSidebar\n      chat={chat}\n      sidebar={{ storageKey: 'rag-threads' }}\n      features={{ steps: true, tabs: true, sources: true, export: true }}\n      models={{\n        options: [\n          {\n            value: 'anthropic/claude-sonnet-4-6',\n            label: 'Claude Sonnet',\n          },\n          {\n            value: 'openai/gpt-4.1-mini',\n            label: 'GPT-4.1 Mini',\n          },\n          {\n            value: 'google/gemini-2.5-flash',\n            label: 'Gemini 2.5 Flash',\n            badge: 'Fast',\n          },\n        ],\n      }}\n      attachments={{\n        uploads: uploadFiles,\n        onRemoveUpload: docs.remove,\n        onAttach: handleAttach,\n        accept: ACCEPT,\n        items: attachmentItems,\n        onRemoveItem: docs.remove,\n      }}\n      quickActions={{\n        actions: QUICK_ACTIONS,\n        onAction: handleQuickAction,\n      }}\n      message={{\n        renderTool: () => null,\n      }}\n      className=\"flex-1 min-h-0\"\n      placeholder=\"Ask anything about your documents...\"\n      emptyState={{ title: 'Docs Agent', description: 'Upload files and ask questions' }}\n    />\n  )\n}\n",
+                "app/page.tsx": "'use client'\n\nimport { useCallback, useMemo } from 'react'\nimport {\n  Chat,\n  ChatSidebar,\n  ChatThemeScope,\n  ConversationsProvider,\n  useChat,\n  useUploadsRegistry,\n} from 'veryfront/chat'\n\nconst UPLOAD_API = '/api/uploads'\nconst ACCEPT = '.pdf,.doc,.docx,.xls,.xlsx,.ppt,.pptx,.csv,.txt,.md,.mdx,.html,.rtf,.epub,.json,.xml'\n\nconst SUGGESTIONS = [\n  {\n    label: 'Ask Question',\n    prompt: 'I have a question about this document: ',\n  },\n  {\n    label: 'Extract Insights',\n    prompt: 'Extract the key insights from the uploaded documents.',\n  },\n  {\n    label: 'Find Sources',\n    prompt: 'Find relevant sources and references in the documents for: ',\n  },\n]\n\nconst MODELS = [\n  {\n    value: 'anthropic/claude-sonnet-4-6',\n    label: 'Claude Sonnet',\n  },\n  {\n    value: 'openai/gpt-4.1-mini',\n    label: 'GPT-4.1 Mini',\n  },\n  {\n    value: 'google/gemini-2.5-flash',\n    label: 'Gemini 2.5 Flash',\n    badge: 'Fast',\n  },\n]\n\nfunction DocsChatSurface() {\n  const chat = useChat({ api: '/api/ag-ui' })\n  const uploads = useUploadsRegistry({ url: UPLOAD_API, storageKey: 'rag-uploads' })\n\n  const suggestionLabels = useMemo(\n    () => SUGGESTIONS.map((suggestion) => suggestion.label),\n    [],\n  )\n\n  const handleSuggestionClick = useCallback((label: string) => {\n    const suggestion = SUGGESTIONS.find((item) => item.label === label)\n    chat.setInput(suggestion?.prompt ?? label)\n  }, [chat.setInput])\n\n  return (\n    <ChatThemeScope className=\"flex h-screen min-h-0\">\n      <ChatSidebar className=\"w-72 shrink-0 border-r border-[var(--border)]\" />\n      <Chat\n        chat={chat}\n        showSteps\n        showTabs\n        showSources\n        agent={{\n          name: 'Docs Agent',\n          description: 'Upload files and ask questions',\n          models: MODELS,\n        }}\n        suggestions={suggestionLabels}\n        onSuggestionClick={handleSuggestionClick}\n        uploads={uploads.items}\n        onRemoveUpload={uploads.remove}\n        onAttach={uploads.upload}\n        onDrop={uploads.upload}\n        attachAccept={ACCEPT}\n        className=\"flex-1 min-h-0\"\n        placeholder=\"Ask anything about your documents...\"\n        emptyState={{ title: 'Docs Agent', description: 'Upload files and ask questions' }}\n      />\n    </ChatThemeScope>\n  )\n}\n\nexport default function DocsChat() {\n  return (\n    <ConversationsProvider storageKey=\"rag-conversations\">\n      <DocsChatSurface />\n    </ConversationsProvider>\n  )\n}\n",
                 "content/architecture.md": "# Architecture\n\nAcme Platform uses a modular, event-driven architecture.\n\n## Core Components\n\n### API Gateway\nRoutes incoming requests to the appropriate microservice. Handles authentication, rate limiting, and request validation.\n\n### Event Bus\nAsynchronous message broker connecting all services. Supports pub/sub and point-to-point messaging patterns.\n\n### Data Layer\nMulti-tenant data storage with automatic sharding. Supports PostgreSQL for relational data and Redis for caching.\n\n## Request Flow\n\n1. Client sends request to API Gateway\n2. Gateway validates authentication token\n3. Request is routed to the target service\n4. Service processes request and publishes events\n5. Response is returned through the gateway\n\n## Scaling\n\nEach component scales independently. The API Gateway uses horizontal scaling with load balancing. Services auto-scale based on queue depth and CPU utilization.\n\n## Security\n\n- All inter-service communication uses mTLS\n- API tokens are rotated every 24 hours\n- Data at rest is encrypted with AES-256\n- Audit logs are retained for 90 days\n",
                 "content/getting-started.md": "# Getting Started\n\nWelcome to Acme Platform. This guide covers initial setup and core concepts.\n\n## Installation\n\nInstall the CLI globally:\n\n```bash\nnpm install -g @acme/cli\n```\n\n## Creating a Project\n\nRun the init command to scaffold a new project:\n\n```bash\nacme init my-project\ncd my-project\n```\n\n## Project Structure\n\n- `src/`: Application source code\n- `config/`: Configuration files\n- `tests/`: Test suite\n- `docs/`: Documentation\n\n## Configuration\n\nCreate an `acme.config.ts` file in your project root:\n\n```ts\nexport default {\n  name: \"my-project\",\n  region: \"us-east-1\",\n  features: [\"auth\", \"storage\"],\n};\n```\n\n## Next Steps\n\n- Read the [Architecture Guide](./architecture) to understand the system design\n- Check [API Reference](./api-reference) for available endpoints\n- Join our Discord community for support\n",
                 "globals.css": "@import \"tailwindcss\";\n",

package/esm/deno.d.ts CHANGED Viewed

@@ -20,6 +20,7 @@ declare namespace _default {
         "./chat/ag-ui": string;
         "./chat/protocol": string;
         "./chat/types": string;
+        "./chat/uploads": string;
         "./markdown": string;
         "./mdx": string;
         "./agent": string;
@@ -42,6 +43,7 @@ declare namespace _default {
         "./runs": string;
         "./skill": string;
         "./trigger": string;
+        "./task": string;
         "./schedule": string;
         "./webhook": string;
         "./mcp": string;
@@ -88,6 +90,7 @@ declare namespace _default {
         "veryfront/fonts": string;
         "veryfront/chat": string;
         "veryfront/chat/types": string;
+        "veryfront/chat/uploads": string;
         "veryfront/markdown": string;
         "veryfront/mdx": string;
         "veryfront/fs": string;
@@ -187,6 +190,7 @@ declare namespace _default {
         "#veryfront/chat/protocol": string;
         "#veryfront/chat/provider-errors": string;
         "#veryfront/chat/stream-watchdog": string;
+        "#veryfront/chat/uploads": string;
         "#veryfront/build": string;
         "#veryfront/cache": string;
         "#veryfront/config": string;
@@ -346,6 +350,9 @@ declare namespace _default {
         "coverage:html": string;
         bench: string;
         clean: string;
+        storybook: string;
+        "build:storybook": string;
+        "storybook:check": string;
         lint: string;
         fmt: string;
         "fmt:check": string;
@@ -367,6 +374,7 @@ declare namespace _default {
         "lint:ban-deep-imports": string;
         "lint:imports": string;
         "lint:ban-internal-root-imports": string;
+        "lint:chat-composability": string;
         "lint:style": string;
         "lint:cli-boundary": string;
         "validate:architecture": string;

package/esm/deno.js CHANGED Viewed

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.996",
+    "version": "0.1.998",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "minimumDependencyAge": {
@@ -59,6 +59,7 @@ export default {
         "dist/",
         "coverage/",
         "scripts/",
+        "storybook/",
         "examples/",
         "data/",
         ".deno_cache/",
@@ -76,6 +77,7 @@ export default {
         "./chat/ag-ui": "./src/chat/ag-ui.ts",
         "./chat/protocol": "./src/chat/protocol.ts",
         "./chat/types": "./src/chat/types.ts",
+        "./chat/uploads": "./src/chat/upload-handler.ts",
         "./markdown": "./src/markdown/index.ts",
         "./mdx": "./src/mdx/index.ts",
         "./agent": "./src/agent/index.ts",
@@ -98,6 +100,7 @@ export default {
         "./runs": "./src/runs/index.ts",
         "./skill": "./src/skill/index.ts",
         "./trigger": "./src/trigger/index.ts",
+        "./task": "./src/task/index.ts",
         "./schedule": "./src/schedule/index.ts",
         "./webhook": "./src/webhook/index.ts",
         "./mcp": "./src/mcp/index.ts",
@@ -144,6 +147,7 @@ export default {
         "veryfront/fonts": "./src/react/fonts/index.ts",
         "veryfront/chat": "./src/chat/index.ts",
         "veryfront/chat/types": "./src/chat/types.ts",
+        "veryfront/chat/uploads": "./src/chat/upload-handler.ts",
         "veryfront/markdown": "./src/markdown/index.ts",
         "veryfront/mdx": "./src/mdx/index.ts",
         "veryfront/fs": "./src/fs/index.ts",
@@ -243,6 +247,7 @@ export default {
         "#veryfront/chat/protocol": "./src/chat/protocol.ts",
         "#veryfront/chat/provider-errors": "./src/chat/provider-errors.ts",
         "#veryfront/chat/stream-watchdog": "./src/chat/stream-watchdog.ts",
+        "#veryfront/chat/uploads": "./src/chat/upload-handler.ts",
         "#veryfront/build": "./src/build/index.ts",
         "#veryfront/cache": "./src/cache/index.ts",
         "#veryfront/config": "./src/config/index.ts",
@@ -408,12 +413,15 @@ export default {
         "coverage:html": "deno coverage coverage --include=src/ --exclude=tests '--exclude=src/**/*_test.ts' '--exclude=src/**/*_test.tsx' '--exclude=src/**/*.test.ts' '--exclude=src/**/*.test.tsx' --html",
         "bench": "VF_DISABLE_LRU_INTERVAL=1 NODE_ENV=production LOG_FORMAT=text deno bench --no-check --allow-all --unstable-worker-options --unstable-net $(find src -name '*.bench.ts')",
         "clean": "rm -rf .cache/",
+        "storybook": "npm --prefix storybook run storybook",
+        "build:storybook": "npm --prefix storybook run build-storybook",
+        "storybook:check": "deno test --no-lock --config=scripts/test.deno.json --no-check --allow-read scripts/storybook/storybook-workbench.test.ts",
         "lint": "DENO_NO_PACKAGE_JSON=1 deno lint src/ cli/ react/ && deno lint --config=scripts/test.deno.json scripts/test/ scripts/build/npm-package-metadata.test.ts",
         "fmt": "deno fmt src/ cli/ react/ && deno fmt --config=scripts/test.deno.json scripts/test/",
         "fmt:check": "deno fmt --check src/ cli/ react/ && deno fmt --check --config=scripts/test.deno.json scripts/test/",
         "typecheck": "deno task generate:manifests:check && deno check src/index.ts cli/main.ts src/server/index.ts src/routing/api/index.ts src/rendering/index.ts src/platform/index.ts src/platform/adapters/index.ts src/build/index.ts src/build/production-build/index.ts src/transforms/index.ts src/config/index.ts src/utils/index.ts src/data/index.ts src/security/index.ts src/middleware/index.ts src/server/handlers/dev/index.ts src/server/handlers/request/api/index.ts src/rendering/cache/index.ts src/rendering/cache/stores/index.ts src/rendering/rsc/actions/index.ts src/html/index.ts src/modules/index.ts src/proxy/main.ts src/chat/index.ts src/markdown/index.ts src/mdx/index.ts src/fs/index.ts src/oauth/index.ts src/agent/index.ts src/agent/service/route-export.check.ts src/eval/index.ts src/tool/index.ts src/workflow/index.ts src/work/index.ts src/prompt/index.ts src/resource/index.ts src/runs/index.ts src/mcp/index.ts src/provider/index.ts",
-        "verify": "deno task generate:manifests:check && deno task fmt:check && deno task lint && deno task lint:style && deno task lint:cli-boundary && deno task lint:wildcard-exports && deno task lint:barrel-jsdoc && deno task lint:ban-test-only && deno task lint:sanitizer-baseline && deno task lint:skipped-tests && deno task lint:ban-zod && deno task lint:core-deps && deno task lint:dependency-boundaries && deno task lint:extension-contracts && deno task lint:extension-capabilities && deno task docs:validate && deno task typecheck && deno task test && deno task test:e2e:binary",
-        "verify:quick": "deno task generate:manifests:check && deno task fmt:check && deno task lint && deno task lint:style && deno task lint:cli-boundary && deno task lint:wildcard-exports && deno task lint:barrel-jsdoc && deno task lint:ban-test-only && deno task lint:sanitizer-baseline && deno task lint:skipped-tests && deno task lint:ban-zod && deno task lint:core-deps && deno task lint:dependency-boundaries && deno task lint:extension-contracts && deno task lint:extension-capabilities && deno task docs:validate && deno task typecheck",
+        "verify": "deno task generate:manifests:check && deno task fmt:check && deno task lint && deno task lint:style && deno task lint:chat-composability && deno task lint:cli-boundary && deno task lint:wildcard-exports && deno task lint:barrel-jsdoc && deno task lint:ban-test-only && deno task lint:sanitizer-baseline && deno task lint:skipped-tests && deno task lint:ban-zod && deno task lint:core-deps && deno task lint:dependency-boundaries && deno task lint:extension-contracts && deno task lint:extension-capabilities && deno task docs:validate && deno task typecheck && deno task test && deno task test:e2e:binary",
+        "verify:quick": "deno task generate:manifests:check && deno task fmt:check && deno task lint && deno task lint:style && deno task lint:chat-composability && deno task lint:cli-boundary && deno task lint:wildcard-exports && deno task lint:barrel-jsdoc && deno task lint:ban-test-only && deno task lint:sanitizer-baseline && deno task lint:skipped-tests && deno task lint:ban-zod && deno task lint:core-deps && deno task lint:dependency-boundaries && deno task lint:extension-contracts && deno task lint:extension-capabilities && deno task docs:validate && deno task typecheck",
         "docs": "deno run --allow-read --allow-write --allow-run --allow-env scripts/docs/generate-api-reference.ts",
         "docs:coverage": "deno run --allow-read scripts/docs/docs-coverage.ts",
         "docs:copy": "rm -rf ../../docs/docs/code/api-reference && cp -r docs/api-reference/ ../../docs/docs/code/api-reference/",
@@ -429,6 +437,7 @@ export default {
         "lint:ban-deep-imports": "deno run --allow-read scripts/lint/ban-deep-imports.ts",
         "lint:imports": "deno run --allow-read scripts/lint/no-cross-boundary-relative-imports.ts",
         "lint:ban-internal-root-imports": "deno run --allow-read scripts/lint/ban-internal-root-imports.ts",
+        "lint:chat-composability": "deno run --allow-read scripts/lint/audit-chat-composability.ts",
         "lint:style": "deno run --allow-read scripts/lint/enforce-style-conventions.ts",
         "lint:cli-boundary": "deno run --allow-read scripts/lint/enforce-cli-boundary.ts",
         "validate:architecture": "deno run --allow-read scripts/lint/validate-architecture.ts",

package/esm/deps/esm.sh/react-dom@19.2.4.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export {};
2	+ //# sourceMappingURL=react-dom@19.2.4.d.ts.map

package/esm/deps/esm.sh/react-dom@19.2.4.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"react-dom@19.2.4.d.ts","sourceRoot":"","sources":["../../../src/deps/esm.sh/react-dom@19.2.4.js"],"names":[],"mappings":""}

package/esm/deps/esm.sh/react-dom@19.2.4.js ADDED Viewed

@@ -0,0 +1,3 @@
+/* npm package shim for esm.sh react-dom@19.2.4.js */
+export * from "react-dom";
+export { default } from "react-dom";

package/esm/react/react-dom.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+export * from "../deps/esm.sh/react-dom@19.2.4.js";
+export { default } from "../deps/esm.sh/react-dom@19.2.4.js";
+//# sourceMappingURL=react-dom.d.ts.map

package/esm/react/react-dom.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"react-dom.d.ts","sourceRoot":"","sources":["../../src/react/react-dom.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC"}

package/esm/react/react-dom.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export * from "../deps/esm.sh/react-dom@19.2.4.js";
2	+ export { default } from "../deps/esm.sh/react-dom@19.2.4.js";

package/esm/src/agent/ag-ui/host-support.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"host-support.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/ag-ui/host-support.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAEpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAa3C,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAgBD,eAAO,MAAM,yBAAyB;;;;GASrC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;GAuBpC,CAAC;AAuBF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiBhC,CAAC;AAEF,kDAAkD;AAClD,eAAO,MAAM,sBAAsB;;;;GAAwC,CAAC;AAC5E,iDAAiD;AACjD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;GAAuC,CAAC;AAC1E;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAmC,CAAC;AAElE,mDAAmD;AACnD,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC;AACzF,kDAAkD;AAClD,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC,CAAC;AACvF,iCAAiC;AACjC,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC;AAE/E,MAAM,WAAW,4BAA4B;IAC3C,sBAAsB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;~~AA8ND~~,uCAAuC;AACvC,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAE7E;AAED,8CAA8C;AAC9C,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,WAAW,GAAG,QAAQ,CAAC,CAKjC;AAED,iCAAiC;AACjC,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,EACjC,OAAO,GAAE,4BAAiC,GACzC,OAAO,EAAE,CAsCX;AAED,gDAAgD;AAChD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,CAQpF;AAED,mDAAmD;AACnD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAUxF;AAED,6CAA6C;AAC7C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,QAAQ,CASlF"}
1	+ {"version":3,"file":"host-support.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/ag-ui/host-support.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAEpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAa3C,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAgBD,eAAO,MAAM,yBAAyB;;;;GASrC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;GAuBpC,CAAC;AAuBF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiBhC,CAAC;AAEF,kDAAkD;AAClD,eAAO,MAAM,sBAAsB;;;;GAAwC,CAAC;AAC5E,iDAAiD;AACjD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;GAAuC,CAAC;AAC1E;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAmC,CAAC;AAElE,mDAAmD;AACnD,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC;AACzF,kDAAkD;AAClD,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC,CAAC;AACvF,iCAAiC;AACjC,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC;AAE/E,MAAM,WAAW,4BAA4B;IAC3C,sBAAsB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AA6OD,uCAAuC;AACvC,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAE7E;AAED,8CAA8C;AAC9C,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,WAAW,GAAG,QAAQ,CAAC,CAKjC;AAED,iCAAiC;AACjC,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,EACjC,OAAO,GAAE,4BAAiC,GACzC,OAAO,EAAE,CAsCX;AAED,gDAAgD;AAChD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,CAQpF;AAED,mDAAmD;AACnD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAUxF;AAED,6CAA6C;AAC7C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,QAAQ,CASlF"}

package/esm/src/agent/ag-ui/host-support.js CHANGED Viewed

@@ -181,6 +181,18 @@ function normalizeMessagePart(part, toolNamesById = new Map()) {
             result: "result" in part ? part.result : undefined,
         };
     }
+    // Attachments: keep `file`/`image` parts (multimodal input). The composer
+    // sends every attachment as `type: "file"`, so route by media type — images
+    // become `image` parts the model can view, everything else stays `file`.
+    // The `url` may be a fetchable URL or an inline `data:` base64 URL.
+    if ((part.type === "file" || part.type === "image") &&
+        typeof part.url === "string" && part.url.length > 0 &&
+        typeof part.mediaType === "string" && part.mediaType.length > 0) {
+        const isImage = part.type === "image" || part.mediaType.startsWith("image/");
+        return isImage
+            ? { type: "image", url: part.url, mediaType: part.mediaType }
+            : { type: "file", url: part.url, mediaType: part.mediaType };
+    }
     return null;
 }
 function buildMessageMetadataFields(message) {

package/esm/src/agent/react/index.d.ts CHANGED Viewed

@@ -4,11 +4,13 @@
  * @module agent/react
  */
 export { useChat } from "./use-chat/index.js";
-export type { BranchInfo, ChatDynamicToolPart, ChatFinishReason, ChatMessage, ChatMessagePart, ChatReasoningPart, ChatStepPart, ChatStreamEvent, ChatTextPart, ChatToolPart, ChatToolResultPart, ChatToolState, InferenceMode, OnToolCallArg, ToolOutput, UseChatOptions, UseChatResult, } from "./use-chat/index.js";
+export type { BranchInfo, ChatDynamicToolPart, ChatFilePart, ChatFinishReason, ChatMessage, ChatMessagePart, ChatReasoningPart, ChatStepPart, ChatStreamEvent, ChatTextPart, ChatToolPart, ChatToolResultPart, ChatToolState, InferenceMode, OnToolCallArg, ToolOutput, UseChatOptions, UseChatResult, } from "./use-chat/index.js";
 export { useAgent } from "./use-agent.js";
 export type { UseAgentOptions, UseAgentResult } from "./use-agent.js";
-export { getAgentPromptSuggestions, normalizeAgentMetadataResponse, useAgentMetadata, } from "./use-agent-metadata.js";
+export { getAgentPromptSuggestions, normalizeAgentMetadata, normalizeAgentMetadataResponse, useAgentMetadata, } from "./use-agent-metadata.js";
 export type { AgentMetadata, AgentMetadataPromptSuggestion, AgentMetadataSuggestion, AgentMetadataSuggestions, AgentMetadataTaskSuggestion, UseAgentMetadataResult, } from "./use-agent-metadata.js";
+export { normalizeAgentsListResponse, useAgents } from "./use-agents.js";
+export type { UseAgentsOptions, UseAgentsResult } from "./use-agents.js";
 export { useCompletion } from "./use-completion.js";
 export type { UseCompletionOptions, UseCompletionResult } from "./use-completion.js";
 export { useStreaming } from "./use-streaming.js";

package/esm/src/agent/react/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/react/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,cAAc,EACd,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EACL,yBAAyB,EACzB,8BAA8B,EAC9B,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,aAAa,EACb,6BAA6B,EAC7B,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAErF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAElF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/react/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,cAAc,EACd,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,8BAA8B,EAC9B,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,aAAa,EACb,6BAA6B,EAC7B,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,2BAA2B,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACzE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAErF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAElF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/esm/src/agent/react/index.js CHANGED Viewed

@@ -5,7 +5,8 @@
  */
 export { useChat } from "./use-chat/index.js";
 export { useAgent } from "./use-agent.js";
-export { getAgentPromptSuggestions, normalizeAgentMetadataResponse, useAgentMetadata, } from "./use-agent-metadata.js";
+export { getAgentPromptSuggestions, normalizeAgentMetadata, normalizeAgentMetadataResponse, useAgentMetadata, } from "./use-agent-metadata.js";
+export { normalizeAgentsListResponse, useAgents } from "./use-agents.js";
 export { useCompletion } from "./use-completion.js";
 export { useStreaming } from "./use-streaming.js";
 export { useVoiceInput } from "./use-voice-input.js";

package/esm/src/agent/react/use-agent-metadata.d.ts CHANGED Viewed

@@ -33,6 +33,11 @@ export interface UseAgentMetadataResult {
     isLoading: boolean;
     error: Error | null;
 }
+/**
+ * Normalize a single browser-safe agent record (the `agent` object inside the
+ * `/api/agents/:id` response, or one entry of the `/api/agents` list).
+ */
+export declare function normalizeAgentMetadata(value: unknown): AgentMetadata;
 /** Normalize the wire response from /api/agents/:id. */
 export declare function normalizeAgentMetadataResponse(value: unknown): AgentMetadata;
 /** Return prompt text suggestions that the current Chat component can render. */

package/esm/src/agent/react/use-agent-metadata.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"use-agent-metadata.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/react/use-agent-metadata.ts"],"names":[],"mappings":"AAGA,+DAA+D;AAC/D,MAAM,MAAM,6BAA6B,GACrC;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,GACC;IACA,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC;AAEJ,6DAA6D;AAC7D,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,uCAAuC;AACvC,MAAM,MAAM,uBAAuB,GAAG,6BAA6B,GAAG,2BAA2B,CAAC;AAElG,oDAAoD;AACpD,MAAM,WAAW,wBAAwB;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,uBAAuB,EAAE,CAAC;CACxC;AAED,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,wBAAwB,CAAC;CACxC;AAED,6CAA6C;AAC7C,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AA2ED,wDAAwD;AACxD,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,~~CAa5E~~;AAED,iFAAiF;AACjF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,EAAE,CAK/E;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,sBAAsB,CAkD3F"}
1	+ {"version":3,"file":"use-agent-metadata.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/react/use-agent-metadata.ts"],"names":[],"mappings":"AAGA,+DAA+D;AAC/D,MAAM,MAAM,6BAA6B,GACrC;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,GACC;IACA,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC;AAEJ,6DAA6D;AAC7D,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,uCAAuC;AACvC,MAAM,MAAM,uBAAuB,GAAG,6BAA6B,GAAG,2BAA2B,CAAC;AAElG,oDAAoD;AACpD,MAAM,WAAW,wBAAwB;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,uBAAuB,EAAE,CAAC;CACxC;AAED,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,wBAAwB,CAAC;CACxC;AAED,6CAA6C;AAC7C,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AA2ED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAYpE;AAED,wDAAwD;AACxD,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAK5E;AAED,iFAAiF;AACjF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,EAAE,CAK/E;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,sBAAsB,CAkD3F"}

package/esm/src/agent/react/use-agent-metadata.js CHANGED Viewed

@@ -62,19 +62,28 @@ function normalizeSuggestions(value) {
         suggestions: rawSuggestions.map(normalizeSuggestion),
     };
 }
+/**
+ * Normalize a single browser-safe agent record (the `agent` object inside the
+ * `/api/agents/:id` response, or one entry of the `/api/agents` list).
+ */
+export function normalizeAgentMetadata(value) {
+    if (!isRecord(value)) {
+        throw new Error("Invalid agent metadata: agent must be an object");
+    }
+    return {
+        id: getRequiredString(value, "id"),
+        name: getRequiredString(value, "name"),
+        description: getNullableString(value, "description"),
+        avatarUrl: getNullableString(value, "avatar_url"),
+        suggestions: normalizeSuggestions(value.suggestions),
+    };
+}
 /** Normalize the wire response from /api/agents/:id. */
 export function normalizeAgentMetadataResponse(value) {
-    if (!isRecord(value) || !isRecord(value.agent)) {
+    if (!isRecord(value)) {
         throw new Error("Invalid agent metadata response");
     }
-    const agent = value.agent;
-    return {
-        id: getRequiredString(agent, "id"),
-        name: getRequiredString(agent, "name"),
-        description: getNullableString(agent, "description"),
-        avatarUrl: getNullableString(agent, "avatar_url"),
-        suggestions: normalizeSuggestions(agent.suggestions),
-    };
+    return normalizeAgentMetadata(value.agent);
 }
 /** Return prompt text suggestions that the current Chat component can render. */
 export function getAgentPromptSuggestions(agent) {

package/esm/src/agent/react/use-agents.d.ts ADDED Viewed

@@ -0,0 +1,33 @@
+import { type AgentMetadata } from "./use-agent-metadata.js";
+/** Options accepted by {@link useAgents}. */
+export interface UseAgentsOptions {
+    /**
+     * When `false`, the request is skipped and the hook stays idle with an empty
+     * list. Flip it to `true` to fetch (or refetch). Defaults to `true`.
+     */
+    enabled?: boolean;
+}
+/** Result returned from {@link useAgents}. */
+export interface UseAgentsResult {
+    /** Browser-safe metadata for every agent the project exposes, sorted by name. */
+    agents: AgentMetadata[];
+    /** `true` while the list request is in flight. */
+    isLoading: boolean;
+    /** The last request error, or `null`. */
+    error: Error | null;
+    /** Re-run the request, bypassing nothing — always hits the network. */
+    refetch: () => void;
+}
+/** Normalize the wire response from `GET /api/agents`. */
+export declare function normalizeAgentsListResponse(value: unknown): AgentMetadata[];
+/**
+ * React hook that lists the browser-safe agents a project exposes, via
+ * `GET /api/agents`. Companion to {@link useAgentMetadata} (single agent) — use
+ * it to drive an agent switcher, e.g. only rendering a picker when
+ * `agents.length > 1`.
+ *
+ * The in-flight request is aborted on unmount, on option change, and before a
+ * `refetch`, so state never lands from a stale response.
+ */
+export declare function useAgents(options?: UseAgentsOptions): UseAgentsResult;
+//# sourceMappingURL=use-agents.d.ts.map

package/esm/src/agent/react/use-agents.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"use-agents.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/react/use-agents.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAA0B,MAAM,yBAAyB,CAAC;AAErF,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,8CAA8C;AAC9C,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,kDAAkD;IAClD,SAAS,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,uEAAuE;IACvE,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAQD,0DAA0D;AAC1D,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,EAAE,CAK3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,eAAe,CAuDzE"}

package/esm/src/agent/react/use-agents.js ADDED Viewed

@@ -0,0 +1,72 @@
+import { useCallback, useEffect, useState } from "../../../react/react.js";
+import { ensureError } from "../../errors/veryfront-error.js";
+import { normalizeAgentMetadata } from "./use-agent-metadata.js";
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+/** Normalize the wire response from `GET /api/agents`. */
+export function normalizeAgentsListResponse(value) {
+    if (!isRecord(value) || !Array.isArray(value.agents)) {
+        throw new Error("Invalid agents list response: agents must be an array");
+    }
+    return value.agents.map(normalizeAgentMetadata);
+}
+/**
+ * React hook that lists the browser-safe agents a project exposes, via
+ * `GET /api/agents`. Companion to {@link useAgentMetadata} (single agent) — use
+ * it to drive an agent switcher, e.g. only rendering a picker when
+ * `agents.length > 1`.
+ *
+ * The in-flight request is aborted on unmount, on option change, and before a
+ * `refetch`, so state never lands from a stale response.
+ */
+export function useAgents(options = {}) {
+    const { enabled = true } = options;
+    const [agents, setAgents] = useState([]);
+    const [isLoading, setIsLoading] = useState(enabled);
+    const [error, setError] = useState(null);
+    // Bumping this re-runs the effect below to force a fresh request.
+    const [reloadToken, setReloadToken] = useState(0);
+    const refetch = useCallback(() => {
+        setReloadToken((token) => token + 1);
+    }, []);
+    useEffect(() => {
+        if (!enabled) {
+            setAgents([]);
+            setIsLoading(false);
+            setError(null);
+            return;
+        }
+        const abortController = new AbortController();
+        setIsLoading(true);
+        setError(null);
+        async function loadAgents() {
+            try {
+                const response = await fetch("/api/agents", {
+                    headers: { accept: "application/json" },
+                    signal: abortController.signal,
+                });
+                if (!response.ok) {
+                    throw new Error(`Agents list request failed: ${response.status}`);
+                }
+                setAgents(normalizeAgentsListResponse(await response.json()));
+            }
+            catch (caught) {
+                if (caught instanceof Error && caught.name === "AbortError")
+                    return;
+                setAgents([]);
+                setError(ensureError(caught));
+            }
+            finally {
+                if (!abortController.signal.aborted) {
+                    setIsLoading(false);
+                }
+            }
+        }
+        void loadAgents();
+        return () => {
+            abortController.abort();
+        };
+    }, [enabled, reloadToken]);
+    return { agents, isLoading, error, refetch };
+}

package/esm/src/agent/react/use-chat/index.d.ts CHANGED Viewed

@@ -5,6 +5,6 @@
  * Build any interface you want.
  */
 export { useChat } from "./use-chat.js";
-export type { BranchInfo, ChatDynamicToolPart, ChatMessage, ChatMessagePart, ChatReasoningPart, ChatStepPart, ChatTextPart, ChatToolPart, ChatToolResultPart, ChatToolState, InferenceMode, OnToolCallArg, ToolOutput, UseChatOptions, UseChatResult, } from "./types.js";
+export type { BranchInfo, ChatDynamicToolPart, ChatFilePart, ChatMessage, ChatMessagePart, ChatReasoningPart, ChatStepPart, ChatTextPart, ChatToolPart, ChatToolResultPart, ChatToolState, InferenceMode, OnToolCallArg, ToolOutput, UseChatOptions, UseChatResult, } from "./types.js";
 export type { ChatFinishReason, ChatStreamEvent, } from "./stream-protocol.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/src/agent/react/use-chat/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/agent/react/use-chat/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,gBAAgB,EAChB,eAAe,GAChB,MAAM,sBAAsB,CAAC"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/agent/react/use-chat/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,gBAAgB,EAChB,eAAe,GAChB,MAAM,sBAAsB,CAAC"}

package/esm/src/agent/react/use-chat/types.d.ts CHANGED Viewed

@@ -1,7 +1,7 @@
-import type { ChatDataPart, ChatDynamicToolPart, ChatMessage, ChatMessagePart, ChatReasoningPart, ChatStepPart, ChatTextPart, ChatToolPart, ChatToolResultPart, ChatToolState } from "../../../chat/protocol.js";
+import type { ChatDataPart, ChatDynamicToolPart, ChatFilePart, ChatMessage, ChatMessagePart, ChatReasoningPart, ChatStepPart, ChatTextPart, ChatToolPart, ChatToolResultPart, ChatToolState } from "../../../chat/protocol.js";
 /** Where inference is happening. */
 export type InferenceMode = "cloud" | "server-local";
-export type { ChatDataPart, ChatDynamicToolPart, ChatMessage, ChatMessagePart, ChatReasoningPart, ChatStepPart, ChatTextPart, ChatToolPart, ChatToolResultPart, ChatToolState, };
+export type { ChatDataPart, ChatDynamicToolPart, ChatFilePart, ChatMessage, ChatMessagePart, ChatReasoningPart, ChatStepPart, ChatTextPart, ChatToolPart, ChatToolResultPart, ChatToolState, };
 type ToolOutputState = "output-available" | "output-error";
 /** Output from tool. */
 export interface ToolOutput {
@@ -59,6 +59,7 @@ export interface UseChatResult {
     setModel: (model: string | undefined) => void;
     sendMessage: (message: {
         text: string;
+        files?: ChatFilePart[];
     }) => Promise<void>;
     /** Edit a user message and resubmit — truncates history to that point */
     editMessage: (messageId: string, newText: string) => Promise<void>;

package/esm/src/agent/react/use-chat/types.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/src/agent/react/use-chat/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACd,MAAM,2BAA2B,CAAC;AAEnC,oCAAoC;AACpC,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,cAAc,CAAC;AAErD,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,aAAa,GACd,CAAC;AAEF,KAAK,eAAe,GAAG,kBAAkB,GAAG,cAAc,CAAC;AAE3D,wBAAwB;AACxB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED,oCAAoC;AACpC,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,+FAA+F;IAC/F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAC1C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D;AAED,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,iGAAiG;IACjG,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,6CAA6C;IAC7C,aAAa,EAAE,aAAa,CAAC;IAC7B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,+CAA+C;IAC/C,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAC9C,WAAW,EAAE,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;~~IAC1D~~,yEAAyE;IACzE,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,yFAAyF;IACzF,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,UAAU,CAAC;IAC/C,sDAAsD;IACtD,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,WAAW,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IAC/C,aAAa,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IAC5C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iBAAiB,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,gBAAgB,GAAG,mBAAmB,CAAC,KAAK,IAAI,CAAC;IAC1F,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,sFAAsF;IACtF,QAAQ,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,gBAAgB,GAAG,mBAAmB,CAAC,KAAK,IAAI,CAAC;IACjF,iFAAiF;IACjF,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,kFAAkF;IAClF,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CACpD"}
1	+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/src/agent/react/use-chat/types.ts"],"names":[],"mappings":"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"}

package/esm/src/agent/react/use-chat/use-chat.d.ts CHANGED Viewed

@@ -9,7 +9,7 @@
  * - server-local: explicit local model on the server
  */
 import { handleAgUiStreamingResponse } from "./streaming/index.js";
-import type { ChatMessage, UseChatOptions, UseChatResult } from "./types.js";
+import type { ChatFilePart, ChatMessage, ChatMessagePart, UseChatOptions, UseChatResult } from "./types.js";
 type UseChatStreamHandler = typeof handleAgUiStreamingResponse;
 /** A snapshot of messages from a branch point onward */
 interface Branch {
@@ -24,6 +24,17 @@ interface BranchState {
 export declare function isLatestRequest(activeRequestId: number, requestId: number): boolean;
 export declare function resolveBranchKey(messageId: string, branchMap: Map<string, BranchState>, branchKeyByMessageId: Map<string, string>): string | undefined;
 export declare function findBranchUserMessageIndex(messages: ChatMessage[], branchKey: string, branchKeyByMessageId: Map<string, string>): number;
+/**
+ * Build the parts for an outgoing user message. File attachments lead (before
+ * the text) so the model sees the referenced files first — matching how AI-SDK
+ * orders multimodal parts. Exported for unit testing.
+ */
+export declare function buildUserMessageParts(text: string, files?: ChatFilePart[]): ChatMessagePart[];
+/** Extract the text and file payload from a user message for regenerate. */
+export declare function userMessagePayload(message: ChatMessage): {
+    text: string;
+    files?: ChatFilePart[];
+} | null;
 export declare function resolveUseChatStreamHandler(transport: UseChatOptions["transport"]): UseChatStreamHandler;
 export declare function useChat(options?: UseChatOptions): UseChatResult;
 export {};

package/esm/src/agent/react/use-chat/use-chat.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"use-chat.d.ts","sourceRoot":"","sources":["../../../../../src/src/agent/react/use-chat/use-chat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAEV,WAAW,~~EAGX~~,cAAc,EACd,aAAa,EACd,MAAM,YAAY,CAAC;AAGpB,KAAK,oBAAoB,GAAG,OAAO,2BAA2B,CAAC;AAE/D,wDAAwD;AACxD,UAAU,MAAM;IACd,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,sEAAsE;AACtE,UAAU,WAAW;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED,wBAAgB,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAEnF;AAED,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EACnC,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,MAAM,GAAG,SAAS,CAGpB;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,WAAW,EAAE,EACvB,SAAS,EAAE,MAAM,EACjB,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,MAAM,CAIR;AAED,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,GACrC,oBAAoB,CAGtB;AAOD,wBAAgB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,aAAa,~~CA8ZnE~~"}
1	+ {"version":3,"file":"use-chat.d.ts","sourceRoot":"","sources":["../../../../../src/src/agent/react/use-chat/use-chat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAEV,YAAY,EACZ,WAAW,EACX,eAAe,EAGf,cAAc,EACd,aAAa,EACd,MAAM,YAAY,CAAC;AAGpB,KAAK,oBAAoB,GAAG,OAAO,2BAA2B,CAAC;AAE/D,wDAAwD;AACxD,UAAU,MAAM;IACd,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,sEAAsE;AACtE,UAAU,WAAW;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED,wBAAgB,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAEnF;AAED,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EACnC,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,MAAM,GAAG,SAAS,CAGpB;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,WAAW,EAAE,EACvB,SAAS,EAAE,MAAM,EACjB,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,MAAM,CAIR;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,YAAY,EAAE,GACrB,eAAe,EAAE,CAEnB;AAMD,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,YAAY,EAAE,CAAA;CAAE,GAAG,IAAI,CAQjD;AAED,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,GACrC,oBAAoB,CAGtB;AAOD,wBAAgB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,aAAa,CAsbnE"}

package/esm/src/agent/react/use-chat/use-chat.js CHANGED Viewed

@@ -22,6 +22,28 @@ export function resolveBranchKey(messageId, branchMap, branchKeyByMessageId) {
 export function findBranchUserMessageIndex(messages, branchKey, branchKeyByMessageId) {
     return messages.findIndex((m) => m.role === "user" && branchKeyByMessageId.get(m.id) === branchKey);
 }
+/**
+ * Build the parts for an outgoing user message. File attachments lead (before
+ * the text) so the model sees the referenced files first — matching how AI-SDK
+ * orders multimodal parts. Exported for unit testing.
+ */
+export function buildUserMessageParts(text, files) {
+    return [...(files ?? []), { type: "text", text }];
+}
+function isFilePart(part) {
+    return part.type === "file";
+}
+/** Extract the text and file payload from a user message for regenerate. */
+export function userMessagePayload(message) {
+    const text = message.parts
+        .filter((part) => part.type === "text")
+        .map((part) => part.text)
+        .join("");
+    const files = message.parts.filter(isFilePart);
+    if (!text && files.length === 0)
+        return null;
+    return { text, ...(files.length > 0 ? { files } : {}) };
+}
 export function resolveUseChatStreamHandler(transport) {
     void transport;
     return handleAgUiStreamingResponse;
@@ -88,7 +110,8 @@ export function useChat(options = {}) {
         const userMessage = {
             id: message.userMessageId ?? generateClientId("msg"),
             role: "user",
-            parts: [{ type: "text", text: message.text }],
+            parts: buildUserMessageParts(message.text, message.files),
+            createdAt: new Date().toISOString(),
         };
         const base = message.baseMessages ?? messagesRef.current;
         setMessages([...base, userMessage]);
@@ -151,7 +174,12 @@ export function useChat(options = {}) {
                         if (!hasAddedStreamingMessage)
                             return [...prev, withMeta];
                         return prev.map((m) => (m.id === currentMessageIdRef.current
-                            ? { ...withMeta, metadata: { ...m.metadata, ...withMeta.metadata } }
+                            ? {
+                                ...withMeta,
+                                // Keep the timestamp from when the turn first streamed in.
+                                createdAt: m.createdAt ?? withMeta.createdAt,
+                                metadata: { ...m.metadata, ...withMeta.metadata },
+                            }
                             : m));
                     });
                     options.onFinish?.(withMeta);
@@ -187,7 +215,17 @@ export function useChat(options = {}) {
                     }
                     if (!hasAddedStreamingMessage) {
                         hasAddedStreamingMessage = true;
-                        setMessages((prev) => [...prev, { id, role: "assistant", parts, metadata }]);
+                        setMessages((prev) => [
+                            ...prev,
+                            {
+                                id,
+                                role: "assistant",
+                                parts,
+                                metadata,
+                                // Stamp when the turn first appears; `onMessage` preserves it.
+                                createdAt: new Date().toISOString(),
+                            },
+                        ]);
                         return;
                     }
                     setMessages((prev) => prev.map((m) => m.id === currentMessageIdRef.current
@@ -223,11 +261,13 @@ export function useChat(options = {}) {
         if (lastUserIndex === -1)
             return;
         const lastUserMessage = currentMessages[lastUserIndex];
-        const textPart = lastUserMessage?.parts.find((p) => p.type === "text");
-        if (!textPart || !("text" in textPart))
+        if (!lastUserMessage)
+            return;
+        const payload = userMessagePayload(lastUserMessage);
+        if (!payload)
             return;
         const base = currentMessages.slice(0, lastUserIndex);
-        await sendMessage({ text: textPart.text, baseMessages: base });
+        await sendMessage({ ...payload, baseMessages: base });
     }, [sendMessage]);
     /**
      * Stop generation
@@ -368,7 +408,7 @@ export function useChat(options = {}) {
         data,
         handleInputChange,
         handleSubmit,
-        // Aliases that match ChatProps / ChatWithSidebarProps so users can spread {...chat}
+        // Aliases that match ChatProps so users can spread {...chat}
         onChange: handleInputChange,
         onSubmit: handleSubmit,
         onModelChange: setModel,