@typegraph-ai/vercel-ai-provider 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 TypeGraph
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,225 @@
+# @typegraph-ai/vercel-ai-provider
+
+Vercel AI SDK integration for TypeGraph tools and memory context helpers.
+
+## Install
+
+```bash
+pnpm add ai @ai-sdk/openai @typegraph-ai/sdk @typegraph-ai/vercel-ai-provider
+```
+
+## Basic Usage
+
+Create tools per request and pass trusted context from your server. Do not ask
+the model to provide tenant, user, group, agent, or thread IDs.
+
+```ts
+import { generateText, stepCountIs } from 'ai'
+import { openai } from '@ai-sdk/openai'
+import { AgentId, ThreadId, UserId, typegraphInit } from '@typegraph-ai/sdk'
+import { typegraphTools } from '@typegraph-ai/vercel-ai-provider'
+
+const tg = await typegraphInit({
+  apiKey: process.env.TYPEGRAPH_API_KEY!,
+})
+
+export async function answerQuestion(req: Request) {
+  const { prompt, userId, threadId } = await req.json()
+
+  const tools = typegraphTools(tg, {
+    context: {
+      userId: UserId(userId),
+      threadId: ThreadId(threadId),
+      agentId: AgentId('support-agent'),
+    },
+  })
+
+  return generateText({
+    model: openai('gpt-4.1-mini'),
+    tools,
+    stopWhen: stepCountIs(4),
+    prompt,
+  })
+}
+```
+
+## Tools
+
+| Tool | Purpose |
+| --- | --- |
+| `typegraph_buckets_list` | List buckets in the configured context |
+| `typegraph_buckets_get` | Fetch one bucket by ID and verify context |
+| `typegraph_buckets_create` | Create a bucket in the configured context |
+| `typegraph_document_ingest` | Ingest one or more documents |
+| `typegraph_search` | Search TypeGraph documents, events, threads, entities, and facts |
+| `typegraph_remember` | Store scoped memory |
+| `typegraph_correct` | Correct scoped memory |
+| `typegraph_jobs_list` | List jobs |
+| `typegraph_jobs_get` | Fetch one job by ID and verify context |
+
+## Context Scoping
+
+Pass `context` to `typegraphTools()` from your trusted auth/session layer:
+
+```ts
+const tools = typegraphTools(tg, {
+  context: {
+    groupId: project.id,
+    userId: user.id,
+    threadId: thread.id,
+  },
+})
+```
+
+The provider merges that context into bucket, document ingest, search, memory,
+and correction calls. Direct lookup tools such as `typegraph_buckets_get` and
+`typegraph_jobs_get` reject records that conflict with the configured context.
+
+Graph access is configured on TypeGraph graphs, not on model-selected tool
+inputs. Use buckets to route document/event writes to the intended graph:
+
+```ts
+await tools.typegraph_document_ingest.execute({
+  document: {
+    name: 'Alice profile',
+    content: 'Alice prefers vegetarian meals.',
+  },
+  options: {
+    bucketId: 'bkt_profiles',
+  },
+}, { toolCallId: 'manual', messages: [] })
+```
+
+The model cannot choose graph access through this tool surface. Set graph access
+in trusted `typegraphInit({ graphs })` config and expose only the buckets/tools
+your agent should use.
+
+## External IDs
+
+External IDs are stable IDs from your app or source systems. Use them in memory
+subjects and entity scopes to keep TypeGraph entities aligned with users,
+accounts, documents, tickets, or messages.
+
+Attach external IDs when storing memory:
+
+```ts
+await tools.typegraph_remember.execute({
+  content: 'Alice prefers short status updates.',
+  subject: {
+    externalIds: [{ type: 'email', id: 'alice@example.com' }],
+    name: 'Alice',
+    entityType: 'person',
+  },
+}, { toolCallId: 'manual', messages: [] })
+```
+
+Use external IDs in search to filter around the same entity:
+
+```ts
+await tools.typegraph_search.execute({
+  text: 'What should I know before replying to Alice?',
+  options: {
+    resources: ['documents', 'facts', 'entities'],
+    weights: { semantic: 1, bm25: 0.7, graph: 0.5, recency: 0.3 },
+    entityScope: {
+      externalIds: [{ type: 'email', id: 'alice@example.com' }],
+      mode: 'filter',
+    },
+    promptBuilder: {
+      format: 'markdown',
+      sections: ['facts', 'chunks'],
+    },
+  },
+}, { toolCallId: 'manual', messages: [] })
+```
+
+## Smoke Test
+
+This bypasses model tool selection and directly verifies the tools call your
+TypeGraph instance with the expected context.
+
+```ts
+import { UserId, typegraphInit } from '@typegraph-ai/sdk'
+import { typegraphTools } from '@typegraph-ai/vercel-ai-provider'
+
+const tg = await typegraphInit({
+  apiKey: process.env.TYPEGRAPH_API_KEY!,
+})
+
+const tools = typegraphTools(tg, {
+  context: {
+    userId: UserId('demo-user'),
+    threadId: 'demo-thread',
+  },
+})
+
+const toolOptions = { toolCallId: 'manual', messages: [] }
+
+await tools.typegraph_remember.execute({
+  content: 'Demo user likes concise answers.',
+  subject: {
+    externalIds: [{ type: 'user_id', id: 'demo-user' }],
+    name: 'Demo User',
+  },
+}, toolOptions)
+
+const memories = await tg.memory.recall('What answer style does this user prefer?', {
+  context: {
+    userId: UserId('demo-user'),
+    threadId: 'demo-thread',
+  },
+  limit: 5,
+})
+
+console.log(memories)
+```
+
+## Memory Middleware
+
+`typegraphMemoryMiddleware()` enriches prompts from scoped memory recall and can
+capture response turns back into a TypeGraph thread. Conversation artifact
+extraction is opt-in.
+
+```ts
+import { typegraphMemoryMiddleware } from '@typegraph-ai/vercel-ai-provider'
+
+const memory = typegraphMemoryMiddleware(tg, {
+  context: {
+    userId: UserId('demo-user'),
+    threadId: ThreadId('demo-thread'),
+    agentId: AgentId('support-agent'),
+  },
+  includeFacts: true,
+  format: 'xml',
+  conversationMemory: {
+    enabled: true,
+    mode: 'extract_and_consolidate',
+  },
+})
+
+const enrichedPrompt = await memory.enrichPrompt('How should I reply?')
+
+await memory.afterResponse([
+  { role: 'user', content: 'How should I reply?' },
+  { role: 'assistant', content: 'Use a concise answer and mention the SSO workaround.' },
+])
+```
+
+`afterResponse()` always stores supplied turns with `thread.addTurn()`. When
+`conversationMemory.enabled` is true, it also calls `memory.extractThread()`.
+When `mode` is `extract_and_consolidate`, it follows with
+`memory.consolidate()`. Leave `conversationMemory` unset when you only want
+prompt enrichment and turn capture.
+
+## API
+
+| Export | Description |
+| --- | --- |
+| `typegraphTools(typegraph, opts)` | Full Vercel AI SDK tool set |
+| `typegraphMemoryTools(memory, opts)` | Memory-only subset for remember/correct |
+| `typegraphMemoryMiddleware(typegraph, opts)` | Prompt enrichment, turn capture, and optional conversation memory extraction |
+
+## Related
+
+- [TypeGraph main repo](../../README.md)
+- [AI SDK tools](https://ai-sdk.dev/docs/ai-sdk-core/tools-and-tool-calling)

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { typegraphTools, typegraphMemoryTools } from './provider.js';
+export type { TypegraphToolDefinition, TypegraphToolName, TypegraphToolsOptions, TypegraphToolsTarget, TypegraphScopedMemoryTarget, } from './provider.js';
+export { typegraphMemoryMiddleware } from './middleware.js';
+export type { MemoryMiddlewareOpts } from './middleware.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACpE,YAAY,EACV,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAA;AAC3D,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { typegraphTools, typegraphMemoryTools } from './provider.js';
+export { typegraphMemoryMiddleware } from './middleware.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AASpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/middleware.d.ts

@@ -0,0 +1,50 @@
+import type { TypeGraphContext, typegraphInstance } from '@typegraph-ai/sdk';
+export interface MemoryMiddlewareOpts {
+    /** Trusted request context merged into recall and turn capture calls. */
+    context?: TypeGraphContext | undefined;
+    /** Run graph extraction when captured turns are stored. Default: false */
+    graphExtraction?: boolean | undefined;
+    /** Include semantic facts. Default: true */
+    includeFacts?: boolean | undefined;
+    /** Include episodic memories. Default: false */
+    includeEpisodes?: boolean | undefined;
+    /** Include procedural memories. Default: false */
+    includeProcedures?: boolean | undefined;
+    /** Maximum number of memories to recall. Default: 10 */
+    limit?: number | undefined;
+    /** Output format. Default: 'xml' */
+    format?: 'xml' | 'markdown' | 'plain' | undefined;
+    /** Opt-in conversation artifact extraction and consolidation after turns are captured. */
+    conversationMemory?: {
+        enabled?: boolean | undefined;
+        mode?: 'extract' | 'extract_and_consolidate' | undefined;
+        layoutId?: string | undefined;
+        includeRoles?: Array<'user' | 'assistant' | 'tool' | 'system'> | undefined;
+        maxTranscriptChars?: number | undefined;
+        maxRawMemories?: number | undefined;
+    } | undefined;
+}
+/**
+ * Create middleware that auto-injects memory context into LLM prompts.
+ *
+ * Returns a function that takes a prompt string and prepends memory context.
+ * Compatible with Vercel AI SDK's middleware pattern.
+ *
+ * @example
+ * ```ts
+ * const middleware = typegraphMemoryMiddleware(memory)
+ * const enrichedPrompt = await middleware.enrichPrompt('What should Alice have for dinner?')
+ * ```
+ */
+export declare function typegraphMemoryMiddleware(typegraph: Pick<typegraphInstance, 'memory' | 'thread'>, opts?: MemoryMiddlewareOpts): {
+    enrichPrompt(prompt: string): Promise<string>;
+    enrichSystem(systemPrompt: string, userQuery: string): Promise<string>;
+    /**
+     * After a response, ingest the thread turn into memory.
+     */
+    afterResponse(messages: {
+        role: "user" | "assistant" | "tool" | "system";
+        content: string;
+    }[], threadId?: string): Promise<void>;
+};
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAM5E,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAA;IACtC,0EAA0E;IAC1E,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACrC,4CAA4C;IAC5C,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAClC,gDAAgD;IAChD,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACrC,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACvC,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,oCAAoC;IACpC,MAAM,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAA;IACjD,0FAA0F;IAC1F,kBAAkB,CAAC,EAAE;QACnB,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC7B,IAAI,CAAC,EAAE,SAAS,GAAG,yBAAyB,GAAG,SAAS,CAAA;QACxD,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC7B,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC,GAAG,SAAS,CAAA;QAC1E,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACvC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KACpC,GAAG,SAAS,CAAA;CACd;AAUD;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,QAAQ,CAAC,EAAE,IAAI,GAAE,oBAAyB;yBAMnG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;+BAOlB,MAAM,aAAa,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO5E;;OAEG;4BAES;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,aACpE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;EAgCnB"}

package/dist/middleware.js

@@ -0,0 +1,80 @@
+function typesFor(opts) {
+    const types = [];
+    if (opts.includeFacts !== false)
+        types.push('semantic');
+    if (opts.includeEpisodes)
+        types.push('episodic');
+    if (opts.includeProcedures)
+        types.push('procedural');
+    return types;
+}
+/**
+ * Create middleware that auto-injects memory context into LLM prompts.
+ *
+ * Returns a function that takes a prompt string and prepends memory context.
+ * Compatible with Vercel AI SDK's middleware pattern.
+ *
+ * @example
+ * ```ts
+ * const middleware = typegraphMemoryMiddleware(memory)
+ * const enrichedPrompt = await middleware.enrichPrompt('What should Alice have for dinner?')
+ * ```
+ */
+export function typegraphMemoryMiddleware(typegraph, opts = {}) {
+    const types = typesFor(opts);
+    const format = opts.format ?? 'xml';
+    const limit = opts.limit ?? 10;
+    return {
+        async enrichPrompt(prompt) {
+            if (types.length === 0)
+                return prompt;
+            const context = await typegraph.memory.recall(prompt, { context: opts.context, types, limit, format });
+            if (!context)
+                return prompt;
+            return `${context}\n\n${prompt}`;
+        },
+        async enrichSystem(systemPrompt, userQuery) {
+            if (types.length === 0)
+                return systemPrompt;
+            const context = await typegraph.memory.recall(userQuery, { context: opts.context, types, limit, format });
+            if (!context)
+                return systemPrompt;
+            return `${systemPrompt}\n\n${context}`;
+        },
+        /**
+         * After a response, ingest the thread turn into memory.
+         */
+        async afterResponse(messages, threadId) {
+            const resolvedThreadId = threadId ?? opts.context?.threadId;
+            if (!resolvedThreadId) {
+                throw new Error('typegraphMemoryMiddleware.afterResponse requires a threadId argument or opts.context.threadId.');
+            }
+            for (const message of messages) {
+                await typegraph.thread.addTurn(String(resolvedThreadId), {
+                    role: message.role,
+                    content: message.content,
+                }, {
+                    context: opts.context,
+                    graphExtraction: opts.graphExtraction,
+                });
+            }
+            const conversationMemory = opts.conversationMemory;
+            if (conversationMemory?.enabled) {
+                await typegraph.memory.extractThread(String(resolvedThreadId), {
+                    context: opts.context,
+                    layoutId: conversationMemory.layoutId,
+                    includeRoles: conversationMemory.includeRoles,
+                    maxTranscriptChars: conversationMemory.maxTranscriptChars,
+                });
+                if (conversationMemory.mode === 'extract_and_consolidate') {
+                    await typegraph.memory.consolidate({
+                        context: opts.context,
+                        layoutId: conversationMemory.layoutId,
+                        maxRawMemories: conversationMemory.maxRawMemories,
+                    });
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"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"}

package/dist/provider.d.ts

@@ -0,0 +1,16 @@
+import { type Tool } from 'ai';
+import type { TypeGraphContext, typegraphInstance } from '@typegraph-ai/sdk';
+export type TypegraphToolName = 'typegraph_buckets_list' | 'typegraph_buckets_get' | 'typegraph_buckets_create' | 'typegraph_document_ingest' | 'typegraph_search' | 'typegraph_remember' | 'typegraph_correct' | 'typegraph_jobs_list' | 'typegraph_jobs_get';
+export type TypegraphToolDefinition = Tool<any, unknown>;
+export type TypegraphToolsTarget = Pick<typegraphInstance, 'bucket' | 'document' | 'search' | 'memory' | 'job'>;
+export type TypegraphScopedMemoryTarget = Pick<typegraphInstance['memory'], 'remember' | 'correct'>;
+export interface TypegraphToolsOptions {
+    /**
+     * Trusted request context supplied by your server. This is merged into every
+     * scoped TypeGraph call so the model cannot select another user/group/agent scope.
+     */
+    context?: TypeGraphContext | undefined;
+}
+export declare function typegraphMemoryTools(memory: TypegraphScopedMemoryTarget, opts?: TypegraphToolsOptions): Pick<Record<TypegraphToolName, TypegraphToolDefinition>, 'typegraph_remember' | 'typegraph_correct'>;
+export declare function typegraphTools(typegraph: TypegraphToolsTarget, opts?: TypegraphToolsOptions): Record<TypegraphToolName, TypegraphToolDefinition>;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,IAAI,CAAA;AAC1C,OAAO,KAAK,EAUV,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,mBAAmB,CAAA;AAE1B,MAAM,MAAM,iBAAiB,GACzB,wBAAwB,GACxB,uBAAuB,GACvB,0BAA0B,GAC1B,2BAA2B,GAC3B,kBAAkB,GAClB,oBAAoB,GACpB,mBAAmB,GACnB,qBAAqB,GACrB,oBAAoB,CAAA;AAExB,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;AAExD,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,iBAAiB,EACjB,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,CACpD,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC5C,iBAAiB,CAAC,QAAQ,CAAC,EAC3B,UAAU,GAAG,SAAS,CACvB,CAAA;AAED,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAA;CACvC;AAqOD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,2BAA2B,EACnC,IAAI,GAAE,qBAA0B,GAC/B,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,EAAE,oBAAoB,GAAG,mBAAmB,CAAC,CAKtG;AAED,wBAAgB,cAAc,CAC5B,SAAS,EAAE,oBAAoB,EAC/B,IAAI,GAAE,qBAA0B,GAC/B,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,CA0NpD"}

package/dist/provider.js

@@ -0,0 +1,397 @@
+import { jsonSchema } from 'ai';
+const IDENTITY_KEYS = [
+    'organizationId',
+    'groupId',
+    'userId',
+    'agentId',
+    'threadId',
+];
+function compactObject(value) {
+    const out = {};
+    for (const [key, item] of Object.entries(value)) {
+        if (item !== undefined && item !== null)
+            out[key] = item;
+    }
+    return out;
+}
+function compactContext(context) {
+    if (!context)
+        return undefined;
+    const out = {};
+    for (const key of IDENTITY_KEYS) {
+        const value = context[key];
+        if (value !== undefined && value !== null) {
+            ;
+            out[key] = value;
+        }
+    }
+    if (context.traceId)
+        out.traceId = context.traceId;
+    if (context.spanId)
+        out.spanId = context.spanId;
+    if (context.agentName)
+        out.agentName = context.agentName;
+    if (context.agentDescription)
+        out.agentDescription = context.agentDescription;
+    if (context.agentVersion)
+        out.agentVersion = context.agentVersion;
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+function scopedOptions(value, opts) {
+    const context = compactContext(opts.context);
+    return compactObject({
+        ...(value ?? {}),
+        ...(context ? { context } : {}),
+    });
+}
+function scopedQueryOptions(value, opts) {
+    return scopedOptions((value ?? {}), opts);
+}
+function normalizeDocument(document) {
+    return compactObject({
+        ...document,
+        updatedAt: coerceDate(document.updatedAt),
+        createdAt: coerceDate(document.createdAt),
+    });
+}
+function coerceDate(value) {
+    if (value instanceof Date)
+        return value;
+    if (typeof value === 'string' || typeof value === 'number')
+        return new Date(value);
+    return undefined;
+}
+function assertMatchesContext(record, context, label) {
+    if (!record || !context)
+        return;
+    for (const key of IDENTITY_KEYS) {
+        const expected = context[key];
+        if (expected === undefined)
+            continue;
+        const actual = record[key] ?? record['identity']?.[key];
+        if (actual !== undefined && actual !== expected) {
+            throw new Error(`${label} is outside the configured TypeGraph context.`);
+        }
+    }
+}
+function schema(json) {
+    return jsonSchema(json);
+}
+const externalIdSchema = {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+        id: { type: 'string', description: 'Stable identifier from your app or source system.' },
+        type: { type: 'string', description: 'Identifier namespace, e.g. email, clerk_user_id, slack_user_id.' },
+        encoding: { type: 'string', enum: ['none', 'sha256'] },
+        metadata: { type: 'object', additionalProperties: true },
+    },
+    required: ['id', 'type'],
+};
+const subjectSchema = {
+    type: 'object',
+    additionalProperties: true,
+    properties: {
+        entityId: { type: 'string' },
+        externalIds: { type: 'array', items: externalIdSchema },
+        name: { type: 'string' },
+        entityType: { type: 'string' },
+        aliases: { type: 'array', items: { type: 'string' } },
+        description: { type: 'string' },
+        metadata: { type: 'object', additionalProperties: true },
+    },
+};
+const documentSchema = {
+    type: 'object',
+    additionalProperties: true,
+    properties: {
+        id: { type: 'string' },
+        name: { type: 'string' },
+        description: { type: 'string' },
+        content: { type: 'string' },
+        url: { type: 'string' },
+        createdAt: { type: 'string', description: 'ISO timestamp.' },
+        updatedAt: { type: 'string', description: 'ISO timestamp.' },
+        mimeType: { type: 'string' },
+        language: { type: 'string' },
+        metadata: { type: 'object', additionalProperties: true },
+    },
+    required: ['content', 'name'],
+};
+const paginationSchema = {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+        limit: { type: 'number' },
+        offset: { type: 'number' },
+    },
+};
+const indexDefaultsSchema = {
+    type: 'object',
+    additionalProperties: true,
+    properties: {
+        chunkSize: { type: 'number' },
+        chunkOverlap: { type: 'number' },
+        stripMarkdownForEmbedding: { type: 'boolean' },
+        propagateMetadata: { type: 'array', items: { type: 'string' } },
+        graphExtraction: { type: 'boolean' },
+    },
+};
+function memoryRememberTool(target, opts) {
+    return {
+        description: 'Store a scoped TypeGraph memory for future recall.',
+        inputSchema: schema({
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                content: { type: 'string', description: 'Memory content to store.' },
+                category: { type: 'string', enum: ['episodic', 'semantic', 'procedural'] },
+                importance: { type: 'number', minimum: 0, maximum: 1 },
+                metadata: { type: 'object', additionalProperties: true },
+                subject: subjectSchema,
+                relatedEntities: { type: 'array', items: subjectSchema },
+            },
+            required: ['content'],
+        }),
+        execute: async (input) => {
+            const { content, ...rest } = input;
+            return target.remember(content, scopedOptions(rest, opts));
+        },
+    };
+}
+function memoryCorrectTool(target, opts) {
+    return {
+        description: 'Correct scoped TypeGraph memory with a natural language correction.',
+        inputSchema: schema({
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                correction: { type: 'string', description: 'Natural language correction to apply.' },
+                subject: subjectSchema,
+                relatedEntities: { type: 'array', items: subjectSchema },
+            },
+            required: ['correction'],
+        }),
+        execute: async (input) => {
+            const { correction, ...rest } = input;
+            return target.correct(correction, scopedOptions(rest, opts));
+        },
+    };
+}
+export function typegraphMemoryTools(memory, opts = {}) {
+    return {
+        typegraph_remember: memoryRememberTool(memory, opts),
+        typegraph_correct: memoryCorrectTool(memory, opts),
+    };
+}
+export function typegraphTools(typegraph, opts = {}) {
+    return {
+        typegraph_buckets_list: {
+            description: 'List TypeGraph buckets in the configured context.',
+            inputSchema: schema({
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    filter: {
+                        type: 'object',
+                        additionalProperties: false,
+                        properties: {
+                            name: { type: 'string' },
+                        },
+                        description: 'Optional non-context bucket filters. Context is supplied by the server.',
+                    },
+                    pagination: paginationSchema,
+                },
+            }),
+            execute: async (input) => {
+                return typegraph.bucket.list(input.filter ?? {}, scopedOptions({}, opts), input.pagination);
+            },
+        },
+        typegraph_buckets_get: {
+            description: 'Get one TypeGraph bucket by ID.',
+            inputSchema: schema({
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    bucketId: { type: 'string' },
+                },
+                required: ['bucketId'],
+            }),
+            execute: async (input) => {
+                const bucket = await typegraph.bucket.get(input.bucketId);
+                assertMatchesContext(bucket, opts.context, 'Bucket');
+                return bucket;
+            },
+        },
+        typegraph_buckets_create: {
+            description: 'Create a TypeGraph bucket in the configured context.',
+            inputSchema: schema({
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    name: { type: 'string' },
+                    description: { type: 'string' },
+                    embeddingModel: { type: 'string' },
+                    searchEmbeddingModel: { type: 'string' },
+                    indexDefaults: indexDefaultsSchema,
+                },
+                required: ['name'],
+            }),
+            execute: async (input) => {
+                return typegraph.bucket.create(input, scopedOptions({}, opts));
+            },
+        },
+        typegraph_document_ingest: {
+            description: 'Ingest one or more documents into TypeGraph in the configured context.',
+            inputSchema: schema({
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    document: documentSchema,
+                    documents: { type: 'array', items: documentSchema },
+                    options: {
+                        type: 'object',
+                        additionalProperties: true,
+                        properties: {
+                            bucketId: { type: 'string' },
+                            mode: { type: 'string', enum: ['upsert', 'replace'] },
+                            chunkSize: { type: 'number' },
+                            chunkOverlap: { type: 'number' },
+                            stripMarkdownForEmbedding: { type: 'boolean' },
+                            graphExtraction: { type: 'boolean' },
+                            dryRun: { type: 'boolean' },
+                            concurrency: { type: 'number' },
+                        },
+                    },
+                },
+            }),
+            execute: async (input) => {
+                const documents = [
+                    ...(input.document ? [input.document] : []),
+                    ...(input.documents ?? []),
+                ].map(normalizeDocument);
+                if (documents.length === 0) {
+                    throw new Error('typegraph_document_ingest requires document or documents.');
+                }
+                return typegraph.document.ingest(documents, {
+                    ...scopedOptions((input.options ?? {}), opts),
+                });
+            },
+        },
+        typegraph_search: {
+            description: 'Search TypeGraph retrieval results in the configured context.',
+            inputSchema: schema({
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    text: { type: 'string', description: 'Natural language query.' },
+                    options: {
+                        type: 'object',
+                        additionalProperties: true,
+                        properties: {
+                            buckets: { type: 'array', items: { type: 'string' } },
+                            limit: { type: 'number' },
+                            resources: {
+                                type: 'array',
+                                items: {
+                                    type: 'string',
+                                    enum: ['documents', 'events', 'threads', 'entities', 'facts'],
+                                },
+                            },
+                            weights: {
+                                type: 'object',
+                                additionalProperties: false,
+                                properties: {
+                                    semantic: { anyOf: [{ type: 'number' }, { const: false }] },
+                                    bm25: { anyOf: [{ type: 'number' }, { const: false }] },
+                                    graph: { anyOf: [{ type: 'number' }, { const: false }] },
+                                    recency: { anyOf: [{ type: 'number' }, { const: false }] },
+                                },
+                            },
+                            fusion: {
+                                type: 'object',
+                                additionalProperties: false,
+                                properties: {
+                                    method: { type: 'string', enum: ['rrf'] },
+                                    k: { type: 'number' },
+                                },
+                            },
+                            entityScope: {
+                                type: 'object',
+                                additionalProperties: false,
+                                properties: {
+                                    entityIds: { type: 'array', items: { type: 'string' } },
+                                    externalIds: { type: 'array', items: externalIdSchema },
+                                    mode: { type: 'string', enum: ['filter', 'boost'] },
+                                },
+                            },
+                            promptBuilder: {
+                                anyOf: [
+                                    { type: 'boolean' },
+                                    {
+                                        type: 'object',
+                                        additionalProperties: true,
+                                        properties: {
+                                            format: { type: 'string', enum: ['xml', 'markdown', 'plain'] },
+                                            sections: {
+                                                type: 'array',
+                                                items: { type: 'string', enum: ['facts', 'entities', 'chunks'] },
+                                            },
+                                            maxTotalTokens: { type: 'number' },
+                                        },
+                                    },
+                                ],
+                            },
+                            includeInvalidated: { type: 'boolean' },
+                            explain: { type: 'boolean' },
+                        },
+                    },
+                },
+                required: ['text'],
+            }),
+            execute: async (input) => {
+                return typegraph.search(input.text, scopedQueryOptions(input.options, opts));
+            },
+        },
+        typegraph_remember: memoryRememberTool(typegraph.memory, opts),
+        typegraph_correct: memoryCorrectTool(typegraph.memory, opts),
+        typegraph_jobs_list: {
+            description: 'List TypeGraph jobs in the configured context.',
+            inputSchema: schema({
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    filter: {
+                        type: 'object',
+                        additionalProperties: false,
+                        properties: {
+                            bucketId: { type: 'string' },
+                            status: { type: 'string', enum: ['pending', 'processing', 'complete', 'failed'] },
+                            type: { type: 'string', enum: ['ingest', 'remember', 'thread_turn', 'correct', 'forget'] },
+                        },
+                    },
+                },
+            }),
+            execute: async (input) => {
+                return typegraph.job.list((input.filter ?? {}));
+            },
+        },
+        typegraph_jobs_get: {
+            description: 'Get one TypeGraph job by ID.',
+            inputSchema: schema({
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    jobId: { type: 'string' },
+                },
+                required: ['jobId'],
+            }),
+            execute: async (input) => {
+                const job = await typegraph.job.get(input.jobId);
+                assertMatchesContext(job, opts.context, 'Job');
+                return job;
+            },
+        },
+    };
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@typegraph-ai/vercel-ai-provider",
+  "version": "0.2.0",
+  "description": "Vercel AI SDK tools and memory helpers for TypeGraph",
+  "type": "module",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@typegraph-ai/sdk": "0.6.0"
+  },
+  "peerDependencies": {
+    "ai": "^6.0.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "devDependencies": {
+    "ai": "^6.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}