@astralyn/pi 0.82.1 → 0.82.3

package/examples/extensions/custom-provider-anthropic/index.ts

@@ -8,15 +8,15 @@
  * - API key support via environment variable
  * - Two model definitions
  *
- * Usage:
+ * Usage (from the repository or package root):
  *   # First install dependencies
- *   cd packages/coding-agent/examples/extensions/custom-provider && npm install
+ *   npm install --prefix examples/extensions/custom-provider-anthropic
  *
  *   # With OAuth (run /login custom-anthropic first)
- *   pi -e ./packages/coding-agent/examples/extensions/custom-provider
+ *   pi -e examples/extensions/custom-provider-anthropic
  *
  *   # With API key
- *   CUSTOM_ANTHROPIC_API_KEY=sk-ant-... pi -e ./packages/coding-agent/examples/extensions/custom-provider
+ *   CUSTOM_ANTHROPIC_API_KEY=sk-ant-... pi -e examples/extensions/custom-provider-anthropic
  *
  * Then use /model to select custom-anthropic/claude-sonnet-4-5
  */

package/examples/extensions/custom-provider-anthropic/package-lock.json

@@ -1,14 +1,14 @@
 {
-  "name": "pi-extension-custom-provider",
+  "name": "pi-extension-custom-provider-anthropic",
   "version": "0.82.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
-      "name": "pi-extension-custom-provider",
+      "name": "pi-extension-custom-provider-anthropic",
       "version": "0.82.0",
       "dependencies": {
-        "@anthropic-ai/sdk": "^0.52.0"
+        "@anthropic-ai/sdk": "0.52.0"
       }
     },
     "node_modules/@anthropic-ai/sdk": {

package/examples/extensions/custom-provider-gitlab-duo/index.ts

@@ -4,8 +4,8 @@
  * Provides access to GitLab Duo AI models (Claude and GPT) through GitLab's AI Gateway.
  * Delegates to pi-ai's built-in Anthropic and OpenAI streaming implementations.
  *
- * Usage:
- *   pi -e ./packages/coding-agent/examples/extensions/custom-provider-gitlab-duo
+ * Usage (from the repository or package root):
+ *   pi -e examples/extensions/custom-provider-gitlab-duo
  *   # Then /login gitlab-duo, or set GITLAB_TOKEN=glpat-...
  */
 

package/examples/extensions/custom-provider-gitlab-duo/test.ts

@@ -8,9 +8,9 @@
  *   npx tsx test.ts claude-sonnet-4-5-20250929 --thinking
  */
 
+import { getAgentDir } from "@astralyn/pi";
 import { type Api, type Context, type Model, registerApiProvider, streamSimple } from "@earendil-works/pi-ai/compat";
 import { readFileSync } from "fs";
-import { getAgentDir } from "packages/coding-agent/src/config.js";
 import { join } from "path";
 import { MODELS, streamGitLabDuo } from "./index.ts";
 

package/examples/extensions/dynamic-resources/dynamic.json

@@ -1,5 +1,5 @@
 {
-	"$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"$schema": "https://raw.githubusercontent.com/ming-kang/pi/main/src/modes/interactive/theme/theme-schema.json",
 	"name": "dynamic-resources",
 	"vars": {
 		"cyan": "#00d7ff",

package/examples/extensions/gondolin/index.ts

@@ -6,13 +6,11 @@
  * /workspace write through to the host; other guest filesystem changes are
  * isolated to the VM.
  *
- * Setup:
- *   cd packages/coding-agent/examples/extensions/gondolin
- *   npm install --ignore-scripts
+ * Setup (from the repository or package root):
+ *   npm install --ignore-scripts --prefix examples/extensions/gondolin
  *
- * Usage:
- *   cd /path/to/project
- *   pi -e /path/to/pi/packages/coding-agent/examples/extensions/gondolin
+ * Usage (from the project that should be mounted at /workspace):
+ *   pi -e /absolute/path/to/pi/examples/extensions/gondolin
  *
  * Requirements:
  *   - Node.js >= 23.6.0 for @earendil-works/gondolin

package/examples/extensions/message-renderer.ts

@@ -12,7 +12,7 @@ import { Box, Text } from "@earendil-works/pi-tui";
 
 export default function (pi: ExtensionAPI) {
 	// Register custom renderer for "status-update" messages
-	pi.registerMessageRenderer("status-update", (message, { expanded }, theme) => {
+	pi.registerMessageRenderer("status-update", (message, { expanded, outputPad }, theme) => {
 		const details = message.details as { level: string; timestamp: number } | undefined;
 		const level = details?.level ?? "info";
 
@@ -29,7 +29,7 @@ export default function (pi: ExtensionAPI) {
 		}
 
 		// Use Box with customMessageBg for consistent styling
-		const box = new Box(1, 1, (t) => theme.bg("customMessageBg", t));
+		const box = new Box(outputPad, 1, (t) => theme.bg("customMessageBg", t));
 		box.addChild(new Text(text, 0, 0));
 		return box;
 	});

package/examples/extensions/overlay-qa-tests.ts

@@ -485,13 +485,13 @@ class StreamingOverflowComponent extends BaseOverlay {
 			echo ""
 			for i in $(seq 1 100); do
 				# Simulate long file paths with OSC 8 hyperlinks (clickable) - tests width overflow
-				DIR="/Users/nicobailon/Documents/development/pi-mono/packages/coding-agent/src/modes/interactive"
+				DIR="/opt/overlay-qa-fixtures/a-deliberately-long-project-directory/src/modes/interactive"
 				FILE="\${DIR}/components/very-long-component-name-that-exceeds-width-\${i}.ts"
 				echo -e "\\033]8;;file://\${FILE}\\007▶ read: \${FILE}\\033]8;;\\007"
 
 				# Add some colored status messages with long text
 				if [ $((i % 5)) -eq 0 ]; then
-					echo -e "  \\033[32m✓ Successfully processed \${i} files in /Users/nicobailon/Documents/development/pi-mono\\033[0m"
+					echo -e "  \\033[32m✓ Successfully processed \${i} files in \${DIR}\\033[0m"
 				fi
 				if [ $((i % 7)) -eq 0 ]; then
 					echo -e "  \\033[33m⚠ Warning: potential issue detected at line \${i} in very-long-component-name-that-exceeds-width.ts\\033[0m"

package/examples/extensions/project-trust.ts

@@ -4,11 +4,11 @@
  * Demonstrates the project_trust event. Install globally or pass via -e:
  *
  *   mkdir -p ~/.pi/agent/extensions
- *   cp packages/coding-agent/examples/extensions/project-trust.ts ~/.pi/agent/extensions/
+ *   cp examples/extensions/project-trust.ts ~/.pi/agent/extensions/
  *
  * Or:
  *
- *   pi -e packages/coding-agent/examples/extensions/project-trust.ts
+ *   pi -e examples/extensions/project-trust.ts
  *
  * Try it in a project containing .pi, AGENTS.md/CLAUDE.md, or .agents/skills.
  */

package/examples/extensions/sandbox/package-lock.json

@@ -8,7 +8,7 @@
 			"name": "pi-extension-sandbox",
 			"version": "1.12.0",
 			"dependencies": {
-				"@anthropic-ai/sandbox-runtime": "^0.0.26"
+				"@anthropic-ai/sandbox-runtime": "0.0.26"
 			}
 		},
 		"node_modules/@anthropic-ai/sandbox-runtime": {

package/examples/extensions/with-deps/package-lock.json

@@ -8,10 +8,10 @@
       "name": "pi-extension-with-deps",
       "version": "0.82.0",
       "dependencies": {
-        "ms": "^2.1.3"
+        "ms": "2.1.3"
       },
       "devDependencies": {
-        "@types/ms": "^2.1.0"
+        "@types/ms": "2.1.0"
       }
     },
     "node_modules/@types/ms": {

package/examples/sdk/README.md

@@ -1,6 +1,6 @@
 # SDK Examples
 
-Programmatic usage of pi-coding-agent via `createAgentSession()` and `createAgentSessionRuntime()`.
+Programmatic usage of `@astralyn/pi` via `createAgentSession()` and `createAgentSessionRuntime()`.
 
 The runtime example shows how to build a recreate function that closes over process-global fixed inputs and recreates cwd-bound services and sessions as the active session cwd changes.
 
@@ -15,7 +15,7 @@ The runtime example shows how to build a recreate function that closes over proc
 | `05-tools.ts` | Built-in tool allowlists |
 | `06-extensions.ts` | Logging, blocking, result modification |
 | `07-context-files.ts` | AGENTS.md context files |
-| `08-slash-commands.ts` | File-based slash commands |
+| `08-prompt-templates.ts` | File-based prompt templates |
 | `09-api-keys-and-oauth.ts` | API key resolution, OAuth config |
 | `10-settings.ts` | Override compaction, retry, terminal settings |
 | `11-sessions.ts` | In-memory, persistent, continue, list sessions |
@@ -24,75 +24,69 @@ The runtime example shows how to build a recreate function that closes over proc
 
 ## Running
 
+From the repository root, or from the root of an unpacked npm package:
+
 ```bash
-cd packages/coding-agent
 npx tsx examples/sdk/01-minimal.ts
 ```
 
 ## Quick Reference
 
 ```typescript
-import { getModel } from "@earendil-works/pi-ai";
 import {
   createAgentSession,
   DefaultResourceLoader,
+  getAgentDir,
   ModelRuntime,
   SessionManager,
   SettingsManager,
 } from "@astralyn/pi";
+import { getModel } from "@earendil-works/pi-ai/compat";
 
-const modelRuntime = await ModelRuntime.create();
-
-// Minimal
-const { session } = await createAgentSession({ modelRuntime });
+// Minimal: uses the default model, resources, tools, settings, and session storage.
+const { session } = await createAgentSession();
 
-// Custom model
+// Select a built-in model.
+const modelRuntime = await ModelRuntime.create();
 const model = getModel("anthropic", "claude-opus-4-5");
-const { session } = await createAgentSession({ model, thinkingLevel: "high", modelRuntime });
-
-// Modify prompt
-const loader = new DefaultResourceLoader({
-  systemPromptOverride: (base) => `${base}\n\nBe concise.`,
+if (model) {
+  const { session: modelSession } = await createAgentSession({
+    model,
+    thinkingLevel: "high",
+    modelRuntime,
+  });
+}
+
+// Replace the system prompt.
+const resourceLoader = new DefaultResourceLoader({
+  cwd: process.cwd(),
+  agentDir: getAgentDir(),
+  systemPromptOverride: () => "You are helpful and concise.",
+  appendSystemPromptOverride: () => [],
 });
-await loader.reload();
-const { session } = await createAgentSession({ resourceLoader: loader, modelRuntime });
-
-// Read-only
-const { session } = await createAgentSession({ tools: ["read", "grep", "find", "ls"], modelRuntime });
-
-// In-memory
-const { session } = await createAgentSession({
+await resourceLoader.reload();
+const { session: promptSession } = await createAgentSession({
+  resourceLoader,
   sessionManager: SessionManager.inMemory(),
-  modelRuntime,
 });
 
-// Full control
-const customRuntime = await ModelRuntime.create({
-  authPath: "/my/app/auth.json",
-  modelsPath: "/my/app/models.json",
+// Enable only read-only built-in tools and keep the session in memory.
+const { session: readOnlySession } = await createAgentSession({
+  tools: ["read", "grep", "find", "ls"],
+  sessionManager: SessionManager.inMemory(),
 });
-customRuntime.setRuntimeApiKey("anthropic", process.env.MY_KEY!);
 
-const resourceLoader = new DefaultResourceLoader({
-  systemPromptOverride: () => "You are helpful.",
-  extensionFactories: [myExtension],
-  skillsOverride: () => ({ skills: [], diagnostics: [] }),
-  agentsFilesOverride: () => ({ agentsFiles: [] }),
-  promptsOverride: () => ({ prompts: [], diagnostics: [] }),
+// Override settings without file I/O.
+const settingsManager = SettingsManager.inMemory({
+  compaction: { enabled: false },
+  retry: { enabled: true, maxRetries: 2 },
 });
-await resourceLoader.reload();
-
-const { session } = await createAgentSession({
-  model,
-  modelRuntime: customRuntime,
-  resourceLoader,
-  tools: ["read", "bash", "my_tool"],
-  customTools: [myTool],
+const { session: configuredSession } = await createAgentSession({
+  settingsManager,
   sessionManager: SessionManager.inMemory(),
-  settingsManager: SettingsManager.inMemory(),
 });
 
-// Run prompts
+// Stream a response.
 session.subscribe((event) => {
   if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
     process.stdout.write(event.assistantMessageEvent.delta);