@theokit/sdk 2.19.0 → 2.21.0

package/dist/a2a/types.d.cts

@@ -2,11 +2,18 @@
  * A2A (Agent-to-Agent) communication types (T20.1, ADR D453).
  * @public
  */
+import type { MessageOrigin } from "../types/run.js";
 export interface A2AMessage<T = unknown> {
     type: string;
     payload: T;
     from: string;
     to: string;
     timestamp: number;
+    /**
+     * SE3 — provenance projection of the sender address: `{ kind: "peer", from }`.
+     * A thin view over `from` (not a parallel system), so a receiver that turns an
+     * a2a message into a turn can forward it via `SendOptions.origin`.
+     */
+    origin?: MessageOrigin;
 }
 export type MessageHandler<T = unknown> = (message: A2AMessage<T>) => undefined | unknown | Promise<undefined | unknown>;

package/dist/a2a/types.d.ts

@@ -2,11 +2,18 @@
  * A2A (Agent-to-Agent) communication types (T20.1, ADR D453).
  * @public
  */
+import type { MessageOrigin } from "../types/run.js";
 export interface A2AMessage<T = unknown> {
     type: string;
     payload: T;
     from: string;
     to: string;
     timestamp: number;
+    /**
+     * SE3 — provenance projection of the sender address: `{ kind: "peer", from }`.
+     * A thin view over `from` (not a parallel system), so a receiver that turns an
+     * a2a message into a turn can forward it via `SendOptions.origin`.
+     */
+    origin?: MessageOrigin;
 }
 export type MessageHandler<T = unknown> = (message: A2AMessage<T>) => undefined | unknown | Promise<undefined | unknown>;

package/dist/agent-builder.d.ts

