@fragno-dev/pi-fragment 0.0.1 → 0.0.3

package/README.md

@@ -5,8 +5,10 @@ A Fragno fragment that runs Pi agents using workflow-backed sessions with regist
 ## Features
 
 - Session lifecycle (create, list, fetch)
-- Workflow-backed agent turns (history stored in workflow steps)
+- Workflow-backed agent turns with restorable current-run inspection state
 - Registry-driven agent + tool configuration
+- Automatic tool call capture + deterministic replay from persisted workflow step state
+- Framework-level side-effect reducers (including built-in bash VFS reconstruction)
 - Minimal API surface for sessions + messages
 
 ## Server usage
@@ -59,8 +61,41 @@ Workflows are executed via the workflows fragment durable hook dispatcher. For a
 
 - `agents`: registry of agent definitions (name, system prompt, model, tools)
 - `tools`: registry of tool factories
+- `toolSideEffectReducers`: optional reducers keyed by tool name for reconstructing runtime state
 - `defaultSteeringMode`: optional default for agent steering mode
 
+## Tool Replay Middleware Contract
+
+Tool calls are persisted automatically in each `assistant-*` workflow step result. Tools do not need
+to write workflow state directly.
+
+- Stable key: `sessionId:turnId:toolCallId`
+- Journal fields: `version`, `toolName`, `args`, `result`, `isError`, `source`, `capturedAt`, `seq`
+- Replay: duplicate tool calls with the same stable key are short-circuited and reuse persisted
+  results
+- Error parity: replayed failed calls preserve `isError` behavior
+
+### Reducers for Stateful Tools
+
+For stateful runtimes (for example bash virtual filesystems), register a reducer so tool factories
+receive reconstructed state through `ctx.replay.sideEffects`.
+
+```ts
+const pi = createPi()
+  .toolSideEffectReducer("bash", (state, entry) => {
+    // Apply persisted bash tool details in deterministic order.
+    const previous = typeof state === "object" && state ? state : {};
+    const details =
+      entry.result.details && typeof entry.result.details === "object" ? entry.result.details : {};
+    return { ...previous, ...details };
+  })
+  .build();
+```
+
+`@fragno-dev/pi-fragment` includes a default `bash` reducer that replays common
+`cwd/files/writes/deletes` detail payloads. Custom reducers can extend or override this behavior per
+tool.
+
 ## Routes
 
 - `POST /sessions`
@@ -69,8 +104,9 @@ Workflows are executed via the workflows fragment durable hook dispatcher. For a
 - `POST /sessions/:sessionId/messages`
 
 `POST /sessions/:sessionId/messages` is asynchronous. It returns `202 Accepted` with a status-only
-ACK payload. Fetch `GET /sessions/:sessionId` to read assistant messages, trace, and summaries once
-the workflow processes the message.
+ACK payload. Fetch `GET /sessions/:sessionId` to read the restored current-run detail payload
+(messages, events, trace, summaries, phase, and waiting markers) once the workflow processes the
+message.
 
 ## Client usage
 

package/dist/browser/client/react.d.ts

@@ -1,5 +1,8 @@
-import { a as FragnoClientError, c as InferOr, d as MaybeExtractPathParamsOrWiden, f as QueryParamsHint, i as ReadableAtom, l as ExtractPathParamsOrWiden, o as NonGetHTTPMethod, r as FetcherValue, s as FragnoPublicClientConfig, u as HasPathParams } from "../client-Bk-J98pf.js";
+import { $ as InferOr, Q as FragnoClientError, X as FetcherValue, Z as NonGetHTTPMethod, c as PiFragmentClientConfig, d as PiSessionStoreView, et as ExtractPathParamsOrWiden, nt as MaybeExtractPathParamsOrWiden, rt as QueryParamsHint, tt as HasPathParams, u as PiSessionStoreHookArgs, y as PiActiveSessionProtocolMessage } from "../routes-CpL_YGWK.js";
+import "../index.js";
+import { ReadableAtom, Store, StoreValue } from "nanostores";
 import * as zod from "zod";
+import * as _mariozechner_pi_agent_core0 from "@mariozechner/pi-agent-core";
 import "react";
 import * as zod_v4_core0 from "zod/v4/core";
 import * as _standard_schema_spec0 from "@standard-schema/spec";
@@ -28,9 +31,11 @@ type FragnoReactMutator<_TMethod extends NonGetHTTPMethod, TPath$1 extends strin
 /**
  * Type helper that unwraps any Store fields of the object into StoreValues
  */
+type FragnoReactStoreValue<T extends object> = T extends Store<infer TStore> ? StoreValue<TStore> : { [K in keyof T]: T[K] extends Store ? StoreValue<T[K]> : T[K] };
+type FragnoReactStore<T extends object, TArgs extends unknown[] = []> = (...args: TArgs) => FragnoReactStoreValue<T>;
 //#endregion
 //#region src/client/react.d.ts
-declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
+declare function createPiFragmentClient(config?: PiFragmentClientConfig): {
   useSessions: FragnoReactHook<"GET", "/sessions", zod.ZodArray<zod.ZodObject<{
     id: zod.ZodString;
     name: zod.ZodNullable<zod.ZodString>;
@@ -43,7 +48,6 @@ declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
       waiting: "waiting";
     }>;
     agent: zod.ZodString;
-    workflowInstanceId: zod.ZodNullable<zod.ZodString>;
     steeringMode: zod.ZodEnum<{
       all: "all";
       "one-at-a-time": "one-at-a-time";
@@ -53,7 +57,7 @@ declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
     createdAt: zod.ZodDate;
     updatedAt: zod.ZodDate;
   }, zod_v4_core0.$strip>>, string, "limit">;
-  useSession: FragnoReactHook<"GET", "/sessions/:sessionId", zod.ZodObject<{
+  useSessionDetail: FragnoReactHook<"GET", "/sessions/:sessionId", zod.ZodObject<{
     id: zod.ZodString;
     name: zod.ZodNullable<zod.ZodString>;
     status: zod.ZodEnum<{
@@ -65,7 +69,6 @@ declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
       waiting: "waiting";
     }>;
     agent: zod.ZodString;
-    workflowInstanceId: zod.ZodNullable<zod.ZodString>;
     steeringMode: zod.ZodEnum<{
       all: "all";
       "one-at-a-time": "one-at-a-time";
@@ -95,20 +98,10 @@ declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
         type: zod.ZodLiteral<"text">;
         text: zod.ZodString;
         textSignature: zod.ZodOptional<zod.ZodString>;
-      }, zod_v4_core0.$strip>, zod.ZodObject<{
-        type: zod.ZodLiteral<"thinking">;
-        thinking: zod.ZodString;
-        thinkingSignature: zod.ZodOptional<zod.ZodString>;
       }, zod_v4_core0.$strip>, zod.ZodObject<{
         type: zod.ZodLiteral<"image">;
         data: zod.ZodString;
         mimeType: zod.ZodString;
-      }, zod_v4_core0.$strip>, zod.ZodObject<{
-        type: zod.ZodLiteral<"toolCall">;
-        id: zod.ZodString;
-        name: zod.ZodString;
-        arguments: zod.ZodRecord<zod.ZodString, zod.ZodUnknown>;
-        thoughtSignature: zod.ZodOptional<zod.ZodString>;
       }, zod_v4_core0.$strip>]>>]>;
       timestamp: zod.ZodNumber;
     }, zod_v4_core0.$strip>, zod.ZodObject<{
@@ -121,10 +114,6 @@ declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
         type: zod.ZodLiteral<"thinking">;
         thinking: zod.ZodString;
         thinkingSignature: zod.ZodOptional<zod.ZodString>;
-      }, zod_v4_core0.$strip>, zod.ZodObject<{
-        type: zod.ZodLiteral<"image">;
-        data: zod.ZodString;
-        mimeType: zod.ZodString;
       }, zod_v4_core0.$strip>, zod.ZodObject<{
         type: zod.ZodLiteral<"toolCall">;
         id: zod.ZodString;
@@ -149,7 +138,13 @@ declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
           total: zod.ZodNumber;
         }, zod_v4_core0.$strip>;
       }, zod_v4_core0.$strip>;
