@soulcraft/sdk 1.0.0

package/dist/client/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @module @soulcraft/sdk/client
+ * @description Browser/client entry point for @soulcraft/sdk. Exports everything needed
+ * for kit apps running in a browser context to connect to a Soulcraft product backend.
+ *
+ * Includes: HTTP (JSON RPC), WebSocket (MessagePack binary RPC + change push), and
+ * SSE (server-push) transports. Cookie-based and Bearer token auth. The Brainy proxy
+ * factory for creating a fully-typed `sdk.brainy` API surface over any transport.
+ *
+ * This entry point has no server-only dependencies — it is safe to bundle for the
+ * browser. The trade-off is that it cannot create Brainy instances directly.
+ *
+ * @example HTTP transport (kit apps, stateless)
+ * ```typescript
+ * import { createBrainyProxy, HttpTransport } from '@soulcraft/sdk/client'
+ *
+ * const brainy = createBrainyProxy(
+ *   new HttpTransport('https://workshop.soulcraft.com', undefined, true)
+ * )
+ *
+ * const results = await brainy.find({ query: 'candle kits', limit: 10 })
+ * ```
+ *
+ * @example WebSocket transport (real-time, change push)
+ * ```typescript
+ * import { createBrainyProxy, WsTransport } from '@soulcraft/sdk/client'
+ *
+ * const transport = new WsTransport(
+ *   'wss://venue.soulcraft.com/api/brainy/ws',
+ *   capabilityToken,
+ *   'wicks-and-whiskers'
+ * )
+ * await transport.connect()
+ *
+ * const brainy = createBrainyProxy(transport)
+ * brainy.onDataChange((event) => console.log('live change:', event))
+ *
+ * const items = await brainy.find({ query: 'inventory' })
+ * ```
+ *
+ * @example SSE transport (receive-only change events, paired with HTTP)
+ * ```typescript
+ * import { createBrainyProxy, HttpTransport, SseTransport } from '@soulcraft/sdk/client'
+ *
+ * const http = new HttpTransport('https://venue.soulcraft.com', undefined, true)
+ * const sse = new SseTransport('https://venue.soulcraft.com', workspaceId)
+ * sse.connect()
+ *
+ * const brainy = createBrainyProxy(http)
+ * sse.onEvent((event) => refreshUI(event))
+ * ```
+ */
+export { HttpTransport } from '../transports/http.js';
+export { WsTransport } from '../transports/ws.js';
+export { SseTransport } from '../transports/sse.js';
+export type { SDKTransport } from '../transports/transport.js';
+export { createBrainyProxy } from '../modules/brainy/proxy.js';
+export type { ClientSDKOptions } from '../types.js';
+export type { SoulcraftBrainy } from '../modules/brainy/types.js';
+export type { BrainyChangeEvent } from '../modules/brainy/events.js';
+export { SDKError, SDKDisconnectedError, SDKTimeoutError, SDKAuthError, SDKForbiddenError, SDKRpcError, SDKMethodNotFoundError, } from '../modules/brainy/errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAG9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAG9D,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACjE,YAAY,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,6BAA6B,CAAA"}

package/dist/client/index.js

