@redis/vercel-ai-sdk 0.0.0-stage → 0.1.0

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 (45) hide show
  1. package/CHANGELOG.md +38 -0
  2. package/LICENSE +21 -0
  3. package/README.md +185 -2
  4. package/TOOLS.md +359 -0
  5. package/dist/errors.d.ts +9 -0
  6. package/dist/errors.d.ts.map +1 -0
  7. package/dist/errors.js +21 -0
  8. package/dist/errors.js.map +1 -0
  9. package/dist/index.d.ts +53 -0
  10. package/dist/index.d.ts.map +1 -0
  11. package/dist/index.js +239 -0
  12. package/dist/index.js.map +1 -0
  13. package/dist/instructions.d.ts +3 -0
  14. package/dist/instructions.d.ts.map +1 -0
  15. package/dist/instructions.js +16 -0
  16. package/dist/instructions.js.map +1 -0
  17. package/dist/namespaces.d.ts +11 -0
  18. package/dist/namespaces.d.ts.map +1 -0
  19. package/dist/namespaces.js +182 -0
  20. package/dist/namespaces.js.map +1 -0
  21. package/dist/provider.d.ts +54 -0
  22. package/dist/provider.d.ts.map +1 -0
  23. package/dist/provider.js +666 -0
  24. package/dist/provider.js.map +1 -0
  25. package/dist/schemas.d.ts +125 -0
  26. package/dist/schemas.d.ts.map +1 -0
  27. package/dist/schemas.js +54 -0
  28. package/dist/schemas.js.map +1 -0
  29. package/dist/scoped-memory.d.ts +63 -0
  30. package/dist/scoped-memory.d.ts.map +1 -0
  31. package/dist/scoped-memory.js +252 -0
  32. package/dist/scoped-memory.js.map +1 -0
  33. package/dist/session-event-hook.d.ts +49 -0
  34. package/dist/session-event-hook.d.ts.map +1 -0
  35. package/dist/session-event-hook.js +77 -0
  36. package/dist/session-event-hook.js.map +1 -0
  37. package/package.json +74 -4
  38. package/src/errors.ts +16 -0
  39. package/src/index.ts +310 -0
  40. package/src/instructions.ts +15 -0
  41. package/src/namespaces.ts +217 -0
  42. package/src/provider.ts +741 -0
  43. package/src/schemas.ts +55 -0
  44. package/src/scoped-memory.ts +298 -0
  45. package/src/session-event-hook.ts +120 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"namespaces.js","sourceRoot":"","sources":["../src/namespaces.ts"],"names":[],"mappings":"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","sourcesContent":["import { tool, type ToolSet } from \"ai\";\nimport type { AgentMemory } from \"@redis-iris/agent-memory\";\nimport type { Namespace } from \"@redis-iris/agent-memory/models\";\nimport { z } from \"zod\";\nimport { RedisAgentMemoryToolError } from \"./errors.js\";\n\nexport interface NamespaceToolOptions {\n ownerId?: string;\n namespaceId?: string;\n allowDeletes: boolean;\n assertMemory: (id: string, signal?: AbortSignal) => Promise<unknown>;\n}\n\nconst identifier = z.string().min(1);\nconst scopeSchema = z.enum([\"PERSONAL\", \"SHARED\"]);\nconst namespaceName = z.string().min(1).refine((name) => !name.includes(\"/\"), {\n message: \"A namespace name is one path segment; use path to create a hierarchy.\",\n});\n\n/** Optional namespace administration tools. Access checks never trust model-supplied IDs. */\nexport function createNamespaceTools(\n client: AgentMemory,\n options: NamespaceToolOptions,\n): ToolSet {\n const requestOptions = (signal?: AbortSignal) => ({ signal });\n\n function assertNamespaceId(namespaceId: string): void {\n if (options.namespaceId !== undefined && namespaceId !== options.namespaceId) {\n throw new RedisAgentMemoryToolError(\"INVALID_SCOPE\", \"This toolset is restricted to its configured namespace.\");\n }\n }\n\n async function assertOwner(namespace: Namespace, signal?: AbortSignal): Promise<void> {\n if (options.ownerId === undefined) return;\n if (namespace.scope !== \"PERSONAL\") {\n throw new RedisAgentMemoryToolError(\"INVALID_SCOPE\", \"This toolset can only access the configured owner's personal namespaces.\");\n }\n const root = namespace.namespaceId === namespace.rootId\n ? namespace\n : (await client.getNamespace(namespace.rootId, requestOptions(signal))).namespace;\n if (root.scope !== \"PERSONAL\" || root.ownerId !== options.ownerId) {\n throw new RedisAgentMemoryToolError(\"INVALID_SCOPE\", \"Namespace access is outside the configured owner scope.\");\n }\n }\n\n async function assertNamespace(namespaceId: string, signal?: AbortSignal): Promise<Namespace> {\n assertNamespaceId(namespaceId);\n const result = await client.getNamespace(namespaceId, requestOptions(signal));\n await assertOwner(result.namespace, signal);\n return result.namespace;\n }\n\n const tools: ToolSet = {\n list_namespaces: tool({\n description:\n \"List namespace roots or the direct children of a namespace. Reuse nextPageToken to fetch another page. \" +\n \"With a fixed namespace configuration, omit filters and pageToken to retrieve only that namespace.\",\n inputSchema: z.object({\n parentId: identifier.optional().describe(\"List direct children; omit to list roots.\"),\n scope: scopeSchema.optional().describe(\"Root scope. Cannot be combined with parentId.\"),\n ownerId: identifier.optional().describe(\"Owner of PERSONAL roots. Cannot be combined with parentId.\"),\n limit: z.number().int().min(1).max(1000).optional(),\n pageToken: z.string().min(1).optional(),\n }),\n execute: async (input, { abortSignal }) => {\n if (options.namespaceId !== undefined) {\n if (input.parentId !== undefined || input.scope !== undefined || input.ownerId !== undefined || input.pageToken !== undefined) {\n throw new RedisAgentMemoryToolError(\"INVALID_SCOPE\", \"Omit filters and pageToken when listing a fixed namespace.\");\n }\n return { items: [await assertNamespace(options.namespaceId, abortSignal)] };\n }\n if (input.parentId !== undefined && (input.scope !== undefined || input.ownerId !== undefined)) {\n throw new RedisAgentMemoryToolError(\"INVALID_SCOPE\", \"parentId cannot be combined with scope or ownerId.\");\n }\n if (input.scope === \"SHARED\" && input.ownerId !== undefined) {\n throw new RedisAgentMemoryToolError(\"INVALID_SCOPE\", \"ownerId only applies to PERSONAL namespaces.\");\n }\n let scope = input.scope;\n let ownerId = input.ownerId;\n if (options.ownerId !== undefined) {\n if (scope === \"SHARED\" || (ownerId !== undefined && ownerId !== options.ownerId)) {\n throw new RedisAgentMemoryToolError(\"INVALID_SCOPE\", \"Namespace filters conflict with the configured owner scope.\");\n }\n if (input.parentId === undefined) {\n scope = \"PERSONAL\";\n ownerId = options.ownerId;\n }\n }\n if (input.parentId !== undefined) {\n await assertNamespace(input.parentId, abortSignal);\n } else if (ownerId !== undefined) {\n scope = \"PERSONAL\";\n }\n const result = await client.listNamespaces(\n input.parentId,\n scope,\n ownerId,\n input.limit,\n input.pageToken,\n requestOptions(abortSignal),\n );\n for (const namespace of result.items) await assertOwner(namespace, abortSignal);\n return result;\n },\n }),\n\n get_namespace: tool({\n description: \"Retrieve a namespace's stable ID, current path, scope, owner, and archive state.\",\n inputSchema: z.object({ namespaceId: identifier }),\n execute: async ({ namespaceId }, { abortSignal }) => ({\n namespace: await assertNamespace(namespaceId, abortSignal),\n }),\n }),\n\n create_namespace: tool({\n description:\n \"Create a namespace root, a child, or an explicit hierarchy path. Use name with scope for a root, \" +\n \"name with parentId for a child, or path with scope for a hierarchy. PERSONAL roots require an owner. \" +\n \"Creation is unavailable when this toolset is bound to one fixed namespace.\",\n inputSchema: z.object({\n name: namespaceName.optional(),\n path: z.string().min(1).optional(),\n scope: scopeSchema.optional(),\n parentId: identifier.optional(),\n ownerId: identifier.optional(),\n }),\n execute: async (input, { abortSignal }) => {\n if (options.namespaceId !== undefined) {\n throw new RedisAgentMemoryToolError(\"INVALID_SCOPE\", \"Cannot create namespaces from a toolset bound to a fixed namespace.\");\n }\n if ((input.name === undefined) === (input.path === undefined)) {\n throw new RedisAgentMemoryToolError(\"INVALID_SCOPE\", \"Provide exactly one of name or path.\");\n }\n if (input.parentId !== undefined) {\n if (input.path !== undefined || input.scope !== undefined || input.ownerId !== undefined) {\n throw new RedisAgentMemoryToolError(\"INVALID_SCOPE\", \"Child creation requires name and parentId only.\");\n }\n await assertNamespace(input.parentId, abortSignal);\n return client.createNamespace(\n { name: input.name, parentId: input.parentId },\n requestOptions(abortSignal),\n );\n }\n let scope = input.scope;\n let ownerId = input.ownerId;\n if (options.ownerId !== undefined) {\n if (scope === \"SHARED\" || (ownerId !== undefined && ownerId !== options.ownerId)) {\n throw new RedisAgentMemoryToolError(\"INVALID_SCOPE\", \"Namespace creation conflicts with the configured owner scope.\");\n }\n scope = \"PERSONAL\";\n ownerId = options.ownerId;\n }\n if (scope === undefined) throw new RedisAgentMemoryToolError(\"INVALID_SCOPE\", \"Specify scope for a namespace root or hierarchy path.\");\n if (scope === \"PERSONAL\" && ownerId === undefined) {\n throw new RedisAgentMemoryToolError(\"INVALID_SCOPE\", \"PERSONAL namespaces require ownerId.\");\n }\n if (scope === \"SHARED\" && ownerId !== undefined) {\n throw new RedisAgentMemoryToolError(\"INVALID_SCOPE\", \"SHARED namespaces must omit ownerId.\");\n }\n return client.createNamespace({ ...input, scope, ownerId }, requestOptions(abortSignal));\n },\n }),\n\n update_namespace: tool({\n description:\n \"Rename a namespace or archive it. Archiving prevents new children and memory placements; \" +\n \"it does not delete the existing memories. Only archive on an explicit user request.\",\n inputSchema: z.object({\n namespaceId: identifier,\n name: namespaceName.optional(),\n state: z.literal(\"ARCHIVED\").optional(),\n }),\n execute: async ({ namespaceId, ...body }, { abortSignal }) => {\n if (body.name === undefined && body.state === undefined) {\n throw new RedisAgentMemoryToolError(\"INVALID_SCOPE\", \"Provide a new name or state to update a namespace.\");\n }\n await assertNamespace(namespaceId, abortSignal);\n return client.updateNamespace(namespaceId, body, requestOptions(abortSignal));\n },\n }),\n\n move_memories: tool({\n description:\n \"Move existing long-term memories to an existing, active namespace. Supply known memory IDs and the \" +\n \"destination namespace ID. Partial failures are returned in errors; inspect them before claiming success.\",\n inputSchema: z.object({\n memoryIds: z.array(identifier).min(1).max(100),\n namespaceId: identifier.describe(\"Destination namespace ID.\"),\n }),\n execute: async ({ memoryIds, namespaceId }, { abortSignal }) => {\n const namespace = await assertNamespace(namespaceId, abortSignal);\n if (namespace.state !== \"ACTIVE\") throw new RedisAgentMemoryToolError(\"INVALID_SCOPE\", \"Cannot move memories into an archived namespace.\");\n for (const memoryId of memoryIds) await options.assertMemory(memoryId, abortSignal);\n return client.moveLongTermMemories(\n { memoryIds, namespaceRef: { namespaceId } },\n requestOptions(abortSignal),\n );\n },\n }),\n };\n\n if (options.allowDeletes) {\n tools.delete_namespace = tool({\n description:\n \"Delete an empty leaf namespace on the user's explicit request. The server rejects namespaces \" +\n \"that still contain children or memory placements. This does not recursively delete anything.\",\n inputSchema: z.object({ namespaceId: identifier }),\n execute: async ({ namespaceId }, { abortSignal }) => {\n await assertNamespace(namespaceId, abortSignal);\n await client.deleteNamespace(namespaceId, requestOptions(abortSignal));\n return { deleted: true, namespaceId };\n },\n });\n }\n\n return tools;\n}\n"]}
