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

package/dist/node/pi/skills.js

@@ -0,0 +1,150 @@
+import { Type } from "typebox";
+//#region src/pi/skills.ts
+const escapeXml = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&apos;");
+const isPiSkillDefinitionArray = (skills) => Array.isArray(skills);
+const skillCatalogEntries = (skills) => (isPiSkillDefinitionArray(skills) ? skills : Object.values(skills)).toSorted((left, right) => left.name.localeCompare(right.name));
+const renderPiSkillCatalogXml = (skills) => {
+	const entries = skillCatalogEntries(skills);
+	if (entries.length === 0) return "";
+	return `<available_skills>
+${entries.map((skill) => `  <skill>
+    <name>${escapeXml(skill.name)}</name>
+    <description>${escapeXml(skill.description)}</description>
+  </skill>`).join("\n")}
+</available_skills>`;
+};
+const renderSkillResourceXml = (resource) => {
+	return `    <file>\n${[
+		`      <path>${escapeXml(resource.path)}</path>`,
+		resource.description === void 0 ? void 0 : `      <description>${escapeXml(resource.description)}</description>`,
+		resource.mimeType === void 0 ? void 0 : `      <mimeType>${escapeXml(resource.mimeType)}</mimeType>`
+	].filter((field) => field !== void 0).join("\n")}\n    </file>`;
+};
+const inferSkillDirectory = (skill) => {
+	if (skill.directory !== void 0) return skill.directory;
+	if (skill.location === void 0) return;
+	const normalizedLocation = skill.location.replaceAll("\\", "/");
+	const lastSlash = normalizedLocation.lastIndexOf("/");
+	if (lastSlash === -1) return;
+	return normalizedLocation.slice(0, lastSlash);
+};
+const renderPiSkillActivationXml = (skill) => {
+	const directory = inferSkillDirectory(skill);
+	const sections = [
+		`<name>${escapeXml(skill.name)}</name>`,
+		`<description>${escapeXml(skill.description)}</description>`,
+		skill.body === void 0 ? void 0 : `<body>\n${escapeXml(skill.body)}\n</body>`,
+		directory === void 0 ? void 0 : `<directory>${escapeXml(directory)}</directory>`,
+		skill.location === void 0 ? void 0 : `<location>${escapeXml(skill.location)}</location>`,
+		skill.resources?.length ? `<resource_path_note>Resource file paths are relative to the skill itself.</resource_path_note>` : void 0,
+		skill.resources?.length ? `<skill_resources>\n${skill.resources.map(renderSkillResourceXml).join("\n")}\n</skill_resources>` : void 0
+	].filter((section) => section !== void 0);
+	return `<skill_content name="${escapeXml(skill.name)}">\n${sections.join("\n")}\n</skill_content>`;
+};
+const renderPiSkillInvocationContext = (skill, options = {}) => {
+	const skillInvocationXml = renderPiSkillActivationXml(skill);
+	if (!options.extraUserInstructions) return skillInvocationXml;
+	return `${skillInvocationXml}\n\n${options.extraUserInstructions}`;
+};
+const findSkill = (skills, name) => {
+	if (isPiSkillDefinitionArray(skills)) return skills.find((skill) => skill.name === name);
+	return skills[name];
+};
+const skillActivationParameters = Type.Object({ name: Type.String() });
+const createPiSkillActivationTool = (skills, options = {}) => ({
+	name: options.name ?? "activate_skill",
+	label: options.label ?? "Activate skill",
+	description: options.description ?? "Load the full instructions for a registered Pi skill by name.",
+	parameters: skillActivationParameters,
+	async execute(_toolCallId, params) {
+		const skill = findSkill(skills, params.name);
+		if (!skill) return {
+			content: [{
+				type: "text",
+				text: `Skill '${params.name}' was not found.`
+			}],
+			details: {
+				found: false,
+				name: params.name
+			},
+			isError: true
+		};
+		return {
+			content: [{
+				type: "text",
+				text: renderPiSkillActivationXml(skill)
+			}],
+			details: {
+				found: true,
+				name: skill.name,
+				resourceCount: skill.resources?.length ?? 0
+			}
+		};
+	}
+});
+var PiSkillDefinitionBuilder = class {
+	#name;
+	#description;
+	#body;
+	#location;
+	#directory;
+	#resources = [];
+	#metadata;
+	constructor(name) {
+		this.#name = name;
+	}
+	description(description) {
+		this.#description = description;
+		return this;
+	}
+	body(body) {
+		this.#body = body;
+		return this;
+	}
+	location(location) {
+		this.#location = location;
+		return this;
+	}
+	directory(directory) {
+		this.#directory = directory;
+		return this;
+	}
+	resource(path, resource = {}) {
+		this.#resources.push({
+			...resource,
+			path
+		});
+		return this;
+	}
+	resources(resources) {
+		this.#resources = [...resources];
+		return this;
+	}
+	metadata(metadata) {
+		this.#metadata = { ...metadata };
+		return this;
+	}
+	metadataValue(key, value) {
+		this.#metadata = {
+			...this.#metadata,
+			[key]: value
+		};
+		return this;
+	}
+	build() {
+		if (!this.#description) throw new Error(`Skill '${this.#name}' must define a description.`);
+		return {
+			name: this.#name,
+			description: this.#description,
+			...this.#body === void 0 ? {} : { body: this.#body },
+			...this.#location === void 0 ? {} : { location: this.#location },
+			...this.#directory === void 0 ? {} : { directory: this.#directory },
+			...this.#resources.length === 0 ? {} : { resources: [...this.#resources] },
+			...this.#metadata === void 0 ? {} : { metadata: { ...this.#metadata } }
+		};
+	}
+};
+//#endregion
+export { PiSkillDefinitionBuilder, createPiSkillActivationTool, renderPiSkillCatalogXml, renderPiSkillInvocationContext };
+
+//# sourceMappingURL=skills.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","names":["#name","#description","#body","#location","#directory","#resources","#metadata"],"sources":["../../../src/pi/skills.ts"],"sourcesContent":["import { Type } from \"typebox\";\n\nimport type { PiToolDefinition } from \"./types\";\n\nexport type PiSkillResource = {\n  path: string;\n  description?: string;\n  content?: string;\n  mimeType?: string;\n  metadata?: Record<string, unknown>;\n};\n\nexport type PiSkillDefinition = {\n  name: string;\n  description: string;\n  body?: string;\n  location?: string;\n  directory?: string;\n  resources?: readonly PiSkillResource[];\n  metadata?: Record<string, unknown>;\n};\n\nexport type PiSkillDefinitionInput = Omit<PiSkillDefinition, \"name\"> & {\n  name?: string;\n};\n\nexport type PiSkillRegistry = Record<string, PiSkillDefinition>;\n\nexport type PiAgentSkillSelection = readonly string[] | \"all\";\n\nexport type PiSkillResolverContext = {\n  workflowName: string;\n  sessionId: string;\n  turnId: string;\n};\n\nexport type PiSkillRegistryResolver = (\n  context: PiSkillResolverContext,\n) => PiSkillRegistry | Promise<PiSkillRegistry>;\n\nexport type PiSkillRegistrySource = PiSkillRegistry | PiSkillRegistryResolver;\n\nexport type PiSkillCatalogXmlInput = PiSkillRegistry | readonly PiSkillDefinition[];\n\nexport type PiSkillActivationDetails =\n  | {\n      found: true;\n      name: string;\n      resourceCount: number;\n    }\n  | {\n      found: false;\n      name: string;\n    };\n\nexport type CreatePiSkillActivationToolOptions = {\n  name?: string;\n  label?: string;\n  description?: string;\n};\n\nexport type PiSkillInvocationContextOptions = {\n  extraUserInstructions?: string;\n};\n\nconst escapeXml = (value: string) =>\n  value\n    .replaceAll(\"&\", \"&amp;\")\n    .replaceAll(\"<\", \"&lt;\")\n    .replaceAll(\">\", \"&gt;\")\n    .replaceAll('\"', \"&quot;\")\n    .replaceAll(\"'\", \"&apos;\");\n\nconst isPiSkillDefinitionArray = (\n  skills: PiSkillCatalogXmlInput,\n): skills is readonly PiSkillDefinition[] => Array.isArray(skills);\n\nconst skillCatalogEntries = (skills: PiSkillCatalogXmlInput) =>\n  (isPiSkillDefinitionArray(skills) ? skills : Object.values(skills)).toSorted((left, right) =>\n    left.name.localeCompare(right.name),\n  );\n\nexport const renderPiSkillCatalogXml = (skills: PiSkillCatalogXmlInput): string => {\n  const entries = skillCatalogEntries(skills);\n  if (entries.length === 0) {\n    return \"\";\n  }\n\n  const skillXml = entries\n    .map(\n      (skill) => `  <skill>\n    <name>${escapeXml(skill.name)}</name>\n    <description>${escapeXml(skill.description)}</description>\n  </skill>`,\n    )\n    .join(\"\\n\");\n\n  return `<available_skills>\n${skillXml}\n</available_skills>`;\n};\n\nconst renderSkillResourceXml = (resource: PiSkillResource) => {\n  const fields = [\n    `      <path>${escapeXml(resource.path)}</path>`,\n    resource.description === undefined\n      ? undefined\n      : `      <description>${escapeXml(resource.description)}</description>`,\n    resource.mimeType === undefined\n      ? undefined\n      : `      <mimeType>${escapeXml(resource.mimeType)}</mimeType>`,\n  ].filter((field): field is string => field !== undefined);\n\n  return `    <file>\\n${fields.join(\"\\n\")}\\n    </file>`;\n};\n\nconst inferSkillDirectory = (skill: PiSkillDefinition) => {\n  if (skill.directory !== undefined) {\n    return skill.directory;\n  }\n  if (skill.location === undefined) {\n    return undefined;\n  }\n\n  const normalizedLocation = skill.location.replaceAll(\"\\\\\", \"/\");\n  const lastSlash = normalizedLocation.lastIndexOf(\"/\");\n  if (lastSlash === -1) {\n    return undefined;\n  }\n  return normalizedLocation.slice(0, lastSlash);\n};\n\nconst renderPiSkillActivationXml = (skill: PiSkillDefinition): string => {\n  const directory = inferSkillDirectory(skill);\n  const sections = [\n    `<name>${escapeXml(skill.name)}</name>`,\n    `<description>${escapeXml(skill.description)}</description>`,\n    skill.body === undefined ? undefined : `<body>\\n${escapeXml(skill.body)}\\n</body>`,\n    directory === undefined ? undefined : `<directory>${escapeXml(directory)}</directory>`,\n    skill.location === undefined ? undefined : `<location>${escapeXml(skill.location)}</location>`,\n    skill.resources?.length\n      ? `<resource_path_note>Resource file paths are relative to the skill itself.</resource_path_note>`\n      : undefined,\n    skill.resources?.length\n      ? `<skill_resources>\\n${skill.resources.map(renderSkillResourceXml).join(\"\\n\")}\\n</skill_resources>`\n      : undefined,\n  ].filter((section): section is string => section !== undefined);\n\n  return `<skill_content name=\"${escapeXml(skill.name)}\">\\n${sections.join(\"\\n\")}\\n</skill_content>`;\n};\n\nexport const renderPiSkillInvocationContext = (\n  skill: PiSkillDefinition,\n  options: PiSkillInvocationContextOptions = {},\n): string => {\n  const skillInvocationXml = renderPiSkillActivationXml(skill);\n  if (!options.extraUserInstructions) {\n    return skillInvocationXml;\n  }\n\n  return `${skillInvocationXml}\\n\\n${options.extraUserInstructions}`;\n};\n\nconst findSkill = (skills: PiSkillCatalogXmlInput, name: string) => {\n  if (isPiSkillDefinitionArray(skills)) {\n    return skills.find((skill) => skill.name === name);\n  }\n  return skills[name];\n};\n\nconst skillActivationParameters = Type.Object({ name: Type.String() });\n\nexport const createPiSkillActivationTool = (\n  skills: PiSkillCatalogXmlInput,\n  options: CreatePiSkillActivationToolOptions = {},\n): PiToolDefinition<typeof skillActivationParameters, PiSkillActivationDetails> => ({\n  name: options.name ?? \"activate_skill\",\n  label: options.label ?? \"Activate skill\",\n  description:\n    options.description ?? \"Load the full instructions for a registered Pi skill by name.\",\n  parameters: skillActivationParameters,\n  async execute(_toolCallId, params) {\n    const skill = findSkill(skills, params.name);\n    if (!skill) {\n      return {\n        content: [{ type: \"text\", text: `Skill '${params.name}' was not found.` }],\n        details: { found: false, name: params.name },\n        isError: true,\n      };\n    }\n\n    return {\n      content: [{ type: \"text\", text: renderPiSkillActivationXml(skill) }],\n      details: {\n        found: true,\n        name: skill.name,\n        resourceCount: skill.resources?.length ?? 0,\n      },\n    };\n  },\n});\n\nexport class PiSkillDefinitionBuilder<TName extends string = string> {\n  readonly #name: TName;\n  #description: string | undefined;\n  #body: string | undefined;\n  #location: string | undefined;\n  #directory: string | undefined;\n  #resources: PiSkillResource[] = [];\n  #metadata: Record<string, unknown> | undefined;\n\n  constructor(name: TName) {\n    this.#name = name;\n  }\n\n  description(description: string): this {\n    this.#description = description;\n    return this;\n  }\n\n  body(body: string): this {\n    this.#body = body;\n    return this;\n  }\n\n  location(location: string): this {\n    this.#location = location;\n    return this;\n  }\n\n  directory(directory: string): this {\n    this.#directory = directory;\n    return this;\n  }\n\n  resource(path: string, resource: Omit<PiSkillResource, \"path\"> = {}): this {\n    this.#resources.push({ ...resource, path });\n    return this;\n  }\n\n  resources(resources: readonly PiSkillResource[]): this {\n    this.#resources = [...resources];\n    return this;\n  }\n\n  metadata(metadata: Record<string, unknown>): this {\n    this.#metadata = { ...metadata };\n    return this;\n  }\n\n  metadataValue(key: string, value: unknown): this {\n    this.#metadata = { ...this.#metadata, [key]: value };\n    return this;\n  }\n\n  build(): PiSkillDefinition {\n    if (!this.#description) {\n      throw new Error(`Skill '${this.#name}' must define a description.`);\n    }\n\n    return {\n      name: this.#name,\n      description: this.#description,\n      ...(this.#body === undefined ? {} : { body: this.#body }),\n      ...(this.#location === undefined ? {} : { location: this.#location }),\n      ...(this.#directory === undefined ? {} : { directory: this.#directory }),\n      ...(this.#resources.length === 0 ? {} : { resources: [...this.#resources] }),\n      ...(this.#metadata === undefined ? {} : { metadata: { ...this.#metadata } }),\n    };\n  }\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,12 @@
+import { AnyPiToolDefinition, PiToolDefinition, PiToolDetailsFromResultSchema, PiToolResultSchema } from "./types.js";
+import { TSchema } from "typebox";
+//#region src/pi/tools.d.ts
+declare function definePiTool<TParameters extends TSchema, TResultSchema extends PiToolResultSchema<unknown>>(tool: PiToolDefinition<TParameters, PiToolDetailsFromResultSchema<TResultSchema>, TResultSchema> & {
+  resultSchema: TResultSchema;
+}): PiToolDefinition<TParameters, PiToolDetailsFromResultSchema<TResultSchema>, TResultSchema>;
+declare function definePiTool<TParameters extends TSchema, TDetails>(tool: PiToolDefinition<TParameters, TDetails> & {
+  resultSchema?: undefined;
+}): PiToolDefinition<TParameters, TDetails>;
+//#endregion
+export { type AnyPiToolDefinition, type PiToolDefinition, type PiToolDetailsFromResultSchema, type PiToolResultSchema, definePiTool };
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","names":[],"sources":["../../../src/pi/tools.ts"],"mappings":";;;iBASgB,aACd,oBAAoB,SACpB,sBAAsB,6BAEtB,MAAM,iBACJ,aACA,8BAA8B,gBAC9B;EAEA,cAAc;IAEf,iBAAiB,aAAa,8BAA8B,gBAAgB;iBAC/D,aAAa,oBAAoB,SAAe,UAC9D,MAAM,iBAAiB,aAAa;EAAc;IACjD,iBAAiB,aAAa"}

