@selesai/code 0.13.6 → 0.13.8

package/examples/sdk/README.md

@@ -1,144 +1,144 @@
-# SDK Examples
-
-Programmatic usage of pi-coding-agent 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.
-
-## Examples
-
-| File | Description |
-|------|-------------|
-| `01-minimal.ts` | Simplest usage with all defaults |
-| `02-custom-model.ts` | Select model and thinking level |
-| `03-custom-prompt.ts` | Replace or modify system prompt |
-| `04-skills.ts` | Discover, filter, or replace skills |
-| `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 |
-| `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 |
-| `12-full-control.ts` | Replace everything, no discovery |
-| `13-session-runtime.ts` | Manage runtime-backed session replacement |
-
-## Running
-
-```bash
-cd packages/coding-agent
-npx tsx examples/sdk/01-minimal.ts
-```
-
-## Quick Reference
-
-```typescript
-import { getModel } from "@earendil-works/pi-ai";
-import {
-  AuthStorage,
-  createAgentSession,
-  DefaultResourceLoader,
-  ModelRegistry,
-  SessionManager,
-  SettingsManager,
-} from "@earendil-works/pi-coding-agent";
-
-// Auth and models setup
-const authStorage = AuthStorage.create();
-const modelRegistry = ModelRegistry.create(authStorage);
-
-// Minimal
-const { session } = await createAgentSession({ authStorage, modelRegistry });
-
-// Custom model
-const model = getModel("anthropic", "claude-opus-4-5");
-const { session } = await createAgentSession({ model, thinkingLevel: "high", authStorage, modelRegistry });
-
-// Modify prompt
-const loader = new DefaultResourceLoader({
-  systemPromptOverride: (base) => `${base}\n\nBe concise.`,
-});
-await loader.reload();
-const { session } = await createAgentSession({ resourceLoader: loader, authStorage, modelRegistry });
-
-// Read-only
-const { session } = await createAgentSession({ tools: ["read", "grep", "find", "ls"], authStorage, modelRegistry });
-
-// In-memory
-const { session } = await createAgentSession({
-  sessionManager: SessionManager.inMemory(),
-  authStorage,
-  modelRegistry,
-});
-
-// Full control
-const customAuth = AuthStorage.create("/my/app/auth.json");
-customAuth.setRuntimeApiKey("anthropic", process.env.MY_KEY!);
-const customRegistry = ModelRegistry.create(customAuth);
-
-const resourceLoader = new DefaultResourceLoader({
-  systemPromptOverride: () => "You are helpful.",
-  extensionFactories: [myExtension],
-  skillsOverride: () => ({ skills: [], diagnostics: [] }),
-  agentsFilesOverride: () => ({ agentsFiles: [] }),
-  promptsOverride: () => ({ prompts: [], diagnostics: [] }),
-});
-await resourceLoader.reload();
-
-const { session } = await createAgentSession({
-  model,
-  authStorage: customAuth,
-  modelRegistry: customRegistry,
-  resourceLoader,
-  tools: ["read", "bash", "my_tool"],
-  customTools: [myTool],
-  sessionManager: SessionManager.inMemory(),
-  settingsManager: SettingsManager.inMemory(),
-});
-
-// Run prompts
-session.subscribe((event) => {
-  if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
-    process.stdout.write(event.assistantMessageEvent.delta);
-  }
-});
-await session.prompt("Hello");
-```
-
-## Options
-
-| Option | Default | Description |
-|--------|---------|-------------|
-| `authStorage` | `AuthStorage.create()` | Credential storage |
-| `modelRegistry` | `ModelRegistry.create(authStorage)` | Model registry |
-| `cwd` | `process.cwd()` | Working directory |
-| `agentDir` | `~/.pi/agent` | Config directory |
-| `model` | From settings/first available | Model to use |
-| `thinkingLevel` | From settings/"off" | off, low, medium, high |
-| `tools` | `["read", "bash", "edit", "write"]` built-ins | Allowlist tool names across built-in, extension, and custom tools |
-| `customTools` | `[]` | Additional tool definitions |
-| `resourceLoader` | DefaultResourceLoader | Resource loader for extensions, skills, prompts, themes |
-| `sessionManager` | `SessionManager.create(cwd)` | Persistence |
-| `settingsManager` | `SettingsManager.create(cwd, agentDir)` | Settings overrides |
-
-## Events
-
-```typescript
-session.subscribe((event) => {
-  switch (event.type) {
-    case "message_update":
-      if (event.assistantMessageEvent.type === "text_delta") {
-        process.stdout.write(event.assistantMessageEvent.delta);
-      }
-      break;
-    case "tool_execution_start":
-      console.log(`Tool: ${event.toolName}`);
-      break;
-    case "tool_execution_end":
-      console.log(`Result: ${event.result}`);
-      break;
-    case "agent_end":
-      console.log("Done");
-      break;
-  }
-});
-```
+# SDK Examples
+
+Programmatic usage of pi-coding-agent 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.
+
+## Examples
+
+| File | Description |
+|------|-------------|
+| `01-minimal.ts` | Simplest usage with all defaults |
+| `02-custom-model.ts` | Select model and thinking level |
+| `03-custom-prompt.ts` | Replace or modify system prompt |
+| `04-skills.ts` | Discover, filter, or replace skills |
+| `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 |
+| `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 |
+| `12-full-control.ts` | Replace everything, no discovery |
+| `13-session-runtime.ts` | Manage runtime-backed session replacement |
+
+## Running
+
+```bash
+cd packages/coding-agent
+npx tsx examples/sdk/01-minimal.ts
+```
+
+## Quick Reference
+
+```typescript
+import { getModel } from "@earendil-works/pi-ai";
+import {
+  AuthStorage,
+  createAgentSession,
+  DefaultResourceLoader,
+  ModelRegistry,
+  SessionManager,
+  SettingsManager,
+} from "@earendil-works/pi-coding-agent";
+
+// Auth and models setup
+const authStorage = AuthStorage.create();
+const modelRegistry = ModelRegistry.create(authStorage);
+
+// Minimal
+const { session } = await createAgentSession({ authStorage, modelRegistry });
+
+// Custom model
+const model = getModel("anthropic", "claude-opus-4-5");
+const { session } = await createAgentSession({ model, thinkingLevel: "high", authStorage, modelRegistry });
+
+// Modify prompt
+const loader = new DefaultResourceLoader({
+  systemPromptOverride: (base) => `${base}\n\nBe concise.`,
+});
+await loader.reload();
+const { session } = await createAgentSession({ resourceLoader: loader, authStorage, modelRegistry });
+
+// Read-only
+const { session } = await createAgentSession({ tools: ["read", "grep", "find", "ls"], authStorage, modelRegistry });
+
+// In-memory
+const { session } = await createAgentSession({
+  sessionManager: SessionManager.inMemory(),
+  authStorage,
+  modelRegistry,
+});
+
+// Full control
+const customAuth = AuthStorage.create("/my/app/auth.json");
+customAuth.setRuntimeApiKey("anthropic", process.env.MY_KEY!);
+const customRegistry = ModelRegistry.create(customAuth);
+
+const resourceLoader = new DefaultResourceLoader({
+  systemPromptOverride: () => "You are helpful.",
+  extensionFactories: [myExtension],
+  skillsOverride: () => ({ skills: [], diagnostics: [] }),
+  agentsFilesOverride: () => ({ agentsFiles: [] }),
+  promptsOverride: () => ({ prompts: [], diagnostics: [] }),
+});
+await resourceLoader.reload();
+
+const { session } = await createAgentSession({
+  model,
+  authStorage: customAuth,
+  modelRegistry: customRegistry,
+  resourceLoader,
+  tools: ["read", "bash", "my_tool"],
+  customTools: [myTool],
+  sessionManager: SessionManager.inMemory(),
+  settingsManager: SettingsManager.inMemory(),
+});
+
+// Run prompts
+session.subscribe((event) => {
+  if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
+    process.stdout.write(event.assistantMessageEvent.delta);
+  }
+});
+await session.prompt("Hello");
+```
+
+## Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `authStorage` | `AuthStorage.create()` | Credential storage |
+| `modelRegistry` | `ModelRegistry.create(authStorage)` | Model registry |
+| `cwd` | `process.cwd()` | Working directory |
+| `agentDir` | `~/.pi/agent` | Config directory |
+| `model` | From settings/first available | Model to use |
+| `thinkingLevel` | From settings/"off" | off, low, medium, high |
+| `tools` | `["read", "bash", "edit", "write"]` built-ins | Allowlist tool names across built-in, extension, and custom tools |
+| `customTools` | `[]` | Additional tool definitions |
+| `resourceLoader` | DefaultResourceLoader | Resource loader for extensions, skills, prompts, themes |
+| `sessionManager` | `SessionManager.create(cwd)` | Persistence |
+| `settingsManager` | `SettingsManager.create(cwd, agentDir)` | Settings overrides |
+
+## Events
+
+```typescript
+session.subscribe((event) => {
+  switch (event.type) {
+    case "message_update":
+      if (event.assistantMessageEvent.type === "text_delta") {
+        process.stdout.write(event.assistantMessageEvent.delta);
+      }
+      break;
+    case "tool_execution_start":
+      console.log(`Tool: ${event.toolName}`);
+      break;
+    case "tool_execution_end":
+      console.log(`Result: ${event.result}`);
+      break;
+    case "agent_end":
+      console.log("Done");
+      break;
+  }
+});
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@selesai/code",
-  "version": "0.13.6",
+  "version": "0.13.8",
   "description": "Maintained, extension-first Pi coding agent with built-in workflows, subagents, web research, questions, skills, and an enhanced terminal UI.",
   "type": "module",
   "repository": {

package/dist/skills/unlazy/scripts/install-hooks.mjs

@@ -1,206 +0,0 @@
-#!/usr/bin/env node
-// Install or remove unlazy's Claude Code Stop hook. Zero dependencies. Node 16+.
-
-import {
-  closeSync, constants as fsConstants, existsSync, fstatSync, lstatSync,
-  openSync, readFileSync,
-} from "node:fs";
-import { join } from "node:path";
-import { fileURLToPath } from "node:url";
-import { homedir } from "node:os";
-import { validateScopeId, writeAtomic } from "./lib/gates.mjs";
-
-const HELP = `usage: install-hooks.mjs [--scope ID] [--shared | --global] [--uninstall]
-
-  default       .claude/settings.local.json in the current project
-  --shared      .claude/settings.json in the current project
-  --global      ~/.claude/settings.json
-  --scope ID    pin the hook to one validated .unlazy/ID pipeline
-  --uninstall   remove only unlazy handlers, preserving sibling handlers`;
-
-function usage(message) {
-  console.error("install-hooks: " + message);
-  console.error("run install-hooks.mjs --help for usage");
-  process.exit(2);
-}
-
-const args = process.argv.slice(2);
-const known = new Set(["--scope", "--shared", "--global", "--uninstall", "--help", "-h"]);
-let scope = null;
-let shared = false;
-let global = false;
-let uninstall = false;
-for (let index = 0; index < args.length; index++) {
-  const arg = args[index];
-  if (!known.has(arg)) usage("unknown option " + arg);
-  if (arg === "--help" || arg === "-h") { console.log(HELP); process.exit(0); }
-  if (arg === "--scope") {
-    if (scope !== null) usage("duplicate --scope");
-    scope = args[++index];
-    if (!scope) usage("--scope needs a pipeline id");
-    continue;
-  }
-  if (arg === "--shared") shared = true;
-  if (arg === "--global") global = true;
-  if (arg === "--uninstall") uninstall = true;
-}
-if (shared && global) usage("--shared and --global are mutually exclusive");
-if (scope) {
-  const error = validateScopeId(scope);
-  if (error) usage(error);
-}
-
-const script = fileURLToPath(new URL("./stop-hook.mjs", import.meta.url));
-const MANAGED_MARKER = "--unlazy-hook-v2";
-const target = global
-  ? join(homedir(), ".claude", "settings.json")
-  : join(process.cwd(), ".claude", shared ? "settings.json" : "settings.local.json");
-const backup = target + ".unlazy.bak";
-
-const isObject = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
-let raw = "";
-let settings = {};
-if (existsSync(target)) {
-  let fd = null;
-  try {
-    const noFollow = process.platform === "win32" ? 0 : (fsConstants.O_NOFOLLOW || 0);
-    fd = openSync(target, fsConstants.O_RDONLY | (fsConstants.O_NONBLOCK || 0) | noFollow);
-    const opened = fstatSync(fd);
-    const named = lstatSync(target);
-    if (!opened.isFile() || !named.isFile() || named.isSymbolicLink() ||
-        opened.nlink !== 1 || named.nlink !== 1 ||
-        opened.dev !== named.dev || opened.ino !== named.ino) {
-      throw new Error("target must be one unchanged regular file, not a link or directory");
-    }
-    raw = readFileSync(fd, "utf8");
-    const after = lstatSync(target);
-    if (!after.isFile() || after.isSymbolicLink() || after.nlink !== 1 ||
-        after.dev !== opened.dev || after.ino !== opened.ino) {
-      throw new Error("target changed while it was read");
-    }
-    settings = JSON.parse(raw);
-  } catch (error) {
-    console.error("Refusing to touch " + target + ": " + error.message);
-    process.exit(1);
-  } finally {
-    if (fd !== null) try { closeSync(fd); } catch { /* ignore */ }
-  }
-}
-
-function validateSettings(value) {
-  if (!isObject(value)) return "settings root must be a JSON object";
-  if (value.hooks !== undefined && !isObject(value.hooks)) return "hooks must be a JSON object";
-  if (value.hooks && value.hooks.Stop !== undefined && !Array.isArray(value.hooks.Stop)) return "hooks.Stop must be an array";
-  const groups = (value.hooks && value.hooks.Stop) || [];
-  for (let groupIndex = 0; groupIndex < groups.length; groupIndex++) {
-    const group = groups[groupIndex];
-    if (!isObject(group)) return "hooks.Stop[" + groupIndex + "] must be an object";
-    if (!Array.isArray(group.hooks)) return "hooks.Stop[" + groupIndex + "].hooks must be an array";
-    for (let hookIndex = 0; hookIndex < group.hooks.length; hookIndex++) {
-      if (!isObject(group.hooks[hookIndex])) {
-        return "hooks.Stop[" + groupIndex + "].hooks[" + hookIndex + "] must be an object";
-      }
-    }
-  }
-  return null;
-}
-
-const shapeError = validateSettings(settings);
-if (shapeError) {
-  console.error("Refusing to touch " + target + ": " + shapeError + ".");
-  process.exit(1);
-}
-
-const quote = (value) => {
-  if (process.platform === "win32") return '"' + String(value).replace(/"/g, '""') + '"';
-  return "'" + String(value).replace(/'/g, "'\\''") + "'";
-};
-const command = quote(process.execPath) + " " + quote(script) + " " + MANAGED_MARKER +
-  (scope ? " --scope " + scope : "");
-
-const isOurHandler = (handler) => {
-  if (!isObject(handler) || typeof handler.command !== "string") return false;
-  const value = handler.command;
-  const token = (name) => new RegExp("(?:^|\\s)" + name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + "(?=\\s|$)").test(value);
-  // An exact foreign --unlazy-* option is positive evidence that this is not
-  // our legacy entry, even when it happens to invoke the same script path.
-  const foreignUnlazyOption = value.split(/\s+/).some((part) => {
-    const quoted = part.length >= 2 &&
-      ((part[0] === '"' && part[part.length - 1] === '"') ||
-       (part[0] === "'" && part[part.length - 1] === "'"));
-    const option = quoted ? part.slice(1, -1) : part;
-    return option.startsWith("--unlazy-") && option !== MANAGED_MARKER;
-  });
-  if (foreignUnlazyOption) return false;
-  if (token(MANAGED_MARKER)) return true;
-  // Migrate v2.0/v2.1 handlers only when both the exact old marker and the
-  // packaged scripts/stop-hook.mjs shape are present. Substrings such as
-  // --unlazy-helper and unrelated same-named scripts are never ownership.
-  const packagedStopHook = /(?:^|[\s"'])[^\s"']*[\\/]scripts[\\/]stop-hook\.mjs(?=$|[\s"'])/i.test(value);
-  const namedLegacyInstall = /[\\/]unlazy[\\/]scripts[\\/]stop-hook\.mjs(?=$|[\s"'])/i.test(value);
-  // Upstream v2.0 shipped before any marker and is recognizable only at its
-  // conventional Claude skill location. Keep that narrow compatibility path,
-  // while marker-era moved installs require the exact standalone old token.
-  const conventionalV2Path = /[\\/]\.claude[\\/]skills[\\/]unlazy[\\/]scripts[\\/]stop-hook\.mjs(?=$|[\s"'])/i.test(value);
-  return value.includes(script) || conventionalV2Path ||
-    (token("--unlazy") && (namedLegacyInstall || packagedStopHook));
-};
-
-const originalGroups = (settings.hooks && settings.hooks.Stop) || [];
-let removed = 0;
-const keptGroups = [];
-for (const group of originalGroups) {
-  const hooks = group.hooks.filter((handler) => {
-    if (!isOurHandler(handler)) return true;
-    removed++;
-    return false;
-  });
-  if (hooks.length) keptGroups.push({ ...group, hooks });
-}
-
-function nextSettings(groups) {
-  const result = { ...settings };
-  const hooks = { ...(settings.hooks || {}) };
-  if (groups.length) hooks.Stop = groups;
-  else delete hooks.Stop;
-  if (Object.keys(hooks).length) result.hooks = hooks;
-  else delete result.hooks;
-  return result;
-}
-
-function persist(value) {
-  try {
-    if (raw) writeAtomic(backup, raw);
-    writeAtomic(target, JSON.stringify(value, null, 2) + "\n");
-  } catch (error) {
-    console.error("Could not update " + target + ": " + error.message);
-    process.exit(1);
-  }
-}
-
-if (uninstall) {
-  if (!removed) {
-    console.log("Nothing to remove: no unlazy Stop hook found in " + target);
-    process.exit(0);
-  }
-  persist(nextSettings(keptGroups));
-  console.log("Removed unlazy Stop hook (" + removed + " handler(s)) from " + target + ". Sibling handlers were preserved.");
-  process.exit(0);
-}
-
-const alreadyCurrent = removed === 1 && originalGroups.some((group) =>
-  group.hooks.some((handler) => isOurHandler(handler) && handler.command === command &&
-    handler.type === "command" && handler.timeout === 20));
-if (alreadyCurrent) {
-  console.log("Already installed in " + target + " (idempotent, nothing changed).");
-  process.exit(0);
-}
-
-const entry = { hooks: [{ type: "command", command, timeout: 20 }] };
-persist(nextSettings([...keptGroups, entry]));
-console.log("Installed unlazy Stop hook into " + target + "\n" +
-  "  command: " + command + "\n" +
-  "  scope:   " + (scope ? scope : "resolved per session/pipeline") + "\n" +
-  "  backup:  " + (raw ? backup : "not needed for a new file") + "\n" +
-  "  note:    keep .unlazy/ and .unlazy-hook-state.json ignored; they are local coordination state." +
-  (shared ? "\n  warning: shared settings contain this machine's absolute Node and skill paths." : ""));