@levelcode/sdk 0.2.2 → 0.2.4

package/dist/common/src/types/dynamic-agent-template.d.ts

@@ -0,0 +1,227 @@
+import { z } from 'zod/v4';
+import type { JSONSchema } from 'zod/v4/core';
+export declare const JsonSchemaSchema: z.ZodType<JSONSchema.BaseSchema, JSONSchema.BaseSchema>;
+declare const PromptFieldSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    path: z.ZodString;
+}, z.core.$strip>]>;
+export type PromptField = z.infer<typeof PromptFieldSchema>;
+export declare const DynamicAgentDefinitionSchema: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    publisher: z.ZodOptional<z.ZodString>;
+    displayName: z.ZodString;
+    model: z.ZodString;
+    reasoningOptions: z.ZodOptional<z.ZodIntersection<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        exclude: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
+        max_tokens: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        effort: z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+            minimal: "minimal";
+            none: "none";
+        }>;
+    }, z.core.$strip>]>>>;
+    providerOptions: z.ZodOptional<z.ZodObject<{
+        order: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        allow_fallbacks: z.ZodOptional<z.ZodBoolean>;
+        require_parameters: z.ZodOptional<z.ZodBoolean>;
+        data_collection: z.ZodOptional<z.ZodEnum<{
+            allow: "allow";
+            deny: "deny";
+        }>>;
+        only: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        ignore: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        quantizations: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            unknown: "unknown";
+            int4: "int4";
+            int8: "int8";
+            fp4: "fp4";
+            fp6: "fp6";
+            fp8: "fp8";
+            fp16: "fp16";
+            bf16: "bf16";
+            fp32: "fp32";
+        }>>>;
+        sort: z.ZodOptional<z.ZodEnum<{
+            price: "price";
+            throughput: "throughput";
+            latency: "latency";
+        }>>;
+        max_price: z.ZodOptional<z.ZodObject<{
+            prompt: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+            completion: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+            image: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+            audio: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+            request: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    mcpServers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodDefault<z.ZodEnum<{
+            http: "http";
+            sse: "sse";
+        }>>;
+        url: z.ZodString;
+        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodDefault<z.ZodLiteral<"stdio">>;
+        command: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>]>>>;
+    toolNames: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    spawnableAgents: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    inputSchema: z.ZodOptional<z.ZodObject<{
+        prompt: z.ZodOptional<z.ZodObject<{
+            type: z.ZodLiteral<"string">;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        params: z.ZodOptional<z.ZodIntersection<z.ZodType<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema, z.core.$ZodTypeInternals<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>, z.ZodObject<{
+            type: z.ZodLiteral<"object">;
+        }, z.core.$strip>>>;
+    }, z.core.$loose>>;
+    includeMessageHistory: z.ZodDefault<z.ZodBoolean>;
+    inheritParentSystemPrompt: z.ZodDefault<z.ZodBoolean>;
+    outputMode: z.ZodDefault<z.ZodEnum<{
+        last_message: "last_message";
+        all_messages: "all_messages";
+        structured_output: "structured_output";
+    }>>;
+    outputSchema: z.ZodOptional<z.ZodIntersection<z.ZodType<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema, z.core.$ZodTypeInternals<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>, z.ZodObject<{
+        type: z.ZodLiteral<"object">;
+    }, z.core.$strip>>>;
+    spawnerPrompt: z.ZodOptional<z.ZodString>;
+    systemPrompt: z.ZodOptional<z.ZodString>;
+    instructionsPrompt: z.ZodOptional<z.ZodString>;
+    stepPrompt: z.ZodOptional<z.ZodString>;
+    handleSteps: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodOptional<z.ZodCustom<z.core.$InferInnerFunctionType<z.ZodTuple<readonly [z.ZodObject<{
+        agentState: z.ZodObject<{
+            agentId: z.ZodString;
+            parentId: z.ZodString;
+            messageHistory: z.ZodArray<z.ZodAny>;
+        }, z.core.$strip>;
+        prompt: z.ZodOptional<z.ZodString>;
+        params: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strip>, z.ZodOptional<z.ZodObject<{
+        debug: z.ZodFunction<z.ZodTuple<readonly [z.ZodAny, z.ZodOptional<z.ZodString>], null>, z.ZodVoid>;
+        info: z.ZodFunction<z.ZodTuple<readonly [z.ZodAny, z.ZodOptional<z.ZodString>], null>, z.ZodVoid>;
+        warn: z.ZodFunction<z.ZodTuple<readonly [z.ZodAny, z.ZodOptional<z.ZodString>], null>, z.ZodVoid>;
+        error: z.ZodFunction<z.ZodTuple<readonly [z.ZodAny, z.ZodOptional<z.ZodString>], null>, z.ZodVoid>;
+    }, z.core.$strip>>], null>, z.ZodAny>, z.core.$InferInnerFunctionType<z.ZodTuple<readonly [z.ZodObject<{
+        agentState: z.ZodObject<{
+            agentId: z.ZodString;
+            parentId: z.ZodString;
+            messageHistory: z.ZodArray<z.ZodAny>;
+        }, z.core.$strip>;
+        prompt: z.ZodOptional<z.ZodString>;
+        params: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strip>, z.ZodOptional<z.ZodObject<{
+        debug: z.ZodFunction<z.ZodTuple<readonly [z.ZodAny, z.ZodOptional<z.ZodString>], null>, z.ZodVoid>;
+        info: z.ZodFunction<z.ZodTuple<readonly [z.ZodAny, z.ZodOptional<z.ZodString>], null>, z.ZodVoid>;
+        warn: z.ZodFunction<z.ZodTuple<readonly [z.ZodAny, z.ZodOptional<z.ZodString>], null>, z.ZodVoid>;
+        error: z.ZodFunction<z.ZodTuple<readonly [z.ZodAny, z.ZodOptional<z.ZodString>], null>, z.ZodVoid>;
+    }, z.core.$strip>>], null>, z.ZodAny>>>]>>;
+}, z.core.$strip>;
+export type DynamicAgentDefinition = z.input<typeof DynamicAgentDefinitionSchema>;
+export type DynamicAgentDefinitionParsed = z.infer<typeof DynamicAgentDefinitionSchema>;
+export declare const DynamicAgentTemplateSchema: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    publisher: z.ZodOptional<z.ZodString>;
+    displayName: z.ZodString;
+    model: z.ZodString;
+    reasoningOptions: z.ZodOptional<z.ZodIntersection<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        exclude: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
+        max_tokens: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        effort: z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+            minimal: "minimal";
+            none: "none";
+        }>;
+    }, z.core.$strip>]>>>;
+    providerOptions: z.ZodOptional<z.ZodObject<{
+        order: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        allow_fallbacks: z.ZodOptional<z.ZodBoolean>;
+        require_parameters: z.ZodOptional<z.ZodBoolean>;
+        data_collection: z.ZodOptional<z.ZodEnum<{
+            allow: "allow";
+            deny: "deny";
+        }>>;
+        only: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        ignore: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        quantizations: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            unknown: "unknown";
+            int4: "int4";
+            int8: "int8";
+            fp4: "fp4";
+            fp6: "fp6";
+            fp8: "fp8";
+            fp16: "fp16";
+            bf16: "bf16";
+            fp32: "fp32";
+        }>>>;
+        sort: z.ZodOptional<z.ZodEnum<{
+            price: "price";
+            throughput: "throughput";
+            latency: "latency";
+        }>>;
+        max_price: z.ZodOptional<z.ZodObject<{
+            prompt: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+            completion: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+            image: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+            audio: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+            request: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    mcpServers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodDefault<z.ZodEnum<{
+            http: "http";
+            sse: "sse";
+        }>>;
+        url: z.ZodString;
+        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodDefault<z.ZodLiteral<"stdio">>;
+        command: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>]>>>;
+    toolNames: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    spawnableAgents: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    inputSchema: z.ZodOptional<z.ZodObject<{
+        prompt: z.ZodOptional<z.ZodObject<{
+            type: z.ZodLiteral<"string">;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        params: z.ZodOptional<z.ZodIntersection<z.ZodType<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema, z.core.$ZodTypeInternals<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>, z.ZodObject<{
+            type: z.ZodLiteral<"object">;
+        }, z.core.$strip>>>;
+    }, z.core.$loose>>;
+    includeMessageHistory: z.ZodDefault<z.ZodBoolean>;
+    inheritParentSystemPrompt: z.ZodDefault<z.ZodBoolean>;
+    outputMode: z.ZodDefault<z.ZodEnum<{
+        last_message: "last_message";
+        all_messages: "all_messages";
+        structured_output: "structured_output";
+    }>>;
+    outputSchema: z.ZodOptional<z.ZodIntersection<z.ZodType<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema, z.core.$ZodTypeInternals<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>, z.ZodObject<{
+        type: z.ZodLiteral<"object">;
+    }, z.core.$strip>>>;
+    spawnerPrompt: z.ZodOptional<z.ZodString>;
+    systemPrompt: z.ZodString;
+    instructionsPrompt: z.ZodString;
+    stepPrompt: z.ZodString;
+    handleSteps: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DynamicAgentTemplate = z.infer<typeof DynamicAgentTemplateSchema>;
+export {};

package/dist/common/src/types/filesystem.d.ts

@@ -0,0 +1,6 @@
+import type fs from 'fs';
+/** File system used for LevelCode SDK.
+ *
+ * Compatible with `fs.promises` from the `'fs'` module.
+ */
+export type LevelCodeFileSystem = Pick<typeof fs.promises, 'mkdir' | 'readdir' | 'readFile' | 'stat' | 'writeFile'>;

package/dist/common/src/types/function-params.d.ts

@@ -0,0 +1,15 @@
+import type { UnionToIntersection } from 'bun-types/vendor/expect-type';
+type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type StripExact<T> = T extends infer U & {
+    [x: string]: never;
+} ? U : T;
+type ParamsOfFunction<T> = T extends (params: infer C) => any ? StripExact<C> : never;
+type IsUnion<T, U = T> = T extends any ? ([U] extends [T] ? false : true) : false;
+type ParamsOfArray<T> = UnionToIntersection<T extends [infer fn, ...infer rest] ? ParamsOfFunction<fn> | ParamsOfArray<rest> : {}>;
+type ParamsOfUnion<T> = IsUnion<T> extends true ? UnionToIntersection<ParamsOfFunction<T>> : ParamsOfFunction<T>;
+export type ParamsOf<T> = Prettify<T extends any[] ? ParamsOfArray<T> : ParamsOfUnion<T>>;
+export type OptionalFields<T, K extends keyof T> = Prettify<Omit<T, K> & Partial<Pick<T, K>>>;
+export type ParamsExcluding<T, K extends keyof ParamsOf<T>> = Prettify<Omit<ParamsOf<T>, K>>;
+export {};

package/dist/common/src/types/grant.d.ts

@@ -0,0 +1,2 @@
+export type GrantType = 'free' | 'referral' | 'referral_legacy' | 'subscription' | 'purchase' | 'admin' | 'organization' | 'ad';
+export declare const GrantTypeValues: readonly ["free", "referral", "referral_legacy", "subscription", "purchase", "admin", "organization", "ad"];

package/dist/common/src/types/json.d.ts

@@ -0,0 +1,9 @@
+import z from 'zod/v4';
+export type JSONValue = null | string | number | boolean | JSONObject | JSONArray;
+export declare const jsonValueSchema: z.ZodType<JSONValue>;
+export declare const jsonObjectSchema: z.ZodType<JSONObject>;
+export type JSONObject = {
+    [key in string]: JSONValue;
+};
+export declare const jsonArraySchema: z.ZodType<JSONArray>;
+export type JSONArray = JSONValue[];

package/dist/common/src/types/mcp.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod/v4';
+export declare const mcpConfigStdioSchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodLiteral<"stdio">>;
+    command: z.ZodString;
+    args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>;
+export declare const mcpConfigRemoteSchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodEnum<{
+        http: "http";
+        sse: "sse";
+    }>>;
+    url: z.ZodString;
+    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>;
+export declare const mcpConfigSchema: z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodDefault<z.ZodEnum<{
+        http: "http";
+        sse: "sse";
+    }>>;
+    url: z.ZodString;
+    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodDefault<z.ZodLiteral<"stdio">>;
+    command: z.ZodString;
+    args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>]>;
+export type MCPConfig = z.infer<typeof mcpConfigSchema>;

