@tiangong-ai/cli 0.0.32 → 0.0.34

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

@@ -1,3 +1,4 @@
+import { type DiscoveryProgress } from "./discovery-status.js";
 import { type AgentExecutionRequest } from "./executor.js";
 import type { AgentRoute, ExecutionResult, OutputRecord, ProjectState, ResearchProgressEvent } from "./types.js";
 export interface RunOptions {
@@ -13,8 +14,8 @@ export interface WorkspaceRunResult {
     workspace: string;
     requestId: string;
     projectId: string | null;
-    status: "complete" | "blocked" | "ready" | "dry-run";
-    stopReason: "dry-run" | "all-projects-complete" | "project-blocked" | "native-stage-required" | "cycle-limit" | "no-ready-work" | "no-projects";
+    status: "complete" | "blocked" | "waiting" | "ready" | "dry-run";
+    stopReason: "dry-run" | "all-projects-complete" | "project-blocked" | "handoff-required" | "native-stage-required" | "cycle-limit" | "no-ready-work" | "no-projects";
     cycles: number;
     executed: Array<{
         projectId: string;
@@ -28,6 +29,53 @@ export interface WorkspaceRunResult {
         usage: ProjectState["usage"];
     }>;
 }
+export declare const researchHandoffRecordSchema: {
+    readonly $id: "https://schemas.tiangong.ai/research/handoff-request-v1.json";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["schemaVersion", "state", "reasonCode", "summary", "requestedActions", "evidenceGaps"];
+    readonly properties: {
+        readonly schemaVersion: {
+            readonly type: "integer";
+            readonly const: 1;
+        };
+        readonly state: {
+            readonly type: "string";
+            readonly enum: readonly ["user-action-required", "external-response-required"];
+        };
+        readonly reasonCode: {
+            readonly type: "string";
+            readonly pattern: "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$";
+        };
+        readonly summary: {
+            readonly type: "string";
+            readonly minLength: 8;
+            readonly maxLength: 1000;
+        };
+        readonly requestedActions: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 10;
+            readonly uniqueItems: true;
+            readonly items: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 500;
+            };
+        };
+        readonly evidenceGaps: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 50;
+            readonly uniqueItems: true;
+            readonly items: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 500;
+            };
+        };
+    };
+};
 export declare function runResearchWorkspace(root: string, options: RunOptions, packageExecutor?: PackageExecutor): Promise<WorkspaceRunResult>;
 /** @internal Test-only seam for exercising deterministic package admission with fake agents. */
 export declare function runResearchWorkspaceWithInjectedProducerForTesting(root: string, options: RunOptions, packageExecutor: PackageExecutor): Promise<WorkspaceRunResult>;
@@ -37,13 +85,14 @@ export interface NativeStagePacket {
     sessionId: string;
     projectId: string;
     packageId: string;
-    stage: "discover" | "analyze" | "synthesize";
+    stage: "discover" | "acquire" | "analyze" | "synthesize";
     hostAgent: AgentRoute["agent"];
     expectedModel: string | null;
     preparedAt: string;
     bindingSha256: string;
     prompt: string;
     outputSchema: Record<string, unknown>;
+    discovery: DiscoveryProgress | null;
     limits: {
         maxOutputBytes: number;
         maxOutputTokens: number;
@@ -56,6 +105,31 @@ export interface NativeStagePacket {
             argv: string[];
             requestSchema: Record<string, unknown>;
         } | null;
+        recordActivity: {
+            argv: string[];
+            recordSchema: Record<string, unknown>;
+        } | null;
+        registerCandidate: {
+            argv: string[];
+            recordSchema: Record<string, unknown>;
+        } | null;
+        recordAssessment: {
+            argv: string[];
+            recordSchema: Record<string, unknown>;
+        } | null;
+        bindDownload: {
+            argv: string[];
+            recordSchema: Record<string, unknown>;
+        } | null;
+        requestHandoff: {
+            argv: string[];
+            recordSchema: Record<string, unknown>;
+        };
+        registerArtifact: {
+            argv: string[];
+            supportedMediaTypes: string[];
+            optionalMetadataFields: string[];
+        } | null;
         submit: {
             argv: string[];
         };
@@ -66,10 +140,19 @@ export interface NativeStagePacket {
     rules: string[];
     packetSha256: string;
 }
+export interface NativeStageStatus {
+    status: "none" | "active" | "stale" | "invalid";
+    sessionId: string | null;
+    stage: string | null;
+    preparedAt: string | null;
+    reasonCode: string | null;
+    recommendedAction: string | null;
+}
+export declare function inspectNativeResearchStage(root: string, project: ProjectState): Promise<NativeStageStatus>;
 export declare function prepareNativeResearchStage(input: {
     root: string;
     projectId: string;
-    stage: "discover" | "analyze" | "synthesize";
+    stage: "discover" | "acquire" | "analyze" | "synthesize";
     hostAgent: AgentRoute["agent"];
 }): Promise<NativeStagePacket>;
 export declare function submitNativeResearchStage(input: {
@@ -95,3 +178,22 @@ export declare function abortNativeResearchStage(input: {
     packageId: string;
     status: "ready" | "blocked";
 }>;
+export declare function requestResearchHandoff(input: {
+    root: string;
+    projectId: string;
+    value: Record<string, unknown>;
+}): Promise<{
+    projectId: string;
+    status: "waiting-user" | "waiting-external";
+    handoff: ProjectState["handoff"];
+    resolveCommand: string;
+}>;
+export declare function resolveResearchHandoff(input: {
+    root: string;
+    projectId: string;
+    note: string;
+}): Promise<{
+    projectId: string;
+    status: ProjectState["status"];
+    handoff: ProjectState["handoff"];
+}>;