-      stopReason: zod.ZodString;
+      stopReason: zod.ZodEnum<{
+        length: "length";
+        error: "error";
+        stop: "stop";
+        toolUse: "toolUse";
+        aborted: "aborted";
+      }>;
       errorMessage: zod.ZodOptional<zod.ZodString>;
       timestamp: zod.ZodNumber;
     }, zod_v4_core0.$strip>, zod.ZodObject<{
@@ -160,38 +155,52 @@ declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
         type: zod.ZodLiteral<"text">;
         text: zod.ZodString;
         textSignature: zod.ZodOptional<zod.ZodString>;
-      }, zod_v4_core0.$strip>, zod.ZodObject<{
-        type: zod.ZodLiteral<"thinking">;
-        thinking: zod.ZodString;
-        thinkingSignature: zod.ZodOptional<zod.ZodString>;
       }, zod_v4_core0.$strip>, zod.ZodObject<{
         type: zod.ZodLiteral<"image">;
         data: zod.ZodString;
         mimeType: zod.ZodString;
-      }, zod_v4_core0.$strip>, zod.ZodObject<{
-        type: zod.ZodLiteral<"toolCall">;
-        id: zod.ZodString;
-        name: zod.ZodString;
-        arguments: zod.ZodRecord<zod.ZodString, zod.ZodUnknown>;
-        thoughtSignature: zod.ZodOptional<zod.ZodString>;
       }, zod_v4_core0.$strip>]>>;
       details: zod.ZodOptional<zod.ZodUnknown>;
       isError: zod.ZodBoolean;
       timestamp: zod.ZodNumber;
     }, zod_v4_core0.$strip>]>>;
-    trace: zod.ZodArray<zod.ZodObject<{
+    events: zod.ZodArray<zod.ZodObject<{
+      id: zod.ZodString;
+      runNumber: zod.ZodOptional<zod.ZodNullable<zod.ZodNumber>>;
       type: zod.ZodString;
-      timestamp: zod.ZodOptional<zod.ZodNumber>;
+      payload: zod.ZodNullable<zod.ZodUnknown>;
+      createdAt: zod.ZodDate;
+      deliveredAt: zod.ZodNullable<zod.ZodDate>;
+      consumedByStepKey: zod.ZodNullable<zod.ZodString>;
     }, zod_v4_core0.$strip>>;
+    trace: zod.ZodArray<zod.ZodType<_mariozechner_pi_agent_core0.AgentEvent, unknown, zod_v4_core0.$ZodTypeInternals<_mariozechner_pi_agent_core0.AgentEvent, unknown>>>;
+    turn: zod.ZodNumber;
+    phase: zod.ZodEnum<{
+      complete: "complete";
+      "waiting-for-user": "waiting-for-user";
+      "running-agent": "running-agent";
+    }>;
+    waitingFor: zod.ZodNullable<zod.ZodUnion<readonly [zod.ZodObject<{
+      type: zod.ZodLiteral<"user_message">;
+      turn: zod.ZodNumber;
+      stepKey: zod.ZodString;
+      timeoutMs: zod.ZodNullable<zod.ZodNumber>;
+    }, zod_v4_core0.$strip>, zod.ZodObject<{
+      type: zod.ZodLiteral<"assistant">;
+      turn: zod.ZodNumber;
+      stepKey: zod.ZodString;
+    }, zod_v4_core0.$strip>]>>;
     summaries: zod.ZodArray<zod.ZodObject<{
       turn: zod.ZodNumber;
       assistant: zod.ZodNullable<zod.ZodAny>;
       summary: zod.ZodNullable<zod.ZodString>;
     }, zod_v4_core0.$strip>>;
-  }, zod_v4_core0.$strip>, "WORKFLOWS_REQUIRED" | "SESSION_NOT_FOUND" | "WORKFLOW_INSTANCE_MISSING", string>;
+  }, zod_v4_core0.$strip>, "SESSION_NOT_FOUND" | "WORKFLOW_INSTANCE_MISSING", "events" | "trace" | "summaries">;
+  useSession: FragnoReactStore<PiSessionStoreView, [args: PiSessionStoreHookArgs]>;
   useCreateSession: FragnoReactMutator<NonGetHTTPMethod, "/sessions", _standard_schema_spec0.StandardSchemaV1<unknown, unknown> | zod.ZodObject<{
     agent: zod.ZodString;
     name: zod.ZodOptional<zod.ZodString>;
+    systemMessage: zod.ZodOptional<zod.ZodString>;
     metadata: zod.ZodOptional<zod.ZodAny>;
     tags: zod.ZodOptional<zod.ZodArray<zod.ZodString>>;
     steeringMode: zod.ZodOptional<zod.ZodEnum<{
@@ -210,7 +219,6 @@ declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
       waiting: "waiting";
     }>;
     agent: zod.ZodString;
-    workflowInstanceId: zod.ZodNullable<zod.ZodString>;
     steeringMode: zod.ZodEnum<{
       all: "all";
       "one-at-a-time": "one-at-a-time";
@@ -231,7 +239,6 @@ declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
       waiting: "waiting";
     }>;
     agent: zod.ZodString;
-    workflowInstanceId: zod.ZodNullable<zod.ZodString>;
     steeringMode: zod.ZodEnum<{
       all: "all";
       "one-at-a-time": "one-at-a-time";
@@ -241,6 +248,7 @@ declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
     createdAt: zod.ZodDate;
     updatedAt: zod.ZodDate;
   }, zod_v4_core0.$strip>> | undefined, string, string>;
+  useActiveSession: FragnoReactHook<"GET", "/sessions/:sessionId/active", zod.ZodArray<zod.ZodType<PiActiveSessionProtocolMessage, unknown, zod_v4_core0.$ZodTypeInternals<PiActiveSessionProtocolMessage, unknown>>>, "SESSION_NOT_FOUND" | "WORKFLOW_INSTANCE_MISSING", string>;
   useSendMessage: FragnoReactMutator<NonGetHTTPMethod, "/sessions/:sessionId/messages", zod.ZodObject<{
     text: zod.ZodString;
     done: zod.ZodOptional<zod.ZodBoolean>;
@@ -257,7 +265,7 @@ declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
       complete: "complete";
       waiting: "waiting";
     }>;
-  }, zod_v4_core0.$strip> | undefined, "WORKFLOWS_REQUIRED" | "SESSION_NOT_FOUND" | "WORKFLOW_INSTANCE_MISSING", string>;
+  }, zod_v4_core0.$strip> | undefined, "SESSION_NOT_FOUND" | "WORKFLOW_INSTANCE_MISSING" | "SESSION_NOT_READY", string>;
 };
 //#endregion
 export { createPiFragmentClient };

