@inflexa-ai/harness 0.35.7 → 0.36.0

package/dist/workflows/execute-target-assessment.d.ts

@@ -1,118 +0,0 @@
-/**
- * `executeTargetAssessment` — the parent DBOS workflow.
- *
- * Shape (every external interaction is a `DBOS.runStep` so a crashed
- * workflow replays from the cache instead of repeating side effects):
- *
- *  Phase 0   `phase0Resolve`               — only step allowed to throw
- *                                            (terminates → `target-unresolved`)
- *  Phase 1   15 collectors in parallel     — coverage-envelope failures
- *  Progress  `emitProgress("deciding")`
- *  Phase 2   2 decisions in parallel       — LLM calls, attempt-numbered
- *  Progress  `emitProgress("fanning_out")`
- *  Phase 3   4 fan-out blocks in parallel  — per-item HTTP, withHost semaphore
- *  Progress  `emitProgress("assembling")`
- *  Phase 4   `phase4Assemble`              — aggregation + cached annotator
- *  Phase 4a  `ta-approval-precedents`      — one openFDA lookup, two projections
- *  Phase 4b  `assembleSafetyCorroboration` — pure fold, no step of its own
- *  Phase 4c  `investigateClaims`           — propose / critique / re-verify / converge
- *  Progress  `emitProgress("synthesizing")`
- *  Phase 5a  3 per-section syntheses in parallel
- *  Phase 5b  `dossierRecommendation` sequential
- *  Phase 5c  `phase5Persist` (pure)
- *  Terminal  outermost try/finally:
- *             - normal:           setDossier         → status="completed"
- *             - phase0 throw:     markFailed         → "target-unresolved"
- *             - schema violation: markFailed         → "schema-violation"
- *             - other throw:      markFailed         → "unexpected-throw"
- *             - 402 self-cancel:  markAssessmentSuspended → "suspended_insufficient_funds"
- *             - operator cancel:  markFailed         → "operator-cancelled"
- *             - soft-deleted row: no-op
- *
- * Workflow ID convention: `workflowID === assessmentId`. TA is one-shot
- * (re-runs create new rows), so the workflowID equals the assessmentId
- * directly. No `:runId` suffix.
- */
-import type { Pool } from "pg";
-import { z } from "zod";
-import type { RunSession } from "../auth/types.js";
-import type { RunAuthorizer } from "../execution/run-authorizer.js";
-import type { Logger } from "../lib/logger.js";
-import type { UsageRecorder } from "../billing/usage-recorder.js";
-import type { AgentChat } from "../providers/types.js";
-import { TargetAssessmentInputSchema } from "./target-assessment/schemas.js";
-import { type ClaimInvestigationConfig } from "./target-assessment/investigation/index.js";
-import { type ProgressPhase } from "./target-assessment/progress.js";
-export declare const ExecuteTargetAssessmentInputSchema: z.ZodObject<{
-    assessmentId: z.ZodString;
-    target: z.ZodString;
-    goal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    organizationId: z.ZodString;
-    requestedBy: z.ZodString;
-    billingContextId: z.ZodString;
-}, z.core.$strip>;
-type SerializedInput = z.infer<typeof ExecuteTargetAssessmentInputSchema>;
-/**
- * Workflow input includes the `runSession` minted at the trigger route.
- * The schema is for the serialised wire shape (input persisted by DBOS);
- * the `runSession` is added at the type level so the workflow body can
- * read the run-authorization credential directly.
- */
-export type ExecuteTargetAssessmentInput = SerializedInput & {
-    readonly runSession: RunSession;
-    /**
-     * True when Cortex owns the run-authorization lifecycle and therefore must
-     * revoke it on the terminal path. Optional because a workflow persisted
-     * before this field existed (recovered across the deploy that added it)
-     * deserializes without it; the body defaults absent → true, matching the
-     * prior Cortex-owned behavior.
-     */
-    readonly ownsMandate?: boolean;
-};
-export interface ExecuteTargetAssessmentResult {
-    readonly assessmentId: string;
-    readonly status: "completed" | "failed" | "suspended_insufficient_funds" | "deleted";
-    readonly bytes: number;
-}
-export interface ExecuteTargetAssessmentDeps {
-    /** Operational logging seam; omitted falls back to no-op. */
-    readonly logger?: Logger;
-    readonly pool: Pool;
-    /** Run-authorization seam — the terminal path revokes through `revoke`. */
-    readonly runAuthorizer: RunAuthorizer;
-    /** NCBI E-utilities key for the ClinVar / PubMed Phase-1 collectors. */
-    readonly ncbiApiKey?: string;
-    /**
-     * Chat provider — billing resolution is closure-wrapped via the TA
-     * resolver in `harness/billing/target-assessment-resolver.ts` (see §12
-     * registration). The session's `scope.kind === "target-assessment"`
-     * carries the `billingContextId` the resolver keys on.
-     */
-    readonly chatProvider: AgentChat;
-    /** Billing-gateway model for decision agents — typically `env.TARGET_ASSESSMENT_DECISION_MODEL`. */
-    readonly decisionModel: string;
-    /** Billing-gateway model for synthesis agents — typically `env.TARGET_ASSESSMENT_SYNTHESIS_MODEL`. */
-    readonly synthesisModel: string;
-    /** LLM usage-accounting seam for the assessment's agent loops; omitted falls back to the no-op recorder. */
-    readonly usageRecorder?: UsageRecorder;
-    /**
-     * Bounds the claim-investigation phase runs under. Omitted falls back to
-     * `DEFAULT_CLAIM_INVESTIGATION_CONFIG` — the values are cost and termination
-     * bounds, not domain constants, so an embedder wanting a deeper pass sets
-     * its own and the dossier reports what was in force.
-     */
-    readonly claimInvestigation?: Partial<ClaimInvestigationConfig>;
-}
-/**
- * Register the executeTargetAssessment workflow with DBOS. Caller is
- * responsible for setting `workflowID = assessmentId` via
- * `DBOS.startWorkflow(_, { workflowID })`.
- */
-export declare function registerExecuteTargetAssessment(deps: ExecuteTargetAssessmentDeps): (input: ExecuteTargetAssessmentInput) => Promise<ExecuteTargetAssessmentResult>;
-/**
- * Body extracted so tests can drive it without registering a workflow
- * (the DBOS calls inside still rely on a workflow context being present).
- */
-export declare function runExecuteTargetAssessmentBody(input: ExecuteTargetAssessmentInput, deps: ExecuteTargetAssessmentDeps): Promise<ExecuteTargetAssessmentResult>;
-export { TargetAssessmentInputSchema };
-export type { ProgressPhase };