@theokit/sdk 1.6.2 → 1.7.0

package/dist/a2a/message-bus.d.cts

@@ -0,0 +1,27 @@
+/**
+ * MessageBus — in-process typed message router for A2A (T20.1, ADR D453).
+ *
+ * Routes messages between agents by ID. Supports fire-and-forget (send)
+ * and request/response (request with timeout).
+ *
+ * @public
+ */
+import type { MessageHandler } from "./types.js";
+export interface RequestOptions {
+    timeoutMs?: number;
+}
+export declare class MessageBus {
+    private readonly _handlers;
+    register(agentId: string, handler: MessageHandler): void;
+    unregister(agentId: string): void;
+    send(from: string, to: string, partial: {
+        type: string;
+        payload: unknown;
+    }): Promise<void>;
+    request(from: string, to: string, partial: {
+        type: string;
+        payload: unknown;
+    }, opts?: RequestOptions): Promise<unknown>;
+    has(agentId: string): boolean;
+    listAgents(): string[];
+}

package/dist/a2a/message-bus.d.ts

@@ -0,0 +1,27 @@
+/**
+ * MessageBus — in-process typed message router for A2A (T20.1, ADR D453).
+ *
+ * Routes messages between agents by ID. Supports fire-and-forget (send)
+ * and request/response (request with timeout).
+ *
+ * @public
+ */
+import type { MessageHandler } from "./types.js";
+export interface RequestOptions {
+    timeoutMs?: number;
+}
+export declare class MessageBus {
+    private readonly _handlers;
+    register(agentId: string, handler: MessageHandler): void;
+    unregister(agentId: string): void;
+    send(from: string, to: string, partial: {
+        type: string;
+        payload: unknown;
+    }): Promise<void>;
+    request(from: string, to: string, partial: {
+        type: string;
+        payload: unknown;
+    }, opts?: RequestOptions): Promise<unknown>;
+    has(agentId: string): boolean;
+    listAgents(): string[];
+}

package/dist/a2a/subagent.d.cts

@@ -0,0 +1,25 @@
+/**
+ * Subagent delegation — declarative child agent invocable as a tool.
+ *
+ * Per ADR D2: `defineSubAgent(spec)` returns a `CustomTool` that, when
+ * invoked by the LLM, creates a child agent and sends the input as a
+ * message. EC-2: delegation depth tracked to prevent infinite recursion.
+ *
+ * @public
+ */
+import type { CustomTool } from "../types/agent.js";
+export interface SubAgentSpec {
+    name: string;
+    description: string;
+    instructions: string;
+    model?: string;
+    tools?: CustomTool[];
+    maxDelegationDepth?: number;
+}
+export declare class MaxDelegationDepthError extends Error {
+    readonly currentDepth: number;
+    readonly maxDepth: number;
+    readonly code: "max_delegation_depth";
+    constructor(currentDepth: number, maxDepth: number);
+}
+export declare function defineSubAgent(spec: SubAgentSpec, _parentDepth?: number): CustomTool;

package/dist/a2a/subagent.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Subagent delegation — declarative child agent invocable as a tool.
+ *
+ * Per ADR D2: `defineSubAgent(spec)` returns a `CustomTool` that, when
+ * invoked by the LLM, creates a child agent and sends the input as a
+ * message. EC-2: delegation depth tracked to prevent infinite recursion.
+ *
+ * @public
+ */
+import type { CustomTool } from "../types/agent.js";
+export interface SubAgentSpec {
+    name: string;
+    description: string;
+    instructions: string;
+    model?: string;
+    tools?: CustomTool[];
+    maxDelegationDepth?: number;
+}
+export declare class MaxDelegationDepthError extends Error {
+    readonly currentDepth: number;
+    readonly maxDepth: number;
+    readonly code: "max_delegation_depth";
+    constructor(currentDepth: number, maxDepth: number);
+}
+export declare function defineSubAgent(spec: SubAgentSpec, _parentDepth?: number): CustomTool;

package/dist/a2a/types.d.cts

@@ -0,0 +1,12 @@
+/**
+ * A2A (Agent-to-Agent) communication types (T20.1, ADR D453).
+ * @public
+ */
+export interface A2AMessage<T = unknown> {
+    type: string;
+    payload: T;
+    from: string;
+    to: string;
+    timestamp: number;
+}
+export type MessageHandler<T = unknown> = (message: A2AMessage<T>) => undefined | unknown | Promise<undefined | unknown>;

