@zihanw/pi-forge 0.2.0 → 0.3.1

package/dist/web-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-host.js","sourceRoot":"","sources":["../src/web-host.ts"],"names":[],"mappings":"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"}

package/examples/custom-system-status-extension/README.md

@@ -0,0 +1,78 @@
+# Custom System Status Extension
+
+This example shows how trusted extension code can register a pi-forge custom macro and custom slot.
+
+It registers:
+
+- `{{cpuLoad}}` macro: one-line CPU load summary.
+- `machine-status` slot: CPU load, OS load average, memory, and uptime snapshot.
+
+The renderers are synchronous, so this example uses Node's OS load average and memory APIs. It is a rough machine-load signal, not an async sampled CPU-utilization profiler.
+
+## Try It Quickly
+
+From a project where `@zihanw/pi-forge` is installed:
+
+```bash
+pi -e ./examples/custom-system-status-extension/index.ts
+```
+
+When developing from a local pi-forge checkout without installing the package, run the example in place from this repository. The extension falls back to `../../src/index.ts`.
+
+If you copy the extension into another project's `.pi/extensions/` folder while pi-forge itself is loaded from a local checkout, point the extension at that same checkout:
+
+```bash
+PI_FORGE_MODULE=/path/to/pi-forge/src/index.ts pi
+```
+
+Replace `/path/to/pi-forge` with the local checkout that matches the pi-forge extension you load from `settings.json`.
+
+Then copy `prompt-stack.json` into your project's prompt-stack folder:
+
+```bash
+mkdir -p .pi/forge/prompt-stacks
+cp examples/custom-system-status-extension/prompt-stack.json .pi/forge/prompt-stacks/custom-system-status.json
+```
+
+Use `/preset reload`, then `/preset use custom-system-status`.
+
+## Where To Put The Extension
+
+Use one of Pi's trusted extension locations:
+
+- Project-local: `.pi/extensions/system-status/index.ts`
+- Global: `~/.pi/agent/extensions/system-status/index.ts`
+- Package-managed: a Pi package with a `pi.extensions` entry in `package.json`
+
+For project-local use:
+
+```bash
+mkdir -p .pi/extensions/system-status
+cp examples/custom-system-status-extension/index.ts .pi/extensions/system-status/index.ts
+```
+
+Project-local extensions load only after the project is trusted. If the extension is not loaded, the stack can still be read, but `machine-status` will validate as an unsupported slot and `{{cpuLoad}}` will remain an unresolved macro.
+
+If the extension fails with `Cannot find module '@zihanw/pi-forge'`, pi-forge is not installed as a package visible to this extension. Either install/load pi-forge as a package, run the example in place from the pi-forge checkout, or set `PI_FORGE_MODULE` to the local `src/index.ts` path of the checkout that Pi is loading.
+
+## Stack Reference
+
+The stack references the custom slot declaratively:
+
+```json
+{
+  "kind": "slot",
+  "id": "machine-status",
+  "enabled": true,
+  "role": "system",
+  "slot": "machine-status",
+  "options": {
+    "format": "plain",
+    "heading": "Runtime machine snapshot",
+    "includeMemory": true,
+    "includeUptime": true
+  }
+}
+```
+
+Only the extension file contains executable code. The prompt stack just selects the registered slot and passes options.

package/examples/custom-system-status-extension/index.ts

