@theokit/sdk 1.6.1 → 1.7.0

package/dist/internal/catalog/local-models.d.ts

@@ -1,24 +0,0 @@
-/**
- * Local model discovery via OpenAI-compatible `/v1/models` endpoint
- * (T2.1, ADR D184).
- *
- * Used by `Theokit.models.list({ provider: "ollama" })` (and any other
- * future provider with `authType: "none"` exposing the OpenAI-shape
- * models endpoint — LM Studio, llama.cpp `./server`, vLLM, etc.) to
- * enumerate locally-installed models without a cloud round-trip.
- *
- * Aligned with OpenClaw `extensions/ollama/src/provider-models.ts` which
- * targets the same endpoint shape. Mirrors the relevant Hermes
- * `models.dev` catalog behavior for local providers.
- *
- * @internal
- */
-import type { SDKModel } from "../../types/theokit.js";
-/**
- * Fetch and map `<baseUrl>/v1/models` → `SDKModel[]`. Throws a typed
- * `ConfigurationError` on connection failures (ECONNREFUSED → "Run
- * `ollama serve`"). Returns `[]` when the body is unparseable —
- * defensive choice over crashing on malformed responses from
- * non-standard local runtimes.
- */
-export declare function listLocalModelsViaOpenAiCompat(baseUrl: string): Promise<SDKModel[]>;

package/dist/internal/handoff/dispatcher.d.ts

@@ -1,29 +0,0 @@
-/**
- * Handoff dispatch orchestration.
- *
- * Pragmatic v1: when a handoff fires, the sender calls `receiver.send()`
- * with the (optionally filtered) history. The receiver's reply is returned
- * to the sender, which captures it as the answer to the user's question.
- *
- * NOTE: this is NOT pure peer-to-peer (the sender stays on the call stack
- * until the receiver returns). Pure intercept-and-swap requires deeper
- * agent-loop refactor; deferred to v2. v1 still validates the user-facing
- * value: "agent A reasoned about routing, agent B answered."
- *
- * @internal
- */
-import type { HandoffDescriptor, HandoffHistory, HandoffResult } from "../../types/handoff.js";
-import { type HandoffChainState } from "./registry.js";
-export declare function dispatchHandoff(args: {
-    descriptor: HandoffDescriptor;
-    senderAgentId: string;
-    chainState: HandoffChainState;
-    rawInputJson: unknown;
-    /** The conversation so far (history wrapper). v1: just the LAST user message. */
-    history: HandoffHistory;
-    /** Override the message text sent to the receiver. Used by `Agent.handoffTo` imperative. */
-    messageOverride?: string;
-}): Promise<{
-    reply: string;
-    result: HandoffResult;
-}>;

package/dist/internal/handoff/registry.d.ts

@@ -1,23 +0,0 @@
-/**
- * Handoff registry — pure state container per `Agent` instance.
- *
- * Holds the active dispatch chain (for depth + pair tracking) across the
- * lifetime of a single `agent.send()` call. Cleared between calls.
- *
- * @internal
- */
-export interface HandoffChainState {
-    /** Ordered chain of agentIds traversed so far (oldest first). */
-    readonly chain: string[];
-    /** Set of "<sender>-><receiver>" keys for pair-level loop detection (D221). */
-    readonly seenPairs: Set<string>;
-    /** Caller-supplied max depth (D218). */
-    readonly maxDepth: number;
-}
-export declare function createChainState(rootAgentId: string, maxDepth: number): HandoffChainState;
-/**
- * Record a handoff hop. Throws on depth-exceed (D218) or pair-loop (D221).
- * Mutates the state in place.
- */
-export declare function recordHop(state: HandoffChainState, senderAgentId: string, receiverAgentId: string): void;
-export declare function currentDepth(state: HandoffChainState): number;

package/dist/internal/handoff/telemetry.d.ts

