@gajae-code/coding-agent 0.11.6 → 0.11.8

package/dist/types/tools/ask.d.ts

@@ -30,80 +30,456 @@ export declare const askSchema: z.ZodObject<{
         }, z.core.$strip>>;
         multi: z.ZodOptional<z.ZodBoolean>;
         recommended: z.ZodOptional<z.ZodNumber>;
-        deepInterview: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
-            round_id: z.ZodOptional<z.ZodString>;
-            round: z.ZodNumber;
-            component: z.ZodString;
-            dimension: z.ZodString;
-            ambiguity: z.ZodNumber;
-            confused_terms: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            references: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                reference_id: z.ZodString;
-                label: z.ZodString;
-                origin: z.ZodString;
-                url: z.ZodOptional<z.ZodString>;
-                excerpt: z.ZodOptional<z.ZodString>;
-            }, z.core.$strict>>>;
-        }, z.core.$strict>, z.ZodObject<{
-            round_id: z.ZodOptional<z.ZodString>;
-            ambiguity: z.ZodNumber;
-            confused_terms: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            references: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                reference_id: z.ZodString;
-                label: z.ZodString;
-                origin: z.ZodString;
-                url: z.ZodOptional<z.ZodString>;
-                excerpt: z.ZodOptional<z.ZodString>;
-            }, z.core.$strict>>>;
-            round: z.ZodLiteral<0>;
-            component: z.ZodLiteral<"review-topology">;
-            dimension: z.ZodLiteral<"topology">;
-            intent_contract: z.ZodObject<{
-                items: z.ZodArray<z.ZodObject<{
-                    id: z.ZodString;
-                    category: z.ZodEnum<{
-                        artifact: "artifact";
-                        constraint: "constraint";
-                        integration: "integration";
-                        surface: "surface";
-                    }>;
-                    statement: z.ZodString;
-                }, z.core.$strict>>;
-                confirmation_options: z.ZodArray<z.ZodString>;
-            }, z.core.$strict>;
-        }, z.core.$strict>, z.ZodObject<{
-            round_id: z.ZodOptional<z.ZodString>;
-            component: z.ZodString;
-            dimension: z.ZodString;
-            ambiguity: z.ZodNumber;
-            confused_terms: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            references: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                reference_id: z.ZodString;
-                label: z.ZodString;
-                origin: z.ZodString;
-                url: z.ZodOptional<z.ZodString>;
-                excerpt: z.ZodOptional<z.ZodString>;
-            }, z.core.$strict>>>;
-            round: z.ZodNumber;
-            intent_review: z.ZodObject<{
-                observed_items: z.ZodArray<z.ZodObject<{
-                    id: z.ZodString;
-                    category: z.ZodEnum<{
-                        artifact: "artifact";
-                        constraint: "constraint";
-                        integration: "integration";
-                        surface: "surface";
-                    }>;
-                    statement: z.ZodString;
-                }, z.core.$strict>>;
-                supporting_substitutions: z.ZodArray<z.ZodObject<{
-                    removed_id: z.ZodString;
-                    replacement_ids: z.ZodArray<z.ZodString>;
-                    rationale: z.ZodString;
-                }, z.core.$strict>>;
-                approval_options: z.ZodArray<z.ZodString>;
-            }, z.core.$strict>;
-        }, z.core.$strict>]>>;
+        deepInterview: z.ZodOptional<z.ZodType<{
+            round_id?: string | undefined;
+            ambiguity: number;
+            confused_terms?: string[] | undefined;
+            references?: {
+                reference_id: string;
+                label: string;
+                origin: string;
+                url?: string | undefined;
+                excerpt?: string | undefined;
+            }[] | undefined;
+            round: 0;
+            component: "review-topology";
+            dimension: "topology";
+            intent_contract: {
+                items: {
+                    id: string;
+                    category: "artifact" | "constraint" | "integration" | "surface";
+                    statement: string;
+                }[];
+                confirmation_options: string[];
+            };
+        } | {
+            round_id?: string | undefined;
+            component: string;
+            dimension: string;
+            ambiguity: number;
+            confused_terms?: string[] | undefined;
+            references?: {
+                reference_id: string;
+                label: string;
+                origin: string;
+                url?: string | undefined;
+                excerpt?: string | undefined;
+            }[] | undefined;
+            round: number;
+        } | {
+            round_id?: string | undefined;
+            component: string;
+            dimension: string;
+            ambiguity: number;
+            confused_terms?: string[] | undefined;
+            references?: {
+                reference_id: string;
+                label: string;
+                origin: string;
+                url?: string | undefined;
+                excerpt?: string | undefined;
+            }[] | undefined;
+            round: number;
+            intent_review: {
+                observed_items: {
+                    id: string;
+                    category: "artifact" | "constraint" | "integration" | "surface";
+                    statement: string;
+                }[];
+                supporting_substitutions: {
+                    removed_id: string;
+                    replacement_ids: string[];
+                    rationale: string;
+                }[];
+                approval_options: string[];
+            };
+        }, unknown, z.core.$ZodTypeInternals<{
+            round_id?: string | undefined;
+            ambiguity: number;
+            confused_terms?: string[] | undefined;
+            references?: {
+                reference_id: string;
+                label: string;
+                origin: string;
+                url?: string | undefined;
+                excerpt?: string | undefined;
+            }[] | undefined;
+            round: 0;
+            component: "review-topology";
+            dimension: "topology";
+            intent_contract: {
+                items: {
+                    id: string;
+                    category: "artifact" | "constraint" | "integration" | "surface";
+                    statement: string;
+                }[];
+                confirmation_options: string[];
+            };
+        } | {
+            round_id?: string | undefined;
+            component: string;
+            dimension: string;
+            ambiguity: number;
+            confused_terms?: string[] | undefined;
+            references?: {
+                reference_id: string;
+                label: string;
+                origin: string;
+                url?: string | undefined;
+                excerpt?: string | undefined;
+            }[] | undefined;
+            round: number;
+        } | {
+            round_id?: string | undefined;
+            component: string;
+            dimension: string;
+            ambiguity: number;
+            confused_terms?: string[] | undefined;
+            references?: {
+                reference_id: string;
+                label: string;
+                origin: string;
+                url?: string | undefined;
+                excerpt?: string | undefined;
+            }[] | undefined;
+            round: number;
+            intent_review: {
+                observed_items: {
+                    id: string;
+                    category: "artifact" | "constraint" | "integration" | "surface";
+                    statement: string;
+                }[];
+                supporting_substitutions: {
+                    removed_id: string;
+                    replacement_ids: string[];
+                    rationale: string;
+                }[];
+                approval_options: string[];
+            };
+        }, unknown>>>;
+        workflowGate: z.ZodOptional<z.ZodObject<{
+            stage: z.ZodEnum<{
+                "deep-interview": "deep-interview";
+                ralplan: "ralplan";
+                ultragoal: "ultragoal";
+            }>;
+            kind: z.ZodEnum<{
+                approval: "approval";
+                execution: "execution";
+                question: "question";
+            }>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const topologyAskSchema: z.ZodObject<{
+    questions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        question: z.ZodString;
+        options: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+        }, z.core.$strip>>;
+        multi: z.ZodOptional<z.ZodBoolean>;
+        recommended: z.ZodOptional<z.ZodNumber>;
+        deepInterview: z.ZodOptional<z.ZodType<{
+            round_id?: string | undefined;
+            ambiguity: number;
+            confused_terms?: string[] | undefined;
+            references?: {
+                reference_id: string;
+                label: string;
+                origin: string;
+                url?: string | undefined;
+                excerpt?: string | undefined;
+            }[] | undefined;
+            round: 0;
+            component: "review-topology";
+            dimension: "topology";
+            intent_contract: {
+                items: {
+                    id: string;
+                    category: "artifact" | "constraint" | "integration" | "surface";
+                    statement: string;
+                }[];
+                confirmation_options: string[];
+            };
+        } | {
+            round_id?: string | undefined;
+            component: string;
+            dimension: string;
+            ambiguity: number;
+            confused_terms?: string[] | undefined;
+            references?: {
+                reference_id: string;
+                label: string;
+                origin: string;
+                url?: string | undefined;
+                excerpt?: string | undefined;
+            }[] | undefined;
+            round: number;
+        } | {
+            round_id?: string | undefined;
+            component: string;
+            dimension: string;
+            ambiguity: number;
+            confused_terms?: string[] | undefined;
+            references?: {
+                reference_id: string;
+                label: string;
+                origin: string;
+                url?: string | undefined;
+                excerpt?: string | undefined;
+            }[] | undefined;
+            round: number;
+            intent_review: {
+                observed_items: {
+                    id: string;
+                    category: "artifact" | "constraint" | "integration" | "surface";
+                    statement: string;
+                }[];
+                supporting_substitutions: {
+                    removed_id: string;
+                    replacement_ids: string[];
+                    rationale: string;
+                }[];
+                approval_options: string[];
+            };
+        }, unknown, z.core.$ZodTypeInternals<{
+            round_id?: string | undefined;
+            ambiguity: number;
+            confused_terms?: string[] | undefined;
+            references?: {
+                reference_id: string;
+                label: string;
+                origin: string;
+                url?: string | undefined;
+                excerpt?: string | undefined;
+            }[] | undefined;
+            round: 0;
+            component: "review-topology";
+            dimension: "topology";
+            intent_contract: {
+                items: {
+                    id: string;
+                    category: "artifact" | "constraint" | "integration" | "surface";
+                    statement: string;
+                }[];
+                confirmation_options: string[];
+            };
+        } | {
+            round_id?: string | undefined;
+            component: string;
+            dimension: string;
+            ambiguity: number;
+            confused_terms?: string[] | undefined;
+            references?: {
+                reference_id: string;
+                label: string;
+                origin: string;
+                url?: string | undefined;
+                excerpt?: string | undefined;
+            }[] | undefined;
+            round: number;
+        } | {
+            round_id?: string | undefined;
+            component: string;
+            dimension: string;
+            ambiguity: number;
+            confused_terms?: string[] | undefined;
+            references?: {
+                reference_id: string;
+                label: string;
+                origin: string;
+                url?: string | undefined;
+                excerpt?: string | undefined;
+            }[] | undefined;
+            round: number;
+            intent_review: {
+                observed_items: {
+                    id: string;
+                    category: "artifact" | "constraint" | "integration" | "surface";
+                    statement: string;
+                }[];
+                supporting_substitutions: {
+                    removed_id: string;
+                    replacement_ids: string[];
+                    rationale: string;
+                }[];
+                approval_options: string[];
+            };
+        }, unknown>>>;
+        workflowGate: z.ZodOptional<z.ZodObject<{
+            stage: z.ZodEnum<{
+                "deep-interview": "deep-interview";
+                ralplan: "ralplan";
+                ultragoal: "ultragoal";
+            }>;
+            kind: z.ZodEnum<{
+                approval: "approval";
+                execution: "execution";
+                question: "question";
+            }>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const postTopologyAskSchema: z.ZodObject<{
+    questions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        question: z.ZodString;
+        options: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+        }, z.core.$strip>>;
+        multi: z.ZodOptional<z.ZodBoolean>;
+        recommended: z.ZodOptional<z.ZodNumber>;
+        deepInterview: z.ZodOptional<z.ZodType<{
+            round_id?: string | undefined;
+            ambiguity: number;
+            confused_terms?: string[] | undefined;
+            references?: {
+                reference_id: string;
+                label: string;
+                origin: string;
+                url?: string | undefined;
+                excerpt?: string | undefined;
+            }[] | undefined;
+            round: 0;
+            component: "review-topology";
+            dimension: "topology";
+            intent_contract: {
+                items: {
+                    id: string;
+                    category: "artifact" | "constraint" | "integration" | "surface";
+                    statement: string;
+                }[];
+                confirmation_options: string[];
+            };
+        } | {
+            round_id?: string | undefined;
+            component: string;
+            dimension: string;
+            ambiguity: number;
+            confused_terms?: string[] | undefined;
+            references?: {
+                reference_id: string;
+                label: string;
+                origin: string;
+                url?: string | undefined;
+                excerpt?: string | undefined;
+            }[] | undefined;
+            round: number;
+        } | {
+            round_id?: string | undefined;
+            component: string;
+            dimension: string;
+            ambiguity: number;
+            confused_terms?: string[] | undefined;
+            references?: {
+                reference_id: string;
+                label: string;
+                origin: string;
+                url?: string | undefined;
+                excerpt?: string | undefined;
+            }[] | undefined;
+            round: number;
+            intent_review: {
+                observed_items: {
+                    id: string;
+                    category: "artifact" | "constraint" | "integration" | "surface";
+                    statement: string;
+                }[];
+                supporting_substitutions: {
+                    removed_id: string;
+                    replacement_ids: string[];
+                    rationale: string;
+                }[];
+                approval_options: string[];
+            };
+        }, unknown, z.core.$ZodTypeInternals<{
+            round_id?: string | undefined;
+            ambiguity: number;
+            confused_terms?: string[] | undefined;
+            references?: {
+                reference_id: string;
+                label: string;
+                origin: string;
+                url?: string | undefined;
+                excerpt?: string | undefined;
+            }[] | undefined;
+            round: 0;
+            component: "review-topology";
+            dimension: "topology";
+            intent_contract: {
+                items: {
+                    id: string;
+                    category: "artifact" | "constraint" | "integration" | "surface";
+                    statement: string;
+                }[];
+                confirmation_options: string[];
+            };
+        } | {
+            round_id?: string | undefined;
+            component: string;
+            dimension: string;
+            ambiguity: number;
+            confused_terms?: string[] | undefined;
+            references?: {
+                reference_id: string;
+                label: string;
+                origin: string;
+                url?: string | undefined;
+                excerpt?: string | undefined;
+            }[] | undefined;
+            round: number;
+        } | {
+            round_id?: string | undefined;
+            component: string;
+            dimension: string;
+            ambiguity: number;
+            confused_terms?: string[] | undefined;
+            references?: {
+                reference_id: string;
+                label: string;
+                origin: string;
+                url?: string | undefined;
+                excerpt?: string | undefined;
+            }[] | undefined;
+            round: number;
+            intent_review: {
+                observed_items: {
+                    id: string;
+                    category: "artifact" | "constraint" | "integration" | "surface";
+                    statement: string;
+                }[];
+                supporting_substitutions: {
+                    removed_id: string;
+                    replacement_ids: string[];
+                    rationale: string;
+                }[];
+                approval_options: string[];
+            };
+        }, unknown>>>;
+        workflowGate: z.ZodOptional<z.ZodObject<{
+            stage: z.ZodEnum<{
+                "deep-interview": "deep-interview";
+                ralplan: "ralplan";
+                ultragoal: "ultragoal";
+            }>;
+            kind: z.ZodEnum<{
+                approval: "approval";
+                execution: "execution";
+                question: "question";
+            }>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const ordinaryAskSchema: z.ZodObject<{
+    questions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        question: z.ZodString;
+        options: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+        }, z.core.$strip>>;
+        multi: z.ZodOptional<z.ZodBoolean>;
+        recommended: z.ZodOptional<z.ZodNumber>;
         workflowGate: z.ZodOptional<z.ZodObject<{
             stage: z.ZodEnum<{
                 "deep-interview": "deep-interview";
@@ -119,7 +495,6 @@ export declare const askSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type AskToolInput = z.infer<typeof askSchema>;
-declare function recoverRoundZeroIntentContract(arguments_: Record<string, unknown>): RawArgumentValidationResult;
 /** Result for a single question */
 export interface QuestionResult {
     id: string;
@@ -165,117 +540,22 @@ export declare function legacyAskReceipt(value: string): {
     settle(settlement: AskSettlement): Promise<AskSettlementResult>;
 };
 type AskParams = AskToolInput;
+type AskParametersSchema = typeof ordinaryAskSchema | typeof askSchema | typeof topologyAskSchema | typeof postTopologyAskSchema;
 /**
  * Ask tool for interactive user prompting during execution.
  *
  * Allows gathering user preferences, clarifying instructions, and getting decisions
  * on implementation choices as the agent works.
  */
-export declare class AskTool implements AgentTool<typeof askSchema, AskToolDetails> {
+export declare class AskTool implements AgentTool<AskParametersSchema, AskToolDetails> {
     #private;
     private readonly session;
     readonly name = "ask";
     readonly label = "Ask";
     readonly summary = "Ask the user a clarifying question";
     readonly description: string;
-    readonly parameters: z.ZodObject<{
-        questions: z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
-            question: z.ZodString;
-            options: z.ZodArray<z.ZodObject<{
-                label: z.ZodString;
-            }, z.core.$strip>>;
-            multi: z.ZodOptional<z.ZodBoolean>;
-            recommended: z.ZodOptional<z.ZodNumber>;
-            deepInterview: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
-                round_id: z.ZodOptional<z.ZodString>;
-                round: z.ZodNumber;
-                component: z.ZodString;
-                dimension: z.ZodString;
-                ambiguity: z.ZodNumber;
-                confused_terms: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                references: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                    reference_id: z.ZodString;
-                    label: z.ZodString;
-                    origin: z.ZodString;
-                    url: z.ZodOptional<z.ZodString>;
-                    excerpt: z.ZodOptional<z.ZodString>;
-                }, z.core.$strict>>>;
-            }, z.core.$strict>, z.ZodObject<{
-                round_id: z.ZodOptional<z.ZodString>;
-                ambiguity: z.ZodNumber;
-                confused_terms: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                references: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                    reference_id: z.ZodString;
-                    label: z.ZodString;
-                    origin: z.ZodString;
-                    url: z.ZodOptional<z.ZodString>;
-                    excerpt: z.ZodOptional<z.ZodString>;
-                }, z.core.$strict>>>;
-                round: z.ZodLiteral<0>;
-                component: z.ZodLiteral<"review-topology">;
-                dimension: z.ZodLiteral<"topology">;
-                intent_contract: z.ZodObject<{
-                    items: z.ZodArray<z.ZodObject<{
-                        id: z.ZodString;
-                        category: z.ZodEnum<{
-                            artifact: "artifact";
-                            constraint: "constraint";
-                            integration: "integration";
-                            surface: "surface";
-                        }>;
-                        statement: z.ZodString;
-                    }, z.core.$strict>>;
-                    confirmation_options: z.ZodArray<z.ZodString>;
-                }, z.core.$strict>;
-            }, z.core.$strict>, z.ZodObject<{
-                round_id: z.ZodOptional<z.ZodString>;
-                component: z.ZodString;
-                dimension: z.ZodString;
-                ambiguity: z.ZodNumber;
-                confused_terms: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                references: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                    reference_id: z.ZodString;
-                    label: z.ZodString;
-                    origin: z.ZodString;
-                    url: z.ZodOptional<z.ZodString>;
-                    excerpt: z.ZodOptional<z.ZodString>;
-                }, z.core.$strict>>>;
-                round: z.ZodNumber;
-                intent_review: z.ZodObject<{
-                    observed_items: z.ZodArray<z.ZodObject<{
-                        id: z.ZodString;
-                        category: z.ZodEnum<{
-                            artifact: "artifact";
-                            constraint: "constraint";
-                            integration: "integration";
-                            surface: "surface";
-                        }>;
-                        statement: z.ZodString;
-                    }, z.core.$strict>>;
-                    supporting_substitutions: z.ZodArray<z.ZodObject<{
-                        removed_id: z.ZodString;
-                        replacement_ids: z.ZodArray<z.ZodString>;
-                        rationale: z.ZodString;
-                    }, z.core.$strict>>;
-                    approval_options: z.ZodArray<z.ZodString>;
-                }, z.core.$strict>;
-            }, z.core.$strict>]>>;
-            workflowGate: z.ZodOptional<z.ZodObject<{
-                stage: z.ZodEnum<{
-                    "deep-interview": "deep-interview";
-                    ralplan: "ralplan";
-                    ultragoal: "ultragoal";
-                }>;
-                kind: z.ZodEnum<{
-                    approval: "approval";
-                    execution: "execution";
-                    question: "question";
-                }>;
-            }, z.core.$strip>>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>;
-    readonly rawArgumentValidation: typeof recoverRoundZeroIntentContract;
+    get parameters(): AskParametersSchema;
+    readonly rawArgumentValidation: (arguments_: Record<string, unknown>) => RawArgumentValidationResult;
     readonly strict = true;
     readonly loadMode = "discoverable";
     constructor(session: ToolSession);

package/dist/types/tools/fetch.d.ts

@@ -14,6 +14,11 @@ export interface ParsedReadUrlTarget {
     limit?: number;
 }
 export declare function parseReadUrlTarget(readPath: string): ParsedReadUrlTarget | null;
+export declare function renderHtmlToText(html: string, signal?: AbortSignal): Promise<{
+    content: string;
+    ok: boolean;
+    method: string;
+}>;
 interface FetchImagePayload {
     data: string;
     mimeType: string;
@@ -21,14 +26,6 @@ interface FetchImagePayload {
 type FetchRenderResult = RenderResult & {
     image?: FetchImagePayload;
 };
-/**
- * Opt-in insane-search fallback for blocked / degraded public URL reads.
- *
- * Returns a finalized `method: "insane"` result on success, or null (so the
- * caller continues with its normal degraded behavior). Fail-closed: no note,
- * guard DNS, dependency probe, or subprocess when raw mode or the opt-in
- * setting is off. The public-URL guard runs BEFORE any probe/spawn.
- */
 export declare function tryInsaneFallback(args: {
     url: string;
     finalUrl: string;