@pylonsync/react 0.4.22 → 0.4.23

package/dist/index.d.ts

@@ -16,6 +16,8 @@ export type { PylonRouter } from "./useRouter";
 import { type Storage as PylonStorage } from "@pylonsync/sync";
 export { useQuery, useQueryOne, useReactiveQuery, useMutation, useInfiniteQuery, usePaginatedQuery, useEntityMutation, useAction, useQueryRaw, useQueryOneRaw, useLiveList, useLiveRow, useInsert, useUpdate, useDelete, useFn, useAggregate, useSearch, } from "./hooks";
 export type { QueryOptions, QueryFilter, IncludeSpec, UseQueryReturn, UseQueryOneReturn, UseReactiveQueryReturn, UseMutationReturn, UseInfiniteQueryReturn, UsePaginatedQueryReturn, PaginatedQueryStatus, UseFnReturn, AggregateSpec, UseAggregateReturn, SearchSpec, UseSearchReturn, } from "./hooks";
+export { useAgentRun } from "./useAgentRun";
+export type { AgentRunRow, AgentMessageRow, UseAgentRunReturn, } from "./useAgentRun";
 export { useRoom, useRoomMessages } from "./useRoom";
 export type { RoomPeer, RoomSnapshot, UseRoomOptions, UseRoomReturn, } from "./useRoom";
 export type { RoomMessage } from "@pylonsync/sync";

package/dist/useAgentRun.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Live view of an `agent()` run — the AgentRun row plus its ordered
+ * transcript — straight from the synced replica. Because AgentRun and
+ * AgentMessage are ordinary synced entities (owner-scoped by policy),
+ * this updates in real time on every one of the user's devices as the
+ * loop persists turns: user input, assistant text, tool calls, tool
+ * results.
+ *
+ * ```tsx
+ * const { run, messages } = useAgentRun(runId);
+ * // messages[i]: { role: "user" | "assistant", content: string | LlmContentBlock[] , seq, ... }
+ * // run.status: "idle" | "running" | "completed" | "failed"
+ * // run.streamId: attach to live tokens with resumeStream(run.streamId)
+ * ```
+ *
+ * Start or continue a run with `streamFn("<agentName>", { input, runId? })`
+ * — tokens stream on that connection; the persisted transcript arrives
+ * here.
+ */
+export interface AgentRunRow {
+    id: string;
+    agent: string;
+    status: "idle" | "running" | "completed" | "failed" | string;
+    userId?: string | null;
+    title?: string | null;
+    /** Resumable-stream id of the current/last generation. */
+    streamId?: string | null;
+    error?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AgentMessageRow {
+    id: string;
+    runId: string;
+    seq: number;
+    role: "user" | "assistant" | string;
+    /** A string for plain turns, or LlmContentBlock[] for assistant
+     *  turns with tool_use and tool_result batches. */
+    content: unknown;
+    createdAt: string;
+}
+export interface UseAgentRunReturn {
+    run: AgentRunRow | null;
+    messages: AgentMessageRow[];
+    loading: boolean;
+}
+export declare function useAgentRun(runId: string | null | undefined): UseAgentRunReturn;

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.4.22",
+  "version": "0.4.23",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./dist/index.d.ts",
@@ -14,8 +14,8 @@
     "prepack": "bun run build"
   },
   "dependencies": {
-    "@pylonsync/sdk": "0.4.22",
-    "@pylonsync/sync": "0.4.22"
+    "@pylonsync/sdk": "0.4.23",
+    "@pylonsync/sync": "0.4.23"
   },
   "peerDependencies": {
     "react": ">=19.0.0"

package/src/index.ts

@@ -107,6 +107,14 @@ export type {
   UseSearchReturn,
 } from "./hooks";
 
+// Agent run hook — live transcript + status for agent() runs
+export { useAgentRun } from "./useAgentRun";
+export type {
+  AgentRunRow,
+  AgentMessageRow,
+  UseAgentRunReturn,
+} from "./useAgentRun";
+
 // Room hook
 export { useRoom, useRoomMessages } from "./useRoom";
 export type {