@theokit/sdk 1.6.2 → 1.8.0

package/dist/cron-BYVdYzob.d.ts

@@ -1,221 +0,0 @@
-import { aG as SDKUserMessage, A as AgentOptions, j as ListResult, m as Run } from './run-DkCD5DeO.js';
-
-/**
- * Runtime hosting a cron job. Mirrors the agent runtime split.
- *
- * - `local` — the in-process scheduler activated via `Cron.start()` fires the
- *   job while the host process is alive.
- * - `cloud` — Theo PaaS schedules the job server-side; fires independent of
- *   any SDK process.
- *
- * @public
- */
-type CronRuntime = "local" | "cloud";
-/**
- * Lifecycle state reported by `Cron.list()` / `Cron.get()`.
- *
- * @public
- */
-type CronJobStatus = "scheduled" | "running" | "paused" | "errored";
-/**
- * Persistent cron-scheduled invocation of the Theo agent.
- *
- * Exactly one of {@link CronJob.agent} (ephemeral agent created on each fire)
- * or {@link CronJob.agentId} (bound to an existing agent for context
- * continuity) is set.
- *
- * @public
- */
-interface CronJob {
-    id: string;
-    name?: string;
-    /** Standard 5-field POSIX cron expression or shorthand (`@hourly`, `@daily`, ...). */
-    cron: string;
-    /** IANA timezone identifier. Defaults to `"UTC"`. */
-    timezone?: string;
-    /** Message sent to the agent on each fire. */
-    message: string | SDKUserMessage;
-    /** Ephemeral agent options. Mutually exclusive with `agentId`. */
-    agent?: AgentOptions;
-    /** ID of an existing agent to reuse for context continuity. Mutually exclusive with `agent`. */
-    agentId?: string;
-    /** Whether the scheduler will fire this job on schedule. */
-    enabled: boolean;
-    /** Current status. */
-    status: CronJobStatus;
-    /** Runtime that hosts this job. Inferred from `agent`/`agentId` at create time. */
-    runtime: CronRuntime;
-    /** Unix ms of the last successful fire, if any. */
-    lastRunAt?: number;
-    /** Unix ms of the next scheduled fire, computed by the scheduler. */
-    nextRunAt?: number;
-    /** Unix ms when the job was created. */
-    createdAt: number;
-}
-/**
- * Options for `Cron.create()`.
- *
- * Pass `agent` for an ephemeral agent created fresh on each fire, OR
- * `agentId` to reuse an existing agent (preserves conversation context across
- * fires). Setting both is a `ConfigurationError`.
- *
- * @public
- */
-interface CronCreateOptions {
-    cron: string;
-    message: string | SDKUserMessage;
-    agent?: AgentOptions;
-    agentId?: string;
-    name?: string;
-    timezone?: string;
-    /** Defaults to `true`. */
-    enabled?: boolean;
-    /** Falls back to `THEOKIT_API_KEY`. */
-    apiKey?: string;
-}
-/**
- * Options for `Cron.list()`.
- *
- * @public
- */
-type CronListOptions = {
-    limit?: number;
-    cursor?: string;
-} & ({
-    runtime?: undefined;
-} | {
-    runtime: "local";
-    cwd?: string;
-} | {
-    runtime: "cloud";
-    apiKey?: string;
-});
-/**
- * Options for `Cron.get()`.
- *
- * @public
- */
-interface CronGetOptions {
-    cwd?: string;
-    apiKey?: string;
-}
-/**
- * Options for `Cron.delete()` / `Cron.enable()` / `Cron.disable()`.
- *
- * @public
- */
-interface CronOperationOptions {
-    cwd?: string;
-    apiKey?: string;
-}
-/**
- * Options for `Cron.run()` — manually trigger a job off-schedule.
- *
- * @public
- */
-interface CronRunOptions {
-    cwd?: string;
-    apiKey?: string;
-}
-/**
- * Options for `Cron.start()` — activates the in-process scheduler for local
- * jobs.
- *
- * @public
- */
-interface CronStartOptions {
-    /** Local workspace whose `.theokit/cron/jobs.json` to load. Defaults to `process.cwd()`. */
-    cwd?: string;
-    /** Override the env API key. */
-    apiKey?: string;
-}
-/**
- * Snapshot of the local scheduler returned by `Cron.status()`.
- *
- * @public
- */
-interface CronSchedulerStatus {
-    /** Whether the in-process scheduler is currently running. */
-    running: boolean;
-    /** Number of jobs loaded into the scheduler. */
-    jobCount: number;
-    /** Unix ms of the next scheduled fire across all jobs, if any. */
-    nextFireAt?: number;
-    /** Last error observed in the scheduler, if any. */
-    lastError?: {
-        jobId: string;
-        message: string;
-        at: number;
-    };
-}
-
-/**
- * Static façade for scheduling Theo agent runs on a cron expression.
- *
- * @public
- */
-declare class Cron {
-    private constructor();
-    /**
-     * Create and persist a cron job.
-     *
-     * @public
-     */
-    static create(options: CronCreateOptions): Promise<CronJob>;
-    /**
-     * List cron jobs (local, cloud, or both).
-     *
-     * @public
-     */
-    static list(options?: CronListOptions): Promise<ListResult<CronJob>>;
-    /**
-     * Get a single cron job by ID.
-     *
-     * @public
-     */
-    static get(jobId: string, _options?: CronGetOptions): Promise<CronJob>;
-    /**
-     * Delete a cron job permanently.
-     *
-     * @public
-     */
-    static delete(jobId: string, _options?: CronOperationOptions): Promise<void>;
-    /**
-     * Re-enable a paused cron job.
-     *
-     * @public
-     */
-    static enable(jobId: string, _options?: CronOperationOptions): Promise<CronJob>;
-    /**
-     * Pause a cron job without deleting it.
-     *
-     * @public
-     */
-    static disable(jobId: string, _options?: CronOperationOptions): Promise<CronJob>;
-    /**
-     * Manually trigger a cron job off-schedule. Returns the resulting `Run`.
-     *
-     * @public
-     */
-    static run(jobId: string, _options?: CronRunOptions): Promise<Run>;
-    /**
-     * Activate the in-process scheduler for local cron jobs.
-     *
-     * @public
-     */
-    static start(options?: CronStartOptions): Promise<void>;
-    /**
-     * Stop the in-process scheduler. Jobs are preserved.
-     *
-     * @public
-     */
-    static stop(): Promise<void>;
-    /**
-     * Snapshot of the local scheduler.
-     *
-     * @public
-     */
-    static status(_options?: CronStartOptions): Promise<CronSchedulerStatus>;
-}
-
-export { Cron as C, type CronCreateOptions as a, type CronGetOptions as b, type CronJob as c, type CronJobStatus as d, type CronListOptions as e, type CronOperationOptions as f, type CronRunOptions as g, type CronRuntime as h, type CronSchedulerStatus as i, type CronStartOptions as j };