package/dist/common/src/types/messages/content-part.d.ts

@@ -0,0 +1,46 @@
+import z from 'zod/v4';
+export declare const textPartSchema: z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodType<import("../json").JSONValue, unknown, z.core.$ZodTypeInternals<import("../json").JSONValue, unknown>>>>>;
+}, z.core.$strip>;
+export type TextPart = z.infer<typeof textPartSchema>;
+export declare const imagePartSchema: z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    image: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodCustom<Uint8Array, Uint8Array>, z.ZodCustom<ArrayBuffer, ArrayBuffer>, z.ZodCustom<Buffer, Buffer>]>, z.ZodCustom<URL, URL>]>;
+    mediaType: z.ZodOptional<z.ZodString>;
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodType<import("../json").JSONValue, unknown, z.core.$ZodTypeInternals<import("../json").JSONValue, unknown>>>>>;
+}, z.core.$strip>;
+export type ImagePart = z.infer<typeof imagePartSchema>;
+export declare const filePartSchema: z.ZodObject<{
+    type: z.ZodLiteral<"file">;
+    data: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodCustom<Uint8Array, Uint8Array>, z.ZodCustom<ArrayBuffer, ArrayBuffer>, z.ZodCustom<Buffer, Buffer>]>, z.ZodCustom<URL, URL>]>;
+    filename: z.ZodOptional<z.ZodString>;
+    mediaType: z.ZodString;
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodType<import("../json").JSONValue, unknown, z.core.$ZodTypeInternals<import("../json").JSONValue, unknown>>>>>;
+}, z.core.$strip>;
+export type FilePart = z.infer<typeof filePartSchema>;
+export declare const reasoningPartSchema: z.ZodObject<{
+    type: z.ZodLiteral<"reasoning">;
+    text: z.ZodString;
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodType<import("../json").JSONValue, unknown, z.core.$ZodTypeInternals<import("../json").JSONValue, unknown>>>>>;
+}, z.core.$strip>;
+export type ReasoningPart = z.infer<typeof reasoningPartSchema>;
+export declare const toolCallPartSchema: z.ZodObject<{
+    type: z.ZodLiteral<"tool-call">;
+    toolCallId: z.ZodString;
+    toolName: z.ZodString;
+    input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodType<import("../json").JSONValue, unknown, z.core.$ZodTypeInternals<import("../json").JSONValue, unknown>>>>>;
+    providerExecuted: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ToolCallPart = z.infer<typeof toolCallPartSchema>;
+export declare const toolResultOutputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"json">;
+    value: z.ZodType<import("../json").JSONValue, unknown, z.core.$ZodTypeInternals<import("../json").JSONValue, unknown>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"media">;
+    data: z.ZodString;
+    mediaType: z.ZodString;
+}, z.core.$strip>], "type">;
+export type ToolResultOutput = z.infer<typeof toolResultOutputSchema>;

