@tekmidian/pai 0.42.5 → 0.43.0

package/dist/daemon-mcp/index.mjs

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
-import { t as PaiClient } from "../ipc-client-BmypMNYk.mjs";
-import { o as loadConfig } from "../config-B64vFg14.mjs";
-import { _ as readWorkersSection, r as MODEL_CAPABILITIES } from "../config-_lQI_W08.mjs";
-import { _ as workersLogDir, m as ledgerPath } from "../server-D4vAieF4.mjs";
-import { C as alive, D as loadStatus, N as ledgerSummary, O as loadStatuses, d as sayToWorker, l as handoffFromInside, n as runWorker, r as testProvider, u as readInbox } from "../run-D7K5UALn.mjs";
-import { t as runChain } from "../chain-DTII7xeL.mjs";
-import { _ as updateProvider, a as addProvider, b as psOutput, c as describeProviders, d as resolveProviderName, f as setClass, g as unsetClass, h as setWorkersEnabled, i as fallbackStatusText, l as modelPrefsText, m as setProviderModel, n as fallbackOn, o as classTargetText, p as setProviderEnabled, r as fallbackStatus, s as describeModels, t as fallbackOff, u as removeProvider, v as useProvider, x as replayOutput } from "../fallback-oJl3BaIN.mjs";
+import "../db-Ddns80yf.mjs";
+import { o as loadConfig } from "../config-DCu8THKi.mjs";
+import { r as MODEL_CAPABILITIES, v as readWorkersSection } from "../config-DxMZjpvY.mjs";
+import { A as loadStatuses, P as setWorkerLabel, S as ledgerSummary, T as alive, d as sayToWorker, k as loadStatus, l as handoffFromInside, n as runWorker, r as testProvider, u as readInbox } from "../run-ByBKowN5.mjs";
+import { t as PaiClient } from "../ipc-client-C6NryMMb.mjs";
+import { _ as workersLogDir, m as ledgerPath } from "../server-Ch99xt5K.mjs";
+import { t as runChain } from "../chain-CEC1a5mX.mjs";
+import { C as readSpecPrompt, _ as updateProvider, a as addProvider, b as psOutput, c as describeProviders, d as resolveProviderName, f as setClass, g as unsetClass, h as setWorkersEnabled, i as fallbackStatusText, l as modelPrefsText, m as setProviderModel, n as fallbackOn, o as classTargetText, p as setProviderEnabled, r as fallbackStatus, s as describeModels, t as fallbackOff, u as removeProvider, v as useProvider, w as resolveSpecPath, x as replayOutput } from "../fallback-BQJ8PbCK.mjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
@@ -3415,79 +3416,35 @@ const meta = meta$1;
 //#region src/daemon-mcp/instructions.ts
 const PAI_INSTRUCTIONS = `## PAI — Personal AI Infrastructure
 
-Federated memory, project registry, session management, and skill workflows.
-
-### PAI-First Search Protocol
-
-Before answering questions about past work, decisions, people, or project status:
-use memory_search. Use project_detect at session start to identify the current project.
-
-### Session Commands
-
-- go / continue / weiter → read TODO.md, look for ## Continue section, resume from there
-- pause session → summarize state, update TODO.md with ## Continue section at top, stop
-- end session → pause procedure + rename session note (NEVER leave as "New Session")
-- cpp → git add . && git commit -m "type: ..." && git push (no AI signatures)
-
-### Response Modes
-
-Classify every request before responding:
-- MINIMAL: greetings, acks, simple yes/no → 1-3 sentences, no structure
-- STANDARD: single-step tasks, quick lookups → direct answer only
-- FULL: multi-step work, research, implementation → SUMMARY / ANALYSIS / ACTIONS / RESULTS / STATUS / NEXT / COMPLETED
-
-### Skill Routing
-
-Fetch the full skill instructions with: prompts/get { name: "<skill-name>" }
-
-| When user says | Fetch prompt |
-|----------------|--------------|
-| review, weekly review, what did I do, recap | review |
-| journal, note to self, capture this thought | journal |
-| plan, what should I focus on, priorities | plan |
-| share on linkedin, post about, tweet this | share |
-| list sessions, where was I working | sessions |
-| route, what project is this | route |
-| search history, find past, when did we | search-history |
-| /name, name this session | name |
-| observability, monitor agents, show dashboard | observability |
-| research, extract wisdom, analyze content | research |
-| visualize, create diagram, flowchart, image | art |
-| create skill, validate skill, update skill | createskill |
-| /story, story explanation, explain as story | story-explanation |
-| load vault context, morning briefing | vault-context |
-| connect X and Y, how does X relate to Y | vault-connect |
-| what's emerging, find patterns in vault | vault-emerge |
-| find orphans, orphaned notes | vault-orphans |
-| trace idea, how did X evolve | vault-trace |
-| run a worker, check workers, worker providers | worker |
-
-### Reference Resources
-
-Fetch with: resources/read { uri: "pai://<name>" }
-
-| Resource | URI |
-|----------|-----|
-| Aesthetic guide (visual style) | pai://aesthetic |
-| Constitution (philosophy, architecture, directory structure) | pai://constitution |
-| Prompt engineering standards | pai://prompting |
-| Voice prosody guide | pai://prosody-guide |
-| Prosody agent template | pai://prosody-agent-template |
-| Voice system reference | pai://voice |
-| Skill system spec (TitleCase, SKILL.md structure) | pai://skill-system |
-| Hook system reference (events, patterns) | pai://hook-system |
-| History system — UOCS (capture, directories) | pai://history-system |
-| Terminal tab title system | pai://terminal-tabs |
-| MCP development guide (three-tier architecture) | pai://mcp-dev-guide |
-
-### Core Rules
-
-- Git commits: NO AI signatures, NO Co-Authored-By lines, format: type: description
-- Stack: TypeScript > Python, bun for JS/TS, uv for Python
-- Security: run git remote -v before every push; never commit private data
-- Fact-checking: mark unverified AI claims with ⚠️ Unverified
-- History lookup: search \${PAI_DIR}/History/ before answering about past work
-- WhatsApp routing: [Whazaa] prefix → reply via whatsapp_send; [Whazaa:voice] → whatsapp_tts
+Federated memory, project registry, session management, skills.
+
+### Search first
+
+Before answering about past work, decisions, people, or project status: use memory_search.
+Run project_detect at session start.
+
+### Session commands
+
+- go / continue / weiter → read TODO.md "## Continue" section, resume there
+- pause session → update TODO.md "## Continue" section, stop
+- end session → pause procedure + rename session note (never leave as "New Session")
+- cpp → release order is in CLAUDE.md
+
+### Skills
+
+Fetch full instructions with prompts/get { name }. Skills are already listed with USE WHEN descriptions.
+
+### Reference resources
+
+Fetch with resources/read { uri }. Available: pai://aesthetic, pai://constitution, pai://prompting,
+pai://prosody-guide, pai://prosody-agent-template, pai://voice, pai://skill-system, pai://hook-system,
+pai://history-system, pai://terminal-tabs, pai://mcp-dev-guide
+
+### Core rules
+
+Git: no AI signatures, commit format "type: description", run git remote -v before pushing, never commit
+private data. Stack: TypeScript > Python (bun/uv). Mark unverified AI claims with ⚠️ Unverified.
+WhatsApp: [Whazaa] → whatsapp_send; [Whazaa:voice] → whatsapp_tts.
 `;
 
 //#endregion