package/dist/handoff.d.ts

@@ -1,55 +0,0 @@
-/**
- * Public `Handoff` class — factory for handoff descriptors (Adoption
- * Roadmap #4; ADRs D214-D229).
- *
- * Usage:
- *
- *   import { Agent, Handoff } from "@theokit/sdk";
- *
- *   const billing = await Agent.create({
- *     name: "billing",
- *     systemPrompt: "You handle billing questions.",
- *     model: { id: "openai/gpt-4o-mini" },
- *     apiKey: process.env.OPENROUTER_API_KEY,
- *   });
- *
- *   const triage = await Agent.create({
- *     name: "triage",
- *     systemPrompt: "Classify the user's intent and transfer to the right specialist.",
- *     model: { id: "openai/gpt-4o-mini" },
- *     apiKey: process.env.OPENROUTER_API_KEY,
- *     handoffs: [
- *       billing,  // auto-wrapped as Handoff.create(billing)
- *       Handoff.create(supportAgent, { inputFilter: redactCreditCards }),
- *     ],
- *   });
- *
- * @public
- */
-import type { ZodType } from "zod";
-import type { SDKAgent } from "./types/agent.js";
-import type { HandoffDescriptor, HandoffOptions } from "./types/handoff.js";
-/** Recommended system-prompt prefix for senders (D215 / EC-13). */
-export declare const RECOMMENDED_HANDOFF_PROMPT_PREFIX: string;
-export declare class Handoff {
-    private constructor();
-    /**
-     * Build a `HandoffDescriptor` for a target agent. Wrap with custom options
-     * (filter / inputType / callback / whitelist / etc); pass to
-     * `Agent.create({ handoffs: [...] })`.
-     *
-     * Raw `SDKAgent` instances in `handoffs[]` are auto-wrapped by the runtime
-     * — call `Handoff.create()` explicitly only when you need to customize.
-     */
-    static create<TInput extends ZodType = ZodType>(target: SDKAgent, options?: HandoffOptions<TInput>): HandoffDescriptor<TInput>;
-}
-/**
- * Imperative escape hatch (D225). Useful for tests / programmatic flows
- * that need deterministic handoff without LLM routing.
- *
- * NOTE: this is a STANDALONE helper rather than a method on `SDKAgent`
- * to avoid invasive refactor of the agent class. Behavior is identical
- * to invoking the corresponding synthetic tool would be.
- */
-export declare function handoffTo(sender: SDKAgent, target: SDKAgent, message: string, options?: HandoffOptions): Promise<string>;
-export { HandoffLoopError, HandoffNameCollisionError, HandoffPairLoopError, HandoffReceiverDisposedError, HandoffSelfReferenceError, } from "./types/handoff.js";

