@fragno-dev/pi-harness 0.0.0-stage → 0.0.3

package/dist/node/routes.js

@@ -0,0 +1,355 @@
+import { PiSessionDataIntegrityError, PiSessionDataUnavailableError, projectPiSessionFromWorkflowInstance } from "./pi/types.js";
+import { piHarnessDefinition } from "./pi/definition.js";
+import { WorkflowBackedSessionStorage, createWorkflowBackedSessionEntryIdAllocator } from "./pi/harness/session-storage.js";
+import { PI_JSONL_EXPORT_CWD, exportSessionStorageToJsonl } from "./pi/pi-jsonl-export.js";
+import { commandAckSchema, commandInputSchema, sessionBaseSchema, sessionDetailSchema } from "./pi/route-schemas.js";
+import { createPiSessionCommandId, piSessionCommandWaitability } from "./pi/session-command-protocol.js";
+import { CommandStepFailedError, CommandStepWaitTimeoutError, CommandWorkflowTerminatedError, waitForCommandStep } from "./pi/wait-for-command-step.js";
+import { defineRoutes } from "@fragno-dev/core";
+import { serviceCalls } from "@fragno-dev/db";
+import { z } from "zod";
+import { WorkflowsLogger } from "@fragno-dev/workflows/debug-log";
+import { createId } from "@fragno-dev/db/id";
+import { WorkflowInstanceNotFoundError, WorkflowNotFoundError, WorkflowParamsInvalidError } from "@fragno-dev/workflows/workflow";
+import { validateWorkflowParams } from "@fragno-dev/workflows";
+//#region src/routes.ts
+const DEFAULT_PAGE_SIZE = 50;
+const MAX_PAGE_SIZE = 200;
+const DEFAULT_COMMAND_STEP_WAIT_TIMEOUT_MS = 12e4;
+const createCommandPayload = (commandId, command) => {
+	switch (command.kind) {
+		case "prompt": return {
+			commandId,
+			kind: command.kind,
+			input: command.input
+		};
+		case "skill": return {
+			commandId,
+			kind: command.kind,
+			input: command.input
+		};
+		case "promptFromTemplate": return {
+			commandId,
+			kind: command.kind,
+			input: command.input
+		};
+		case "compact": return {
+			commandId,
+			kind: command.kind,
+			input: command.input
+		};
+		case "steer": return {
+			commandId,
+			kind: command.kind,
+			input: command.input
+		};
+		case "followUp": return {
+			commandId,
+			kind: command.kind,
+			input: command.input
+		};
+		case "abort": return command.reason ? {
+			commandId,
+			kind: command.kind,
+			reason: command.reason
+		} : {
+			commandId,
+			kind: command.kind
+		};
+	}
+	throw new Error("Unsupported Pi session command kind.");
+};
+const parsePositiveIntegerQueryValue = (value) => {
+	if (value === null) return;
+	const parsed = Number.parseInt(value, 10);
+	return Number.isFinite(parsed) && parsed > 0 ? parsed : void 0;
+};
+const toSessionDetail = (snapshot) => ({
+	...snapshot.session,
+	workflow: {
+		status: snapshot.workflowStatus.status,
+		error: snapshot.workflowStatus.error,
+		output: snapshot.workflowStatus.output
+	},
+	agent: { state: { messages: snapshot.messages } }
+});
+const piRoutesFactory = defineRoutes(piHarnessDefinition).create(({ config, defineRoute, serviceDeps, services }) => {
+	if (config.logging) WorkflowsLogger.configure(config.logging);
+	const toSessionDetailLoadError = (err, workflowName, sessionId) => {
+		if (err instanceof WorkflowInstanceNotFoundError) return {
+			body: {
+				message: `Session ${workflowName}/${sessionId} not found.`,
+				code: "SESSION_NOT_FOUND"
+			},
+			init: { status: 404 }
+		};
+		if (err instanceof PiSessionDataUnavailableError) return {
+			body: {
+				message: err.message,
+				code: "SESSION_DATA_UNAVAILABLE"
+			},
+			init: { status: 404 }
+		};
+		if (err instanceof PiSessionDataIntegrityError) return {
+			body: {
+				message: err.message,
+				code: "SESSION_DATA_INTEGRITY_ERROR"
+			},
+			init: { status: 500 }
+		};
+		return {
+			body: {
+				message: err instanceof Error ? err.message : "Failed to load workflow detail.",
+				code: "WORKFLOW_INSTANCE_MISSING"
+			},
+			init: { status: 500 }
+		};
+	};
+	return [
+		defineRoute({
+			method: "POST",
+			path: "/workflows/:workflowName/sessions",
+			inputSchema: z.object({
+				name: z.string().optional(),
+				metadata: z.record(z.string(), z.unknown()).optional(),
+				input: z.unknown().optional()
+			}),
+			outputSchema: sessionBaseSchema,
+			errorCodes: [
+				"WORKFLOW_NOT_FOUND",
+				"WORKFLOW_PARAMS_INVALID",
+				"WORKFLOW_CREATE_FAILED"
+			],
+			handler: async function({ input, pathParams }, { json, error }) {
+				const values = await input.valid();
+				const workflowName = pathParams.workflowName;
+				const now = /* @__PURE__ */ new Date();
+				const sessionId = createId();
+				try {
+					const validatedParams = await validateWorkflowParams(new Map((config.workflows ?? []).map((workflow) => [workflow.name, workflow])), workflowName, values.input);
+					if (typeof validatedParams !== "object" || validatedParams === null || Array.isArray(validatedParams)) throw new WorkflowParamsInvalidError(workflowName, ["Workflow parameters must resolve to an object."]);
+					const params = { ...validatedParams };
+					if (values.metadata !== void 0) params["metadata"] = values.metadata;
+					else delete params["metadata"];
+					await this.handlerTx().withServiceCalls(() => [services.createWorkflowSession({
+						id: sessionId,
+						workflowName,
+						name: values.name,
+						params
+					})]).execute();
+					return json({
+						id: sessionId,
+						name: values.name ?? null,
+						metadata: values.metadata ?? null,
+						workflowName,
+						createdAt: now,
+						updatedAt: now
+					});
+				} catch (err) {
+					if (err instanceof WorkflowNotFoundError) return error({
+						message: `Workflow ${workflowName} not found.`,
+						code: "WORKFLOW_NOT_FOUND"
+					}, { status: 404 });
+					if (err instanceof WorkflowParamsInvalidError) return error({
+						message: "Workflow input is invalid.",
+						code: "WORKFLOW_PARAMS_INVALID"
+					}, { status: 400 });
+					return error({
+						message: err instanceof Error ? err.message : "Failed to create workflow instance.",
+						code: "WORKFLOW_CREATE_FAILED"
+					}, { status: 500 });
+				}
+			}
+		}),
+		defineRoute({
+			method: "GET",
+			path: "/workflows/:workflowName/sessions",
+			queryParameters: ["limit"],
+			outputSchema: z.array(sessionBaseSchema),
+			errorCodes: ["SESSION_DATA_INTEGRITY_ERROR"],
+			handler: async function({ pathParams, query }, { json, error }) {
+				const workflowName = pathParams.workflowName;
+				const limit = Number.parseInt(query.get("limit") ?? `${DEFAULT_PAGE_SIZE}`, 10);
+				const normalizedLimit = Number.isFinite(limit) ? Math.max(1, Math.min(MAX_PAGE_SIZE, limit)) : DEFAULT_PAGE_SIZE;
+				const result = await this.handlerTx().withServiceCalls(() => [serviceDeps.workflows.listInstances({
+					workflowName,
+					pageSize: normalizedLimit
+				})]).transform(({ serviceResult: [result] }) => result).execute();
+				try {
+					return json(result.instances.flatMap((instance) => {
+						const session = projectPiSessionFromWorkflowInstance({
+							id: instance.id,
+							workflowName,
+							params: instance.params,
+							createdAt: instance.createdAt,
+							updatedAt: instance.updatedAt
+						});
+						return session ? [session] : [];
+					}));
+				} catch (err) {
+					if (err instanceof PiSessionDataIntegrityError) return error({
+						message: err.message,
+						code: "SESSION_DATA_INTEGRITY_ERROR"
+					}, { status: 500 });
+					throw err;
+				}
+			}
+		}),
+		defineRoute({
+			method: "GET",
+			path: "/workflows/:workflowName/sessions/:sessionId",
+			outputSchema: sessionDetailSchema,
+			errorCodes: [
+				"SESSION_NOT_FOUND",
+				"SESSION_DATA_UNAVAILABLE",
+				"SESSION_DATA_INTEGRITY_ERROR",
+				"WORKFLOW_INSTANCE_MISSING"
+			],
+			handler: async function({ pathParams: { workflowName, sessionId } }, { json, error }) {
+				try {
+					const result = await this.handlerTx().withServiceCalls(() => [services.getSessionDetailSnapshot(workflowName, sessionId)]).transform(({ serviceResult: [snapshot] }) => snapshot).execute();
+					return json(toSessionDetail(result));
+				} catch (err) {
+					const loadError = toSessionDetailLoadError(err, workflowName, sessionId);
+					return error(loadError.body, loadError.init);
+				}
+			}
+		}),
+		defineRoute({
+			method: "GET",
+			path: "/workflows/:workflowName/sessions/:sessionId/export/pi-jsonl",
+			errorCodes: [
+				"SESSION_NOT_FOUND",
+				"SESSION_DATA_UNAVAILABLE",
+				"SESSION_DATA_INTEGRITY_ERROR",
+				"WORKFLOW_INSTANCE_MISSING"
+			],
+			handler: async function({ pathParams: { workflowName, sessionId } }, { error }) {
+				try {
+					const snapshot = await this.handlerTx().withServiceCalls(() => [services.getSessionDetailSnapshot(workflowName, sessionId)]).transform(({ serviceResult: [snapshot] }) => snapshot).execute();
+					const jsonl = await exportSessionStorageToJsonl(new WorkflowBackedSessionStorage({
+						metadata: {
+							id: snapshot.session.id,
+							createdAt: snapshot.session.createdAt.toISOString()
+						},
+						entries: snapshot.sessionEntries,
+						entryIds: createWorkflowBackedSessionEntryIdAllocator({
+							prefix: `${snapshot.session.id}:export:entry`,
+							startIndex: snapshot.sessionEntries.length
+						})
+					}), { cwd: PI_JSONL_EXPORT_CWD });
+					return new Response(jsonl, {
+						status: 200,
+						headers: {
+							"content-type": "application/x-ndjson; charset=utf-8",
+							"content-disposition": `attachment; filename="pi-session-${sessionId}.jsonl"`
+						}
+					});
+				} catch (err) {
+					const loadError = toSessionDetailLoadError(err, workflowName, sessionId);
+					return error(loadError.body, loadError.init);
+				}
+			}
+		}),
+		defineRoute({
+			method: "GET",
+			path: "/workflows/:workflowName/sessions/:sessionId/commands/:commandId/wait",
+			queryParameters: ["timeoutMs"],
+			errorCodes: [
+				"SESSION_NOT_FOUND",
+				"WORKFLOW_INSTANCE_MISSING",
+				"INVALID_COMMAND_ID",
+				"COMMAND_NOT_WAITABLE",
+				"COMMAND_STEP_TIMEOUT",
+				"COMMAND_STEP_FAILED",
+				"COMMAND_WORKFLOW_TERMINAL"
+			],
+			handler: async function({ pathParams, query }, { empty, error }) {
+				const timeoutMs = parsePositiveIntegerQueryValue(query.get("timeoutMs"));
+				const workflowName = pathParams.workflowName;
+				const sessionId = pathParams.sessionId;
+				const commandId = pathParams.commandId;
+				const waitability = piSessionCommandWaitability(commandId);
+				if (waitability === "invalid") return error({
+					message: "Invalid command id.",
+					code: "INVALID_COMMAND_ID"
+				}, { status: 400 });
+				if (waitability === "control") return error({
+					message: "Control commands cannot be waited on.",
+					code: "COMMAND_NOT_WAITABLE"
+				}, { status: 400 });
+				const waitTimeoutMs = timeoutMs ?? DEFAULT_COMMAND_STEP_WAIT_TIMEOUT_MS;
+				try {
+					await waitForCommandStep({
+						handlerTx: this.handlerTx.bind(this),
+						workflows: serviceDeps.workflows,
+						workflowName,
+						instanceId: sessionId,
+						commandId,
+						timeoutMs: waitTimeoutMs
+					});
+					return empty(204);
+				} catch (err) {
+					if (err instanceof CommandStepWaitTimeoutError) return error({
+						message: err.message,
+						code: "COMMAND_STEP_TIMEOUT"
+					}, { status: 408 });
+					if (err instanceof CommandStepFailedError) return error({
+						message: err.message,
+						code: "COMMAND_STEP_FAILED"
+					}, { status: 409 });
+					if (err instanceof CommandWorkflowTerminatedError) return error({
+						message: err.message,
+						code: "COMMAND_WORKFLOW_TERMINAL"
+					}, { status: 409 });
+					if (err instanceof WorkflowInstanceNotFoundError) return error({
+						message: `Session ${workflowName}/${sessionId} not found.`,
+						code: "SESSION_NOT_FOUND"
+					}, { status: 404 });
+					return error({
+						message: err instanceof Error ? err.message : "Failed to wait for command step.",
+						code: "WORKFLOW_INSTANCE_MISSING"
+					}, { status: 500 });
+				}
+			}
+		}),
+		defineRoute({
+			method: "POST",
+			path: "/workflows/:workflowName/sessions/:sessionId/command",
+			inputSchema: commandInputSchema,
+			outputSchema: commandAckSchema,
+			errorCodes: ["SESSION_NOT_FOUND", "WORKFLOW_INSTANCE_MISSING"],
+			handler: async function({ input, pathParams }, { json, error }) {
+				const command = await input.valid();
+				const workflowName = pathParams.workflowName;
+				const sessionId = pathParams.sessionId;
+				const workflowsService = serviceDeps.workflows;
+				const commandId = createPiSessionCommandId(command.kind);
+				const payload = createCommandPayload(commandId, command);
+				try {
+					return json({
+						accepted: true,
+						commandId,
+						status: (await this.handlerTx().withServiceCalls(() => serviceCalls(workflowsService.sendEvent(workflowName, sessionId, {
+							type: "command",
+							payload
+						}), workflowsService.getInstanceStatus(workflowName, sessionId))).transform(({ serviceResult: [, workflowStatus] }) => ({ workflowStatus })).execute()).workflowStatus.status
+					}, 202);
+				} catch (err) {
+					if (err instanceof WorkflowInstanceNotFoundError) return error({
+						message: `Session ${workflowName}/${sessionId} not found.`,
+						code: "SESSION_NOT_FOUND"
+					}, { status: 404 });
+					return error({
+						message: err instanceof Error ? err.message : "Failed to deliver command.",
+						code: "WORKFLOW_INSTANCE_MISSING"
+					}, { status: 500 });
+				}
+			}
+		})
+	];
+});
+//#endregion
+export { piRoutesFactory };
+
+//# sourceMappingURL=routes.js.map

