tracegrove 0.0.0-stage → 0.3.0

package/dist/core/lookup.d.ts

@@ -0,0 +1,662 @@
+import { type Ref } from '../protocol/index.ts';
+import type { LoadedProject } from './corpus.ts';
+export type CaseQuery = {
+    id?: string;
+    workflow?: string;
+    surface?: string;
+    text?: string;
+    limit?: number;
+    cursor?: string;
+};
+export declare function searchCases(project: LoadedProject, query?: CaseQuery): {
+    snapshot: {
+        id: string;
+        revision: string;
+        digest: {
+            algorithm: "sha256";
+            hex: string;
+        };
+    };
+    results: {
+        ref: {
+            id: string;
+            revision: string;
+            digest: {
+                algorithm: "sha256";
+                hex: string;
+            };
+        };
+        workflowId: string;
+        surface: "ui" | "api" | "job" | "integration" | "hybrid";
+        purpose: string;
+        sourcePath: string;
+        requiredCapabilities: string[];
+        compatibility: string;
+        state: string;
+        review: string;
+    }[];
+    total: number;
+    cursor: string | null;
+};
+export declare function getCase(project: LoadedProject, ref: Ref, maxBytes?: number): {
+    snapshot: {
+        id: string;
+        revision: string;
+        digest: {
+            algorithm: "sha256";
+            hex: string;
+        };
+    };
+    sourcePath: string;
+    spec: {
+        purpose: string;
+        workflowId: string;
+        requirementRefs: {
+            id: string;
+            revision: string;
+            digest: {
+                algorithm: "sha256";
+                hex: string;
+            };
+        }[];
+        sourceRefs: {
+            id: string;
+            revision: string;
+            digest: {
+                algorithm: "sha256";
+                hex: string;
+            };
+        }[];
+        sourceAnalysisRef: {
+            id: string;
+            revision: string;
+            digest: {
+                algorithm: "sha256";
+                hex: string;
+            };
+        } | null;
+        risk: "critical" | "standard" | "exploratory";
+        surface: "ui" | "api" | "job" | "integration" | "hybrid";
+        surfaceBindingRef: {
+            id: string;
+            revision: string;
+            digest: {
+                algorithm: "sha256";
+                hex: string;
+            };
+        };
+        proofClaim: string;
+        environmentClasses: ("isolated_candidate" | "deployed_preview" | "deployed_canary" | "production_observation")[];
+        requiredCapabilities: string[];
+        requiredBoundaries: {
+            boundaryId: string;
+            mode: "real" | "stubbed" | "recorded_replay" | "synthetic_runtime";
+        }[];
+        dependencyCases: {
+            id: string;
+            revision: string;
+            digest: {
+                algorithm: "sha256";
+                hex: string;
+            };
+        }[];
+        personaRef: {
+            id: string;
+            revision: string;
+            digest: {
+                algorithm: "sha256";
+                hex: string;
+            };
+        };
+        datasetRef: {
+            id: string;
+            revision: string;
+            digest: {
+                algorithm: "sha256";
+                hex: string;
+            };
+        } | null;
+        fixturePlanRef: {
+            id: string;
+            revision: string;
+            digest: {
+                algorithm: "sha256";
+                hex: string;
+            };
+        } | null;
+        navigationRef: {
+            id: string;
+            revision: string;
+            digest: {
+                algorithm: "sha256";
+                hex: string;
+            };
+        } | null;
+        preconditions: {
+            id: string;
+            required: boolean;
+            environmentClasses: ("isolated_candidate" | "deployed_preview" | "deployed_canary" | "production_observation")[];
+            oracle: {
+                name: "http.observation" | "browser.observation" | "job.observation" | "mcp.observation" | "step.result";
+                version: "1";
+            };
+            stepId: string;
+            predicate: import("../protocol/index.ts").PredicateT;
+            coverageTags: string[];
+        }[];
+        steps: ({
+            kind: "http.request";
+            method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD";
+            path: string;
+            headers: Record<string, string>;
+            body: unknown;
+            auth: {
+                kind: "none";
+            } | {
+                kind: "persona";
+            } | {
+                kind: "credential";
+                name: string;
+            };
+            expectStatus: number | null;
+            captures: {
+                name: string;
+                from: "status" | "json" | "header";
+                path: string | null;
+            }[];
+            id: string;
+            timeoutMs: number;
+            inputs: Record<string, {
+                kind: "literal";
+                value: unknown;
+            } | {
+                kind: "fixture";
+                entityKey: string;
+                outputName: string;
+            } | {
+                kind: "capture";
+                stepId: string;
+                name: string;
+            } | {
+                kind: "credential";
+                name: string;
+            } | {
+                kind: "runtime";
+                name: "execution_nonce" | "lease_namespace" | "target_origin";
+            }>;
+            retry: {
+                attempts: number;
+            };
+        } | {
+            kind: "observe";
+            readback: {
+                kind: "http";
+                method: "GET" | "HEAD";
+                path: string;
+                auth: {
+                    kind: "none";
+                } | {
+                    kind: "persona";
+                } | {
+                    kind: "credential";
+                    name: string;
+                };
+            };
+            predicate: import("../protocol/index.ts").PredicateT;
+            pollIntervalMs: number;
+            captures: {
+                name: string;
+                from: "status" | "json" | "header";
+                path: string | null;
+            }[];
+            id: string;
+            timeoutMs: number;
+            inputs: Record<string, {
+                kind: "literal";
+                value: unknown;
+            } | {
+                kind: "fixture";
+                entityKey: string;
+                outputName: string;
+            } | {
+                kind: "capture";
+                stepId: string;
+                name: string;
+            } | {
+                kind: "credential";
+                name: string;
+            } | {
+                kind: "runtime";
+                name: "execution_nonce" | "lease_namespace" | "target_origin";
+            }>;
+            retry: {
+                attempts: number;
+            };
+        } | {
+            kind: "integration.action" | "widget.action" | "native.action" | "computer.action";
+            parameters: Record<string, unknown>;
+            id: string;
+            timeoutMs: number;
+            inputs: Record<string, {
+                kind: "literal";
+                value: unknown;
+            } | {
+                kind: "fixture";
+                entityKey: string;
+                outputName: string;
+            } | {
+                kind: "capture";
+                stepId: string;
+                name: string;
+            } | {
+                kind: "credential";
+                name: string;
+            } | {
+                kind: "runtime";
+                name: "execution_nonce" | "lease_namespace" | "target_origin";
+            }>;
+            retry: {
+                attempts: number;
+            };
+        } | {
+            kind: "ui.navigate";
+            path: string;
+            id: string;
+            timeoutMs: number;
+            inputs: Record<string, {
+                kind: "literal";
+                value: unknown;
+            } | {
+                kind: "fixture";
+                entityKey: string;
+                outputName: string;
+            } | {
+                kind: "capture";
+                stepId: string;
+                name: string;
+            } | {
+                kind: "credential";
+                name: string;
+            } | {
+                kind: "runtime";
+                name: "execution_nonce" | "lease_namespace" | "target_origin";
+            }>;
+            retry: {
+                attempts: number;
+            };
+        } | {
+            kind: "ui.action";
+            command: {
+                kind: "click";
+                target: {
+                    by: "role";
+                    role: "status" | "link" | "button" | "textbox" | "checkbox" | "heading";
+                    name: string;
+                } | {
+                    by: "label";
+                    name: string;
+                } | {
+                    by: "testId";
+                    name: string;
+                };
+            } | {
+                kind: "fill";
+                target: {
+                    by: "role";
+                    role: "status" | "link" | "button" | "textbox" | "checkbox" | "heading";
+                    name: string;
+                } | {
+                    by: "label";
+                    name: string;
+                } | {
+                    by: "testId";
+                    name: string;
+                };
+                value: string;
+            };
+            id: string;
+            timeoutMs: number;
+            inputs: Record<string, {
+                kind: "literal";
+                value: unknown;
+            } | {
+                kind: "fixture";
+                entityKey: string;
+                outputName: string;
+            } | {
+                kind: "capture";
+                stepId: string;
+                name: string;
+            } | {
+                kind: "credential";
+                name: string;
+            } | {
+                kind: "runtime";
+                name: "execution_nonce" | "lease_namespace" | "target_origin";
+            }>;
+            retry: {
+                attempts: number;
+            };
+        } | {
+            kind: "ui.observe";
+            target: {
+                by: "role";
+                role: "status" | "link" | "button" | "textbox" | "checkbox" | "heading";
+                name: string;
+            } | {
+                by: "label";
+                name: string;
+            } | {
+                by: "testId";
+                name: string;
+            };
+            predicate: import("../protocol/index.ts").PredicateT;
+            pollIntervalMs: number;
+            id: string;
+            timeoutMs: number;
+            inputs: Record<string, {
+                kind: "literal";
+                value: unknown;
+            } | {
+                kind: "fixture";
+                entityKey: string;
+                outputName: string;
+            } | {
+                kind: "capture";
+                stepId: string;
+                name: string;
+            } | {
+                kind: "credential";
+                name: string;
+            } | {
+                kind: "runtime";
+                name: "execution_nonce" | "lease_namespace" | "target_origin";
+            }>;
+            retry: {
+                attempts: number;
+            };
+        } | {
+            kind: "job.submit";
+            command: {
+                action: "submit";
+                queue: string;
+                requestKey: string;
+                payload: unknown;
+            };
+            auth: {
+                kind: "none";
+            } | {
+                kind: "persona";
+            } | {
+                kind: "credential";
+                name: string;
+            };
+            captures: {
+                name: string;
+                path: string | null;
+                from: "json";
+            }[];
+            id: string;
+            timeoutMs: number;
+            inputs: Record<string, {
+                kind: "literal";
+                value: unknown;
+            } | {
+                kind: "fixture";
+                entityKey: string;
+                outputName: string;
+            } | {
+                kind: "capture";
+                stepId: string;
+                name: string;
+            } | {
+                kind: "credential";
+                name: string;
+            } | {
+                kind: "runtime";
+                name: "execution_nonce" | "lease_namespace" | "target_origin";
+            }>;
+            retry: {
+                attempts: number;
+            };
+        } | {
+            kind: "job.observe";
+            command: {
+                action: "read";
+                queue: string;
+                jobId: string;
+            };
+            predicate: import("../protocol/index.ts").PredicateT;
+            pollIntervalMs: number;
+            auth: {
+                kind: "none";
+            } | {
+                kind: "persona";
+            } | {
+                kind: "credential";
+                name: string;
+            };
+            captures: {
+                name: string;
+                path: string | null;
+                from: "json";
+            }[];
+            id: string;
+            timeoutMs: number;
+            inputs: Record<string, {
+                kind: "literal";
+                value: unknown;
+            } | {
+                kind: "fixture";
+                entityKey: string;
+                outputName: string;
+            } | {
+                kind: "capture";
+                stepId: string;
+                name: string;
+            } | {
+                kind: "credential";
+                name: string;
+            } | {
+                kind: "runtime";
+                name: "execution_nonce" | "lease_namespace" | "target_origin";
+            }>;
+            retry: {
+                attempts: number;
+            };
+        } | {
+            kind: "job.cancel";
+            command: {
+                action: "cancel";
+                queue: string;
+                jobId: string;
+            };
+            auth: {
+                kind: "none";
+            } | {
+                kind: "persona";
+            } | {
+                kind: "credential";
+                name: string;
+            };
+            captures: {
+                name: string;
+                path: string | null;
+                from: "json";
+            }[];
+            id: string;
+            timeoutMs: number;
+            inputs: Record<string, {
+                kind: "literal";
+                value: unknown;
+            } | {
+                kind: "fixture";
+                entityKey: string;
+                outputName: string;
+            } | {
+                kind: "capture";
+                stepId: string;
+                name: string;
+            } | {
+                kind: "credential";
+                name: string;
+            } | {
+                kind: "runtime";
+                name: "execution_nonce" | "lease_namespace" | "target_origin";
+            }>;
+            retry: {
+                attempts: number;
+            };
+        } | {
+            kind: "mcp.call";
+            command: {
+                endpoint: string;
+                tool: string;
+                arguments: Record<string, unknown>;
+            };
+            auth: {
+                kind: "none";
+            } | {
+                kind: "persona";
+            } | {
+                kind: "credential";
+                name: string;
+            };
+            captures: {
+                name: string;
+                path: string | null;
+                from: "json";
+            }[];
+            id: string;
+            timeoutMs: number;
+            inputs: Record<string, {
+                kind: "literal";
+                value: unknown;
+            } | {
+                kind: "fixture";
+                entityKey: string;
+                outputName: string;
+            } | {
+                kind: "capture";
+                stepId: string;
+                name: string;
+            } | {
+                kind: "credential";
+                name: string;
+            } | {
+                kind: "runtime";
+                name: "execution_nonce" | "lease_namespace" | "target_origin";
+            }>;
+            retry: {
+                attempts: number;
+            };
+        })[];
+        assertions: {
+            id: string;
+            required: boolean;
+            environmentClasses: ("isolated_candidate" | "deployed_preview" | "deployed_canary" | "production_observation")[];
+            oracle: {
+                name: "http.observation" | "browser.observation" | "job.observation" | "mcp.observation" | "step.result";
+                version: "1";
+            };
+            stepId: string;
+            predicate: import("../protocol/index.ts").PredicateT;
+            coverageTags: string[];
+        }[];
+        effects: {
+            mode: "read_only" | "designated_writes";
+            allowedHosts: string[];
+            allowedMethods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD")[];
+            allowedResourcePrefixes: string[];
+            maxCreates: number;
+            maxMessages: number;
+            maxJobs: number;
+            cleanupRecipeRef: {
+                id: string;
+                revision: string;
+                digest: {
+                    algorithm: "sha256";
+                    hex: string;
+                };
+            } | null;
+            allowedJobQueues?: string[] | undefined;
+            allowedMcpTools?: string[] | undefined;
+            maxMcpCalls?: number | undefined;
+        };
+        limits: {
+            deadlineMs: number;
+            maxProviderRequests: number;
+            maxTokens: number;
+            costCeilingCents: number;
+            maxBrowserActions: number;
+            maxArtifactBytes: number;
+            diagnosticRetries: number;
+            concurrencyGroup: string;
+        };
+        capture: {
+            stepEvents: true;
+            networkMetadata: true;
+            trace: "optional" | "required" | "failure";
+            video: "optional" | "required" | "failure";
+            redactionPolicyRef: {
+                id: string;
+                revision: string;
+                digest: {
+                    algorithm: "sha256";
+                    hex: string;
+                };
+            } | null;
+            retentionPolicyRef: {
+                id: string;
+                revision: string;
+                digest: {
+                    algorithm: "sha256";
+                    hex: string;
+                };
+            } | null;
+        };
+        baselineRef: {
+            id: string;
+            revision: string;
+            digest: {
+                algorithm: "sha256";
+                hex: string;
+            };
+        } | null;
+        generation: {
+            agent: string;
+            requestedModel: string;
+            observedModel: string | null;
+            promptDigest: {
+                algorithm: "sha256";
+                hex: string;
+            };
+            changeDigest: {
+                algorithm: "sha256";
+                hex: string;
+            };
+            sourceMapRefs: {
+                id: string;
+                revision: string;
+                digest: {
+                    algorithm: "sha256";
+                    hex: string;
+                };
+            }[];
+        } | null;
+        schemaVersion: "workflow.case/v1";
+        ref: {
+            id: string;
+            revision: string;
+            digest: {
+                algorithm: "sha256";
+                hex: string;
+            };
+        };
+        scope: {
+            ownerId: string;
+            tenantId: string | null;
+            visibility: "public" | "owner_private" | "tenant_private";
+        };
+    };
+};