@@ -18,7 +18,8 @@ export declare class AgentBuilder {
     private opts;
     private readonly deps;
     constructor(deps?: AgentBuilderDeps);
-    model(m: ModelSelection): this;
+    /** SE8 — accepts a bare-string id shorthand (`"openai/gpt-4o-mini"`) or a {@link ModelSelection}. */
+    model(m: string | ModelSelection): this;
     apiKey(k: string): this;
     name(n: string): this;
     systemPrompt(p: string | SystemPromptResolver): this;

package/dist/agent-generate.d.ts

@@ -0,0 +1,12 @@
+/**
+ * SE9 — integrated structured output: `agent.generate(input, { output })` runs the
+ * agent's NORMAL tool loop (the user's tools run first) and then coerces the final
+ * answer into a Zod schema, returning a validated, inferred-typed object.
+ *
+ * This is SUGAR over `generateObject` (ADR D33) — it does NOT fork the
+ * synthetic-forced-tool machinery. Phase 1 is the user's own `agent.send()` run;
+ * phase 2 reuses `generateObjectImpl` over the run's final answer.
+ *
+ * @public
+ */
+export type { GenerateOptions, GenerateRunResult } from "./types/run.js";

package/dist/client/index.cjs.map

@@ -1 +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"]}
+{"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 * @deprecated since 2.x — consumes a legacy server-adapter HTTP contract\n * (`POST /agent/send`, `GET /agent/stream`) that the ecosystem no longer\n * produces. For in-process agent runs use the `Agent` façade (`@theokit/sdk`);\n * for HTTP, the framework (`theokit`) exposes agents at `POST /api/agents/<name>`\n * over a `UIMessageStream` with its own typed client. The `@theokit/sdk/client`\n * sub-path will be removed in the next major.\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

@@ -2,6 +2,11 @@
  * Client sub-path barrel (T20.2, ADR D454).
  * Exported via `@theokit/sdk/client`.
  * @public
+ * @deprecated since 2.x — the `@theokit/sdk/client` sub-path consumes a legacy
+ * server-adapter HTTP contract (`/agent/send`, `/agent/stream`) that the
+ * ecosystem no longer produces. Use the `Agent` façade (`@theokit/sdk`) for
+ * in-process runs, or the framework's `POST /api/agents/<name>` typed client for
+ * HTTP. This sub-path will be removed in the next major.
  */
 export { TheoKitClient } from "./theokit-client.js";
 export type { ClientOptions, SendResponse, StreamEvent } from "./types.js";

package/dist/client/index.d.ts

@@ -2,6 +2,11 @@
  * Client sub-path barrel (T20.2, ADR D454).
  * Exported via `@theokit/sdk/client`.
  * @public
+ * @deprecated since 2.x — the `@theokit/sdk/client` sub-path consumes a legacy
+ * server-adapter HTTP contract (`/agent/send`, `/agent/stream`) that the
+ * ecosystem no longer produces. Use the `Agent` façade (`@theokit/sdk`) for
+ * in-process runs, or the framework's `POST /api/agents/<name>` typed client for
+ * HTTP. This sub-path will be removed in the next major.
  */
 export { TheoKitClient } from "./theokit-client.js";
 export type { ClientOptions, SendResponse, StreamEvent } from "./types.js";

package/dist/client/index.js.map

@@ -1 +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"]}
+{"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 * @deprecated since 2.x — consumes a legacy server-adapter HTTP contract\n * (`POST /agent/send`, `GET /agent/stream`) that the ecosystem no longer\n * produces. For in-process agent runs use the `Agent` façade (`@theokit/sdk`);\n * for HTTP, the framework (`theokit`) exposes agents at `POST /api/agents/<name>`\n * over a `UIMessageStream` with its own typed client. The `@theokit/sdk/client`\n * sub-path will be removed in the next major.\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

@@ -6,6 +6,12 @@
  * Consumes the same HTTP contract as server adapters (POST /send, GET /stream).
  *
  * @public
+ * @deprecated since 2.x — consumes a legacy server-adapter HTTP contract
+ * (`POST /agent/send`, `GET /agent/stream`) that the ecosystem no longer
+ * produces. For in-process agent runs use the `Agent` façade (`@theokit/sdk`);
+ * for HTTP, the framework (`theokit`) exposes agents at `POST /api/agents/<name>`
+ * over a `UIMessageStream` with its own typed client. The `@theokit/sdk/client`
+ * sub-path will be removed in the next major.
  */
 import type { ClientOptions, SendResponse, StreamEvent } from "./types.js";
 export declare class TheoKitClient {

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

@@ -6,6 +6,12 @@
  * Consumes the same HTTP contract as server adapters (POST /send, GET /stream).
  *
  * @public
+ * @deprecated since 2.x — consumes a legacy server-adapter HTTP contract
+ * (`POST /agent/send`, `GET /agent/stream`) that the ecosystem no longer
+ * produces. For in-process agent runs use the `Agent` façade (`@theokit/sdk`);
+ * for HTTP, the framework (`theokit`) exposes agents at `POST /api/agents/<name>`
+ * over a `UIMessageStream` with its own typed client. The `@theokit/sdk/client`
+ * sub-path will be removed in the next major.
  */
 import type { ClientOptions, SendResponse, StreamEvent } from "./types.js";
 export declare class TheoKitClient {

package/dist/client/types.d.cts

@@ -1,6 +1,8 @@
 /**
  * Client SDK types (T20.2, ADR D454).
  * @public
+ * @deprecated since 2.x — types for the deprecated `@theokit/sdk/client`
+ * (`TheoKitClient`) sub-path; removed with it in the next major.
  */
 export interface ClientOptions {
     baseUrl: string;

package/dist/client/types.d.ts

@@ -1,6 +1,8 @@
 /**
  * Client SDK types (T20.2, ADR D454).
  * @public
+ * @deprecated since 2.x — types for the deprecated `@theokit/sdk/client`
+ * (`TheoKitClient`) sub-path; removed with it in the next major.
  */
 export interface ClientOptions {
     baseUrl: string;

package/dist/create-skill.d.ts

@@ -0,0 +1,29 @@
+/**
+ * M22 — `createSkill`: define a skill in TypeScript, without a `SKILL.md` file on disk.
+ *
+ * An inline skill is usable ALONGSIDE filesystem skills (`AgentOptions.skills.inline`), and points
+ * an agent at code-defined capabilities without a `.theokit/skills/<name>/SKILL.md`. Like file
+ * skills, its `name` + `description` surface in the `<skills>` system-prompt block; its
+ * `instructions` (the body) travel on the object for the consumer (the SDK injects name+description,
+ * not bodies — inline and file skills are symmetric there). Inline skills override file skills on a
+ * name conflict (mirrors the subagents-loader precedent).
+ */
+import type { Skill } from "./internal/runtime/skills/discover-skills.js";
+/** A code-defined skill (from {@link createSkill}) — a {@link Skill} plus its inline body. */
+export interface InlineSkill extends Skill {
+    /** The skill body/instructions (inline skills carry it here instead of a SKILL.md file). */
+    instructions: string;
+}
+/** Spec accepted by {@link createSkill}. */
+export interface CreateSkillSpec {
+    name: string;
+    description: string;
+    instructions: string;
+    category?: string;
+    dependencies?: string[];
+}
+/**
+ * Build an {@link InlineSkill} from a code spec. Fails fast on an empty `name`/`description`
+ * (error-handling.md). The synthetic `source` (`inline://<name>`) marks it as file-less.
+ */
+export declare function createSkill(spec: CreateSkillSpec): InlineSkill;

package/dist/{cron-D_wK1S-0.d.cts → cron-YrmsszEN.d.cts}

@@ -1,4 +1,5 @@
-import { C as CustomTool, M as ModelSelection, G as SDKUserMessage, J as SendOptions, b as Run, r as RunToCompletionOptions, s as RunToCompletionResult, S as SDKMessage, U as StreamToCompletionResult, a as McpServerConfig } from './run-BgfBWX-z.cjs';
+import { C as CustomTool, M as ModelSelection, Z as SDKUserMessage, $ as SendOptions, b as Run, G as GenerateOptions, j as GenerateRunResult, F as RunToCompletionOptions, H as RunToCompletionResult, S as SDKMessage, a6 as StreamToCompletionResult, a as McpServerConfig } from './run-BMo8yRwK.cjs';
+import * as zod from 'zod';
 
 /**
  * Fork primitive public type contracts (T1.2, ADRs D110-D114).
@@ -602,6 +603,31 @@ interface StoredMessage {
     /** Optional epoch-ms timestamp. Implementations MAY default to `Date.now()` on append. */
     at?: number;
 }
+/**
+ * SE4 — light, session-level metadata stored ALONGSIDE the transcript (title +
+ * tag). Distinct from {@link StoredMessage} (which is per-turn content): this is
+ * per-conversation display metadata a host sets to build a session UI.
+ *
+ * @public
+ */
+interface SessionMeta {
+    /** Human-facing title set via `renameSession`. Absent = untitled. */
+    readonly title?: string;
+    /** Single free-form tag set via `tagSession`. Absent = untagged. */
+    readonly tag?: string;
+}
+/**
+ * SE4 — a partial update to {@link SessionMeta}. An omitted field is left
+ * unchanged; `tag: null` explicitly CLEARS the tag (distinct from omitting it).
+ *
+ * @public
+ */
+interface SessionMetaPatch {
+    /** Set the title; `null` explicitly CLEARS it (distinct from omitting it). */
+    readonly title?: string | null;
+    /** Set the tag; `null` explicitly CLEARS it (distinct from omitting it). */
+    readonly tag?: string | null;
+}
 /**
  * Pluggable conversation persistence contract.
  *
@@ -673,6 +699,19 @@ interface ConversationStorageAdapter {
      * trims old turns past a soft cap; other backends typically no-op.
      */
     compact?(conversationId: string, maxTurns: number): Promise<void>;
+    /**
+     * SE4 — optional: read the session-level metadata (title/tag) for a
+     * conversation. MUST return `undefined` when none was set (NOT throw).
+     * Adapters that cannot store side metadata MAY omit this — the session
+     * manager then reports rename/tag as unsupported rather than throwing.
+     */
+    getSessionMeta?(conversationId: string): Promise<SessionMeta | undefined>;
+    /**
+     * SE4 — optional: apply a {@link SessionMetaPatch} to a conversation's
+     * session metadata (set title, set/clear tag). MUST create the metadata
+     * lazily. Adapters that cannot store side metadata MAY omit this.
+     */
+    setSessionMeta?(conversationId: string, patch: SessionMetaPatch): Promise<void>;
     /**
      * Optional: dispose underlying handles (close DB pool, etc.).
      * MUST be safe to call multiple times.
@@ -680,6 +719,53 @@ interface ConversationStorageAdapter {
     dispose?(): Promise<void>;
 }
 
+/**
+ * A discovered skill's metadata. The skill BODY is never included — only the
+ * strict frontmatter fields plus the resolved `source` path.
+ *
+ * Public via `@theokit/sdk/skills`.
+ *
+ * @public
+ */
+interface Skill {
+    name: string;
+    description: string;
+    /** Absolute path to the discovered `SKILL.md`. */
+    source: string;
+    category?: string;
+    dependencies?: string[];
+}
+
+/**
+ * M22 — `createSkill`: define a skill in TypeScript, without a `SKILL.md` file on disk.
+ *
+ * An inline skill is usable ALONGSIDE filesystem skills (`AgentOptions.skills.inline`), and points
+ * an agent at code-defined capabilities without a `.theokit/skills/<name>/SKILL.md`. Like file
+ * skills, its `name` + `description` surface in the `<skills>` system-prompt block; its
+ * `instructions` (the body) travel on the object for the consumer (the SDK injects name+description,
+ * not bodies — inline and file skills are symmetric there). Inline skills override file skills on a
+ * name conflict (mirrors the subagents-loader precedent).
+ */
+
+/** A code-defined skill (from {@link createSkill}) — a {@link Skill} plus its inline body. */
+interface InlineSkill extends Skill {
+    /** The skill body/instructions (inline skills carry it here instead of a SKILL.md file). */
+    instructions: string;
+}
+/** Spec accepted by {@link createSkill}. */
+interface CreateSkillSpec {
+    name: string;
+    description: string;
+    instructions: string;
+    category?: string;
+    dependencies?: string[];
+}
+/**
+ * Build an {@link InlineSkill} from a code spec. Fails fast on an empty `name`/`description`
+ * (error-handling.md). The synthetic `source` (`inline://<name>`) marks it as file-less.
+ */
+declare function createSkill(spec: CreateSkillSpec): InlineSkill;
+
 /**
  * Context manager backend.
  *
@@ -1182,6 +1268,16 @@ interface SkillsSettings {
      * skills itself.
      */
     autoInject?: boolean;
+    /**
+     * M22 — discover skills from a CUSTOM directory (containing `<name>/SKILL.md`) instead of the
+     * default `<cwd>/.theokit/skills`. Absent ⇒ the default root.
+     */
+    skillsDir?: string;
+    /**
+     * M22 — code-defined skills (from `createSkill`) merged with the discovered ones. An inline skill
+     * overrides a discovered file skill of the same name.
+     */
+    inline?: InlineSkill[];
 }
 /**
  * Memory configuration accepted by `Agent.create()` via {@link AgentOptions.memory}.
@@ -1278,7 +1374,12 @@ interface TelemetrySettings {
  * @public
  */
 interface AgentOptions {
-    model?: ModelSelection;
+    /**
+     * The model to run. SE8 — accepts a bare-string id shorthand
+     * (`"openai/gpt-4o-mini"`, normalized to `{ id }`) OR a {@link ModelSelection}
+     * object (use the object form to pass `params`).
+     */
+    model?: string | ModelSelection;
     /** Falls back to `THEOKIT_API_KEY`. */
     apiKey?: string;
     name?: string;
@@ -1570,6 +1671,12 @@ interface SDKAgent {
      */
     readonly plugins?: SDKAgentPlugins;
     send(message: string | SDKUserMessage, options?: SendOptions): Promise<Run>;
+    /**
+     * SE9 — integrated structured output. Runs the normal tool loop (the tools run
+     * first) then coerces the final answer into the `output` Zod schema, returning a
+     * validated, inferred-typed object. Sugar over `Agent.generateObject` (ADR D33).
+     */
+    generate<T extends zod.ZodType>(message: string | SDKUserMessage, options: GenerateOptions<T>): Promise<GenerateRunResult<zod.z.infer<T>>>;
     /** Fire-and-forget disposal. */
     close(): void;
     /** Re-read filesystem config (context, hooks, project MCP, subagents) without disposing. */
@@ -2039,4 +2146,4 @@ declare class Cron {
     static status(_options?: CronStartOptions): Promise<CronSchedulerStatus>;
 }
 
-export { type GoalResult as $, type AgentOptions as A, type BudgetTracker as B, type CloudOptions as C, type CloudRepo as D, type ContextBudget as E, type ContextManagerKind as F, type GetAgentOptions as G, type ContextSnapshot as H, type ContextSource as I, type ContextSourceStatus as J, Cron as K, type LocalOptions as L, type MemorySettings as M, type CronCreateOptions as N, type CronGetOptions as O, type ProviderRoutingSettings as P, type CronJob as Q, type CronJobStatus as R, type SystemPromptResolver as S, type CronListOptions as T, type CronOperationOptions as U, type CronRunOptions as V, type CronRuntime as W, type CronSchedulerStatus as X, type CronStartOptions as Y, type GoalEvent as Z, type GoalOptions as _, type AgentDefinition as a, type HookName as a0, type InvalidateCacheOptions as a1, type MemoryAdapter as a2, type MemoryAdapterCapabilities as a3, type MemoryContext as a4, type MemoryFact as a5, type MemoryProviderHandle as a6, type MemoryProviderInitOptions as a7, type MemoryRevision as a8, type MemoryToolSchema as a9, type MemoryTurnMessage as aa, type PersonalityPreset as ab, type PluginContext as ac, type PostAssistantReplyContext as ad, type PreToolCallContext as ae, type PreUserSendContext as af, type PreUserSendResult as ag, type ProviderCapability as ah, type ProviderRoute as ai, type RecordSessionSummaryArgs as aj, type ResolvedProviderRoute as ak, type RunUntilIterator as al, type SDKAgentPlugins as am, type SDKAgentSkills as an, type SDKArtifact as ao, type SDKContextManager as ap, type SDKPluginMetadata as aq, type SDKProvidersManager as ar, type SettingSource as as, type SystemPromptContext as at, type SystemPromptMemoryFact as au, type SystemPromptSkillRef as av, type TelemetrySettings as aw, definePlugin as ax, type ContextSettings as b, type PluginsSettings as c, type SkillsSettings as d, type SDKAgent as e, type ListAgentsOptions as f, type ListResult as g, type SDKAgentInfo as h, type ListRunsOptions as i, type GetRunOptions as j, type AgentOperationOptions as k, type ProviderProfile as l, type Plugin as m, type ConversationStorageAdapter as n, type StoredMessage as o, type MemoryProvider as p, type MemoryId as q, type PreToolCallDecision as r, type SDKProvider as s, type ActiveMemoryPassArgs as t, type ActiveMemoryPassResult as u, type AgentMemory as v, type BudgetCheck as w, type BudgetTotal as x, type BudgetUsageEvent as y, type CloudEnv as z };
+export { type CronStartOptions as $, type AgentOptions as A, type BudgetTracker as B, type CloudOptions as C, type BudgetUsageEvent as D, type CloudEnv as E, type CloudRepo as F, type GetAgentOptions as G, type ContextBudget as H, type ContextManagerKind as I, type ContextSnapshot as J, type ContextSource as K, type LocalOptions as L, type MemorySettings as M, type ContextSourceStatus as N, type CreateSkillSpec as O, type ProviderRoutingSettings as P, Cron as Q, type CronCreateOptions as R, type SystemPromptResolver as S, type CronGetOptions as T, type CronJob as U, type CronJobStatus as V, type CronListOptions as W, type CronOperationOptions as X, type CronRunOptions as Y, type CronRuntime as Z, type CronSchedulerStatus as _, type AgentDefinition as a, type GoalEvent as a0, type GoalOptions as a1, type GoalResult as a2, type HookName as a3, type InlineSkill as a4, type InvalidateCacheOptions as a5, type MemoryAdapter as a6, type MemoryAdapterCapabilities as a7, type MemoryContext as a8, type MemoryFact as a9, type TelemetrySettings as aA, createSkill as aB, definePlugin as aC, type MemoryProviderHandle as aa, type MemoryProviderInitOptions as ab, type MemoryRevision as ac, type MemoryToolSchema as ad, type MemoryTurnMessage as ae, type PersonalityPreset as af, type PluginContext as ag, type PostAssistantReplyContext as ah, type PreToolCallContext as ai, type PreUserSendContext as aj, type PreUserSendResult as ak, type ProviderCapability as al, type ProviderRoute as am, type RecordSessionSummaryArgs as an, type ResolvedProviderRoute as ao, type RunUntilIterator as ap, type SDKAgentPlugins as aq, type SDKAgentSkills as ar, type SDKArtifact as as, type SDKContextManager as at, type SDKPluginMetadata as au, type SDKProvidersManager as av, type SettingSource as aw, type SystemPromptContext as ax, type SystemPromptMemoryFact as ay, type SystemPromptSkillRef as az, type ContextSettings as b, type PluginsSettings as c, type SkillsSettings as d, type SDKAgent as e, type ListAgentsOptions as f, type ListResult as g, type SDKAgentInfo as h, type ListRunsOptions as i, type GetRunOptions as j, type AgentOperationOptions as k, type ProviderProfile as l, type Plugin as m, type ConversationStorageAdapter as n, type StoredMessage as o, type SessionMeta as p, type SessionMetaPatch as q, type MemoryProvider as r, type MemoryId as s, type PreToolCallDecision as t, type SDKProvider as u, type ActiveMemoryPassArgs as v, type ActiveMemoryPassResult as w, type AgentMemory as x, type BudgetCheck as y, type BudgetTotal as z };

package/dist/{cron-Cep07kTz.d.ts → cron-dpvtRoro.d.ts}

@@ -1,4 +1,5 @@
-import { C as CustomTool, M as ModelSelection, G as SDKUserMessage, J as SendOptions, b as Run, r as RunToCompletionOptions, s as RunToCompletionResult, S as SDKMessage, U as StreamToCompletionResult, a as McpServerConfig } from './run-BgfBWX-z.js';
+import { C as CustomTool, M as ModelSelection, Z as SDKUserMessage, $ as SendOptions, b as Run, G as GenerateOptions, j as GenerateRunResult, F as RunToCompletionOptions, H as RunToCompletionResult, S as SDKMessage, a6 as StreamToCompletionResult, a as McpServerConfig } from './run-BMo8yRwK.js';
+import * as zod from 'zod';
 
 /**
  * Fork primitive public type contracts (T1.2, ADRs D110-D114).
@@ -602,6 +603,31 @@ interface StoredMessage {
     /** Optional epoch-ms timestamp. Implementations MAY default to `Date.now()` on append. */
     at?: number;
 }
+/**
+ * SE4 — light, session-level metadata stored ALONGSIDE the transcript (title +
+ * tag). Distinct from {@link StoredMessage} (which is per-turn content): this is
+ * per-conversation display metadata a host sets to build a session UI.
+ *
+ * @public
+ */
+interface SessionMeta {
+    /** Human-facing title set via `renameSession`. Absent = untitled. */
+    readonly title?: string;
+    /** Single free-form tag set via `tagSession`. Absent = untagged. */
+    readonly tag?: string;
+}
+/**
+ * SE4 — a partial update to {@link SessionMeta}. An omitted field is left
+ * unchanged; `tag: null` explicitly CLEARS the tag (distinct from omitting it).
+ *
+ * @public
+ */
+interface SessionMetaPatch {
+    /** Set the title; `null` explicitly CLEARS it (distinct from omitting it). */
+    readonly title?: string | null;
+    /** Set the tag; `null` explicitly CLEARS it (distinct from omitting it). */
+    readonly tag?: string | null;
+}
 /**
  * Pluggable conversation persistence contract.
  *
@@ -673,6 +699,19 @@ interface ConversationStorageAdapter {
      * trims old turns past a soft cap; other backends typically no-op.
      */
     compact?(conversationId: string, maxTurns: number): Promise<void>;
+    /**
+     * SE4 — optional: read the session-level metadata (title/tag) for a
+     * conversation. MUST return `undefined` when none was set (NOT throw).
+     * Adapters that cannot store side metadata MAY omit this — the session
+     * manager then reports rename/tag as unsupported rather than throwing.
+     */
+    getSessionMeta?(conversationId: string): Promise<SessionMeta | undefined>;
+    /**
+     * SE4 — optional: apply a {@link SessionMetaPatch} to a conversation's
+     * session metadata (set title, set/clear tag). MUST create the metadata
+     * lazily. Adapters that cannot store side metadata MAY omit this.
+     */
+    setSessionMeta?(conversationId: string, patch: SessionMetaPatch): Promise<void>;
     /**
      * Optional: dispose underlying handles (close DB pool, etc.).
      * MUST be safe to call multiple times.
@@ -680,6 +719,53 @@ interface ConversationStorageAdapter {
     dispose?(): Promise<void>;
 }
 
+/**
+ * A discovered skill's metadata. The skill BODY is never included — only the
+ * strict frontmatter fields plus the resolved `source` path.
+ *
+ * Public via `@theokit/sdk/skills`.
+ *
+ * @public
+ */
+interface Skill {
+    name: string;
+    description: string;
+    /** Absolute path to the discovered `SKILL.md`. */
+    source: string;
+    category?: string;
+    dependencies?: string[];
+}
+
+/**
+ * M22 — `createSkill`: define a skill in TypeScript, without a `SKILL.md` file on disk.
+ *
+ * An inline skill is usable ALONGSIDE filesystem skills (`AgentOptions.skills.inline`), and points
+ * an agent at code-defined capabilities without a `.theokit/skills/<name>/SKILL.md`. Like file
+ * skills, its `name` + `description` surface in the `<skills>` system-prompt block; its
+ * `instructions` (the body) travel on the object for the consumer (the SDK injects name+description,
+ * not bodies — inline and file skills are symmetric there). Inline skills override file skills on a
+ * name conflict (mirrors the subagents-loader precedent).
+ */
+
+/** A code-defined skill (from {@link createSkill}) — a {@link Skill} plus its inline body. */
+interface InlineSkill extends Skill {
+    /** The skill body/instructions (inline skills carry it here instead of a SKILL.md file). */
+    instructions: string;
+}
+/** Spec accepted by {@link createSkill}. */
+interface CreateSkillSpec {
+    name: string;
+    description: string;
+    instructions: string;
+    category?: string;
+    dependencies?: string[];
+}
+/**
+ * Build an {@link InlineSkill} from a code spec. Fails fast on an empty `name`/`description`
+ * (error-handling.md). The synthetic `source` (`inline://<name>`) marks it as file-less.
+ */
+declare function createSkill(spec: CreateSkillSpec): InlineSkill;
+
 /**
  * Context manager backend.
  *
@@ -1182,6 +1268,16 @@ interface SkillsSettings {
      * skills itself.
      */
     autoInject?: boolean;
+    /**
+     * M22 — discover skills from a CUSTOM directory (containing `<name>/SKILL.md`) instead of the
+     * default `<cwd>/.theokit/skills`. Absent ⇒ the default root.
+     */
+    skillsDir?: string;
+    /**
+     * M22 — code-defined skills (from `createSkill`) merged with the discovered ones. An inline skill
+     * overrides a discovered file skill of the same name.
+     */
+    inline?: InlineSkill[];
 }
 /**
  * Memory configuration accepted by `Agent.create()` via {@link AgentOptions.memory}.
@@ -1278,7 +1374,12 @@ interface TelemetrySettings {
  * @public
  */
 interface AgentOptions {
-    model?: ModelSelection;
+    /**
+     * The model to run. SE8 — accepts a bare-string id shorthand
+     * (`"openai/gpt-4o-mini"`, normalized to `{ id }`) OR a {@link ModelSelection}
+     * object (use the object form to pass `params`).
+     */
+    model?: string | ModelSelection;
     /** Falls back to `THEOKIT_API_KEY`. */
     apiKey?: string;
     name?: string;
@@ -1570,6 +1671,12 @@ interface SDKAgent {
      */
     readonly plugins?: SDKAgentPlugins;
     send(message: string | SDKUserMessage, options?: SendOptions): Promise<Run>;
+    /**
+     * SE9 — integrated structured output. Runs the normal tool loop (the tools run
+     * first) then coerces the final answer into the `output` Zod schema, returning a
+     * validated, inferred-typed object. Sugar over `Agent.generateObject` (ADR D33).
+     */
+    generate<T extends zod.ZodType>(message: string | SDKUserMessage, options: GenerateOptions<T>): Promise<GenerateRunResult<zod.z.infer<T>>>;
     /** Fire-and-forget disposal. */
     close(): void;
     /** Re-read filesystem config (context, hooks, project MCP, subagents) without disposing. */
@@ -2039,4 +2146,4 @@ declare class Cron {
     static status(_options?: CronStartOptions): Promise<CronSchedulerStatus>;
 }
 
-export { type GoalResult as $, type AgentOptions as A, type BudgetTracker as B, type CloudOptions as C, type CloudRepo as D, type ContextBudget as E, type ContextManagerKind as F, type GetAgentOptions as G, type ContextSnapshot as H, type ContextSource as I, type ContextSourceStatus as J, Cron as K, type LocalOptions as L, type MemorySettings as M, type CronCreateOptions as N, type CronGetOptions as O, type ProviderRoutingSettings as P, type CronJob as Q, type CronJobStatus as R, type SystemPromptResolver as S, type CronListOptions as T, type CronOperationOptions as U, type CronRunOptions as V, type CronRuntime as W, type CronSchedulerStatus as X, type CronStartOptions as Y, type GoalEvent as Z, type GoalOptions as _, type AgentDefinition as a, type HookName as a0, type InvalidateCacheOptions as a1, type MemoryAdapter as a2, type MemoryAdapterCapabilities as a3, type MemoryContext as a4, type MemoryFact as a5, type MemoryProviderHandle as a6, type MemoryProviderInitOptions as a7, type MemoryRevision as a8, type MemoryToolSchema as a9, type MemoryTurnMessage as aa, type PersonalityPreset as ab, type PluginContext as ac, type PostAssistantReplyContext as ad, type PreToolCallContext as ae, type PreUserSendContext as af, type PreUserSendResult as ag, type ProviderCapability as ah, type ProviderRoute as ai, type RecordSessionSummaryArgs as aj, type ResolvedProviderRoute as ak, type RunUntilIterator as al, type SDKAgentPlugins as am, type SDKAgentSkills as an, type SDKArtifact as ao, type SDKContextManager as ap, type SDKPluginMetadata as aq, type SDKProvidersManager as ar, type SettingSource as as, type SystemPromptContext as at, type SystemPromptMemoryFact as au, type SystemPromptSkillRef as av, type TelemetrySettings as aw, definePlugin as ax, type ContextSettings as b, type PluginsSettings as c, type SkillsSettings as d, type SDKAgent as e, type ListAgentsOptions as f, type ListResult as g, type SDKAgentInfo as h, type ListRunsOptions as i, type GetRunOptions as j, type AgentOperationOptions as k, type ProviderProfile as l, type Plugin as m, type ConversationStorageAdapter as n, type StoredMessage as o, type MemoryProvider as p, type MemoryId as q, type PreToolCallDecision as r, type SDKProvider as s, type ActiveMemoryPassArgs as t, type ActiveMemoryPassResult as u, type AgentMemory as v, type BudgetCheck as w, type BudgetTotal as x, type BudgetUsageEvent as y, type CloudEnv as z };
+export { type CronStartOptions as $, type AgentOptions as A, type BudgetTracker as B, type CloudOptions as C, type BudgetUsageEvent as D, type CloudEnv as E, type CloudRepo as F, type GetAgentOptions as G, type ContextBudget as H, type ContextManagerKind as I, type ContextSnapshot as J, type ContextSource as K, type LocalOptions as L, type MemorySettings as M, type ContextSourceStatus as N, type CreateSkillSpec as O, type ProviderRoutingSettings as P, Cron as Q, type CronCreateOptions as R, type SystemPromptResolver as S, type CronGetOptions as T, type CronJob as U, type CronJobStatus as V, type CronListOptions as W, type CronOperationOptions as X, type CronRunOptions as Y, type CronRuntime as Z, type CronSchedulerStatus as _, type AgentDefinition as a, type GoalEvent as a0, type GoalOptions as a1, type GoalResult as a2, type HookName as a3, type InlineSkill as a4, type InvalidateCacheOptions as a5, type MemoryAdapter as a6, type MemoryAdapterCapabilities as a7, type MemoryContext as a8, type MemoryFact as a9, type TelemetrySettings as aA, createSkill as aB, definePlugin as aC, type MemoryProviderHandle as aa, type MemoryProviderInitOptions as ab, type MemoryRevision as ac, type MemoryToolSchema as ad, type MemoryTurnMessage as ae, type PersonalityPreset as af, type PluginContext as ag, type PostAssistantReplyContext as ah, type PreToolCallContext as ai, type PreUserSendContext as aj, type PreUserSendResult as ak, type ProviderCapability as al, type ProviderRoute as am, type RecordSessionSummaryArgs as an, type ResolvedProviderRoute as ao, type RunUntilIterator as ap, type SDKAgentPlugins as aq, type SDKAgentSkills as ar, type SDKArtifact as as, type SDKContextManager as at, type SDKPluginMetadata as au, type SDKProvidersManager as av, type SettingSource as aw, type SystemPromptContext as ax, type SystemPromptMemoryFact as ay, type SystemPromptSkillRef as az, type ContextSettings as b, type PluginsSettings as c, type SkillsSettings as d, type SDKAgent as e, type ListAgentsOptions as f, type ListResult as g, type SDKAgentInfo as h, type ListRunsOptions as i, type GetRunOptions as j, type AgentOperationOptions as k, type ProviderProfile as l, type Plugin as m, type ConversationStorageAdapter as n, type StoredMessage as o, type SessionMeta as p, type SessionMetaPatch as q, type MemoryProvider as r, type MemoryId as s, type PreToolCallDecision as t, type SDKProvider as u, type ActiveMemoryPassArgs as v, type ActiveMemoryPassResult as w, type AgentMemory as x, type BudgetCheck as y, type BudgetTotal as z };