package/dist/node/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","names":[],"sources":["../../src/routes.ts"],"sourcesContent":["import { createId } from \"@fragno-dev/db/id\";\nimport { WorkflowsLogger } from \"@fragno-dev/workflows/debug-log\";\nimport {\n  WorkflowInstanceNotFoundError,\n  WorkflowNotFoundError,\n  WorkflowParamsInvalidError,\n} from \"@fragno-dev/workflows/workflow\";\nimport { z } from \"zod\";\n\nimport { defineRoutes } from \"@fragno-dev/core\";\nimport { serviceCalls } from \"@fragno-dev/db\";\nimport { validateWorkflowParams } from \"@fragno-dev/workflows\";\n\nimport { piHarnessDefinition, type PiSessionDetailSnapshot } from \"./pi/definition\";\nimport {\n  createWorkflowBackedSessionEntryIdAllocator,\n  WorkflowBackedSessionStorage,\n} from \"./pi/harness/session-storage\";\nimport { exportSessionStorageToJsonl, PI_JSONL_EXPORT_CWD } from \"./pi/pi-jsonl-export\";\nimport {\n  commandAckSchema,\n  commandInputSchema,\n  sessionBaseSchema,\n  sessionDetailSchema,\n} from \"./pi/route-schemas\";\nimport {\n  createPiSessionCommandId,\n  piSessionCommandWaitability,\n} from \"./pi/session-command-protocol\";\nimport {\n  PiSessionDataIntegrityError,\n  PiSessionDataUnavailableError,\n  projectPiSessionFromWorkflowInstance,\n  type PiSessionCommandPayload,\n  type PiSessionDetail,\n} from \"./pi/types\";\nimport {\n  CommandStepFailedError,\n  CommandStepWaitTimeoutError,\n  CommandWorkflowTerminatedError,\n  waitForCommandStep,\n} from \"./pi/wait-for-command-step\";\n\nconst DEFAULT_PAGE_SIZE = 50;\nconst MAX_PAGE_SIZE = 200;\nconst DEFAULT_COMMAND_STEP_WAIT_TIMEOUT_MS = 120_000;\nconst createCommandPayload = (\n  commandId: string,\n  command: z.infer<typeof commandInputSchema>,\n): PiSessionCommandPayload => {\n  switch (command.kind) {\n    case \"prompt\":\n      return { commandId, kind: command.kind, input: command.input };\n    case \"skill\":\n      return { commandId, kind: command.kind, input: command.input };\n    case \"promptFromTemplate\":\n      return { commandId, kind: command.kind, input: command.input };\n    case \"compact\":\n      return { commandId, kind: command.kind, input: command.input };\n    case \"steer\":\n      return { commandId, kind: command.kind, input: command.input };\n    case \"followUp\":\n      return { commandId, kind: command.kind, input: command.input };\n    case \"abort\":\n      return command.reason\n        ? { commandId, kind: command.kind, reason: command.reason }\n        : { commandId, kind: command.kind };\n  }\n\n  throw new Error(\"Unsupported Pi session command kind.\");\n};\n\nconst parsePositiveIntegerQueryValue = (value: string | null): number | undefined => {\n  if (value === null) {\n    return undefined;\n  }\n  const parsed = Number.parseInt(value, 10);\n  return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;\n};\n\nconst toSessionDetail = (snapshot: PiSessionDetailSnapshot): PiSessionDetail => ({\n  ...snapshot.session,\n  workflow: {\n    status: snapshot.workflowStatus.status,\n    error: snapshot.workflowStatus.error,\n    output: snapshot.workflowStatus.output,\n  },\n  agent: {\n    state: { messages: snapshot.messages },\n  },\n});\n\nexport const piRoutesFactory = defineRoutes(piHarnessDefinition).create(\n  ({ config, defineRoute, serviceDeps, services }) => {\n    if (config.logging) {\n      WorkflowsLogger.configure(config.logging);\n    }\n\n    const toSessionDetailLoadError = (err: unknown, workflowName: string, sessionId: string) => {\n      if (err instanceof WorkflowInstanceNotFoundError) {\n        return {\n          body: {\n            message: `Session ${workflowName}/${sessionId} not found.`,\n            code: \"SESSION_NOT_FOUND\" as const,\n          },\n          init: { status: 404 as const },\n        };\n      }\n      if (err instanceof PiSessionDataUnavailableError) {\n        return {\n          body: {\n            message: err.message,\n            code: \"SESSION_DATA_UNAVAILABLE\" as const,\n          },\n          init: { status: 404 as const },\n        };\n      }\n      if (err instanceof PiSessionDataIntegrityError) {\n        return {\n          body: {\n            message: err.message,\n            code: \"SESSION_DATA_INTEGRITY_ERROR\" as const,\n          },\n          init: { status: 500 as const },\n        };\n      }\n      const message = err instanceof Error ? err.message : \"Failed to load workflow detail.\";\n      return {\n        body: { message, code: \"WORKFLOW_INSTANCE_MISSING\" as const },\n        init: { status: 500 as const },\n      };\n    };\n\n    return [\n      defineRoute({\n        method: \"POST\",\n        path: \"/workflows/:workflowName/sessions\",\n        inputSchema: z.object({\n          name: z.string().optional(),\n          metadata: z.record(z.string(), z.unknown()).optional(),\n          input: z.unknown().optional(),\n        }),\n        outputSchema: sessionBaseSchema,\n        errorCodes: [\"WORKFLOW_NOT_FOUND\", \"WORKFLOW_PARAMS_INVALID\", \"WORKFLOW_CREATE_FAILED\"],\n        handler: async function ({ input, pathParams }, { json, error }) {\n          const values = await input.valid();\n\n          const workflowName = pathParams.workflowName;\n          const now = new Date();\n          const sessionId = createId();\n\n          try {\n            const workflowsByName = new Map(\n              (config.workflows ?? []).map((workflow) => [workflow.name, workflow]),\n            );\n            const validatedParams = await validateWorkflowParams(\n              workflowsByName,\n              workflowName,\n              values.input,\n            );\n            if (\n              typeof validatedParams !== \"object\" ||\n              validatedParams === null ||\n              Array.isArray(validatedParams)\n            ) {\n              throw new WorkflowParamsInvalidError(workflowName, [\n                \"Workflow parameters must resolve to an object.\",\n              ]);\n            }\n            const params = { ...(validatedParams as Record<string, unknown>) };\n            if (values.metadata !== undefined) {\n              params[\"metadata\"] = values.metadata;\n            } else {\n              delete params[\"metadata\"];\n            }\n            await this.handlerTx()\n              .withServiceCalls(() => [\n                services.createWorkflowSession({\n                  id: sessionId,\n                  workflowName,\n                  name: values.name,\n                  params,\n                }),\n              ])\n              .execute();\n\n            return json({\n              id: sessionId,\n              name: values.name ?? null,\n              metadata: values.metadata ?? null,\n              workflowName,\n              createdAt: now,\n              updatedAt: now,\n            });\n          } catch (err) {\n            if (err instanceof WorkflowNotFoundError) {\n              return error(\n                { message: `Workflow ${workflowName} not found.`, code: \"WORKFLOW_NOT_FOUND\" },\n                { status: 404 },\n              );\n            }\n            if (err instanceof WorkflowParamsInvalidError) {\n              return error(\n                { message: \"Workflow input is invalid.\", code: \"WORKFLOW_PARAMS_INVALID\" },\n                { status: 400 },\n              );\n            }\n            const message =\n              err instanceof Error ? err.message : \"Failed to create workflow instance.\";\n            return error({ message, code: \"WORKFLOW_CREATE_FAILED\" }, { status: 500 });\n          }\n        },\n      }),\n      defineRoute({\n        method: \"GET\",\n        path: \"/workflows/:workflowName/sessions\",\n        queryParameters: [\"limit\"],\n        outputSchema: z.array(sessionBaseSchema),\n        errorCodes: [\"SESSION_DATA_INTEGRITY_ERROR\"],\n        handler: async function ({ pathParams, query }, { json, error }) {\n          const workflowName = pathParams.workflowName;\n          const limit = Number.parseInt(query.get(\"limit\") ?? `${DEFAULT_PAGE_SIZE}`, 10);\n          const normalizedLimit = Number.isFinite(limit)\n            ? Math.max(1, Math.min(MAX_PAGE_SIZE, limit))\n            : DEFAULT_PAGE_SIZE;\n\n          // TODO: Apply the limit after excluding workflow instances without Pi metadata, so non-Pi rows do not consume the requested page.\n          const result = await this.handlerTx()\n            .withServiceCalls(() => [\n              serviceDeps.workflows.listInstances({\n                workflowName,\n                pageSize: normalizedLimit,\n              }),\n            ])\n            .transform(({ serviceResult: [result] }) => result)\n            .execute();\n\n          try {\n            return json(\n              result.instances.flatMap((instance) => {\n                const session = projectPiSessionFromWorkflowInstance({\n                  id: instance.id,\n                  workflowName,\n                  params: instance.params,\n                  createdAt: instance.createdAt,\n                  updatedAt: instance.updatedAt,\n                });\n                return session ? [session] : [];\n              }),\n            );\n          } catch (err) {\n            if (err instanceof PiSessionDataIntegrityError) {\n              return error(\n                { message: err.message, code: \"SESSION_DATA_INTEGRITY_ERROR\" },\n                { status: 500 },\n              );\n            }\n            throw err;\n          }\n        },\n      }),\n      defineRoute({\n        method: \"GET\",\n        path: \"/workflows/:workflowName/sessions/:sessionId\",\n        outputSchema: sessionDetailSchema,\n        errorCodes: [\n          \"SESSION_NOT_FOUND\",\n          \"SESSION_DATA_UNAVAILABLE\",\n          \"SESSION_DATA_INTEGRITY_ERROR\",\n          \"WORKFLOW_INSTANCE_MISSING\",\n        ],\n        handler: async function ({ pathParams: { workflowName, sessionId } }, { json, error }) {\n          try {\n            const result = await this.handlerTx()\n              .withServiceCalls(\n                () => [services.getSessionDetailSnapshot(workflowName, sessionId)] as const,\n              )\n              .transform(({ serviceResult: [snapshot] }) => snapshot)\n              .execute();\n            return json(toSessionDetail(result));\n          } catch (err) {\n            const loadError = toSessionDetailLoadError(err, workflowName, sessionId);\n            return error(loadError.body, loadError.init);\n          }\n        },\n      }),\n      defineRoute({\n        method: \"GET\",\n        path: \"/workflows/:workflowName/sessions/:sessionId/export/pi-jsonl\",\n        errorCodes: [\n          \"SESSION_NOT_FOUND\",\n          \"SESSION_DATA_UNAVAILABLE\",\n          \"SESSION_DATA_INTEGRITY_ERROR\",\n          \"WORKFLOW_INSTANCE_MISSING\",\n        ],\n        handler: async function ({ pathParams: { workflowName, sessionId } }, { error }) {\n          try {\n            const snapshot = await this.handlerTx()\n              .withServiceCalls(\n                () => [services.getSessionDetailSnapshot(workflowName, sessionId)] as const,\n              )\n              .transform(({ serviceResult: [snapshot] }) => snapshot)\n              .execute();\n            const storage = new WorkflowBackedSessionStorage({\n              metadata: {\n                id: snapshot.session.id,\n                createdAt: snapshot.session.createdAt.toISOString(),\n              },\n              entries: snapshot.sessionEntries,\n              entryIds: createWorkflowBackedSessionEntryIdAllocator({\n                prefix: `${snapshot.session.id}:export:entry`,\n                startIndex: snapshot.sessionEntries.length,\n              }),\n            });\n            const jsonl = await exportSessionStorageToJsonl(storage, { cwd: PI_JSONL_EXPORT_CWD });\n\n            return new Response(jsonl, {\n              status: 200,\n              headers: {\n                \"content-type\": \"application/x-ndjson; charset=utf-8\",\n                \"content-disposition\": `attachment; filename=\"pi-session-${sessionId}.jsonl\"`,\n              },\n            });\n          } catch (err) {\n            const loadError = toSessionDetailLoadError(err, workflowName, sessionId);\n            return error(loadError.body, loadError.init);\n          }\n        },\n      }),\n      defineRoute({\n        method: \"GET\",\n        path: \"/workflows/:workflowName/sessions/:sessionId/commands/:commandId/wait\",\n        queryParameters: [\"timeoutMs\"],\n        errorCodes: [\n          \"SESSION_NOT_FOUND\",\n          \"WORKFLOW_INSTANCE_MISSING\",\n          \"INVALID_COMMAND_ID\",\n          \"COMMAND_NOT_WAITABLE\",\n          \"COMMAND_STEP_TIMEOUT\",\n          \"COMMAND_STEP_FAILED\",\n          \"COMMAND_WORKFLOW_TERMINAL\",\n        ],\n        handler: async function ({ pathParams, query }, { empty, error }) {\n          const timeoutMs = parsePositiveIntegerQueryValue(query.get(\"timeoutMs\"));\n          const workflowName = pathParams.workflowName;\n          const sessionId = pathParams.sessionId;\n          const commandId = pathParams.commandId;\n          const waitability = piSessionCommandWaitability(commandId);\n          if (waitability === \"invalid\") {\n            return error(\n              { message: \"Invalid command id.\", code: \"INVALID_COMMAND_ID\" },\n              { status: 400 },\n            );\n          }\n          if (waitability === \"control\") {\n            return error(\n              { message: \"Control commands cannot be waited on.\", code: \"COMMAND_NOT_WAITABLE\" },\n              { status: 400 },\n            );\n          }\n          const waitTimeoutMs = timeoutMs ?? DEFAULT_COMMAND_STEP_WAIT_TIMEOUT_MS;\n\n          try {\n            await waitForCommandStep({\n              handlerTx: this.handlerTx.bind(this),\n              workflows: serviceDeps.workflows,\n              workflowName,\n              instanceId: sessionId,\n              commandId,\n              timeoutMs: waitTimeoutMs,\n            });\n\n            return empty(204);\n          } catch (err) {\n            if (err instanceof CommandStepWaitTimeoutError) {\n              return error({ message: err.message, code: \"COMMAND_STEP_TIMEOUT\" }, { status: 408 });\n            }\n            if (err instanceof CommandStepFailedError) {\n              return error({ message: err.message, code: \"COMMAND_STEP_FAILED\" }, { status: 409 });\n            }\n            if (err instanceof CommandWorkflowTerminatedError) {\n              return error(\n                { message: err.message, code: \"COMMAND_WORKFLOW_TERMINAL\" },\n                { status: 409 },\n              );\n            }\n            if (err instanceof WorkflowInstanceNotFoundError) {\n              return error(\n                {\n                  message: `Session ${workflowName}/${sessionId} not found.`,\n                  code: \"SESSION_NOT_FOUND\",\n                },\n                { status: 404 },\n              );\n            }\n            return error(\n              {\n                message: err instanceof Error ? err.message : \"Failed to wait for command step.\",\n                code: \"WORKFLOW_INSTANCE_MISSING\",\n              },\n              { status: 500 },\n            );\n          }\n        },\n      }),\n      defineRoute({\n        method: \"POST\",\n        path: \"/workflows/:workflowName/sessions/:sessionId/command\",\n        inputSchema: commandInputSchema,\n        outputSchema: commandAckSchema,\n        errorCodes: [\"SESSION_NOT_FOUND\", \"WORKFLOW_INSTANCE_MISSING\"],\n        handler: async function ({ input, pathParams }, { json, error }) {\n          const command = await input.valid();\n          const workflowName = pathParams.workflowName;\n          const sessionId = pathParams.sessionId;\n          const workflowsService = serviceDeps.workflows;\n          const commandId = createPiSessionCommandId(command.kind);\n          const payload = createCommandPayload(commandId, command);\n\n          try {\n            const result = await this.handlerTx()\n              .withServiceCalls(() =>\n                serviceCalls(\n                  workflowsService.sendEvent(workflowName, sessionId, {\n                    type: \"command\",\n                    payload,\n                  }),\n                  workflowsService.getInstanceStatus(workflowName, sessionId),\n                ),\n              )\n              .transform(({ serviceResult: [, workflowStatus] }) => ({ workflowStatus }))\n              .execute();\n\n            return json(\n              {\n                accepted: true,\n                commandId,\n                status: result.workflowStatus.status,\n              },\n              202,\n            );\n          } catch (err) {\n            if (err instanceof WorkflowInstanceNotFoundError) {\n              return error(\n                {\n                  message: `Session ${workflowName}/${sessionId} not found.`,\n                  code: \"SESSION_NOT_FOUND\",\n                },\n                { status: 404 },\n              );\n            }\n            const message = err instanceof Error ? err.message : \"Failed to deliver command.\";\n            return error({ message, code: \"WORKFLOW_INSTANCE_MISSING\" }, { status: 500 });\n          }\n        },\n      }),\n    ];\n  },\n);\n"],"mappings":"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"}

