my-pi 0.0.13 → 0.1.1

package/dist/api.js

@@ -1,2 +1,2 @@
-import { n as create_my_pi, r as runPrintMode, t as InteractiveMode } from "./api-CWEizv2k.js";
+import { n as create_my_pi, r as runPrintMode, t as InteractiveMode } from "./api-Dxi4curf.js";
 export { InteractiveMode, create_my_pi, runPrintMode };

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as create_my_pi } from "./api-CWEizv2k.js";
+import { n as create_my_pi } from "./api-Dxi4curf.js";
 import { InteractiveMode, runPrintMode } from "@mariozechner/pi-coding-agent";
 import { defineCommand, runMain } from "citty";
 import { readFileSync } from "node:fs";
@@ -106,6 +106,21 @@ runMain(defineCommand({
 			description: "Disable LSP extension",
 			default: false
 		},
+		"no-session-name": {
+			type: "boolean",
+			description: "Disable session name extension",
+			default: false
+		},
+		"no-confirm-destructive": {
+			type: "boolean",
+			description: "Disable destructive action confirmations",
+			default: false
+		},
+		"no-hooks": {
+			type: "boolean",
+			description: "Disable Claude-style hook execution",
+			default: false
+		},
 		telemetry: {
 			type: "boolean",
 			description: "Enable local SQLite telemetry for this process",
@@ -179,6 +194,9 @@ runMain(defineCommand({
 			recall: !args["no-builtin"] && !args["no-recall"],
 			prompt_presets: !args["no-builtin"] && !args["no-prompt-presets"],
 			lsp: !args["no-builtin"] && !args["no-lsp"],
+			session_name: !args["no-builtin"] && !args["no-session-name"],
+			confirm_destructive: !args["no-builtin"] && !args["no-confirm-destructive"],
+			hooks_resolution: !args["no-builtin"] && !args["no-hooks"],
 			telemetry: telemetry_override,
 			telemetry_db_path: args["telemetry-db"],
 			model: args.model,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\n// CLI for my-pi — composable pi coding agent\n// Extension stacking patterns inspired by https://github.com/disler/pi-vs-claude-code\n\nimport {\n\tInteractiveMode,\n\trunPrintMode,\n} from '@mariozechner/pi-coding-agent';\nimport { defineCommand, runMain } from 'citty';\nimport { readFileSync } from 'node:fs';\nimport { dirname, join, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { create_my_pi } from './api.js';\n\n// Suppress node:sqlite ExperimentalWarning\nprocess.removeAllListeners('warning');\nprocess.on('warning', (warning) => {\n\tif (warning.name !== 'ExperimentalWarning') {\n\t\tconsole.warn(warning);\n\t}\n});\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst pkg = JSON.parse(\n\treadFileSync(join(__dirname, '..', 'package.json'), 'utf-8'),\n);\n\n// citty can't handle repeatable args, so parse -e from argv directly\n// (citty uses strict: false, so unknown flags are silently ignored)\nfunction parse_extension_paths(argv: string[]): string[] {\n\tconst paths: string[] = [];\n\tfor (let i = 0; i < argv.length; i++) {\n\t\tif (\n\t\t\t(argv[i] === '-e' || argv[i] === '--extension') &&\n\t\t\ti + 1 < argv.length\n\t\t) {\n\t\t\tpaths.push(resolve(argv[++i]));\n\t\t}\n\t}\n\treturn paths;\n}\n\nasync function read_stdin(): Promise<string> {\n\tconst chunks: Buffer[] = [];\n\tfor await (const chunk of process.stdin) {\n\t\tchunks.push(chunk as Buffer);\n\t}\n\treturn Buffer.concat(chunks).toString('utf-8').trim();\n}\n\nfunction print_usage(): void {\n\tconsole.log(`my-pi v${pkg.version} — composable pi coding agent\\n`);\n\tconsole.log('Usage:');\n\tconsole.log(\n\t\t'  my-pi \"prompt\"                   One-shot print mode',\n\t);\n\tconsole.log(\n\t\t'  my-pi                            Interactive TUI mode',\n\t);\n\tconsole.log(\n\t\t'  my-pi -P \"prompt\"                Explicit print mode',\n\t);\n\tconsole.log(\n\t\t'  my-pi --json \"prompt\"            NDJSON output for agents',\n\t);\n\tconsole.log(\n\t\t'  my-pi -e ext.ts                  Stack an extension',\n\t);\n\tconsole.log(\n\t\t'  my-pi -e a.ts -e b.ts            Stack multiple extensions',\n\t);\n\tconsole.log(\n\t\t'  my-pi --telemetry --json \"task\"  Enable local SQLite telemetry',\n\t);\n\tconsole.log(\n\t\t'  my-pi --agent-dir /tmp/pi-agent   Override auth/config/session dir',\n\t);\n\tconsole.log(\n\t\t'  echo \"prompt\" | my-pi --json     Pipe stdin as prompt',\n\t);\n\tconsole.log(\n\t\t'  my-pi -m claude-haiku-4-5-20241022  Set initial model',\n\t);\n\tconsole.log(\n\t\t'  my-pi --no-builtin -e ext.ts     Skip all built-in extensions',\n\t);\n}\n\nconst main = defineCommand({\n\tmeta: {\n\t\tname: 'my-pi',\n\t\tversion: pkg.version,\n\t\tdescription:\n\t\t\t'Composable pi coding agent with MCP, LSP, chains, presets, and local eval telemetry',\n\t},\n\targs: {\n\t\tprint: {\n\t\t\ttype: 'boolean',\n\t\t\talias: 'P',\n\t\t\tdescription: 'Print mode (non-interactive, one-shot)',\n\t\t\tdefault: false,\n\t\t},\n\t\t'agent-dir': {\n\t\t\ttype: 'string',\n\t\t\tdescription:\n\t\t\t\t'Override Pi auth/config/session directory for this process',\n\t\t\trequired: false,\n\t\t},\n\t\tjson: {\n\t\t\ttype: 'boolean',\n\t\t\talias: 'j',\n\t\t\tdescription: 'Output NDJSON events (for agent consumption)',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-builtin': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable all built-in extensions',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-mcp': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable built-in MCP extension',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-skills': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable built-in skills extension',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-chain': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable built-in chain extension',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-filter': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable secret redaction in tool output',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-handoff': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable handoff extension',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-recall': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable recall extension',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-prompt-presets': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable prompt presets extension',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-lsp': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable LSP extension',\n\t\t\tdefault: false,\n\t\t},\n\t\ttelemetry: {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Enable local SQLite telemetry for this process',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-telemetry': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable local SQLite telemetry for this process',\n\t\t\tdefault: false,\n\t\t},\n\t\t'telemetry-db': {\n\t\t\ttype: 'string',\n\t\t\tdescription:\n\t\t\t\t'Override telemetry database path for this process',\n\t\t\trequired: false,\n\t\t},\n\t\tmodel: {\n\t\t\ttype: 'string',\n\t\t\talias: 'm',\n\t\t\tdescription:\n\t\t\t\t'Model to use (e.g. claude-sonnet-4-5-20241022, gpt-5.4)',\n\t\t},\n\t\t'system-prompt': {\n\t\t\ttype: 'string',\n\t\t\tdescription: 'Replace the base system prompt',\n\t\t\trequired: false,\n\t\t},\n\t\t'append-system-prompt': {\n\t\t\ttype: 'string',\n\t\t\tdescription: 'Append one-off instructions to the system prompt',\n\t\t\trequired: false,\n\t\t},\n\t\tprompt: {\n\t\t\ttype: 'string',\n\t\t\talias: 'p',\n\t\t\tdescription: 'Prompt text (alternative to positional argument)',\n\t\t\trequired: false,\n\t\t},\n\t},\n\tasync run({ args }) {\n\t\tconst cwd = process.cwd();\n\t\tconst extension_paths = parse_extension_paths(process.argv);\n\n\t\t// Resolve prompt: named --prompt flag > positional > stdin\n\t\tlet prompt = args.prompt;\n\t\tif (!prompt) {\n\t\t\t// Check for positional arguments (after citty strips flags)\n\t\t\tconst positionals = (args as any)._ as string[] | undefined;\n\t\t\tif (positionals && positionals.length > 0) {\n\t\t\t\tprompt = positionals[0];\n\t\t\t}\n\t\t}\n\t\tif (!prompt && !process.stdin.isTTY) {\n\t\t\tprompt = await read_stdin();\n\t\t}\n\n\t\t// Model validation (issue #5)\n\t\tif (args.model && /[/\\\\]/.test(args.model)) {\n\t\t\tconsole.error(\n\t\t\t\t`Error: Invalid model \"${args.model}\". Use bare model names without provider prefixes.`,\n\t\t\t);\n\t\t\tconsole.error(\n\t\t\t\t`  Examples: claude-sonnet-4-5-20241022, gpt-5.4, mistral-large`,\n\t\t\t);\n\t\t\tprocess.exit(1);\n\t\t}\n\n\t\tif (\n\t\t\t!args.print &&\n\t\t\t!args.json &&\n\t\t\t!prompt &&\n\t\t\t!process.stdout.isTTY\n\t\t) {\n\t\t\tprint_usage();\n\t\t\treturn;\n\t\t}\n\n\t\t// Startup feedback so silence = broken (issue #3)\n\t\tif (args.print || args.json || prompt) {\n\t\t\tprocess.stderr.write(\n\t\t\t\t`my-pi: connecting to ${args.model || 'default model'}...\\n`,\n\t\t\t);\n\t\t}\n\n\t\tif (args.telemetry && args['no-telemetry']) {\n\t\t\tconsole.error(\n\t\t\t\t'Error: --telemetry and --no-telemetry cannot be used together.',\n\t\t\t);\n\t\t\tprocess.exit(1);\n\t\t}\n\n\t\tconst telemetry_override = args.telemetry\n\t\t\t? true\n\t\t\t: args['no-telemetry']\n\t\t\t\t? false\n\t\t\t\t: undefined;\n\n\t\tconst runtime = await create_my_pi({\n\t\t\tcwd,\n\t\t\tagent_dir: args['agent-dir'],\n\t\t\textensions: extension_paths,\n\t\t\tmcp: !args['no-builtin'] && !args['no-mcp'],\n\t\t\tskills: !args['no-builtin'] && !args['no-skills'],\n\t\t\tchain: !args['no-builtin'] && !args['no-chain'],\n\t\t\tfilter_output: !args['no-builtin'] && !args['no-filter'],\n\t\t\thandoff: !args['no-builtin'] && !args['no-handoff'],\n\t\t\trecall: !args['no-builtin'] && !args['no-recall'],\n\t\t\tprompt_presets:\n\t\t\t\t!args['no-builtin'] && !args['no-prompt-presets'],\n\t\t\tlsp: !args['no-builtin'] && !args['no-lsp'],\n\t\t\ttelemetry: telemetry_override,\n\t\t\ttelemetry_db_path: args['telemetry-db'],\n\t\t\tmodel: args.model,\n\t\t\tsystem_prompt: args['system-prompt'],\n\t\t\tappend_system_prompt: args['append-system-prompt'],\n\t\t});\n\n\t\tif (args.print || args.json || prompt) {\n\t\t\tconst code = await runPrintMode(runtime, {\n\t\t\t\tmode: args.json ? 'json' : 'text',\n\t\t\t\tinitialMessage: prompt || '',\n\t\t\t\tinitialImages: [],\n\t\t\t\tmessages: [],\n\t\t\t});\n\t\t\tprocess.exit(code);\n\t\t} else if (!process.stdout.isTTY) {\n\t\t\tprint_usage();\n\t\t} else {\n\t\t\tconst mode = new InteractiveMode(runtime, {\n\t\t\t\tmigratedProviders: [],\n\t\t\t\tmodelFallbackMessage: undefined,\n\t\t\t\tinitialMessage: undefined,\n\t\t\t\tinitialImages: [],\n\t\t\t\tinitialMessages: [],\n\t\t\t});\n\t\t\tawait mode.run();\n\t\t}\n\t},\n});\n\nvoid runMain(main);\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\n// CLI for my-pi — composable pi coding agent\n// Extension stacking patterns inspired by https://github.com/disler/pi-vs-claude-code\n\nimport {\n\tInteractiveMode,\n\trunPrintMode,\n} from '@mariozechner/pi-coding-agent';\nimport { defineCommand, runMain } from 'citty';\nimport { readFileSync } from 'node:fs';\nimport { dirname, join, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { create_my_pi } from './api.js';\n\n// Suppress node:sqlite ExperimentalWarning\nprocess.removeAllListeners('warning');\nprocess.on('warning', (warning) => {\n\tif (warning.name !== 'ExperimentalWarning') {\n\t\tconsole.warn(warning);\n\t}\n});\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst pkg = JSON.parse(\n\treadFileSync(join(__dirname, '..', 'package.json'), 'utf-8'),\n);\n\n// citty can't handle repeatable args, so parse -e from argv directly\n// (citty uses strict: false, so unknown flags are silently ignored)\nfunction parse_extension_paths(argv: string[]): string[] {\n\tconst paths: string[] = [];\n\tfor (let i = 0; i < argv.length; i++) {\n\t\tif (\n\t\t\t(argv[i] === '-e' || argv[i] === '--extension') &&\n\t\t\ti + 1 < argv.length\n\t\t) {\n\t\t\tpaths.push(resolve(argv[++i]));\n\t\t}\n\t}\n\treturn paths;\n}\n\nasync function read_stdin(): Promise<string> {\n\tconst chunks: Buffer[] = [];\n\tfor await (const chunk of process.stdin) {\n\t\tchunks.push(chunk as Buffer);\n\t}\n\treturn Buffer.concat(chunks).toString('utf-8').trim();\n}\n\nfunction print_usage(): void {\n\tconsole.log(`my-pi v${pkg.version} — composable pi coding agent\\n`);\n\tconsole.log('Usage:');\n\tconsole.log(\n\t\t'  my-pi \"prompt\"                   One-shot print mode',\n\t);\n\tconsole.log(\n\t\t'  my-pi                            Interactive TUI mode',\n\t);\n\tconsole.log(\n\t\t'  my-pi -P \"prompt\"                Explicit print mode',\n\t);\n\tconsole.log(\n\t\t'  my-pi --json \"prompt\"            NDJSON output for agents',\n\t);\n\tconsole.log(\n\t\t'  my-pi -e ext.ts                  Stack an extension',\n\t);\n\tconsole.log(\n\t\t'  my-pi -e a.ts -e b.ts            Stack multiple extensions',\n\t);\n\tconsole.log(\n\t\t'  my-pi --telemetry --json \"task\"  Enable local SQLite telemetry',\n\t);\n\tconsole.log(\n\t\t'  my-pi --agent-dir /tmp/pi-agent   Override auth/config/session dir',\n\t);\n\tconsole.log(\n\t\t'  echo \"prompt\" | my-pi --json     Pipe stdin as prompt',\n\t);\n\tconsole.log(\n\t\t'  my-pi -m claude-haiku-4-5-20241022  Set initial model',\n\t);\n\tconsole.log(\n\t\t'  my-pi --no-builtin -e ext.ts     Skip all built-in extensions',\n\t);\n}\n\nconst main = defineCommand({\n\tmeta: {\n\t\tname: 'my-pi',\n\t\tversion: pkg.version,\n\t\tdescription:\n\t\t\t'Composable pi coding agent with MCP, LSP, chains, presets, and local eval telemetry',\n\t},\n\targs: {\n\t\tprint: {\n\t\t\ttype: 'boolean',\n\t\t\talias: 'P',\n\t\t\tdescription: 'Print mode (non-interactive, one-shot)',\n\t\t\tdefault: false,\n\t\t},\n\t\t'agent-dir': {\n\t\t\ttype: 'string',\n\t\t\tdescription:\n\t\t\t\t'Override Pi auth/config/session directory for this process',\n\t\t\trequired: false,\n\t\t},\n\t\tjson: {\n\t\t\ttype: 'boolean',\n\t\t\talias: 'j',\n\t\t\tdescription: 'Output NDJSON events (for agent consumption)',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-builtin': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable all built-in extensions',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-mcp': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable built-in MCP extension',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-skills': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable built-in skills extension',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-chain': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable built-in chain extension',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-filter': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable secret redaction in tool output',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-handoff': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable handoff extension',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-recall': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable recall extension',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-prompt-presets': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable prompt presets extension',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-lsp': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable LSP extension',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-session-name': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable session name extension',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-confirm-destructive': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable destructive action confirmations',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-hooks': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable Claude-style hook execution',\n\t\t\tdefault: false,\n\t\t},\n\t\ttelemetry: {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Enable local SQLite telemetry for this process',\n\t\t\tdefault: false,\n\t\t},\n\t\t'no-telemetry': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Disable local SQLite telemetry for this process',\n\t\t\tdefault: false,\n\t\t},\n\t\t'telemetry-db': {\n\t\t\ttype: 'string',\n\t\t\tdescription:\n\t\t\t\t'Override telemetry database path for this process',\n\t\t\trequired: false,\n\t\t},\n\t\tmodel: {\n\t\t\ttype: 'string',\n\t\t\talias: 'm',\n\t\t\tdescription:\n\t\t\t\t'Model to use (e.g. claude-sonnet-4-5-20241022, gpt-5.4)',\n\t\t},\n\t\t'system-prompt': {\n\t\t\ttype: 'string',\n\t\t\tdescription: 'Replace the base system prompt',\n\t\t\trequired: false,\n\t\t},\n\t\t'append-system-prompt': {\n\t\t\ttype: 'string',\n\t\t\tdescription: 'Append one-off instructions to the system prompt',\n\t\t\trequired: false,\n\t\t},\n\t\tprompt: {\n\t\t\ttype: 'string',\n\t\t\talias: 'p',\n\t\t\tdescription: 'Prompt text (alternative to positional argument)',\n\t\t\trequired: false,\n\t\t},\n\t},\n\tasync run({ args }) {\n\t\tconst cwd = process.cwd();\n\t\tconst extension_paths = parse_extension_paths(process.argv);\n\n\t\t// Resolve prompt: named --prompt flag > positional > stdin\n\t\tlet prompt = args.prompt;\n\t\tif (!prompt) {\n\t\t\t// Check for positional arguments (after citty strips flags)\n\t\t\tconst positionals = (args as any)._ as string[] | undefined;\n\t\t\tif (positionals && positionals.length > 0) {\n\t\t\t\tprompt = positionals[0];\n\t\t\t}\n\t\t}\n\t\tif (!prompt && !process.stdin.isTTY) {\n\t\t\tprompt = await read_stdin();\n\t\t}\n\n\t\t// Model validation (issue #5)\n\t\tif (args.model && /[/\\\\]/.test(args.model)) {\n\t\t\tconsole.error(\n\t\t\t\t`Error: Invalid model \"${args.model}\". Use bare model names without provider prefixes.`,\n\t\t\t);\n\t\t\tconsole.error(\n\t\t\t\t`  Examples: claude-sonnet-4-5-20241022, gpt-5.4, mistral-large`,\n\t\t\t);\n\t\t\tprocess.exit(1);\n\t\t}\n\n\t\tif (\n\t\t\t!args.print &&\n\t\t\t!args.json &&\n\t\t\t!prompt &&\n\t\t\t!process.stdout.isTTY\n\t\t) {\n\t\t\tprint_usage();\n\t\t\treturn;\n\t\t}\n\n\t\t// Startup feedback so silence = broken (issue #3)\n\t\tif (args.print || args.json || prompt) {\n\t\t\tprocess.stderr.write(\n\t\t\t\t`my-pi: connecting to ${args.model || 'default model'}...\\n`,\n\t\t\t);\n\t\t}\n\n\t\tif (args.telemetry && args['no-telemetry']) {\n\t\t\tconsole.error(\n\t\t\t\t'Error: --telemetry and --no-telemetry cannot be used together.',\n\t\t\t);\n\t\t\tprocess.exit(1);\n\t\t}\n\n\t\tconst telemetry_override = args.telemetry\n\t\t\t? true\n\t\t\t: args['no-telemetry']\n\t\t\t\t? false\n\t\t\t\t: undefined;\n\n\t\tconst runtime = await create_my_pi({\n\t\t\tcwd,\n\t\t\tagent_dir: args['agent-dir'],\n\t\t\textensions: extension_paths,\n\t\t\tmcp: !args['no-builtin'] && !args['no-mcp'],\n\t\t\tskills: !args['no-builtin'] && !args['no-skills'],\n\t\t\tchain: !args['no-builtin'] && !args['no-chain'],\n\t\t\tfilter_output: !args['no-builtin'] && !args['no-filter'],\n\t\t\thandoff: !args['no-builtin'] && !args['no-handoff'],\n\t\t\trecall: !args['no-builtin'] && !args['no-recall'],\n\t\t\tprompt_presets:\n\t\t\t\t!args['no-builtin'] && !args['no-prompt-presets'],\n\t\t\tlsp: !args['no-builtin'] && !args['no-lsp'],\n\t\t\tsession_name: !args['no-builtin'] && !args['no-session-name'],\n\t\t\tconfirm_destructive:\n\t\t\t\t!args['no-builtin'] && !args['no-confirm-destructive'],\n\t\t\thooks_resolution: !args['no-builtin'] && !args['no-hooks'],\n\t\t\ttelemetry: telemetry_override,\n\t\t\ttelemetry_db_path: args['telemetry-db'],\n\t\t\tmodel: args.model,\n\t\t\tsystem_prompt: args['system-prompt'],\n\t\t\tappend_system_prompt: args['append-system-prompt'],\n\t\t});\n\n\t\tif (args.print || args.json || prompt) {\n\t\t\tconst code = await runPrintMode(runtime, {\n\t\t\t\tmode: args.json ? 'json' : 'text',\n\t\t\t\tinitialMessage: prompt || '',\n\t\t\t\tinitialImages: [],\n\t\t\t\tmessages: [],\n\t\t\t});\n\t\t\tprocess.exit(code);\n\t\t} else if (!process.stdout.isTTY) {\n\t\t\tprint_usage();\n\t\t} else {\n\t\t\tconst mode = new InteractiveMode(runtime, {\n\t\t\t\tmigratedProviders: [],\n\t\t\t\tmodelFallbackMessage: undefined,\n\t\t\t\tinitialMessage: undefined,\n\t\t\t\tinitialImages: [],\n\t\t\t\tinitialMessages: [],\n\t\t\t});\n\t\t\tawait mode.run();\n\t\t}\n\t},\n});\n\nvoid runMain(main);\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "my-pi",
-  "version": "0.0.13",
+  "version": "0.1.1",
   "description": "Composable pi coding agent with MCP, LSP, agent chains, prompt presets, and local eval telemetry",
   "keywords": [
     "cli",

package/src/extensions/config.test.ts

@@ -26,6 +26,15 @@ describe('find_builtin_extension', () => {
 		expect(find_builtin_extension('language-server')?.key).toBe(
 			'lsp',
 		);
+		expect(find_builtin_extension('auto-name')?.key).toBe(
+			'session-name',
+		);
+		expect(find_builtin_extension('confirm')?.key).toBe(
+			'confirm-destructive',
+		);
+		expect(find_builtin_extension('hooks')?.key).toBe(
+			'hooks-resolution',
+		);
 	});
 });
 

package/src/extensions/config.ts

@@ -16,7 +16,10 @@ export type BuiltinExtensionKey =
 	| 'handoff'
 	| 'recall'
 	| 'prompt-presets'
-	| 'lsp';
+	| 'lsp'
+	| 'session-name'
+	| 'confirm-destructive'
+	| 'hooks-resolution';
 
 export interface BuiltinExtensionInfo {
 	key: BuiltinExtensionKey;
@@ -79,7 +82,8 @@ export const BUILTIN_EXTENSIONS: BuiltinExtensionInfo[] = [
 	{
 		key: 'handoff',
 		label: 'Handoff',
-		description: 'Session handoff export and /handoff command',
+		description:
+			'AI-generated session handoff with editor review and new-session prefill',
 		cli_flag: '--no-handoff',
 		aliases: ['handoff'],
 	},
@@ -106,6 +110,30 @@ export const BUILTIN_EXTENSIONS: BuiltinExtensionInfo[] = [
 		cli_flag: '--no-lsp',
 		aliases: ['lsp', 'language-server'],
 	},
+	{
+		key: 'session-name',
+		label: 'Session name',
+		description:
+			'AI-powered session auto-naming and /session-name command',
+		cli_flag: '--no-session-name',
+		aliases: ['session-name', 'session', 'auto-name'],
+	},
+	{
+		key: 'confirm-destructive',
+		label: 'Confirm destructive',
+		description:
+			'Prompt before destructive session actions like clear, switch, and fork',
+		cli_flag: '--no-confirm-destructive',
+		aliases: ['confirm-destructive', 'confirm'],
+	},
+	{
+		key: 'hooks-resolution',
+		label: 'Hooks resolution',
+		description:
+			'Claude Code style PostToolUse hook compatibility from .claude, .rulesync, and .pi configs',
+		cli_flag: '--no-hooks',
+		aliases: ['hooks-resolution', 'hooks'],
+	},
 ];
 
 export function get_builtin_extensions_config_path(): string {

package/src/extensions/confirm-destructive.test.ts

@@ -0,0 +1,157 @@
+import type { ExtensionAPI } from '@mariozechner/pi-coding-agent';
+import { describe, expect, it, vi } from 'vitest';
+import confirm_destructive from './confirm-destructive.js';
+
+function create_test_pi() {
+	const events = new Map<string, any>();
+	const pi = {
+		on(name: string, handler: any) {
+			events.set(name, handler);
+		},
+	} as unknown as ExtensionAPI;
+	return { pi, events };
+}
+
+function create_context(overrides: Partial<any> = {}) {
+	const notify = vi.fn();
+	const confirm = vi.fn();
+	const select = vi.fn();
+
+	const ctx = {
+		hasUI: true,
+		ui: {
+			notify,
+			confirm,
+			select,
+		},
+		sessionManager: {
+			getEntries: vi.fn().mockReturnValue([]),
+		},
+		...overrides,
+	};
+
+	return { ctx, notify, confirm, select };
+}
+
+describe('confirm-destructive extension', () => {
+	it('confirms before clearing a session and cancels on rejection', async () => {
+		const { pi, events } = create_test_pi();
+		await confirm_destructive(pi);
+
+		const handler = events.get('session_before_switch');
+		const { ctx, confirm, notify } = create_context();
+		confirm.mockResolvedValue(false);
+
+		const result = await handler({ reason: 'new' }, ctx);
+
+		expect(confirm).toHaveBeenCalledWith(
+			'Clear session?',
+			'This will delete all messages in the current session.',
+		);
+		expect(notify).toHaveBeenCalledWith('Clear cancelled', 'info');
+		expect(result).toEqual({ cancel: true });
+	});
+
+	it('allows clearing a session when confirmed', async () => {
+		const { pi, events } = create_test_pi();
+		await confirm_destructive(pi);
+
+		const handler = events.get('session_before_switch');
+		const { ctx, confirm, notify } = create_context();
+		confirm.mockResolvedValue(true);
+
+		const result = await handler({ reason: 'new' }, ctx);
+
+		expect(confirm).toHaveBeenCalledOnce();
+		expect(notify).not.toHaveBeenCalled();
+		expect(result).toBeUndefined();
+	});
+
+	it('does not prompt when switching sessions without user messages', async () => {
+		const { pi, events } = create_test_pi();
+		await confirm_destructive(pi);
+
+		const handler = events.get('session_before_switch');
+		const { ctx, confirm } = create_context({
+			sessionManager: {
+				getEntries: vi.fn().mockReturnValue([
+					{
+						type: 'message',
+						message: { role: 'assistant' },
+					},
+				]),
+			},
+		});
+
+		const result = await handler({ reason: 'resume' }, ctx);
+
+		expect(confirm).not.toHaveBeenCalled();
+		expect(result).toBeUndefined();
+	});
+
+	it('confirms before switching sessions when user messages exist', async () => {
+		const { pi, events } = create_test_pi();
+		await confirm_destructive(pi);
+
+		const handler = events.get('session_before_switch');
+		const { ctx, confirm, notify } = create_context({
+			sessionManager: {
+				getEntries: vi.fn().mockReturnValue([
+					{
+						type: 'message',
+						message: { role: 'user' },
+					},
+				]),
+			},
+		});
+		confirm.mockResolvedValue(false);
+
+		const result = await handler({ reason: 'resume' }, ctx);
+
+		expect(confirm).toHaveBeenCalledWith(
+			'Switch session?',
+			'You have messages in the current session. Switch anyway?',
+		);
+		expect(notify).toHaveBeenCalledWith('Switch cancelled', 'info');
+		expect(result).toEqual({ cancel: true });
+	});
+
+	it('confirms before forking and cancels when declined', async () => {
+		const { pi, events } = create_test_pi();
+		await confirm_destructive(pi);
+
+		const handler = events.get('session_before_fork');
+		const { ctx, select, notify } = create_context();
+		select.mockResolvedValue('No, stay in current session');
+
+		const result = await handler(
+			{ entryId: '1234567890abcdef' },
+			ctx,
+		);
+
+		expect(select).toHaveBeenCalledWith('Fork from entry 12345678?', [
+			'Yes, create fork',
+			'No, stay in current session',
+		]);
+		expect(notify).toHaveBeenCalledWith('Fork cancelled', 'info');
+		expect(result).toEqual({ cancel: true });
+	});
+
+	it('allows forking when confirmed', async () => {
+		const { pi, events } = create_test_pi();
+		await confirm_destructive(pi);
+
+		const handler = events.get('session_before_fork');
+		const { ctx, select, notify } = create_context();
+		select.mockResolvedValue('Yes, create fork');
+
+		const result = await handler(
+			{ entryId: '1234567890abcdef' },
+			ctx,
+		);
+
+		expect(select).toHaveBeenCalledOnce();
+		expect(notify).not.toHaveBeenCalled();
+		expect(result).toBeUndefined();
+	});
+});

package/src/extensions/confirm-destructive.ts

@@ -0,0 +1,61 @@
+// Confirm destructive actions — prompt before clear, switch, or fork
+
+import type {
+	ExtensionAPI,
+	SessionBeforeSwitchEvent,
+	SessionMessageEntry,
+} from '@mariozechner/pi-coding-agent';
+
+export default async function confirm_destructive(pi: ExtensionAPI) {
+	pi.on(
+		'session_before_switch',
+		async (event: SessionBeforeSwitchEvent, ctx) => {
+			if (!ctx.hasUI) return;
+
+			if (event.reason === 'new') {
+				const confirmed = await ctx.ui.confirm(
+					'Clear session?',
+					'This will delete all messages in the current session.',
+				);
+
+				if (!confirmed) {
+					ctx.ui.notify('Clear cancelled', 'info');
+					return { cancel: true };
+				}
+				return;
+			}
+
+			const entries = ctx.sessionManager.getEntries();
+			const has_unsaved_work = entries.some(
+				(e): e is SessionMessageEntry =>
+					e.type === 'message' && e.message.role === 'user',
+			);
+
+			if (has_unsaved_work) {
+				const confirmed = await ctx.ui.confirm(
+					'Switch session?',
+					'You have messages in the current session. Switch anyway?',
+				);
+
+				if (!confirmed) {
+					ctx.ui.notify('Switch cancelled', 'info');
+					return { cancel: true };
+				}
+			}
+		},
+	);
+
+	pi.on('session_before_fork', async (event, ctx) => {
+		if (!ctx.hasUI) return;
+
+		const choice = await ctx.ui.select(
+			`Fork from entry ${event.entryId.slice(0, 8)}?`,
+			['Yes, create fork', 'No, stay in current session'],
+		);
+
+		if (choice !== 'Yes, create fork') {
+			ctx.ui.notify('Fork cancelled', 'info');
+			return { cancel: true };
+		}
+	});
+}

package/src/extensions/extensions.test.ts

@@ -0,0 +1,114 @@
+import type { ExtensionAPI } from '@mariozechner/pi-coding-agent';
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { create_extensions_extension } from './extensions.js';
+
+function create_test_pi() {
+	const commands = new Map<string, any>();
+	const pi = {
+		registerCommand(name: string, definition: any) {
+			commands.set(name, definition);
+		},
+	} as unknown as ExtensionAPI;
+	return { pi, commands };
+}
+
+function create_command_context(options?: { hasUI?: boolean }) {
+	const notifications: Array<{ message: string; level?: string }> =
+		[];
+	let custom_calls = 0;
+	let reload_calls = 0;
+
+	return {
+		ctx: {
+			hasUI: options?.hasUI ?? true,
+			ui: {
+				notify(message: string, level?: string) {
+					notifications.push({ message, level });
+				},
+				async custom() {
+					custom_calls += 1;
+				},
+			},
+			async reload() {
+				reload_calls += 1;
+			},
+		} as any,
+		notifications,
+		get custom_calls() {
+			return custom_calls;
+		},
+		get reload_calls() {
+			return reload_calls;
+		},
+	};
+}
+
+const dirs: string[] = [];
+const original_xdg = process.env.XDG_CONFIG_HOME;
+
+afterEach(() => {
+	for (const dir of dirs.splice(0)) {
+		rmSync(dir, { recursive: true, force: true });
+	}
+	if (original_xdg === undefined) {
+		delete process.env.XDG_CONFIG_HOME;
+	} else {
+		process.env.XDG_CONFIG_HOME = original_xdg;
+	}
+});
+
+describe('extensions command', () => {
+	it.each(['enable', 'disable', 'toggle'])(
+		'opens the interactive manager for /extensions %s with no key in UI mode',
+		async (subcommand) => {
+			const config_home = mkdtempSync(
+				join(tmpdir(), 'my-pi-ext-test-'),
+			);
+			dirs.push(config_home);
+			process.env.XDG_CONFIG_HOME = config_home;
+
+			const { pi, commands } = create_test_pi();
+			await create_extensions_extension()(pi);
+
+			const command = commands.get('extensions');
+			expect(command).toBeTruthy();
+
+			const command_context = create_command_context({ hasUI: true });
+			await command.handler(subcommand, command_context.ctx);
+
+			expect(command_context.custom_calls).toBe(1);
+			expect(command_context.reload_calls).toBe(0);
+			expect(
+				command_context.notifications.some((entry) =>
+					entry.message.includes('Usage: /extensions'),
+				),
+			).toBe(false);
+		},
+	);
+
+	it('keeps the usage warning for /extensions toggle with no key outside UI mode', async () => {
+		const config_home = mkdtempSync(
+			join(tmpdir(), 'my-pi-ext-test-'),
+		);
+		dirs.push(config_home);
+		process.env.XDG_CONFIG_HOME = config_home;
+
+		const { pi, commands } = create_test_pi();
+		await create_extensions_extension()(pi);
+
+		const command = commands.get('extensions');
+		expect(command).toBeTruthy();
+
+		const command_context = create_command_context({ hasUI: false });
+		await command.handler('toggle', command_context.ctx);
+
+		expect(command_context.custom_calls).toBe(0);
+		expect(command_context.notifications).toContainEqual({
+			message: 'Usage: /extensions toggle <key>',
+			level: 'warning',
+		});
+	});
+});