package/dist/common/src/types/messages/data-content.d.ts

@@ -0,0 +1,3 @@
+import z from 'zod/v4';
+export declare const dataContentSchema: z.ZodUnion<readonly [z.ZodString, z.ZodCustom<Uint8Array, Uint8Array>, z.ZodCustom<ArrayBuffer, ArrayBuffer>, z.ZodCustom<Buffer, Buffer>]>;
+export type DataContent = z.infer<typeof dataContentSchema>;

package/dist/common/src/types/messages/levelcode-message.d.ts

@@ -0,0 +1,37 @@
+import type { FilePart, ImagePart, ReasoningPart, TextPart, ToolCallPart, ToolResultOutput } from './content-part';
+import type { ProviderMetadata } from './provider-metadata';
+export type AuxiliaryMessageData = {
+    providerOptions?: ProviderMetadata;
+    tags?: string[];
+    /**
+     * Unix timestamp (ms) when the message was added to history.
+     * Used to detect prompt cache expiry (>5 min gap = cache miss).
+     * This field is stripped before sending to the LLM.
+     */
+    sentAt?: number;
+    /** @deprecated Use tags instead. */
+    timeToLive?: 'agentStep' | 'userPrompt';
+    /** @deprecated Use tags instead. */
+    keepDuringTruncation?: boolean;
+    /** @deprecated Use tags instead. */
+    keepLastTags?: string[];
+};
+export type SystemMessage = {
+    role: 'system';
+    content: TextPart[];
+} & AuxiliaryMessageData;
+export type UserMessage = {
+    role: 'user';
+    content: (TextPart | ImagePart | FilePart)[];
+} & AuxiliaryMessageData;
+export type AssistantMessage = {
+    role: 'assistant';
+    content: (TextPart | ReasoningPart | ToolCallPart)[];
+} & AuxiliaryMessageData;
+export type ToolMessage = {
+    role: 'tool';
+    toolCallId: string;
+    toolName: string;
+    content: ToolResultOutput[];
+} & AuxiliaryMessageData;
+export type Message = SystemMessage | UserMessage | AssistantMessage | ToolMessage;