package/dist/node/pi/tools.js

@@ -0,0 +1,8 @@
+//#region src/pi/tools.ts
+function definePiTool(tool) {
+	return tool;
+}
+//#endregion
+export { definePiTool };
+
+//# sourceMappingURL=tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","names":[],"sources":["../../../src/pi/tools.ts"],"sourcesContent":["import type { TSchema as TypeBoxSchema } from \"typebox\";\n\nimport type {\n  AnyPiToolDefinition,\n  PiToolDefinition,\n  PiToolDetailsFromResultSchema,\n  PiToolResultSchema,\n} from \"./types\";\n\nexport function definePiTool<\n  TParameters extends TypeBoxSchema,\n  TResultSchema extends PiToolResultSchema<unknown>,\n>(\n  tool: PiToolDefinition<\n    TParameters,\n    PiToolDetailsFromResultSchema<TResultSchema>,\n    TResultSchema\n  > & {\n    resultSchema: TResultSchema;\n  },\n): PiToolDefinition<TParameters, PiToolDetailsFromResultSchema<TResultSchema>, TResultSchema>;\nexport function definePiTool<TParameters extends TypeBoxSchema, TDetails>(\n  tool: PiToolDefinition<TParameters, TDetails> & { resultSchema?: undefined },\n): PiToolDefinition<TParameters, TDetails>;\nexport function definePiTool(tool: AnyPiToolDefinition): AnyPiToolDefinition {\n  return tool;\n}\n\nexport type {\n  AnyPiToolDefinition,\n  PiToolDefinition,\n  PiToolDetailsFromResultSchema,\n  PiToolResultSchema,\n} from \"./types\";\n"],"mappings":";AAwBA,SAAgB,aAAa,MAAgD;CAC3E,OAAO;AACT"}

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

