@tiangong-ai/cli 0.0.60 → 0.0.62

package/dist/research/workspace/investigation.d.ts

@@ -0,0 +1,424 @@
+import { type InvestigationReadStore } from "./investigation-store.js";
+import type { JournalEvent, OutputRecord } from "./types.js";
+type Option = {
+    id: string;
+    kind: "number" | "integer";
+    minimum: number;
+    maximum: number;
+} | {
+    id: string;
+    kind: "enum";
+    values: string[];
+};
+export declare function investigationInputSchema(): {
+    type: string;
+    additionalProperties: boolean;
+    required: string[];
+    properties: {
+        schemaVersion: {
+            const: number;
+        };
+        investigationId: {
+            type: string;
+            pattern: string;
+        };
+        requirementId: {
+            type: string;
+            pattern: string;
+        };
+        requirementSha256: {
+            type: string;
+            pattern: string;
+        };
+        objective: {
+            type: string;
+            minLength: number;
+            maxLength: number;
+        };
+        canonicalInputs: {
+            type: string;
+            minItems: number;
+            maxItems: number;
+            items: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    id: {
+                        type: string;
+                        pattern: string;
+                    };
+                    artifactId: {
+                        type: string;
+                        pattern: string;
+                    };
+                    sha256: {
+                        type: string;
+                        pattern: string;
+                    };
+                };
+            };
+        };
+        programs: {
+            type: string;
+            minItems: number;
+            maxItems: number;
+            items: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    id: {
+                        type: string;
+                        pattern: string;
+                    };
+                    runtime: {
+                        type: string;
+                        additionalProperties: boolean;
+                        required: string[];
+                        properties: {
+                            kind: {
+                                enum: string[];
+                            };
+                            path: {
+                                type: string;
+                                minLength: number;
+                                maxLength: number;
+                            };
+                        };
+                    };
+                    scriptPath: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                    environmentLockPath: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                    arguments: {
+                        type: string;
+                        maxItems: number;
+                        items: {
+                            type: string;
+                            minLength: number;
+                            maxLength: number;
+                        };
+                    };
+                    outputs: {
+                        type: string;
+                        minItems: number;
+                        maxItems: number;
+                        items: {
+                            type: string;
+                            additionalProperties: boolean;
+                            required: string[];
+                            properties: {
+                                id: {
+                                    type: string;
+                                    pattern: string;
+                                };
+                                fileName: {
+                                    type: string;
+                                    pattern: string;
+                                };
+                                mediaType: {
+                                    type: string;
+                                    pattern: string;
+                                };
+                            };
+                        };
+                    };
+                    diagnosticOutputId: {
+                        type: string;
+                        pattern: string;
+                    };
+                    telemetry: {
+                        type: string;
+                        additionalProperties: boolean;
+                        required: string[];
+                        properties: {
+                            requiredMetrics: {
+                                type: string;
+                                maxItems: number;
+                                uniqueItems: boolean;
+                                items: {
+                                    type: string;
+                                    pattern: string;
+                                };
+                            };
+                            requiredStatuses: {
+                                type: string;
+                                maxItems: number;
+                                uniqueItems: boolean;
+                                items: {
+                                    type: string;
+                                    pattern: string;
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        options: {
+            type: string;
+            maxItems: number;
+            items: {
+                oneOf: ({
+                    type: string;
+                    additionalProperties: boolean;
+                    required: string[];
+                    properties: {
+                        id: {
+                            type: string;
+                            pattern: string;
+                        };
+                        kind: {
+                            enum: string[];
+                            const?: never;
+                        };
+                        minimum: {
+                            type: string;
+                        };
+                        maximum: {
+                            type: string;
+                        };
+                        values?: never;
+                    };
+                } | {
+                    type: string;
+                    additionalProperties: boolean;
+                    required: string[];
+                    properties: {
+                        minimum?: never;
+                        maximum?: never;
+                        id: {
+                            type: string;
+                            pattern: string;
+                        };
+                        kind: {
+                            enum?: never;
+                            const: string;
+                        };
+                        values: {
+                            type: string;
+                            minItems: number;
+                            maxItems: number;
+                            uniqueItems: boolean;
+                            items: {
+                                type: string;
+                                minLength: number;
+                                maxLength: number;
+                            };
+                        };
+                    };
+                })[];
+            };
+        };
+        limits: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                maxRuns: {
+                    type: string;
+                    minimum: number;
+                    maximum: number;
+                };
+                maxWallSeconds: {
+                    type: string;
+                    minimum: number;
+                    maximum: number;
+                };
+                maxRunSeconds: {
+                    type: string;
+                    minimum: number;
+                    maximum: number;
+                };
+                maxCostUsd: {
+                    type: string;
+                    minimum: number;
+                };
+                maxRunCostUsd: {
+                    type: string;
+                    minimum: number;
+                };
+                maxOutputBytes: {
+                    type: string;
+                    minimum: number;
+                    maximum: number;
+                };
+                maxTotalOutputBytes: {
+                    type: string;
+                    minimum: number;
+                    maximum: number;
+                };
+            };
+        };
+        deniedEffects: {
+            type: string;
+            minItems: number;
+            maxItems: number;
+            uniqueItems: boolean;
+            items: {
+                enum: string[];
+            };
+        };
+    };
+};
+export declare function planInvestigation(root: string, projectId: string, value: unknown): Promise<{
+    schemaVersion: 1;
+    kind: "tiangong-investigation-plan";
+    projectId: string;
+    investigationId: string;
+    requestSha256: string;
+    requirementId: string;
+    requirementSha256: string;
+    questionSha256: string;
+    designSha256: string | null;
+    effectiveDesignSha256: string | null;
+    policySha256: string | null;
+    acquisitionSnapshotSha256: string;
+    objective: string;
+    canonicalInputs: {
+        id: string;
+        artifactId: string;
+        sha256: string;
+    }[];
+    programs: {
+        id: string;
+        runtime: {
+            kind: "node" | "python";
+            binarySha256: string;
+            pathSha256: string;
+        };
+        scriptSha256: string;
+        environmentLockSha256: string;
+        arguments: string[];
+        outputs: {
+            id: string;
+            fileName: string;
+            mediaType: string;
+        }[];
+        diagnosticOutputId: string;
+        telemetry: {
+            requiredMetrics: string[];
+            requiredStatuses: string[];
+        };
+    }[];
+    options: Option[];
+    limits: {
+        maxRuns: number;
+        maxWallSeconds: number;
+        maxRunSeconds: number;
+        maxCostUsd: number;
+        maxRunCostUsd: number;
+        maxOutputBytes: number;
+        maxTotalOutputBytes: number;
+    };
+    deniedEffects: string[];
+    needsProjectBudget: boolean;
+    purpose: "diagnostic-candidate-only";
+    planSha256: string;
+}>;
+export type InvestigationPlan = Awaited<ReturnType<typeof planInvestigation>>;
+export interface InvestigationDefinition {
+    schemaVersion: 1;
+    kind: "tiangong-investigation";
+    projectId: string;
+    investigationId: string;
+    plan: InvestigationPlan;
+    programs: Array<{
+        id: string;
+        script: OutputRecord;
+        environmentLock: OutputRecord;
+    }>;
+    scopeAuthorization: {
+        kind: "operator-confirmation";
+        planSha256: string;
+        sourceSha256: string;
+        source: OutputRecord;
+    };
+    routingSha256: string;
+    approvedAt: string;
+    recordSha256: string;
+}
+export declare function loadInvestigation(root: string, projectId: string, id: string, knownEvents?: JournalEvent[], store?: InvestigationReadStore): Promise<InvestigationDefinition>;
+export declare function approveInvestigation(root: string, projectId: string, value: unknown, confirmation: string | undefined, sourcePath: string | undefined): Promise<InvestigationDefinition>;
+export declare function inspectInvestigation(root: string, projectId: string, id: string): Promise<{
+    projectId: string;
+    investigationId: string;
+    definitionSha256: string;
+    authority: {
+        state: "authoritative" | "superseded" | "archived" | "abandoned" | "invalid";
+        projectId: string;
+    };
+    status: string;
+    remaining: {
+        runs: number;
+        wallSeconds: number;
+        outputBytes: number;
+        costUpperBoundUsd: number;
+    };
+    availableRunSeconds: number;
+    projectWallReservations: {
+        wallSeconds: number;
+        reservations: {
+            kind: "investigation-attempt" | "certification";
+            id: string;
+            wallSeconds: number;
+        }[];
+    };
+    authorizationValid: boolean;
+    scopeReason: string | null;
+    allowedNextAction: string;
+    candidate: {
+        recordSha256: string;
+        attemptSha256: string;
+        recipeSha256: string;
+        certification: string;
+    } | null;
+    promotions: {
+        projectId: string;
+        recordSha256: string;
+        runId: string | null;
+        runSha256: string | null;
+        certification: "not-started" | "incomplete" | "failed" | "passed";
+        scopeCurrent: boolean;
+        frozen: boolean;
+        observer?: Awaited<ReturnType<typeof import("./investigation-observer.js").inspectInvestigationObserver>>;
+    }[];
+    closure: import("./investigation-close.js").InvestigationClosure | null;
+    actualCostUsd: null;
+    attempts: {
+        attemptId: string;
+        startSha256: string;
+        recordSha256: string | null;
+        outcome: string;
+        hypothesis: string;
+        configuration: Record<string, string | number>;
+        parentAttemptSha256: string | null;
+        changes: import("./investigation-attempt.js").InvestigationChanges;
+        observer?: {
+            state: string;
+            localRoute: string;
+            automaticRetry: boolean;
+            supervisorPid?: never;
+            phase?: never;
+            stagingDirectoryName?: never;
+        } | {
+            state: string;
+            supervisorPid: number;
+            phase: "calculation" | "runtime-probe";
+            stagingDirectoryName: string;
+            localRoute: string;
+            automaticRetry: boolean;
+        } | undefined;
+        conclusion: string;
+    }[];
+    executionBoundary: string;
+    purpose: "diagnostic-candidate-only";
+}>;
+export {};