package/dist/browser/client/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","names":["ExtractPathParamsOrWiden","HasPathParams","MaybeExtractPathParamsOrWiden","QueryParamsHint","InferOr","NonGetHTTPMethod","FragnoClientError","FragnoClientHookData","FragnoClientMutatorData","FragnoStoreData","ReadableAtom","Store","StoreValue","FetcherValue","react0","DependencyList","StandardSchemaV1","FragnoReactHook","_TMethod","TPath$1","TOutputSchema$1","TErrorCode$1","TQueryParameters$1","InferOutput","NonNullable","path","query","args","FragnoReactMutator","TInputSchema","body","Promise","mutate","loading","error","data","FragnoReactStore","T","TStore","K","useFragno","Record","TPath","TOutputSchema","TErrorCode","TQueryParameters","TMethod","TInput","TOutput","TError","TStoreObj","clientObj","StoreKeys","setKey","k","v","UseStoreOptions","SomeStore","deps","keys","useStore","store","options","FragnoHydrator","children","React","ReactNode"],"sources":["../../../../fragno/dist/client/react.d.ts","../../../src/client/react.ts"],"mappings":";;;;;;;;;KAYKiB,eAAAA,yEAAwFD,gBAAAA,qEAAqFW,IAAAA;EAChLF,IAAAA,GAAOvB,6BAAAA,CAA8BiB,OAAAA,WAAkBT,YAAAA;EACvDgB,KAAAA,GAAQvB,eAAAA,CAAgBmB,kBAAAA,WAA6BZ,YAAAA;AAAAA,MACjDG,YAAAA,CAAaG,gBAAAA,CAAiBO,WAAAA,CAAYH,eAAAA,GAAkBd,iBAAAA,CAAkBkB,WAAAA,CAAYH,YAAAA;AAAAA,KAC3FO,kBAAAA,kBAAoCvB,gBAAAA,+CAA+DW,gBAAAA,sCAAsDA,gBAAAA;EAC5JgB,MAAAA;IACEF,IAAAA;IACAL,IAAAA;IACAC;EAAAA;IAEAI,IAAAA,GAAO1B,OAAAA,CAAQyB,YAAAA;IACfJ,IAAAA,GAAOxB,aAAAA,CAAckB,OAAAA,iBAAwBnB,wBAAAA,CAAyBmB,OAAAA,WAAkBT,YAAAA;IACxFgB,KAAAA,GAAQvB,eAAAA,CAAgBmB,kBAAAA,WAA6BZ,YAAAA;EAAAA,MACjDqB,OAAAA,CAAQ3B,OAAAA,CAAQgB,eAAAA;EACtBa,OAAAA;EACAC,KAAAA,GAAQ5B,iBAAAA,CAAkBkB,WAAAA,CAAYH,YAAAA;EACtCc,IAAAA,GAAO/B,OAAAA,CAAQgB,eAAAA;AAAAA;;;;;;iBCxBD,sBAAA,CAAuB,MAAA,GAAQ,wBAAA;;QAA6B,GAAA,CAAA,SAAA"}
+{"version":3,"file":"react.d.ts","names":["ExtractPathParamsOrWiden","HasPathParams","MaybeExtractPathParamsOrWiden","QueryParamsHint","InferOr","FragnoClientError","FragnoClientHookData","FragnoClientMutatorData","FragnoStoreFactoryData","FragnoStoreObjectData","NonGetHTTPMethod","ReadableAtom","Store","StoreValue","FetcherValue","react0","DependencyList","StandardSchemaV1","FragnoReactHook","_TMethod","TPath$1","TOutputSchema$1","TErrorCode$1","TQueryParameters$1","InferOutput","NonNullable","path","query","args","FragnoReactMutator","TInputSchema","body","Promise","mutate","loading","error","data","FragnoReactStoreValue","T","TStore","K","FragnoReactStore","TArgs","useFragno","Record","TPath","TOutputSchema","TErrorCode","TQueryParameters","TMethod","TInput","TOutput","TError","TStoreObj","TStoreArgs","clientObj","StoreKeys","setKey","k","v","UseStoreOptions","SomeStore","deps","keys","useStore","store","options","FragnoHydrator","children","React","ReactNode"],"sources":["../../../../fragno/dist/client/react.d.ts","../../../src/client/react.ts"],"mappings":";;;;;;;;;;;;KAYKkB,eAAAA,yEAAwFD,gBAAAA,qEAAqFW,IAAAA;EAChLF,IAAAA,GAAOxB,6BAAAA,CAA8BkB,OAAAA,WAAkBT,YAAAA;EACvDgB,KAAAA,GAAQxB,eAAAA,CAAgBoB,kBAAAA,WAA6BZ,YAAAA;AAAAA,MACjDG,YAAAA,CAAaG,gBAAAA,CAAiBO,WAAAA,CAAYH,eAAAA,GAAkBhB,iBAAAA,CAAkBoB,WAAAA,CAAYH,YAAAA;AAAAA,KAC3FO,kBAAAA,kBAAoCnB,gBAAAA,+CAA+DO,gBAAAA,sCAAsDA,gBAAAA;EAC5JgB,MAAAA;IACEF,IAAAA;IACAL,IAAAA;IACAC;EAAAA;IAEAI,IAAAA,GAAO3B,OAAAA,CAAQ0B,YAAAA;IACfJ,IAAAA,GAAOzB,aAAAA,CAAcmB,OAAAA,iBAAwBpB,wBAAAA,CAAyBoB,OAAAA,WAAkBT,YAAAA;IACxFgB,KAAAA,GAAQxB,eAAAA,CAAgBoB,kBAAAA,WAA6BZ,YAAAA;EAAAA,MACjDqB,OAAAA,CAAQ5B,OAAAA,CAAQiB,eAAAA;EACtBa,OAAAA;EACAC,KAAAA,GAAQ9B,iBAAAA,CAAkBoB,WAAAA,CAAYH,YAAAA;EACtCc,IAAAA,GAAOhC,OAAAA,CAAQiB,eAAAA;AAAAA;;;;KAKZgB,qBAAAA,qBAA0CC,CAAAA,SAAU1B,KAAAA,iBAAsBC,UAAAA,CAAW0B,MAAAA,kBAAwBD,CAAAA,GAAIA,CAAAA,CAAEE,CAAAA,UAAW5B,KAAAA,GAAQC,UAAAA,CAAWyB,CAAAA,CAAEE,CAAAA,KAAMF,CAAAA,CAAEE,CAAAA;AAAAA,KAC3JC,gBAAAA,uDAAuEb,IAAAA,EAAMc,KAAAA,KAAUL,qBAAAA,CAAsBC,CAAAA;;;iBC9BlG,sBAAA,CAAuB,MAAA,GAAQ,sBAAA;;QAA2B,GAAA,CAAA,SAAA"}

package/dist/browser/client/react.js

@@ -1,16 +1,7 @@
-import { f as isGetHook, h as isReadableAtom, m as isStore, o as createPiFragmentClients, p as isMutatorHook } from "../factory-DKoO_lRA.js";
-import "../index.js";
-import { useCallback, useMemo, useRef, useSyncExternalStore } from "react";
+import { d as isStore, f as isReadableAtom, l as isGetHook, t as createPiFragmentClients, u as isMutatorHook } from "../clients-BscY_HVe.js";
+import { listenKeys } from "nanostores";
+import { useCallback, useEffect, useMemo, useRef, useSyncExternalStore } from "react";
 