@@ -1,18 +0,0 @@
-/**
- * D220 — Lazy-loaded OTel `handoff.transfer` span emitter.
- *
- * @internal
- */
-export interface HandoffSpanHandle {
-    setAttribute(key: string, value: string | number | boolean): void;
-    end(): void;
-}
-export declare function startHandoffSpan(attrs: {
-    from: string;
-    to: string;
-    reason: string;
-    depth: number;
-    toolName: string;
-}): HandoffSpanHandle;
-/** Test-only — reset cached OTel handle. */
-export declare function __resetHandoffOtelCacheForTests(): void;

package/dist/internal/handoff/tool-injector.d.ts

@@ -1,34 +0,0 @@
-/**
- * Convert `handoffs[]` entries into synthetic `transfer_to_<receiver>` tools
- * for injection into the agent's tool registry at construction time.
- *
- * The synthesized tool's handler calls `dispatchHandoff` internally and
- * returns the receiver's reply as `tool_result`. v1 trade-off documented
- * in dispatcher.ts.
- *
- * @internal
- */
-import type { CustomTool, SDKAgent } from "../../types/agent.js";
-import { type HandoffDescriptor } from "../../types/handoff.js";
-interface NormalizedHandoff {
-    descriptor: HandoffDescriptor;
-}
-/**
- * Normalize each `handoffs[]` entry to a `HandoffDescriptor`. Raw `SDKAgent`
- * instances are auto-wrapped with default options. Validates:
- *   - EC-6: no self-reference (would cause infinite recursion).
- *   - D215: resolved tool names must be unique.
- */
-export declare function normalizeHandoffs(parentAgentId: string, entries: ReadonlyArray<SDKAgent | HandoffDescriptor>): NormalizedHandoff[];
-/**
- * Build a `CustomTool` for one handoff descriptor. The handler dispatches
- * the handoff using a fresh chain state per `send()`-level invocation.
- *
- * NOTE: this v1 builds a NEW chain state per tool invocation. Pure
- * cross-tool depth tracking within one send() requires per-Agent context
- * — deferred. The single-flight pair guard catches direct ping-pong even
- * without cross-invocation chain (since each call wraps the same depth
- * counter from 1).
- */
-export declare function buildHandoffTool(parentAgentId: string, descriptor: HandoffDescriptor, maxHandoffDepth: number): CustomTool;
-export {};

package/dist/internal/memory/atomic-write.d.ts

@@ -1,7 +0,0 @@
-/**
- * @deprecated Import from `../persistence/atomic-write.js` instead.
- * Maintained as re-export for backward compatibility (ADR D59).
- *
- * @internal
- */
-export { atomicWriteJson, replaceFileAtomic } from "../persistence/atomic-write.js";

package/dist/internal/memory/dreaming/diary.d.ts

@@ -1,4 +0,0 @@
-export declare function diaryPath(cwd: string): string;
-export declare function renderDiaryEntry(entry: DiaryEntry): string;
-export declare function appendDiaryEntry(cwd: string, entry: DiaryEntry): Promise<void>;
-export declare function entryHash(entry: DiaryEntry): string;

package/dist/internal/memory/dreaming/phases.d.ts

@@ -1,15 +0,0 @@
-import type { EmbeddingRuntime } from "../embedding-adapter.js";
-import type { MemoryFact } from "../types.js";
-export interface Cluster {
-    representativeText: string;
-    members: ReadonlyArray<MemoryFact>;
-}
-export interface ClusterResult {
-    clusters: Cluster[];
-}
-/** Light phase — drop facts whose embedding is too similar to one already kept. */
-export declare function lightPhase(facts: ReadonlyArray<MemoryFact>, embedding: EmbeddingRuntime, threshold?: number): Promise<DedupResult>;
-/** REM phase — single-link agglomerative clustering by cosine similarity. */
-export declare function remPhase(facts: ReadonlyArray<MemoryFact>, embedding: EmbeddingRuntime, threshold?: number): Promise<ClusterResult>;
-/** Deep phase — render consolidated markdown for the dreamed note. */
-export declare function deepPhase(clusters: ReadonlyArray<Cluster>, timestampMs: number): string;

package/dist/internal/memory/dreaming/run.d.ts