package/dist/common/src/types/messages/provider-metadata.d.ts

@@ -0,0 +1,3 @@
+import z from 'zod/v4';
+export declare const providerMetadataSchema: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodType<import("../json").JSONValue, unknown, z.core.$ZodTypeInternals<import("../json").JSONValue, unknown>>>>;
+export type ProviderMetadata = z.infer<typeof providerMetadataSchema>;

package/dist/common/src/types/print-mode.d.ts

@@ -0,0 +1,155 @@
+import z from 'zod/v4';
+export declare const printModeStartSchema: z.ZodObject<{
+    type: z.ZodLiteral<"start">;
+    agentId: z.ZodOptional<z.ZodString>;
+    messageHistoryLength: z.ZodNumber;
+}, z.core.$strip>;
+export type PrintModeStart = z.infer<typeof printModeStartSchema>;
+export declare const printModeErrorSchema: z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    message: z.ZodString;
+}, z.core.$strip>;
+export type PrintModeError = z.infer<typeof printModeErrorSchema>;
+export declare const printModeDownloadStatusSchema: z.ZodObject<{
+    type: z.ZodLiteral<"download">;
+    version: z.ZodString;
+    status: z.ZodEnum<{
+        failed: "failed";
+        complete: "complete";
+    }>;
+}, z.core.$strip>;
+export type PrintModeDownloadStatus = z.infer<typeof printModeDownloadStatusSchema>;
+export declare const printModeToolCallSchema: z.ZodObject<{
+    type: z.ZodLiteral<"tool_call">;
+    toolCallId: z.ZodString;
+    toolName: z.ZodString;
+    input: z.ZodRecord<z.ZodString, z.ZodAny>;
+    agentId: z.ZodOptional<z.ZodString>;
+    parentAgentId: z.ZodOptional<z.ZodString>;
+    includeToolCall: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type PrintModeToolCall = z.infer<typeof printModeToolCallSchema>;
+export declare const printModeToolResultSchema: z.ZodObject<{
+    type: z.ZodLiteral<"tool_result">;
+    toolCallId: z.ZodString;
+    toolName: z.ZodString;
+    output: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"json">;
+        value: z.ZodType<import("src").JSONValue, unknown, z.core.$ZodTypeInternals<import("src").JSONValue, unknown>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"media">;
+        data: z.ZodString;
+        mediaType: z.ZodString;
+    }, z.core.$strip>], "type">>;
+    parentAgentId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PrintModeToolResult = z.infer<typeof printModeToolResultSchema>;
+export declare const printModeTextSchema: z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+    agentId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PrintModeText = z.infer<typeof printModeTextSchema>;
+export declare const printModeFinishSchema: z.ZodObject<{
+    type: z.ZodLiteral<"finish">;
+    agentId: z.ZodOptional<z.ZodString>;
+    totalCost: z.ZodNumber;
+}, z.core.$strip>;
+export type PrintModeFinish = z.infer<typeof printModeFinishSchema>;
+export declare const printModeSubagentStartSchema: z.ZodObject<{
+    type: z.ZodLiteral<"subagent_start">;
+    agentId: z.ZodString;
+    agentType: z.ZodString;
+    displayName: z.ZodString;
+    onlyChild: z.ZodBoolean;
+    parentAgentId: z.ZodOptional<z.ZodString>;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PrintModeSubagentStart = z.infer<typeof printModeSubagentStartSchema>;
+export declare const printModeSubagentFinishSchema: z.ZodObject<{
+    type: z.ZodLiteral<"subagent_finish">;
+    agentId: z.ZodString;
+    agentType: z.ZodString;
+    displayName: z.ZodString;
+    onlyChild: z.ZodBoolean;
+    parentAgentId: z.ZodOptional<z.ZodString>;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PrintModeSubagentFinish = z.infer<typeof printModeSubagentFinishSchema>;
+export declare const printModeReasoningDeltaSchema: z.ZodObject<{
+    type: z.ZodLiteral<"reasoning_delta">;
+    text: z.ZodString;
+    ancestorRunIds: z.ZodArray<z.ZodString>;
+    runId: z.ZodString;
+}, z.core.$strip>;
+export type PrintModeReasoningDelta = z.infer<typeof printModeReasoningDeltaSchema>;
+export declare const printModeEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"download">;
+    version: z.ZodString;
+    status: z.ZodEnum<{
+        failed: "failed";
+        complete: "complete";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    message: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"finish">;
+    agentId: z.ZodOptional<z.ZodString>;
+    totalCost: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"start">;
+    agentId: z.ZodOptional<z.ZodString>;
+    messageHistoryLength: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"subagent_finish">;
+    agentId: z.ZodString;
+    agentType: z.ZodString;
+    displayName: z.ZodString;
+    onlyChild: z.ZodBoolean;
+    parentAgentId: z.ZodOptional<z.ZodString>;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"subagent_start">;
+    agentId: z.ZodString;
+    agentType: z.ZodString;
+    displayName: z.ZodString;
+    onlyChild: z.ZodBoolean;
+    parentAgentId: z.ZodOptional<z.ZodString>;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+    agentId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_call">;
+    toolCallId: z.ZodString;
+    toolName: z.ZodString;
+    input: z.ZodRecord<z.ZodString, z.ZodAny>;
+    agentId: z.ZodOptional<z.ZodString>;
+    parentAgentId: z.ZodOptional<z.ZodString>;
+    includeToolCall: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_result">;
+    toolCallId: z.ZodString;
+    toolName: z.ZodString;
+    output: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"json">;
+        value: z.ZodType<import("src").JSONValue, unknown, z.core.$ZodTypeInternals<import("src").JSONValue, unknown>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"media">;
+        data: z.ZodString;
+        mediaType: z.ZodString;
+    }, z.core.$strip>], "type">>;
+    parentAgentId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"reasoning_delta">;
+    text: z.ZodString;
+    ancestorRunIds: z.ZodArray<z.ZodString>;
+    runId: z.ZodString;
+}, z.core.$strip>], "type">;
+export type PrintModeEvent = z.infer<typeof printModeEventSchema>;