package/dist/internal/budget/calendar-window.d.ts

@@ -1,19 +0,0 @@
-/**
- * UTC-aligned calendar window helpers (ADR D382).
- *
- * - `1h` — relative (now - 1 hour).
- * - `1d` — UTC midnight (current UTC day).
- * - `1w` — UTC monday 00:00:00 (current UTC week, Monday is week start).
- * - `30d` — relative 30 days.
- * - `365d` — relative 365 days.
- *
- * `1d` and `1w` are calendar-aligned because users expect "1 USD per day"
- * = "since midnight UTC", not a rolling 24h.
- * `30d`/`365d` are relative because nobody expects "since the 1st".
- *
- * @internal
- */
-export declare function startOfDayUtc(now?: Date): Date;
-export declare function startOfWeekUtc(now?: Date): Date;
-/** Returns the inclusive start timestamp (ms) for the given window relative to `now`. */
-export declare function windowStartMs(window: BudgetWindow, now?: Date): number;

package/dist/internal/budget/enforcement.d.ts

@@ -1,32 +0,0 @@
-/**
- * Budget enforcement (ADRs D383, D386, EC-7/8/9).
- *
- * - `preflightCheck(name, estimatedUsd)` — em `block` mode, throw
- *   `BudgetExceededError` antes da LLM call se qualquer limit seria
- *   excedido (EC-9 — caller chama dentro do mutex section).
- * - `chargeAndCheckThresholds(name, actualUsd)` — apply charge ao
- *   ledger + invoca onThreshold/onExceed callbacks isolated em
- *   try/catch (EC-8).
- *
- * @internal
- */
-/**
- * Throws BudgetExceededError if `mode === "block"` and any limit
- * would be exceeded. No-op for audit/warn modes (post-charge checks
- * handle those).
- *
- * Caller invokes this BEFORE the LLM call.
- */
-export declare function preflightCheck(name: string, estimatedUsd: number): void;
-/**
- * Charge the budget + dispatch threshold/exceed callbacks (EC-8 isolated).
- *
- * - In `audit` mode: charge only, no callbacks.
- * - In `warn` mode: charge + onThreshold (80/95) + onExceed (100). No throw.
- * - In `block` mode: charge + onThreshold + onExceed. No throw post-call
- *   (preflightCheck already prevented exceed for the upcoming call;
- *   this protects against simultaneous-call races where multiple sends
- *   each pass preflight independently — last one to charge may still
- *   tip a limit. We document the case rather than retroactively throw).
- */
-export declare function chargeAndCheckThresholds(name: string, actualUsd: number): Promise<void>;

package/dist/internal/budget/ledger.d.ts

@@ -1,25 +0,0 @@
-/**
- * In-process Budget ledger (ADR D385).
- *
- * Singleton mutex-protected. Stores per-budget ChargeLog[] arrays;
- * `spentIn(window)` filters by timestamp.
- *
- * EC-6: GC eviction runs DENTRO do mesmo mutex que charge — sem race.
- * EC-9: charge() é called inside same critical section as preflight
- * check by Budget enforcement.
- *
- * Persistence cross-restart: deferred to v0.2 (JsonFile pattern).
- *
- * @internal
- */
-/** Charge a budget. Idempotent across concurrent calls via withCwdMutex. */
-export declare function charge(name: string, amountUsd: number): Promise<void>;
-/** Return total spend in the given window for `name`. Snapshot read (no mutex needed). */
-export declare function spentIn(name: string, window: BudgetWindow, now?: Date): number;
-/** Diagnostic — total logs across all budgets. */
-export declare function __getLogCountForTests(name?: string): number;
-export declare function __resetLedgerForTests(): void;
-/** Force GC manually (tests only). */
-export declare function __evictNowForTests(): Promise<void>;
-/** Force-insert a log at a specific timestamp (tests only). */
-export declare function __injectLogForTests(name: string, timestamp: number, amountUsd: number): void;