@@ -1,10 +0,0 @@
-export interface DreamingResult {
-    status: "ok" | "skipped" | "error";
-    factsBefore: number;
-    factsAfter: number;
-    duplicatesRemoved: number;
-    clustersCreated: number;
-    notesWritten: number;
-    diaryEntryHash: string | undefined;
-}
-export declare function runDreamingSweep(options: DreamingOptions): Promise<DreamingResult>;

package/dist/internal/memory/migrate-sqlite-to-lance.d.ts

@@ -1,15 +0,0 @@
-export interface MigrateResult {
-    countSqlite: number;
-    countLance: number;
-    /** Set when validation succeeded (or dryRun); false on validation failure. */
-    validated: boolean;
-    /** Per-fact compare results (size = sample count, up to 10). */
-    sampleComparisons: ReadonlyArray<{
-        id: string;
-        match: boolean;
-    }>;
-    /** Lance storage location (final, after migration). */
-    lancePath: string;
-    /** Was the migration committed (false for dry-run). */
-    committed: boolean;
-}

package/dist/memory-adapter-helpers.d.ts

@@ -1,28 +0,0 @@
-/**
- * Runtime helpers for `MemoryAdapter` (T1.1, ADR D141).
- *
- * Kept separate from `types/memory-adapter.ts` so the types module
- * stays import-free of runtime code (dep-cruise rule
- * `types-dont-import-runtime`). Adapter authors call `mkMemoryId` to
- * construct a branded id and `extractRawId` to unwrap with cross-adapter
- * safety (EC-B).
- *
- * @public
- */
-import type { MemoryId } from "./types/memory-adapter.js";
-/**
- * Construct a branded `MemoryId` for an adapter. Embeds the adapter
- * identifier so `extractRawId` can reject ids minted by other adapters.
- *
- * @public
- */
-export declare function mkMemoryId(adapterId: string, rawId: string): MemoryId;
-/**
- * Extract the raw provider id from a `MemoryId`, enforcing that the
- * prefix matches `expectedAdapterId`. Throws `MemoryAdapterError(code:
- * "invalid_input")` on mismatch — prevents `mem0.delete(supermemoryId)`
- * from accidentally deleting unrelated data (EC-B).
- *
- * @public
- */
-export declare function extractRawId(id: MemoryId, expectedAdapterId: string): string;

package/dist/memory.d.ts