package/dist/a2a/types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * A2A (Agent-to-Agent) communication types (T20.1, ADR D453).
+ * @public
+ */
+export interface A2AMessage<T = unknown> {
+    type: string;
+    payload: T;
+    from: string;
+    to: string;
+    timestamp: number;
+}
+export type MessageHandler<T = unknown> = (message: A2AMessage<T>) => undefined | unknown | Promise<undefined | unknown>;

package/dist/agent.d.ts

@@ -1,5 +1,5 @@
 import { AgentBuilder } from "./agent-builder.js";
-import { type LiveAgentRegistry } from "./internal/runtime/live-agent-registry.js";
+import { type LiveAgentRegistry } from "./internal/runtime/registry/live-agent-registry.js";
 import type { AgentOperationOptions, AgentOptions, GetAgentOptions, GetRunOptions, ListAgentsOptions, ListResult, ListRunsOptions, SDKAgent, SDKAgentInfo } from "./types/agent.js";
 import type { Run, RunResult } from "./types/run.js";
 /**

package/dist/client/index.cjs

@@ -0,0 +1,73 @@
+'use strict';
+
+// src/client/theokit-client.ts
+var TheoKitClient = class {
+  _baseUrl;
+  _basePath;
+  _headers;
+  constructor(opts) {
+    this._baseUrl = opts.baseUrl.replace(/\/$/, "");
+    this._basePath = opts.basePath ?? "/agent";
+    this._headers = opts.headers ?? {};
+  }
+  async send(input) {
+    const url = `${this._baseUrl}${this._basePath}/send`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...this._headers
+      },
+      body: JSON.stringify({ input })
+    });
+    if (!response.ok) {
+      throw new Error(`TheoKitClient: send failed with status ${response.status}`);
+    }
+    return await response.json();
+  }
+  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: SSE stream parsing with fetch + ReadableStream reader requires sequential control flow
+  async *stream(input) {
+    const url = `${this._baseUrl}${this._basePath}/stream?input=${encodeURIComponent(input)}`;
+    const response = await fetch(url, {
+      headers: {
+        Accept: "text/event-stream",
+        ...this._headers
+      }
+    });
+    if (!response.ok) {
+      throw new Error(`TheoKitClient: stream failed with status ${response.status}`);
+    }
+    const reader = response.body?.getReader();
+    if (!reader) {
+      throw new Error("TheoKitClient: response body is not readable");
+    }
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+          const trimmed = line.trim();
+          if (trimmed.startsWith("data: ")) {
+            const data = trimmed.slice(6);
+            if (data === "[DONE]") return;
+            try {
+              yield JSON.parse(data);
+            } catch {
+            }
+          }
+        }
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
+};
+
+exports.TheoKitClient = TheoKitClient;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/client/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/theokit-client.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * TheoKitClient — browser-safe client for consuming server adapter endpoints\n * (T20.2, ADR D454).\n *\n * Zero Node dependencies. Uses native fetch + manual SSE parsing.\n * Consumes the same HTTP contract as server adapters (POST /send, GET /stream).\n *\n * @public\n */\n\nimport type { ClientOptions, SendResponse, StreamEvent } from \"./types.js\";\n\nexport class TheoKitClient {\n  private readonly _baseUrl: string;\n  private readonly _basePath: string;\n  private readonly _headers: Record<string, string>;\n\n  constructor(opts: ClientOptions) {\n    this._baseUrl = opts.baseUrl.replace(/\\/$/, \"\");\n    this._basePath = opts.basePath ?? \"/agent\";\n    this._headers = opts.headers ?? {};\n  }\n\n  async send(input: string): Promise<SendResponse> {\n    const url = `${this._baseUrl}${this._basePath}/send`;\n    const response = await fetch(url, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...this._headers,\n      },\n      body: JSON.stringify({ input }),\n    });\n\n    if (!response.ok) {\n      throw new Error(`TheoKitClient: send failed with status ${response.status}`);\n    }\n\n    return (await response.json()) as SendResponse;\n  }\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: SSE stream parsing with fetch + ReadableStream reader requires sequential control flow\n  async *stream(input: string): AsyncGenerator<StreamEvent, void, void> {\n    const url = `${this._baseUrl}${this._basePath}/stream?input=${encodeURIComponent(input)}`;\n    const response = await fetch(url, {\n      headers: {\n        Accept: \"text/event-stream\",\n        ...this._headers,\n      },\n    });\n\n    if (!response.ok) {\n      throw new Error(`TheoKitClient: stream failed with status ${response.status}`);\n    }\n\n    const reader = response.body?.getReader();\n    if (!reader) {\n      throw new Error(\"TheoKitClient: response body is not readable\");\n    }\n\n    const decoder = new TextDecoder();\n    let buffer = \"\";\n\n    try {\n      // jscpd:ignore-start — SSE stream buffer pattern (different protocol from NDJSON in ollama-native)\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) break;\n\n        buffer += decoder.decode(value, { stream: true });\n        const lines = buffer.split(\"\\n\");\n        buffer = lines.pop() ?? \"\";\n        // jscpd:ignore-end\n\n        for (const line of lines) {\n          const trimmed = line.trim();\n          if (trimmed.startsWith(\"data: \")) {\n            const data = trimmed.slice(6);\n            if (data === \"[DONE]\") return;\n            try {\n              yield JSON.parse(data) as StreamEvent;\n            } catch {\n              // Skip malformed SSE data lines\n            }\n          }\n        }\n      }\n    } finally {\n      reader.releaseLock();\n    }\n  }\n}\n"]}