@@ -0,0 +1,60 @@
+/**
+ * @module @soulcraft/sdk/client
+ * @description Browser/client entry point for @soulcraft/sdk. Exports everything needed
+ * for kit apps running in a browser context to connect to a Soulcraft product backend.
+ *
+ * Includes: HTTP (JSON RPC), WebSocket (MessagePack binary RPC + change push), and
+ * SSE (server-push) transports. Cookie-based and Bearer token auth. The Brainy proxy
+ * factory for creating a fully-typed `sdk.brainy` API surface over any transport.
+ *
+ * This entry point has no server-only dependencies — it is safe to bundle for the
+ * browser. The trade-off is that it cannot create Brainy instances directly.
+ *
+ * @example HTTP transport (kit apps, stateless)
+ * ```typescript
+ * import { createBrainyProxy, HttpTransport } from '@soulcraft/sdk/client'
+ *
+ * const brainy = createBrainyProxy(
+ *   new HttpTransport('https://workshop.soulcraft.com', undefined, true)
+ * )
+ *
+ * const results = await brainy.find({ query: 'candle kits', limit: 10 })
+ * ```
+ *
+ * @example WebSocket transport (real-time, change push)
+ * ```typescript
+ * import { createBrainyProxy, WsTransport } from '@soulcraft/sdk/client'
+ *
+ * const transport = new WsTransport(
+ *   'wss://venue.soulcraft.com/api/brainy/ws',
+ *   capabilityToken,
+ *   'wicks-and-whiskers'
+ * )
+ * await transport.connect()
+ *
+ * const brainy = createBrainyProxy(transport)
+ * brainy.onDataChange((event) => console.log('live change:', event))
+ *
+ * const items = await brainy.find({ query: 'inventory' })
+ * ```
+ *
+ * @example SSE transport (receive-only change events, paired with HTTP)
+ * ```typescript
+ * import { createBrainyProxy, HttpTransport, SseTransport } from '@soulcraft/sdk/client'
+ *
+ * const http = new HttpTransport('https://venue.soulcraft.com', undefined, true)
+ * const sse = new SseTransport('https://venue.soulcraft.com', workspaceId)
+ * sse.connect()
+ *
+ * const brainy = createBrainyProxy(http)
+ * sse.onEvent((event) => refreshUI(event))
+ * ```
+ */
+// ── Transport classes ─────────────────────────────────────────────────────────
+export { HttpTransport } from '../transports/http.js';
+export { WsTransport } from '../transports/ws.js';
+export { SseTransport } from '../transports/sse.js';
+// ── Proxy factory ─────────────────────────────────────────────────────────────
+export { createBrainyProxy } from '../modules/brainy/proxy.js';
+export { SDKError, SDKDisconnectedError, SDKTimeoutError, SDKAuthError, SDKForbiddenError, SDKRpcError, SDKMethodNotFoundError, } from '../modules/brainy/errors.js';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAEH,iFAAiF;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGnD,iFAAiF;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAM9D,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,6BAA6B,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @module @soulcraft/sdk
+ * @description Shared entry point for @soulcraft/sdk. Exports the createSDK factory,
+ * all shared types, and re-exports from every module namespace. This entry point is
+ * safe to import in any environment (server or browser).
+ *
+ * For server-specific exports (Brainy lifecycle, Cortex, auth middleware, RPC handlers),
+ * use `@soulcraft/sdk/server`.
+ *
+ * For browser-specific exports (HTTP/WS/SSE transports, cookie auth), use
+ * `@soulcraft/sdk/client`.
+ */
+export type { SoulcraftSDK, SDKOptions, ServerSDKOptions, ClientSDKOptions } from './types.js';
+export type { SoulcraftBrainy } from './modules/brainy/types.js';
+export type { Entity, Relation, Result, AddParams, UpdateParams, RelateParams, FindParams, BrainyConfig, AggregateDefinition, DiagnosticsResult, MigrationResult, MigrateOptions, MigrationPreview, NounType, VerbType, BrainyChangeEvent, BrainyChangeEntity, BrainyChangeRelation, } from './modules/brainy/types.js';
+export type { CreateCapabilityTokenOptions, CapabilityTokenClaims, } from './modules/brainy/auth.js';
+export { createCapabilityToken, verifyCapabilityToken, } from './modules/brainy/auth.js';
+export { SDKError, SDKDisconnectedError, SDKTimeoutError, SDKAuthError, SDKForbiddenError, SDKRpcError, SDKMethodNotFoundError, } from './modules/brainy/errors.js';
+export type { VfsModule } from './modules/vfs/types.js';
+export type { VersionsModule } from './modules/versions/types.js';
+export type { HallModule, HallConfig, RoomOptions, RecordingManifest, ConceptEvent, RelationProposedEvent, AttentionEvent, RoomEventMap, } from './modules/hall/types.js';
+export type { AuthModule, PlatformRole, SoulcraftAuthProvider, SoulcraftOrganization, SoulcraftUserFields, SoulcraftSessionUser, SoulcraftSession, OIDCClientConfig, AuthMode, } from './modules/auth/types.js';
+export { SOULCRAFT_USER_FIELDS, SOULCRAFT_SESSION_CONFIG, computeEmailHash, getAuthMode, getOIDCClientConfig, } from './modules/auth/config.js';
+export type { AiModule, AiCompleteOptions, AiCompleteResult, AiStreamOptions, AiStreamEvent, AiToolCall, AiMessage, AiContentBlock, AiTool, AiModel, } from './modules/ai/types.js';
+export { AI_MODELS } from './modules/ai/types.js';
+export type { EventsModule, SoulcraftEventMap, SoulcraftEventName, VfsWriteEvent, VfsDeleteEvent, VfsRenameEvent, } from './modules/events/types.js';
+export type { SkillsModule, Skill, SkillListOptions, SkillInstallOptions, } from './modules/skills/types.js';
+export type * from './modules/license/types.js';
+export type * from './modules/kits/types.js';
+export type * from './modules/formats/types.js';
+export type * from './modules/billing/types.js';
+export type * from './modules/notifications/types.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;;;;;;;;;;;GAWG;AAEH,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAG9F,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAChE,YAAY,EACV,MAAM,EACN,QAAQ,EACR,MAAM,EACN,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,QAAQ,EACR,QAAQ,EACR,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,2BAA2B,CAAA;AAClC,YAAY,EACV,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,4BAA4B,CAAA;AAGnC,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAGvD,YAAY,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAGjE,YAAY,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,YAAY,GACb,MAAM,yBAAyB,CAAA;AAGhC,YAAY,EACV,UAAU,EACV,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,GACT,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EAChB,WAAW,EACX,mBAAmB,GACpB,MAAM,0BAA0B,CAAA;AAGjC,YAAY,EACV,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,UAAU,EACV,SAAS,EACT,cAAc,EACd,MAAM,EACN,OAAO,GACR,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAGjD,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,cAAc,GACf,MAAM,2BAA2B,CAAA;AAGlC,YAAY,EACV,YAAY,EACZ,KAAK,EACL,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,2BAA2B,CAAA;AAGlC,mBAAmB,4BAA4B,CAAA;AAC/C,mBAAmB,yBAAyB,CAAA;AAC5C,mBAAmB,4BAA4B,CAAA;AAC/C,mBAAmB,4BAA4B,CAAA;AAC/C,mBAAmB,kCAAkC,CAAA"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @module @soulcraft/sdk
+ * @description Shared entry point for @soulcraft/sdk. Exports the createSDK factory,
+ * all shared types, and re-exports from every module namespace. This entry point is
+ * safe to import in any environment (server or browser).
+ *
+ * For server-specific exports (Brainy lifecycle, Cortex, auth middleware, RPC handlers),
+ * use `@soulcraft/sdk/server`.
+ *
+ * For browser-specific exports (HTTP/WS/SSE transports, cookie auth), use
+ * `@soulcraft/sdk/client`.
+ */
+export { createCapabilityToken, verifyCapabilityToken, } from './modules/brainy/auth.js';
+export { SDKError, SDKDisconnectedError, SDKTimeoutError, SDKAuthError, SDKForbiddenError, SDKRpcError, SDKMethodNotFoundError, } from './modules/brainy/errors.js';
+export { SOULCRAFT_USER_FIELDS, SOULCRAFT_SESSION_CONFIG, computeEmailHash, getAuthMode, getOIDCClientConfig, } from './modules/auth/config.js';
+export { AI_MODELS } from './modules/ai/types.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;;;;;;;;;;;GAWG;AA8BH,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,4BAA4B,CAAA;AAgCnC,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EAChB,WAAW,EACX,mBAAmB,GACpB,MAAM,0BAA0B,CAAA;AAejC,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/modules/ai/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @module modules/ai
+ * @description Claude AI integration for @soulcraft/sdk.
+ *
+ * Wraps the `@anthropic-ai/sdk` client with Soulcraft-specific defaults and
+ * conventions. Exposes a simple `complete()` + `stream()` API that handles
+ * message formatting, tool call extraction, and usage tracking without
+ * per-callsite boilerplate.
+ *
+ * The Anthropic API key is read from `ANTHROPIC_API_KEY` in the environment.
+ * The module fails fast (at SDK creation time) if the key is absent in
+ * production (`NODE_ENV=production`).
+ *
+ * ## Tool call flow
+ *
+ * When Claude calls a tool, `complete()` returns a result with `toolCalls`
+ * populated and `stopReason === 'tool_use'`. The caller executes the tool,
+ * appends a `tool_result` content block to the messages, and calls `complete()`
+ * again to get Claude's follow-up response. The SDK does not auto-loop tool
+ * calls — explicit control keeps kit code predictable.
+ *
+ * @example
+ * ```typescript
+ * import { createAiModule } from '@soulcraft/sdk/server'
+ *
+ * const ai = createAiModule()
+ *
+ * const result = await ai.complete({
+ *   model: 'claude-haiku-4-5-20251001',
+ *   systemPrompt: kit.shared.aiPersona,
+ *   messages: [{ role: 'user', content: 'What candles are low in stock?' }],
+ *   tools: [searchInventoryTool],
+ * })
+ * ```
+ */
+import type { AiModule } from './types.js';
+/**
+ * Creates an `AiModule` backed by the Anthropic Claude API.
+ *
+ * Reads `ANTHROPIC_API_KEY` from the environment. In production, throws if
+ * the key is absent so misconfigured deployments fail loudly at startup.
+ *
+ * @returns A configured {@link AiModule} instance.
+ * @throws {Error} If `ANTHROPIC_API_KEY` is absent in production.
+ *
+ * @example
+ * ```typescript
+ * const ai = createAiModule()
+ * const result = await ai.complete({ messages: [...], model: 'claude-sonnet-4-6' })
+ * ```
+ */
+export declare function createAiModule(): AiModule;
+export type { AiModule, AiCompleteOptions, AiCompleteResult, AiStreamOptions, AiStreamEvent, AiToolCall, AiMessage, AiContentBlock, AiTool, AiModel, } from './types.js';
+export { AI_MODELS } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/ai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,OAAO,KAAK,EACV,QAAQ,EAMT,MAAM,YAAY,CAAA;AAOnB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CAqBzC;AA6MD,YAAY,EACV,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,UAAU,EACV,SAAS,EACT,cAAc,EACd,MAAM,EACN,OAAO,GACR,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA"}