@@ -1,123 +0,0 @@
-/**
- * Public handle to an open memory index. Mirrors the internal `MemoryIndex`
- * contract structurally; defined here (NOT re-exported from internal/) so
- * the public DTS surface does not pull the internal/runtime cycle that
- * trips rollup-plugin-dts.
- *
- * @public
- */
-export interface MemoryIndexHandle {
-    sync(): Promise<{
-        filesScanned: number;
-        filesUpdated: number;
-        chunksWritten: number;
-        chunksEmbedded: number;
-    }>;
-    search(query: string, options?: {
-        maxResults?: number;
-        minScore?: number;
-        sources?: ReadonlyArray<"memory" | "sessions" | "wiki">;
-    }): Promise<ReadonlyArray<{
-        path: string;
-        startLine: number;
-        endLine: number;
-        score: number;
-        textScore: number;
-        vectorScore?: number;
-        snippet: string;
-        source: "memory" | "sessions" | "wiki";
-        citation: string;
-    }>>;
-    status(): {
-        backend: "fts-only" | "hybrid";
-        filesIndexed: number;
-        chunksIndexed: number;
-        lastSyncMs?: number;
-    };
-    close(): Promise<void> | void;
-}
-/**
- * Public `Memory` namespace.
- *
- * Exposes operations users can run outside of `agent.send()` — most notably
- * the dreaming sweep (consolidation of facts via dedup + clustering).
- *
- * @public
- */
-export interface DreamingSweepOptions {
-    /** Workspace cwd holding `.theokit/memory/`. */
-    cwd: string;
-    /**
-     * Embedding provider for semantic dedup + clustering. Required — dreaming
-     * relies on real embeddings to score cosine similarity. Supported providers:
-     * `"openai"`, `"mistral"`, `"openrouter"`, `"voyage"`, `"deepinfra"`,
-     * `"ollama"` (local, ADR D183).
-     */
-    embedding: {
-        provider: "openai" | "mistral" | "openrouter" | "voyage" | "deepinfra" | "ollama";
-        model?: string;
-    };
-    /** Cosine-similarity threshold for the dedup phase. Default `0.95`. */
-    dedupThreshold?: number;
-    /** Cosine-similarity threshold for the clustering phase. Default `0.75`. */
-    clusterThreshold?: number;
-}
-export interface DreamingSweepResult {
-    status: "ok" | "skipped" | "error";
-    factsBefore: number;
-    factsAfter: number;
-    duplicatesRemoved: number;
-    clustersCreated: number;
-    notesWritten: number;
-}
-/**
- * Options for `Memory.openIndex`. Mirrors the internal `OpenIndexOptions`
- * but using only public types from the SDK surface.
- *
- * @public
- */
-export interface OpenMemoryIndexOptions {
-    /** Workspace cwd holding `.theokit/memory/`. */
-    cwd: string;
-    /** Override storage file path (SQLite) OR storage directory (Lance). */
-    filePath?: string;
-    /**
-     * Embedding runtime — REQUIRED for `backend: "lance"`, optional for
-     * `"sqlite-vec"` (when omitted, SQLite runs FTS-only without vector
-     * recall).
-     */
-    embedding?: {
-        provider: "openai" | "mistral" | "openrouter" | "voyage" | "deepinfra" | "ollama";
-        model?: string;
-    };
-    /** Default `"sqlite-vec"`. Set to `"lance"` to opt into LanceDB (peer dep). */
-    backend?: "sqlite-vec" | "lance";
-}
-export declare const Memory: {
-    /**
-     * Open a memory index. Dispatches to SQLite-vec (default, zero deps) or
-     * LanceDB (opt-in via `backend: "lance"`, requires `@lancedb/lancedb`
-     * peer dep + an embedding runtime).
-     *
-     * Returns a `MemoryIndex` with `sync()`, `search(query, opts?)`,
-     * `status()`, and `close()`. Use this when you want a direct index
-     * handle outside of `Agent.create({ memory: ... })`.
-     *
-     * @throws ConfigurationError({code:"invalid_memory_backend"}) for typos
-     *   like `"lancedb"`.
-     * @throws ConfigurationError({code:"lance_requires_embedding"}) when
-     *   `backend: "lance"` is requested without `embedding`.
-     * @throws ConfigurationError({code:"lance_backend_unavailable"}) when
-     *   `backend: "lance"` is requested but the peer dep is absent.
-     *
-     * @public
-     */
-    openIndex(opts: OpenMemoryIndexOptions): Promise<MemoryIndexHandle>;
-    /**
-     * Run a dreaming sweep: dedup near-duplicate facts, cluster thematically
-     * related ones, and write a consolidated note + diary entry.
-     *
-     * @public
-     */
-    runDreamingSweep(opts: DreamingSweepOptions): Promise<DreamingSweepResult>;
-};

package/dist/migrate.d.ts

@@ -1,33 +0,0 @@
-/**
- * Options for {@link migrateSqliteToLance}.
- *
- * @public
- */
-export interface MigrateOptions {
-    cwd: string;
-    dryRun?: boolean;
-    batchSize?: number;
-    logger?: (msg: string) => void;
-}
-/**
- * Outcome of {@link migrateSqliteToLance}.
- *
- * @public
- */
-export interface MigrateResult {
-    countSqlite: number;
-    countLance: number;
-    validated: boolean;
-    sampleComparisons: ReadonlyArray<{
-        id: string;
-        match: boolean;
-    }>;
-    lancePath: string;
-    committed: boolean;
-}
-/**
- * Migrate the Memory index from SQLite to LanceDB. ADR D44.
- *
- * @public
- */
-export declare function migrateSqliteToLance(options: MigrateOptions): Promise<MigrateResult>;

package/dist/security.d.ts