@@ -0,0 +1,176 @@
+import { cpus, freemem, loadavg, totalmem, uptime } from "node:os";
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { registerMacro, registerSlot } from "../../src/index.ts";
+
+interface PiForgeRegistrationApi {
+	registerMacro: typeof registerMacro;
+	registerSlot: typeof registerSlot;
+}
+
+interface SystemStatusSnapshot {
+	logicalCores: number;
+	cpuModel: string;
+	load1: number;
+	load5: number;
+	load15: number;
+	normalizedLoad1: number;
+	freeMemoryMb: number;
+	totalMemoryMb: number;
+	usedMemoryPercent: number;
+	uptimeSeconds: number;
+}
+
+interface ExampleRegistryState {
+	unregister: Array<() => void>;
+}
+
+type ExampleGlobal = typeof globalThis & {
+	__piForgeSystemStatusExample?: ExampleRegistryState;
+};
+
+function registryState(): ExampleRegistryState {
+	const globalScope = globalThis as ExampleGlobal;
+	globalScope.__piForgeSystemStatusExample ??= { unregister: [] };
+	return globalScope.__piForgeSystemStatusExample;
+}
+
+function resetRegistrations(): void {
+	const state = registryState();
+	for (const unregister of state.unregister.splice(0)) unregister();
+}
+
+export default async function systemStatusExtension(_pi: ExtensionAPI): Promise<void> {
+	const { registerMacro, registerSlot } = await loadPiForgeRegistrationApi();
+	resetRegistrations();
+	const state = registryState();
+
+	state.unregister.push(
+		registerMacro({
+			name: "cpuLoad",
+			source: "pi-forge-example-system-status",
+			description: "Current machine CPU load as normalized 1-minute OS load average.",
+			render: () => formatCpuLoad(readSystemStatus()),
+		}),
+		registerSlot({
+			name: "machine-status",
+			source: "pi-forge-example-system-status",
+			description: "Current machine CPU, memory, and uptime snapshot.",
+			options: {
+				format: { type: "enum", values: ["plain", "xml"], default: "plain" },
+				heading: { type: "string", default: "Machine status" },
+				includeMemory: { type: "boolean", default: true },
+				includeUptime: { type: "boolean", default: true },
+			},
+			render: (ctx) => {
+				const snapshot = readSystemStatus();
+				const includeMemory = ctx.options.includeMemory !== false;
+				const includeUptime = ctx.options.includeUptime !== false;
+				const heading = typeof ctx.options.heading === "string" && ctx.options.heading.trim()
+					? ctx.options.heading.trim()
+					: "Machine status";
+
+				if (ctx.format() === "xml") {
+					const lines = [
+						"<machine_status>",
+						`  <cpu logical_cores=\"${snapshot.logicalCores}\" normalized_load_1m=\"${snapshot.normalizedLoad1.toFixed(3)}\" model=\"${ctx.helpers.escapeXml(snapshot.cpuModel)}\">${ctx.helpers.escapeXml(formatCpuLoad(snapshot))}</cpu>`,
+						`  <load_average one_minute=\"${snapshot.load1.toFixed(2)}\" five_minutes=\"${snapshot.load5.toFixed(2)}\" fifteen_minutes=\"${snapshot.load15.toFixed(2)}\" />`,
+					];
+					if (includeMemory) {
+						lines.push(`  <memory used_percent=\"${snapshot.usedMemoryPercent.toFixed(1)}\" free_mb=\"${snapshot.freeMemoryMb}\" total_mb=\"${snapshot.totalMemoryMb}\" />`);
+					}
+					if (includeUptime) {
+						lines.push(`  <uptime>${ctx.helpers.escapeXml(formatDuration(snapshot.uptimeSeconds))}</uptime>`);
+					}
+					lines.push("</machine_status>");
+					return lines.join("\n");
+				}
+
+				const lines = [
+					`${heading}:`,
+					ctx.helpers.plainBullet("CPU", `${snapshot.logicalCores} logical cores, ${snapshot.cpuModel}`),
+					ctx.helpers.plainBullet("CPU load", formatCpuLoad(snapshot)),
+					ctx.helpers.plainBullet("Load average", `${snapshot.load1.toFixed(2)} / ${snapshot.load5.toFixed(2)} / ${snapshot.load15.toFixed(2)} (1m/5m/15m)`),
+				];
+				if (includeMemory) {
+					lines.push(ctx.helpers.plainBullet("Memory", `${snapshot.usedMemoryPercent.toFixed(1)}% used (${snapshot.freeMemoryMb} MB free / ${snapshot.totalMemoryMb} MB total)`));
+				}
+				if (includeUptime) {
+					lines.push(ctx.helpers.plainBullet("Uptime", formatDuration(snapshot.uptimeSeconds)));
+				}
+				return lines.join("\n");
+			},
+		}),
+	);
+}
+
+async function loadPiForgeRegistrationApi(): Promise<PiForgeRegistrationApi> {
+	const override = process.env.PI_FORGE_MODULE;
+	if (override) {
+		return importPiForgeApi(pathToFileURL(resolve(override)).href);
+	}
+
+	try {
+		return await importPiForgeApi("@zihanw/pi-forge");
+	} catch {
+		try {
+			return await importPiForgeApi("../../src/index.ts");
+		} catch (error) {
+			const detail = error instanceof Error ? error.message : String(error);
+			throw new Error(
+				"Unable to load pi-forge registration API. Install @zihanw/pi-forge, " +
+				"set PI_FORGE_MODULE=/absolute/path/to/pi-forge/src/index.ts, or run this example in place from the pi-forge checkout. " +
+				`Last error: ${detail}`,
+			);
+		}
+	}
+}
+
+async function importPiForgeApi(specifier: string): Promise<PiForgeRegistrationApi> {
+	const mod = await import(specifier) as Partial<PiForgeRegistrationApi>;
+	if (typeof mod.registerMacro !== "function" || typeof mod.registerSlot !== "function") {
+		throw new Error(`Module does not export registerMacro/registerSlot: ${specifier}`);
+	}
+	return { registerMacro: mod.registerMacro, registerSlot: mod.registerSlot };
+}
+
+function readSystemStatus(): SystemStatusSnapshot {
+	const cores = cpus();
+	const logicalCores = Math.max(cores.length, 1);
+	const [load1 = 0, load5 = 0, load15 = 0] = loadavg();
+	const free = freemem();
+	const total = totalmem();
+	const freeMemoryMb = Math.round(free / 1024 / 1024);
+	const totalMemoryMb = Math.round(total / 1024 / 1024);
+	const usedMemoryPercent = total > 0 ? ((total - free) / total) * 100 : 0;
+
+	return {
+		logicalCores,
+		cpuModel: cores[0]?.model ?? "unknown",
+		load1,
+		load5,
+		load15,
+		normalizedLoad1: load1 / logicalCores,
+		freeMemoryMb,
+		totalMemoryMb,
+		usedMemoryPercent,
+		uptimeSeconds: uptime(),
+	};
+}
+
+function formatCpuLoad(snapshot: SystemStatusSnapshot): string {
+	const normalizedPercent = snapshot.normalizedLoad1 * 100;
+	return `${normalizedPercent.toFixed(1)}% normalized (${snapshot.load1.toFixed(2)} 1m load / ${snapshot.logicalCores} logical cores)`;
+}
+
+function formatDuration(seconds: number): string {
+	const days = Math.floor(seconds / 86_400);
+	const hours = Math.floor((seconds % 86_400) / 3_600);
+	const minutes = Math.floor((seconds % 3_600) / 60);
+	const parts: string[] = [];
+	if (days > 0) parts.push(`${days}d`);
+	if (hours > 0 || parts.length > 0) parts.push(`${hours}h`);
+	parts.push(`${minutes}m`);
+	return parts.join(" ");
+}