package/dist/modules/ai/index.js

@@ -0,0 +1,263 @@
+/**
+ * @module modules/ai
+ * @description Claude AI integration for @soulcraft/sdk.
+ *
+ * Wraps the `@anthropic-ai/sdk` client with Soulcraft-specific defaults and
+ * conventions. Exposes a simple `complete()` + `stream()` API that handles
+ * message formatting, tool call extraction, and usage tracking without
+ * per-callsite boilerplate.
+ *
+ * The Anthropic API key is read from `ANTHROPIC_API_KEY` in the environment.
+ * The module fails fast (at SDK creation time) if the key is absent in
+ * production (`NODE_ENV=production`).
+ *
+ * ## Tool call flow
+ *
+ * When Claude calls a tool, `complete()` returns a result with `toolCalls`
+ * populated and `stopReason === 'tool_use'`. The caller executes the tool,
+ * appends a `tool_result` content block to the messages, and calls `complete()`
+ * again to get Claude's follow-up response. The SDK does not auto-loop tool
+ * calls — explicit control keeps kit code predictable.
+ *
+ * @example
+ * ```typescript
+ * import { createAiModule } from '@soulcraft/sdk/server'
+ *
+ * const ai = createAiModule()
+ *
+ * const result = await ai.complete({
+ *   model: 'claude-haiku-4-5-20251001',
+ *   systemPrompt: kit.shared.aiPersona,
+ *   messages: [{ role: 'user', content: 'What candles are low in stock?' }],
+ *   tools: [searchInventoryTool],
+ * })
+ * ```
+ */
+import Anthropic from '@anthropic-ai/sdk';
+import { AI_MODELS } from './types.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Factory
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Creates an `AiModule` backed by the Anthropic Claude API.
+ *
+ * Reads `ANTHROPIC_API_KEY` from the environment. In production, throws if
+ * the key is absent so misconfigured deployments fail loudly at startup.
+ *
+ * @returns A configured {@link AiModule} instance.
+ * @throws {Error} If `ANTHROPIC_API_KEY` is absent in production.
+ *
+ * @example
+ * ```typescript
+ * const ai = createAiModule()
+ * const result = await ai.complete({ messages: [...], model: 'claude-sonnet-4-6' })
+ * ```
+ */
+export function createAiModule() {
+    const apiKey = process.env['ANTHROPIC_API_KEY'];
+    if (!apiKey && process.env['NODE_ENV'] === 'production') {
+        throw new Error('ANTHROPIC_API_KEY is required in production. ' +
+            'Set this environment variable to your Anthropic API key.');
+    }
+    const client = new Anthropic({ apiKey: apiKey ?? 'placeholder-for-dev' });
+    return {
+        async complete(options) {
+            return _complete(client, options);
+        },
+        async *stream(options) {
+            yield* _stream(client, options);
+        },
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Internal implementation
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Execute a non-streaming Claude completion.
+ *
+ * @param client - The Anthropic SDK client.
+ * @param options - Completion options.
+ * @returns The full result including text, tool calls, stop reason, and usage.
+ */
+async function _complete(client, options) {
+    const { messages, systemPrompt, model, tools, maxTokens = 8192, temperature } = options;
+    const params = {
+        model: model ?? AI_MODELS.sonnet,
+        max_tokens: maxTokens,
+        messages: messages.map(_toAnthropicMessage),
+        ...(systemPrompt ? { system: systemPrompt } : {}),
+        ...(tools && tools.length > 0
+            ? {
+                tools: tools.map((t) => ({
+                    name: t.name,
+                    description: t.description,
+                    input_schema: t.inputSchema,
+                })),
+            }
+            : {}),
+        ...(temperature !== undefined ? { temperature } : {}),
+    };
+    const response = await client.messages.create(params);
+    return _parseResponse(response);
+}
+/**
+ * Execute a streaming Claude completion, yielding typed events.
+ *
+ * @param client - The Anthropic SDK client.
+ * @param options - Completion options (same shape as {@link _complete}).
+ * @yields `AiStreamEvent` — text chunks, tool use blocks, and a final done event.
+ */
+async function* _stream(client, options) {
+    const { messages, systemPrompt, model, tools, maxTokens = 8192, temperature } = options;
+    const params = {
+        model: model ?? AI_MODELS.sonnet,
+        max_tokens: maxTokens,
+        stream: true,
+        messages: messages.map(_toAnthropicMessage),
+        ...(systemPrompt ? { system: systemPrompt } : {}),
+        ...(tools && tools.length > 0
+            ? {
+                tools: tools.map((t) => ({
+                    name: t.name,
+                    description: t.description,
+                    input_schema: t.inputSchema,
+                })),
+            }
+            : {}),
+        ...(temperature !== undefined ? { temperature } : {}),
+    };
+    // Accumulate state for the final done event
+    let accumulatedText = '';
+    const accumulatedToolCalls = [];
+    let currentToolCall = null;
+    const stream = await client.messages.stream(params);
+    for await (const event of stream) {
+        if (event.type === 'content_block_start') {
+            if (event.content_block.type === 'tool_use') {
+                currentToolCall = {
+                    id: event.content_block.id,
+                    name: event.content_block.name,
+                    inputJson: '',
+                };
+            }
+        }
+        else if (event.type === 'content_block_delta') {
+            if (event.delta.type === 'text_delta') {
+                accumulatedText += event.delta.text;
+                yield { type: 'text', text: event.delta.text };
+            }
+            else if (event.delta.type === 'input_json_delta' && currentToolCall) {
+                currentToolCall.inputJson += event.delta.partial_json;
+            }
+        }
+        else if (event.type === 'content_block_stop') {
+            if (currentToolCall) {
+                let input = {};
+                try {
+                    input = JSON.parse(currentToolCall.inputJson);
+                }
+                catch {
+                    // Malformed JSON from the model — use empty object
+                }
+                const toolCall = {
+                    id: currentToolCall.id,
+                    name: currentToolCall.name,
+                    input,
+                };
+                accumulatedToolCalls.push(toolCall);
+                yield { type: 'tool_use', toolCall };
+                currentToolCall = null;
+            }
+        }
+        else if (event.type === 'message_stop') {
+            const finalMessage = await stream.finalMessage();
+            yield {
+                type: 'done',
+                result: {
+                    text: accumulatedText || null,
+                    toolCalls: accumulatedToolCalls.length > 0 ? accumulatedToolCalls : null,
+                    stopReason: finalMessage.stop_reason ?? 'end_turn',
+                    usage: {
+                        inputTokens: finalMessage.usage.input_tokens,
+                        outputTokens: finalMessage.usage.output_tokens,
+                    },
+                },
+            };
+        }
+    }
+}
+/**
+ * Convert a {@link AiMessage} to the Anthropic SDK's message format.
+ *
+ * @param msg - An SDK-typed message.
+ * @returns An Anthropic API message param.
+ */
+function _toAnthropicMessage(msg) {
+    if (typeof msg.content === 'string') {
+        return { role: msg.role, content: msg.content };
+    }
+    // Map SDK content blocks to Anthropic content blocks
+    const blocks = msg.content.map((block) => {
+        if (block.type === 'text') {
+            return { type: 'text', text: block.text };
+        }
+        if (block.type === 'image') {
+            return {
+                type: 'image',
+                source: {
+                    type: 'base64',
+                    media_type: block.source.media_type,
+                    data: block.source.data,
+                },
+            };
+        }
+        if (block.type === 'tool_use') {
+            return {
+                type: 'tool_use',
+                id: block.id,
+                name: block.name,
+                input: block.input,
+            };
+        }
+        // tool_result
+        return {
+            type: 'tool_result',
+            tool_use_id: block.tool_use_id,
+            content: block.content,
+        };
+    });
+    return { role: msg.role, content: blocks };
+}
+/**
+ * Parse an Anthropic API response into an {@link AiCompleteResult}.
+ *
+ * @param response - The raw Anthropic message response.
+ * @returns A normalized SDK result.
+ */
+function _parseResponse(response) {
+    let text = null;
+    const toolCalls = [];
+    for (const block of response.content) {
+        if (block.type === 'text') {
+            text = (text ?? '') + block.text;
+        }
+        else if (block.type === 'tool_use') {
+            toolCalls.push({
+                id: block.id,
+                name: block.name,
+                input: block.input,
+            });
+        }
+    }
+    return {
+        text,
+        toolCalls: toolCalls.length > 0 ? toolCalls : null,
+        stopReason: response.stop_reason ?? 'end_turn',
+        usage: {
+            inputTokens: response.usage.input_tokens,
+            outputTokens: response.usage.output_tokens,
+        },
+    };
+}
+export { AI_MODELS } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/modules/ai/index.js.map

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