@@ -1,67 +0,0 @@
-/**
- * Public security namespace (T2.1, ADR D68).
- *
- * Two entry points:
- *
- * - `Security.redact(text, opts?)` — apply the canonical redactor to
- *   arbitrary text. Useful when a consumer app (or example) writes its
- *   own logs / metrics / paste-share artifacts that the SDK's wired
- *   sinks (error metadata, telemetry, transcript, migration) don't
- *   cover.
- * - `Security.addPattern(re)` — register a custom credential pattern
- *   on top of the 12 builtins (OpenAI, Anthropic, GitHub PAT classic +
- *   fine, GitLab, AWS, Google, Slack, Sentry, Stripe live + restricted)
- *   plus the parametric `key=value` + `Bearer <token>` matchers.
- *
- * Redaction is ON by default. Disable with `THEOKIT_REDACT_SECRETS=false`
- * (a warning is emitted on stderr so the operator knows the SDK process
- * is vulnerable). The env var is snapshotted at module init — runtime
- * mutation cannot disable it, defending against prompt injection that
- * tries to flip the flag mid-run.
- */
-export declare class Security {
-    private constructor();
-    /**
-     * Redact known credential patterns from `text` and return the masked
-     * string. Use this at any consumer output boundary the SDK does not
-     * directly own (custom stdout loggers, app-level metrics, debug-share
-     * artifacts, etc.).
-     *
-     * Coerces non-strings (objects via JSON.stringify, null/undefined → "").
-     * Two-bucket masking: tokens shorter than 18 chars → `***`; longer
-     * tokens preserve `prefix...suffix` for debuggability without revealing
-     * the secret middle.
-     *
-     * @param text - The value to redact. Strings, objects, primitives all OK.
-     * @param opts.codeFile - When `true`, skips the parametric `key=value`
-     *   matcher so file content like `.env.example` placeholders is left
-     *   intact. Built-in pattern matches still apply.
-     *
-     * @example
-     * console.log(`[bot] received: ${Security.redact(userText)}`);
-     * // → "[bot] received: please remember sk-abc...xyz1"
-     */
-    static redact(text: unknown, opts?: {
-        codeFile?: boolean;
-    }): string;
-    /**
-     * Register a custom redaction pattern. Additive — built-in patterns
-     * (OpenAI, Anthropic, GitHub PAT, AWS, etc.) cannot be removed.
-     *
-     * @param re - RegExp with `/g` flag. Throws if `/g` is missing
-     *             (without /g, only first match is replaced and the rest
-     *             leaks).
-     *
-     * Process-global mutable state. The SDK is designed for single-tenant
-     * processes (Theo PaaS user runtime, local CLI). Multi-tenant
-     * deployments running multiple SDK consumers in the same Node process
-     * share this list — patterns added by tenant A apply to tenant B's
-     * redactions. Acceptable for v1; future isolate-aware refactor would
-     * thread patterns through a context if needed.
-     *
-     * @example
-     * Security.addPattern(/MYORG-[A-Z0-9]{32}/g);
-     * // → text containing "MYORG-AAAA...AAAA" now masks like a builtin.
-     */
-    static addPattern(re: RegExp): void;
-}

package/dist/task.d.ts