@@ -0,0 +1,165 @@
+import { PiHarnessFrontendAgentMessage } from "./harness/agent-harness-event-protocol.js";
+import { PiHarnessOperation } from "./workflows/workflow-agent-harness.js";
+import { HookContext } from "@fragno-dev/db";
+import { AgentTool, AgentToolResult } from "@earendil-works/pi-agent-core";
+import { InstanceStatus, WorkflowRegistryEntry } from "@fragno-dev/workflows/workflow";
+import { Static, TSchema } from "typebox";
+import { AssistantMessage } from "@earendil-works/pi-ai";
+import { StandardSchemaV1 } from "@fragno-dev/core/api";
+//#region src/pi/types.d.ts
+type PiLoggerConfig = {
+  enabled?: boolean;
+  level?: "off" | "error" | "warn" | "info" | "debug";
+};
+type PiWorkflowStatus = InstanceStatus["status"];
+type PiSessionMetadata = Record<string, unknown>;
+type PiSession = {
+  id: string;
+  name: string | null;
+  metadata: PiSessionMetadata | null;
+  workflowName: string;
+  createdAt: Date;
+  updatedAt: Date;
+};
+declare class PiSessionDataUnavailableError extends Error {
+  readonly workflowName: string;
+  readonly sessionId: string;
+  readonly code = "PI_SESSION_DATA_UNAVAILABLE";
+  constructor(workflowName: string, sessionId: string);
+}
+declare class PiSessionDataIntegrityError extends Error {
+  readonly workflowName: string;
+  readonly sessionId: string;
+  readonly code = "PI_SESSION_DATA_INTEGRITY_ERROR";
+  constructor(workflowName: string, sessionId: string, cause: unknown);
+}
+declare const projectPiSessionFromWorkflowInstance: (instance: {
+  id: string;
+  workflowName: string;
+  params: unknown;
+  createdAt: Date;
+  updatedAt: Date;
+}) => PiSession | null;
+type PiOperationDetails = {
+  actor: unknown;
+  workflowName: string;
+  sessionId: string;
+  metadata: PiSessionMetadata | null;
+  stepName: string;
+  operationId: string;
+  operation: PiHarnessOperation["kind"];
+};
+type PiOperationCompletedHookPayload = PiOperationDetails & {
+  /**
+   * Model calls exposed by Pi as assistant messages during this operation.
+   *
+   * Compact operations and tree navigation with summarization are not included yet because Pi
+   * does not expose their internal model calls as first-class harness events.
+   */
+  modelCalls: Array<Pick<AssistantMessage, "api" | "provider" | "model" | "responseModel" | "responseId" | "usage" | "stopReason" | "timestamp">>;
+  usage: AssistantMessage["usage"];
+};
+/** Maximum total Base64 characters persisted in one Pi command event. */
+declare const MAX_PI_COMMAND_IMAGE_DATA_LENGTH: number;
+declare const PI_SESSION_COMMAND_STEP_PREFIX = "command:";
+type PiPromptInput = {
+  text: string;
+  images?: Array<{
+    type: "image";
+    data: string;
+    mimeType: string;
+  }>;
+};
+type PiCompactCommandOutcome = {
+  kind: "compact";
+  commandId: string;
+  status: "succeeded";
+} | {
+  kind: "compact";
+  commandId: string;
+  status: "rejected";
+  code: "nothing_to_compact" | "compaction_failed";
+  message: string;
+};
+type PiSessionCommandPayload = {
+  commandId: string;
+  kind: "prompt";
+  input: PiPromptInput;
+} | {
+  commandId: string;
+  kind: "skill";
+  input: {
+    name: string;
+    additionalInstructions?: string;
+  };
+} | {
+  commandId: string;
+  kind: "promptFromTemplate";
+  input: {
+    name: string;
+    args?: string[];
+  };
+} | {
+  commandId: string;
+  kind: "compact";
+  input: {
+    customInstructions?: string;
+  };
+} | {
+  commandId: string;
+  kind: "abort";
+  reason?: string;
+} | {
+  commandId: string;
+  kind: "steer";
+  input: PiPromptInput;
+} | {
+  commandId: string;
+  kind: "followUp";
+  input: PiPromptInput;
+};
+type PiAgentStateSnapshot = {
+  messages: PiHarnessFrontendAgentMessage[];
+};
+type PiSessionDetail = PiSession & {
+  workflow: {
+    status: PiWorkflowStatus;
+    error?: {
+      name: string;
+      message: string;
+    };
+    output?: unknown;
+  };
+  agent: {
+    state: PiAgentStateSnapshot;
+  };
+};
+type PiToolResultSchema<TDetails> = StandardSchemaV1<unknown, TDetails> | TSchema;
+type PiToolDetailsFromResultSchema<TResultSchema> = TResultSchema extends StandardSchemaV1<unknown, infer TDetails> ? TDetails : TResultSchema extends TSchema ? Static<TResultSchema> : unknown;
+type PiToolDefinition<TParameters extends TSchema = TSchema, TDetails = unknown, TResultSchema extends PiToolResultSchema<TDetails> | undefined = PiToolResultSchema<TDetails> | undefined> = AgentTool<TParameters, TDetails> & {
+  name: string;
+  resultSchema?: TResultSchema;
+  handoff?: boolean;
+};
+type AnyPiToolDefinition = Omit<AgentTool<TSchema, unknown>, "execute"> & {
+  name: string;
+  resultSchema?: PiToolResultSchema<unknown>;
+  handoff?: boolean;
+  execute: (toolCallId: string, params: any, signal?: AbortSignal, onUpdate?: (partialResult: AgentToolResult<any>) => void) => Promise<AgentToolResult<any>>;
+};
+interface PiFragmentConfig {
+  workflows?: WorkflowRegistryEntry[];
+  /**
+   * Called through a durable hook after a harness operation commits a terminal outcome.
+   *
+   * Usage reporting currently excludes compact operations and tree navigation with summarization.
+   */
+  onOperationCompleted?: (payload: PiOperationCompletedHookPayload, context: HookContext) => Promise<void> | void;
+  /**
+   * Optional logging config for internal pi-harness diagnostics.
+   */
+  logging?: PiLoggerConfig;
+}
+//#endregion
+export { AnyPiToolDefinition, MAX_PI_COMMAND_IMAGE_DATA_LENGTH, PI_SESSION_COMMAND_STEP_PREFIX, PiAgentStateSnapshot, PiCompactCommandOutcome, PiFragmentConfig, PiLoggerConfig, PiOperationCompletedHookPayload, PiOperationDetails, PiPromptInput, PiSession, PiSessionCommandPayload, PiSessionDataIntegrityError, PiSessionDataUnavailableError, PiSessionDetail, PiSessionMetadata, PiToolDefinition, PiToolDetailsFromResultSchema, PiToolResultSchema, PiWorkflowStatus, projectPiSessionFromWorkflowInstance };
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/pi/types.ts"],"mappings":";;;;;;;;;KAaY;EACV;EACA;;KAGU,mBAAmB;KAEnB,oBAAoB;KAEpB;EACV;EACA;EACA,UAAU;EACV;EACA,WAAW;EACX,WAAW;;cAUA,sCAAsC;WAItC;WACA;WAJF;cAGE,sBACA;;cAOA,oCAAoC;WAIpC;WACA;WAJF;cAGE,sBACA,mBACT;;cAOS,uCAAwC;EACnD;EACA;EACA;EACA,WAAW;EACX,WAAW;MACT;KA0BQ;EACV;EACA;EACA;EACA,UAAU;EACV;EACA;EACA,WAAW;;KAGD,kCAAkC;;;;;;;EAO5C,YAAY,MACV,KACE;EAWJ,OAAO;;;cAII;cAEA;KAED;EACV;EACA,SAAS;IAAQ;IAAe;IAAc;;;KAGpC;EAEN;EACA;EACA;;EAGA;EACA;EACA;EACA;EACA;;KAGM;EACN;EAAmB;EAAgB,OAAO;;EAC1C;EAAmB;EAAe;IAAS;IAAc;;;EACzD;EAAmB;EAA4B;IAAS;IAAc;;;EACtE;EAAmB;EAAiB;IAAS;;;EAC7C;EAAmB;EAAe;;EAClC;EAAmB;EAAe,OAAO;;EACzC;EAAmB;EAAkB,OAAO;;KAEtC;EACV,UAAU;;KAGA,kBAAkB;EAC5B;IACE,QAAQ;IACR;MAAU;MAAc;;IACxB;;EAEF;IACE,OAAO;;;KAIC,mBAAmB,YAAY,0BAA0B,YAAY;KAErE,8BAA8B,iBACxC,sBAAsB,gCAAgC,YAClD,WACA,sBAAsB,UACpB,OAAO;KAGH,iBACV,oBAAoB,UAAgB,SACpC,oBACA,sBAAsB,mBAAmB,wBACrC,mBAAmB,yBAErB,UAAU,aAAa;EACzB;EACA,eAAe;EACf;;KAGU,sBAAsB,KAAK,UAAU;EAC/C;EACA,eAAe;EACf;EACA,UACE,oBAEA,aACA,SAAS,aAET,YAAY,eAAe,kCAExB,QAAQ;;UAGE;EACf,YAAY;;;;;;EAMZ,wBACE,SAAS,iCACT,SAAS,gBACN;;;;EAIL,UAAU"}

