@selesai/code 0.10.1 → 0.10.2

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.10.1",
+	"version": "0.10.2",
 	"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/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/bun/cli.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=cli.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/bun/register-bedrock.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=register-bedrock.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/bun/restore-sandbox-env.d.ts

@@ -1,17 +0,0 @@
-/**
- * Workaround for https://github.com/oven-sh/bun/issues/27802
- *
- * Bun compiled binaries have an empty `process.env` when running inside
- * sandbox environments (e.g. nono on Linux/macOS). On Linux we can recover
- * the environment from `/proc/self/environ`.
- *
- * Keep this in sync with getBunSandboxEnvValue() in
- * packages/ai/src/utils/provider-env.ts. The ai package duplicates the lookup
- * for direct consumers that do not go through this coding-agent entrypoint.
- */
-/**
- * Restore environment variables from `/proc/self/environ` when running
- * inside a sandbox where Bun's `process.env` is empty.
- */
-export declare function restoreSandboxEnv(): void;
-//# sourceMappingURL=restore-sandbox-env.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/cli/args.d.ts

@@ -1,57 +0,0 @@
-/**
- * CLI argument parsing and help display
- */
-import type { ThinkingLevel } from "@earendil-works/pi-agent-core";
-import type { ExtensionFlag } from "../core/extensions/types.ts";
-export type Mode = "text" | "json" | "rpc";
-export interface Args {
-    provider?: string;
-    model?: string;
-    apiKey?: string;
-    systemPrompt?: string;
-    appendSystemPrompt?: string[];
-    thinking?: ThinkingLevel;
-    continue?: boolean;
-    resume?: boolean;
-    help?: boolean;
-    version?: boolean;
-    mode?: Mode;
-    name?: string;
-    noSession?: boolean;
-    session?: string;
-    sessionId?: string;
-    fork?: string;
-    sessionDir?: string;
-    models?: string[];
-    tools?: string[];
-    excludeTools?: string[];
-    noTools?: boolean;
-    noBuiltinTools?: boolean;
-    extensions?: string[];
-    noExtensions?: boolean;
-    print?: boolean;
-    export?: string;
-    noSkills?: boolean;
-    skills?: string[];
-    promptTemplates?: string[];
-    noPromptTemplates?: boolean;
-    themes?: string[];
-    noThemes?: boolean;
-    noContextFiles?: boolean;
-    listModels?: string | true;
-    offline?: boolean;
-    verbose?: boolean;
-    projectTrustOverride?: boolean;
-    messages: string[];
-    fileArgs: string[];
-    /** Unknown flags (potentially extension flags) - map of flag name to value */
-    unknownFlags: Map<string, boolean | string>;
-    diagnostics: Array<{
-        type: "warning" | "error";
-        message: string;
-    }>;
-}
-export declare function isValidThinkingLevel(level: string): level is ThinkingLevel;
-export declare function parseArgs(args: string[]): Args;
-export declare function printHelp(extensionFlags?: ExtensionFlag[]): void;
-//# sourceMappingURL=args.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/cli/config-selector.d.ts

@@ -1,16 +0,0 @@
-/**
- * TUI config selector for `pi config` command
- */
-import type { SettingsManager } from "../core/settings-manager.ts";
-import { type ScopedResolvedPaths } from "../modes/interactive/components/config-selector.ts";
-export interface ConfigSelectorOptions {
-    resolvedPaths: ScopedResolvedPaths;
-    settingsManager: SettingsManager;
-    cwd: string;
-    agentDir: string;
-    writeScope: "global" | "project";
-    projectModeAvailable: boolean;
-}
-/** Show TUI config selector and return when closed */
-export declare function selectConfig(options: ConfigSelectorOptions): Promise<void>;
-//# sourceMappingURL=config-selector.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/cli/file-processor.d.ts

@@ -1,15 +0,0 @@
-/**
- * Process @file CLI arguments into text content and image attachments
- */
-import type { ImageContent } from "@earendil-works/pi-ai";
-export interface ProcessedFiles {
-    text: string;
-    images: ImageContent[];
-}
-export interface ProcessFileOptions {
-    /** Whether to auto-resize images to 2000x2000 max. Default: true */
-    autoResizeImages?: boolean;
-}
-/** Process @file arguments into text content and image attachments */
-export declare function processFileArguments(fileArgs: string[], options?: ProcessFileOptions): Promise<ProcessedFiles>;
-//# sourceMappingURL=file-processor.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/cli/initial-message.d.ts