package/dist/common/src/types/session-state.d.ts

@@ -0,0 +1,94 @@
+import { z } from 'zod/v4';
+import type { Message } from './messages/levelcode-message';
+import type { ProjectFileContext } from '../util/file';
+export declare const toolCallSchema: z.ZodObject<{
+    toolName: z.ZodString;
+    toolCallId: z.ZodString;
+    input: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, z.core.$strip>;
+export type ToolCall = z.infer<typeof toolCallSchema>;
+export declare const subgoalSchema: z.ZodObject<{
+    objective: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        NOT_STARTED: "NOT_STARTED";
+        IN_PROGRESS: "IN_PROGRESS";
+        COMPLETE: "COMPLETE";
+        ABORTED: "ABORTED";
+    }>>;
+    plan: z.ZodOptional<z.ZodString>;
+    logs: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type Subgoal = z.infer<typeof subgoalSchema>;
+export type AgentState = {
+    /**
+     * @deprecated agentId is replaced by runId
+     */
+    agentId: string;
+    agentType: AgentTemplateType | null;
+    agentContext: Record<string, Subgoal>;
+    ancestorRunIds: string[];
+    runId?: string;
+    subagents: AgentState[];
+    childRunIds: string[];
+    messageHistory: Message[];
+    stepsRemaining: number;
+    creditsUsed: number;
+    directCreditsUsed: number;
+    output?: Record<string, any>;
+    parentId?: string;
+    systemPrompt: string;
+    toolDefinitions: Record<string, {
+        description: string | undefined;
+        inputSchema: {};
+    }>;
+    /**
+     * The accurate token count from the Anthropic API.
+     * This is updated on every agent step via the /api/v1/token-count endpoint.
+     */
+    contextTokenCount: number;
+};
+export declare const AgentOutputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"structuredOutput">;
+    value: z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodNull]>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"lastMessage">;
+    value: z.ZodArray<z.ZodAny>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"allMessages">;
+    value: z.ZodArray<z.ZodAny>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    message: z.ZodString;
+    statusCode: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>], "type">;
+export type AgentOutput = z.infer<typeof AgentOutputSchema>;
+export declare const AgentTemplateTypeList: readonly ["base", "base_free", "base_max", "base_experimental", "claude4_gemini_thinking", "superagent", "base_agent_builder", "ask", "planner", "dry_run", "thinker", "file_picker", "file_explorer", "researcher", "reviewer", "agent_builder", "example_programmatic"];
+type UnderscoreToDash<S extends string> = S extends `${infer L}_${infer R}` ? `${L}-${UnderscoreToDash<R>}` : S;
+export declare const AgentTemplateTypes: { [K in (typeof AgentTemplateTypeList)[number]]: UnderscoreToDash<K>; };
+declare const agentTemplateTypeSchema: z.ZodEnum<{
+    base: "base";
+    base_free: "base_free";
+    base_max: "base_max";
+    base_experimental: "base_experimental";
+    claude4_gemini_thinking: "claude4_gemini_thinking";
+    superagent: "superagent";
+    base_agent_builder: "base_agent_builder";
+    ask: "ask";
+    planner: "planner";
+    dry_run: "dry_run";
+    thinker: "thinker";
+    file_picker: "file_picker";
+    file_explorer: "file_explorer";
+    researcher: "researcher";
+    reviewer: "reviewer";
+    agent_builder: "agent_builder";
+    example_programmatic: "example_programmatic";
+}>;
+export type AgentTemplateType = z.infer<typeof agentTemplateTypeSchema> | (string & {});
+export type SessionState = {
+    fileContext: ProjectFileContext;
+    mainAgentState: AgentState;
+};
+export declare function getInitialAgentState(): AgentState;
+export declare function getInitialSessionState(fileContext: ProjectFileContext): SessionState;
+export {};