@theokit/sdk 2.19.0 → 2.21.0

package/dist/generate-object.d.ts

@@ -1,5 +1,5 @@
-import type { ZodType } from "zod";
-import type { LocalOptions, ModelSelection } from "./types/agent.js";
+import type { z as ZodNamespace, ZodType } from "zod";
+import type { AgentOptions, LocalOptions, ModelSelection, SDKAgent } from "./types/agent.js";
 import type { ProviderRoutingSettings } from "./types/providers.js";
 /**
  * Options accepted by {@link Agent.generateObject}. Returns a typed object
@@ -14,8 +14,16 @@ export interface GenerateObjectOptions<T extends ZodType> {
     prompt: string;
     /** Optional system prompt steering the model. */
     systemPrompt?: string;
-    /** Model selection. Required (transient agents need a model). */
-    model: ModelSelection;
+    /** Model selection. Required (transient agents need a model). SE8 — accepts a
+     *  bare-string id shorthand (`"openai/gpt-4o-mini"`) or a {@link ModelSelection}. */
+    model: string | ModelSelection;
+    /**
+     * M21 — optional separate model for the STRUCTURING step. When set, `model` first produces a
+     * free-text reasoned answer to the prompt (phase 1), then `structuringModel` extracts the
+     * schema-matched object by calling the `output` tool over that answer (phase 2). Lets a large
+     * model reason while a cheap fast model does the extraction. Absent ⇒ today's single-model flow.
+     */
+    structuringModel?: string | ModelSelection;
     /** API key. Falls back to env (THEOKIT_API_KEY etc). */
     apiKey?: string;
     /** Local runtime config (cwd, sandbox). Required to keep the transient agent local-only. */
@@ -76,3 +84,10 @@ export declare class GenerateObjectError extends Error {
     readonly cause?: unknown;
     constructor(code: "no_tool_call" | "parse_failed", message: string, cause?: unknown);
 }
+interface GenerateObjectDeps {
+    create: (options: AgentOptions) => Promise<SDKAgent>;
+    /** Hard-delete the transient agent from the registry after dispose. */
+    delete: (agentId: string) => Promise<void>;
+}
+export declare function generateObjectImpl<T extends ZodType>(options: GenerateObjectOptions<T>, deps: GenerateObjectDeps): Promise<GenerateObjectResult<ZodNamespace.infer<T>>>;
+export {};