@agents24/react 0.2.23 → 0.2.25

package/compatibility.json

@@ -1,5 +1,5 @@
 {
-  "contractHash": "904701fe1c173854cd4154f2156020da471397fbc6bb644cea60f44c71a1a0d2",
+  "contractHash": "6d6ceb78b4285f987a5635b4d4d0b407732bf5e61abd1aca1369a97a7d6336e6",
   "contractVersion": "0.3.0",
   "corpus": "conformance/v1/corpus.json",
   "generatedBy": "@agents24/sdk-contract",
@@ -15,11 +15,11 @@
       "reactDom": ">=19 <20"
     },
     "@agents24/client": {
-      "contract": "904701fe1c173854cd4154f2156020da471397fbc6bb644cea60f44c71a1a0d2",
+      "contract": "6d6ceb78b4285f987a5635b4d4d0b407732bf5e61abd1aca1369a97a7d6336e6",
       "runtime": "run-stream.v3"
     },
     "@agents24/node": {
-      "contract": "904701fe1c173854cd4154f2156020da471397fbc6bb644cea60f44c71a1a0d2",
+      "contract": "6d6ceb78b4285f987a5635b4d4d0b407732bf5e61abd1aca1369a97a7d6336e6",
       "node": "^22.0.0 || ^24.0.0"
     },
     "@agents24/react": {
@@ -27,11 +27,11 @@
       "react": ">=19 <20"
     },
     "@talmudpedia/runtime-sdk": {
-      "contract": "904701fe1c173854cd4154f2156020da471397fbc6bb644cea60f44c71a1a0d2",
+      "contract": "6d6ceb78b4285f987a5635b4d4d0b407732bf5e61abd1aca1369a97a7d6336e6",
       "protocolOwner": "@agents24/client"
     },
     "agents24": {
-      "contract": "904701fe1c173854cd4154f2156020da471397fbc6bb644cea60f44c71a1a0d2",
+      "contract": "6d6ceb78b4285f987a5635b4d4d0b407732bf5e61abd1aca1369a97a7d6336e6",
       "python": ">=3.10"
     }
   },

package/dist/hitl-resolution.d.ts

@@ -0,0 +1,10 @@
+import type { HitlResumeResult } from "@agents24/client";
+import type { ChatHitlPart, ChatMessage, ChatPart } from "./model";
+export type HitlDecisionReceipt = Pick<HitlResumeResult, "run_id" | "thread_id" | "interrupt_id" | "resolution"> & {
+    run_status?: string;
+};
+/** Apply a durable receipt without moving the delivery cursor or changing run execution. */
+export declare function applyHitlResolution<T extends Pick<ChatMessage, "runId" | "parts">>(messages: T[], receipt: HitlDecisionReceipt): T[];
+export declare function findHitlResolution(messages: readonly ChatMessage[], runId: string, interruptId: string): ChatHitlPart | undefined;
+/** Terminal decisions are monotonic even when delivery replays an older pending snapshot. */
+export declare function preserveResolvedHitlParts(current: readonly ChatPart[], incoming: ChatPart[]): ChatPart[];

package/dist/hitl-submission.d.ts

@@ -0,0 +1,36 @@
+import type { AbortSignalLike, HitlResponse, HitlResumeResult } from "@agents24/client";
+import type { HitlDecisionReceipt } from "./hitl-resolution";
+import type { AbortControllerFactory } from "./lifecycle";
+export type HitlSubmissionOptions = {
+    /** Host-owned prerequisite. Runs inside the submission lock and decision deadline. */
+    prepare?: (input: {
+        signal: AbortSignalLike;
+    }) => Promise<void>;
+};
+export type HitlSubmissionState = {
+    action: string;
+    status: "submitting" | "checking" | "uncertain" | "accepted" | "error";
+    error?: string | null;
+    retry?: () => Promise<void>;
+};
+/** A separate deadline for decisions and reconciliation, never for continuation streams. */
+export declare function withHitlDeadline<T>(factory: AbortControllerFactory, work: (signal: AbortSignalLike) => Promise<T>, ms?: number): Promise<T>;
+export declare function isDefinitiveHitlRejection(error: unknown): boolean;
+/** One immutable decision; retry is the very same operation and idempotency identity. */
+export declare function createHitlSubmission(options: {
+    response: HitlResponse;
+    idempotencyKey: string;
+    prepare?: HitlSubmissionOptions["prepare"];
+    createAbortController: AbortControllerFactory;
+    isCurrent(): boolean;
+    send(response: HitlResponse, key: string, signal: AbortSignalLike): Promise<HitlResumeResult>;
+    reconcile(signal: AbortSignalLike): Promise<HitlDecisionReceipt | null>;
+    accept(receipt: HitlDecisionReceipt): void;
+    changed(state: HitlSubmissionState): void;
+    now?: () => number;
+    timing?: (stage: "preparation" | "acknowledgement", durationMs: number) => void;
+}): {
+    retry: () => Promise<void>;
+    readonly failed: boolean;
+    readonly uncertain: boolean;
+};

package/dist/index.d.ts

@@ -10,3 +10,5 @@ export * from "./use-agent-chat";
 export * from "./use-agent-resources";
 export * from "./operation-ownership";
 export { useAgentChatFeedback } from "./use-agent-chat-feedback";
+export * from "./hitl-resolution";
+export * from "./hitl-submission";