@gajae-code/coding-agent 0.9.6 → 0.10.1

package/dist/types/modes/shared/agent-wire/workflow-gate-broker.d.ts

@@ -1,4 +1,32 @@
-import type { RpcWorkflowGate, RpcWorkflowGateContext, RpcWorkflowGateKind, RpcWorkflowGateOption, RpcWorkflowGateResolution, RpcWorkflowGateResponse, RpcWorkflowStage } from "../../rpc/rpc-types";
+import type { AskSelectedAckOutcome } from "../../../tools";
+import type { RpcWorkflowGate, RpcWorkflowGateContext, RpcWorkflowGateKind, RpcWorkflowGateOption, RpcWorkflowGateResolution, RpcWorkflowGateResponse, RpcWorkflowGateValidationError, RpcWorkflowStage } from "../../rpc/rpc-types";
+export type PersistedSemanticDisposition = "commit" | "resolve_without_commit";
+export type PersistedResolutionOrigin = {
+    kind: "generic";
+    channel: "rpc" | "bridge" | "other";
+} | {
+    kind: "telegram_notification";
+    interactionActionId: string;
+} | {
+    kind: "legacy_unknown";
+};
+export type PersistedAckPolicy = {
+    kind: "none";
+    reason: "non_telegram" | "semantic_noncommit" | "legacy_unproven";
+} | {
+    kind: "telegram_selected_v1";
+    commitKey: string;
+    actionId: string;
+    state: "pending" | "attempt_started" | "delivered" | "failed" | "unknown";
+    outcome?: AskSelectedAckOutcome;
+    updatedAt: string;
+};
+export interface GateResolutionOptions {
+    semanticDisposition?: PersistedSemanticDisposition;
+    resolutionOrigin?: PersistedResolutionOrigin;
+    ackPolicy?: PersistedAckPolicy;
+    beforeAdvance?: () => Promise<void>;
+}
 export interface PersistedGate {
     gate: RpcWorkflowGate;
     status: "pending" | "accepted";
@@ -8,6 +36,9 @@ export interface PersistedGate {
     answer?: unknown;
     resolution?: RpcWorkflowGateResolution;
     advanced: boolean;
+    semanticDisposition?: PersistedSemanticDisposition;
+    resolutionOrigin?: PersistedResolutionOrigin;
+    ackPolicy?: PersistedAckPolicy;
 }
 export interface GateStore {
     nextSeq(stage: RpcWorkflowStage): number;
@@ -74,6 +105,8 @@ export interface BrokerHooks {
      * it for any gate left `accepted` but not `advanced` by a crash.
      */
     advance?(gate: RpcWorkflowGate, answer: unknown): void | Promise<void>;
+    /** Runs after durable acceptance and before advance, including crash recovery. */
+    finalizeAccepted?(record: PersistedGate): Promise<void>;
     /** Append-only audit sink. */
     audit?(event: GateAuditEvent): void;
 }
@@ -92,7 +125,13 @@ export declare class WorkflowGateBroker {
     private readonly runId;
     private readonly store;
     private readonly hooks;
+    private readonly recovering;
+    private readonly gateLocks;
+    private withGateLock;
     constructor(runId: string, store: GateStore, hooks?: BrokerHooks);
+    classifyDisposition(gateId: string, answer: unknown): PersistedSemanticDisposition;
+    validationError(gateId: string, keyword: string, message: string): RpcWorkflowGateValidationError;
+    updateAckPolicy(gateId: string, ackPolicy: PersistedAckPolicy): void;
     private runShort;
     /** Open and emit a gate. The pending record is persisted BEFORE emission. */
     openGate(input: OpenGateInput): RpcWorkflowGate;
@@ -101,7 +140,8 @@ export declare class WorkflowGateBroker {
      * On success the resolution is persisted BEFORE `advance` is invoked exactly
      * once. Invalid answers leave the gate pending (per #315 acceptance).
      */
-    resolve(response: RpcWorkflowGateResponse): Promise<RpcWorkflowGateResolution>;
+    resolve(response: RpcWorkflowGateResponse, options?: GateResolutionOptions): Promise<RpcWorkflowGateResolution>;
+    private resolveUnlocked;
     /**
      * Recover any gate left `accepted` but not `advanced` by a crash between the
      * durable accept and the advanced commit. Replays `advance` (which must be