package/dist/node/pi/types.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+//#region src/pi/types.ts
+const piSessionWorkflowParamsSchema = z.object({
+	metadata: z.record(z.string(), z.unknown()).optional(),
+	__piSession: z.object({ name: z.string().nullable() })
+});
+var PiSessionDataUnavailableError = class extends Error {
+	workflowName;
+	sessionId;
+	code = "PI_SESSION_DATA_UNAVAILABLE";
+	constructor(workflowName, sessionId) {
+		super(`Workflow ${workflowName}/${sessionId} does not contain Pi session data.`);
+		this.workflowName = workflowName;
+		this.sessionId = sessionId;
+		this.name = "PiSessionDataUnavailableError";
+	}
+};
+var PiSessionDataIntegrityError = class extends Error {
+	workflowName;
+	sessionId;
+	code = "PI_SESSION_DATA_INTEGRITY_ERROR";
+	constructor(workflowName, sessionId, cause) {
+		super(`Persisted Pi session data for ${workflowName}/${sessionId} is invalid.`, { cause });
+		this.workflowName = workflowName;
+		this.sessionId = sessionId;
+		this.name = "PiSessionDataIntegrityError";
+	}
+};
+const projectPiSessionFromWorkflowInstance = (instance) => {
+	const persistedParams = instance.params;
+	if (typeof persistedParams !== "object" || persistedParams === null || Array.isArray(persistedParams) || !Object.hasOwn(persistedParams, "__piSession")) return null;
+	const params = piSessionWorkflowParamsSchema.safeParse(persistedParams);
+	if (!params.success) throw new PiSessionDataIntegrityError(instance.workflowName, instance.id, params.error);
+	return {
+		id: instance.id,
+		name: params.data.__piSession.name,
+		metadata: params.data.metadata ?? null,
+		workflowName: instance.workflowName,
+		createdAt: instance.createdAt,
+		updatedAt: instance.updatedAt
+	};
+};
+/** Maximum total Base64 characters persisted in one Pi command event. */
+const MAX_PI_COMMAND_IMAGE_DATA_LENGTH = 8 * 1024 * 1024;
+const PI_SESSION_COMMAND_STEP_PREFIX = "command:";
+//#endregion
+export { MAX_PI_COMMAND_IMAGE_DATA_LENGTH, PI_SESSION_COMMAND_STEP_PREFIX, PiSessionDataIntegrityError, PiSessionDataUnavailableError, projectPiSessionFromWorkflowInstance };
+
+//# 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 { StandardSchemaV1 } from \"@fragno-dev/core/api\";\nimport type { InstanceStatus, WorkflowRegistryEntry } from \"@fragno-dev/workflows/workflow\";\nimport type { Static, TSchema as TypeBoxSchema } from \"typebox\";\nimport { z } from \"zod\";\n\nimport type { HookContext } from \"@fragno-dev/db\";\n\nimport type { AgentTool, AgentToolResult } from \"@earendil-works/pi-agent-core\";\nimport type { AssistantMessage } from \"@earendil-works/pi-ai\";\n\nimport type { PiHarnessFrontendAgentMessage } from \"./harness/agent-harness-event-protocol\";\nimport type { PiHarnessOperation } from \"./workflows/workflow-agent-harness\";\n\nexport type PiLoggerConfig = {\n  enabled?: boolean;\n  level?: \"off\" | \"error\" | \"warn\" | \"info\" | \"debug\";\n};\n\nexport type PiWorkflowStatus = InstanceStatus[\"status\"];\n\nexport type PiSessionMetadata = Record<string, unknown>;\n\nexport type PiSession = {\n  id: string;\n  name: string | null;\n  metadata: PiSessionMetadata | null;\n  workflowName: string;\n  createdAt: Date;\n  updatedAt: Date;\n};\n\nconst piSessionWorkflowParamsSchema = z.object({\n  metadata: z.record(z.string(), z.unknown()).optional(),\n  __piSession: z.object({\n    name: z.string().nullable(),\n  }),\n});\n\nexport class PiSessionDataUnavailableError extends Error {\n  readonly code = \"PI_SESSION_DATA_UNAVAILABLE\";\n\n  constructor(\n    readonly workflowName: string,\n    readonly sessionId: string,\n  ) {\n    super(`Workflow ${workflowName}/${sessionId} does not contain Pi session data.`);\n    this.name = \"PiSessionDataUnavailableError\";\n  }\n}\n\nexport class PiSessionDataIntegrityError extends Error {\n  readonly code = \"PI_SESSION_DATA_INTEGRITY_ERROR\";\n\n  constructor(\n    readonly workflowName: string,\n    readonly sessionId: string,\n    cause: unknown,\n  ) {\n    super(`Persisted Pi session data for ${workflowName}/${sessionId} is invalid.`, { cause });\n    this.name = \"PiSessionDataIntegrityError\";\n  }\n}\n\nexport const projectPiSessionFromWorkflowInstance = (instance: {\n  id: string;\n  workflowName: string;\n  params: unknown;\n  createdAt: Date;\n  updatedAt: Date;\n}): PiSession | null => {\n  const persistedParams = instance.params;\n  if (\n    typeof persistedParams !== \"object\" ||\n    persistedParams === null ||\n    Array.isArray(persistedParams) ||\n    !Object.hasOwn(persistedParams, \"__piSession\")\n  ) {\n    return null;\n  }\n\n  const params = piSessionWorkflowParamsSchema.safeParse(persistedParams);\n  if (!params.success) {\n    throw new PiSessionDataIntegrityError(instance.workflowName, instance.id, params.error);\n  }\n\n  return {\n    id: instance.id,\n    name: params.data.__piSession.name,\n    metadata: params.data.metadata ?? null,\n    workflowName: instance.workflowName,\n    createdAt: instance.createdAt,\n    updatedAt: instance.updatedAt,\n  };\n};\n\nexport type PiOperationDetails = {\n  actor: unknown;\n  workflowName: string;\n  sessionId: string;\n  metadata: PiSessionMetadata | null;\n  stepName: string;\n  operationId: string;\n  operation: PiHarnessOperation[\"kind\"];\n};\n\nexport type PiOperationCompletedHookPayload = PiOperationDetails & {\n  /**\n   * Model calls exposed by Pi as assistant messages during this operation.\n   *\n   * Compact operations and tree navigation with summarization are not included yet because Pi\n   * does not expose their internal model calls as first-class harness events.\n   */\n  modelCalls: Array<\n    Pick<\n      AssistantMessage,\n      | \"api\"\n      | \"provider\"\n      | \"model\"\n      | \"responseModel\"\n      | \"responseId\"\n      | \"usage\"\n      | \"stopReason\"\n      | \"timestamp\"\n    >\n  >;\n  usage: AssistantMessage[\"usage\"];\n};\n\n/** Maximum total Base64 characters persisted in one Pi command event. */\nexport const MAX_PI_COMMAND_IMAGE_DATA_LENGTH = 8 * 1024 * 1024;\n\nexport const PI_SESSION_COMMAND_STEP_PREFIX = \"command:\";\n\nexport type PiPromptInput = {\n  text: string;\n  images?: Array<{ type: \"image\"; data: string; mimeType: string }>;\n};\n\nexport type PiCompactCommandOutcome =\n  | {\n      kind: \"compact\";\n      commandId: string;\n      status: \"succeeded\";\n    }\n  | {\n      kind: \"compact\";\n      commandId: string;\n      status: \"rejected\";\n      code: \"nothing_to_compact\" | \"compaction_failed\";\n      message: string;\n    };\n\nexport type PiSessionCommandPayload =\n  | { commandId: string; kind: \"prompt\"; input: PiPromptInput }\n  | { commandId: string; kind: \"skill\"; input: { name: string; additionalInstructions?: string } }\n  | { commandId: string; kind: \"promptFromTemplate\"; input: { name: string; args?: string[] } }\n  | { commandId: string; kind: \"compact\"; input: { customInstructions?: string } }\n  | { commandId: string; kind: \"abort\"; reason?: string }\n  | { commandId: string; kind: \"steer\"; input: PiPromptInput }\n  | { commandId: string; kind: \"followUp\"; input: PiPromptInput };\n\nexport type PiAgentStateSnapshot = {\n  messages: PiHarnessFrontendAgentMessage[];\n};\n\nexport type PiSessionDetail = PiSession & {\n  workflow: {\n    status: PiWorkflowStatus;\n    error?: { name: string; message: string };\n    output?: unknown;\n  };\n  agent: {\n    state: PiAgentStateSnapshot;\n  };\n};\n\nexport type PiToolResultSchema<TDetails> = StandardSchemaV1<unknown, TDetails> | TypeBoxSchema;\n\nexport type PiToolDetailsFromResultSchema<TResultSchema> =\n  TResultSchema extends StandardSchemaV1<unknown, infer TDetails>\n    ? TDetails\n    : TResultSchema extends TypeBoxSchema\n      ? Static<TResultSchema>\n      : unknown;\n\nexport type PiToolDefinition<\n  TParameters extends TypeBoxSchema = TypeBoxSchema,\n  TDetails = unknown,\n  TResultSchema extends PiToolResultSchema<TDetails> | undefined =\n    | PiToolResultSchema<TDetails>\n    | undefined,\n> = AgentTool<TParameters, TDetails> & {\n  name: string;\n  resultSchema?: TResultSchema;\n  handoff?: boolean;\n};\n\nexport type AnyPiToolDefinition = Omit<AgentTool<TypeBoxSchema, unknown>, \"execute\"> & {\n  name: string;\n  resultSchema?: PiToolResultSchema<unknown>;\n  handoff?: boolean;\n  execute: (\n    toolCallId: string,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    params: any,\n    signal?: AbortSignal,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    onUpdate?: (partialResult: AgentToolResult<any>) => void,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ) => Promise<AgentToolResult<any>>;\n};\n\nexport interface PiFragmentConfig {\n  workflows?: WorkflowRegistryEntry[];\n  /**\n   * Called through a durable hook after a harness operation commits a terminal outcome.\n   *\n   * Usage reporting currently excludes compact operations and tree navigation with summarization.\n   */\n  onOperationCompleted?: (\n    payload: PiOperationCompletedHookPayload,\n    context: HookContext,\n  ) => Promise<void> | void;\n  /**\n   * Optional logging config for internal pi-harness diagnostics.\n   */\n  logging?: PiLoggerConfig;\n}\n"],"mappings":";;AA+BA,MAAM,gCAAgC,EAAE,OAAO;CAC7C,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS;CACrD,aAAa,EAAE,OAAO,EACpB,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS,EAC5B,CAAC;AACH,CAAC;AAED,IAAa,gCAAb,cAAmD,MAAM;CAI5C;CACA;CAJX,OAAgB;CAEhB,YACE,cACA,WACA;EACA,MAAM,YAAY,aAAa,GAAG,UAAU,mCAAmC;EAHtE,KAAA,eAAA;EACA,KAAA,YAAA;EAGT,KAAK,OAAO;CACd;AACF;AAEA,IAAa,8BAAb,cAAiD,MAAM;CAI1C;CACA;CAJX,OAAgB;CAEhB,YACE,cACA,WACA,OACA;EACA,MAAM,iCAAiC,aAAa,GAAG,UAAU,eAAe,EAAE,MAAM,CAAC;EAJhF,KAAA,eAAA;EACA,KAAA,YAAA;EAIT,KAAK,OAAO;CACd;AACF;AAEA,MAAa,wCAAwC,aAM7B;CACtB,MAAM,kBAAkB,SAAS;CACjC,IACE,OAAO,oBAAoB,YAC3B,oBAAoB,QACpB,MAAM,QAAQ,eAAe,KAC7B,CAAC,OAAO,OAAO,iBAAiB,aAAa,GAE7C,OAAO;CAGT,MAAM,SAAS,8BAA8B,UAAU,eAAe;CACtE,IAAI,CAAC,OAAO,SACV,MAAM,IAAI,4BAA4B,SAAS,cAAc,SAAS,IAAI,OAAO,KAAK;CAGxF,OAAO;EACL,IAAI,SAAS;EACb,MAAM,OAAO,KAAK,YAAY;EAC9B,UAAU,OAAO,KAAK,YAAY;EAClC,cAAc,SAAS;EACvB,WAAW,SAAS;EACpB,WAAW,SAAS;CACtB;AACF;;AAoCA,MAAa,mCAAmC,IAAI,OAAO;AAE3D,MAAa,iCAAiC"}