@@ -1,18 +0,0 @@
-import type { ImageContent } from "@earendil-works/pi-ai";
-import type { Args } from "./args.ts";
-export interface InitialMessageInput {
-    parsed: Args;
-    fileText?: string;
-    fileImages?: ImageContent[];
-    stdinContent?: string;
-}
-export interface InitialMessageResult {
-    initialMessage?: string;
-    initialImages?: ImageContent[];
-}
-/**
- * Combine stdin content, @file text, and the first CLI message into a single
- * initial prompt for non-interactive mode.
- */
-export declare function buildInitialMessage({ parsed, fileText, fileImages, stdinContent }: InitialMessageInput): InitialMessageResult;
-//# sourceMappingURL=initial-message.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/cli/list-models.d.ts

@@ -1,9 +0,0 @@
-/**
- * List available models with optional fuzzy search
- */
-import type { ModelRuntime } from "../core/model-runtime.ts";
-/**
- * List available models, optionally filtered by search pattern
- */
-export declare function listModels(modelRuntime: ModelRuntime, searchPattern?: string): Promise<void>;
-//# sourceMappingURL=list-models.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/cli/project-trust.d.ts

@@ -1,10 +0,0 @@
-import type { ProjectTrustContext } from "../core/extensions/types.ts";
-import type { AppMode } from "../core/project-trust.ts";
-import type { SettingsManager } from "../core/settings-manager.ts";
-export declare function createProjectTrustContext(options: {
-    cwd: string;
-    mode: AppMode;
-    settingsManager: SettingsManager;
-    hasUI: boolean;
-}): ProjectTrustContext;
-//# sourceMappingURL=project-trust.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/cli/session-picker.d.ts

@@ -1,10 +0,0 @@
-/**
- * TUI session selector for --resume flag
- */
-import type { SessionInfo, SessionListProgress } from "../core/session-manager.ts";
-import type { SettingsManager } from "../core/settings-manager.ts";
-type SessionsLoader = (onProgress?: SessionListProgress) => Promise<SessionInfo[]>;
-/** Show TUI session selector and return selected session path or null if cancelled */
-export declare function selectSession(currentSessionsLoader: SessionsLoader, allSessionsLoader: SessionsLoader, settingsManager: SettingsManager): Promise<string | null>;
-export {};
-//# sourceMappingURL=session-picker.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/cli/startup-ui.d.ts

@@ -1,20 +0,0 @@
-import { TUI } from "@earendil-works/pi-tui";
-import { SettingsManager } from "../core/settings-manager.ts";
-export declare function createStartupTui(settingsManager: SettingsManager): Promise<TUI>;
-export declare function startStartupTui(ui: TUI, settingsManager: SettingsManager): void;
-/**
- * First-time setup runs when all of these hold:
- * - this is the official Pi distribution (not a fork/rebrand)
- * - experimental features are enabled (PI_EXPERIMENTAL=1)
- * - the default agent directory is used (no custom agent dir override)
- * - setup was not completed before (settings.json does not exist)
- */
-export declare function shouldRunFirstTimeSetup(settingsPath?: string): boolean;
-export declare function showStartupSelector<T>(settingsManager: SettingsManager, title: string, options: Array<{
-    label: string;
-    value: T;
-}>): Promise<T | undefined>;
-/** Show the first-time setup dialog and persist the result */
-export declare function showFirstTimeSetup(settingsManager: SettingsManager): Promise<void>;
-export declare function showStartupInput(settingsManager: SettingsManager, title: string, placeholder?: string): Promise<string | undefined>;
-//# sourceMappingURL=startup-ui.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/cli.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=cli.d.ts.map

package/dist/extensions/pi-subagents/test/fixtures/pi-coding-agent-shim/dist/config.d.ts

