@wjarka/cezarion 0.16.0 → 0.17.0

package/dist/ci-wait/tools.d.ts

@@ -1,3 +1,4 @@
+import { type CezarAskAnswer } from '../contract/index.js';
 import { z } from 'zod';
 /**
  * The one list of cezar tools (#781). The MCP adapter lists it, Pi's extension registers it, and
@@ -29,7 +30,184 @@ export type CezarTool = {
 };
 /** Live preview is on under the exact value `1` only (spec 2026-10-02-live-preview-v1). */
 export declare function previewToolEnabled(env?: NodeJS.ProcessEnv): boolean;
-export declare const ciToolDefinition: {
+/** Automations are on under the exact value `1` only (spec 2026-10-02-scheduled-automations). */
+export declare function automationsToolEnabled(env?: NodeJS.ProcessEnv): boolean;
+export declare const waitToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: {
+            kind: {
+                type: string;
+                enum: ("pr" | "process" | "timer" | "worker")[];
+                description: string;
+            };
+            pr: {
+                description: string;
+            };
+            until: {
+                description: string;
+            };
+            wake_on_conflict: {
+                description: string;
+            };
+            worker_ids: {
+                description: string;
+            };
+            request_ids: {
+                description: string;
+            };
+            mode: {
+                description: string;
+            };
+            timeout_seconds: {
+                description: string;
+            };
+            seconds: {
+                description: string;
+            };
+            pid: {
+                description: string;
+            };
+            exit_file: {
+                description: string;
+            };
+            note: {
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+};
+/**
+ * hearsay-tools/cezarion#1234: the user's answer gets its own tool, so its card is required and
+ * `cezar_wait` never has to explain a field only one kind takes. hearsay-tools/cezarion#1458: the
+ * texts are research task 77dfb5c4's tested ones; on Claude, prose between tool calls may never
+ * reach the user, so the content rides in `context`.
+ */
+export declare const askToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        $schema?: "https://json-schema.org/draft/2020-12/schema" | "http://json-schema.org/draft-07/schema#" | "http://json-schema.org/draft-04/schema#";
+        $id?: string;
+        $anchor?: string;
+        $ref?: string;
+        $dynamicRef?: string;
+        $dynamicAnchor?: string;
+        $vocabulary?: Record<string, boolean>;
+        $comment?: string;
+        $defs?: Record<string, z.core.JSONSchema.JSONSchema>;
+        additionalItems?: z.core.JSONSchema._JSONSchema;
+        unevaluatedItems?: z.core.JSONSchema._JSONSchema;
+        prefixItems?: z.core.JSONSchema._JSONSchema[];
+        items?: z.core.JSONSchema._JSONSchema | z.core.JSONSchema._JSONSchema[];
+        contains?: z.core.JSONSchema._JSONSchema;
+        additionalProperties?: z.core.JSONSchema._JSONSchema;
+        unevaluatedProperties?: z.core.JSONSchema._JSONSchema;
+        properties?: Record<string, z.core.JSONSchema._JSONSchema>;
+        patternProperties?: Record<string, z.core.JSONSchema._JSONSchema>;
+        dependentSchemas?: Record<string, z.core.JSONSchema._JSONSchema>;
+        propertyNames?: z.core.JSONSchema._JSONSchema;
+        if?: z.core.JSONSchema._JSONSchema;
+        then?: z.core.JSONSchema._JSONSchema;
+        else?: z.core.JSONSchema._JSONSchema;
+        allOf?: z.core.JSONSchema.JSONSchema[];
+        anyOf?: z.core.JSONSchema.JSONSchema[];
+        oneOf?: z.core.JSONSchema.JSONSchema[];
+        not?: z.core.JSONSchema._JSONSchema;
+        multipleOf?: number;
+        maximum?: number;
+        exclusiveMaximum?: number | boolean;
+        minimum?: number;
+        exclusiveMinimum?: number | boolean;
+        maxLength?: number;
+        minLength?: number;
+        pattern?: string;
+        maxItems?: number;
+        minItems?: number;
+        uniqueItems?: boolean;
+        maxContains?: number;
+        minContains?: number;
+        maxProperties?: number;
+        minProperties?: number;
+        required?: string[];
+        dependentRequired?: Record<string, string[]>;
+        enum?: Array<string | number | boolean | null>;
+        const?: string | number | boolean | null;
+        id?: string;
+        title?: string;
+        description?: string;
+        default?: unknown;
+        deprecated?: boolean;
+        readOnly?: boolean;
+        writeOnly?: boolean;
+        nullable?: boolean;
+        examples?: unknown[];
+        format?: string;
+        contentMediaType?: string;
+        contentEncoding?: string;
+        contentSchema?: z.core.JSONSchema.JSONSchema;
+        _prefault?: unknown;
+        "~standard": z.core.ZodStandardSchemaWithJSON<z.ZodObject<{
+            questions: z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                header: z.ZodString;
+                question: z.ZodString;
+                options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    label: z.ZodString;
+                    description: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                multiSelect: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+            context: z.ZodString;
+        }, z.core.$strict>>;
+        type: 'object';
+    };
+};
+/**
+ * hearsay-tools/cezarion#1428: agents asked about drafts they never sent, and treated the context
+ * they cut from a rejected card as sent. Both hints say where that context belongs: `context`.
+ */
+export declare function askAnswerHint(answer: CezarAskAnswer): string;
+export declare function invokeAskTool(input: unknown): Promise<{
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError: boolean;
+    details: {
+        ok: true;
+        wait_id: string;
+        open_waits: ({
+            wait_id: string;
+            summary: string;
+            kind: "pr" | "process" | "timer" | "worker";
+            deadline: string;
+        } | {
+            wait_id: string;
+            summary: string;
+            kind: "human";
+        })[];
+    } | {
+        ok: false;
+        code: "autonomous_run" | "capability_revoked" | "capacity" | "finish_requested" | "generation_mismatch" | "invalid_request" | "manager_disposed" | "persistence" | "root_finish_pending" | "run_cancelled" | "run_missing" | "run_not_running" | "run_stopping" | "session_closed" | "session_replaced" | "unauthorized" | "unavailable" | "worker_execution_stopped" | "worker_wait_pending";
+        message: string;
+        open_waits?: ({
+            wait_id: string;
+            summary: string;
+            kind: "pr" | "process" | "timer" | "worker";
+            deadline: string;
+        } | {
+            wait_id: string;
+            summary: string;
+            kind: "human";
+        })[] | undefined;
+    };
+}>;
+export declare const cancelWaitToolDefinition: {
     name: string;
     description: string;
     inputSchema: {
@@ -94,35 +272,209 @@ export declare const ciToolDefinition: {
         contentSchema?: z.core.JSONSchema.JSONSchema;
         _prefault?: unknown;
         "~standard": z.core.ZodStandardSchemaWithJSON<z.ZodObject<{
-            pr: z.ZodString;
-            timeout_seconds: z.ZodDefault<z.ZodNumber>;
+            wait_id: z.ZodUUID;
         }, z.core.$strict>>;
         type: 'object';
     };
 };
-export declare function invokeCiTool(input: unknown): Promise<{
+/** JSON first, then one hint sentence, as `invokePreviewTool` answers. */
+export declare function invokeWaitTool(input: unknown): Promise<{
     content: {
         type: 'text';
         text: string;
     }[];
+    isError: boolean;
     details: {
-        prUrl: string;
-        repository: string;
-        prNumber: number;
-        headSha: string;
-        waitId: string;
-        registeredAt: string;
+        ok: true;
+        wait_id: string;
+        kind: "pr" | "process" | "timer" | "worker";
         deadline: string;
-        phase: "delivered" | "parked" | "registered" | "wake-pending" | "withdrawn";
+        open_waits: ({
+            wait_id: string;
+            summary: string;
+            kind: "pr" | "process" | "timer" | "worker";
+            deadline: string;
+        } | {
+            wait_id: string;
+            summary: string;
+            kind: "human";
+        })[];
+    } | {
+        ok: false;
+        code: "authentication" | "capability_revoked" | "capacity" | "command_failed" | "denied_scope" | "exit_file_outside" | "finish_requested" | "generation_mismatch" | "gh_missing" | "inaccessible_pr" | "invalid_request" | "malformed_data" | "manager_disposed" | "output_limit" | "persistence" | "process_not_allowed" | "process_not_owned" | "query_timeout" | "registration_aborted" | "root_finish_pending" | "run_cancelled" | "run_missing" | "run_not_running" | "run_stopping" | "session_closed" | "session_replaced" | "timers_disabled" | "turn_changed" | "unauthorized" | "unavailable" | "unsupported_host" | "wait_conflict" | "wake_budget_spent" | "worker_execution_stopped" | "worker_wait_pending";
+        message: string;
+        open_waits?: ({
+            wait_id: string;
+            summary: string;
+            kind: "pr" | "process" | "timer" | "worker";
+            deadline: string;
+        } | {
+            wait_id: string;
+            summary: string;
+            kind: "human";
+        })[] | undefined;
     };
-    isError?: undefined;
-} | {
+}>;
+export declare function invokeCancelWaitTool(input: unknown): Promise<{
+    content: {
+        type: 'text';
+        text: string;
+    }[];
     isError: boolean;
+    details: {
+        cancelled: true;
+        wait_id: string;
+        open_waits: ({
+            wait_id: string;
+            summary: string;
+            kind: "pr" | "process" | "timer" | "worker";
+            deadline: string;
+        } | {
+            wait_id: string;
+            summary: string;
+            kind: "human";
+        })[];
+    } | {
+        cancelled: false;
+        code: "already_resolved" | "human_question" | "invalid_request" | "not_found" | "unavailable";
+        message: string;
+        open_waits?: ({
+            wait_id: string;
+            summary: string;
+            kind: "pr" | "process" | "timer" | "worker";
+            deadline: string;
+        } | {
+            wait_id: string;
+            summary: string;
+            kind: "human";
+        })[] | undefined;
+    };
+}>;
+/** hearsay-tools/cezarion#1234: the explicit form of the done line. */
+export declare const doneToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        $schema?: "https://json-schema.org/draft/2020-12/schema" | "http://json-schema.org/draft-07/schema#" | "http://json-schema.org/draft-04/schema#";
+        $id?: string;
+        $anchor?: string;
+        $ref?: string;
+        $dynamicRef?: string;
+        $dynamicAnchor?: string;
+        $vocabulary?: Record<string, boolean>;
+        $comment?: string;
+        $defs?: Record<string, z.core.JSONSchema.JSONSchema>;
+        additionalItems?: z.core.JSONSchema._JSONSchema;
+        unevaluatedItems?: z.core.JSONSchema._JSONSchema;
+        prefixItems?: z.core.JSONSchema._JSONSchema[];
+        items?: z.core.JSONSchema._JSONSchema | z.core.JSONSchema._JSONSchema[];
+        contains?: z.core.JSONSchema._JSONSchema;
+        additionalProperties?: z.core.JSONSchema._JSONSchema;
+        unevaluatedProperties?: z.core.JSONSchema._JSONSchema;
+        properties?: Record<string, z.core.JSONSchema._JSONSchema>;
+        patternProperties?: Record<string, z.core.JSONSchema._JSONSchema>;
+        dependentSchemas?: Record<string, z.core.JSONSchema._JSONSchema>;
+        propertyNames?: z.core.JSONSchema._JSONSchema;
+        if?: z.core.JSONSchema._JSONSchema;
+        then?: z.core.JSONSchema._JSONSchema;
+        else?: z.core.JSONSchema._JSONSchema;
+        allOf?: z.core.JSONSchema.JSONSchema[];
+        anyOf?: z.core.JSONSchema.JSONSchema[];
+        oneOf?: z.core.JSONSchema.JSONSchema[];
+        not?: z.core.JSONSchema._JSONSchema;
+        multipleOf?: number;
+        maximum?: number;
+        exclusiveMaximum?: number | boolean;
+        minimum?: number;
+        exclusiveMinimum?: number | boolean;
+        maxLength?: number;
+        minLength?: number;
+        pattern?: string;
+        maxItems?: number;
+        minItems?: number;
+        uniqueItems?: boolean;
+        maxContains?: number;
+        minContains?: number;
+        maxProperties?: number;
+        minProperties?: number;
+        required?: string[];
+        dependentRequired?: Record<string, string[]>;
+        enum?: Array<string | number | boolean | null>;
+        const?: string | number | boolean | null;
+        id?: string;
+        title?: string;
+        description?: string;
+        default?: unknown;
+        deprecated?: boolean;
+        readOnly?: boolean;
+        writeOnly?: boolean;
+        nullable?: boolean;
+        examples?: unknown[];
+        format?: string;
+        contentMediaType?: string;
+        contentEncoding?: string;
+        contentSchema?: z.core.JSONSchema.JSONSchema;
+        _prefault?: unknown;
+        "~standard": z.core.ZodStandardSchemaWithJSON<z.ZodObject<{
+            summary: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        type: 'object';
+    };
+};
+export declare function invokeDoneTool(input: unknown): Promise<{
     content: {
         type: 'text';
         text: string;
     }[];
-    details: {};
+    isError: boolean;
+    details: {
+        ok: true;
+        finishes: "at_turn_end";
+        open_waits: ({
+            wait_id: string;
+            summary: string;
+            kind: "pr" | "process" | "timer" | "worker";
+            deadline: string;
+        } | {
+            wait_id: string;
+            summary: string;
+            kind: "human";
+        })[];
+        completes: "task";
+    } | {
+        ok: true;
+        finishes: "at_turn_end";
+        open_waits: ({
+            wait_id: string;
+            summary: string;
+            kind: "pr" | "process" | "timer" | "worker";
+            deadline: string;
+        } | {
+            wait_id: string;
+            summary: string;
+            kind: "human";
+        })[];
+        completes: "step";
+        next_step: string;
+    } | {
+        ok: false;
+        code: "capability_revoked" | "finish_requested" | "generation_mismatch" | "human_question_pending" | "invalid_request" | "manager_disposed" | "not_final_step" | "root_finish_pending" | "run_cancelled" | "run_missing" | "run_not_running" | "run_stopping" | "session_closed" | "session_replaced" | "unavailable" | "worker_questions" | "worker_wait_pending" | "workers_outstanding" | "workers_uncollected";
+        message: string;
+        workers?: {
+            worker_id: string;
+            reason: "outstanding" | "question" | "uncollected";
+        }[] | undefined;
+        open_waits?: ({
+            wait_id: string;
+            summary: string;
+            kind: "pr" | "process" | "timer" | "worker";
+            deadline: string;
+        } | {
+            wait_id: string;
+            summary: string;
+            kind: "human";
+        })[] | undefined;
+    };
 }>;
 export declare const previewToolDefinition: {
     name: string;
@@ -198,7 +550,7 @@ export declare const previewToolDefinition: {
         type: 'object';
     };
 };
-/** JSON first, then the hint as a plain sentence: the shape `cezar_wait_for_ci` answers in. */
+/** JSON first, then the hint as a plain sentence: the shape every cezar tool answers in. */
 export declare function invokePreviewTool(input: unknown): Promise<{
     content: {
         type: 'text';
@@ -296,11 +648,179 @@ export declare function invokePreviewStopTool(input: unknown): Promise<{
         hint: string;
     };
 }>;
+/**
+ * hearsay-tools/cezarion#1465: a one-time schedule starts later as an ordinary task, so the agent
+ * does not keep a session parked on timers for days. `cezar_scheduled_tasks` takes one action per
+ * call; its union is advertised as one flat object for the same reason as `cezar_wait`.
+ */
+export declare const scheduleTaskToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        $schema?: "https://json-schema.org/draft/2020-12/schema" | "http://json-schema.org/draft-07/schema#" | "http://json-schema.org/draft-04/schema#";
+        $id?: string;
+        $anchor?: string;
+        $ref?: string;
+        $dynamicRef?: string;
+        $dynamicAnchor?: string;
+        $vocabulary?: Record<string, boolean>;
+        $comment?: string;
+        $defs?: Record<string, z.core.JSONSchema.JSONSchema>;
+        additionalItems?: z.core.JSONSchema._JSONSchema;
+        unevaluatedItems?: z.core.JSONSchema._JSONSchema;
+        prefixItems?: z.core.JSONSchema._JSONSchema[];
+        items?: z.core.JSONSchema._JSONSchema | z.core.JSONSchema._JSONSchema[];
+        contains?: z.core.JSONSchema._JSONSchema;
+        additionalProperties?: z.core.JSONSchema._JSONSchema;
+        unevaluatedProperties?: z.core.JSONSchema._JSONSchema;
+        properties?: Record<string, z.core.JSONSchema._JSONSchema>;
+        patternProperties?: Record<string, z.core.JSONSchema._JSONSchema>;
+        dependentSchemas?: Record<string, z.core.JSONSchema._JSONSchema>;
+        propertyNames?: z.core.JSONSchema._JSONSchema;
+        if?: z.core.JSONSchema._JSONSchema;
+        then?: z.core.JSONSchema._JSONSchema;
+        else?: z.core.JSONSchema._JSONSchema;
+        allOf?: z.core.JSONSchema.JSONSchema[];
+        anyOf?: z.core.JSONSchema.JSONSchema[];
+        oneOf?: z.core.JSONSchema.JSONSchema[];
+        not?: z.core.JSONSchema._JSONSchema;
+        multipleOf?: number;
+        maximum?: number;
+        exclusiveMaximum?: number | boolean;
+        minimum?: number;
+        exclusiveMinimum?: number | boolean;
+        maxLength?: number;
+        minLength?: number;
+        pattern?: string;
+        maxItems?: number;
+        minItems?: number;
+        uniqueItems?: boolean;
+        maxContains?: number;
+        minContains?: number;
+        maxProperties?: number;
+        minProperties?: number;
+        required?: string[];
+        dependentRequired?: Record<string, string[]>;
+        enum?: Array<string | number | boolean | null>;
+        const?: string | number | boolean | null;
+        id?: string;
+        title?: string;
+        description?: string;
+        default?: unknown;
+        deprecated?: boolean;
+        readOnly?: boolean;
+        writeOnly?: boolean;
+        nullable?: boolean;
+        examples?: unknown[];
+        format?: string;
+        contentMediaType?: string;
+        contentEncoding?: string;
+        contentSchema?: z.core.JSONSchema.JSONSchema;
+        _prefault?: unknown;
+        "~standard": z.core.ZodStandardSchemaWithJSON<z.ZodObject<{
+            at: z.ZodOptional<z.ZodString>;
+            delay: z.ZodOptional<z.ZodString>;
+            time_zone: z.ZodOptional<z.ZodString>;
+            latest_start: z.ZodOptional<z.ZodString>;
+            workflow: z.ZodOptional<z.ZodString>;
+            runner: z.ZodOptional<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            effort: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            prompt: z.ZodString;
+            enable: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        type: 'object';
+    };
+};
+export declare const scheduledTasksToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: {
+            action: {
+                type: string;
+                enum: ("cancel" | "enable" | "list" | "pause" | "show" | "update")[];
+                description: string;
+            };
+            archived: {
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+};
+export declare function invokeScheduleTaskTool(input: unknown): Promise<{
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError: boolean;
+    details: {
+        ok: false;
+        code: "automations_off" | "conflict" | "invalid_request" | "not_found" | "unavailable";
+        message: string;
+    } | {
+        ok: true;
+        task: {
+            id: string;
+            name: string;
+            status: "archived" | "failed" | "missed" | "paused" | "waiting";
+            due_at: string;
+            time_zone: string;
+            resolved_instant: string;
+            latest_start_minutes?: number | undefined;
+            run_id?: string | undefined;
+            url?: string | undefined;
+        };
+        note: string;
+    };
+}>;
+export declare function invokeScheduledTasksTool(input: unknown): Promise<{
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError: boolean;
+    details: {
+        ok: false;
+        code: "automations_off" | "conflict" | "invalid_request" | "not_found" | "unavailable";
+        message: string;
+    } | {
+        ok: true;
+        tasks: {
+            id: string;
+            name: string;
+            status: "archived" | "failed" | "missed" | "paused" | "waiting";
+            due_at: string;
+            time_zone: string;
+            resolved_instant: string;
+            latest_start_minutes?: number | undefined;
+            run_id?: string | undefined;
+            url?: string | undefined;
+        }[];
+    } | {
+        ok: true;
+        task: {
+            id: string;
+            name: string;
+            status: "archived" | "failed" | "missed" | "paused" | "waiting";
+            due_at: string;
+            time_zone: string;
+            resolved_instant: string;
+            latest_start_minutes?: number | undefined;
+            run_id?: string | undefined;
+            url?: string | undefined;
+        };
+    };
+}>;
 export declare function cezarTools(env?: NodeJS.ProcessEnv): CezarTool[];
 export declare function cezarToolNames(env?: NodeJS.ProcessEnv): string[];
 /**
  * Env names a harness must forward to the adapter process. Several harnesses spawn MCP servers
- * from an allowlist, so the preview opt-in rides along explicitly or the adapter never sees it.
+ * from an allowlist, so the preview and automations opt-ins ride along explicitly or the adapter never sees it.
  */
 export declare function cezarToolEnvNames(env?: NodeJS.ProcessEnv): string[];
 export declare function cezarServerInstructions(env?: NodeJS.ProcessEnv): string;