package/dist/client/index.d.cts

@@ -0,0 +1,7 @@
+/**
+ * Client sub-path barrel (T20.2, ADR D454).
+ * Exported via `@theokit/sdk/client`.
+ * @public
+ */
+export { TheoKitClient } from "./theokit-client.js";
+export type { ClientOptions, SendResponse, StreamEvent } from "./types.js";

package/dist/client/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Client sub-path barrel (T20.2, ADR D454).
+ * Exported via `@theokit/sdk/client`.
+ * @public
+ */
+export { TheoKitClient } from "./theokit-client.js";
+export type { ClientOptions, SendResponse, StreamEvent } from "./types.js";

package/dist/client/index.js

@@ -0,0 +1,71 @@
+// src/client/theokit-client.ts
+var TheoKitClient = class {
+  _baseUrl;
+  _basePath;
+  _headers;
+  constructor(opts) {
+    this._baseUrl = opts.baseUrl.replace(/\/$/, "");
+    this._basePath = opts.basePath ?? "/agent";
+    this._headers = opts.headers ?? {};
+  }
+  async send(input) {
+    const url = `${this._baseUrl}${this._basePath}/send`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...this._headers
+      },
+      body: JSON.stringify({ input })
+    });
+    if (!response.ok) {
+      throw new Error(`TheoKitClient: send failed with status ${response.status}`);
+    }
+    return await response.json();
+  }
+  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: SSE stream parsing with fetch + ReadableStream reader requires sequential control flow
+  async *stream(input) {
+    const url = `${this._baseUrl}${this._basePath}/stream?input=${encodeURIComponent(input)}`;
+    const response = await fetch(url, {
+      headers: {
+        Accept: "text/event-stream",
+        ...this._headers
+      }
+    });
+    if (!response.ok) {
+      throw new Error(`TheoKitClient: stream failed with status ${response.status}`);
+    }
+    const reader = response.body?.getReader();
+    if (!reader) {
+      throw new Error("TheoKitClient: response body is not readable");
+    }
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+          const trimmed = line.trim();
+          if (trimmed.startsWith("data: ")) {
+            const data = trimmed.slice(6);
+            if (data === "[DONE]") return;
+            try {
+              yield JSON.parse(data);
+            } catch {
+            }
+          }
+        }
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
+};
+
+export { TheoKitClient };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/theokit-client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * TheoKitClient — browser-safe client for consuming server adapter endpoints\n * (T20.2, ADR D454).\n *\n * Zero Node dependencies. Uses native fetch + manual SSE parsing.\n * Consumes the same HTTP contract as server adapters (POST /send, GET /stream).\n *\n * @public\n */\n\nimport type { ClientOptions, SendResponse, StreamEvent } from \"./types.js\";\n\nexport class TheoKitClient {\n  private readonly _baseUrl: string;\n  private readonly _basePath: string;\n  private readonly _headers: Record<string, string>;\n\n  constructor(opts: ClientOptions) {\n    this._baseUrl = opts.baseUrl.replace(/\\/$/, \"\");\n    this._basePath = opts.basePath ?? \"/agent\";\n    this._headers = opts.headers ?? {};\n  }\n\n  async send(input: string): Promise<SendResponse> {\n    const url = `${this._baseUrl}${this._basePath}/send`;\n    const response = await fetch(url, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...this._headers,\n      },\n      body: JSON.stringify({ input }),\n    });\n\n    if (!response.ok) {\n      throw new Error(`TheoKitClient: send failed with status ${response.status}`);\n    }\n\n    return (await response.json()) as SendResponse;\n  }\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: SSE stream parsing with fetch + ReadableStream reader requires sequential control flow\n  async *stream(input: string): AsyncGenerator<StreamEvent, void, void> {\n    const url = `${this._baseUrl}${this._basePath}/stream?input=${encodeURIComponent(input)}`;\n    const response = await fetch(url, {\n      headers: {\n        Accept: \"text/event-stream\",\n        ...this._headers,\n      },\n    });\n\n    if (!response.ok) {\n      throw new Error(`TheoKitClient: stream failed with status ${response.status}`);\n    }\n\n    const reader = response.body?.getReader();\n    if (!reader) {\n      throw new Error(\"TheoKitClient: response body is not readable\");\n    }\n\n    const decoder = new TextDecoder();\n    let buffer = \"\";\n\n    try {\n      // jscpd:ignore-start — SSE stream buffer pattern (different protocol from NDJSON in ollama-native)\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) break;\n\n        buffer += decoder.decode(value, { stream: true });\n        const lines = buffer.split(\"\\n\");\n        buffer = lines.pop() ?? \"\";\n        // jscpd:ignore-end\n\n        for (const line of lines) {\n          const trimmed = line.trim();\n          if (trimmed.startsWith(\"data: \")) {\n            const data = trimmed.slice(6);\n            if (data === \"[DONE]\") return;\n            try {\n              yield JSON.parse(data) as StreamEvent;\n            } catch {\n              // Skip malformed SSE data lines\n            }\n          }\n        }\n      }\n    } finally {\n      reader.releaseLock();\n    }\n  }\n}\n"]}