@@ -3882,7 +3839,7 @@ USE WHEN user says 'load vault context', 'brief me from Obsidian', 'morning brie
 
 Reads: daily note → open TODOs → PAI index (active projects) → HOME.md (focus areas) → recent insights. Synthesizes into morning briefing with Suggested First Action.
 
-All vault skills work with the vault configured in \`~/.config/pai/config.json\` (\`vaultPath\` key).`
+All vault skills work with the vault configured in \`~/.claude/pai/config.json\` (\`vaultPath\` key).`
 };
 
 //#endregion
@@ -4178,7 +4135,7 @@ For each reconstructed note, call \`kg_add\` to store key facts. Examples of fac
 - Maximum **15 triples per note** — pick the most important.
 - Never invent project names, versions, or paths. Copy them verbatim.
 
-**Alternative (batch mode):** If reconstructing many notes at once, instead of calling \`kg_add\` interactively you may run \`pai kg backfill --project <slug>\` from the terminal after the notes are written. The backfill walks every note in \`Notes/YYYY/MM/\`, runs the same extractor the session-summary-worker uses, and is idempotent (state file at \`~/.config/pai/kg-backfill-state.json\`).
+**Alternative (batch mode):** If reconstructing many notes at once, instead of calling \`kg_add\` interactively you may run \`pai kg backfill --project <slug>\` from the terminal after the notes are written. The backfill walks every note in \`Notes/YYYY/MM/\`, runs the same extractor the session-summary-worker uses, and is idempotent (state file at \`~/.claude/pai/kg-backfill-state.json\`).
 
 After extraction, append a one-line note to the summary output:
 \`\`\`
@@ -4208,7 +4165,7 @@ USE WHEN user says 'whisper', 'add whisper rule', 'remove whisper rule', 'list w
 
 Manage the rules that PAI injects into every prompt via the whisper-rules hook.
 
-Rules are stored in \`~/.claude/whisper-rules.md\` — one rule per line, plain text.
+Rules are stored in \`~/.claude/pai/whisper-rules.md\` — one rule per line, plain text.
 The hook reads this file on every UserPromptSubmit and injects it as a \`<system-reminder>\`.
 Rules survive compaction, /clear, and session restarts.
 
@@ -4223,11 +4180,11 @@ Rules survive compaction, /clear, and session restarts.
 ### Workflow
 
 **Show current rules:**
-Read \`~/.claude/whisper-rules.md\` and display each rule with a line number.
+Read \`~/.claude/pai/whisper-rules.md\` and display each rule with a line number.
 If the file doesn't exist, say "No whisper rules configured."
 
 **Add a rule:**
-Append the rule as a new line to \`~/.claude/whisper-rules.md\`.
+Append the rule as a new line to \`~/.claude/pai/whisper-rules.md\`.
 Create the file if it doesn't exist.
 Do NOT add duplicate rules — check if a similar rule already exists.
 
@@ -4357,13 +4314,13 @@ ALSO USE WHEN user says plain-language budget/mode phrases like:
 - "go full power", "use whatever model", "no budget constraints", "normal mode", "unrestricted" → set mode to normal
 - "back to auto", "reset advisor", "let the budget decide" → set mode to auto
 
-When you detect these, write the appropriate mode to \`~/.claude/advisor-mode.json\` and confirm what you did.
+When you detect these, write the appropriate mode to \`~/.claude/pai/advisor-mode.json\` and confirm what you did.
 
 Advisor mode controls which models subagents use, based on weekly budget consumption.
 
 ### Configuration
 
-The config file is at \`~/.claude/advisor-mode.json\`:
+The config file is at \`~/.claude/pai/advisor-mode.json\`:
 \`\`\`json
 {
   "weeklyBudgetPercent": 90,
@@ -4393,7 +4350,7 @@ The config file is at \`~/.claude/advisor-mode.json\`:
 ### Workflow
 
 **Show current status:**
-Read \`~/.claude/advisor-mode.json\`. Display the mode, budget percentage, and what model constraints are active.
+Read \`~/.claude/pai/advisor-mode.json\`. Display the mode, budget percentage, and what model constraints are active.
 
 **Update budget percentage:**
 The user reads their weekly budget from the statusline (e.g., "7d: 63% → Fr. 08:00").
@@ -4595,7 +4552,7 @@ pai worker run --label "short task label" --class research \\
 - \`worker_status\` — on/off, active provider, providers, run tally.
 - \`worker_providers\` — list/add/update/remove/use/enable/disable/test. Adding
   needs name, base_url, model and a key (key file path, or a raw key which is
-  parked in ~/.config/pai/keys/<name>, mode 0600). update changes cost_tier
+  parked in ~/.claude/pai/keys/<name>, mode 0600). update changes cost_tier
   (1 cheapest … 5 most expensive) and tags (code, vision, image-gen,
   long-context, fast, reasoning).
 - \`worker_classes\` — list/set/unset class → provider[/<capability>], or constraints
@@ -4634,6 +4591,37 @@ pai worker run --label "short task label" --class research \\
 - Never tell the user to edit a config file — the tools do it.`
 };
 