package/dist/internal/budget/normalize-usage.d.ts

@@ -1,27 +0,0 @@
-/**
- * normalizeUsage — convert provider-shaped raw `usage` object to
- * canonical `TokenUsage`. Ports Hermes Agent's `normalize_usage`
- * (referencia/hermes-agent/agent/usage_pricing.py:672-742).
- *
- * Handles 3 API shapes:
- *   - Anthropic Messages: 4 explicit buckets (input/output/cache_read/cache_creation).
- *   - OpenAI Chat Completions: prompt_tokens INCLUDES cache; subtract cached_tokens.
- *   - OpenAI Responses (Codex): input_tokens INCLUDES cache; same subtraction.
- *
- * Edge cases:
- *   - cline#10266 — OpenAI-compat proxies (OpenRouter, Vercel AI Gateway,
- *     Cline) routing Claude expose Anthropic-style top-level fields
- *     (cache_read_input_tokens / cache_creation_input_tokens). Both
- *     locations are checked with top-level fallback.
- *   - Null/undefined fields → 0 via `int()` coerce.
- *   - String token counts → parsed via int.
- *   - Negative values → clamped to 0 (defensive against proxy bugs).
- *
- * @internal
- */
-export type ApiMode = "anthropic_messages" | "openai_chat_completions" | "openai_responses";
-export declare function inferApiMode(provider: string): ApiMode;
-export declare function normalizeUsage(rawUsage: unknown, opts: {
-    provider: string;
-    apiMode?: ApiMode;
-}): TokenUsage;

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

@@ -1,16 +0,0 @@
-/**
- * Internal Budget registry — keeps live `BudgetOptions` per name.
- * Singleton; no persistence (D385).
- *
- * @internal
- */
-import type { BudgetHandle, BudgetMode, BudgetOptions, BudgetSnapshot } from "../../types/budget.js";
-export declare function __resetRegistryForTests(): void;
-export declare function validateBudgetName(name: string): void;
-export declare function createBudget(opts: BudgetOptions): BudgetHandle;
-export declare function getBudget(name: string): BudgetHandle | undefined;
-export declare function listBudgets(): readonly BudgetHandle[];
-export declare function deleteBudget(name: string): boolean;
-export declare function snapshotAll(): readonly BudgetSnapshot[];
-export declare function getBudgetOptionsRaw(name: string): BudgetOptions | undefined;
-export declare function defaultMode(opts: BudgetOptions): BudgetMode;

package/dist/internal/cache/cosine.d.ts

@@ -1,14 +0,0 @@
-/**
- * Cosine distance between two equal-length vectors.
- *
- * Returns `1 - cos(a, b)`. Range:
- *   - 0.0 = identical direction
- *   - 1.0 = orthogonal
- *   - 2.0 = opposite (rare in normalized embeddings)
- *
- * Throws on dim mismatch. (Callers MUST filter by dim before calling
- * — EC-2 absorbed at the store level.)
- *
- * @internal
- */
-export {};

package/dist/internal/cache/embed-helper.d.ts

@@ -1,15 +0,0 @@
-/**
- * Shared embed-with-graceful-degradation helper — used by both `lookup.ts`
- * and `store-handler.ts`. Extracted to remove the embed-failure boilerplate
- * clone flagged by jscpd. EC-1 absorbed: embedder failure is silent (caller
- * decides what to do via the boolean return).
- *
- * @internal
- */
-import type { InMemoryCacheStore } from "./store.js";
-import type { JsonFileCacheStore } from "./store-json.js";
-interface SpanLike {
-    setAttribute(key: string, value: string | number | boolean): SpanLike;
-}
-export declare function embedOrDegrade(embedder: CacheEmbedderRuntime, prompt: string, store: InMemoryCacheStore | JsonFileCacheStore, span: SpanLike, context: "lookup" | "store"): Promise<number[] | undefined>;
-export {};

package/dist/internal/cache/key.d.ts

@@ -1,15 +0,0 @@
-/**
- * Composite cache key (ADR D253).
- *
- * Format: `${namespace}:${embedderId}:${modelId}:${hash(normalizedPrompt)}`.
- * Normalizes whitespace + lowercases. Hash = first 16 hex chars of SHA-256.
- *
- * @internal
- */
-export interface CacheKeyParams {
-    namespace: string;
-    embedderId: string;
-    modelId: string;
-    prompt: string;
-}
-export declare function computeCacheKey(p: CacheKeyParams): string;

