@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-subagents/src/extension/schemas.d.ts

@@ -0,0 +1,225 @@
+/**
+ * TypeBox schemas for subagent tool parameters
+ */
+import { Type } from "typebox";
+export declare const ParallelTaskSchema: Type.TObject<{
+    agent: Type.TString;
+    task: Type.TOptional<Type.TString>;
+    phase: Type.TOptional<Type.TString>;
+    label: Type.TOptional<Type.TString>;
+    as: Type.TOptional<Type.TString>;
+    outputSchema: Type.TOptional<Type.TUnsafe<unknown>>;
+    cwd: Type.TOptional<Type.TString>;
+    count: Type.TOptional<Type.TInteger>;
+    output: Type.TOptional<Type.TUnsafe<unknown>>;
+    outputMode: Type.TOptional<Type.TString>;
+    reads: Type.TOptional<Type.TUnsafe<unknown>>;
+    progress: Type.TOptional<Type.TBoolean>;
+    skill: Type.TOptional<Type.TUnsafe<unknown>>;
+    model: Type.TOptional<Type.TString>;
+    tier: Type.TOptional<Type.TString>;
+    toolBudget: Type.TOptional<Type.TObject<{
+        soft: Type.TOptional<Type.TInteger>;
+        hard: Type.TInteger;
+        block: Type.TOptional<Type.TUnsafe<unknown>>;
+    }>>;
+    acceptance: Type.TOptional<Type.TUnsafe<unknown>>;
+}>;
+export declare const DynamicExpandSchema: Type.TObject<{
+    from: Type.TObject<{
+        output: Type.TString;
+        path: Type.TString;
+    }>;
+    item: Type.TOptional<Type.TString>;
+    key: Type.TOptional<Type.TString>;
+    maxItems: Type.TOptional<Type.TInteger>;
+    onEmpty: Type.TOptional<Type.TString>;
+}>;
+export declare const DynamicParallelTemplateSchema: Type.TObject<{
+    agent: Type.TString;
+    task: Type.TOptional<Type.TString>;
+    phase: Type.TOptional<Type.TString>;
+    label: Type.TOptional<Type.TString>;
+    outputSchema: Type.TOptional<Type.TUnsafe<unknown>>;
+    cwd: Type.TOptional<Type.TString>;
+    output: Type.TOptional<Type.TUnsafe<unknown>>;
+    outputMode: Type.TOptional<Type.TString>;
+    reads: Type.TOptional<Type.TUnsafe<unknown>>;
+    progress: Type.TOptional<Type.TBoolean>;
+    skill: Type.TOptional<Type.TUnsafe<unknown>>;
+    model: Type.TOptional<Type.TString>;
+    tier: Type.TOptional<Type.TString>;
+    toolBudget: Type.TOptional<Type.TObject<{
+        soft: Type.TOptional<Type.TInteger>;
+        hard: Type.TInteger;
+        block: Type.TOptional<Type.TUnsafe<unknown>>;
+    }>>;
+    acceptance: Type.TOptional<Type.TUnsafe<unknown>>;
+}>;
+export declare const DynamicCollectSchema: Type.TObject<{
+    as: Type.TString;
+    outputSchema: Type.TOptional<Type.TUnsafe<unknown>>;
+}>;
+export declare const ChainItem: Type.TObject<{
+    agent: Type.TOptional<Type.TString>;
+    task: Type.TOptional<Type.TString>;
+    phase: Type.TOptional<Type.TString>;
+    label: Type.TOptional<Type.TString>;
+    as: Type.TOptional<Type.TString>;
+    outputSchema: Type.TOptional<Type.TUnsafe<unknown>>;
+    cwd: Type.TOptional<Type.TString>;
+    output: Type.TOptional<Type.TUnsafe<unknown>>;
+    outputMode: Type.TOptional<Type.TString>;
+    reads: Type.TOptional<Type.TUnsafe<unknown>>;
+    progress: Type.TOptional<Type.TBoolean>;
+    skill: Type.TOptional<Type.TUnsafe<unknown>>;
+    model: Type.TOptional<Type.TString>;
+    tier: Type.TOptional<Type.TString>;
+    toolBudget: Type.TOptional<Type.TObject<{
+        soft: Type.TOptional<Type.TInteger>;
+        hard: Type.TInteger;
+        block: Type.TOptional<Type.TUnsafe<unknown>>;
+    }>>;
+    acceptance: Type.TOptional<Type.TUnsafe<unknown>>;
+    parallel: Type.TOptional<Type.TUnsafe<unknown>>;
+    expand: Type.TOptional<Type.TObject<{
+        from: Type.TObject<{
+            output: Type.TString;
+            path: Type.TString;
+        }>;
+        item: Type.TOptional<Type.TString>;
+        key: Type.TOptional<Type.TString>;
+        maxItems: Type.TOptional<Type.TInteger>;
+        onEmpty: Type.TOptional<Type.TString>;
+    }>>;
+    collect: Type.TOptional<Type.TObject<{
+        as: Type.TString;
+        outputSchema: Type.TOptional<Type.TUnsafe<unknown>>;
+    }>>;
+    concurrency: Type.TOptional<Type.TNumber>;
+    failFast: Type.TOptional<Type.TBoolean>;
+    worktree: Type.TOptional<Type.TBoolean>;
+}>;
+export declare const SubagentParams: Type.TObject<{
+    agent: Type.TOptional<Type.TString>;
+    task: Type.TOptional<Type.TString>;
+    action: Type.TOptional<Type.TString>;
+    id: Type.TOptional<Type.TString>;
+    runId: Type.TOptional<Type.TString>;
+    dir: Type.TOptional<Type.TString>;
+    index: Type.TOptional<Type.TInteger>;
+    view: Type.TOptional<Type.TString>;
+    lines: Type.TOptional<Type.TInteger>;
+    message: Type.TOptional<Type.TString>;
+    scope: Type.TOptional<Type.TString>;
+    target: Type.TOptional<Type.TString>;
+    thinking: Type.TOptional<Type.TUnsafe<unknown>>;
+    schedule: Type.TOptional<Type.TString>;
+    scheduleName: Type.TOptional<Type.TString>;
+    chainName: Type.TOptional<Type.TString>;
+    config: Type.TOptional<Type.TUnsafe<unknown>>;
+    tasks: Type.TOptional<Type.TArray<Type.TObject<{
+        agent: Type.TString;
+        task: Type.TString;
+        cwd: Type.TOptional<Type.TString>;
+        count: Type.TOptional<Type.TInteger>;
+        output: Type.TOptional<Type.TUnsafe<unknown>>;
+        outputMode: Type.TOptional<Type.TString>;
+        reads: Type.TOptional<Type.TUnsafe<unknown>>;
+        progress: Type.TOptional<Type.TBoolean>;
+        model: Type.TOptional<Type.TString>;
+        tier: Type.TOptional<Type.TString>;
+        skill: Type.TOptional<Type.TUnsafe<unknown>>;
+        toolBudget: Type.TOptional<Type.TObject<{
+            soft: Type.TOptional<Type.TInteger>;
+            hard: Type.TInteger;
+            block: Type.TOptional<Type.TUnsafe<unknown>>;
+        }>>;
+        acceptance: Type.TOptional<Type.TUnsafe<unknown>>;
+    }>>>;
+    concurrency: Type.TOptional<Type.TInteger>;
+    worktree: Type.TOptional<Type.TBoolean>;
+    chain: Type.TOptional<Type.TArray<Type.TObject<{
+        agent: Type.TOptional<Type.TString>;
+        task: Type.TOptional<Type.TString>;
+        phase: Type.TOptional<Type.TString>;
+        label: Type.TOptional<Type.TString>;
+        as: Type.TOptional<Type.TString>;
+        outputSchema: Type.TOptional<Type.TUnsafe<unknown>>;
+        cwd: Type.TOptional<Type.TString>;
+        output: Type.TOptional<Type.TUnsafe<unknown>>;
+        outputMode: Type.TOptional<Type.TString>;
+        reads: Type.TOptional<Type.TUnsafe<unknown>>;
+        progress: Type.TOptional<Type.TBoolean>;
+        skill: Type.TOptional<Type.TUnsafe<unknown>>;
+        model: Type.TOptional<Type.TString>;
+        tier: Type.TOptional<Type.TString>;
+        toolBudget: Type.TOptional<Type.TObject<{
+            soft: Type.TOptional<Type.TInteger>;
+            hard: Type.TInteger;
+            block: Type.TOptional<Type.TUnsafe<unknown>>;
+        }>>;
+        acceptance: Type.TOptional<Type.TUnsafe<unknown>>;
+        parallel: Type.TOptional<Type.TUnsafe<unknown>>;
+        expand: Type.TOptional<Type.TObject<{
+            from: Type.TObject<{
+                output: Type.TString;
+                path: Type.TString;
+            }>;
+            item: Type.TOptional<Type.TString>;
+            key: Type.TOptional<Type.TString>;
+            maxItems: Type.TOptional<Type.TInteger>;
+            onEmpty: Type.TOptional<Type.TString>;
+        }>>;
+        collect: Type.TOptional<Type.TObject<{
+            as: Type.TString;
+            outputSchema: Type.TOptional<Type.TUnsafe<unknown>>;
+        }>>;
+        concurrency: Type.TOptional<Type.TNumber>;
+        failFast: Type.TOptional<Type.TBoolean>;
+        worktree: Type.TOptional<Type.TBoolean>;
+    }>>>;
+    context: Type.TOptional<Type.TString>;
+    chainDir: Type.TOptional<Type.TString>;
+    async: Type.TOptional<Type.TBoolean>;
+    timeoutMs: Type.TOptional<Type.TInteger>;
+    maxRuntimeMs: Type.TOptional<Type.TInteger>;
+    turnBudget: Type.TOptional<Type.TObject<{
+        maxTurns: Type.TInteger;
+        graceTurns: Type.TOptional<Type.TInteger>;
+    }>>;
+    toolBudget: Type.TOptional<Type.TObject<{
+        soft: Type.TOptional<Type.TInteger>;
+        hard: Type.TInteger;
+        block: Type.TOptional<Type.TUnsafe<unknown>>;
+    }>>;
+    agentScope: Type.TOptional<Type.TString>;
+    cwd: Type.TOptional<Type.TString>;
+    artifacts: Type.TOptional<Type.TBoolean>;
+    includeProgress: Type.TOptional<Type.TBoolean>;
+    share: Type.TOptional<Type.TBoolean>;
+    sessionDir: Type.TOptional<Type.TString>;
+    clarify: Type.TOptional<Type.TBoolean>;
+    control: Type.TOptional<Type.TObject<{
+        enabled: Type.TOptional<Type.TBoolean>;
+        needsAttentionAfterMs: Type.TOptional<Type.TInteger>;
+        activeNoticeAfterMs: Type.TOptional<Type.TInteger>;
+        activeNoticeAfterTurns: Type.TOptional<Type.TInteger>;
+        activeNoticeAfterTokens: Type.TOptional<Type.TInteger>;
+        failedToolAttemptsBeforeAttention: Type.TOptional<Type.TInteger>;
+        notifyOn: Type.TOptional<Type.TArray<Type.TString>>;
+        notifyChannels: Type.TOptional<Type.TArray<Type.TString>>;
+    }>>;
+    output: Type.TOptional<Type.TUnsafe<unknown>>;
+    outputMode: Type.TOptional<Type.TString>;
+    skill: Type.TOptional<Type.TUnsafe<unknown>>;
+    model: Type.TOptional<Type.TString>;
+    tier: Type.TOptional<Type.TString>;
+    acceptance: Type.TOptional<Type.TUnsafe<unknown>>;
+}>;
+export declare const SubagentWaitParams: Type.TObject<{
+    id: Type.TOptional<Type.TString>;
+    all: Type.TOptional<Type.TBoolean>;
+    timeoutMs: Type.TOptional<Type.TInteger>;
+}>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/extension/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/extension/schemas.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAkH/B,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;EAkB7B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;EASG,CAAC;AAEpC,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;EAgBP,CAAC;AAEpC,eAAO,MAAM,oBAAoB;;;EAGE,CAAC;AAGpC,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoCpB,CAAC;AAmGH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA0D,CAAC;AAetF,eAAO,MAAM,kBAAkB;;;;EAA8D,CAAC","sourcesContent":["// @ts-nocheck\n/**\n * TypeBox schemas for subagent tool parameters\n */\n\nimport { Type } from \"typebox\";\n\nfunction keepTopLevelParameterDescriptions<T>(schema: T): T {\n\treturn pruneNestedDescriptions(schema, []) as T;\n}\n\nfunction pruneNestedDescriptions(value: unknown, path: string[]): unknown {\n\tif (!value || typeof value !== \"object\") return value;\n\n\tconst result = Array.isArray(value) ? [] : Object.create(Object.getPrototypeOf(value));\n\tfor (const key of Reflect.ownKeys(value)) {\n\t\tconst descriptor = Object.getOwnPropertyDescriptor(value, key);\n\t\tif (!descriptor) continue;\n\t\tif (key === \"description\" && !isTopLevelParameterDescription(path)) continue;\n\t\tif (\"value\" in descriptor) {\n\t\t\tconst nextPath = typeof key === \"string\" ? [...path, key] : path;\n\t\t\tdescriptor.value = pruneNestedDescriptions(descriptor.value, nextPath);\n\t\t}\n\t\tObject.defineProperty(result, key, descriptor);\n\t}\n\treturn result;\n}\n\nfunction isTopLevelParameterDescription(path: string[]): boolean {\n\treturn path.length === 2 && path[0] === \"properties\";\n}\n\nconst SkillOverride = Type.Unsafe({\n\tanyOf: [\n\t\t{ type: \"array\", items: { type: \"string\" } },\n\t\t{ type: \"boolean\" },\n\t\t{ type: \"string\" },\n\t],\n\tdescription: \"Skill name(s) to make available (comma-separated), array of strings, or boolean (false disables, true uses default)\",\n});\n\nconst OutputOverride = Type.Unsafe({\n\tanyOf: [\n\t\t{ type: \"string\" },\n\t\t{ type: \"boolean\" },\n\t],\n\tdescription: \"Output filename/path (string), or false to disable file output\",\n});\n\nconst OutputModeOverride = Type.String({\n\tenum: [\"inline\", \"file-only\"],\n\tdescription: \"Return saved output inline (default) or only a concise file reference. file-only requires output to be a path.\",\n});\n\n// lunr: model tier override for 3-tier subagent routing; resolved through the\n// @lunr/model-tiers bridge and ignored when tier mode is disabled.\nconst TierOverride = Type.String({\n\tenum: [\"light\", \"standard\", \"heavy\"],\n\tdescription: \"Model tier ('light' cheap/fast, 'standard' typical, 'heavy' complex reasoning) when model tiers are enabled. An explicit model overrides the tier; omit both to inherit the parent model.\",\n});\n\nconst ReadsOverride = Type.Unsafe({\n\tanyOf: [\n\t\t{ type: \"array\", items: { type: \"string\" } },\n\t\t{ type: \"boolean\" },\n\t],\n\tdescription: \"Files to read before running (array of filenames), or false to disable\",\n});\n\nconst JsonSchemaObject = Type.Unsafe({\n\ttype: \"object\",\n\tadditionalProperties: true,\n\tdescription: \"JSON Schema object for strict structured output. Non-object roots are rejected.\",\n});\n\nconst AcceptanceOverride = Type.Unsafe({\n\tanyOf: [\n\t\t{ type: \"string\", enum: [\"auto\", \"attested\", \"checked\", \"verified\", \"reviewed\"] },\n\t\t{ type: \"boolean\", enum: [false] },\n\t\t{ type: \"object\", additionalProperties: true },\n\t],\n\tdescription: \"Optional acceptance policy. Omitted means auto-inferred; verified requires configured runtime commands. Reviewed is inferred-only because explicit runs cannot supply an independent reviewer result. Bare \\\"none\\\" requires { level: \\\"none\\\", reason: \\\"...\\\" }, while false is deprecated.\",\n});\n\nconst TurnBudgetOverride = Type.Object({\n\tmaxTurns: Type.Integer({ minimum: 1 }),\n\tgraceTurns: Type.Optional(Type.Integer({ minimum: 0 })),\n}, { additionalProperties: false, description: \"Optional assistant-turn budget. At maxTurns the child is asked to wrap up; after graceTurns additional assistant turns it is aborted and partial output is returned.\" });\n\nconst ToolBudgetBlock = Type.Unsafe({\n\tanyOf: [\n\t\t{ type: \"array\", minItems: 1, items: { type: \"string\", minLength: 1 } },\n\t\t{ type: \"string\", enum: [\"*\"] },\n\t],\n});\n\nconst ToolBudgetOverride = Type.Object({\n\tsoft: Type.Optional(Type.Integer({ minimum: 1 })),\n\thard: Type.Integer({ minimum: 1 }),\n\tblock: Type.Optional(ToolBudgetBlock),\n}, { additionalProperties: false, description: \"Optional child tool-call budget. soft nudges the child; after hard, block tools (default read/grep/find/ls, or '*' for all tools) are blocked so the child can finalize.\" });\n\nconst TaskItem = Type.Object({\n\tagent: Type.String(), \n\ttask: Type.String(), \n\tcwd: Type.Optional(Type.String()),\n\tcount: Type.Optional(Type.Integer({ minimum: 1, description: \"Repeat this parallel task N times with the same settings.\" })),\n\toutput: Type.Optional(OutputOverride),\n\toutputMode: Type.Optional(OutputModeOverride),\n\treads: Type.Optional(ReadsOverride),\n\tprogress: Type.Optional(Type.Boolean({ description: \"Enable progress.md tracking for this task\" })),\n\tmodel: Type.Optional(Type.String({ description: \"Override model for this task (e.g. 'google/gemini-3-pro')\" })),\n\ttier: Type.Optional(TierOverride), // lunr: model tiers\n\tskill: Type.Optional(SkillOverride),\n\ttoolBudget: Type.Optional(ToolBudgetOverride),\n\tacceptance: Type.Optional(AcceptanceOverride),\n});\n\n// Parallel task item (within a parallel step)\nexport const ParallelTaskSchema = Type.Object({\n\tagent: Type.String(),\n\ttask: Type.Optional(Type.String({ description: \"Task template with {task}, {previous}, {chain_dir} variables. Defaults to {previous}.\" })),\n\tphase: Type.Optional(Type.String({ description: \"Optional phase/group label for status and graph rendering.\" })),\n\tlabel: Type.Optional(Type.String({ description: \"Optional user-facing label for this parallel task.\" })),\n\tas: Type.Optional(Type.String({ description: \"Optional safe identifier used as {outputs.name} in later chain steps.\" })),\n\toutputSchema: Type.Optional(JsonSchemaObject),\n\tcwd: Type.Optional(Type.String()),\n\tcount: Type.Optional(Type.Integer({ minimum: 1, description: \"Repeat this parallel task N times with the same settings.\" })),\n\toutput: Type.Optional(OutputOverride),\n\toutputMode: Type.Optional(OutputModeOverride),\n\treads: Type.Optional(ReadsOverride),\n\tprogress: Type.Optional(Type.Boolean({ description: \"Enable progress.md tracking in {chain_dir}\" })),\n\tskill: Type.Optional(SkillOverride),\n\tmodel: Type.Optional(Type.String({ description: \"Override model for this task\" })),\n\ttier: Type.Optional(TierOverride), // lunr: model tiers\n\ttoolBudget: Type.Optional(ToolBudgetOverride),\n\tacceptance: Type.Optional(AcceptanceOverride),\n});\n\nexport const DynamicExpandSchema = Type.Object({\n\tfrom: Type.Object({\n\t\toutput: Type.String({ description: \"Prior named structured output to expand from.\" }),\n\t\tpath: Type.String({ description: \"JSON Pointer into the structured output, e.g. /items.\" }),\n\t}, { additionalProperties: false }),\n\titem: Type.Optional(Type.String({ description: \"Template variable name for each item. Defaults to item.\" })),\n\tkey: Type.Optional(Type.String({ description: \"JSON Pointer relative to each item for stable child ids.\" })),\n\tmaxItems: Type.Optional(Type.Integer({ minimum: 0, description: \"Required fanout bound unless configured globally.\" })),\n\tonEmpty: Type.Optional(Type.String({ enum: [\"skip\", \"fail\"], description: \"Empty input behavior. Defaults to skip.\" })),\n}, { additionalProperties: false });\n\nexport const DynamicParallelTemplateSchema = Type.Object({\n\tagent: Type.String(),\n\ttask: Type.Optional(Type.String({ description: \"Task template with {item}, {item.path}, {task}, {previous}, {chain_dir}, and {outputs.name} variables.\" })),\n\tphase: Type.Optional(Type.String({ description: \"Optional phase/group label for status and graph rendering.\" })),\n\tlabel: Type.Optional(Type.String({ description: \"Optional user-facing label; item templates are supported.\" })),\n\toutputSchema: Type.Optional(JsonSchemaObject),\n\tcwd: Type.Optional(Type.String()),\n\toutput: Type.Optional(OutputOverride),\n\toutputMode: Type.Optional(OutputModeOverride),\n\treads: Type.Optional(ReadsOverride),\n\tprogress: Type.Optional(Type.Boolean({ description: \"Enable progress.md tracking in {chain_dir}\" })),\n\tskill: Type.Optional(SkillOverride),\n\tmodel: Type.Optional(Type.String({ description: \"Override model for this task\" })),\n\ttier: Type.Optional(TierOverride), // lunr: model tiers\n\ttoolBudget: Type.Optional(ToolBudgetOverride),\n\tacceptance: Type.Optional(AcceptanceOverride),\n}, { additionalProperties: false });\n\nexport const DynamicCollectSchema = Type.Object({\n\tas: Type.String({ description: \"Safe output name for the ordered collected result array.\" }),\n\toutputSchema: Type.Optional(JsonSchemaObject),\n}, { additionalProperties: false });\n\n// Flattened so chain steps do not need an object-shape anyOf/oneOf union.\nexport const ChainItem = Type.Object({\n\tagent: Type.Optional(Type.String({ description: \"Sequential step agent name\" })),\n\ttask: Type.Optional(Type.String({\n\t\tdescription: \"Task template with variables: {task}=original request, {previous}=prior step's text response, {chain_dir}=shared folder, {outputs.name}=prior named output. Required for first step, defaults to '{previous}' for subsequent steps.\"\n\t})),\n\tphase: Type.Optional(Type.String({ description: \"Optional phase/group label for status and graph rendering.\" })),\n\tlabel: Type.Optional(Type.String({ description: \"Optional user-facing label for this chain step.\" })),\n\tas: Type.Optional(Type.String({ description: \"Optional safe identifier used as {outputs.name} in later chain steps.\" })),\n\toutputSchema: Type.Optional(JsonSchemaObject),\n\tcwd: Type.Optional(Type.String()),\n\toutput: Type.Optional(OutputOverride),\n\toutputMode: Type.Optional(OutputModeOverride),\n\treads: Type.Optional(ReadsOverride),\n\tprogress: Type.Optional(Type.Boolean({ description: \"Enable progress.md tracking in {chain_dir}\" })),\n\tskill: Type.Optional(SkillOverride),\n\tmodel: Type.Optional(Type.String({ description: \"Override model for this step\" })),\n\ttier: Type.Optional(TierOverride), // lunr: model tiers\n\ttoolBudget: Type.Optional(ToolBudgetOverride),\n\tacceptance: Type.Optional(AcceptanceOverride),\n\tparallel: Type.Optional(Type.Unsafe({\n\t\tanyOf: [\n\t\t\tType.Array(ParallelTaskSchema, { minItems: 1, description: \"Tasks to run in parallel\" }),\n\t\t\tDynamicParallelTemplateSchema,\n\t\t],\n\t\tdescription: \"Static parallel tasks array, or a single dynamic fanout child template when expand/collect are present.\",\n\t})),\n\texpand: Type.Optional(DynamicExpandSchema),\n\tcollect: Type.Optional(DynamicCollectSchema),\n\tconcurrency: Type.Optional(Type.Number({ description: \"Max concurrent tasks (default: 4)\" })),\n\tfailFast: Type.Optional(Type.Boolean({ description: \"Stop on first failure (default: false)\" })),\n\tworktree: Type.Optional(Type.Boolean({\n\t\tdescription: \"Create isolated git worktrees for each parallel task.\"\n\t})),\n}, {\n\tdescription: \"Chain step: use {agent, task?, ...} for sequential, {parallel: [...]} for static concurrent execution, or {expand, parallel: {...}, collect} for dynamic fanout.\",\n\tadditionalProperties: false,\n});\n\nconst ControlOverrides = Type.Object({\n\tenabled: Type.Optional(Type.Boolean({ description: \"Enable/disable subagent control attention tracking for this run\" })),\n\tneedsAttentionAfterMs: Type.Optional(Type.Integer({ minimum: 1, description: \"No-observed-activity window before a run needs attention\" })),\n\tactiveNoticeAfterMs: Type.Optional(Type.Integer({ minimum: 1, description: \"Active-long-running notice threshold by elapsed ms (default: 240000)\" })),\n\tactiveNoticeAfterTurns: Type.Optional(Type.Integer({ minimum: 1, description: \"Optional active-long-running notice threshold by assistant turns (disabled by default)\" })),\n\tactiveNoticeAfterTokens: Type.Optional(Type.Integer({ minimum: 1, description: \"Optional active-long-running notice threshold by total tokens (disabled by default)\" })),\n\tfailedToolAttemptsBeforeAttention: Type.Optional(Type.Integer({ minimum: 1, description: \"Consecutive mutating-tool failures before escalating to needs_attention (default: 3)\" })),\n\tnotifyOn: Type.Optional(Type.Array(Type.String({ enum: [\"active_long_running\", \"needs_attention\"] }), {\n\t\tdescription: \"Control event types that should notify the parent/orchestrator. Defaults to active_long_running and needs_attention.\",\n\t})),\n\tnotifyChannels: Type.Optional(Type.Array(Type.String({ enum: [\"event\", \"async\", \"intercom\"] }), {\n\t\tdescription: \"Notification channels to use when available. Defaults to event, async, and intercom.\",\n\t})),\n});\n\nconst SubagentParamsSchema = Type.Object({\n\tagent: Type.Optional(Type.String({ description: \"Agent name (SINGLE mode) or target for management get/update/delete\" })),\n\ttask: Type.Optional(Type.String({ description: \"Task (SINGLE mode, optional for self-contained agents)\" })),\n\t// Management action (when present, tool operates in management mode)\n\taction: Type.Optional(Type.String({\n\t\tdescription: \"Management/control action only. Must be omitted for execution mode (single, parallel, or chain).\"\n\t})),\n\tid: Type.Optional(Type.String({\n\t\tdescription: \"Run id or prefix for action='status', action='interrupt', action='stop', action='resume', action='steer', or action='append-step'.\"\n\t})),\n\trunId: Type.Optional(Type.String({\n\t\tdescription: \"Target run ID for action='interrupt', action='stop', action='resume', action='steer', or action='append-step'. Prefer id for new calls.\"\n\t})),\n\tdir: Type.Optional(Type.String({\n\t\tdescription: \"Async run directory for action='status', action='stop', action='resume', or action='steer'.\"\n\t})),\n\tindex: Type.Optional(Type.Integer({ minimum: 0, description: \"Zero-based child index for actions that target a specific child or transcript.\" })),\n\tview: Type.Optional(Type.String({\n\t\tenum: [\"fleet\", \"transcript\"],\n\t\tdescription: \"Optional status view. Use view='fleet' for a read-only active foreground/async fleet surface, or view='transcript' with id/dir (and optional index) to tail a run transcript.\",\n\t})),\n\tlines: Type.Optional(Type.Integer({ minimum: 1, maximum: 500, description: \"Maximum transcript lines for action='status', view='transcript'. Defaults to 80.\" })),\n\tmessage: Type.Optional(Type.String({ description: \"Follow-up message for action='resume' or non-terminal guidance for action='steer'. Use index to choose a child from multi-child runs.\" })),\n\tscope: Type.Optional(Type.String({ enum: [\"session\", \"user\", \"project\"], description: \"Scope for action='watchdog.configure'. Defaults to session to avoid persistent settings writes unless user/project is explicit.\" })),\n\ttarget: Type.Optional(Type.String({ enum: [\"main\", \"children\", \"child\"], description: \"Target for action='watchdog.configure'. Defaults to main. Use target='child' with agent for a per-agent child watchdog override.\" })),\n\tthinking: Type.Optional(Type.Unsafe({ anyOf: [{ type: \"string\" }, { type: \"boolean\", enum: [false] }], description: \"Thinking level for action='watchdog.configure' (off/minimal/low/medium/high/xhigh/max, inherit, or false for off).\" })),\n\tschedule: Type.Optional(Type.String({ description: \"Explicit one-shot schedule for action='schedule'. Only honored when scheduledRuns.enabled is true. Use '+10m' or a future ISO timestamp with timezone; scheduled runs always launch async with fresh context.\" })),\n\tscheduleName: Type.Optional(Type.String({ description: \"Optional display name for action='schedule'.\" })),\n\t// Chain identifier for management (can't reuse 'chain' — that's the execution array)\n\tchainName: Type.Optional(Type.String({\n\t\tdescription: \"Chain name for get/update/delete management actions\"\n\t})),\n\t// Agent/chain configuration for create/update (nested to avoid conflicts with execution fields)\n\tconfig: Type.Optional(Type.Unsafe({\n\t\tanyOf: [\n\t\t\t{ type: \"object\", additionalProperties: true },\n\t\t\t{ type: \"string\" },\n\t\t],\n\t\tdescription: \"Agent/chain config for create/update. Object or JSON string; presence of steps creates a chain.\"\n\t})),\n\ttasks: Type.Optional(Type.Array(TaskItem, { description: \"PARALLEL mode: [{agent, task, count?, output?, outputMode?, reads?, progress?}, ...]\" })),\n\tconcurrency: Type.Optional(Type.Integer({ minimum: 1, description: \"Top-level PARALLEL mode only: max concurrent tasks. Defaults to config.parallel.concurrency or 4.\" })),\n\tworktree: Type.Optional(Type.Boolean({\n\t\tdescription: \"Create isolated git worktrees for parallel tasks; requires clean git state.\"\n\t})),\n\tchain: Type.Optional(Type.Array(ChainItem, { description: \"CHAIN mode: sequential steps; each result becomes {previous}. append-step takes one tail step and may use {chain_dir}/{outputs.name}.\" })),\n\tcontext: Type.Optional(Type.String({\n\t\tenum: [\"fresh\", \"fork\"],\n\t\tdescription: \"'fresh' or 'fork' to branch from parent session. Explicit context overrides every child in the invocation. If omitted, each requested agent uses its own defaultContext; agents without defaultContext: 'fork' run fresh.\",\n\t})),\n\tchainDir: Type.Optional(Type.String({ description: \"Persistent chain artifact directory; defaults to user-scoped temp storage.\" })),\n\tasync: Type.Optional(Type.Boolean({ description: \"Run in background (default: false, or per config)\" })),\n\ttimeoutMs: Type.Optional(Type.Integer({ minimum: 1, description: \"Optional run-level timeout in ms for foreground and async/background runs. Alias of maxRuntimeMs.\" })),\n\tmaxRuntimeMs: Type.Optional(Type.Integer({ minimum: 1, description: \"Alias of timeoutMs for optional run-level timeout in foreground and async/background runs.\" })),\n\tturnBudget: Type.Optional(TurnBudgetOverride),\n\ttoolBudget: Type.Optional(ToolBudgetOverride),\n\tagentScope: Type.Optional(Type.String({ description: \"Agent discovery scope: 'user', 'project', or 'both' (default: 'both'; project wins on name collisions)\" })),\n\tcwd: Type.Optional(Type.String()),\n\tartifacts: Type.Optional(Type.Boolean({ description: \"Write debug artifacts (default: true)\" })),\n\tincludeProgress: Type.Optional(Type.Boolean({ description: \"Include full progress in result (default: false)\" })),\n\tshare: Type.Optional(Type.Boolean({ description: \"Upload session to GitHub Gist for sharing (default: false)\" })),\n\tsessionDir: Type.Optional(\n\t\tType.String({ description: \"Directory to store session logs (default: temp; enables sessions even if share=false)\" }),\n\t),\n\t// Clarification TUI\n\tclarify: Type.Optional(Type.Boolean({ description: \"Show TUI to preview/edit before execution. Explicit clarify: true keeps the run foreground for the clarify UI; omitted clarify can still run in the background when async: true is set.\" })),\n\tcontrol: Type.Optional(ControlOverrides),\n\t// Solo agent overrides\n\toutput: Type.Optional(Type.Unsafe({\n\t\tanyOf: [\n\t\t\t{ type: \"string\" },\n\t\t\t{ type: \"boolean\" },\n\t\t],\n\t\tdescription: \"Output file for single agent (string), or false to disable. Relative paths resolve against cwd.\",\n\t})),\n\toutputMode: Type.Optional(OutputModeOverride),\n\tskill: Type.Optional(SkillOverride),\n\tmodel: Type.Optional(Type.String({ description: \"Override model for single agent (e.g. 'anthropic/claude-sonnet-4')\" })),\n\ttier: Type.Optional(TierOverride), // lunr: model tiers\n\tacceptance: Type.Optional(AcceptanceOverride),\n});\n\nexport const SubagentParams = keepTopLevelParameterDescriptions(SubagentParamsSchema);\n\nconst SubagentWaitParamsSchema = Type.Object({\n\tid: Type.Optional(Type.String({\n\t\tdescription: \"Async run or remembered detached foreground run id/prefix to wait for one specific run. Omit to wait across every active async run started in this session.\",\n\t})),\n\tall: Type.Optional(Type.Boolean({\n\t\tdescription: \"Wait for ALL active runs to finish. Default false: return as soon as the first run finishes, so a fleet manager can spawn a replacement and wait again. Ignored when id targets a single run.\",\n\t})),\n\ttimeoutMs: Type.Optional(Type.Integer({\n\t\tminimum: 1,\n\t\tdescription: \"Give up waiting after this many milliseconds (the runs keep going regardless). Defaults to 1800000 (30 minutes).\",\n\t})),\n});\n\nexport const SubagentWaitParams = keepTopLevelParameterDescriptions(SubagentWaitParamsSchema);\n"]}