package/examples/custom-system-status-extension/prompt-stack.json

@@ -0,0 +1,39 @@
+{
+  "schemaVersion": 1,
+  "type": "pi-forge.prompt-stack",
+  "id": "custom-system-status",
+  "name": "Custom System Status",
+  "description": "Example stack that uses a trusted custom macro and custom slot registered by examples/custom-system-status-extension/index.ts.",
+  "mode": "append",
+  "items": [
+    {
+      "kind": "block",
+      "id": "cpu-load-macro",
+      "name": "CPU Load Macro",
+      "enabled": true,
+      "role": "system",
+      "content": "Current rough CPU load: {{cpuLoad}}"
+    },
+    {
+      "kind": "slot",
+      "id": "machine-status",
+      "name": "Machine Status Slot",
+      "enabled": true,
+      "role": "system",
+      "slot": "machine-status",
+      "options": {
+        "format": "plain",
+        "heading": "Runtime machine snapshot",
+        "includeMemory": true,
+        "includeUptime": true
+      }
+    },
+    {
+      "kind": "slot",
+      "id": "chat-history",
+      "name": "Chat History",
+      "enabled": true,
+      "slot": "chat-history"
+    }
+  ]
+}

package/examples/default-prompt-stack.json

@@ -2,8 +2,8 @@
   "schemaVersion": 1,
   "type": "pi-forge.prompt-stack",
   "id": "default",