@@ -1,87 +0,0 @@
-/**
- * `Task` — observable async work registry (Adoption Roadmap gap #2,
- * ADRs D361-D374).
- *
- * Static facade delegating to the in-process `TaskRegistry` singleton.
- * The lifecycle of any task is the 5-state machine `queued | running |
- * finished | error | cancelled` (D362). Wrapping `Agent.send` /
- * `Agent.batch` / `Workflow.run` / `Cron` fires is opt-in via the
- * `{ task: true }` option on each (D363).
- *
- * @public
- */
-import type { TaskCancelResult, TaskEvent, TaskFilter, TaskHandle, TaskKind, TaskStoreOptions, TaskSubmitOptions } from "./types/task.js";
-export interface TaskWorkContext {
-    readonly signal: AbortSignal;
-    emit(payload: unknown): void;
-}
-export type TaskWorkFn<T> = (ctx: TaskWorkContext) => Promise<T> | T;
-/**
- * Registry-level configuration. May only be applied BEFORE the first
- * `Task.submit` of the process — see EC-13. Subsequent calls emit a
- * single stderr line and become no-ops.
- */
-export interface TaskConfigureOptions {
-    readonly store?: TaskStoreOptions;
-    readonly maxConcurrent?: number;
-    readonly retentionMs?: number;
-}
-export declare class Task {
-    private constructor();
-    /**
-     * Configure the registry. **Must be called before the first `submit`**
-     * (EC-13). Available knobs: pluggable store (D364), concurrency cap
-     * (D369), and retention (D373).
-     */
-    static configure(opts: TaskConfigureOptions): void;
-    /**
-     * Submit a unit of asynchronous work to the registry.
-     *
-     * The `work` function receives `{ signal, emit }` — `signal` is the
-     * AbortSignal honored on cancel; `emit(payload)` produces a
-     * `progress` event observable via `Task.subscribe`.
-     *
-     * Returns a `TaskHandle` in `state: "queued"`. Subsequent state
-     * transitions are observable via `Task.subscribe(handle.id)` OR
-     * polled via `Task.get(handle.id)`.
-     *
-     * **Idempotency (D367):** submitting twice with the same `id` returns
-     * the existing handle without re-invoking work.
-     *
-     * **Grammar (D368):** user-supplied ids must match
-     * `^[a-z0-9][a-z0-9_-]*$` and must not start with reserved prefixes
-     * `wf-` / `b-` / `cron-`. Otherwise `InvalidTaskIdError` is thrown.
-     *
-     * **Pre-aborted signal (EC-4):** if `options.signal` is already
-     * aborted, the task short-circuits to `cancelled` without acquiring
-     * a semaphore slot and without invoking `work`.
-     */
-    static submit<T>(kind: TaskKind, work: TaskWorkFn<T>, options?: TaskSubmitOptions): Promise<TaskHandle>;
-    /** Returns matching handles, capped at `filter.limit ?? 100`. */
-    static list(filter?: TaskFilter): Promise<TaskHandle[]>;
-    /** Returns a single handle by id, or `undefined` if unknown / evicted. */
-    static get(id: string): Promise<TaskHandle | undefined>;
-    /**
-     * Idempotent cancel (D365). Returns:
-     *   - `{ cancelled: true, alreadyTerminal: false }` — transitioned
-     *     queued/running task to `cancelled`.
-     *   - `{ cancelled: false, alreadyTerminal: true }` — task already
-     *     terminal.
-     *   - `{ cancelled: false, alreadyTerminal: false }` — task unknown.
-     *
-     * Never throws.
-     */
-    static cancel(id: string, reason?: string): Promise<TaskCancelResult>;
-    /**
-     * Subscribe to a task's event stream. The returned `AsyncIterable<TaskEvent>`
-     * starts by replaying buffered events (ring buffer cap 64, D372) and
-     * then yields live events until a terminal event (finished / errored
-     * / cancelled) is emitted, at which point it closes automatically.
-     *
-     * Calling `.return()` on the iterator (or `break` in a `for await`)
-     * cleans up the subscriber callback (EC-10).
-     *
-     * Throws `TaskNotFoundError` if the id is unknown or has been evicted.
-     */
-    static subscribe(id: string): AsyncIterable<TaskEvent>;
-}

package/dist/theokit.d.ts

