@tiangong-ai/cli 0.0.61 → 0.0.62

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

@@ -0,0 +1,159 @@
+import { type InvestigationReadStore } from "./investigation-store.js";
+import { type InvestigationDefinition } from "./investigation.js";
+import { type NativeRunRecord, captureProcess } from "./native-run.js";
+import type { JournalEvent, OutputRecord, ProjectState } from "./types.js";
+export declare function investigationAttemptInputSchema(): {
+    type: string;
+    additionalProperties: boolean;
+    required: string[];
+    properties: {
+        schemaVersion: {
+            const: number;
+        };
+        investigationId: {
+            type: string;
+            pattern: string;
+        };
+        attemptId: {
+            type: string;
+            pattern: string;
+        };
+        parentAttemptId: {
+            type: string;
+            pattern: string;
+        };
+        programId: {
+            type: string;
+            pattern: string;
+        };
+        hypothesis: {
+            type: string;
+            minLength: number;
+            maxLength: number;
+        };
+        configuration: {
+            type: string;
+            maxProperties: number;
+            additionalProperties: {
+                type: string[];
+            };
+        };
+        nativeSessionId: {
+            type: string[];
+            minLength: number;
+            maxLength: number;
+        };
+        workingDirectory: {
+            type: string;
+            minLength: number;
+            maxLength: number;
+        };
+    };
+};
+interface AttemptStart {
+    schemaVersion: 1;
+    kind: "tiangong-investigation-attempt-start";
+    projectId: string;
+    investigationId: string;
+    attemptId: string;
+    definitionSha256: string;
+    requestSha256: string;
+    programId: string;
+    hypothesis: string;
+    configuration: Record<string, string | number>;
+    parentAttemptSha256: string | null;
+    changes: InvestigationChanges;
+    nativePacketSha256: string | null;
+    inputs: Array<OutputRecord & {
+        id: string;
+        artifactId: string;
+    }>;
+    timeoutSeconds: number;
+    maxCostUsd: number;
+    maxOutputBytes: number;
+    startedAt: string;
+    recordSha256: string;
+}
+type Observed = Awaited<ReturnType<typeof captureProcess>>;
+type Diagnostic = {
+    schemaVersion: 1;
+    solverReached: boolean;
+    feasible: boolean;
+    metrics: Record<string, number>;
+    statuses: Record<string, string>;
+    conclusion: string;
+};
+declare const outcomes: readonly ["harness-failure", "output-limit-exceeded", "solver-not-reached", "numerical-failure", "diagnostic-incomplete", "feasible-candidate", "stale", "inputs-changed"];
+export interface InvestigationAttempt {
+    schemaVersion: 1;
+    kind: "tiangong-investigation-attempt";
+    projectId: string;
+    investigationId: string;
+    attemptId: string;
+    startSha256: string;
+    definitionSha256: string;
+    programId: string;
+    configuration: Record<string, string | number>;
+    hypothesis: string;
+    purpose: "diagnostic-candidate-only";
+    parentAttemptSha256: string | null;
+    changes: InvestigationChanges;
+    outcome: (typeof outcomes)[number];
+    diagnostic: Diagnostic | null;
+    diagnosticTrust: "program-reported";
+    missingTelemetry: string[];
+    actualCostUsd: null;
+    accountedCostUpperBoundUsd: number;
+    process: Omit<Observed, "stdout" | "stderr">;
+    runtimeProbe: Omit<Observed, "stdout" | "stderr">;
+    runtime: NativeRunRecord["runtime"];
+    isolation: {
+        provider: string;
+        policySha256: string;
+    };
+    logs: {
+        stdout: OutputRecord;
+        stderr: OutputRecord;
+    };
+    outputs: Array<OutputRecord & {
+        id: string;
+        mediaType: string;
+    }>;
+    recordSha256: string;
+}
+export interface InvestigationChanges {
+    program: {
+        before: string | null;
+        after: string;
+    };
+    configuration: Array<{
+        id: string;
+        before: string | number | null;
+        after: string | number;
+    }>;
+}
+export declare function investigationAttemptHistory(root: string, projectId: string, definition: InvestigationDefinition, events: JournalEvent[], store?: InvestigationReadStore): Promise<{
+    start: AttemptStart;
+    record: InvestigationAttempt | null;
+}[]>;
+export declare function investigationRemaining(definition: InvestigationDefinition, attempts: Array<{
+    start: AttemptStart;
+    record: InvestigationAttempt | null;
+}>): {
+    runs: number;
+    wallSeconds: number;
+    outputBytes: number;
+    costUpperBoundUsd: number;
+};
+export declare function assertInvestigationCurrent(root: string, project: ProjectState, definition: InvestigationDefinition, events: JournalEvent[]): Promise<import("./acquisition.js").EvidenceSnapshot>;
+export declare function parseInvestigationDiagnostic(value: unknown): Diagnostic | null;
+/** Preserve an unresolved start on unexpected storage/runtime failure. */
+export declare function observeInvestigationAttempt(root: string, projectId: string, value: unknown): Promise<{
+    record: InvestigationAttempt;
+    replayed: boolean;
+} | {
+    record: InvestigationAttempt;
+    replayed: boolean;
+    stagingDirectoryName: string;
+}>;
+export {};