package/dist/node/schema.d.ts

@@ -0,0 +1,5 @@
+//#region src/schema.d.ts
+declare const piSchema: import("@fragno-dev/db/schema").Schema<{}>;
+//#endregion
+export { piSchema };
+//# sourceMappingURL=schema.d.ts.map

package/dist/node/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","names":[],"sources":["../../src/schema.ts"],"mappings":";cAEa,0CAAQ"}

package/dist/node/schema.js

@@ -0,0 +1,7 @@
+import { schema } from "@fragno-dev/db/schema";
+//#region src/schema.ts
+const piSchema = schema("pi-harness", (s) => s.noOp("store Pi session metadata in workflow instance params"));
+//#endregion
+export { piSchema };
+
+//# sourceMappingURL=schema.js.map

package/dist/node/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","names":[],"sources":["../../src/schema.ts"],"sourcesContent":["import { schema } from \"@fragno-dev/db/schema\";\n\nexport const piSchema = schema(\"pi-harness\", (s) =>\n  s.noOp(\"store Pi session metadata in workflow instance params\"),\n);\n"],"mappings":";;AAEA,MAAa,WAAW,OAAO,eAAe,MAC5C,EAAE,KAAK,uDAAuD,CAChE"}

package/package.json

@@ -1,6 +1,178 @@
 {
   "name": "@fragno-dev/pi-harness",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.3",
+  "description": "A Fragno fragment for Pi workflow session harnessing",
+  "keywords": [
+    "fragno",
+    "react",
+    "solidjs",
+    "svelte",
+    "typescript",
+    "vue"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rejot-dev/fragno.git",
+    "directory": "packages/pi-harness"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    "./client": {
+      "types": "./dist/browser/client/clients.d.ts",
+      "default": "./dist/browser/client/clients.js"
+    },
+    "./client/pi-workflow-emission-stream": {
+      "types": "./dist/browser/client/pi-workflow-emission-stream.d.ts",
+      "default": "./dist/browser/client/pi-workflow-emission-stream.js"
+    },
+    "./client/workflow-lofi-session-projection": {
+      "types": "./dist/browser/client/workflow-lofi-session-projection.d.ts",
+      "default": "./dist/browser/client/workflow-lofi-session-projection.js"
+    },
+    "./context-usage": {
+      "types": "./dist/browser/pi/context-usage.d.ts",
+      "browser": "./dist/browser/pi/context-usage.js",
+      "default": "./dist/node/pi/context-usage.js"
+    },
+    "./definition": {
+      "types": "./dist/node/pi/definition.d.ts",
+      "default": "./dist/node/pi/definition.js"
+    },
+    "./factory": {
+      "types": "./dist/node/pi/factory.d.ts",
+      "default": "./dist/node/pi/factory.js"
+    },
+    "./harness/agent-harness-event-protocol": {
+      "types": "./dist/browser/pi/harness/agent-harness-event-protocol.d.ts",
+      "browser": "./dist/browser/pi/harness/agent-harness-event-protocol.js",
+      "default": "./dist/node/pi/harness/agent-harness-event-protocol.js"
+    },
+    "./harness/pi-operation-completed": {
+      "types": "./dist/node/pi/harness/pi-operation-completed.d.ts",
+      "default": "./dist/node/pi/harness/pi-operation-completed.js"
+    },
+    "./harness/session-storage": {
+      "types": "./dist/node/pi/harness/session-storage.d.ts",
+      "default": "./dist/node/pi/harness/session-storage.js"
+    },
+    "./react": {
+      "types": "./dist/browser/client/react.d.ts",
+      "default": "./dist/browser/client/react.js"
+    },
+    "./pi-jsonl-export": {
+      "types": "./dist/node/pi/pi-jsonl-export.d.ts",
+      "default": "./dist/node/pi/pi-jsonl-export.js"
+    },
+    "./route-schemas": {
+      "types": "./dist/node/pi/route-schemas.d.ts",
+      "browser": "./dist/browser/pi/route-schemas.js",
+      "default": "./dist/node/pi/route-schemas.js"
+    },
+    "./routes": {
+      "types": "./dist/node/routes.d.ts",
+      "default": "./dist/node/routes.js"
+    },
+    "./schema": {
+      "types": "./dist/node/schema.d.ts",
+      "default": "./dist/node/schema.js"
+    },
+    "./skills": {
+      "types": "./dist/node/pi/skills.d.ts",
+      "default": "./dist/node/pi/skills.js"
+    },
+    "./solid": {
+      "types": "./dist/browser/client/solid.d.ts",
+      "default": "./dist/browser/client/solid.js"
+    },
+    "./svelte": {
+      "types": "./dist/browser/client/svelte.d.ts",
+      "default": "./dist/browser/client/svelte.js"
+    },
+    "./tools": {
+      "types": "./dist/node/pi/tools.d.ts",
+      "default": "./dist/node/pi/tools.js"
+    },
+    "./types": {
+      "types": "./dist/node/pi/types.d.ts",
+      "default": "./dist/node/pi/types.js"
+    },
+    "./workflow-session-projection": {
+      "types": "./dist/browser/pi/workflow-session-projection.d.ts",
+      "browser": "./dist/browser/pi/workflow-session-projection.js",
+      "default": "./dist/node/pi/workflow-session-projection.js"
+    },
+    "./vanilla": {
+      "types": "./dist/browser/client/vanilla.d.ts",
+      "default": "./dist/browser/client/vanilla.js"
+    },
+    "./vue": {
+      "types": "./dist/browser/client/vue.d.ts",
+      "default": "./dist/browser/client/vue.js"
+    },
+    "./workflows/interactive-chat-workflow": {
+      "types": "./dist/node/pi/workflows/interactive-chat-workflow.d.ts",
+      "default": "./dist/node/pi/workflows/interactive-chat-workflow.js"
+    },
+    "./workflows/workflow-agent-harness": {
+      "types": "./dist/node/pi/workflows/workflow-agent-harness.d.ts",
+      "default": "./dist/node/pi/workflows/workflow-agent-harness.js"
+    }
+  },
+  "dependencies": {
+    "@earendil-works/pi-agent-core": "0.83.0",
+    "@earendil-works/pi-ai": "0.83.0",
+    "@standard-schema/spec": "^1.1.0",
+    "nanostores": "^1.2.0",
+    "typebox": "1.3.27",
+    "zod": "^4.5.4",
+    "@fragno-dev/core": "0.2.2",
+    "@fragno-dev/db": "0.4.1",
+    "@fragno-dev/lofi": "0.0.3",
+    "@fragno-dev/workflows": "0.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.2",
+    "@types/react": "^19.2.14",
+    "drizzle-kit": "^0.31.7",
+    "drizzle-orm": "^0.44.7",
+    "fake-indexeddb": "^6.2.5",
+    "tsdown": "^0.22.4",
+    "vitest": "^4.1.4",
+    "@fragno-dev/test": "2.0.2",
+    "@fragno-dev/unplugin-fragno": "0.0.9"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "solid-js": ">=1.0.0",
+    "svelte": ">=4.0.0",
+    "typescript": "npm:@typescript/typescript6@^6.0.2",
+    "vue": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "svelte": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    },
+    "solid-js": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "types:check": "tsc --noEmit",
+    "build": "tsdown",
+    "test": "vitest run",
+    "measure:event-encoder": "pnpm run build && node scripts/measure-event-encoder-allocation.mjs",
+    "format:package": "node ../../scripts/run-package-quality.mjs format",
+    "format:check:package": "node ../../scripts/run-package-quality.mjs format:check",
+    "lint:package": "node ../../scripts/run-package-quality.mjs lint",
+    "lint:fix:package": "node ../../scripts/run-package-quality.mjs lint:fix"
+  }
 }