@@ -1,84 +0,0 @@
-import type { SDKProvider } from "./types/providers.js";
-import type { SDKModel, SDKRepository, SDKUser } from "./types/theokit.js";
-/**
- * Options shared by every `Theokit.*` request.
- *
- * @public
- */
-export interface TheokitRequestOptions {
-    /** Override the `THEOKIT_API_KEY` env var for this call. */
-    apiKey?: string;
-    /**
-     * Target a specific provider for catalog reads. When set to a provider
-     * with `authType: "none"` (e.g. `"ollama"`, `"lmstudio"`, `"llamacpp"`),
-     * `Theokit.models.list({ provider })` reads from the provider's local
-     * `/v1/models` endpoint instead of the TheoCloud catalog. ADR D184.
-     *
-     * @public
-     */
-    provider?: string;
-}
-/**
- * Account-level and catalog reads. All methods accept an optional `apiKey`
- * and otherwise fall back to the `THEOKIT_API_KEY` environment variable.
- *
- * @public
- */
-export declare class Theokit {
-    private constructor();
-    /**
-     * Return the user behind the current API key.
-     *
-     * @public
-     */
-    static me(options?: TheokitRequestOptions): Promise<SDKUser>;
-    /**
-     * Model catalog reads.
-     *
-     * @public
-     */
-    static readonly models: {
-        list: (options?: TheokitRequestOptions) => Promise<SDKModel[]>;
-    };
-    /**
-     * Connected GitHub repositories for the calling user's team. Cloud only.
-     *
-     * @public
-     */
-    static readonly repositories: {
-        list: (options?: TheokitRequestOptions) => Promise<SDKRepository[]>;
-    };
-    /**
-     * Provider catalog. Lists every provider known to the platform, including
-     * plugin-registered ones, with capability and availability metadata.
-     *
-     * @public
-     */
-    static readonly providers: {
-        list: (options?: TheokitRequestOptions) => Promise<SDKProvider[]>;
-    };
-    /**
-     * Local introspection of bundled SDK assets (ADR D201). Unlike the
-     * cloud-catalog `providers.list()` (which hits the TheoCloud HTTP API),
-     * `inspect.*` reads the SDK's own bundled registries — useful for
-     * tooling (e.g. `@theokit/cli`'s `theokit inspect`) that needs to know
-     * what's available WITHOUT a network round-trip.
-     *
-     * @public
-     */
-    static readonly inspect: {
-        builtinProviders: () => Array<{
-            readonly name: string;
-            readonly apiMode: string;
-            readonly authType: string;
-            readonly baseUrl: string;
-            readonly aliases?: ReadonlyArray<string>;
-            readonly envVars: ReadonlyArray<string>;
-        }>;
-        embeddingAdapters: () => Array<{
-            readonly id: string;
-            readonly transport: string;
-            readonly defaultModel: string;
-        }>;
-    };
-}

package/dist/tools/_path-scope.d.ts

@@ -1,8 +0,0 @@
-/**
- * Shared `safePathJoin + assertNoSymlinkEscape` helper for built-in coding
- * tools (git-diff, run-vitest, list-dir, read-file, search-text). Returns a
- * pre-formatted `path_traversal` JSON string on failure or `null` on pass.
- *
- * @internal
- */
-export declare function checkPathScope(path: string | undefined, projectRoot: string): string | null;

package/dist/tools/_subprocess.d.ts

@@ -1,28 +0,0 @@
-/**
- * Shared subprocess-watch helpers for built-in coding tools (git-diff,
- * run-vitest). Wires the on(close)/on(error) settle pattern in a single
- * place to eliminate the cross-file clone flagged by jscpd.
- *
- * @internal
- */
-/**
- * Settle gate — guarantees the supplied callback fires exactly once across
- * the close/error/timeout race. Clears the timer on settle.
- */
-interface SettleGate {
-    /** True after first settle; subsequent calls are no-ops. */
-    settled: () => boolean;
-    /** Settle the gate, clear the timer, and call `onSettle()`. */
-    fire: (onSettle: () => void) => void;
-}
-/**
- * Wire SIGKILL-on-timeout for a detached process group. Returns the settle
- * gate so caller listeners can short-circuit when the timeout already fired.
- */
-export declare function armTimeoutKill<T>(child: ChildProcess, timeoutMs: number, onTimeout: () => T, resolve: (value: T) => void): SettleGate;
-/**
- * Attach a close+error pair of listeners that resolve via the supplied
- * callbacks. Honors the gate so timeout-vs-close races settle exactly once.
- */
-export declare function attachChildSettlers<T>(child: ChildProcess, gate: SettleGate, onClose: (code: number | null) => T, onError: (err: Error) => T, resolve: (value: T) => void): void;
-export {};