@comma-agents/core 2.0.0-rc.0

package/dist/strategy/schema.d.ts

@@ -0,0 +1,1032 @@
+import { z } from "zod";
+import type { BUILT_IN_TOOL_NAMES } from "../tools/tool.constants";
+export type BuiltInToolName = (typeof BUILT_IN_TOOL_NAMES)[number];
+/** User agent — collects human input. */
+export declare const UserAgentDefSchema: z.ZodObject<{
+    type: z.ZodLiteral<"user">;
+    description: z.ZodOptional<z.ZodString>;
+    config: z.ZodOptional<z.ZodObject<{
+        requireInput: z.ZodOptional<z.ZodBoolean>;
+        presetMessage: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        requireInput?: boolean | undefined;
+        presetMessage?: string | undefined;
+    }, {
+        requireInput?: boolean | undefined;
+        presetMessage?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    type: "user";
+    description?: string | undefined;
+    config?: {
+        requireInput?: boolean | undefined;
+        presetMessage?: string | undefined;
+    } | undefined;
+}, {
+    type: "user";
+    description?: string | undefined;
+    config?: {
+        requireInput?: boolean | undefined;
+        presetMessage?: string | undefined;
+    } | undefined;
+}>;
+/** LLM agent — backed by a language model. */
+export declare const LLMAgentDefSchema: z.ZodObject<{
+    type: z.ZodOptional<z.ZodLiteral<"llm">>;
+    description: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    systemPrompt: z.ZodOptional<z.ZodString>;
+    systemPromptTemplate: z.ZodOptional<z.ZodObject<{
+        template: z.ZodString;
+        variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString, "many">, z.ZodRecord<z.ZodString, z.ZodString>]>>>;
+    }, "strict", z.ZodTypeAny, {
+        template: string;
+        variables?: Record<string, string | number | boolean | string[] | Record<string, string>> | undefined;
+    }, {
+        template: string;
+        variables?: Record<string, string | number | boolean | string[] | Record<string, string>> | undefined;
+    }>>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Skills whose full instructions must be loaded into this agent's system
+     * prompt. All discovered skills remain available through the skill tools.
+     */
+    skills: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Per-call provider options forwarded verbatim to the AI SDK. Used to
+     * enable provider-specific features such as Anthropic extended thinking
+     * or OpenAI reasoning effort. Shape:
+     * `{ <providerId>: { <option>: <value>, ... }, ... }`.
+     */
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    /**
+     * Model-level generation parameters (temperature, maxOutputTokens, topP, seed,
+     * etc.). Forwarded to `streamText` as top-level options. Provider-specific
+     * features should use `providerOptions` instead.
+     */
+    modelOptions: z.ZodOptional<z.ZodObject<{
+        temperature: z.ZodOptional<z.ZodNumber>;
+        topP: z.ZodOptional<z.ZodNumber>;
+        topK: z.ZodOptional<z.ZodNumber>;
+        maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+        maxRetries: z.ZodOptional<z.ZodNumber>;
+        frequencyPenalty: z.ZodOptional<z.ZodNumber>;
+        presencePenalty: z.ZodOptional<z.ZodNumber>;
+        seed: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        topK?: number | undefined;
+        maxOutputTokens?: number | undefined;
+        maxRetries?: number | undefined;
+        frequencyPenalty?: number | undefined;
+        presencePenalty?: number | undefined;
+        seed?: number | undefined;
+    }, {
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        topK?: number | undefined;
+        maxOutputTokens?: number | undefined;
+        maxRetries?: number | undefined;
+        frequencyPenalty?: number | undefined;
+        presencePenalty?: number | undefined;
+        seed?: number | undefined;
+    }>>;
+    /** JSON Schema describing the agent's structured output. */
+    outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** Conversation context retention and compaction controls. */
+    context: z.ZodOptional<z.ZodObject<{
+        rollingWindow: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodObject<{
+            maxRecords: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            maxRecords: number;
+        }, {
+            maxRecords: number;
+        }>]>>;
+        compaction: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
+            keepRecent: z.ZodOptional<z.ZodNumber>;
+            threshold: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            keepRecent?: number | undefined;
+            threshold?: number | undefined;
+        }, {
+            keepRecent?: number | undefined;
+            threshold?: number | undefined;
+        }>]>>;
+    }, "strict", z.ZodTypeAny, {
+        rollingWindow?: number | {
+            maxRecords: number;
+        } | undefined;
+        compaction?: boolean | {
+            keepRecent?: number | undefined;
+            threshold?: number | undefined;
+        } | undefined;
+    }, {
+        rollingWindow?: number | {
+            maxRecords: number;
+        } | undefined;
+        compaction?: boolean | {
+            keepRecent?: number | undefined;
+            threshold?: number | undefined;
+        } | undefined;
+    }>>;
+    /**
+     * Maximum number of LLM round-trips (steps) per call.
+     * Each tool-call + response counts as one step.
+     */
+    maxSteps: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    type?: "llm" | undefined;
+    description?: string | undefined;
+    model?: string | undefined;
+    systemPrompt?: string | undefined;
+    systemPromptTemplate?: {
+        template: string;
+        variables?: Record<string, string | number | boolean | string[] | Record<string, string>> | undefined;
+    } | undefined;
+    tools?: string[] | undefined;
+    providerOptions?: Record<string, Record<string, unknown>> | undefined;
+    modelOptions?: {
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        topK?: number | undefined;
+        maxOutputTokens?: number | undefined;
+        maxRetries?: number | undefined;
+        frequencyPenalty?: number | undefined;
+        presencePenalty?: number | undefined;
+        seed?: number | undefined;
+    } | undefined;
+    outputSchema?: Record<string, unknown> | undefined;
+    context?: {
+        rollingWindow?: number | {
+            maxRecords: number;
+        } | undefined;
+        compaction?: boolean | {
+            keepRecent?: number | undefined;
+            threshold?: number | undefined;
+        } | undefined;
+    } | undefined;
+    maxSteps?: number | undefined;
+    skills?: string[] | undefined;
+}, {
+    type?: "llm" | undefined;
+    description?: string | undefined;
+    model?: string | undefined;
+    systemPrompt?: string | undefined;
+    systemPromptTemplate?: {
+        template: string;
+        variables?: Record<string, string | number | boolean | string[] | Record<string, string>> | undefined;
+    } | undefined;
+    tools?: string[] | undefined;
+    providerOptions?: Record<string, Record<string, unknown>> | undefined;
+    modelOptions?: {
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        topK?: number | undefined;
+        maxOutputTokens?: number | undefined;
+        maxRetries?: number | undefined;
+        frequencyPenalty?: number | undefined;
+        presencePenalty?: number | undefined;
+        seed?: number | undefined;
+    } | undefined;
+    outputSchema?: Record<string, unknown> | undefined;
+    context?: {
+        rollingWindow?: number | {
+            maxRecords: number;
+        } | undefined;
+        compaction?: boolean | {
+            keepRecent?: number | undefined;
+            threshold?: number | undefined;
+        } | undefined;
+    } | undefined;
+    maxSteps?: number | undefined;
+    skills?: string[] | undefined;
+}>;
+/**
+ * An agent definition is either a user agent or an LLM agent.
+ * Discriminated by the `type` field (user agents must have `type: "user"`,
+ * LLM agents may omit `type` or set `type: "llm"`).
+ */
+export declare const AgentDefSchema: z.ZodUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"user">;
+    description: z.ZodOptional<z.ZodString>;
+    config: z.ZodOptional<z.ZodObject<{
+        requireInput: z.ZodOptional<z.ZodBoolean>;
+        presetMessage: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        requireInput?: boolean | undefined;
+        presetMessage?: string | undefined;
+    }, {
+        requireInput?: boolean | undefined;
+        presetMessage?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    type: "user";
+    description?: string | undefined;
+    config?: {
+        requireInput?: boolean | undefined;
+        presetMessage?: string | undefined;
+    } | undefined;
+}, {
+    type: "user";
+    description?: string | undefined;
+    config?: {
+        requireInput?: boolean | undefined;
+        presetMessage?: string | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    type: z.ZodOptional<z.ZodLiteral<"llm">>;
+    description: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    systemPrompt: z.ZodOptional<z.ZodString>;
+    systemPromptTemplate: z.ZodOptional<z.ZodObject<{
+        template: z.ZodString;
+        variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString, "many">, z.ZodRecord<z.ZodString, z.ZodString>]>>>;
+    }, "strict", z.ZodTypeAny, {
+        template: string;
+        variables?: Record<string, string | number | boolean | string[] | Record<string, string>> | undefined;
+    }, {
+        template: string;
+        variables?: Record<string, string | number | boolean | string[] | Record<string, string>> | undefined;
+    }>>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Skills whose full instructions must be loaded into this agent's system
+     * prompt. All discovered skills remain available through the skill tools.
+     */
+    skills: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Per-call provider options forwarded verbatim to the AI SDK. Used to
+     * enable provider-specific features such as Anthropic extended thinking
+     * or OpenAI reasoning effort. Shape:
+     * `{ <providerId>: { <option>: <value>, ... }, ... }`.
+     */
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    /**
+     * Model-level generation parameters (temperature, maxOutputTokens, topP, seed,
+     * etc.). Forwarded to `streamText` as top-level options. Provider-specific
+     * features should use `providerOptions` instead.
+     */
+    modelOptions: z.ZodOptional<z.ZodObject<{
+        temperature: z.ZodOptional<z.ZodNumber>;
+        topP: z.ZodOptional<z.ZodNumber>;
+        topK: z.ZodOptional<z.ZodNumber>;
+        maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+        maxRetries: z.ZodOptional<z.ZodNumber>;
+        frequencyPenalty: z.ZodOptional<z.ZodNumber>;
+        presencePenalty: z.ZodOptional<z.ZodNumber>;
+        seed: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        topK?: number | undefined;
+        maxOutputTokens?: number | undefined;
+        maxRetries?: number | undefined;
+        frequencyPenalty?: number | undefined;
+        presencePenalty?: number | undefined;
+        seed?: number | undefined;
+    }, {
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        topK?: number | undefined;
+        maxOutputTokens?: number | undefined;
+        maxRetries?: number | undefined;
+        frequencyPenalty?: number | undefined;
+        presencePenalty?: number | undefined;
+        seed?: number | undefined;
+    }>>;
+    /** JSON Schema describing the agent's structured output. */
+    outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** Conversation context retention and compaction controls. */
+    context: z.ZodOptional<z.ZodObject<{
+        rollingWindow: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodObject<{
+            maxRecords: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            maxRecords: number;
+        }, {
+            maxRecords: number;
+        }>]>>;
+        compaction: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
+            keepRecent: z.ZodOptional<z.ZodNumber>;
+            threshold: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            keepRecent?: number | undefined;
+            threshold?: number | undefined;
+        }, {
+            keepRecent?: number | undefined;
+            threshold?: number | undefined;
+        }>]>>;
+    }, "strict", z.ZodTypeAny, {
+        rollingWindow?: number | {
+            maxRecords: number;
+        } | undefined;
+        compaction?: boolean | {
+            keepRecent?: number | undefined;
+            threshold?: number | undefined;
+        } | undefined;
+    }, {
+        rollingWindow?: number | {
+            maxRecords: number;
+        } | undefined;
+        compaction?: boolean | {
+            keepRecent?: number | undefined;
+            threshold?: number | undefined;
+        } | undefined;
+    }>>;
+    /**
+     * Maximum number of LLM round-trips (steps) per call.
+     * Each tool-call + response counts as one step.
+     */
+    maxSteps: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    type?: "llm" | undefined;
+    description?: string | undefined;
+    model?: string | undefined;
+    systemPrompt?: string | undefined;
+    systemPromptTemplate?: {
+        template: string;
+        variables?: Record<string, string | number | boolean | string[] | Record<string, string>> | undefined;
+    } | undefined;
+    tools?: string[] | undefined;
+    providerOptions?: Record<string, Record<string, unknown>> | undefined;
+    modelOptions?: {
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        topK?: number | undefined;
+        maxOutputTokens?: number | undefined;
+        maxRetries?: number | undefined;
+        frequencyPenalty?: number | undefined;
+        presencePenalty?: number | undefined;
+        seed?: number | undefined;
+    } | undefined;
+    outputSchema?: Record<string, unknown> | undefined;
+    context?: {
+        rollingWindow?: number | {
+            maxRecords: number;
+        } | undefined;
+        compaction?: boolean | {
+            keepRecent?: number | undefined;
+            threshold?: number | undefined;
+        } | undefined;
+    } | undefined;
+    maxSteps?: number | undefined;
+    skills?: string[] | undefined;
+}, {
+    type?: "llm" | undefined;
+    description?: string | undefined;
+    model?: string | undefined;
+    systemPrompt?: string | undefined;
+    systemPromptTemplate?: {
+        template: string;
+        variables?: Record<string, string | number | boolean | string[] | Record<string, string>> | undefined;
+    } | undefined;
+    tools?: string[] | undefined;
+    providerOptions?: Record<string, Record<string, unknown>> | undefined;
+    modelOptions?: {
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        topK?: number | undefined;
+        maxOutputTokens?: number | undefined;
+        maxRetries?: number | undefined;
+        frequencyPenalty?: number | undefined;
+        presencePenalty?: number | undefined;
+        seed?: number | undefined;
+    } | undefined;
+    outputSchema?: Record<string, unknown> | undefined;
+    context?: {
+        rollingWindow?: number | {
+            maxRecords: number;
+        } | undefined;
+        compaction?: boolean | {
+            keepRecent?: number | undefined;
+            threshold?: number | undefined;
+        } | undefined;
+    } | undefined;
+    maxSteps?: number | undefined;
+    skills?: string[] | undefined;
+}>]>;
+/** A step that references a named agent from the registry. */
+export declare const AgentStepSchema: z.ZodObject<{
+    agent: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    agent: string;
+    description?: string | undefined;
+}, {
+    agent: string;
+    description?: string | undefined;
+}>;
+/**
+ * A flow step is either an agent reference or a nested flow definition.
+ * Uses z.lazy() to support recursive nesting.
+ */
+export declare const FlowStepSchema: z.ZodType;
+export declare const SequentialFlowDefSchema: z.ZodObject<{
+    type: z.ZodLiteral<"sequential">;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    steps: z.ZodArray<z.ZodType<any, z.ZodTypeDef, any>, "many">;
+}, "strict", z.ZodTypeAny, {
+    type: "sequential";
+    name: string;
+    steps: any[];
+    description?: string | undefined;
+}, {
+    type: "sequential";
+    name: string;
+    steps: any[];
+    description?: string | undefined;
+}>;
+export declare const CycleFlowDefSchema: z.ZodObject<{
+    type: z.ZodLiteral<"cycle">;
+    cycles: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<"Infinity">]>>;
+    observer: z.ZodOptional<z.ZodString>;
+    /**
+     * Custom break-signal tokens. The cycle ends when the observer's
+     * output contains one of these signals per `breakCycleSignalMatch`.
+     * Defaults to `["end cycle", "stop", "done"]` — fine for legacy
+     * strategies but brittle for verbose observers (e.g. "not done yet"
+     * triggers the "done" signal). Prefer a unique token like
+     * `"==CYCLE_DONE=="` paired with `breakCycleSignalMatch: "first-line"`.
+     */
+    breakCycleSignals: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * How to match `breakCycleSignals` against the observer's output.
+     * One of `"substring"` (legacy default, prone to false positives),
+     * `"first-line"` (recommended — observer's verdict is line 1),
+     * `"any-line"`, or `"exact"`. See {@link CycleFlowConfig.breakCycleSignalMatch}
+     * for full semantics.
+     */
+    breakCycleSignalMatch: z.ZodOptional<z.ZodEnum<["substring", "first-line", "any-line", "exact"]>>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    steps: z.ZodArray<z.ZodType<any, z.ZodTypeDef, any>, "many">;
+}, "strict", z.ZodTypeAny, {
+    type: "cycle";
+    name: string;
+    steps: any[];
+    description?: string | undefined;
+    cycles?: number | "Infinity" | undefined;
+    observer?: string | undefined;
+    breakCycleSignals?: string[] | undefined;
+    breakCycleSignalMatch?: "exact" | "substring" | "first-line" | "any-line" | undefined;
+}, {
+    type: "cycle";
+    name: string;
+    steps: any[];
+    description?: string | undefined;
+    cycles?: number | "Infinity" | undefined;
+    observer?: string | undefined;
+    breakCycleSignals?: string[] | undefined;
+    breakCycleSignalMatch?: "exact" | "substring" | "first-line" | "any-line" | undefined;
+}>;
+export declare const BroadcastFlowDefSchema: z.ZodObject<{
+    type: z.ZodLiteral<"broadcast">;
+    separator: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    steps: z.ZodArray<z.ZodType<any, z.ZodTypeDef, any>, "many">;
+}, "strict", z.ZodTypeAny, {
+    type: "broadcast";
+    name: string;
+    steps: any[];
+    description?: string | undefined;
+    separator?: string | undefined;
+}, {
+    type: "broadcast";
+    name: string;
+    steps: any[];
+    description?: string | undefined;
+    separator?: string | undefined;
+}>;
+/** A flow definition — discriminated union by `type`. */
+export declare const FlowDefSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"sequential">;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    steps: z.ZodArray<z.ZodType<any, z.ZodTypeDef, any>, "many">;
+}, "strict", z.ZodTypeAny, {
+    type: "sequential";
+    name: string;
+    steps: any[];
+    description?: string | undefined;
+}, {
+    type: "sequential";
+    name: string;
+    steps: any[];
+    description?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"cycle">;
+    cycles: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<"Infinity">]>>;
+    observer: z.ZodOptional<z.ZodString>;
+    /**
+     * Custom break-signal tokens. The cycle ends when the observer's
+     * output contains one of these signals per `breakCycleSignalMatch`.
+     * Defaults to `["end cycle", "stop", "done"]` — fine for legacy
+     * strategies but brittle for verbose observers (e.g. "not done yet"
+     * triggers the "done" signal). Prefer a unique token like
+     * `"==CYCLE_DONE=="` paired with `breakCycleSignalMatch: "first-line"`.
+     */
+    breakCycleSignals: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * How to match `breakCycleSignals` against the observer's output.
+     * One of `"substring"` (legacy default, prone to false positives),
+     * `"first-line"` (recommended — observer's verdict is line 1),
+     * `"any-line"`, or `"exact"`. See {@link CycleFlowConfig.breakCycleSignalMatch}
+     * for full semantics.
+     */
+    breakCycleSignalMatch: z.ZodOptional<z.ZodEnum<["substring", "first-line", "any-line", "exact"]>>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    steps: z.ZodArray<z.ZodType<any, z.ZodTypeDef, any>, "many">;
+}, "strict", z.ZodTypeAny, {
+    type: "cycle";
+    name: string;
+    steps: any[];
+    description?: string | undefined;
+    cycles?: number | "Infinity" | undefined;
+    observer?: string | undefined;
+    breakCycleSignals?: string[] | undefined;
+    breakCycleSignalMatch?: "exact" | "substring" | "first-line" | "any-line" | undefined;
+}, {
+    type: "cycle";
+    name: string;
+    steps: any[];
+    description?: string | undefined;
+    cycles?: number | "Infinity" | undefined;
+    observer?: string | undefined;
+    breakCycleSignals?: string[] | undefined;
+    breakCycleSignalMatch?: "exact" | "substring" | "first-line" | "any-line" | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"broadcast">;
+    separator: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    steps: z.ZodArray<z.ZodType<any, z.ZodTypeDef, any>, "many">;
+}, "strict", z.ZodTypeAny, {
+    type: "broadcast";
+    name: string;
+    steps: any[];
+    description?: string | undefined;
+    separator?: string | undefined;
+}, {
+    type: "broadcast";
+    name: string;
+    steps: any[];
+    description?: string | undefined;
+    separator?: string | undefined;
+}>]>;
+export declare const StrategySchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    agents: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"user">;
+        description: z.ZodOptional<z.ZodString>;
+        config: z.ZodOptional<z.ZodObject<{
+            requireInput: z.ZodOptional<z.ZodBoolean>;
+            presetMessage: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            requireInput?: boolean | undefined;
+            presetMessage?: string | undefined;
+        }, {
+            requireInput?: boolean | undefined;
+            presetMessage?: string | undefined;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        type: "user";
+        description?: string | undefined;
+        config?: {
+            requireInput?: boolean | undefined;
+            presetMessage?: string | undefined;
+        } | undefined;
+    }, {
+        type: "user";
+        description?: string | undefined;
+        config?: {
+            requireInput?: boolean | undefined;
+            presetMessage?: string | undefined;
+        } | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodOptional<z.ZodLiteral<"llm">>;
+        description: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        systemPrompt: z.ZodOptional<z.ZodString>;
+        systemPromptTemplate: z.ZodOptional<z.ZodObject<{
+            template: z.ZodString;
+            variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString, "many">, z.ZodRecord<z.ZodString, z.ZodString>]>>>;
+        }, "strict", z.ZodTypeAny, {
+            template: string;
+            variables?: Record<string, string | number | boolean | string[] | Record<string, string>> | undefined;
+        }, {
+            template: string;
+            variables?: Record<string, string | number | boolean | string[] | Record<string, string>> | undefined;
+        }>>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * Skills whose full instructions must be loaded into this agent's system
+         * prompt. All discovered skills remain available through the skill tools.
+         */
+        skills: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * Per-call provider options forwarded verbatim to the AI SDK. Used to
+         * enable provider-specific features such as Anthropic extended thinking
+         * or OpenAI reasoning effort. Shape:
+         * `{ <providerId>: { <option>: <value>, ... }, ... }`.
+         */
+        providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        /**
+         * Model-level generation parameters (temperature, maxOutputTokens, topP, seed,
+         * etc.). Forwarded to `streamText` as top-level options. Provider-specific
+         * features should use `providerOptions` instead.
+         */
+        modelOptions: z.ZodOptional<z.ZodObject<{
+            temperature: z.ZodOptional<z.ZodNumber>;
+            topP: z.ZodOptional<z.ZodNumber>;
+            topK: z.ZodOptional<z.ZodNumber>;
+            maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+            maxRetries: z.ZodOptional<z.ZodNumber>;
+            frequencyPenalty: z.ZodOptional<z.ZodNumber>;
+            presencePenalty: z.ZodOptional<z.ZodNumber>;
+            seed: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            temperature?: number | undefined;
+            topP?: number | undefined;
+            topK?: number | undefined;
+            maxOutputTokens?: number | undefined;
+            maxRetries?: number | undefined;
+            frequencyPenalty?: number | undefined;
+            presencePenalty?: number | undefined;
+            seed?: number | undefined;
+        }, {
+            temperature?: number | undefined;
+            topP?: number | undefined;
+            topK?: number | undefined;
+            maxOutputTokens?: number | undefined;
+            maxRetries?: number | undefined;
+            frequencyPenalty?: number | undefined;
+            presencePenalty?: number | undefined;
+            seed?: number | undefined;
+        }>>;
+        /** JSON Schema describing the agent's structured output. */
+        outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        /** Conversation context retention and compaction controls. */
+        context: z.ZodOptional<z.ZodObject<{
+            rollingWindow: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodObject<{
+                maxRecords: z.ZodNumber;
+            }, "strict", z.ZodTypeAny, {
+                maxRecords: number;
+            }, {
+                maxRecords: number;
+            }>]>>;
+            compaction: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
+                keepRecent: z.ZodOptional<z.ZodNumber>;
+                threshold: z.ZodOptional<z.ZodNumber>;
+            }, "strict", z.ZodTypeAny, {
+                keepRecent?: number | undefined;
+                threshold?: number | undefined;
+            }, {
+                keepRecent?: number | undefined;
+                threshold?: number | undefined;
+            }>]>>;
+        }, "strict", z.ZodTypeAny, {
+            rollingWindow?: number | {
+                maxRecords: number;
+            } | undefined;
+            compaction?: boolean | {
+                keepRecent?: number | undefined;
+                threshold?: number | undefined;
+            } | undefined;
+        }, {
+            rollingWindow?: number | {
+                maxRecords: number;
+            } | undefined;
+            compaction?: boolean | {
+                keepRecent?: number | undefined;
+                threshold?: number | undefined;
+            } | undefined;
+        }>>;
+        /**
+         * Maximum number of LLM round-trips (steps) per call.
+         * Each tool-call + response counts as one step.
+         */
+        maxSteps: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        type?: "llm" | undefined;
+        description?: string | undefined;
+        model?: string | undefined;
+        systemPrompt?: string | undefined;
+        systemPromptTemplate?: {
+            template: string;
+            variables?: Record<string, string | number | boolean | string[] | Record<string, string>> | undefined;
+        } | undefined;
+        tools?: string[] | undefined;
+        providerOptions?: Record<string, Record<string, unknown>> | undefined;
+        modelOptions?: {
+            temperature?: number | undefined;
+            topP?: number | undefined;
+            topK?: number | undefined;
+            maxOutputTokens?: number | undefined;
+            maxRetries?: number | undefined;
+            frequencyPenalty?: number | undefined;
+            presencePenalty?: number | undefined;
+            seed?: number | undefined;
+        } | undefined;
+        outputSchema?: Record<string, unknown> | undefined;
+        context?: {
+            rollingWindow?: number | {
+                maxRecords: number;
+            } | undefined;
+            compaction?: boolean | {
+                keepRecent?: number | undefined;
+                threshold?: number | undefined;
+            } | undefined;
+        } | undefined;
+        maxSteps?: number | undefined;
+        skills?: string[] | undefined;
+    }, {
+        type?: "llm" | undefined;
+        description?: string | undefined;
+        model?: string | undefined;
+        systemPrompt?: string | undefined;
+        systemPromptTemplate?: {
+            template: string;
+            variables?: Record<string, string | number | boolean | string[] | Record<string, string>> | undefined;
+        } | undefined;
+        tools?: string[] | undefined;
+        providerOptions?: Record<string, Record<string, unknown>> | undefined;
+        modelOptions?: {
+            temperature?: number | undefined;
+            topP?: number | undefined;
+            topK?: number | undefined;
+            maxOutputTokens?: number | undefined;
+            maxRetries?: number | undefined;
+            frequencyPenalty?: number | undefined;
+            presencePenalty?: number | undefined;
+            seed?: number | undefined;
+        } | undefined;
+        outputSchema?: Record<string, unknown> | undefined;
+        context?: {
+            rollingWindow?: number | {
+                maxRecords: number;
+            } | undefined;
+            compaction?: boolean | {
+                keepRecent?: number | undefined;
+                threshold?: number | undefined;
+            } | undefined;
+        } | undefined;
+        maxSteps?: number | undefined;
+        skills?: string[] | undefined;
+    }>]>>;
+    flow: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"sequential">;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        steps: z.ZodArray<z.ZodType<any, z.ZodTypeDef, any>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        type: "sequential";
+        name: string;
+        steps: any[];
+        description?: string | undefined;
+    }, {
+        type: "sequential";
+        name: string;
+        steps: any[];
+        description?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"cycle">;
+        cycles: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<"Infinity">]>>;
+        observer: z.ZodOptional<z.ZodString>;
+        /**
+         * Custom break-signal tokens. The cycle ends when the observer's
+         * output contains one of these signals per `breakCycleSignalMatch`.
+         * Defaults to `["end cycle", "stop", "done"]` — fine for legacy
+         * strategies but brittle for verbose observers (e.g. "not done yet"
+         * triggers the "done" signal). Prefer a unique token like
+         * `"==CYCLE_DONE=="` paired with `breakCycleSignalMatch: "first-line"`.
+         */
+        breakCycleSignals: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * How to match `breakCycleSignals` against the observer's output.
+         * One of `"substring"` (legacy default, prone to false positives),
+         * `"first-line"` (recommended — observer's verdict is line 1),
+         * `"any-line"`, or `"exact"`. See {@link CycleFlowConfig.breakCycleSignalMatch}
+         * for full semantics.
+         */
+        breakCycleSignalMatch: z.ZodOptional<z.ZodEnum<["substring", "first-line", "any-line", "exact"]>>;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        steps: z.ZodArray<z.ZodType<any, z.ZodTypeDef, any>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        type: "cycle";
+        name: string;
+        steps: any[];
+        description?: string | undefined;
+        cycles?: number | "Infinity" | undefined;
+        observer?: string | undefined;
+        breakCycleSignals?: string[] | undefined;
+        breakCycleSignalMatch?: "exact" | "substring" | "first-line" | "any-line" | undefined;
+    }, {
+        type: "cycle";
+        name: string;
+        steps: any[];
+        description?: string | undefined;
+        cycles?: number | "Infinity" | undefined;
+        observer?: string | undefined;
+        breakCycleSignals?: string[] | undefined;
+        breakCycleSignalMatch?: "exact" | "substring" | "first-line" | "any-line" | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"broadcast">;
+        separator: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        steps: z.ZodArray<z.ZodType<any, z.ZodTypeDef, any>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        type: "broadcast";
+        name: string;
+        steps: any[];
+        description?: string | undefined;
+        separator?: string | undefined;
+    }, {
+        type: "broadcast";
+        name: string;
+        steps: any[];
+        description?: string | undefined;
+        separator?: string | undefined;
+    }>]>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    version: string;
+    agents: Record<string, {
+        type: "user";
+        description?: string | undefined;
+        config?: {
+            requireInput?: boolean | undefined;
+            presetMessage?: string | undefined;
+        } | undefined;
+    } | {
+        type?: "llm" | undefined;
+        description?: string | undefined;
+        model?: string | undefined;
+        systemPrompt?: string | undefined;
+        systemPromptTemplate?: {
+            template: string;
+            variables?: Record<string, string | number | boolean | string[] | Record<string, string>> | undefined;
+        } | undefined;
+        tools?: string[] | undefined;
+        providerOptions?: Record<string, Record<string, unknown>> | undefined;
+        modelOptions?: {
+            temperature?: number | undefined;
+            topP?: number | undefined;
+            topK?: number | undefined;
+            maxOutputTokens?: number | undefined;
+            maxRetries?: number | undefined;
+            frequencyPenalty?: number | undefined;
+            presencePenalty?: number | undefined;
+            seed?: number | undefined;
+        } | undefined;
+        outputSchema?: Record<string, unknown> | undefined;
+        context?: {
+            rollingWindow?: number | {
+                maxRecords: number;
+            } | undefined;
+            compaction?: boolean | {
+                keepRecent?: number | undefined;
+                threshold?: number | undefined;
+            } | undefined;
+        } | undefined;
+        maxSteps?: number | undefined;
+        skills?: string[] | undefined;
+    }>;
+    flow: {
+        type: "sequential";
+        name: string;
+        steps: any[];
+        description?: string | undefined;
+    } | {
+        type: "cycle";
+        name: string;
+        steps: any[];
+        description?: string | undefined;
+        cycles?: number | "Infinity" | undefined;
+        observer?: string | undefined;
+        breakCycleSignals?: string[] | undefined;
+        breakCycleSignalMatch?: "exact" | "substring" | "first-line" | "any-line" | undefined;
+    } | {
+        type: "broadcast";
+        name: string;
+        steps: any[];
+        description?: string | undefined;
+        separator?: string | undefined;
+    };
+    description?: string | undefined;
+}, {
+    name: string;
+    version: string;
+    agents: Record<string, {
+        type: "user";
+        description?: string | undefined;
+        config?: {
+            requireInput?: boolean | undefined;
+            presetMessage?: string | undefined;
+        } | undefined;
+    } | {
+        type?: "llm" | undefined;
+        description?: string | undefined;
+        model?: string | undefined;
+        systemPrompt?: string | undefined;
+        systemPromptTemplate?: {
+            template: string;
+            variables?: Record<string, string | number | boolean | string[] | Record<string, string>> | undefined;
+        } | undefined;
+        tools?: string[] | undefined;
+        providerOptions?: Record<string, Record<string, unknown>> | undefined;
+        modelOptions?: {
+            temperature?: number | undefined;
+            topP?: number | undefined;
+            topK?: number | undefined;
+            maxOutputTokens?: number | undefined;
+            maxRetries?: number | undefined;
+            frequencyPenalty?: number | undefined;
+            presencePenalty?: number | undefined;
+            seed?: number | undefined;
+        } | undefined;
+        outputSchema?: Record<string, unknown> | undefined;
+        context?: {
+            rollingWindow?: number | {
+                maxRecords: number;
+            } | undefined;
+            compaction?: boolean | {
+                keepRecent?: number | undefined;
+                threshold?: number | undefined;
+            } | undefined;
+        } | undefined;
+        maxSteps?: number | undefined;
+        skills?: string[] | undefined;
+    }>;
+    flow: {
+        type: "sequential";
+        name: string;
+        steps: any[];
+        description?: string | undefined;
+    } | {
+        type: "cycle";
+        name: string;
+        steps: any[];
+        description?: string | undefined;
+        cycles?: number | "Infinity" | undefined;
+        observer?: string | undefined;
+        breakCycleSignals?: string[] | undefined;
+        breakCycleSignalMatch?: "exact" | "substring" | "first-line" | "any-line" | undefined;
+    } | {
+        type: "broadcast";
+        name: string;
+        steps: any[];
+        description?: string | undefined;
+        separator?: string | undefined;
+    };
+    description?: string | undefined;
+}>;
+export declare const CommaProjectManifestSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    strategies: z.ZodArray<z.ZodString, "many">;
+    tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    entry: z.ZodOptional<z.ZodString>;
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    strategies: string[];
+    description?: string | undefined;
+    tools?: string[] | undefined;
+    version?: string | undefined;
+    entry?: string | undefined;
+    dependencies?: string[] | undefined;
+}, {
+    name: string;
+    strategies: string[];
+    description?: string | undefined;
+    tools?: string[] | undefined;
+    version?: string | undefined;
+    entry?: string | undefined;
+    dependencies?: string[] | undefined;
+}>;
+export type UserAgentDef = z.infer<typeof UserAgentDefSchema>;
+export type LLMAgentDef = z.infer<typeof LLMAgentDefSchema>;
+export type AgentDef = z.infer<typeof AgentDefSchema>;
+export type AgentStep = z.infer<typeof AgentStepSchema>;
+export type SequentialFlowDef = z.infer<typeof SequentialFlowDefSchema>;
+export type CycleFlowDef = z.infer<typeof CycleFlowDefSchema>;
+export type BroadcastFlowDef = z.infer<typeof BroadcastFlowDefSchema>;
+export type FlowDef = z.infer<typeof FlowDefSchema>;
+export type Strategy = z.infer<typeof StrategySchema>;
+export type CommaProjectManifest = z.infer<typeof CommaProjectManifestSchema>;
+/** Check if an agent definition is a user agent. */
+export declare function isUserAgentDef(agentDefinition: AgentDef): agentDefinition is UserAgentDef;
+/** Check if an agent definition is an LLM agent. */
+export declare function isLLMAgentDef(agentDefinition: AgentDef): agentDefinition is LLMAgentDef;
+/** Check if a flow step is an agent reference (vs a nested flow). */
+export declare function isAgentStep(step: unknown): step is AgentStep;
+/** Check if a flow step is a nested flow definition. */
+export declare function isFlowDef(step: unknown): step is FlowDef;