package/dist/builtin-extensions/pi-subagents/src/extension/schemas.js

@@ -0,0 +1,301 @@
+// @ts-nocheck
+/**
+ * TypeBox schemas for subagent tool parameters
+ */
+import { Type } from "typebox";
+function keepTopLevelParameterDescriptions(schema) {
+    return pruneNestedDescriptions(schema, []);
+}
+function pruneNestedDescriptions(value, path) {
+    if (!value || typeof value !== "object")
+        return value;
+    const result = Array.isArray(value) ? [] : Object.create(Object.getPrototypeOf(value));
+    for (const key of Reflect.ownKeys(value)) {
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (!descriptor)
+            continue;
+        if (key === "description" && !isTopLevelParameterDescription(path))
+            continue;
+        if ("value" in descriptor) {
+            const nextPath = typeof key === "string" ? [...path, key] : path;
+            descriptor.value = pruneNestedDescriptions(descriptor.value, nextPath);
+        }
+        Object.defineProperty(result, key, descriptor);
+    }
+    return result;
+}
+function isTopLevelParameterDescription(path) {
+    return path.length === 2 && path[0] === "properties";
+}
+const SkillOverride = Type.Unsafe({
+    anyOf: [
+        { type: "array", items: { type: "string" } },
+        { type: "boolean" },
+        { type: "string" },
+    ],
+    description: "Skill name(s) to make available (comma-separated), array of strings, or boolean (false disables, true uses default)",
+});
+const OutputOverride = Type.Unsafe({
+    anyOf: [
+        { type: "string" },
+        { type: "boolean" },
+    ],
+    description: "Output filename/path (string), or false to disable file output",
+});
+const OutputModeOverride = Type.String({
+    enum: ["inline", "file-only"],
+    description: "Return saved output inline (default) or only a concise file reference. file-only requires output to be a path.",
+});
+// lunr: model tier override for 3-tier subagent routing; resolved through the
+// @lunr/model-tiers bridge and ignored when tier mode is disabled.
+const TierOverride = Type.String({
+    enum: ["light", "standard", "heavy"],
+    description: "Model tier ('light' cheap/fast, 'standard' typical, 'heavy' complex reasoning) when model tiers are enabled. An explicit model overrides the tier; omit both to inherit the parent model.",
+});
+const ReadsOverride = Type.Unsafe({
+    anyOf: [
+        { type: "array", items: { type: "string" } },
+        { type: "boolean" },
+    ],
+    description: "Files to read before running (array of filenames), or false to disable",
+});
+const JsonSchemaObject = Type.Unsafe({
+    type: "object",
+    additionalProperties: true,
+    description: "JSON Schema object for strict structured output. Non-object roots are rejected.",
+});
+const AcceptanceOverride = Type.Unsafe({
+    anyOf: [
+        { type: "string", enum: ["auto", "attested", "checked", "verified", "reviewed"] },
+        { type: "boolean", enum: [false] },
+        { type: "object", additionalProperties: true },
+    ],
+    description: "Optional acceptance policy. Omitted means auto-inferred; verified requires configured runtime commands. Reviewed is inferred-only because explicit runs cannot supply an independent reviewer result. Bare \"none\" requires { level: \"none\", reason: \"...\" }, while false is deprecated.",
+});
+const TurnBudgetOverride = Type.Object({
+    maxTurns: Type.Integer({ minimum: 1 }),
+    graceTurns: Type.Optional(Type.Integer({ minimum: 0 })),
+}, { additionalProperties: false, description: "Optional assistant-turn budget. At maxTurns the child is asked to wrap up; after graceTurns additional assistant turns it is aborted and partial output is returned." });
+const ToolBudgetBlock = Type.Unsafe({
+    anyOf: [
+        { type: "array", minItems: 1, items: { type: "string", minLength: 1 } },
+        { type: "string", enum: ["*"] },
+    ],
+});
+const ToolBudgetOverride = Type.Object({
+    soft: Type.Optional(Type.Integer({ minimum: 1 })),
+    hard: Type.Integer({ minimum: 1 }),
+    block: Type.Optional(ToolBudgetBlock),
+}, { additionalProperties: false, description: "Optional child tool-call budget. soft nudges the child; after hard, block tools (default read/grep/find/ls, or '*' for all tools) are blocked so the child can finalize." });
+const TaskItem = Type.Object({
+    agent: Type.String(),
+    task: Type.String(),
+    cwd: Type.Optional(Type.String()),
+    count: Type.Optional(Type.Integer({ minimum: 1, description: "Repeat this parallel task N times with the same settings." })),
+    output: Type.Optional(OutputOverride),
+    outputMode: Type.Optional(OutputModeOverride),
+    reads: Type.Optional(ReadsOverride),
+    progress: Type.Optional(Type.Boolean({ description: "Enable progress.md tracking for this task" })),
+    model: Type.Optional(Type.String({ description: "Override model for this task (e.g. 'google/gemini-3-pro')" })),
+    tier: Type.Optional(TierOverride), // lunr: model tiers
+    skill: Type.Optional(SkillOverride),
+    toolBudget: Type.Optional(ToolBudgetOverride),
+    acceptance: Type.Optional(AcceptanceOverride),
+});
+// Parallel task item (within a parallel step)
+export const ParallelTaskSchema = Type.Object({
+    agent: Type.String(),
+    task: Type.Optional(Type.String({ description: "Task template with {task}, {previous}, {chain_dir} variables. Defaults to {previous}." })),
+    phase: Type.Optional(Type.String({ description: "Optional phase/group label for status and graph rendering." })),
+    label: Type.Optional(Type.String({ description: "Optional user-facing label for this parallel task." })),
+    as: Type.Optional(Type.String({ description: "Optional safe identifier used as {outputs.name} in later chain steps." })),
+    outputSchema: Type.Optional(JsonSchemaObject),
+    cwd: Type.Optional(Type.String()),
+    count: Type.Optional(Type.Integer({ minimum: 1, description: "Repeat this parallel task N times with the same settings." })),
+    output: Type.Optional(OutputOverride),
+    outputMode: Type.Optional(OutputModeOverride),
+    reads: Type.Optional(ReadsOverride),
+    progress: Type.Optional(Type.Boolean({ description: "Enable progress.md tracking in {chain_dir}" })),
+    skill: Type.Optional(SkillOverride),
+    model: Type.Optional(Type.String({ description: "Override model for this task" })),
+    tier: Type.Optional(TierOverride), // lunr: model tiers
+    toolBudget: Type.Optional(ToolBudgetOverride),
+    acceptance: Type.Optional(AcceptanceOverride),
+});
+export const DynamicExpandSchema = Type.Object({
+    from: Type.Object({
+        output: Type.String({ description: "Prior named structured output to expand from." }),
+        path: Type.String({ description: "JSON Pointer into the structured output, e.g. /items." }),
+    }, { additionalProperties: false }),
+    item: Type.Optional(Type.String({ description: "Template variable name for each item. Defaults to item." })),
+    key: Type.Optional(Type.String({ description: "JSON Pointer relative to each item for stable child ids." })),
+    maxItems: Type.Optional(Type.Integer({ minimum: 0, description: "Required fanout bound unless configured globally." })),
+    onEmpty: Type.Optional(Type.String({ enum: ["skip", "fail"], description: "Empty input behavior. Defaults to skip." })),
+}, { additionalProperties: false });
+export const DynamicParallelTemplateSchema = Type.Object({
+    agent: Type.String(),
+    task: Type.Optional(Type.String({ description: "Task template with {item}, {item.path}, {task}, {previous}, {chain_dir}, and {outputs.name} variables." })),
+    phase: Type.Optional(Type.String({ description: "Optional phase/group label for status and graph rendering." })),
+    label: Type.Optional(Type.String({ description: "Optional user-facing label; item templates are supported." })),
+    outputSchema: Type.Optional(JsonSchemaObject),
+    cwd: Type.Optional(Type.String()),
+    output: Type.Optional(OutputOverride),
+    outputMode: Type.Optional(OutputModeOverride),
+    reads: Type.Optional(ReadsOverride),
+    progress: Type.Optional(Type.Boolean({ description: "Enable progress.md tracking in {chain_dir}" })),
+    skill: Type.Optional(SkillOverride),
+    model: Type.Optional(Type.String({ description: "Override model for this task" })),
+    tier: Type.Optional(TierOverride), // lunr: model tiers
+    toolBudget: Type.Optional(ToolBudgetOverride),
+    acceptance: Type.Optional(AcceptanceOverride),
+}, { additionalProperties: false });
+export const DynamicCollectSchema = Type.Object({
+    as: Type.String({ description: "Safe output name for the ordered collected result array." }),
+    outputSchema: Type.Optional(JsonSchemaObject),
+}, { additionalProperties: false });
+// Flattened so chain steps do not need an object-shape anyOf/oneOf union.
+export const ChainItem = Type.Object({
+    agent: Type.Optional(Type.String({ description: "Sequential step agent name" })),
+    task: Type.Optional(Type.String({
+        description: "Task template with variables: {task}=original request, {previous}=prior step's text response, {chain_dir}=shared folder, {outputs.name}=prior named output. Required for first step, defaults to '{previous}' for subsequent steps."
+    })),
+    phase: Type.Optional(Type.String({ description: "Optional phase/group label for status and graph rendering." })),
+    label: Type.Optional(Type.String({ description: "Optional user-facing label for this chain step." })),
+    as: Type.Optional(Type.String({ description: "Optional safe identifier used as {outputs.name} in later chain steps." })),
+    outputSchema: Type.Optional(JsonSchemaObject),
+    cwd: Type.Optional(Type.String()),
+    output: Type.Optional(OutputOverride),
+    outputMode: Type.Optional(OutputModeOverride),
+    reads: Type.Optional(ReadsOverride),
+    progress: Type.Optional(Type.Boolean({ description: "Enable progress.md tracking in {chain_dir}" })),
+    skill: Type.Optional(SkillOverride),
+    model: Type.Optional(Type.String({ description: "Override model for this step" })),
+    tier: Type.Optional(TierOverride), // lunr: model tiers
+    toolBudget: Type.Optional(ToolBudgetOverride),
+    acceptance: Type.Optional(AcceptanceOverride),
+    parallel: Type.Optional(Type.Unsafe({
+        anyOf: [
+            Type.Array(ParallelTaskSchema, { minItems: 1, description: "Tasks to run in parallel" }),
+            DynamicParallelTemplateSchema,
+        ],
+        description: "Static parallel tasks array, or a single dynamic fanout child template when expand/collect are present.",
+    })),
+    expand: Type.Optional(DynamicExpandSchema),
+    collect: Type.Optional(DynamicCollectSchema),
+    concurrency: Type.Optional(Type.Number({ description: "Max concurrent tasks (default: 4)" })),
+    failFast: Type.Optional(Type.Boolean({ description: "Stop on first failure (default: false)" })),
+    worktree: Type.Optional(Type.Boolean({
+        description: "Create isolated git worktrees for each parallel task."
+    })),
+}, {
+    description: "Chain step: use {agent, task?, ...} for sequential, {parallel: [...]} for static concurrent execution, or {expand, parallel: {...}, collect} for dynamic fanout.",
+    additionalProperties: false,
+});
+const ControlOverrides = Type.Object({
+    enabled: Type.Optional(Type.Boolean({ description: "Enable/disable subagent control attention tracking for this run" })),
+    needsAttentionAfterMs: Type.Optional(Type.Integer({ minimum: 1, description: "No-observed-activity window before a run needs attention" })),
+    activeNoticeAfterMs: Type.Optional(Type.Integer({ minimum: 1, description: "Active-long-running notice threshold by elapsed ms (default: 240000)" })),
+    activeNoticeAfterTurns: Type.Optional(Type.Integer({ minimum: 1, description: "Optional active-long-running notice threshold by assistant turns (disabled by default)" })),
+    activeNoticeAfterTokens: Type.Optional(Type.Integer({ minimum: 1, description: "Optional active-long-running notice threshold by total tokens (disabled by default)" })),
+    failedToolAttemptsBeforeAttention: Type.Optional(Type.Integer({ minimum: 1, description: "Consecutive mutating-tool failures before escalating to needs_attention (default: 3)" })),
+    notifyOn: Type.Optional(Type.Array(Type.String({ enum: ["active_long_running", "needs_attention"] }), {
+        description: "Control event types that should notify the parent/orchestrator. Defaults to active_long_running and needs_attention.",
+    })),
+    notifyChannels: Type.Optional(Type.Array(Type.String({ enum: ["event", "async", "intercom"] }), {
+        description: "Notification channels to use when available. Defaults to event, async, and intercom.",
+    })),
+});
+const SubagentParamsSchema = Type.Object({
+    agent: Type.Optional(Type.String({ description: "Agent name (SINGLE mode) or target for management get/update/delete" })),
+    task: Type.Optional(Type.String({ description: "Task (SINGLE mode, optional for self-contained agents)" })),
+    // Management action (when present, tool operates in management mode)
+    action: Type.Optional(Type.String({
+        description: "Management/control action only. Must be omitted for execution mode (single, parallel, or chain)."
+    })),
+    id: Type.Optional(Type.String({
+        description: "Run id or prefix for action='status', action='interrupt', action='stop', action='resume', action='steer', or action='append-step'."
+    })),
+    runId: Type.Optional(Type.String({
+        description: "Target run ID for action='interrupt', action='stop', action='resume', action='steer', or action='append-step'. Prefer id for new calls."
+    })),
+    dir: Type.Optional(Type.String({
+        description: "Async run directory for action='status', action='stop', action='resume', or action='steer'."
+    })),
+    index: Type.Optional(Type.Integer({ minimum: 0, description: "Zero-based child index for actions that target a specific child or transcript." })),
+    view: Type.Optional(Type.String({
+        enum: ["fleet", "transcript"],
+        description: "Optional status view. Use view='fleet' for a read-only active foreground/async fleet surface, or view='transcript' with id/dir (and optional index) to tail a run transcript.",
+    })),
+    lines: Type.Optional(Type.Integer({ minimum: 1, maximum: 500, description: "Maximum transcript lines for action='status', view='transcript'. Defaults to 80." })),
+    message: Type.Optional(Type.String({ description: "Follow-up message for action='resume' or non-terminal guidance for action='steer'. Use index to choose a child from multi-child runs." })),
+    scope: Type.Optional(Type.String({ enum: ["session", "user", "project"], description: "Scope for action='watchdog.configure'. Defaults to session to avoid persistent settings writes unless user/project is explicit." })),
+    target: Type.Optional(Type.String({ enum: ["main", "children", "child"], description: "Target for action='watchdog.configure'. Defaults to main. Use target='child' with agent for a per-agent child watchdog override." })),
+    thinking: Type.Optional(Type.Unsafe({ anyOf: [{ type: "string" }, { type: "boolean", enum: [false] }], description: "Thinking level for action='watchdog.configure' (off/minimal/low/medium/high/xhigh/max, inherit, or false for off)." })),
+    schedule: Type.Optional(Type.String({ description: "Explicit one-shot schedule for action='schedule'. Only honored when scheduledRuns.enabled is true. Use '+10m' or a future ISO timestamp with timezone; scheduled runs always launch async with fresh context." })),
+    scheduleName: Type.Optional(Type.String({ description: "Optional display name for action='schedule'." })),
+    // Chain identifier for management (can't reuse 'chain' — that's the execution array)
+    chainName: Type.Optional(Type.String({
+        description: "Chain name for get/update/delete management actions"
+    })),
+    // Agent/chain configuration for create/update (nested to avoid conflicts with execution fields)
+    config: Type.Optional(Type.Unsafe({
+        anyOf: [
+            { type: "object", additionalProperties: true },
+            { type: "string" },
+        ],
+        description: "Agent/chain config for create/update. Object or JSON string; presence of steps creates a chain."
+    })),
+    tasks: Type.Optional(Type.Array(TaskItem, { description: "PARALLEL mode: [{agent, task, count?, output?, outputMode?, reads?, progress?}, ...]" })),
+    concurrency: Type.Optional(Type.Integer({ minimum: 1, description: "Top-level PARALLEL mode only: max concurrent tasks. Defaults to config.parallel.concurrency or 4." })),
+    worktree: Type.Optional(Type.Boolean({
+        description: "Create isolated git worktrees for parallel tasks; requires clean git state."
+    })),
+    chain: Type.Optional(Type.Array(ChainItem, { description: "CHAIN mode: sequential steps; each result becomes {previous}. append-step takes one tail step and may use {chain_dir}/{outputs.name}." })),
+    context: Type.Optional(Type.String({
+        enum: ["fresh", "fork"],
+        description: "'fresh' or 'fork' to branch from parent session. Explicit context overrides every child in the invocation. If omitted, each requested agent uses its own defaultContext; agents without defaultContext: 'fork' run fresh.",
+    })),
+    chainDir: Type.Optional(Type.String({ description: "Persistent chain artifact directory; defaults to user-scoped temp storage." })),
+    async: Type.Optional(Type.Boolean({ description: "Run in background (default: false, or per config)" })),
+    timeoutMs: Type.Optional(Type.Integer({ minimum: 1, description: "Optional run-level timeout in ms for foreground and async/background runs. Alias of maxRuntimeMs." })),
+    maxRuntimeMs: Type.Optional(Type.Integer({ minimum: 1, description: "Alias of timeoutMs for optional run-level timeout in foreground and async/background runs." })),
+    turnBudget: Type.Optional(TurnBudgetOverride),
+    toolBudget: Type.Optional(ToolBudgetOverride),
+    agentScope: Type.Optional(Type.String({ description: "Agent discovery scope: 'user', 'project', or 'both' (default: 'both'; project wins on name collisions)" })),
+    cwd: Type.Optional(Type.String()),
+    artifacts: Type.Optional(Type.Boolean({ description: "Write debug artifacts (default: true)" })),
+    includeProgress: Type.Optional(Type.Boolean({ description: "Include full progress in result (default: false)" })),
+    share: Type.Optional(Type.Boolean({ description: "Upload session to GitHub Gist for sharing (default: false)" })),
+    sessionDir: Type.Optional(Type.String({ description: "Directory to store session logs (default: temp; enables sessions even if share=false)" })),
+    // Clarification TUI
+    clarify: Type.Optional(Type.Boolean({ description: "Show TUI to preview/edit before execution. Explicit clarify: true keeps the run foreground for the clarify UI; omitted clarify can still run in the background when async: true is set." })),
+    control: Type.Optional(ControlOverrides),
+    // Solo agent overrides
+    output: Type.Optional(Type.Unsafe({
+        anyOf: [
+            { type: "string" },
+            { type: "boolean" },
+        ],
+        description: "Output file for single agent (string), or false to disable. Relative paths resolve against cwd.",
+    })),
+    outputMode: Type.Optional(OutputModeOverride),
+    skill: Type.Optional(SkillOverride),
+    model: Type.Optional(Type.String({ description: "Override model for single agent (e.g. 'anthropic/claude-sonnet-4')" })),
+    tier: Type.Optional(TierOverride), // lunr: model tiers
+    acceptance: Type.Optional(AcceptanceOverride),
+});
+export const SubagentParams = keepTopLevelParameterDescriptions(SubagentParamsSchema);
+const SubagentWaitParamsSchema = Type.Object({
+    id: Type.Optional(Type.String({
+        description: "Async run or remembered detached foreground run id/prefix to wait for one specific run. Omit to wait across every active async run started in this session.",
+    })),
+    all: Type.Optional(Type.Boolean({
+        description: "Wait for ALL active runs to finish. Default false: return as soon as the first run finishes, so a fleet manager can spawn a replacement and wait again. Ignored when id targets a single run.",
+    })),
+    timeoutMs: Type.Optional(Type.Integer({
+        minimum: 1,
+        description: "Give up waiting after this many milliseconds (the runs keep going regardless). Defaults to 1800000 (30 minutes).",
+    })),
+});
+export const SubagentWaitParams = keepTopLevelParameterDescriptions(SubagentWaitParamsSchema);
+//# sourceMappingURL=schemas.js.map