@agents24/react 0.2.23 → 0.2.25

package/dist/operation-ownership.d.ts

@@ -1,6 +1,7 @@
 /** A selection generation distinguishes A → B → A from uninterrupted ownership. */
 export type ChatOperationOwner = {
     generation: number;
+    client?: unknown;
     threadId: string | null;
     runId?: string | null;
     stream?: unknown;

package/dist/provider.d.ts

@@ -14,6 +14,10 @@ export type Agents24ReactRuntime = {
     createId: () => string;
     storage?: AgentChatStorage;
     visibility?: VisibilitySource;
+    onHitlTiming?: (timing: {
+        stage: "preparation" | "acknowledgement" | "attachment" | "first_activity";
+        durationMs: number;
+    }) => void;
 };
 export type Agents24ProviderProps = {
     children: React.ReactNode;
@@ -22,7 +26,11 @@ export type Agents24ProviderProps = {
     createId?: () => string;
     storage?: AgentChatStorage;
     visibility?: VisibilitySource;
+    onHitlTiming?: (timing: {
+        stage: "preparation" | "acknowledgement" | "attachment" | "first_activity";
+        durationMs: number;
+    }) => void;
 };
-export declare function Agents24Provider({ children, client, createAbortController, createId, storage, visibility, }: Agents24ProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function Agents24Provider({ children, client, createAbortController, createId, storage, visibility, onHitlTiming, }: Agents24ProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare function useAgents24Runtime(): Agents24ReactRuntime;
 export declare function useAgentClient(): AgentClient;

package/dist/use-agent-chat-hitl-submissions.d.ts

@@ -0,0 +1,20 @@
+import type { AgentClient, HitlResponse } from "@agents24/client";
+import * as React from "react";
+import type { ChatHitlPart } from "./model";
+import type { AgentChatState } from "./state";
+import type { Agents24ReactRuntime } from "./provider";
+import { type HitlDecisionReceipt } from "./hitl-resolution";
+import { type HitlSubmissionOptions, type HitlSubmissionState } from "./hitl-submission";
+export declare function useAgentChatHitlSubmissions(options: {
+    client: AgentClient;
+    runtime: Agents24ReactRuntime;
+    pageSize: number;
+    stateRef: React.MutableRefObject<AgentChatState>;
+    selectionGeneration: React.MutableRefObject<number>;
+    ownOperation(): () => boolean;
+    accept(receipt: HitlDecisionReceipt): void;
+    attach(runId: string): void;
+}): {
+    resumeHitl: (part: ChatHitlPart, response: HitlResponse, submission?: HitlSubmissionOptions) => Promise<void>;
+    getHitlSubmissionState: (part: ChatHitlPart) => HitlSubmissionState | undefined;
+};

package/dist/use-agent-chat.d.ts

@@ -1,3 +1,4 @@
+import type { HitlSubmissionOptions, HitlSubmissionState } from "./hitl-submission";
 import type { AgentClient, FeedbackReason, HitlResponse, PortableUpload, ThreadMessage, ThreadMessageQueueState } from "@agents24/client";
 import type { ChatAttachment, ChatHitlPart, ChatMessage, StoredChatThread } from "./model";
 import { type RetractedMessageDraft } from "./thread-message-queue";
@@ -46,7 +47,8 @@ export type AgentChatController = AgentChatState & {
     retractPendingMessage(message: ThreadMessage): Promise<RetractedMessageDraft>;
     resumeQueue(): Promise<void>;
     steer(text: string): Promise<void>;
-    resumeHitl(part: ChatHitlPart, response: HitlResponse): Promise<void>;
+    resumeHitl(part: ChatHitlPart, response: HitlResponse, options?: HitlSubmissionOptions): Promise<void>;
+    getHitlSubmissionState(part: ChatHitlPart): HitlSubmissionState | undefined;
     setFeedback(message: ChatMessage, input: {
         rating: "like" | "dislike" | null;
         reason?: FeedbackReason | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agents24/react",
-  "version": "0.2.23",
+  "version": "0.2.25",
   "description": "DOM-free React state and hooks for Agents24 client applications.",
   "license": "MIT",
   "repository": {
@@ -40,7 +40,7 @@
     "prepack": "pnpm run build && pnpm run check:boundaries"
   },
   "dependencies": {
-    "@agents24/client": "0.2.18"
+    "@agents24/client": "0.2.20"
   },
   "peerDependencies": {
     "react": ">=19.0.0 <20.0.0"