package/dist/client/theokit-client.d.cts

@@ -0,0 +1,18 @@
+/**
+ * TheoKitClient — browser-safe client for consuming server adapter endpoints
+ * (T20.2, ADR D454).
+ *
+ * Zero Node dependencies. Uses native fetch + manual SSE parsing.
+ * Consumes the same HTTP contract as server adapters (POST /send, GET /stream).
+ *
+ * @public
+ */
+import type { ClientOptions, SendResponse, StreamEvent } from "./types.js";
+export declare class TheoKitClient {
+    private readonly _baseUrl;
+    private readonly _basePath;
+    private readonly _headers;
+    constructor(opts: ClientOptions);
+    send(input: string): Promise<SendResponse>;
+    stream(input: string): AsyncGenerator<StreamEvent, void, void>;
+}

package/dist/client/theokit-client.d.ts

@@ -0,0 +1,18 @@
+/**
+ * TheoKitClient — browser-safe client for consuming server adapter endpoints
+ * (T20.2, ADR D454).
+ *
+ * Zero Node dependencies. Uses native fetch + manual SSE parsing.
+ * Consumes the same HTTP contract as server adapters (POST /send, GET /stream).
+ *
+ * @public
+ */
+import type { ClientOptions, SendResponse, StreamEvent } from "./types.js";
+export declare class TheoKitClient {
+    private readonly _baseUrl;
+    private readonly _basePath;
+    private readonly _headers;
+    constructor(opts: ClientOptions);
+    send(input: string): Promise<SendResponse>;
+    stream(input: string): AsyncGenerator<StreamEvent, void, void>;
+}

package/dist/client/types.d.cts

@@ -0,0 +1,19 @@
+/**
+ * Client SDK types (T20.2, ADR D454).
+ * @public
+ */
+export interface ClientOptions {
+    baseUrl: string;
+    basePath?: string;
+    headers?: Record<string, string>;
+}
+export interface SendResponse {
+    status: string;
+    output?: unknown;
+    error?: string;
+}
+export interface StreamEvent {
+    type: string;
+    text?: string;
+    [key: string]: unknown;
+}

package/dist/client/types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Client SDK types (T20.2, ADR D454).
+ * @public
+ */
+export interface ClientOptions {
+    baseUrl: string;
+    basePath?: string;
+    headers?: Record<string, string>;
+}
+export interface SendResponse {
+    status: string;
+    output?: unknown;
+    error?: string;
+}
+export interface StreamEvent {
+    type: string;
+    text?: string;
+    [key: string]: unknown;
+}