@@ -0,0 +1,54 @@
1
+ import { wrapLanguageModel } from 'ai';
2
+ import { resolveAgentMemoryClient, type RedisAgentMemoryScope as BaseScope } from './scoped-memory.js';
3
+ export { RedisAgentMemoryToolError } from './errors.js';
4
+ export type ConfiguredLanguageModel = Parameters<typeof wrapLanguageModel>[0]['model'];
5
+ export type RedisAgentMemoryModel = ReturnType<typeof wrapLanguageModel>;
6
+ export interface RedisAgentMemoryLimits {
7
+ memoryCount?: number;
8
+ memoryChars?: number;
9
+ sessionChars?: number;
10
+ readTimeoutMs?: number;
11
+ writeTimeoutMs?: number;
12
+ recordingChars?: number;
13
+ }
14
+ export interface RedisAgentMemoryModelOptions {
15
+ /** Replaces the factory default scope when supplied. */
16
+ scope?: BaseScope;
17
+ /** Overrides the factory default configured model when supplied. */
18
+ model?: ConfiguredLanguageModel;
19
+ assistantId?: string;
20
+ historyMode?: 'iris' | 'application';
21
+ recording?: boolean;
22
+ query?: string;
23
+ strictReads?: boolean;
24
+ includeMemoryProvenance?: boolean;
25
+ limits?: RedisAgentMemoryLimits;
26
+ onDiagnostic?: (event: RedisAgentMemoryDiagnostic) => void;
27
+ }
28
+ export interface RedisAgentMemoryDiagnosticError {
29
+ code: string;
30
+ statusCode?: number;
31
+ }
32
+ export interface RedisAgentMemoryDiagnostic {
33
+ operation: 'session.restore' | 'memory.search' | 'session.user.write' | 'session.assistant.write' | 'context.inject' | 'provenance.merge';
34
+ outcome: 'success' | 'empty' | 'unavailable' | 'skipped' | 'timeout' | 'failure' | 'truncated' | 'scope_violation' | 'collision' | 'too_large';
35
+ durationMs: number;
36
+ count?: number;
37
+ includedCount?: number;
38
+ omittedCount?: number;
39
+ writeStatus?: 'not_started' | 'acknowledged' | 'unknown';
40
+ error?: RedisAgentMemoryDiagnosticError;
41
+ }
42
+ export interface RedisAgentMemoryProvenanceEntry {
43
+ id: string;
44
+ memoryType?: string;
45
+ createdAt?: string;
46
+ updatedAt?: string;
47
+ }
48
+ export interface RedisAgentMemoryProvenance {
49
+ memories: RedisAgentMemoryProvenanceEntry[];
50
+ }
51
+ export declare function assertConfiguredLanguageModel(model: unknown): asserts model is ConfiguredLanguageModel;
52
+ /** Create a fresh request-scoped model using an already shared Iris client. */
53
+ export declare function createRedisAgentMemoryModel(client: ReturnType<typeof resolveAgentMemoryClient>, model: ConfiguredLanguageModel, inputOptions: RedisAgentMemoryModelOptions): RedisAgentMemoryModel;
54
+ //# sourceMappingURL=provider.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAgC,MAAM,IAAI,CAAC;AAErE,OAAO,EAIL,wBAAwB,EACxB,KAAK,qBAAqB,IAAI,SAAS,EAExC,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAExD,MAAM,MAAM,uBAAuB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AACvF,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAWzE,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,4BAA4B;IAC3C,wDAAwD;IACxD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,oEAAoE;IACpE,KAAK,CAAC,EAAE,uBAAuB,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,CAAC;CAC5D;AAED,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,iBAAiB,GAAG,eAAe,GAAG,oBAAoB,GACnE,yBAAyB,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;IACpE,OAAO,EAAE,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,GAClE,SAAS,GAAG,WAAW,GAAG,iBAAiB,GAAG,WAAW,GAAG,WAAW,CAAC;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,aAAa,GAAG,cAAc,GAAG,SAAS,CAAC;IACzD,KAAK,CAAC,EAAE,+BAA+B,CAAC;CACzC;AAED,MAAM,WAAW,+BAA+B;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,+BAA+B,EAAE,CAAC;CAC7C;AA2RD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,uBAAuB,CAWtG;AAED,+EAA+E;AAC/E,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,EACnD,KAAK,EAAE,uBAAuB,EAC9B,YAAY,EAAE,4BAA4B,GACzC,qBAAqB,CA0WvB"}