+//#endregion
+//#region src/daemon-mcp/prompts/providers.ts
+const providers = {
+	description: "List every configured provider and model, mark the one this session runs on, and explain how to switch",
+	content: `## Providers Skill
+
+USE WHEN user says /providers, /models, /provider, what providers exist, which models are configured, show providers, what model this session is on, switch provider, OR asks which provider or model this session or the harness is currently running on.
+
+### The constraint that matters
+
+A running \`claude\` process cannot switch provider — its base URL and auth are fixed for the life of the process. Claude Code's own \`/model\` command only ever lists the models of whatever endpoint THIS process was started against (plain Anthropic if started plainly, a provider's models if started through it). Switching provider always means starting a NEW session, with \`pai launch\`.
+
+### Procedure
+
+1. Run:
+
+   \`\`\`bash
+   pai launch --list --current
+   \`\`\`
+
+2. Print its output to the user **verbatim** — it already lists every enabled provider (built-in \`anthropic\` first) with its default/fast/image models, numbered, marks the workers.yaml \`active\` provider, marks the row matching THIS session own provider/model when it can be determined (falls back to (session default) rather than guessing), and ends with a line explaining how to switch.
+
+3. Do not add a summary of the table — the command output is the answer.
+
+### Notes
+
+- Provider/model detection is env-based (\`ANTHROPIC_BASE_URL\` against workers.yaml, and \`ANTHROPIC_DEFAULT_SONNET_MODEL\` when set) — a best-effort read of THIS process own environment, not a live API call.
+- To actually start on a different provider: \`pai launch --provider <name> --model <model>\` (model defaults to that provider default). \`pai launch\` alone, in a terminal, offers a numbered picker instead.
+- \`pai worker providers\` is the config-management surface (add, remove, enable, disable, use) — this skill is read-only, for what is configured and what this session is on.`
+};
+
 //#endregion
 //#region src/daemon-mcp/resources/aesthetic.ts
 const aesthetic = {
@@ -4700,7 +4688,7 @@ The foundational philosophy, architecture, and operations of PAI (Personal AI In
 4. **Skills as Containers** — Each skill is a self-contained unit with SKILL.md, workflows/, and tools/.
 5. **CLI-First** — Every capability should be accessible from the command line before being wrapped in prompts.
 6. **Two-Tier MCP** — Thin routing shim (daemon-mcp) + full capability daemon. Never merge them.
-7. **History as Memory** — All work is captured automatically to \${PAI_DIR}/History/. Work normally, docs handle themselves.
+7. **History as Memory** — All work is captured automatically to \${PAI_HOME}/History/. Work normally, docs handle themselves.
 8. **Fail Gracefully** — Hooks and automations must never block the AI. Always exit 0.
 
 ## Architecture Layers
@@ -4720,8 +4708,8 @@ User
 |-----------|----------|---------|
 | Memory | \${PAI_DIR}/projects/*/Notes/ | Session notes, todos |
 | Skills | ~/.claude/Skills/ | Workflow instructions |
-| History | \${PAI_DIR}/History/ | Automated capture |
-| Config | ~/.config/pai/ | Agent preferences, voices |
+| History | \${PAI_HOME}/History/ | Automated capture |
+| Config | ~/.claude/pai/ | Agent preferences (config.json, workers.yaml) |
 
 ## Two-Tier MCP Strategy
 
@@ -5117,7 +5105,7 @@ Automated documentation of ALL work performed by PAI and specialized agents.
 ## Directory Structure
 
 \`\`\`
-\${PAI_DIR}/History/
+\${PAI_HOME}/History/
 ├── Sessions/YYYY-MM/          # Session summaries
 ├── Learnings/YYYY-MM/         # Problem-solving narratives
 ├── Research/YYYY-MM/          # Investigation reports
@@ -5146,13 +5134,13 @@ YYYY-MM-DD-HHMMSS_[PROJECT]_[TYPE]_[HIERARCHY]_[DESCRIPTION].md
 
 \`\`\`bash
 # Quick keyword search
-rg -i "keyword" \${PAI_DIR}/History/
+rg -i "keyword" \${PAI_HOME}/History/
 
 # Search sessions
-rg -i "keyword" \${PAI_DIR}/History/sessions/
+rg -i "keyword" \${PAI_HOME}/History/sessions/
 
 # Recent files
-ls -lt \${PAI_DIR}/History/sessions/\$(date +%Y-%m)/ | head -20
+ls -lt \${PAI_HOME}/History/sessions/\$(date +%Y-%m)/ | head -20
 \`\`\`
 `
 };
@@ -5442,6 +5430,37 @@ At 200 message sessions, that is 1.3MB of context saved — equivalent to 5-10 e
 `
 };
 
+//#endregion
+//#region src/daemon-mcp/tools/worker-run-args.ts
+/**
+* worker_run's input schema and prompt resolution, extracted so both can be
+* imported and tested without starting the shim's stdio transport.
+*/
+const workerRunShape = {
+	prompt: string().min(1).optional().describe("The task (the -p value). Mutually exclusive with specPath."),
+	specPath: string().min(1).optional().describe("Path to a file (or \"-\" for stdin) whose contents become the prompt. Mutually exclusive with prompt."),
+	chain: string().optional().describe("Comma-separated stages, e.g. draft,implement or draft,implement,review."),
+	class: string().optional().describe("Task class (draft, implement, review, research, spotcheck, simple, complex, image)."),
+	label: string().min(1).describe("Short task label shown in worker_ps / the status line and worker pane."),
+	cwd: string().optional().describe("Working directory (default: here)."),
+	allowed_tools: string().optional().describe("Comma-separated tool allowlist passed to the worker."),
+	mcp: string().optional().describe("MCP servers/sets the worker may use (comma-separated).")
+};
+/**
+* The prompt text and resolved --spec path (for status recording) a
+* worker_run call resolves to. Throws when prompt/specPath are both given or
+* both missing (mutually exclusive, exactly one required) — the same rule
+* `pai worker run` enforces between -p and --spec.
+*/
+function resolveWorkerRunPrompt(args, cwd) {
+	if (Boolean(args.prompt) === Boolean(args.specPath)) throw new Error("exactly one of prompt or specPath is required (they are mutually exclusive)");
+	if (args.specPath) return {
+		promptText: readSpecPrompt(args.specPath, cwd),
+		specPath: resolveSpecPath(args.specPath, cwd)
+	};
+	return { promptText: args.prompt };
+}
+
 //#endregion
 //#region src/daemon-mcp/tools/worker-model.ts
 /**
@@ -5569,7 +5588,8 @@ async function startShim() {
 		"consolidate": consolidate,
 		"advisor": advisor,
 		"tasks": tasks,
-		"worker": worker
+		"worker": worker,
+		"providers": providers
 	};
 	for (const [promptName, skill] of Object.entries(SKILL_PROMPTS)) server.prompt(promptName, skill.description, () => ({ messages: [{
 		role: "user",
@@ -5616,7 +5636,7 @@ async function startShim() {
 		"",
 		"Recency boost optionally down-weights older results (recency_boost=90 means scores halve every 90 days).",
 		"",
-		"Defaults come from ~/.config/pai/config.json (search section). Per-call parameters override config defaults.",
+		"Defaults come from ~/.claude/pai/config.json (search section). Per-call parameters override config defaults.",
 		"",
 		"Returns ranked snippets with project slug, file path, line range, and score.",
 		"Higher score = more relevant.",
@@ -5877,7 +5897,7 @@ async function startShim() {
 		"action=add needs name, model — and either key_file or key, plus:",
 		"  base_url (anthropic protocol) or upstream_url (protocol=openai, runs",
 		"  through the local PAI proxy). A raw key is written to",
-		"  ~/.config/pai/keys/<name> (mode 0600); only the path lands in the config.",
+		"  ~/.claude/pai/keys/<name> (mode 0600); only the path lands in the config.",
 		"  engine=codex runs the Codex CLI instead of Claude Code.",
 		"action=update changes cost_tier / tags of an existing provider.",
 		"action=test runs a one-word pong probe through the provider",
@@ -5900,7 +5920,7 @@ async function startShim() {
 		engine: _enum(["claude", "codex"]).optional().describe("Runner engine (add). Default: claude."),
 		context_window: number().int().positive().optional().describe("Context window for the meter (add). No default: unset hides the meter unless the init event announces one."),
 		key_file: string().optional().describe("File holding the API token, 0600 (add)."),
-		key: string().optional().describe("Raw API token (add) — parked in ~/.config/pai/keys/<name>."),
+		key: string().optional().describe("Raw API token (add) — parked in ~/.claude/pai/keys/<name>."),
 		model: string().optional().describe("Default model id (add)."),
 		fast_model: string().optional().describe("Cheaper model for spotchecks (add, optional)."),
 		env: record(string(), string()).optional().describe("Extra env for runs (add, optional)."),
@@ -6077,23 +6097,25 @@ async function startShim() {
 	server.tool("worker_run", [
 		"Start a worker (or a chain) and return its id immediately.",
 		"",
-		"This is the chat-side face of `pai worker run`: prompt is required,",
-		"chain (e.g. \"draft,implement\") runs spec-first stages, class picks the",
-		"provider (default: active). Check on it with worker_ps / worker_replay,",
-		"talk to it with worker_say."
-	].join("\n"), {
-		prompt: string().min(1).describe("The task (the -p value)."),
-		chain: string().optional().describe("Comma-separated stages, e.g. draft,implement or draft,implement,review."),
-		class: string().optional().describe("Task class (draft, implement, review, research, spotcheck, simple, complex, image)."),
-		label: string().optional().describe("Short task label shown in worker_ps."),
-		cwd: string().optional().describe("Working directory (default: here)."),
-		allowed_tools: string().optional().describe("Comma-separated tool allowlist passed to the worker."),
-		mcp: string().optional().describe("MCP servers/sets the worker may use (comma-separated).")
-	}, async (args) => {
+		"This is the chat-side face of `pai worker run`: label is required, and",
+		"exactly one of prompt/specPath (the -p value, or a file/stdin '-' to read",
+		"it from — avoids quoting long prompts through JSON-RPC). chain (e.g.",
+		"\"draft,implement\") runs spec-first stages, class picks the provider",
+		"(default: active). Check on it with worker_ps / worker_replay, talk to",
+		"it with worker_say."
+	].join("\n"), workerRunShape, async (args) => {
 		try {
+			const cwd = args.cwd ?? process.cwd();
+			let promptText;
+			let specPath;
+			try {
+				({promptText, specPath} = resolveWorkerRunPrompt(args, cwd));
+			} catch (e) {
+				return workerError(e);
+			}
 			const claudeArgs = [
 				"-p",
-				args.prompt,
+				promptText,
 				...args.allowed_tools ? ["--allowedTools", args.allowed_tools] : []
 			];
 			let startedIdResolve;
@@ -6108,7 +6130,8 @@ async function startShim() {
 					label: args.label,
 					noPane: false,
 					mcpFlag: args.mcp,
-					brief: args.prompt,
+					specPath,
+					brief: promptText,
 					claudeArgs,
 					...args.cwd ? { cwd: args.cwd } : {},
 					onChainStart: (id) => startedIdResolve(id),
@@ -6119,6 +6142,7 @@ async function startShim() {
 					label: args.label,
 					noPane: false,
 					mcpFlag: args.mcp,
+					specPath,
 					claudeArgs,
 					...args.cwd ? { cwd: args.cwd } : {},
 					onWorkerStart: (wid) => startedIdResolve(wid),
@@ -6210,11 +6234,14 @@ async function startShim() {
 		"worker_resume (or `pai worker resume <id> \"text\"`) instead."
 	].join("\n"), {
 		id: string().describe("Worker id (as shown by worker_ps)."),
-		text: string().min(1).describe("The message to send (one line).")
+		text: string().min(1).describe("The message to send (one line)."),
+		goal: string().optional().describe("Relabel the worker (its ps / pane goal) before sending the message.")
 	}, async (args) => {
 		try {
 			const { workers } = readWorkersSection();
-			await sayToWorker(workersLogDir(workers), args.id, args.text);
+			const logDir = workersLogDir(workers);
+			if (args.goal !== void 0) setWorkerLabel(logDir, args.id, args.goal);
+			await sayToWorker(logDir, args.id, args.text);
 			return workerText(`sent to ${args.id}`);
 		} catch (e) {
 			return workerError(e);