package/dist/node/pi/wait-for-command-step.js

@@ -0,0 +1,46 @@
+import { PI_SESSION_COMMAND_STEP_PREFIX } from "./types.js";
+import { buildStepKey } from "@fragno-dev/workflows/step-identity";
+//#region src/pi/wait-for-command-step.ts
+const COMMAND_STEP_POLL_INTERVAL_MS = 100;
+var CommandStepWaitTimeoutError = class extends Error {
+	constructor(workflowName, instanceId, commandId) {
+		super(`Timed out waiting for command ${commandId} in ${workflowName}/${instanceId}.`);
+		this.name = "CommandStepWaitTimeoutError";
+	}
+};
+var CommandStepFailedError = class extends Error {
+	constructor(commandId, error) {
+		super(`Command ${commandId} failed: ${error.name}: ${error.message}`);
+		this.name = "CommandStepFailedError";
+	}
+};
+var CommandWorkflowTerminatedError = class extends Error {
+	constructor(commandId, status) {
+		super(`Command ${commandId} could not complete: workflow is ${status}.`);
+		this.name = "CommandWorkflowTerminatedError";
+	}
+};
+async function waitForCommandStep(options) {
+	const { handlerTx, workflows, workflowName, instanceId, commandId } = options;
+	const stepKey = buildStepKey("do", `${PI_SESSION_COMMAND_STEP_PREFIX}${commandId}`);
+	const deadline = Date.now() + options.timeoutMs;
+	while (true) {
+		const outcome = await handlerTx().withServiceCalls(() => [workflows.getStepOutcome(workflowName, instanceId, stepKey)]).transform(({ serviceResult: [result] }) => result).execute();
+		switch (outcome.status) {
+			case "completed": return;
+			case "errored": throw new CommandStepFailedError(commandId, outcome.error);
+			case "instance-terminal": throw new CommandWorkflowTerminatedError(commandId, outcome.instanceStatus);
+			case "not-started":
+			case "waiting": break;
+		}
+		const remainingMs = deadline - Date.now();
+		if (remainingMs <= 0) throw new CommandStepWaitTimeoutError(workflowName, instanceId, commandId);
+		await new Promise((resolve) => {
+			setTimeout(resolve, Math.min(COMMAND_STEP_POLL_INTERVAL_MS, remainingMs)).unref?.();
+		});
+	}
+}
+//#endregion
+export { CommandStepFailedError, CommandStepWaitTimeoutError, CommandWorkflowTerminatedError, waitForCommandStep };
+
+//# sourceMappingURL=wait-for-command-step.js.map