-//#region ../../node_modules/.pnpm/nanostores@1.1.0/node_modules/nanostores/listen-keys/index.js
-function listenKeys($store, keys, listener) {
-	let keysSet = new Set(keys).add(void 0);
-	return $store.listen((value, oldValue, changed) => {
-		if (keysSet.has(changed)) listener(value, oldValue, changed);
-	});
-}
-
-//#endregion
 //#region ../fragno/dist/client/react.js
 function createReactHook(hook) {
 	return ({ path, query } = {}) => {
@@ -29,17 +20,109 @@ function createReactMutator(hook) {
 		return useStore(useMemo(() => hook.mutatorStore, [hook]));
 	};
 }
-function createReactStore(hook) {
-	if (isReadableAtom(hook.obj)) return () => useStore(hook.obj);
-	return () => {
-		const result = {};
-		for (const key in hook.obj) {
-			if (!Object.prototype.hasOwnProperty.call(hook.obj, key)) continue;
-			const value = hook.obj[key];
-			if (isReadableAtom(value)) result[key] = useStore(value);
-			else result[key] = value;
+const isPlainObject = (value) => {
+	if (!value || typeof value !== "object") return false;
+	const prototype = Object.getPrototypeOf(value);
+	return prototype === Object.prototype || prototype === null;
+};
+const areStoreFactoryValuesEqual = (left, right) => {
+	if (Object.is(left, right)) return true;
+	if (Array.isArray(left) && Array.isArray(right)) return left.length === right.length && left.every((value, index) => areStoreFactoryValuesEqual(value, right[index]));
+	if (left instanceof Date && right instanceof Date) return left.getTime() === right.getTime();
+	if (isReadableAtom(left) || isReadableAtom(right)) return left === right;
+	if (typeof left === "function" || typeof right === "function") return left === right;
+	if (isPlainObject(left) && isPlainObject(right)) {
+		const leftKeys = Object.keys(left).sort();
+		const rightKeys = Object.keys(right).sort();
+		return leftKeys.length === rightKeys.length && leftKeys.every((key, index) => key === rightKeys[index] && areStoreFactoryValuesEqual(left[key], right[key]));
+	}
+	return false;
+};
+const areStoreFactoryArgsEqual = (left, right) => left.length === right.length && left.every((value, index) => areStoreFactoryValuesEqual(value, right[index]));
+const getStoreDisposer = (value) => {
+	const disposer = value[Symbol.dispose];
+	return typeof disposer === "function" ? disposer.bind(value) : void 0;
+};
+const createReactStoreObjectView = (value, getAtomValue) => {
+	const atomValues = /* @__PURE__ */ new Map();
+	const boundMethods = /* @__PURE__ */ new Map();
+	return new Proxy(value, { get(target, property, _receiver) {
+		const propertyValue = Reflect.get(target, property, target);
+		if (isReadableAtom(propertyValue)) {
+			if (atomValues.has(propertyValue)) return atomValues.get(propertyValue);
+			const atomValue = getAtomValue(propertyValue);
+			atomValues.set(propertyValue, atomValue);
+			return atomValue;
 		}
-		return result;
+		if (typeof propertyValue === "function") {
+			if (boundMethods.has(property)) return boundMethods.get(property);
+			const boundMethod = propertyValue.bind(target);
+			boundMethods.set(property, boundMethod);
+			return boundMethod;
+		}
+		return propertyValue;
+	} });
+};
+function unwrapReactStoreValueOnServer(value) {
+	if (isReadableAtom(value)) return value.get();
+	return createReactStoreObjectView(value, (store) => store.get());
+}
+function unwrapReactStoreValue(value) {
+	if (isReadableAtom(value)) return useStore(value);
+	const atomEntries = Object.keys(value).flatMap((key) => {
+		const fieldValue = value[key];
+		return isReadableAtom(fieldValue) ? [[key, fieldValue]] : [];
+	});
+	const snapshotRef = useRef(atomEntries.map(([, store]) => store.get()));
+	const getSnapshot = () => {
+		const nextSnapshot = atomEntries.map(([, store]) => store.get());
+		const previousSnapshot = snapshotRef.current;
+		if (previousSnapshot.length === nextSnapshot.length && previousSnapshot.every((entry, index) => Object.is(entry, nextSnapshot[index]))) return previousSnapshot;
+		snapshotRef.current = nextSnapshot;
+		return nextSnapshot;
+	};
+	const atomValues = useSyncExternalStore((onStoreChange) => {
+		const unsubscribes = atomEntries.map(([, store]) => store.listen(onStoreChange));
+		return () => {
+			for (const unsubscribe of unsubscribes) unsubscribe();
+		};
+	}, getSnapshot, getSnapshot);
+	return useMemo(() => createReactStoreObjectView(value, (store) => {
+		const atomIndex = atomEntries.findIndex(([, entryStore]) => entryStore === store);
+		return atomIndex === -1 ? store.get() : atomValues[atomIndex];
+	}), [
+		value,
+		atomEntries,
+		atomValues
+	]);
+}
+function createReactStore(hook) {
+	return (...args) => {
+		const stableArgsRef = useRef(args);
+		const pendingDisposalsRef = useRef(/* @__PURE__ */ new Map());
+		if (!areStoreFactoryArgsEqual(stableArgsRef.current, args)) stableArgsRef.current = args;
+		const value = useMemo(() => {
+			if ("factory" in hook) return hook.factory(...stableArgsRef.current);
+			return hook.obj;
+		}, [hook, stableArgsRef.current]);
+		useEffect(() => {
+			const disposer = getStoreDisposer(value);
+			const pendingTimeout = pendingDisposalsRef.current.get(value);
+			if (pendingTimeout !== void 0) {
+				clearTimeout(pendingTimeout);
+				pendingDisposalsRef.current.delete(value);
+			}
+			return () => {
+				if (!disposer) return;
+				const timeoutId = setTimeout(() => {
+					pendingDisposalsRef.current.delete(value);
+					disposer();
+				}, 0);
+				pendingDisposalsRef.current.set(value, timeoutId);
+			};
+		}, [value]);
+		if (typeof window === "undefined") return unwrapReactStoreValueOnServer(value);
+		return unwrapReactStoreValue(value);
 	};
 }
 function useFragno(clientObj) {

package/dist/browser/client/react.js.map

@@ -1 +1 @@
-{"version":3,"file":"react.js","names":["listenKeys","$store","keys","listener","keysSet","Set","add","undefined","listen","value","oldValue","changed","has","subscribeKeys","unbind","hydrateFromWindow","isReadableAtom","isGetHook","isMutatorHook","isStore","listenKeys","useCallback","useMemo","useRef","useSyncExternalStore","createReactHook","hook","path","query","pathParamValues","Object","values","queryParamValues","store","window","get","useStore","createReactMutator","mutatorStore","createReactStore","obj","result","key","prototype","hasOwnProperty","call","value","useFragno","clientObj","options","snapshotRef","keys","deps","subscribe","onChange","emitChange","current","length","listen","FragnoHydrator","children","useFragno","FragnoPublicClientConfig","createPiFragmentClients","createPiFragmentClient","config"],"sources":["../../../../../node_modules/.pnpm/nanostores@1.1.0/node_modules/nanostores/listen-keys/index.js","../../../../fragno/dist/client/react.js","../../../src/client/react.ts"],"sourcesContent":["export function listenKeys($store, keys, listener) {\n  let keysSet = new Set(keys).add(undefined)\n  return $store.listen((value, oldValue, changed) => {\n    if (keysSet.has(changed)) {\n      listener(value, oldValue, changed)\n    }\n  })\n}\n\nexport function subscribeKeys($store, keys, listener) {\n  let unbind = listenKeys($store, keys, listener)\n  listener($store.value)\n  return unbind\n}\n","import { hydrateFromWindow } from \"../util/ssr.js\";\nimport { isReadableAtom } from \"../util/nanostores.js\";\nimport { isGetHook, isMutatorHook, isStore } from \"./client.js\";\nimport { listenKeys } from \"nanostores\";\nimport { useCallback, useMemo, useRef, useSyncExternalStore } from \"react\";\n\n//#region src/client/react.ts\nfunction createReactHook(hook) {\n\treturn ({ path, query } = {}) => {\n\t\tconst pathParamValues = path ? Object.values(path) : [];\n\t\tconst queryParamValues = query ? Object.values(query) : [];\n\t\tconst store = useMemo(() => hook.store({\n\t\t\tpath,\n\t\t\tquery\n\t\t}), [hook, ...[...pathParamValues, ...queryParamValues]]);\n\t\tif (typeof window === \"undefined\") return store.get();\n\t\treturn useStore(store);\n\t};\n}\nfunction createReactMutator(hook) {\n\treturn () => {\n\t\treturn useStore(useMemo(() => hook.mutatorStore, [hook]));\n\t};\n}\nfunction createReactStore(hook) {\n\tif (isReadableAtom(hook.obj)) return () => useStore(hook.obj);\n\treturn () => {\n\t\tconst result = {};\n\t\tfor (const key in hook.obj) {\n\t\t\tif (!Object.prototype.hasOwnProperty.call(hook.obj, key)) continue;\n\t\t\tconst value = hook.obj[key];\n\t\t\tif (isReadableAtom(value)) result[key] = useStore(value);\n\t\t\telse result[key] = value;\n\t\t}\n\t\treturn result;\n\t};\n}\nfunction useFragno(clientObj) {\n\tconst result = {};\n\tfor (const key in clientObj) {\n\t\tif (!Object.prototype.hasOwnProperty.call(clientObj, key)) continue;\n\t\tconst hook = clientObj[key];\n\t\tif (isGetHook(hook)) result[key] = createReactHook(hook);\n\t\telse if (isMutatorHook(hook)) result[key] = createReactMutator(hook);\n\t\telse if (isStore(hook)) result[key] = createReactStore(hook);\n\t\telse result[key] = hook;\n\t}\n\treturn result;\n}\nfunction useStore(store, options = {}) {\n\tconst snapshotRef = useRef(store.get());\n\tconst { keys, deps = [store, keys] } = options;\n\tconst subscribe = useCallback((onChange) => {\n\t\tconst emitChange = (value) => {\n\t\t\tif (snapshotRef.current === value) return;\n\t\t\tsnapshotRef.current = value;\n\t\t\tonChange();\n\t\t};\n\t\temitChange(store.value);\n\t\tif (keys?.length) return listenKeys(store, keys, emitChange);\n\t\treturn store.listen(emitChange);\n\t}, deps);\n\tconst get = () => snapshotRef.current;\n\treturn useSyncExternalStore(subscribe, get, () => {\n\t\treturn get();\n\t});\n}\nfunction FragnoHydrator({ children }) {\n\tuseMemo(() => {\n\t\thydrateFromWindow();\n\t}, []);\n\treturn children;\n}\n\n//#endregion\nexport { FragnoHydrator, useFragno, useStore };\n//# sourceMappingURL=react.js.map","import { useFragno } from \"@fragno-dev/core/react\";\nimport type { FragnoPublicClientConfig } from \"@fragno-dev/core/client\";\nimport { createPiFragmentClients } from \"..\";\n\nexport function createPiFragmentClient(config: FragnoPublicClientConfig = {}) {\n  return useFragno(createPiFragmentClients(config));\n}\n"],"x_google_ignoreList":[0],"mappings":";;;;;AAAA,SAAgBA,WAAWC,QAAQC,MAAMC,UAAU;CACjD,IAAIC,UAAU,IAAIC,IAAIH,KAAK,CAACI,IAAIC,OAAU;AAC1C,QAAON,OAAOO,QAAQC,OAAOC,UAAUC,YAAY;AACjD,MAAIP,QAAQQ,IAAID,QAAQ,CACtBR,UAASM,OAAOC,UAAUC,QAAQ;GAEpC;;;;;ACCJ,SAASc,gBAAgBC,MAAM;AAC9B,SAAQ,EAAEC,MAAMC,UAAU,EAAE,KAAK;EAChC,MAAMC,kBAAkBF,OAAOG,OAAOC,OAAOJ,KAAK,GAAG,EAAE;EACvD,MAAMK,mBAAmBJ,QAAQE,OAAOC,OAAOH,MAAM,GAAG,EAAE;EAC1D,MAAMK,QAAQX,cAAcI,KAAKO,MAAM;GACtCN;GACAC;GACA,CAAC,EAAE,CAACF,MAAM,GAAG,CAAC,GAAGG,iBAAiB,GAAGG,iBAAiB,CAAC,CAAC;AACzD,MAAI,OAAOE,WAAW,YAAa,QAAOD,MAAME,KAAK;AACrD,SAAOC,SAASH,MAAM;;;AAGxB,SAASI,mBAAmBX,MAAM;AACjC,cAAa;AACZ,SAAOU,SAASd,cAAcI,KAAKY,cAAc,CAACZ,KAAK,CAAC,CAAC;;;AAG3D,SAASa,iBAAiBb,MAAM;AAC/B,KAAIV,eAAeU,KAAKc,IAAI,CAAE,cAAaJ,SAASV,KAAKc,IAAI;AAC7D,cAAa;EACZ,MAAMC,SAAS,EAAE;AACjB,OAAK,MAAMC,OAAOhB,KAAKc,KAAK;AAC3B,OAAI,CAACV,OAAOa,UAAUC,eAAeC,KAAKnB,KAAKc,KAAKE,IAAI,CAAE;GAC1D,MAAMI,QAAQpB,KAAKc,IAAIE;AACvB,OAAI1B,eAAe8B,MAAM,CAAEL,QAAOC,OAAON,SAASU,MAAM;OACnDL,QAAOC,OAAOI;;AAEpB,SAAOL;;;AAGT,SAASM,UAAUC,WAAW;CAC7B,MAAMP,SAAS,EAAE;AACjB,MAAK,MAAMC,OAAOM,WAAW;AAC5B,MAAI,CAAClB,OAAOa,UAAUC,eAAeC,KAAKG,WAAWN,IAAI,CAAE;EAC3D,MAAMhB,OAAOsB,UAAUN;AACvB,MAAIzB,UAAUS,KAAK,CAAEe,QAAOC,OAAOjB,gBAAgBC,KAAK;WAC/CR,cAAcQ,KAAK,CAAEe,QAAOC,OAAOL,mBAAmBX,KAAK;WAC3DP,QAAQO,KAAK,CAAEe,QAAOC,OAAOH,iBAAiBb,KAAK;MACvDe,QAAOC,OAAOhB;;AAEpB,QAAOe;;AAER,SAASL,SAASH,OAAOgB,UAAU,EAAE,EAAE;CACtC,MAAMC,cAAc3B,OAAOU,MAAME,KAAK,CAAC;CACvC,MAAM,EAAEgB,MAAMC,OAAO,CAACnB,OAAOkB,KAAI,KAAMF;CACvC,MAAMI,YAAYhC,aAAaiC,aAAa;EAC3C,MAAMC,cAAcT,UAAU;AAC7B,OAAII,YAAYM,YAAYV,MAAO;AACnCI,eAAYM,UAAUV;AACtBQ,aAAU;;AAEXC,aAAWtB,MAAMa,MAAM;AACvB,MAAIK,MAAMM,OAAQ,QAAOrC,WAAWa,OAAOkB,MAAMI,WAAW;AAC5D,SAAOtB,MAAMyB,OAAOH,WAAW;IAC7BH,KAAK;CACR,MAAMjB,YAAYe,YAAYM;AAC9B,QAAOhC,qBAAqB6B,WAAWlB,WAAW;AACjD,SAAOA,KAAK;GACX;;;;;AC7DH,SAAgB6B,uBAAuBC,SAAmC,EAAE,EAAE;AAC5E,QAAOJ,UAAUE,wBAAwBE,OAAO,CAAC"}
+{"version":3,"file":"react.js","names":["isReadableAtom","hydrateFromWindow","isGetHook","isMutatorHook","isStore","listenKeys","useCallback","useEffect","useMemo","useRef","useSyncExternalStore","createReactHook","hook","path","query","pathParamValues","Object","values","queryParamValues","store","window","get","useStore","createReactMutator","mutatorStore","isPlainObject","value","prototype","getPrototypeOf","areStoreFactoryValuesEqual","left","right","is","Array","isArray","length","every","index","Date","getTime","leftKeys","keys","sort","rightKeys","key","areStoreFactoryArgsEqual","getStoreDisposer","disposer","Symbol","dispose","bind","createReactStoreObjectView","getAtomValue","atomValues","Map","boundMethods","Proxy","target","property","_receiver","propertyValue","Reflect","has","atomValue","set","boundMethod","unwrapReactStoreValueOnServer","unwrapReactStoreValue","atomEntries","flatMap","fieldValue","snapshotRef","map","getSnapshot","nextSnapshot","previousSnapshot","current","entry","onStoreChange","unsubscribes","listen","unsubscribe","atomIndex","findIndex","entryStore","createReactStore","args","stableArgsRef","pendingDisposalsRef","factory","obj","pendingTimeout","clearTimeout","delete","timeoutId","setTimeout","useFragno","clientObj","result","hasOwnProperty","call","options","deps","subscribe","onChange","emitChange","FragnoHydrator","children","useFragno","createPiFragmentClients","PiFragmentClientConfig","createPiFragmentClient","config"],"sources":["../../../../fragno/dist/client/react.js","../../../src/client/react.ts"],"sourcesContent":["import { isReadableAtom } from \"../util/nanostores.js\";\nimport { hydrateFromWindow } from \"../util/ssr.js\";\nimport { isGetHook, isMutatorHook, isStore } from \"./client.js\";\nimport { listenKeys } from \"nanostores\";\nimport { useCallback, useEffect, useMemo, useRef, useSyncExternalStore } from \"react\";\n\n//#region src/client/react.ts\nfunction createReactHook(hook) {\n\treturn ({ path, query } = {}) => {\n\t\tconst pathParamValues = path ? Object.values(path) : [];\n\t\tconst queryParamValues = query ? Object.values(query) : [];\n\t\tconst store = useMemo(() => hook.store({\n\t\t\tpath,\n\t\t\tquery\n\t\t}), [hook, ...[...pathParamValues, ...queryParamValues]]);\n\t\tif (typeof window === \"undefined\") return store.get();\n\t\treturn useStore(store);\n\t};\n}\nfunction createReactMutator(hook) {\n\treturn () => {\n\t\treturn useStore(useMemo(() => hook.mutatorStore, [hook]));\n\t};\n}\nconst isPlainObject = (value) => {\n\tif (!value || typeof value !== \"object\") return false;\n\tconst prototype = Object.getPrototypeOf(value);\n\treturn prototype === Object.prototype || prototype === null;\n};\nconst areStoreFactoryValuesEqual = (left, right) => {\n\tif (Object.is(left, right)) return true;\n\tif (Array.isArray(left) && Array.isArray(right)) return left.length === right.length && left.every((value, index) => areStoreFactoryValuesEqual(value, right[index]));\n\tif (left instanceof Date && right instanceof Date) return left.getTime() === right.getTime();\n\tif (isReadableAtom(left) || isReadableAtom(right)) return left === right;\n\tif (typeof left === \"function\" || typeof right === \"function\") return left === right;\n\tif (isPlainObject(left) && isPlainObject(right)) {\n\t\tconst leftKeys = Object.keys(left).sort();\n\t\tconst rightKeys = Object.keys(right).sort();\n\t\treturn leftKeys.length === rightKeys.length && leftKeys.every((key, index) => key === rightKeys[index] && areStoreFactoryValuesEqual(left[key], right[key]));\n\t}\n\treturn false;\n};\nconst areStoreFactoryArgsEqual = (left, right) => left.length === right.length && left.every((value, index) => areStoreFactoryValuesEqual(value, right[index]));\nconst getStoreDisposer = (value) => {\n\tconst disposer = value[Symbol.dispose];\n\treturn typeof disposer === \"function\" ? disposer.bind(value) : void 0;\n};\nconst createReactStoreObjectView = (value, getAtomValue) => {\n\tconst atomValues = /* @__PURE__ */ new Map();\n\tconst boundMethods = /* @__PURE__ */ new Map();\n\treturn new Proxy(value, { get(target, property, _receiver) {\n\t\tconst propertyValue = Reflect.get(target, property, target);\n\t\tif (isReadableAtom(propertyValue)) {\n\t\t\tif (atomValues.has(propertyValue)) return atomValues.get(propertyValue);\n\t\t\tconst atomValue = getAtomValue(propertyValue);\n\t\t\tatomValues.set(propertyValue, atomValue);\n\t\t\treturn atomValue;\n\t\t}\n\t\tif (typeof propertyValue === \"function\") {\n\t\t\tif (boundMethods.has(property)) return boundMethods.get(property);\n\t\t\tconst boundMethod = propertyValue.bind(target);\n\t\t\tboundMethods.set(property, boundMethod);\n\t\t\treturn boundMethod;\n\t\t}\n\t\treturn propertyValue;\n\t} });\n};\nfunction unwrapReactStoreValueOnServer(value) {\n\tif (isReadableAtom(value)) return value.get();\n\treturn createReactStoreObjectView(value, (store) => store.get());\n}\nfunction unwrapReactStoreValue(value) {\n\tif (isReadableAtom(value)) return useStore(value);\n\tconst atomEntries = Object.keys(value).flatMap((key) => {\n\t\tconst fieldValue = value[key];\n\t\treturn isReadableAtom(fieldValue) ? [[key, fieldValue]] : [];\n\t});\n\tconst snapshotRef = useRef(atomEntries.map(([, store]) => store.get()));\n\tconst getSnapshot = () => {\n\t\tconst nextSnapshot = atomEntries.map(([, store]) => store.get());\n\t\tconst previousSnapshot = snapshotRef.current;\n\t\tif (previousSnapshot.length === nextSnapshot.length && previousSnapshot.every((entry, index) => Object.is(entry, nextSnapshot[index]))) return previousSnapshot;\n\t\tsnapshotRef.current = nextSnapshot;\n\t\treturn nextSnapshot;\n\t};\n\tconst atomValues = useSyncExternalStore((onStoreChange) => {\n\t\tconst unsubscribes = atomEntries.map(([, store]) => store.listen(onStoreChange));\n\t\treturn () => {\n\t\t\tfor (const unsubscribe of unsubscribes) unsubscribe();\n\t\t};\n\t}, getSnapshot, getSnapshot);\n\treturn useMemo(() => createReactStoreObjectView(value, (store) => {\n\t\tconst atomIndex = atomEntries.findIndex(([, entryStore]) => entryStore === store);\n\t\treturn atomIndex === -1 ? store.get() : atomValues[atomIndex];\n\t}), [\n\t\tvalue,\n\t\tatomEntries,\n\t\tatomValues\n\t]);\n}\nfunction createReactStore(hook) {\n\treturn ((...args) => {\n\t\tconst stableArgsRef = useRef(args);\n\t\tconst pendingDisposalsRef = useRef(/* @__PURE__ */ new Map());\n\t\tif (!areStoreFactoryArgsEqual(stableArgsRef.current, args)) stableArgsRef.current = args;\n\t\tconst value = useMemo(() => {\n\t\t\tif (\"factory\" in hook) return hook.factory(...stableArgsRef.current);\n\t\t\treturn hook.obj;\n\t\t}, [hook, stableArgsRef.current]);\n\t\tuseEffect(() => {\n\t\t\tconst disposer = getStoreDisposer(value);\n\t\t\tconst pendingTimeout = pendingDisposalsRef.current.get(value);\n\t\t\tif (pendingTimeout !== void 0) {\n\t\t\t\tclearTimeout(pendingTimeout);\n\t\t\t\tpendingDisposalsRef.current.delete(value);\n\t\t\t}\n\t\t\treturn () => {\n\t\t\t\tif (!disposer) return;\n\t\t\t\tconst timeoutId = setTimeout(() => {\n\t\t\t\t\tpendingDisposalsRef.current.delete(value);\n\t\t\t\t\tdisposer();\n\t\t\t\t}, 0);\n\t\t\t\tpendingDisposalsRef.current.set(value, timeoutId);\n\t\t\t};\n\t\t}, [value]);\n\t\tif (typeof window === \"undefined\") return unwrapReactStoreValueOnServer(value);\n\t\treturn unwrapReactStoreValue(value);\n\t});\n}\nfunction useFragno(clientObj) {\n\tconst result = {};\n\tfor (const key in clientObj) {\n\t\tif (!Object.prototype.hasOwnProperty.call(clientObj, key)) continue;\n\t\tconst hook = clientObj[key];\n\t\tif (isGetHook(hook)) result[key] = createReactHook(hook);\n\t\telse if (isMutatorHook(hook)) result[key] = createReactMutator(hook);\n\t\telse if (isStore(hook)) result[key] = createReactStore(hook);\n\t\telse result[key] = hook;\n\t}\n\treturn result;\n}\nfunction useStore(store, options = {}) {\n\tconst snapshotRef = useRef(store.get());\n\tconst { keys, deps = [store, keys] } = options;\n\tconst subscribe = useCallback((onChange) => {\n\t\tconst emitChange = (value) => {\n\t\t\tif (snapshotRef.current === value) return;\n\t\t\tsnapshotRef.current = value;\n\t\t\tonChange();\n\t\t};\n\t\temitChange(store.value);\n\t\tif (keys?.length) return listenKeys(store, keys, emitChange);\n\t\treturn store.listen(emitChange);\n\t}, deps);\n\tconst get = () => snapshotRef.current;\n\treturn useSyncExternalStore(subscribe, get, () => {\n\t\treturn get();\n\t});\n}\nfunction FragnoHydrator({ children }) {\n\tuseMemo(() => {\n\t\thydrateFromWindow();\n\t}, []);\n\treturn children;\n}\n\n//#endregion\nexport { FragnoHydrator, useFragno, useStore };\n//# sourceMappingURL=react.js.map","import { useFragno } from \"@fragno-dev/core/react\";\n\nimport { createPiFragmentClients, type PiFragmentClientConfig } from \"./clients\";\n\nexport function createPiFragmentClient(config: PiFragmentClientConfig = {}) {\n  return useFragno(createPiFragmentClients(config));\n}\n"],"mappings":"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"}

package/dist/browser/client/solid.d.ts

@@ -1,5 +1,8 @@
-import { a as FragnoClientError, c as InferOr, d as MaybeExtractPathParamsOrWiden, f as QueryParamsHint, i as ReadableAtom, o as NonGetHTTPMethod, s as FragnoPublicClientConfig } from "../client-Bk-J98pf.js";
+import { $ as InferOr, Q as FragnoClientError, Y as FragnoStoreFactoryData, Z as NonGetHTTPMethod, c as PiFragmentClientConfig, d as PiSessionStoreView, nt as MaybeExtractPathParamsOrWiden, rt as QueryParamsHint, u as PiSessionStoreHookArgs, y as PiActiveSessionProtocolMessage } from "../routes-CpL_YGWK.js";
+import "../index.js";
+import { ReadableAtom, Store, StoreValue } from "nanostores";
 import * as zod from "zod";
+import * as _mariozechner_pi_agent_core0 from "@mariozechner/pi-agent-core";
 import { Accessor } from "solid-js";
 import * as zod_v4_core0 from "zod/v4/core";
 import * as _standard_schema_spec0 from "@standard-schema/spec";
@@ -32,7 +35,7 @@ type FragnoSolidMutator<_TMethod extends NonGetHTTPMethod, TPath$1 extends strin
  */
 //#endregion
 //#region src/client/solid.d.ts
-declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
+declare function createPiFragmentClient(config?: PiFragmentClientConfig): {
   useSessions: FragnoSolidHook<"GET", "/sessions", zod.ZodArray<zod.ZodObject<{
     id: zod.ZodString;
     name: zod.ZodNullable<zod.ZodString>;
@@ -45,7 +48,6 @@ declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
       waiting: "waiting";
     }>;
     agent: zod.ZodString;
-    workflowInstanceId: zod.ZodNullable<zod.ZodString>;
     steeringMode: zod.ZodEnum<{
       all: "all";
       "one-at-a-time": "one-at-a-time";
@@ -55,7 +57,7 @@ declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
     createdAt: zod.ZodDate;
     updatedAt: zod.ZodDate;
   }, zod_v4_core0.$strip>>, string, "limit">;
-  useSession: FragnoSolidHook<"GET", "/sessions/:sessionId", zod.ZodObject<{
+  useSessionDetail: FragnoSolidHook<"GET", "/sessions/:sessionId", zod.ZodObject<{
     id: zod.ZodString;
     name: zod.ZodNullable<zod.ZodString>;
     status: zod.ZodEnum<{
@@ -67,7 +69,6 @@ declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
       waiting: "waiting";
     }>;
     agent: zod.ZodString;
-    workflowInstanceId: zod.ZodNullable<zod.ZodString>;
     steeringMode: zod.ZodEnum<{
       all: "all";
       "one-at-a-time": "one-at-a-time";
@@ -97,20 +98,10 @@ declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
         type: zod.ZodLiteral<"text">;
         text: zod.ZodString;
         textSignature: zod.ZodOptional<zod.ZodString>;
-      }, zod_v4_core0.$strip>, zod.ZodObject<{
-        type: zod.ZodLiteral<"thinking">;
-        thinking: zod.ZodString;
-        thinkingSignature: zod.ZodOptional<zod.ZodString>;
       }, zod_v4_core0.$strip>, zod.ZodObject<{
         type: zod.ZodLiteral<"image">;
         data: zod.ZodString;
         mimeType: zod.ZodString;
-      }, zod_v4_core0.$strip>, zod.ZodObject<{
-        type: zod.ZodLiteral<"toolCall">;
-        id: zod.ZodString;
-        name: zod.ZodString;
-        arguments: zod.ZodRecord<zod.ZodString, zod.ZodUnknown>;
-        thoughtSignature: zod.ZodOptional<zod.ZodString>;
       }, zod_v4_core0.$strip>]>>]>;
       timestamp: zod.ZodNumber;
     }, zod_v4_core0.$strip>, zod.ZodObject<{
@@ -123,10 +114,6 @@ declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
         type: zod.ZodLiteral<"thinking">;
         thinking: zod.ZodString;
         thinkingSignature: zod.ZodOptional<zod.ZodString>;
-      }, zod_v4_core0.$strip>, zod.ZodObject<{
-        type: zod.ZodLiteral<"image">;
-        data: zod.ZodString;
-        mimeType: zod.ZodString;
       }, zod_v4_core0.$strip>, zod.ZodObject<{
         type: zod.ZodLiteral<"toolCall">;
         id: zod.ZodString;
@@ -151,7 +138,13 @@ declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
           total: zod.ZodNumber;
         }, zod_v4_core0.$strip>;
       }, zod_v4_core0.$strip>;
-      stopReason: zod.ZodString;
+      stopReason: zod.ZodEnum<{
+        length: "length";
+        error: "error";
+        stop: "stop";
+        toolUse: "toolUse";
+        aborted: "aborted";
+      }>;
       errorMessage: zod.ZodOptional<zod.ZodString>;
       timestamp: zod.ZodNumber;
     }, zod_v4_core0.$strip>, zod.ZodObject<{
@@ -162,38 +155,52 @@ declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
         type: zod.ZodLiteral<"text">;
         text: zod.ZodString;
         textSignature: zod.ZodOptional<zod.ZodString>;
-      }, zod_v4_core0.$strip>, zod.ZodObject<{
-        type: zod.ZodLiteral<"thinking">;
-        thinking: zod.ZodString;
-        thinkingSignature: zod.ZodOptional<zod.ZodString>;
       }, zod_v4_core0.$strip>, zod.ZodObject<{
         type: zod.ZodLiteral<"image">;
         data: zod.ZodString;
         mimeType: zod.ZodString;
-      }, zod_v4_core0.$strip>, zod.ZodObject<{
-        type: zod.ZodLiteral<"toolCall">;
-        id: zod.ZodString;
-        name: zod.ZodString;
-        arguments: zod.ZodRecord<zod.ZodString, zod.ZodUnknown>;
-        thoughtSignature: zod.ZodOptional<zod.ZodString>;
       }, zod_v4_core0.$strip>]>>;
       details: zod.ZodOptional<zod.ZodUnknown>;
       isError: zod.ZodBoolean;
       timestamp: zod.ZodNumber;
     }, zod_v4_core0.$strip>]>>;