package/dist/internal/cache/lookup.d.ts

@@ -1,28 +0,0 @@
-/**
- * Cache lookup handler — wired to `pre_user_send` hook (ADRs D259, D260).
- *
- * EC-1: embedder failure degrades to miss (cache is transparent).
- * EC-3: empty / whitespace prompt bypasses cache (avoids hash collision).
- * EC-5: telemetry span ends in finally even on early-return.
- *
- * @internal
- */
-import type { InMemoryCacheStore } from "./store.js";
-import type { JsonFileCacheStore } from "./store-json.js";
-export type LookupableStore = InMemoryCacheStore | JsonFileCacheStore;
-export interface LookupParams {
-    prompt: string;
-    store: LookupableStore;
-    embedder: CacheEmbedderRuntime;
-    threshold: number;
-    ttl: CacheTTLConfig;
-    namespace: string;
-    modelId: string;
-}
-export interface LookupResult {
-    cached: boolean;
-    response?: string;
-    source?: "kv" | "semantic";
-    distance?: number;
-}
-export declare function performLookup(p: LookupParams): Promise<LookupResult>;

package/dist/internal/cache/store-handler.d.ts

@@ -1,24 +0,0 @@
-/**
- * Cache store handler — wired to `post_assistant_reply` hook (ADRs D260, D266).
- *
- * EC-1: embedder failure during store is silent (LLM call already succeeded;
- * no cache entry written).
- * EC-3: empty prompt bypass.
- * EC-10 / D266: skip storage when the run invoked tools (replay loses
- * side-effects).
- *
- * @internal
- */
-import type { LookupableStore } from "./lookup.js";
-export interface StoreParams {
-    prompt: string;
-    response: string;
-    /** D266: skip cache when tools were used. */
-    usedTools?: boolean;
-    store: LookupableStore;
-    embedder: CacheEmbedderRuntime;
-    ttl: CacheTTLConfig;
-    namespace: string;
-    modelId: string;
-}
-export declare function performStore(p: StoreParams): Promise<void>;

package/dist/internal/cache/store-json.d.ts

@@ -1,48 +0,0 @@
-/**
- * JSON disk-backed cache store (ADR D265).
- *
- * One file per namespace at `<dir>/<namespace>.json`. Uses
- * `atomicWriteText` (D60) for crash-safe writes. Debounced flush (200ms)
- * to coalesce bursts.
- *
- * EC-7: corrupt JSON load → log warn + treat as empty cache. Never
- * propagates parse errors that would block `Agent.create`.
- *
- * Layered behind `InMemoryCacheStore` — disk is just persistence; all
- * lookups still hit the in-memory Map for O(1) KV / O(N) vector scan.
- *
- * @internal
- */
-import type { CacheEntry, CacheStats } from "../../types/cache.js";
-import { type CacheStore } from "./store.js";
-export declare class JsonFileCacheStore implements CacheStore {
-    private readonly dir;
-    private readonly namespace;
-    private readonly inner;
-    private flushTimer;
-    private dirty;
-    constructor(dir: string, namespace: string, maxEntries: number);
-    /** Hydrate from disk. EC-7: corrupt file → empty cache. */
-    hydrate(): Promise<void>;
-    kvGet(key: string, now: number): CacheEntry | undefined;
-    semanticSearch(vector: ReadonlyArray<number>, threshold: number, embedderId: string, namespace: string, now: number): {
-        entry: CacheEntry;
-        distance: number;
-    } | undefined;
-    set(entry: CacheEntry): void;
-    delete(key: string): void;
-    clear(): Promise<void>;
-    stats(): CacheStats;
-    evictExpired(now: number): number;
-    /** Force write the current snapshot. Called on shutdown / clear. */
-    flush(): Promise<void>;
-    /** Counters proxied to inner. */
-    incrementKvHits(): void;
-    incrementSemanticHits(): void;
-    incrementMisses(): void;
-    incrementExcluded(): void;
-    incrementEmbedderFailures(): void;
-    private filePath;
-    private markDirty;
-    private writeSnapshot;
-}

package/dist/internal/cache/store.d.ts