-  "name": "Default pi-forge Prompt Stack",
-  "description": "A starter stack that replaces Pi's default system prompt while keeping tools, skills, project context, and chat history as movable slots.",
+  "name": "Default Pi Prompt Mirror",
+  "description": "Recreates Pi's built-in prompt layout with pi-forge slots, exposing tools, guidelines, docs, append-system-prompt, project context, skills, date/cwd, and chat history as movable pieces.",
   "autoActivate": true,
   "mode": "replace",
   "defaults": {
@@ -13,48 +13,24 @@
   "context": {
     "allowDuplicateChatHistory": false
   },
-  "variables": {
-    "user": "User",
-    "char": "Assistant"
+  "tools": {
+    "allow": ["*"]
   },
-  "state": {
-    "schemaVersion": 1,
-    "definitions": {
-      "agent.progress": {
-        "type": "string",
-        "scope": "session",
-        "description": "Concise summary of current task, story, or conversation progress.",
-        "agentWritable": true
-      },
-      "agent.openQuestions": {
-        "type": "string[]",
-        "scope": "session",
-        "description": "Short list of questions that may need user input.",
-        "agentWritable": true
-      },
-      "agent.notes": {
-        "type": "string[]",
-        "scope": "session",
-        "description": "Durable notes the user explicitly asked the agent to remember.",
-        "agentWritable": true
-      },
-      "user.preference": {
-        "type": "string",
-        "scope": "session",
-        "description": "User-provided preference or instruction for this session.",
-        "agentWritable": false,
-        "userWritable": true
-      }
-    }
+  "skills": {
+    "allow": ["*"]
   },
   "items": [
     {
       "kind": "block",
       "id": "main-role",
-      "name": "Main Role",
+      "name": "Pi Default Role",
       "enabled": true,
       "role": "system",
-      "content": "You are an expert coding assistant operating inside pi-forge, a prompt-stack controlled Pi extension. Help the user by reading files, executing commands, editing code, and writing new files. Follow the active prompt stack layout exactly."
+      "source": {
+        "package": "@earendil-works/pi-coding-agent",
+        "file": "dist/core/system-prompt.js"
+      },
+      "content": "You are an expert coding assistant operating inside pi, a coding agent harness. You help users by reading files, executing commands, editing code, and writing new files."
     },
     {
       "kind": "slot",
@@ -62,61 +38,76 @@
       "name": "Available Tools",
       "enabled": true,
       "role": "system",
-      "slot": "tools"
+      "slot": "tools",
+      "options": {
+        "format": "plain",
+        "onlyWithSnippets": true
+      }
+    },
+    {
+      "kind": "block",
+      "id": "custom-tools-note",
+      "name": "Custom Tools Note",
+      "enabled": true,
+      "role": "system",
+      "content": "In addition to the tools above, you may have access to other custom tools depending on the project."
     },
     {
       "kind": "slot",
       "id": "tool-guidelines",
-      "name": "Tool Guidelines",
+      "name": "Guidelines",
       "enabled": true,
       "role": "system",
-      "slot": "tool-guidelines"
+      "slot": "tool-guidelines",
+      "options": {
+        "format": "plain",
+        "heading": "Guidelines:",
+        "includePiDefaultGuidelines": true,
+        "piStyle": true
+      }
     },
     {
       "kind": "slot",
-      "id": "project-context",
-      "name": "Project Context",
+      "id": "pi-docs",
+      "name": "Pi Documentation Guidance",
       "enabled": true,
       "role": "system",
-      "slot": "project-context"
+      "slot": "pi-docs"
     },
     {
       "kind": "slot",
-      "id": "skills",
-      "name": "Available Skills",
+      "id": "append-system-prompt",
+      "name": "User Append System Prompt",
       "enabled": true,
       "role": "system",
-      "slot": "skills"
+      "slot": "append-system-prompt"
     },
     {
       "kind": "slot",
-      "id": "date-cwd",
-      "name": "Date and Working Directory",
+      "id": "project-context",
+      "name": "Project Context",
       "enabled": true,
       "role": "system",
-      "slot": "date-cwd"
+      "slot": "project-context"
     },
     {
       "kind": "slot",
-      "id": "prompt-state",
-      "name": "Prompt State",
+      "id": "skills",
+      "name": "Available Skills",
       "enabled": true,
-      "role": "user",
-      "slot": "variables",
+      "role": "system",
+      "slot": "skills",
       "options": {
-        "includeScopes": ["session"],
-        "includeNamespaces": ["user.*", "agent.*"],
-        "includeMetadata": true,
-        "maxValueChars": 1200
+        "requireReadTool": true
       }
     },
     {
-      "kind": "block",
-      "id": "history-open",
-      "name": "Open Conversation Context Wrapper",
+      "kind": "slot",
+      "id": "date-cwd",
+      "name": "Date and Working Directory",
       "enabled": true,
-      "role": "user",
-      "content": "<conversation_context>\nThe following is the current Pi conversation context. Treat it as authoritative conversation state, including user requests, assistant replies, tool calls, and tool results."
+      "role": "system",
+      "slot": "date-cwd"
     },
     {
       "kind": "slot",
@@ -124,38 +115,6 @@
       "name": "Chat History",
       "enabled": true,
       "slot": "chat-history"
-    },
-    {
-      "kind": "block",
-      "id": "history-close",
-      "name": "Close Conversation Context Wrapper",
-      "enabled": true,
-      "role": "user",
-      "content": "</conversation_context>"
-    },
-    {
-      "kind": "block",
-      "id": "post-history-focus",
-      "name": "Post-History Focus Instruction",
-      "enabled": true,
-      "role": "user",
-      "content": "<current_turn_instructions>\nFocus on the latest user request. Use the wrapped conversation context only as context; do not repeat it. If tools are needed, use the available Pi tools according to their schemas.\n</current_turn_instructions>"
-    },
-    {
-      "kind": "slot",
-      "id": "append-system-prompt",
-      "name": "User Append System Prompt",
-      "enabled": true,
-      "role": "user",
-      "slot": "append-system-prompt"
-    },
-    {
-      "kind": "slot",
-      "id": "pi-docs",
-      "name": "Pi Docs Guidance",
-      "enabled": false,
-      "role": "system",
-      "slot": "pi-docs"
     }
   ]
 }

package/examples/image-reader-prompt-stack.json

@@ -0,0 +1,124 @@
+{
+  "schemaVersion": 1,
+  "type": "pi-forge.prompt-stack",
+  "id": "image-reader",
+  "name": "Image Reader Subagent",
+  "description": "A vision-subagent prompt stack that converts images into detailed, neutral visual reports for a main agent that may not have vision access.",
+  "autoActivate": false,
+  "mode": "replace",
+  "defaults": {
+    "syntheticMessagesVisible": false,
+    "unresolvedMacroPolicy": "warn"
+  },
+  "context": {
+    "allowDuplicateChatHistory": false
+  },
+  "tools": {
+    "deny": ["bash", "edit", "write"]
+  },
+  "variables": {
+    "audience": "main agent",
+    "report_mode": "image-reader",
+    "detail_level": "exhaustive factual visual inventory",
+    "safety_scope": "include safety-relevant visual content neutrally without giving instructions for harmful acts"
+  },
+  "items": [
+    {
+      "kind": "block",
+      "id": "role",
+      "name": "Image Reader Role",
+      "enabled": true,
+      "role": "system",
+      "content": "{{setturnvar::active_preset::image-reader}}You are an image reader subagent. Your job is to inspect image inputs directly and produce a faithful visual report for the {{audience}}.\n\nUse this stack only when you can actually inspect the image. If no image is present, the image is inaccessible, or the current model cannot view images, say that directly and do not guess.\n\nPrimary objective: describe exactly what is visible in the image in detail. Treat the report as sensory evidence for another agent, not as advice, judgment, or creative writing."
+    },
+    {
+      "kind": "block",
+      "id": "report-rules",
+      "name": "Visual Report Rules",
+      "enabled": true,
+      "role": "system",
+      "content": "Reporting rules:\n- Be concrete, literal, and complete. Include objects, people, text, layout, colors, lighting, camera angle, foreground/background, visible actions, and spatial relationships.\n- Separate direct observations from uncertainty. Use phrases like \"appears to\", \"possibly\", or \"unclear\" when the image does not support certainty.\n- Transcribe visible text exactly when legible. Preserve line breaks when they matter.\n- Do not identify private people or infer identity. Describe visible attributes only when relevant to the image.\n- Do not infer hidden intent, guilt, medical diagnosis, protected traits, or off-image facts.\n- Do not omit disturbing or safety-relevant visual content. If weapons, injuries, blood, drugs, self-harm indicators, hate symbols, nudity, sexual content, abuse, dangerous tools, or illegal activity are visible, describe what is visible neutrally.\n- Do not provide operational instructions, optimization, encouragement, or procedural guidance for harmful acts. Stay at visual-description level.\n- If the image contains graphic injury, sexual content, or other sensitive material, keep the wording clinically descriptive and avoid sensational detail beyond what the main agent needs to understand the image."
+    },
+    {
+      "kind": "block",
+      "id": "macro-context",
+      "name": "Macro Context",
+      "enabled": true,
+      "role": "system",
+      "content": "{{ifeq::report_mode::image-reader::Report mode is active: {{upper::{{report_mode}}}}.::Report mode is not image-reader; state this mismatch before proceeding.}}\n{{ifvar::safety_scope::Safety scope: {{safety_scope}}.}}\n{{iftools::read::If the user references an image file path and direct vision input is unavailable, you may inspect only file metadata or surrounding text with read tools; do not pretend metadata is image vision.}}\n{{ifslot::variables::Runtime variables are available below for auditability.}}"
+    },
+    {
+      "kind": "slot",
+      "id": "variables",
+      "name": "Image Reader Variables",
+      "enabled": true,
+      "role": "system",
+      "slot": "variables",
+      "options": {
+        "includeStatic": true,
+        "includeSession": true,
+        "includeTurn": true,
+        "format": "plain"
+      }
+    },
+    {
+      "kind": "slot",
+      "id": "tools",
+      "name": "Available Read-Only Tools",
+      "enabled": true,
+      "role": "system",
+      "slot": "tools",
+      "options": {
+        "format": "plain",
+        "onlyWithSnippets": true
+      }
+    },
+    {
+      "kind": "slot",
+      "id": "date-cwd",
+      "name": "Date and Working Directory",
+      "enabled": true,
+      "role": "system",
+      "slot": "date-cwd"
+    },
+    {
+      "kind": "block",
+      "id": "history-open",
+      "name": "Open Prior Task Context",
+      "enabled": true,
+      "role": "user",
+      "content": "<prior_task_context>\nThe following prior messages are background for the image-reading request. Use them only to understand what the main agent needs from the image report."
+    },
+    {
+      "kind": "slot",
+      "id": "chat-history",
+      "name": "Prior Context Without Current Request",
+      "enabled": true,
+      "slot": "chat-history",
+      "options": {
+        "includeLastUserMessage": false,
+        "stripAssistantThinking": true,
+        "includeSummaries": true,
+        "toolMode": "drop",
+        "maxMessages": 20,
+        "maxChars": 12000
+      }
+    },
+    {
+      "kind": "block",
+      "id": "history-close",
+      "name": "Close Prior Task Context",
+      "enabled": true,
+      "role": "user",
+      "content": "</prior_task_context>"
+    },
+    {
+      "kind": "block",
+      "id": "current-image-task",
+      "name": "Current Image Task",
+      "enabled": true,
+      "role": "user",
+      "content": "<current_image_task>\n{{xml::{{lastUserMessage}}}}\n</current_image_task>\n\nProduce the image report now for the {{audience}}.\n\nRequired output:\n1. Access check: state whether you can directly inspect the image.\n2. One-sentence overview: summarize the scene plainly.\n3. Detailed inventory: list visible subjects, objects, setting, text, colors, layout, and relationships.\n4. Safety-relevant content: list visible hazards, injuries, weapons, explicit content, abuse indicators, hate symbols, or other potentially harmful content. Write \"None visible\" only if none are visible.\n5. Uncertainties: list anything important that is unclear, ambiguous, cropped, blurry, or inferred.\n6. Machine-readable summary: include one compact JSON object with keys \"canInspectImage\", \"overview\", \"visibleText\", \"safetyRelevantContent\", and \"uncertainties\". Use strings or arrays only; do not include markdown inside the JSON.\n\nRequest as JSON string for logging: {{json::{{lastUserMessage}}}}"
+    }
+  ]
+}