-    trace: zod.ZodArray<zod.ZodObject<{
+    events: zod.ZodArray<zod.ZodObject<{
+      id: zod.ZodString;
+      runNumber: zod.ZodOptional<zod.ZodNullable<zod.ZodNumber>>;
       type: zod.ZodString;
-      timestamp: zod.ZodOptional<zod.ZodNumber>;
+      payload: zod.ZodNullable<zod.ZodUnknown>;
+      createdAt: zod.ZodDate;
+      deliveredAt: zod.ZodNullable<zod.ZodDate>;
+      consumedByStepKey: zod.ZodNullable<zod.ZodString>;
     }, zod_v4_core0.$strip>>;
+    trace: zod.ZodArray<zod.ZodType<_mariozechner_pi_agent_core0.AgentEvent, unknown, zod_v4_core0.$ZodTypeInternals<_mariozechner_pi_agent_core0.AgentEvent, unknown>>>;
+    turn: zod.ZodNumber;
+    phase: zod.ZodEnum<{
+      complete: "complete";
+      "waiting-for-user": "waiting-for-user";
+      "running-agent": "running-agent";
+    }>;
+    waitingFor: zod.ZodNullable<zod.ZodUnion<readonly [zod.ZodObject<{
+      type: zod.ZodLiteral<"user_message">;
+      turn: zod.ZodNumber;
+      stepKey: zod.ZodString;
+      timeoutMs: zod.ZodNullable<zod.ZodNumber>;
+    }, zod_v4_core0.$strip>, zod.ZodObject<{
+      type: zod.ZodLiteral<"assistant">;
+      turn: zod.ZodNumber;
+      stepKey: zod.ZodString;
+    }, zod_v4_core0.$strip>]>>;
     summaries: zod.ZodArray<zod.ZodObject<{
       turn: zod.ZodNumber;
       assistant: zod.ZodNullable<zod.ZodAny>;
       summary: zod.ZodNullable<zod.ZodString>;
     }, zod_v4_core0.$strip>>;
-  }, zod_v4_core0.$strip>, "WORKFLOWS_REQUIRED" | "SESSION_NOT_FOUND" | "WORKFLOW_INSTANCE_MISSING", string>;
+  }, zod_v4_core0.$strip>, "SESSION_NOT_FOUND" | "WORKFLOW_INSTANCE_MISSING", "events" | "trace" | "summaries">;
+  useSession: FragnoStoreFactoryData<PiSessionStoreView, [args: PiSessionStoreHookArgs]>;
   useCreateSession: FragnoSolidMutator<NonGetHTTPMethod, "/sessions", _standard_schema_spec0.StandardSchemaV1<unknown, unknown> | zod.ZodObject<{
     agent: zod.ZodString;
     name: zod.ZodOptional<zod.ZodString>;
+    systemMessage: zod.ZodOptional<zod.ZodString>;
     metadata: zod.ZodOptional<zod.ZodAny>;
     tags: zod.ZodOptional<zod.ZodArray<zod.ZodString>>;
     steeringMode: zod.ZodOptional<zod.ZodEnum<{
@@ -212,7 +219,6 @@ declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
       waiting: "waiting";
     }>;
     agent: zod.ZodString;
-    workflowInstanceId: zod.ZodNullable<zod.ZodString>;
     steeringMode: zod.ZodEnum<{
       all: "all";
       "one-at-a-time": "one-at-a-time";
@@ -233,7 +239,6 @@ declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
       waiting: "waiting";
     }>;
     agent: zod.ZodString;
-    workflowInstanceId: zod.ZodNullable<zod.ZodString>;
     steeringMode: zod.ZodEnum<{
       all: "all";
       "one-at-a-time": "one-at-a-time";
@@ -243,6 +248,7 @@ declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
     createdAt: zod.ZodDate;
     updatedAt: zod.ZodDate;
   }, zod_v4_core0.$strip>> | undefined, string, string>;
+  useActiveSession: FragnoSolidHook<"GET", "/sessions/:sessionId/active", zod.ZodArray<zod.ZodType<PiActiveSessionProtocolMessage, unknown, zod_v4_core0.$ZodTypeInternals<PiActiveSessionProtocolMessage, unknown>>>, "SESSION_NOT_FOUND" | "WORKFLOW_INSTANCE_MISSING", string>;
   useSendMessage: FragnoSolidMutator<NonGetHTTPMethod, "/sessions/:sessionId/messages", zod.ZodObject<{
     text: zod.ZodString;
     done: zod.ZodOptional<zod.ZodBoolean>;
@@ -259,7 +265,7 @@ declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
       complete: "complete";
       waiting: "waiting";
     }>;
-  }, zod_v4_core0.$strip> | undefined, "WORKFLOWS_REQUIRED" | "SESSION_NOT_FOUND" | "WORKFLOW_INSTANCE_MISSING", string>;
+  }, zod_v4_core0.$strip> | undefined, "SESSION_NOT_FOUND" | "WORKFLOW_INSTANCE_MISSING" | "SESSION_NOT_READY", string>;
 };
 //#endregion
 export { createPiFragmentClient };