@@ -1,96 +0,0 @@
-/**
- * Detect if we're running as a Bun compiled binary.
- * Bun binaries have import.meta.url containing "$bunfs", "~BUN", or "%7EBUN" (Bun's virtual filesystem path)
- */
-export declare const isBunBinary: boolean;
-/** Detect if Bun is the runtime (compiled binary or bun run) */
-export declare const isBunRuntime: boolean;
-export type InstallMethod = "bun-binary" | "npm" | "pnpm" | "yarn" | "bun" | "unknown";
-interface SelfUpdateCommandStep {
-    command: string;
-    args: string[];
-    display: string;
-}
-export interface SelfUpdateCommand extends SelfUpdateCommandStep {
-    steps?: SelfUpdateCommandStep[];
-}
-export type SelfUpdatePackageTarget = string | {
-    packageName: string;
-    installSpec?: string;
-};
-export declare function detectInstallMethod(): InstallMethod;
-export declare function getSelfUpdateCommand(packageName: string, npmCommand?: string[], updatePackageTarget?: SelfUpdatePackageTarget): SelfUpdateCommand | undefined;
-export declare function getSelfUpdateUnavailableInstruction(packageName: string, npmCommand?: string[], updatePackageTarget?: SelfUpdatePackageTarget): string;
-export declare function getUpdateInstruction(packageName: string): string;
-/**
- * Get the base directory for resolving package assets (themes, package.json, README.md, CHANGELOG.md).
- * - For Bun binary: returns the directory containing the executable
- * - For Node.js (dist/): returns __dirname (the dist/ directory)
- * - For tsx (src/): returns parent directory (the package root)
- */
-export declare function getPackageDir(): string;
-/**
- * Get path to built-in themes directory (shipped with package)
- * - For Bun binary: theme/ next to executable
- * - For Node.js (dist/): dist/modes/interactive/theme/
- * - For tsx (src/): src/modes/interactive/theme/
- */
-export declare function getThemesDir(): string;
-/**
- * Get path to HTML export template directory (shipped with package)
- * - For Bun binary: export-html/ next to executable
- * - For Node.js (dist/): dist/core/export-html/
- * - For tsx (src/): src/core/export-html/
- */
-export declare function getExportTemplateDir(): string;
-/** Get path to package.json */
-export declare function getPackageJsonPath(): string;
-/** Get path to README.md */
-export declare function getReadmePath(): string;
-/** Get path to docs directory */
-export declare function getDocsPath(): string;
-/** Get path to examples directory */
-export declare function getExamplesPath(): string;
-/** Get path to CHANGELOG.md */
-export declare function getChangelogPath(): string;
-/**
- * Get path to built-in interactive assets directory.
- * - For Bun binary: assets/ next to executable
- * - For Node.js (dist/): dist/modes/interactive/assets/
- * - For tsx (src/): src/modes/interactive/assets/
- */
-export declare function getInteractiveAssetsDir(): string;
-/** Get path to a bundled interactive asset */
-export declare function getBundledInteractiveAssetPath(name: string): string;
-export declare const PACKAGE_NAME: string;
-export declare const APP_NAME: string;
-export declare const APP_TITLE: string;
-export declare const CONFIG_DIR_NAME: string;
-export declare const VERSION: string;
-export declare const ENV_AGENT_DIR: string;
-export declare const ENV_SESSION_DIR: string;
-export declare function expandTildePath(path: string): string;
-/** Get the share viewer URL for a gist ID */
-export declare function getShareViewerUrl(gistId: string): string;
-/** Get the agent config directory (e.g., ~/.selesai/agent/) */
-export declare function getAgentDir(): string;
-/** Get path to user's custom themes directory */
-export declare function getCustomThemesDir(): string;
-/** Get path to models.json */
-export declare function getModelsPath(): string;
-/** Get path to auth.json */
-export declare function getAuthPath(): string;
-/** Get path to settings.json */
-export declare function getSettingsPath(): string;
-/** Get path to tools directory */
-export declare function getToolsDir(): string;
-/** Get path to managed binaries directory (fd, rg) */
-export declare function getBinDir(): string;
-/** Get path to prompt templates directory */
-export declare function getPromptsDir(): string;
-/** Get path to sessions directory */
-export declare function getSessionsDir(): string;
-/** Get path to debug log file */
-export declare function getDebugLogPath(): string;
-export {};
-//# sourceMappingURL=config.d.ts.map