@@ -1,54 +0,0 @@
-/**
- * Cache store interface + in-memory implementation (ADRs D252, D259, D261).
- *
- * INVARIANT (EC-9, EC-13): KV map and vector view are the SAME Map.
- * `semanticSearch` iterates `Map.values()`. No parallel list. `set` replaces
- * by key (Map semantics) — no duplicate-on-race possible.
- *
- * EC-2: `semanticSearch` filters by `embedderId === currentEmbedderId &&
- * vector.length === currentDim` before cosine compare. Protects against
- * dim mismatch when disk-loaded entries used a different embedder.
- *
- * @internal
- */
-export interface CacheStore {
-    kvGet(key: string, now: number): CacheEntry | undefined;
-    semanticSearch(vector: ReadonlyArray<number>, threshold: number, embedderId: string, namespace: string, now: number): {
-        entry: CacheEntry;
-        distance: number;
-    } | undefined;
-    set(entry: CacheEntry): void;
-    delete(key: string): void;
-    clear(): Promise<void>;
-    stats(): CacheStats;
-    evictExpired(now: number): number;
-    /** For persistence backends — bulk import. */
-    loadAll?(entries: ReadonlyArray<CacheEntry>): void;
-    /** For persistence backends — snapshot for serialization. */
-    dump?(): ReadonlyArray<CacheEntry>;
-}
-export declare class InMemoryCacheStore implements CacheStore {
-    private readonly maxEntries;
-    private readonly map;
-    private readonly counters;
-    constructor(maxEntries: number);
-    kvGet(key: string, now: number): CacheEntry | undefined;
-    private isEligibleForSearch;
-    semanticSearch(vector: ReadonlyArray<number>, threshold: number, embedderId: string, namespace: string, now: number): {
-        entry: CacheEntry;
-        distance: number;
-    } | undefined;
-    set(entry: CacheEntry): void;
-    delete(key: string): void;
-    clear(): Promise<void>;
-    stats(): CacheStats;
-    evictExpired(now: number): number;
-    loadAll(entries: ReadonlyArray<CacheEntry>): void;
-    dump(): ReadonlyArray<CacheEntry>;
-    /** Internal helpers for counters (used by lookup/store handlers). */
-    incrementKvHits(): void;
-    incrementSemanticHits(): void;
-    incrementMisses(): void;
-    incrementExcluded(): void;
-    incrementEmbedderFailures(): void;
-}

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

@@ -1,20 +0,0 @@
-/**
- * OTel telemetry for semantic cache (ADR D262).
- *
- * Spans:
- *   - `cache.lookup` — per `pre_user_send`. Attributes: namespace, embedder.id,
- *     hit (kv|semantic|miss), distance, ttl_remaining_s, bypass_reason.
- *   - `cache.store` — per `post_assistant_reply`. Attributes: bypass_reason, stored.
- *
- * @internal
- */
-export declare function startCacheLookupSpan(info: {
-    namespace: string;
-    embedderId: string;
-}): SpanLike;
-export declare function startCacheStoreSpan(info: {
-    namespace: string;
-    embedderId: string;
-}): SpanLike;
-/** Test seam — reset tracer cache so a fresh require attempt happens. */
-export declare function __resetCacheTelemetryForTests(): void;

package/dist/internal/cache/ttl.d.ts

@@ -1,11 +0,0 @@
-/**
- * TTL string parser. Accepts:
- *   - number → treated as SECONDS
- *   - string `"\d+(s|m|h|d|w)"` → seconds/minutes/hours/days/weeks
- *
- * EC-8: `"0s"` / `0` returns 0 (effectively disables cache for that entry).
- *       Negative numbers throw `CacheInvalidTtlError`.
- *
- * @internal
- */
-export declare function parseTtlMs(input: string | number): number;

package/dist/internal/catalog/fixtures.d.ts

@@ -1,16 +0,0 @@
-import type { SDKProvider } from "../../types/providers.js";
-import type { SDKModel, SDKRepository, SDKUser } from "../../types/theokit.js";
-/** Fixture user identity (matches `tests/golden/theokit/me.json`). */
-export declare const FIXTURE_USER: SDKUser;
-/** Fixture model catalog (matches `tests/golden/theokit/models.json`). */
-export declare const FIXTURE_MODELS: SDKModel[];
-/** Fixture connected repos (matches `tests/golden/theokit/repositories.json`). */
-export declare const FIXTURE_REPOSITORIES: SDKRepository[];
-/**
- * Fixture provider catalog. Covers chat, web_search, image, and embedding
- * capabilities. The `setupSchema` is intentionally generic JSON Schema —
- * consumers drive UI from these definitions.
- *
- * Public and secret-free by design — no tokens or API key examples.
- */
-export declare const FIXTURE_PROVIDERS: SDKProvider[];