@fragno-dev/pi-fragment 0.0.1 → 0.0.3

package/dist/node/pi/route-schemas.js

@@ -2,12 +2,16 @@ import { SESSION_STATUSES, STEERING_MODES } from "./constants.js";
 import { z } from "zod";
 
 //#region src/pi/route-schemas.ts
+const AGENT_LOOP_PHASES = [
+	"waiting-for-user",
+	"running-agent",
+	"complete"
+];
 const sessionBaseSchema = z.object({
 	id: z.string(),
 	name: z.string().nullable(),
 	status: z.enum(SESSION_STATUSES),
 	agent: z.string(),
-	workflowInstanceId: z.string().nullable(),
 	steeringMode: z.enum(STEERING_MODES),
 	metadata: z.any().nullable(),
 	tags: z.array(z.string()),
@@ -36,12 +40,13 @@ const ToolCallSchema = z.object({
 	arguments: z.record(z.string(), z.unknown()),
 	thoughtSignature: z.string().optional()
 });
-const ContentSchema = z.union([
+const UserContentSchema = z.union([TextContentSchema, ImageContentSchema]);
+const AssistantContentSchema = z.union([
 	TextContentSchema,
 	ThinkingContentSchema,
-	ImageContentSchema,
 	ToolCallSchema
 ]);
+const ToolResultContentSchema = z.union([TextContentSchema, ImageContentSchema]);
 const UsageSchema = z.object({
 	input: z.number(),
 	output: z.number(),
@@ -59,17 +64,23 @@ const UsageSchema = z.object({
 const MessageSchema = z.union([
 	z.object({
 		role: z.literal("user"),
-		content: z.union([z.string(), z.array(ContentSchema)]),
+		content: z.union([z.string(), z.array(UserContentSchema)]),
 		timestamp: z.number()
 	}),
 	z.object({
 		role: z.literal("assistant"),
-		content: z.array(ContentSchema),
+		content: z.array(AssistantContentSchema),
 		api: z.string(),
 		provider: z.string(),
 		model: z.string(),
 		usage: UsageSchema,
-		stopReason: z.string(),
+		stopReason: z.enum([
+			"stop",
+			"length",
+			"toolUse",
+			"error",
+			"aborted"
+		]),
 		errorMessage: z.string().optional(),
 		timestamp: z.number()
 	}),
@@ -77,16 +88,32 @@ const MessageSchema = z.union([
 		role: z.literal("toolResult"),
 		toolCallId: z.string(),
 		toolName: z.string(),
-		content: z.array(ContentSchema),
+		content: z.array(ToolResultContentSchema),
 		details: z.unknown().optional(),
 		isError: z.boolean(),
 		timestamp: z.number()
 	})
 ]);
-const TraceSchema = z.object({
+const TraceSchema = z.custom();
+const EventSchema = z.object({
+	id: z.string(),
+	runNumber: z.number().nullable().optional(),
 	type: z.string(),
-	timestamp: z.number().optional()
+	payload: z.unknown().nullable(),
+	createdAt: z.date(),
+	deliveredAt: z.date().nullable(),
+	consumedByStepKey: z.string().nullable()
 });
+const WaitingForSchema = z.union([z.object({
+	type: z.literal("user_message"),
+	turn: z.number(),
+	stepKey: z.string(),
+	timeoutMs: z.number().nullable()
+}), z.object({
+	type: z.literal("assistant"),
+	turn: z.number(),
+	stepKey: z.string()
+})]).nullable();
 const workflowStatusSchema = z.object({
 	status: z.enum(SESSION_STATUSES),
 	error: z.object({
@@ -98,7 +125,11 @@ const workflowStatusSchema = z.object({
 const sessionDetailSchema = sessionBaseSchema.extend({
 	workflow: workflowStatusSchema,
 	messages: z.array(MessageSchema),
+	events: z.array(EventSchema),
 	trace: z.array(TraceSchema),
+	turn: z.number(),
+	phase: z.enum(AGENT_LOOP_PHASES),
+	waitingFor: WaitingForSchema,
 	summaries: z.array(z.object({
 		turn: z.number(),
 		assistant: z.any().nullable(),
@@ -106,7 +137,8 @@ const sessionDetailSchema = sessionBaseSchema.extend({
 	}))
 });
 const messageAckSchema = z.object({ status: z.enum(SESSION_STATUSES) });
+const activeSessionStreamItemSchema = z.custom();
 
 //#endregion
-export { messageAckSchema, sessionBaseSchema, sessionDetailSchema };
+export { activeSessionStreamItemSchema, messageAckSchema, sessionBaseSchema, sessionDetailSchema };
 //# sourceMappingURL=route-schemas.js.map

package/dist/node/pi/route-schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"route-schemas.js","names":[],"sources":["../../../src/pi/route-schemas.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { SESSION_STATUSES, STEERING_MODES } from \"./constants\";\n\nconst sessionBaseSchema = z.object({\n  id: z.string(),\n  name: z.string().nullable(),\n  status: z.enum(SESSION_STATUSES),\n  agent: z.string(),\n  workflowInstanceId: z.string().nullable(),\n  steeringMode: z.enum(STEERING_MODES),\n  metadata: z.any().nullable(),\n  tags: z.array(z.string()),\n  createdAt: z.date(),\n  updatedAt: z.date(),\n});\n\nconst TextContentSchema = z.object({\n  type: z.literal(\"text\"),\n  text: z.string(),\n  textSignature: z.string().optional(),\n});\n\nconst ThinkingContentSchema = z.object({\n  type: z.literal(\"thinking\"),\n  thinking: z.string(),\n  thinkingSignature: z.string().optional(),\n});\n\nconst ImageContentSchema = z.object({\n  type: z.literal(\"image\"),\n  data: z.string(),\n  mimeType: z.string(),\n});\n\nconst ToolCallSchema = z.object({\n  type: z.literal(\"toolCall\"),\n  id: z.string(),\n  name: z.string(),\n  arguments: z.record(z.string(), z.unknown()),\n  thoughtSignature: z.string().optional(),\n});\n\nconst ContentSchema = z.union([\n  TextContentSchema,\n  ThinkingContentSchema,\n  ImageContentSchema,\n  ToolCallSchema,\n]);\n\nconst UsageSchema = z.object({\n  input: z.number(),\n  output: z.number(),\n  cacheRead: z.number(),\n  cacheWrite: z.number(),\n  totalTokens: z.number(),\n  cost: z.object({\n    input: z.number(),\n    output: z.number(),\n    cacheRead: z.number(),\n    cacheWrite: z.number(),\n    total: z.number(),\n  }),\n});\n\nconst MessageSchema = z.union([\n  z.object({\n    role: z.literal(\"user\"),\n    content: z.union([z.string(), z.array(ContentSchema)]),\n    timestamp: z.number(),\n  }),\n  z.object({\n    role: z.literal(\"assistant\"),\n    content: z.array(ContentSchema),\n    api: z.string(),\n    provider: z.string(),\n    model: z.string(),\n    usage: UsageSchema,\n    stopReason: z.string(),\n    errorMessage: z.string().optional(),\n    timestamp: z.number(),\n  }),\n  z.object({\n    role: z.literal(\"toolResult\"),\n    toolCallId: z.string(),\n    toolName: z.string(),\n    content: z.array(ContentSchema),\n    details: z.unknown().optional(),\n    isError: z.boolean(),\n    timestamp: z.number(),\n  }),\n]);\n\nconst TraceSchema = z.object({\n  type: z.string(),\n  timestamp: z.number().optional(),\n});\n\nconst workflowStatusSchema = z.object({\n  status: z.enum(SESSION_STATUSES),\n  error: z\n    .object({\n      name: z.string(),\n      message: z.string(),\n    })\n    .optional(),\n  output: z.any().optional(),\n});\n\nconst sessionDetailSchema = sessionBaseSchema.extend({\n  workflow: workflowStatusSchema,\n  messages: z.array(MessageSchema),\n  trace: z.array(TraceSchema),\n  summaries: z.array(\n    z.object({\n      turn: z.number(),\n      assistant: z.any().nullable(),\n      summary: z.string().nullable(),\n    }),\n  ),\n});\n\nconst messageAckSchema = z.object({\n  status: z.enum(SESSION_STATUSES),\n});\n\nexport { messageAckSchema, sessionBaseSchema, sessionDetailSchema, workflowStatusSchema };\n"],"mappings":";;;;AAIA,MAAM,oBAAoB,EAAE,OAAO;CACjC,IAAI,EAAE,QAAQ;CACd,MAAM,EAAE,QAAQ,CAAC,UAAU;CAC3B,QAAQ,EAAE,KAAK,iBAAiB;CAChC,OAAO,EAAE,QAAQ;CACjB,oBAAoB,EAAE,QAAQ,CAAC,UAAU;CACzC,cAAc,EAAE,KAAK,eAAe;CACpC,UAAU,EAAE,KAAK,CAAC,UAAU;CAC5B,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;CACzB,WAAW,EAAE,MAAM;CACnB,WAAW,EAAE,MAAM;CACpB,CAAC;AAEF,MAAM,oBAAoB,EAAE,OAAO;CACjC,MAAM,EAAE,QAAQ,OAAO;CACvB,MAAM,EAAE,QAAQ;CAChB,eAAe,EAAE,QAAQ,CAAC,UAAU;CACrC,CAAC;AAEF,MAAM,wBAAwB,EAAE,OAAO;CACrC,MAAM,EAAE,QAAQ,WAAW;CAC3B,UAAU,EAAE,QAAQ;CACpB,mBAAmB,EAAE,QAAQ,CAAC,UAAU;CACzC,CAAC;AAEF,MAAM,qBAAqB,EAAE,OAAO;CAClC,MAAM,EAAE,QAAQ,QAAQ;CACxB,MAAM,EAAE,QAAQ;CAChB,UAAU,EAAE,QAAQ;CACrB,CAAC;AAEF,MAAM,iBAAiB,EAAE,OAAO;CAC9B,MAAM,EAAE,QAAQ,WAAW;CAC3B,IAAI,EAAE,QAAQ;CACd,MAAM,EAAE,QAAQ;CAChB,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,SAAS,CAAC;CAC5C,kBAAkB,EAAE,QAAQ,CAAC,UAAU;CACxC,CAAC;AAEF,MAAM,gBAAgB,EAAE,MAAM;CAC5B;CACA;CACA;CACA;CACD,CAAC;AAEF,MAAM,cAAc,EAAE,OAAO;CAC3B,OAAO,EAAE,QAAQ;CACjB,QAAQ,EAAE,QAAQ;CAClB,WAAW,EAAE,QAAQ;CACrB,YAAY,EAAE,QAAQ;CACtB,aAAa,EAAE,QAAQ;CACvB,MAAM,EAAE,OAAO;EACb,OAAO,EAAE,QAAQ;EACjB,QAAQ,EAAE,QAAQ;EAClB,WAAW,EAAE,QAAQ;EACrB,YAAY,EAAE,QAAQ;EACtB,OAAO,EAAE,QAAQ;EAClB,CAAC;CACH,CAAC;AAEF,MAAM,gBAAgB,EAAE,MAAM;CAC5B,EAAE,OAAO;EACP,MAAM,EAAE,QAAQ,OAAO;EACvB,SAAS,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,MAAM,cAAc,CAAC,CAAC;EACtD,WAAW,EAAE,QAAQ;EACtB,CAAC;CACF,EAAE,OAAO;EACP,MAAM,EAAE,QAAQ,YAAY;EAC5B,SAAS,EAAE,MAAM,cAAc;EAC/B,KAAK,EAAE,QAAQ;EACf,UAAU,EAAE,QAAQ;EACpB,OAAO,EAAE,QAAQ;EACjB,OAAO;EACP,YAAY,EAAE,QAAQ;EACtB,cAAc,EAAE,QAAQ,CAAC,UAAU;EACnC,WAAW,EAAE,QAAQ;EACtB,CAAC;CACF,EAAE,OAAO;EACP,MAAM,EAAE,QAAQ,aAAa;EAC7B,YAAY,EAAE,QAAQ;EACtB,UAAU,EAAE,QAAQ;EACpB,SAAS,EAAE,MAAM,cAAc;EAC/B,SAAS,EAAE,SAAS,CAAC,UAAU;EAC/B,SAAS,EAAE,SAAS;EACpB,WAAW,EAAE,QAAQ;EACtB,CAAC;CACH,CAAC;AAEF,MAAM,cAAc,EAAE,OAAO;CAC3B,MAAM,EAAE,QAAQ;CAChB,WAAW,EAAE,QAAQ,CAAC,UAAU;CACjC,CAAC;AAEF,MAAM,uBAAuB,EAAE,OAAO;CACpC,QAAQ,EAAE,KAAK,iBAAiB;CAChC,OAAO,EACJ,OAAO;EACN,MAAM,EAAE,QAAQ;EAChB,SAAS,EAAE,QAAQ;EACpB,CAAC,CACD,UAAU;CACb,QAAQ,EAAE,KAAK,CAAC,UAAU;CAC3B,CAAC;AAEF,MAAM,sBAAsB,kBAAkB,OAAO;CACnD,UAAU;CACV,UAAU,EAAE,MAAM,cAAc;CAChC,OAAO,EAAE,MAAM,YAAY;CAC3B,WAAW,EAAE,MACX,EAAE,OAAO;EACP,MAAM,EAAE,QAAQ;EAChB,WAAW,EAAE,KAAK,CAAC,UAAU;EAC7B,SAAS,EAAE,QAAQ,CAAC,UAAU;EAC/B,CAAC,CACH;CACF,CAAC;AAEF,MAAM,mBAAmB,EAAE,OAAO,EAChC,QAAQ,EAAE,KAAK,iBAAiB,EACjC,CAAC"}
+{"version":3,"file":"route-schemas.js","names":[],"sources":["../../../src/pi/route-schemas.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport type { AgentEvent } from \"@mariozechner/pi-agent-core\";\n\nimport { SESSION_STATUSES, STEERING_MODES } from \"./constants\";\nimport type { PiActiveSessionProtocolMessage } from \"./types\";\n\nconst AGENT_LOOP_PHASES = [\"waiting-for-user\", \"running-agent\", \"complete\"] as const;\n\nconst sessionBaseSchema = z.object({\n  id: z.string(),\n  name: z.string().nullable(),\n  status: z.enum(SESSION_STATUSES),\n  agent: z.string(),\n  steeringMode: z.enum(STEERING_MODES),\n  metadata: z.any().nullable(),\n  tags: z.array(z.string()),\n  createdAt: z.date(),\n  updatedAt: z.date(),\n});\n\nconst TextContentSchema = z.object({\n  type: z.literal(\"text\"),\n  text: z.string(),\n  textSignature: z.string().optional(),\n});\n\nconst ThinkingContentSchema = z.object({\n  type: z.literal(\"thinking\"),\n  thinking: z.string(),\n  thinkingSignature: z.string().optional(),\n});\n\nconst ImageContentSchema = z.object({\n  type: z.literal(\"image\"),\n  data: z.string(),\n  mimeType: z.string(),\n});\n\nconst ToolCallSchema = z.object({\n  type: z.literal(\"toolCall\"),\n  id: z.string(),\n  name: z.string(),\n  arguments: z.record(z.string(), z.unknown()),\n  thoughtSignature: z.string().optional(),\n});\n\n// Per-role content unions matching the actual AgentMessage types from @mariozechner/pi-ai:\n// - UserMessage.content:      string | (TextContent | ImageContent)[]\n// - AssistantMessage.content: (TextContent | ThinkingContent | ToolCall)[]\n// - ToolResultMessage.content:(TextContent | ImageContent)[]\nconst UserContentSchema = z.union([TextContentSchema, ImageContentSchema]);\nconst AssistantContentSchema = z.union([TextContentSchema, ThinkingContentSchema, ToolCallSchema]);\nconst ToolResultContentSchema = z.union([TextContentSchema, ImageContentSchema]);\n\nconst UsageSchema = z.object({\n  input: z.number(),\n  output: z.number(),\n  cacheRead: z.number(),\n  cacheWrite: z.number(),\n  totalTokens: z.number(),\n  cost: z.object({\n    input: z.number(),\n    output: z.number(),\n    cacheRead: z.number(),\n    cacheWrite: z.number(),\n    total: z.number(),\n  }),\n});\n\nconst MessageSchema = z.union([\n  z.object({\n    role: z.literal(\"user\"),\n    content: z.union([z.string(), z.array(UserContentSchema)]),\n    timestamp: z.number(),\n  }),\n  z.object({\n    role: z.literal(\"assistant\"),\n    content: z.array(AssistantContentSchema),\n    api: z.string(),\n    provider: z.string(),\n    model: z.string(),\n    usage: UsageSchema,\n    stopReason: z.enum([\"stop\", \"length\", \"toolUse\", \"error\", \"aborted\"]),\n    errorMessage: z.string().optional(),\n    timestamp: z.number(),\n  }),\n  z.object({\n    role: z.literal(\"toolResult\"),\n    toolCallId: z.string(),\n    toolName: z.string(),\n    content: z.array(ToolResultContentSchema),\n    details: z.unknown().optional(),\n    isError: z.boolean(),\n    timestamp: z.number(),\n  }),\n]);\n\n// AgentEvent is a discriminated union that recursively contains AgentMessage[],\n// making a full structural Zod schema impractical.\nconst TraceSchema: z.ZodType<AgentEvent> = z.custom<AgentEvent>();\n\nconst EventSchema = z.object({\n  id: z.string(),\n  runNumber: z.number().nullable().optional(),\n  type: z.string(),\n  payload: z.unknown().nullable(),\n  createdAt: z.date(),\n  deliveredAt: z.date().nullable(),\n  consumedByStepKey: z.string().nullable(),\n});\n\nconst WaitingForSchema = z\n  .union([\n    z.object({\n      type: z.literal(\"user_message\"),\n      turn: z.number(),\n      stepKey: z.string(),\n      timeoutMs: z.number().nullable(),\n    }),\n    z.object({\n      type: z.literal(\"assistant\"),\n      turn: z.number(),\n      stepKey: z.string(),\n    }),\n  ])\n  .nullable();\n\nconst workflowStatusSchema = z.object({\n  status: z.enum(SESSION_STATUSES),\n  error: z\n    .object({\n      name: z.string(),\n      message: z.string(),\n    })\n    .optional(),\n  output: z.any().optional(),\n});\n\nconst sessionDetailSchema = sessionBaseSchema.extend({\n  workflow: workflowStatusSchema,\n  messages: z.array(MessageSchema),\n  events: z.array(EventSchema),\n  trace: z.array(TraceSchema),\n  turn: z.number(),\n  phase: z.enum(AGENT_LOOP_PHASES),\n  waitingFor: WaitingForSchema,\n  summaries: z.array(\n    z.object({\n      turn: z.number(),\n      assistant: z.any().nullable(),\n      summary: z.string().nullable(),\n    }),\n  ),\n});\n\nconst messageAckSchema = z.object({\n  status: z.enum(SESSION_STATUSES),\n});\n\nconst activeSessionStreamItemSchema: z.ZodType<PiActiveSessionProtocolMessage> =\n  z.custom<PiActiveSessionProtocolMessage>();\n\nexport {\n  activeSessionStreamItemSchema,\n  messageAckSchema,\n  sessionBaseSchema,\n  sessionDetailSchema,\n  workflowStatusSchema,\n};\n"],"mappings":"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"}

package/dist/node/pi/types.d.ts

@@ -1,18 +1,18 @@
+import { PiLoggerConfig } from "../debug-log.js";
 import { PiSessionStatus, PiSteeringMode } from "./constants.js";
-import { InstantiatedFragmentFromDefinition } from "@fragno-dev/core";
+import { PiWorkflowsRegistry } from "./workflow/workflow.js";
 import { TxResult } from "@fragno-dev/db";
+import { InstanceStatus, WorkflowsFragmentServices, WorkflowsHistoryStep } from "@fragno-dev/workflows";
 import { AgentEvent, AgentMessage, AgentOptions, AgentTool, StreamFn, ThinkingLevel } from "@mariozechner/pi-agent-core";
-import { Api, Model } from "@mariozechner/pi-ai";
-import { InstanceStatus, WorkflowsHistoryStep, workflowsFragmentDefinition } from "@fragno-dev/workflows";
+import { Api, ImageContent, Model, TextContent } from "@mariozechner/pi-ai";
 
 //#region src/pi/types.d.ts
-type WorkflowsService = InstantiatedFragmentFromDefinition<typeof workflowsFragmentDefinition>["services"];
+type WorkflowsService = WorkflowsFragmentServices<PiWorkflowsRegistry>;
 type PiSession = {
   id: string;
   name: string | null;
   status: PiSessionStatus;
   agent: string;
-  workflowInstanceId: string | null;
   steeringMode: PiSteeringMode;
   metadata: unknown;
   tags: string[];
@@ -24,9 +24,88 @@ type PiTurnSummary = {
   assistant: AgentMessage | null;
   summary: string | null;
 };
+type PiSessionDetailEvent = {
+  id: string;
+  type: string;
+  payload: unknown | null;
+  createdAt: Date;
+  deliveredAt: Date | null;
+  consumedByStepKey: string | null;
+  runNumber?: number | null;
+};
+type PiAgentLoopPhase = "waiting-for-user" | "running-agent" | "complete";
+type PiActiveSessionStreamItem = AgentEvent;
+type PiActiveSessionSettledStatus = "waiting-for-user" | "complete" | "errored";
+type PiActiveSessionUpdate = {
+  type: "event";
+  turn: number;
+  event: PiActiveSessionStreamItem;
+} | {
+  type: "settled";
+  turn: number;
+  status: PiActiveSessionSettledStatus;
+};
+type PiActiveSessionSubscriber = (update: PiActiveSessionUpdate) => void;
+type PiActiveSessionReplayBufferEntry = {
+  turn: number;
+  updates: PiActiveSessionUpdate[];
+};
+type PiActiveSessionReplayBuffer = PiActiveSessionReplayBufferEntry[];
+type PiActiveSessionState = {
+  subscribe: (listener: PiActiveSessionSubscriber) => () => void;
+  publishEvent: (turn: number, event: PiActiveSessionStreamItem) => void;
+  settleTurn: (turn: number, status: PiActiveSessionSettledStatus) => void;
+  replayTurn: (turn: number) => PiActiveSessionUpdate[];
+  exportReplayBuffer: () => PiActiveSessionReplayBuffer;
+  importReplayBuffer: (buffer: PiActiveSessionReplayBuffer) => void;
+  listenerCount: () => number;
+};
+type PiAgentLoopWaitingFor = {
+  type: "user_message";
+  turn: number;
+  stepKey: string;
+  timeoutMs: number | null;
+} | {
+  type: "assistant";
+  turn: number;
+  stepKey: string;
+} | null;
+type PiAgentLoopSerializableState = {
+  messages: AgentMessage[];
+  events: PiSessionDetailEvent[];
+  trace: AgentEvent[];
+  summaries: PiTurnSummary[];
+  turn: number;
+  phase: PiAgentLoopPhase;
+  waitingFor: PiAgentLoopWaitingFor;
+};
+type PiAgentLoopPersistedState = PiAgentLoopSerializableState & {
+  activeSessionUpdatesByTurn: PiActiveSessionReplayBuffer;
+};
+type PiSessionWorkflowStatus = {
+  status: PiSessionStatus;
+  error?: {
+    name: string;
+    message: string;
+  };
+  output?: unknown;
+};
+type PiSessionDetail = PiSession & {
+  workflow: PiSessionWorkflowStatus;
+  messages: AgentMessage[];
+  events: PiSessionDetailEvent[];
+  trace: AgentEvent[];
+  summaries: PiTurnSummary[];
+  turn: number;
+  phase: PiAgentLoopPhase;
+  waitingFor: PiAgentLoopWaitingFor;
+};
+type PiAgentLoopState = PiAgentLoopPersistedState & {
+  activeSession?: PiActiveSessionState;
+};
 type PiWorkflowsInstanceStatus = InstanceStatus;
 type PiWorkflowHistoryStep = WorkflowsHistoryStep;
-type PiWorkflowsService = Pick<WorkflowsService, "createInstance" | "getInstanceStatus" | "getInstanceRunNumber" | "sendEvent" | "listHistory"> & {
+type PiWorkflowsService = Pick<WorkflowsService, "createInstance" | "getInstanceStatus" | "getLiveInstanceState" | "restoreInstanceState" | "sendEvent"> & {
   getInstanceStatusBatch?: (workflowName: string, instanceIds: string[]) => TxResult<PiWorkflowsInstanceStatus[], PiWorkflowsInstanceStatus[]>;
 };
 type PiAgentDefinition = {
@@ -49,11 +128,75 @@ type PiAgentDefinition = {
   }) => void;
 };
 type PiAgentRegistry = Record<string, PiAgentDefinition>;
+declare const PI_TOOL_JOURNAL_VERSION: 1;
+type PiToolJournalVersion = typeof PI_TOOL_JOURNAL_VERSION;
+type PiToolCallStableKey = string;
+type PiPersistedToolResult = {
+  content: Array<TextContent | ImageContent>;
+  details: unknown;
+};
+type PiPersistedToolCallSource = "executed" | "replay";
+type PiPersistedToolCallV1 = {
+  version: PiToolJournalVersion;
+  key: PiToolCallStableKey;
+  sessionId: string;
+  turnId: string;
+  toolCallId: string;
+  toolName: string;
+  args: Record<string, unknown>;
+  result: PiPersistedToolResult;
+  isError: boolean;
+  source: PiPersistedToolCallSource;
+  capturedAt: number;
+  seq: number;
+};
+type PiActiveSessionSystemMessage = {
+  layer: "system";
+  type: "snapshot";
+  turn: number;
+  phase: PiAgentLoopPhase;
+  waitingFor: PiAgentLoopWaitingFor;
+  replayCount: number;
+} | {
+  layer: "system";
+  type: "settled";
+  turn: number;
+  status: PiActiveSessionSettledStatus;
+} | {
+  layer: "system";
+  type: "inactive";
+  reason: "session-complete" | "session-idle";
+  turn: number;
+  phase: PiAgentLoopPhase;
+  waitingFor: PiAgentLoopWaitingFor;
+};
+type PiActiveSessionProtocolMessage = PiActiveSessionSystemMessage | {
+  layer: "pi";
+  type: "event";
+  turn: number;
+  source: "replay" | "live";
+  event: PiActiveSessionStreamItem;
+};
+type PiPersistedToolCall = PiPersistedToolCallV1;
+type PiToolReplayCache = Map<PiToolCallStableKey, PiPersistedToolCall>;
+type PiToolSideEffectReducerContext = {
+  key: PiToolCallStableKey;
+  sessionId: string;
+  turnId: string;
+};
+type PiToolSideEffectReducer = (state: unknown, entry: PiPersistedToolCall, ctx: PiToolSideEffectReducerContext) => unknown;
+type PiToolSideEffectReducerRegistry = Record<string, PiToolSideEffectReducer>;
+type PiToolReplayContext = {
+  cache: PiToolReplayCache;
+  journal: PiPersistedToolCall[];
+  sideEffects: Record<string, unknown>;
+};
 type PiToolFactoryContext = {
   session: PiSession;
   turnId: string;
   toolConfig: unknown;
   messages: AgentMessage[];
+  replay: PiToolReplayContext;
 };
 type PiToolFactory = AgentTool | ((ctx: PiToolFactoryContext) => AgentTool | Promise<AgentTool>);
 type PiToolRegistry = Record<string, PiToolFactory>;
@@ -61,7 +204,12 @@ interface PiFragmentConfig {
   agents: PiAgentRegistry;
   tools: PiToolRegistry;
   defaultSteeringMode?: PiSteeringMode;
+  toolSideEffectReducers?: PiToolSideEffectReducerRegistry;
+  /**
+   * Optional logging config for internal pi-fragment diagnostics.
+   */
+  logging?: PiLoggerConfig;
 }
 //#endregion
-export { PiAgentDefinition, PiAgentRegistry, PiFragmentConfig, PiSession, PiToolFactory, PiToolFactoryContext, PiToolRegistry, PiTurnSummary, PiWorkflowHistoryStep, PiWorkflowsInstanceStatus, PiWorkflowsService };
+export { PI_TOOL_JOURNAL_VERSION, PiActiveSessionProtocolMessage, PiActiveSessionStreamItem, PiAgentDefinition, PiAgentLoopState, PiAgentRegistry, PiFragmentConfig, PiPersistedToolCall, PiPersistedToolCallSource, PiPersistedToolResult, PiSession, PiSessionDetail, PiToolFactory, PiToolFactoryContext, PiToolRegistry, PiToolReplayCache, PiToolReplayContext, PiToolSideEffectReducer, PiToolSideEffectReducerContext, PiToolSideEffectReducerRegistry, PiTurnSummary, PiWorkflowHistoryStep, PiWorkflowsInstanceStatus, PiWorkflowsService };
 //# sourceMappingURL=types.d.ts.map

package/dist/node/pi/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/pi/types.ts"],"mappings":";;;;;;;;KAoBY,gBAAA,GAAmB,kCAAA,QACtB,2BAAA;AAAA,KAGG,SAAA;EACV,EAAA;EACA,IAAA;EACA,MAAA,EAAQ,eAAA;EACR,KAAA;EACA,kBAAA;EACA,YAAA,EAAc,cAAA;EACd,QAAA;EACA,IAAA;EACA,SAAA,EAAW,IAAA;EACX,SAAA,EAAW,IAAA;AAAA;AAAA,KAGD,aAAA;EACV,IAAA;EACA,SAAA,EAAW,YAAA;EACX,OAAA;AAAA;AAAA,KAGU,yBAAA,GAA4B,cAAA;AAAA,KAE5B,qBAAA,GAAwB,oBAAA;AAAA,KAExB,kBAAA,GAAqB,IAAA,CAC/B,gBAAA;EAGA,sBAAA,IACE,YAAA,UACA,WAAA,eACG,QAAA,CAAS,yBAAA,IAA6B,yBAAA;AAAA;AAAA,KAGjC,iBAAA;EACV,IAAA;EACA,YAAA;EACA,KAAA,EAAO,KAAA,CAAM,GAAA;EACb,aAAA,GAAgB,aAAA;EAChB,KAAA;EACA,UAAA;EACA,cAAA;EACA,QAAA,GAAW,QAAA;EACX,YAAA,GAAe,YAAA;EACf,gBAAA,GAAmB,YAAA;EACnB,SAAA,GAAY,YAAA;EACZ,eAAA,GAAkB,YAAA;EAClB,eAAA,GAAkB,YAAA;EAClB,OAAA,IAAW,KAAA,EAAO,UAAA,EAAY,GAAA;IAAO,SAAA;IAAmB,MAAA;EAAA;AAAA;AAAA,KAG9C,eAAA,GAAkB,MAAA,SAAe,iBAAA;AAAA,KAEjC,oBAAA;EACV,OAAA,EAAS,SAAA;EACT,MAAA;EACA,UAAA;EACA,QAAA,EAAU,YAAA;AAAA;AAAA,KAGA,aAAA,GACR,SAAA,KACE,GAAA,EAAK,oBAAA,KAAyB,SAAA,GAAY,OAAA,CAAQ,SAAA;AAAA,KAE5C,cAAA,GAAiB,MAAA,SAAe,aAAA;AAAA,UAE3B,gBAAA;EACf,MAAA,EAAQ,eAAA;EACR,KAAA,EAAO,cAAA;EACP,mBAAA,GAAsB,cAAA;AAAA"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/pi/types.ts"],"mappings":"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"}

package/dist/node/pi/types.js

@@ -0,0 +1,6 @@
+//#region src/pi/types.ts
+const PI_TOOL_JOURNAL_VERSION = 1;
+
+//#endregion
+export { PI_TOOL_JOURNAL_VERSION };
+//# sourceMappingURL=types.js.map

package/dist/node/pi/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../../src/pi/types.ts"],"sourcesContent":["import type { TxResult } from \"@fragno-dev/db\";\nimport type {\n  InstanceStatus,\n  WorkflowsFragmentServices,\n  WorkflowsHistory,\n  WorkflowsHistoryStep,\n} from \"@fragno-dev/workflows\";\n\nimport type {\n  AgentEvent,\n  AgentMessage,\n  AgentOptions,\n  AgentTool,\n  StreamFn,\n  ThinkingLevel,\n} from \"@mariozechner/pi-agent-core\";\nimport type { Api, ImageContent, Model, TextContent } from \"@mariozechner/pi-ai\";\n\nimport type { PiLoggerConfig } from \"../debug-log\";\nimport type { PiSessionStatus, PiSteeringMode } from \"./constants\";\nimport type { PiWorkflowsRegistry } from \"./workflow/workflow\";\n\nexport type WorkflowsService = WorkflowsFragmentServices<PiWorkflowsRegistry>;\n\nexport type PiSession = {\n  id: string;\n  name: string | null;\n  status: PiSessionStatus;\n  agent: string;\n  steeringMode: PiSteeringMode;\n  metadata: unknown;\n  tags: string[];\n  createdAt: Date;\n  updatedAt: Date;\n};\n\nexport type PiTurnSummary = {\n  turn: number;\n  assistant: AgentMessage | null;\n  summary: string | null;\n};\n\nexport type PiSessionDetailEvent = {\n  id: string;\n  type: string;\n  payload: unknown | null;\n  createdAt: Date;\n  deliveredAt: Date | null;\n  consumedByStepKey: string | null;\n  runNumber?: number | null;\n};\n\nexport type PiAgentLoopPhase = \"waiting-for-user\" | \"running-agent\" | \"complete\";\n\nexport type PiActiveSessionStreamItem = AgentEvent;\n\nexport type PiActiveSessionSettledStatus = \"waiting-for-user\" | \"complete\" | \"errored\";\n\nexport type PiActiveSessionUpdate =\n  | {\n      type: \"event\";\n      turn: number;\n      event: PiActiveSessionStreamItem;\n    }\n  | {\n      type: \"settled\";\n      turn: number;\n      status: PiActiveSessionSettledStatus;\n    };\n\nexport type PiActiveSessionSubscriber = (update: PiActiveSessionUpdate) => void;\n\nexport type PiActiveSessionReplayBufferEntry = {\n  turn: number;\n  updates: PiActiveSessionUpdate[];\n};\n\nexport type PiActiveSessionReplayBuffer = PiActiveSessionReplayBufferEntry[];\n\nexport type PiActiveSessionState = {\n  subscribe: (listener: PiActiveSessionSubscriber) => () => void;\n  publishEvent: (turn: number, event: PiActiveSessionStreamItem) => void;\n  settleTurn: (turn: number, status: PiActiveSessionSettledStatus) => void;\n  replayTurn: (turn: number) => PiActiveSessionUpdate[];\n  exportReplayBuffer: () => PiActiveSessionReplayBuffer;\n  importReplayBuffer: (buffer: PiActiveSessionReplayBuffer) => void;\n  listenerCount: () => number;\n};\n\nexport type PiAgentLoopWaitingFor =\n  | {\n      type: \"user_message\";\n      turn: number;\n      stepKey: string;\n      timeoutMs: number | null;\n    }\n  | {\n      type: \"assistant\";\n      turn: number;\n      stepKey: string;\n    }\n  | null;\n\nexport type PiAgentLoopSerializableState = {\n  messages: AgentMessage[];\n  events: PiSessionDetailEvent[];\n  trace: AgentEvent[];\n  summaries: PiTurnSummary[];\n  turn: number;\n  phase: PiAgentLoopPhase;\n  waitingFor: PiAgentLoopWaitingFor;\n};\n\nexport type PiAgentLoopPersistedState = PiAgentLoopSerializableState & {\n  activeSessionUpdatesByTurn: PiActiveSessionReplayBuffer;\n};\n\nexport type PiSessionWorkflowStatus = {\n  status: PiSessionStatus;\n  error?: { name: string; message: string };\n  output?: unknown;\n};\n\nexport type PiSessionDetail = PiSession & {\n  workflow: PiSessionWorkflowStatus;\n  messages: AgentMessage[];\n  events: PiSessionDetailEvent[];\n  trace: AgentEvent[];\n  summaries: PiTurnSummary[];\n  turn: number;\n  phase: PiAgentLoopPhase;\n  waitingFor: PiAgentLoopWaitingFor;\n};\n\nexport type PiAgentLoopState = PiAgentLoopPersistedState & {\n  activeSession?: PiActiveSessionState;\n};\n\nexport type PiWorkflowsInstanceStatus = InstanceStatus;\nexport type PiWorkflowsHistoryPage = WorkflowsHistory;\nexport type PiWorkflowHistoryStep = WorkflowsHistoryStep;\n\nexport type PiWorkflowsService = Pick<\n  WorkflowsService,\n  | \"createInstance\"\n  | \"getInstanceStatus\"\n  | \"getLiveInstanceState\"\n  | \"restoreInstanceState\"\n  | \"sendEvent\"\n> & {\n  getInstanceStatusBatch?: (\n    workflowName: string,\n    instanceIds: string[],\n  ) => TxResult<PiWorkflowsInstanceStatus[], PiWorkflowsInstanceStatus[]>;\n};\n\nexport type PiAgentDefinition = {\n  name: string;\n  systemPrompt: string;\n  model: Model<Api>;\n  thinkingLevel?: ThinkingLevel;\n  tools?: string[];\n  toolConfig?: unknown;\n  maxTraceEvents?: number;\n  streamFn?: StreamFn;\n  convertToLlm?: AgentOptions[\"convertToLlm\"];\n  transformContext?: AgentOptions[\"transformContext\"];\n  getApiKey?: AgentOptions[\"getApiKey\"];\n  thinkingBudgets?: AgentOptions[\"thinkingBudgets\"];\n  maxRetryDelayMs?: AgentOptions[\"maxRetryDelayMs\"];\n  onEvent?: (event: AgentEvent, ctx: { sessionId: string; turnId: string }) => void;\n};\n\nexport type PiAgentRegistry = Record<string, PiAgentDefinition>;\n\nexport const PI_TOOL_JOURNAL_VERSION = 1 as const;\n\nexport type PiToolJournalVersion = typeof PI_TOOL_JOURNAL_VERSION;\n\nexport type PiToolCallStableKey = string;\n\nexport type PiPersistedToolResult = {\n  content: Array<TextContent | ImageContent>;\n  details: unknown;\n};\n\nexport type PiPersistedToolCallSource = \"executed\" | \"replay\";\n\nexport type PiPersistedToolCallV1 = {\n  version: PiToolJournalVersion;\n  key: PiToolCallStableKey;\n  sessionId: string;\n  turnId: string;\n  toolCallId: string;\n  toolName: string;\n  args: Record<string, unknown>;\n  result: PiPersistedToolResult;\n  isError: boolean;\n  source: PiPersistedToolCallSource;\n  capturedAt: number;\n  seq: number;\n};\n\nexport type PiActiveSessionSystemMessage =\n  | {\n      layer: \"system\";\n      type: \"snapshot\";\n      turn: number;\n      phase: PiAgentLoopPhase;\n      waitingFor: PiAgentLoopWaitingFor;\n      replayCount: number;\n    }\n  | {\n      layer: \"system\";\n      type: \"settled\";\n      turn: number;\n      status: PiActiveSessionSettledStatus;\n    }\n  | {\n      layer: \"system\";\n      type: \"inactive\";\n      reason: \"session-complete\" | \"session-idle\";\n      turn: number;\n      phase: PiAgentLoopPhase;\n      waitingFor: PiAgentLoopWaitingFor;\n    };\n\nexport type PiActiveSessionProtocolMessage =\n  | PiActiveSessionSystemMessage\n  | {\n      layer: \"pi\";\n      type: \"event\";\n      turn: number;\n      source: \"replay\" | \"live\";\n      event: PiActiveSessionStreamItem;\n    };\n\nexport type PiPersistedToolCall = PiPersistedToolCallV1;\n\nexport type PiToolReplayCache = Map<PiToolCallStableKey, PiPersistedToolCall>;\n\nexport type PiToolSideEffectReducerContext = {\n  key: PiToolCallStableKey;\n  sessionId: string;\n  turnId: string;\n};\n\nexport type PiToolSideEffectReducer = (\n  state: unknown,\n  entry: PiPersistedToolCall,\n  ctx: PiToolSideEffectReducerContext,\n) => unknown;\n\nexport type PiToolSideEffectReducerRegistry = Record<string, PiToolSideEffectReducer>;\n\nexport type PiToolReplayContext = {\n  cache: PiToolReplayCache;\n  journal: PiPersistedToolCall[];\n  sideEffects: Record<string, unknown>;\n};\n\nexport type PiToolFactoryContext = {\n  session: PiSession;\n  turnId: string;\n  toolConfig: unknown;\n  messages: AgentMessage[];\n  replay: PiToolReplayContext;\n};\n\nexport type PiToolFactory =\n  | AgentTool\n  | ((ctx: PiToolFactoryContext) => AgentTool | Promise<AgentTool>);\n\nexport type PiToolRegistry = Record<string, PiToolFactory>;\n\nexport interface PiFragmentConfig {\n  agents: PiAgentRegistry;\n  tools: PiToolRegistry;\n  defaultSteeringMode?: PiSteeringMode;\n  toolSideEffectReducers?: PiToolSideEffectReducerRegistry;\n  /**\n   * Optional logging config for internal pi-fragment diagnostics.\n   */\n  logging?: PiLoggerConfig;\n}\n"],"mappings":";AA+KA,MAAa,0BAA0B"}

package/dist/node/pi/workflow/active-session.d.ts

@@ -0,0 +1,2 @@
+import "../types.js";
+import { AgentMessage } from "@mariozechner/pi-agent-core";

package/dist/node/pi/workflow/active-session.js

@@ -0,0 +1,107 @@
+//#region src/pi/workflow/active-session.ts
+const WAIT_FOR_USER_TIMEOUT_MS = 3600 * 1e3;
+const buildWaitingForUser = (turn) => ({
+	type: "user_message",
+	turn,
+	stepKey: `waitForEvent:wait-user-${turn}`,
+	timeoutMs: WAIT_FOR_USER_TIMEOUT_MS
+});
+const getActiveSessionReplayBuffer = (state) => {
+	const replayBuffer = state.activeSessionUpdatesByTurn;
+	return Array.isArray(replayBuffer) ? structuredClone(replayBuffer) : [];
+};
+const createPiActiveSessionState = (options) => {
+	const listeners = /* @__PURE__ */ new Set();
+	const updatesByTurn = /* @__PURE__ */ new Map();
+	const trimPreviousTurns = (turn) => {
+		for (const previousTurn of updatesByTurn.keys()) if (previousTurn < turn - 1) updatesByTurn.delete(previousTurn);
+	};
+	const appendUpdate = (turn, update) => {
+		const existing = updatesByTurn.get(turn) ?? [];
+		updatesByTurn.set(turn, [...existing, structuredClone(update)]);
+		trimPreviousTurns(turn);
+	};
+	const exportReplayBuffer = () => structuredClone([...updatesByTurn.entries()].sort(([leftTurn], [rightTurn]) => leftTurn - rightTurn).map(([turn, updates]) => ({
+		turn,
+		updates
+	})));
+	const syncReplayBuffer = () => {
+		options?.onReplayBufferChange?.(exportReplayBuffer());
+	};
+	const importReplayBuffer = (buffer) => {
+		updatesByTurn.clear();
+		for (const entry of structuredClone(buffer)) for (const update of entry.updates) appendUpdate(entry.turn, update);
+		syncReplayBuffer();
+	};
+	if (options?.replayBuffer) importReplayBuffer(options.replayBuffer);
+	const notify = (update) => {
+		for (const listener of Array.from(listeners)) try {
+			listener(update);
+		} catch (error) {
+			console.warn("Pi active-session listener failed.", {
+				error,
+				updateType: update.type
+			});
+		}
+	};
+	return {
+		subscribe(listener) {
+			listeners.add(listener);
+			return () => {
+				listeners.delete(listener);
+			};
+		},
+		publishEvent(turn, event) {
+			const update = {
+				type: "event",
+				turn,
+				event
+			};
+			appendUpdate(turn, update);
+			syncReplayBuffer();
+			notify(update);
+		},
+		settleTurn(turn, status) {
+			const update = {
+				type: "settled",
+				turn,
+				status
+			};
+			appendUpdate(turn, update);
+			syncReplayBuffer();
+			notify(update);
+		},
+		replayTurn(turn) {
+			return structuredClone(updatesByTurn.get(turn) ?? []);
+		},
+		exportReplayBuffer,
+		importReplayBuffer,
+		listenerCount: () => listeners.size
+	};
+};
+const createInitialPiAgentLoopState = (messages = []) => ({
+	messages,
+	events: [],
+	trace: [],
+	summaries: [],
+	turn: 0,
+	phase: "waiting-for-user",
+	waitingFor: buildWaitingForUser(0),
+	activeSessionUpdatesByTurn: []
+});
+const ensurePiActiveSessionState = (state) => {
+	if (state.activeSession) return state.activeSession;
+	const activeSession = createPiActiveSessionState({
+		replayBuffer: getActiveSessionReplayBuffer(state),
+		onReplayBufferChange: (replayBuffer) => {
+			state.activeSessionUpdatesByTurn = replayBuffer;
+		}
+	});
+	state.activeSessionUpdatesByTurn = activeSession.exportReplayBuffer();
+	state.activeSession = activeSession;
+	return activeSession;
+};
+
+//#endregion
+export { createInitialPiAgentLoopState, createPiActiveSessionState, ensurePiActiveSessionState };
+//# sourceMappingURL=active-session.js.map

package/dist/node/pi/workflow/active-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-session.js","names":[],"sources":["../../../../src/pi/workflow/active-session.ts"],"sourcesContent":["import type { AgentMessage } from \"@mariozechner/pi-agent-core\";\n\nimport type {\n  PiActiveSessionReplayBuffer,\n  PiActiveSessionState,\n  PiActiveSessionSubscriber,\n  PiActiveSessionUpdate,\n  PiAgentLoopState,\n  PiAgentLoopWaitingFor,\n} from \"../types\";\n\nconst WAIT_FOR_USER_TIMEOUT_MS = 60 * 60 * 1000;\n\nconst buildWaitingForUser = (turn: number): NonNullable<PiAgentLoopWaitingFor> => ({\n  type: \"user_message\",\n  turn,\n  stepKey: `waitForEvent:wait-user-${turn}`,\n  timeoutMs: WAIT_FOR_USER_TIMEOUT_MS,\n});\n\nconst getActiveSessionReplayBuffer = (state: PiAgentLoopState): PiActiveSessionReplayBuffer => {\n  const replayBuffer = (state as { activeSessionUpdatesByTurn?: unknown })\n    .activeSessionUpdatesByTurn;\n  return Array.isArray(replayBuffer)\n    ? structuredClone(replayBuffer as PiActiveSessionReplayBuffer)\n    : [];\n};\n\nexport const createPiActiveSessionState = (options?: {\n  replayBuffer?: PiActiveSessionReplayBuffer;\n  onReplayBufferChange?: (buffer: PiActiveSessionReplayBuffer) => void;\n}): PiActiveSessionState => {\n  const listeners = new Set<PiActiveSessionSubscriber>();\n  const updatesByTurn = new Map<number, PiActiveSessionUpdate[]>();\n\n  const trimPreviousTurns = (turn: number) => {\n    for (const previousTurn of updatesByTurn.keys()) {\n      if (previousTurn < turn - 1) {\n        updatesByTurn.delete(previousTurn);\n      }\n    }\n  };\n\n  const appendUpdate = (turn: number, update: PiActiveSessionUpdate) => {\n    const existing = updatesByTurn.get(turn) ?? [];\n    updatesByTurn.set(turn, [...existing, structuredClone(update)]);\n    trimPreviousTurns(turn);\n  };\n\n  const exportReplayBuffer = (): PiActiveSessionReplayBuffer =>\n    structuredClone(\n      [...updatesByTurn.entries()]\n        .sort(([leftTurn], [rightTurn]) => leftTurn - rightTurn)\n        .map(([turn, updates]) => ({ turn, updates })),\n    );\n\n  const syncReplayBuffer = () => {\n    options?.onReplayBufferChange?.(exportReplayBuffer());\n  };\n\n  const importReplayBuffer = (buffer: PiActiveSessionReplayBuffer) => {\n    updatesByTurn.clear();\n    for (const entry of structuredClone(buffer)) {\n      for (const update of entry.updates) {\n        appendUpdate(entry.turn, update);\n      }\n    }\n    syncReplayBuffer();\n  };\n\n  if (options?.replayBuffer) {\n    importReplayBuffer(options.replayBuffer);\n  }\n\n  const notify = (update: PiActiveSessionUpdate) => {\n    for (const listener of Array.from(listeners)) {\n      try {\n        listener(update);\n      } catch (error) {\n        console.warn(\"Pi active-session listener failed.\", { error, updateType: update.type });\n      }\n    }\n  };\n\n  return {\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    publishEvent(turn, event) {\n      const update: PiActiveSessionUpdate = { type: \"event\", turn, event };\n      appendUpdate(turn, update);\n      syncReplayBuffer();\n      notify(update);\n    },\n    settleTurn(turn, status) {\n      const update: PiActiveSessionUpdate = { type: \"settled\", turn, status };\n      appendUpdate(turn, update);\n      syncReplayBuffer();\n      notify(update);\n    },\n    replayTurn(turn) {\n      return structuredClone(updatesByTurn.get(turn) ?? []);\n    },\n    exportReplayBuffer,\n    importReplayBuffer,\n    listenerCount: () => listeners.size,\n  };\n};\n\nexport const createInitialPiAgentLoopState = (messages: AgentMessage[] = []): PiAgentLoopState => ({\n  messages,\n  events: [],\n  trace: [],\n  summaries: [],\n  turn: 0,\n  phase: \"waiting-for-user\",\n  waitingFor: buildWaitingForUser(0),\n  activeSessionUpdatesByTurn: [],\n});\n\nexport const ensurePiActiveSessionState = (state: PiAgentLoopState): PiActiveSessionState => {\n  if (state.activeSession) {\n    return state.activeSession;\n  }\n\n  const activeSession = createPiActiveSessionState({\n    replayBuffer: getActiveSessionReplayBuffer(state),\n    onReplayBufferChange: (replayBuffer) => {\n      state.activeSessionUpdatesByTurn = replayBuffer;\n    },\n  });\n  state.activeSessionUpdatesByTurn = activeSession.exportReplayBuffer();\n  state.activeSession = activeSession;\n  return activeSession;\n};\n"],"mappings":";AAWA,MAAM,2BAA2B,OAAU;AAE3C,MAAM,uBAAuB,UAAsD;CACjF,MAAM;CACN;CACA,SAAS,0BAA0B;CACnC,WAAW;CACZ;AAED,MAAM,gCAAgC,UAAyD;CAC7F,MAAM,eAAgB,MACnB;AACH,QAAO,MAAM,QAAQ,aAAa,GAC9B,gBAAgB,aAA4C,GAC5D,EAAE;;AAGR,MAAa,8BAA8B,YAGf;CAC1B,MAAM,4BAAY,IAAI,KAAgC;CACtD,MAAM,gCAAgB,IAAI,KAAsC;CAEhE,MAAM,qBAAqB,SAAiB;AAC1C,OAAK,MAAM,gBAAgB,cAAc,MAAM,CAC7C,KAAI,eAAe,OAAO,EACxB,eAAc,OAAO,aAAa;;CAKxC,MAAM,gBAAgB,MAAc,WAAkC;EACpE,MAAM,WAAW,cAAc,IAAI,KAAK,IAAI,EAAE;AAC9C,gBAAc,IAAI,MAAM,CAAC,GAAG,UAAU,gBAAgB,OAAO,CAAC,CAAC;AAC/D,oBAAkB,KAAK;;CAGzB,MAAM,2BACJ,gBACE,CAAC,GAAG,cAAc,SAAS,CAAC,CACzB,MAAM,CAAC,WAAW,CAAC,eAAe,WAAW,UAAU,CACvD,KAAK,CAAC,MAAM,cAAc;EAAE;EAAM;EAAS,EAAE,CACjD;CAEH,MAAM,yBAAyB;AAC7B,WAAS,uBAAuB,oBAAoB,CAAC;;CAGvD,MAAM,sBAAsB,WAAwC;AAClE,gBAAc,OAAO;AACrB,OAAK,MAAM,SAAS,gBAAgB,OAAO,CACzC,MAAK,MAAM,UAAU,MAAM,QACzB,cAAa,MAAM,MAAM,OAAO;AAGpC,oBAAkB;;AAGpB,KAAI,SAAS,aACX,oBAAmB,QAAQ,aAAa;CAG1C,MAAM,UAAU,WAAkC;AAChD,OAAK,MAAM,YAAY,MAAM,KAAK,UAAU,CAC1C,KAAI;AACF,YAAS,OAAO;WACT,OAAO;AACd,WAAQ,KAAK,sCAAsC;IAAE;IAAO,YAAY,OAAO;IAAM,CAAC;;;AAK5F,QAAO;EACL,UAAU,UAAU;AAClB,aAAU,IAAI,SAAS;AACvB,gBAAa;AACX,cAAU,OAAO,SAAS;;;EAG9B,aAAa,MAAM,OAAO;GACxB,MAAM,SAAgC;IAAE,MAAM;IAAS;IAAM;IAAO;AACpE,gBAAa,MAAM,OAAO;AAC1B,qBAAkB;AAClB,UAAO,OAAO;;EAEhB,WAAW,MAAM,QAAQ;GACvB,MAAM,SAAgC;IAAE,MAAM;IAAW;IAAM;IAAQ;AACvE,gBAAa,MAAM,OAAO;AAC1B,qBAAkB;AAClB,UAAO,OAAO;;EAEhB,WAAW,MAAM;AACf,UAAO,gBAAgB,cAAc,IAAI,KAAK,IAAI,EAAE,CAAC;;EAEvD;EACA;EACA,qBAAqB,UAAU;EAChC;;AAGH,MAAa,iCAAiC,WAA2B,EAAE,MAAwB;CACjG;CACA,QAAQ,EAAE;CACV,OAAO,EAAE;CACT,WAAW,EAAE;CACb,MAAM;CACN,OAAO;CACP,YAAY,oBAAoB,EAAE;CAClC,4BAA4B,EAAE;CAC/B;AAED,MAAa,8BAA8B,UAAkD;AAC3F,KAAI,MAAM,cACR,QAAO,MAAM;CAGf,MAAM,gBAAgB,2BAA2B;EAC/C,cAAc,6BAA6B,MAAM;EACjD,uBAAuB,iBAAiB;AACtC,SAAM,6BAA6B;;EAEtC,CAAC;AACF,OAAM,6BAA6B,cAAc,oBAAoB;AACrE,OAAM,gBAAgB;AACtB,QAAO"}

package/dist/node/pi/workflow/agent-runner.d.ts

@@ -0,0 +1,13 @@
+import "../types.js";
+import { AgentEvent, AgentMessage } from "@mariozechner/pi-agent-core";
+
+//#region src/pi/workflow/agent-runner.d.ts
+type AgentLoopParams = {
+  sessionId: string;
+  agentName: string;
+  systemPrompt?: string;
+  initialMessages?: AgentMessage[];
+};
+//#endregion
+export { AgentLoopParams };
+//# sourceMappingURL=agent-runner.d.ts.map

package/dist/node/pi/workflow/agent-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runner.d.ts","names":[],"sources":["../../../../src/pi/workflow/agent-runner.ts"],"mappings":";;;;KA+BY,eAAA;EACV,SAAA;EACA,SAAA;EACA,YAAA;EACA,eAAA,GAAkB,YAAA;AAAA"}