package/dist/node/pi/wait-for-command-step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for-command-step.js","names":[],"sources":["../../../src/pi/wait-for-command-step.ts"],"sourcesContent":["import { buildStepKey } from \"@fragno-dev/workflows/step-identity\";\n\nimport type { DatabaseHandlerTx } from \"@fragno-dev/db\";\nimport type { WorkflowsFragmentServices } from \"@fragno-dev/workflows\";\n\nimport { PI_SESSION_COMMAND_STEP_PREFIX } from \"./types\";\n\nconst COMMAND_STEP_POLL_INTERVAL_MS = 100;\n\nexport class CommandStepWaitTimeoutError extends Error {\n  constructor(workflowName: string, instanceId: string, commandId: string) {\n    super(`Timed out waiting for command ${commandId} in ${workflowName}/${instanceId}.`);\n    this.name = \"CommandStepWaitTimeoutError\";\n  }\n}\n\nexport class CommandStepFailedError extends Error {\n  constructor(commandId: string, error: { name: string; message: string }) {\n    super(`Command ${commandId} failed: ${error.name}: ${error.message}`);\n    this.name = \"CommandStepFailedError\";\n  }\n}\n\nexport class CommandWorkflowTerminatedError extends Error {\n  constructor(commandId: string, status: string) {\n    super(`Command ${commandId} could not complete: workflow is ${status}.`);\n    this.name = \"CommandWorkflowTerminatedError\";\n  }\n}\n\nexport async function waitForCommandStep(options: {\n  handlerTx: DatabaseHandlerTx;\n  workflows: WorkflowsFragmentServices;\n  workflowName: string;\n  instanceId: string;\n  commandId: string;\n  timeoutMs: number;\n}): Promise<void> {\n  const { handlerTx, workflows, workflowName, instanceId, commandId } = options;\n  const stepKey = buildStepKey(\"do\", `${PI_SESSION_COMMAND_STEP_PREFIX}${commandId}`);\n  const deadline = Date.now() + options.timeoutMs;\n\n  while (true) {\n    const outcome = await handlerTx()\n      .withServiceCalls(\n        () => [workflows.getStepOutcome(workflowName, instanceId, stepKey)] as const,\n      )\n      .transform(({ serviceResult: [result] }) => result)\n      .execute();\n\n    switch (outcome.status) {\n      case \"completed\":\n        return;\n      case \"errored\":\n        throw new CommandStepFailedError(commandId, outcome.error);\n      case \"instance-terminal\":\n        throw new CommandWorkflowTerminatedError(commandId, outcome.instanceStatus);\n      case \"not-started\":\n      case \"waiting\":\n        break;\n    }\n\n    const remainingMs = deadline - Date.now();\n    if (remainingMs <= 0) {\n      throw new CommandStepWaitTimeoutError(workflowName, instanceId, commandId);\n    }\n    await new Promise<void>((resolve) => {\n      const timeout = setTimeout(resolve, Math.min(COMMAND_STEP_POLL_INTERVAL_MS, remainingMs));\n      timeout.unref?.();\n    });\n  }\n}\n"],"mappings":";;;AAOA,MAAM,gCAAgC;AAEtC,IAAa,8BAAb,cAAiD,MAAM;CACrD,YAAY,cAAsB,YAAoB,WAAmB;EACvE,MAAM,iCAAiC,UAAU,MAAM,aAAa,GAAG,WAAW,EAAE;EACpF,KAAK,OAAO;CACd;AACF;AAEA,IAAa,yBAAb,cAA4C,MAAM;CAChD,YAAY,WAAmB,OAA0C;EACvE,MAAM,WAAW,UAAU,WAAW,MAAM,KAAK,IAAI,MAAM,SAAS;EACpE,KAAK,OAAO;CACd;AACF;AAEA,IAAa,iCAAb,cAAoD,MAAM;CACxD,YAAY,WAAmB,QAAgB;EAC7C,MAAM,WAAW,UAAU,mCAAmC,OAAO,EAAE;EACvE,KAAK,OAAO;CACd;AACF;AAEA,eAAsB,mBAAmB,SAOvB;CAChB,MAAM,EAAE,WAAW,WAAW,cAAc,YAAY,cAAc;CACtE,MAAM,UAAU,aAAa,MAAM,GAAG,iCAAiC,WAAW;CAClF,MAAM,WAAW,KAAK,IAAI,IAAI,QAAQ;CAEtC,OAAO,MAAM;EACX,MAAM,UAAU,MAAM,UAAU,CAAC,CAC9B,uBACO,CAAC,UAAU,eAAe,cAAc,YAAY,OAAO,CAAC,CACpE,CAAC,CACA,WAAW,EAAE,eAAe,CAAC,cAAc,MAAM,CAAC,CAClD,QAAQ;EAEX,QAAQ,QAAQ,QAAhB;GACE,KAAK,aACH;GACF,KAAK,WACH,MAAM,IAAI,uBAAuB,WAAW,QAAQ,KAAK;GAC3D,KAAK,qBACH,MAAM,IAAI,+BAA+B,WAAW,QAAQ,cAAc;GAC5E,KAAK;GACL,KAAK,WACH;EACJ;EAEA,MAAM,cAAc,WAAW,KAAK,IAAI;EACxC,IAAI,eAAe,GACjB,MAAM,IAAI,4BAA4B,cAAc,YAAY,SAAS;EAE3E,MAAM,IAAI,SAAe,YAAY;GAEnC,WAD2B,SAAS,KAAK,IAAI,+BAA+B,WAAW,CACjF,CAAC,CAAC,QAAQ;EAClB,CAAC;CACH;AACF"}