@docyrus/docyrus 0.0.62 → 0.0.64

package/main.js

@@ -18864,7 +18864,7 @@ var require_core3 = __commonJS({
       return match && match.index === 0;
     }
     var BACKREF_RE = /\[(?:[^\\\]]|\\.)*\]|\(\??|\\([1-9][0-9]*)|\\./;
-    function join18(regexps, separator = "|") {
+    function join19(regexps, separator = "|") {
       let numCaptures = 0;
       return regexps.map((regex) => {
         numCaptures += 1;
@@ -19168,7 +19168,7 @@ var require_core3 = __commonJS({
             this.exec = () => null;
           }
           const terminators = this.regexes.map((el) => el[1]);
-          this.matcherRe = langRe(join18(terminators), true);
+          this.matcherRe = langRe(join19(terminators), true);
           this.lastIndex = 0;
         }
         /** @param {string} s */
@@ -85749,9 +85749,9 @@ var init_lib10 = __esm({
        * @returns {undefined}
        *   Nothing.
        */
-      set dirname(dirname13) {
+      set dirname(dirname14) {
         assertPath(this.basename, "dirname");
-        this.path = import_node_path7.default.join(dirname13 || "", this.basename);
+        this.path = import_node_path7.default.join(dirname14 || "", this.basename);
       }
       /**
        * Get the extname (including dot) (example: `'.js'`).
@@ -102181,8 +102181,8 @@ var require_snapshot_utils = __commonJS({
 var require_snapshot_recorder = __commonJS({
   "../../node_modules/.pnpm/undici@7.24.7/node_modules/undici/lib/mock/snapshot-recorder.js"(exports2, module2) {
     "use strict";
-    var { writeFile: writeFile9, readFile: readFile17, mkdir: mkdir10 } = require("node:fs/promises");
-    var { dirname: dirname13, resolve: resolve2 } = require("node:path");
+    var { writeFile: writeFile10, readFile: readFile18, mkdir: mkdir11 } = require("node:fs/promises");
+    var { dirname: dirname14, resolve: resolve2 } = require("node:path");
     var { setTimeout: setTimeout2, clearTimeout: clearTimeout2 } = require("node:timers");
     var { InvalidArgumentError, UndiciError } = require_errors3();
     var { hashId, isUrlExcludedFactory, normalizeHeaders, createHeaderFilters } = require_snapshot_utils();
@@ -102383,7 +102383,7 @@ var require_snapshot_recorder = __commonJS({
           throw new InvalidArgumentError("Snapshot path is required");
         }
         try {
-          const data = await readFile17(resolve2(path8), "utf8");
+          const data = await readFile18(resolve2(path8), "utf8");
           const parsed = JSON.parse(data);
           if (Array.isArray(parsed)) {
             this.#snapshots.clear();
@@ -102413,12 +102413,12 @@ var require_snapshot_recorder = __commonJS({
           throw new InvalidArgumentError("Snapshot path is required");
         }
         const resolvedPath = resolve2(path8);
-        await mkdir10(dirname13(resolvedPath), { recursive: true });
+        await mkdir11(dirname14(resolvedPath), { recursive: true });
         const data = Array.from(this.#snapshots.entries()).map(([hash3, snapshot]) => ({
           hash: hash3,
           snapshot
         }));
-        await writeFile9(resolvedPath, JSON.stringify(data, null, 2), { flush: true });
+        await writeFile10(resolvedPath, JSON.stringify(data, null, 2), { flush: true });
       }
       /**
        * Clears all recorded snapshots
@@ -139349,7 +139349,7 @@ function buildInputSchema(args2, env2, options2) {
 // package.json
 var package_default = {
   name: "@docyrus/docyrus",
-  version: "0.0.62",
+  version: "0.0.64",
   private: false,
   description: "Docyrus API CLI",
   main: "./main.js",
@@ -139423,7 +139423,8 @@ var EnvironmentConfigStateSchema = external_exports.object({
   version: external_exports.literal(1),
   activeEnvironmentId: external_exports.string().min(1),
   environments: external_exports.array(EnvironmentConfigItemSchema).min(1),
-  defaultClientId: external_exports.string().min(1).optional()
+  defaultClientId: external_exports.string().min(1).optional(),
+  activeSoulId: external_exports.string().min(1).optional()
 });
 var LegacyAuthSessionSchema = external_exports.object({
   apiBaseUrl: external_exports.string().min(1),
@@ -140782,12 +140783,12 @@ function summarizeFailure(result) {
 }
 function resolveBrowserToolsResourceRoot(options2 = {}) {
   const cwd = options2.cwd ?? process.cwd();
-  const dirname13 = options2.dirname ?? __dirname;
+  const dirname14 = options2.dirname ?? __dirname;
   const fileExists = options2.existsSyncFn ?? import_node_fs3.existsSync;
   const candidates = options2.candidatePaths ?? [
     (0, import_node_path4.resolve)(cwd, "apps/api-cli/resources/browser-tools"),
-    (0, import_node_path4.resolve)(dirname13, "../resources/browser-tools"),
-    (0, import_node_path4.resolve)(dirname13, "resources/browser-tools"),
+    (0, import_node_path4.resolve)(dirname14, "../resources/browser-tools"),
+    (0, import_node_path4.resolve)(dirname14, "resources/browser-tools"),
     (0, import_node_path4.resolve)(cwd, "dist/apps/api-cli/resources/browser-tools")
   ];
   const resolved = candidates.find((candidate) => fileExists(candidate));
@@ -152537,16 +152538,16 @@ function resolveCliScriptPath() {
 }
 function resolveOpenTuiEntryPath(options2 = {}) {
   const cwd = options2.cwd ?? process.cwd();
-  const dirname13 = options2.dirname ?? __dirname;
+  const dirname14 = options2.dirname ?? __dirname;
   const fileExists = options2.existsSyncFn ?? import_node_fs16.existsSync;
   const candidates = [
     // Source/dev mode in monorepo. Prefer this first so Bun resolves deps via
     // apps/api-cli/node_modules in workspace runs (e.g. `pnpm docyrus tui`).
     (0, import_node_path25.resolve)(cwd, "apps/api-cli/src/tui/opentuiMain.tsx"),
-    (0, import_node_path25.resolve)(dirname13, "../tui/opentuiMain.tsx"),
+    (0, import_node_path25.resolve)(dirname14, "../tui/opentuiMain.tsx"),
     // Dist mode (bundled command runtime)
-    (0, import_node_path25.resolve)(dirname13, "tui.mjs"),
-    (0, import_node_path25.resolve)(dirname13, "../tui.mjs"),
+    (0, import_node_path25.resolve)(dirname14, "tui.mjs"),
+    (0, import_node_path25.resolve)(dirname14, "../tui.mjs"),
     (0, import_node_path25.resolve)(cwd, "dist/apps/api-cli/tui.mjs")
   ];
   const resolved = candidates.find((candidate) => fileExists(candidate));
@@ -153641,6 +153642,76 @@ var AuthStore = class {
 // src/services/environmentConfig.ts
 var import_promises21 = require("node:fs/promises");
 var import_node_path27 = require("node:path");
+
+// resources/pi-agent/souls/catalog.ts
+var DEFAULT_SOUL_ID = "default";
+var SOULS = [
+  {
+    id: "default",
+    name: "Default",
+    description: "Standard Docyrus operator voice. No style overlay.",
+    promptFile: null
+  },
+  {
+    id: "caveman",
+    name: "Caveman",
+    description: "Short grunts. Agent talk simple. Fire good.",
+    promptFile: "caveman.md"
+  },
+  {
+    id: "boomer-parent",
+    name: "Boomer Parent",
+    description: "Overly proud dad-jokes energy with 'back in my day' asides.",
+    promptFile: "boomer-parent.md"
+  },
+  {
+    id: "master-yoda",
+    name: "Master Yoda",
+    description: "Inverted syntax the agent speaks. Mystical brevity, hmm.",
+    promptFile: "master-yoda.md"
+  },
+  {
+    id: "bro",
+    name: "Bro",
+    description: "Pure gym-bro hype energy. 'Lit, fam, let's go.'",
+    promptFile: "bro.md"
+  },
+  {
+    id: "nonsense-engineer",
+    name: "Nonsense Engineer",
+    description: "Maximum jargon, minimum meaning. 'Leveraging synergistic abstractions.'",
+    promptFile: "nonsense-engineer.md"
+  },
+  {
+    id: "shakespeare",
+    name: "Shakespeare",
+    description: "Thee/thou, dramatic flair, iambic vibes.",
+    promptFile: "shakespeare.md"
+  },
+  {
+    id: "noir-detective",
+    name: "Noir Detective",
+    description: "Hard-boiled 1940s narrator. Every bug is a dame.",
+    promptFile: "noir-detective.md"
+  },
+  {
+    id: "pirate",
+    name: "Pirate",
+    description: "Aye matey, every task a seafaring metaphor, arrr.",
+    promptFile: "pirate.md"
+  },
+  {
+    id: "linkedin-influencer",
+    name: "LinkedIn Influencer",
+    description: "Every reply is a mini-post. Single-sentence paragraphs. Humble-brags. 'Agree? \u{1F447}'",
+    promptFile: "linkedin-influencer.md"
+  }
+];
+function findSoul(id) {
+  return SOULS.find((soul) => soul.id === id);
+}
+
+// src/services/environmentConfig.ts
 var ENVIRONMENT_ID_ALIASES = {
   "local-development": "dev",
   prod: "live"
@@ -153664,9 +153735,20 @@ function createDefaultState3() {
       name: environment.name,
       apiBaseUrl: environment.apiBaseUrl
     })),
-    defaultClientId: void 0
+    defaultClientId: void 0,
+    activeSoulId: DEFAULT_SOUL_ID
   };
 }
+function normalizeSoulId(value2) {
+  if (!value2) {
+    return DEFAULT_SOUL_ID;
+  }
+  const trimmed = value2.trim();
+  if (!trimmed) {
+    return DEFAULT_SOUL_ID;
+  }
+  return findSoul(trimmed) ? trimmed : DEFAULT_SOUL_ID;
+}
 function normalizeState3(state) {
   const defaultsById = new Map(
     DEFAULT_ENVIRONMENTS.map((environment) => [
@@ -153717,7 +153799,8 @@ function normalizeState3(state) {
     version: 1,
     activeEnvironmentId: hasActiveEnvironment ? canonicalActiveEnvironmentId : fallbackActiveEnvironment,
     environments,
-    defaultClientId: state.defaultClientId?.trim() || void 0
+    defaultClientId: state.defaultClientId?.trim() || void 0,
+    activeSoulId: normalizeSoulId(state.activeSoulId)
   };
 }
 var EnvironmentConfigService = class {
@@ -153822,6 +153905,25 @@ var EnvironmentConfigService = class {
       defaultClientId: trimmedClientId
     });
   }
+  async getActiveSoulId() {
+    const state = await this.#readStateWithDefaults();
+    return normalizeSoulId(state.activeSoulId);
+  }
+  async setActiveSoulId(soulId) {
+    const trimmed = soulId.trim();
+    if (!trimmed) {
+      throw new UserInputError("Soul ID cannot be empty.");
+    }
+    if (!findSoul(trimmed)) {
+      throw new UserInputError(`Unknown soul '${soulId}'. Use /souls inside the pi agent or GET /api/souls to view options.`);
+    }
+    const state = await this.#readStateWithDefaults();
+    await this.writeState({
+      ...state,
+      activeSoulId: trimmed
+    });
+    return trimmed;
+  }
   async #readStateWithDefaults() {
     const state = await this.readState();
     if (state.environments.length > 0) {
@@ -153839,8 +153941,51 @@ var EnvironmentConfigService = class {
 // src/services/piAgentLauncher.ts
 var import_node_child_process8 = require("node:child_process");
 var import_node_fs17 = require("node:fs");
+var import_promises23 = require("node:fs/promises");
+var import_node_path29 = require("node:path");
+
+// src/services/soulRegistry.ts
 var import_promises22 = require("node:fs/promises");
 var import_node_path28 = require("node:path");
+function resolveBasePromptPath(params) {
+  const filename = params.profile === "agent" ? "agent-system.md" : "coder-system.md";
+  return (0, import_node_path28.join)(params.resourceRoot, "prompts", filename);
+}
+async function composeSystemPrompt(params) {
+  const soul = findSoul(params.soulId) ?? findSoul(DEFAULT_SOUL_ID);
+  if (!soul) {
+    throw new Error(`Soul catalog is missing the '${DEFAULT_SOUL_ID}' entry.`);
+  }
+  const basePromptPath = resolveBasePromptPath({
+    resourceRoot: params.resourceRoot,
+    profile: params.profile
+  });
+  if (!soul.promptFile) {
+    return basePromptPath;
+  }
+  const overlayPath = (0, import_node_path28.join)(params.resourceRoot, "souls", soul.promptFile);
+  const [basePrompt, overlayPrompt] = await Promise.all([
+    (0, import_promises22.readFile)(basePromptPath, "utf8"),
+    (0, import_promises22.readFile)(overlayPath, "utf8")
+  ]);
+  const composedPath = (0, import_node_path28.join)(params.agentRootPath, `system-prompt-${params.profile}.md`);
+  const composed = `${basePrompt.trimEnd()}
+
+---
+
+${overlayPrompt.trimEnd()}
+`;
+  await (0, import_promises22.mkdir)((0, import_node_path28.dirname)(composedPath), {
+    recursive: true,
+    mode: 448
+  });
+  await (0, import_promises22.writeFile)(composedPath, composed, {
+    encoding: "utf8",
+    mode: 384
+  });
+  await (0, import_promises22.chmod)(composedPath, 384);
+  return composedPath;
+}
 
 // src/services/spinner.ts
 var import_picocolors2 = __toESM(require_picocolors());
@@ -153902,13 +154047,13 @@ function summarizeFailure3(result, commandLabel = "Command") {
 }
 function resolvePackagedPiResourceRoot(options2 = {}) {
   const cwd = options2.cwd ?? process.cwd();
-  const dirname13 = options2.dirname ?? __dirname;
+  const dirname14 = options2.dirname ?? __dirname;
   const fileExists = options2.existsSyncFn ?? import_node_fs17.existsSync;
   const candidates = [
-    (0, import_node_path28.resolve)(cwd, "apps/api-cli/resources/pi-agent"),
-    (0, import_node_path28.resolve)(dirname13, "../resources/pi-agent"),
-    (0, import_node_path28.resolve)(dirname13, "resources/pi-agent"),
-    (0, import_node_path28.resolve)(cwd, "dist/apps/api-cli/resources/pi-agent")
+    (0, import_node_path29.resolve)(cwd, "apps/api-cli/resources/pi-agent"),
+    (0, import_node_path29.resolve)(dirname14, "../resources/pi-agent"),
+    (0, import_node_path29.resolve)(dirname14, "resources/pi-agent"),
+    (0, import_node_path29.resolve)(cwd, "dist/apps/api-cli/resources/pi-agent")
   ];
   const resolved = candidates.find((candidate) => fileExists(candidate));
   if (!resolved) {
@@ -153918,7 +154063,7 @@ function resolvePackagedPiResourceRoot(options2 = {}) {
 }
 function resolveDocyrusPiLoaderEntryPath(options2 = {}) {
   const cwd = options2.cwd ?? process.cwd();
-  const dirname13 = options2.dirname ?? __dirname;
+  const dirname14 = options2.dirname ?? __dirname;
   const fileExists = options2.existsSyncFn ?? import_node_fs17.existsSync;
   const seen = /* @__PURE__ */ new Set();
   const candidates = options2.candidatePaths ?? [];
@@ -153929,25 +154074,25 @@ function resolveDocyrusPiLoaderEntryPath(options2 = {}) {
     }
   };
   const collectAncestorCandidates = (startDir) => {
-    let currentDir = (0, import_node_path28.resolve)(startDir);
+    let currentDir = (0, import_node_path29.resolve)(startDir);
     while (true) {
-      addCandidate((0, import_node_path28.join)(currentDir, "dist", "apps", "api-cli", "agent-loader.js"));
-      addCandidate((0, import_node_path28.join)(currentDir, "agent-loader.js"));
-      if ((0, import_node_path28.basename)(currentDir) === "dist") {
-        addCandidate((0, import_node_path28.join)(currentDir, "apps", "api-cli", "agent-loader.js"));
+      addCandidate((0, import_node_path29.join)(currentDir, "dist", "apps", "api-cli", "agent-loader.js"));
+      addCandidate((0, import_node_path29.join)(currentDir, "agent-loader.js"));
+      if ((0, import_node_path29.basename)(currentDir) === "dist") {
+        addCandidate((0, import_node_path29.join)(currentDir, "apps", "api-cli", "agent-loader.js"));
       }
-      const parentDir = (0, import_node_path28.resolve)(currentDir, "..");
+      const parentDir = (0, import_node_path29.resolve)(currentDir, "..");
       if (parentDir === currentDir) {
         break;
       }
       currentDir = parentDir;
     }
   };
-  addCandidate((0, import_node_path28.resolve)(cwd, "dist/apps/api-cli/agent-loader.js"));
-  addCandidate((0, import_node_path28.resolve)(dirname13, "../agent-loader.js"));
-  addCandidate((0, import_node_path28.resolve)(dirname13, "agent-loader.js"));
+  addCandidate((0, import_node_path29.resolve)(cwd, "dist/apps/api-cli/agent-loader.js"));
+  addCandidate((0, import_node_path29.resolve)(dirname14, "../agent-loader.js"));
+  addCandidate((0, import_node_path29.resolve)(dirname14, "agent-loader.js"));
   collectAncestorCandidates(cwd);
-  collectAncestorCandidates(dirname13);
+  collectAncestorCandidates(dirname14);
   const resolved = candidates.find((candidate) => fileExists(candidate));
   if (!resolved) {
     throw new UserInputError(`Unable to locate Docyrus pi loader entry file. Checked: ${candidates.join(", ")}`);
@@ -153956,7 +154101,7 @@ function resolveDocyrusPiLoaderEntryPath(options2 = {}) {
 }
 function resolveDocyrusCliEntryPath(options2 = {}) {
   const cwd = options2.cwd ?? process.cwd();
-  const dirname13 = options2.dirname ?? __dirname;
+  const dirname14 = options2.dirname ?? __dirname;
   const argv = options2.argv ?? process.argv;
   const fileExists = options2.existsSyncFn ?? import_node_fs17.existsSync;
   const seen = /* @__PURE__ */ new Set();
@@ -153965,20 +154110,20 @@ function resolveDocyrusCliEntryPath(options2 = {}) {
     if (!candidate) {
       return;
     }
-    const resolvedCandidate = (0, import_node_path28.resolve)(candidate);
+    const resolvedCandidate = (0, import_node_path29.resolve)(candidate);
     if (!seen.has(resolvedCandidate)) {
       seen.add(resolvedCandidate);
       candidates.push(resolvedCandidate);
     }
   };
   const argvScript = argv[1]?.trim();
-  const normalizedArgvScript = argvScript ? argvScript.startsWith("/") ? argvScript : (0, import_node_path28.resolve)(cwd, argvScript) : void 0;
+  const normalizedArgvScript = argvScript ? argvScript.startsWith("/") ? argvScript : (0, import_node_path29.resolve)(cwd, argvScript) : void 0;
   if (normalizedArgvScript && normalizedArgvScript.endsWith(".js")) {
     addCandidate(normalizedArgvScript);
   }
-  addCandidate((0, import_node_path28.resolve)(cwd, "dist/apps/api-cli/main.js"));
-  addCandidate((0, import_node_path28.resolve)(dirname13, "../main.js"));
-  addCandidate((0, import_node_path28.resolve)(dirname13, "main.js"));
+  addCandidate((0, import_node_path29.resolve)(cwd, "dist/apps/api-cli/main.js"));
+  addCandidate((0, import_node_path29.resolve)(dirname14, "../main.js"));
+  addCandidate((0, import_node_path29.resolve)(dirname14, "main.js"));
   if (normalizedArgvScript) {
     addCandidate(normalizedArgvScript);
   }
@@ -153990,7 +154135,7 @@ function resolveDocyrusCliEntryPath(options2 = {}) {
 }
 function resolveInstalledPiPackageRootPath(options2 = {}) {
   const cwd = options2.cwd ?? process.cwd();
-  const dirname13 = options2.dirname ?? __dirname;
+  const dirname14 = options2.dirname ?? __dirname;
   const fileExists = options2.existsSyncFn ?? import_node_fs17.existsSync;
   const seen = /* @__PURE__ */ new Set();
   const candidates = options2.candidatePaths ?? [];
@@ -154001,32 +154146,32 @@ function resolveInstalledPiPackageRootPath(options2 = {}) {
     }
   };
   const collectAncestorCandidates = (startDir) => {
-    let currentDir = (0, import_node_path28.resolve)(startDir);
+    let currentDir = (0, import_node_path29.resolve)(startDir);
     while (true) {
-      addCandidate((0, import_node_path28.join)(currentDir, "node_modules", "@mariozechner", "pi-coding-agent", "package.json"));
-      if ((0, import_node_path28.basename)(currentDir) === "node_modules") {
-        addCandidate((0, import_node_path28.join)(currentDir, "@mariozechner", "pi-coding-agent", "package.json"));
+      addCandidate((0, import_node_path29.join)(currentDir, "node_modules", "@mariozechner", "pi-coding-agent", "package.json"));
+      if ((0, import_node_path29.basename)(currentDir) === "node_modules") {
+        addCandidate((0, import_node_path29.join)(currentDir, "@mariozechner", "pi-coding-agent", "package.json"));
       }
-      const parentDir = (0, import_node_path28.resolve)(currentDir, "..");
+      const parentDir = (0, import_node_path29.resolve)(currentDir, "..");
       if (parentDir === currentDir) {
         break;
       }
       currentDir = parentDir;
     }
   };
-  addCandidate((0, import_node_path28.resolve)(cwd, "apps/api-cli/node_modules/@mariozechner/pi-coding-agent/package.json"));
-  addCandidate((0, import_node_path28.resolve)(dirname13, "../../../apps/api-cli/node_modules/@mariozechner/pi-coding-agent/package.json"));
+  addCandidate((0, import_node_path29.resolve)(cwd, "apps/api-cli/node_modules/@mariozechner/pi-coding-agent/package.json"));
+  addCandidate((0, import_node_path29.resolve)(dirname14, "../../../apps/api-cli/node_modules/@mariozechner/pi-coding-agent/package.json"));
   collectAncestorCandidates(cwd);
-  collectAncestorCandidates(dirname13);
+  collectAncestorCandidates(dirname14);
   const resolvedPackageJson = candidates.find((candidate) => fileExists(candidate));
   if (!resolvedPackageJson) {
     throw new UserInputError(`Unable to locate the installed pi package root. Checked: ${candidates.join(", ")}`);
   }
-  return (0, import_node_path28.resolve)(resolvedPackageJson, "..");
+  return (0, import_node_path29.resolve)(resolvedPackageJson, "..");
 }
 function createPiAgentRuntimeSkill(params) {
   const commandPrefix = params.scope === "global" ? "docyrus -g" : "docyrus";
-  const knowledgeDir = (0, import_node_path28.join)(params.cwd, "docyrus", "knowledge");
+  const knowledgeDir = (0, import_node_path29.join)(params.cwd, "docyrus", "knowledge");
   const hasKnowledgeGraph = (0, import_node_fs17.existsSync)(knowledgeDir);
   const authLines = params.activeProfile ? [
     `- email: \`${params.activeProfile.email}\``,
@@ -154080,35 +154225,35 @@ function createPiAgentRuntimeSkill(params) {
   ].join("\n");
 }
 async function syncPackagedSkills(params) {
-  const sourceSkillsRoot = (0, import_node_path28.join)(params.resourceRoot, "skills");
-  const targetSkillsRoot = (0, import_node_path28.join)(params.agentRootPath, "skills");
-  await (0, import_promises22.mkdir)(targetSkillsRoot, {
+  const sourceSkillsRoot = (0, import_node_path29.join)(params.resourceRoot, "skills");
+  const targetSkillsRoot = (0, import_node_path29.join)(params.agentRootPath, "skills");
+  await (0, import_promises23.mkdir)(targetSkillsRoot, {
     recursive: true,
     mode: 448
   });
-  const entries = await (0, import_promises22.readdir)(sourceSkillsRoot, {
+  const entries = await (0, import_promises23.readdir)(sourceSkillsRoot, {
     withFileTypes: true
   });
   await Promise.all(DOCYRUS_MIGRATED_SKILL_NAMES.map(async (skillName) => {
-    await (0, import_promises22.rm)((0, import_node_path28.join)(targetSkillsRoot, skillName), {
+    await (0, import_promises23.rm)((0, import_node_path29.join)(targetSkillsRoot, skillName), {
       recursive: true,
       force: true
     });
   }));
   await Promise.all(entries.map(async (entry) => {
-    await (0, import_promises22.cp)((0, import_node_path28.join)(sourceSkillsRoot, entry.name), (0, import_node_path28.join)(targetSkillsRoot, entry.name), {
+    await (0, import_promises23.cp)((0, import_node_path29.join)(sourceSkillsRoot, entry.name), (0, import_node_path29.join)(targetSkillsRoot, entry.name), {
       recursive: true,
       force: true
     });
   }));
 }
 async function writeRuntimeSkill(params) {
-  const runtimeSkillDir = (0, import_node_path28.join)(params.agentRootPath, "skills", "docyrus-runtime-context");
-  await (0, import_promises22.mkdir)(runtimeSkillDir, {
+  const runtimeSkillDir = (0, import_node_path29.join)(params.agentRootPath, "skills", "docyrus-runtime-context");
+  await (0, import_promises23.mkdir)(runtimeSkillDir, {
     recursive: true,
     mode: 448
   });
-  await (0, import_promises22.writeFile)((0, import_node_path28.join)(runtimeSkillDir, "SKILL.md"), `${params.content}
+  await (0, import_promises23.writeFile)((0, import_node_path29.join)(runtimeSkillDir, "SKILL.md"), `${params.content}
 `, {
     encoding: "utf8",
     mode: 384
@@ -154121,10 +154266,10 @@ function resolveNpmCommand() {
   return process.platform === "win32" ? "npm.cmd" : "npm";
 }
 function resolveManagedDiffityInstallRoot(agentRootPath) {
-  return (0, import_node_path28.join)(agentRootPath, "tools", "diffity");
+  return (0, import_node_path29.join)(agentRootPath, "tools", "diffity");
 }
 function resolveManagedDiffityExecutablePath(agentRootPath) {
-  return (0, import_node_path28.join)(
+  return (0, import_node_path29.join)(
     resolveManagedDiffityInstallRoot(agentRootPath),
     "node_modules",
     ".bin",
@@ -154132,10 +154277,10 @@ function resolveManagedDiffityExecutablePath(agentRootPath) {
   );
 }
 function prependPathEntry(entry, existingPath) {
-  const values = existingPath ? existingPath.split(import_node_path28.delimiter).filter((value2) => value2.trim().length > 0) : [];
+  const values = existingPath ? existingPath.split(import_node_path29.delimiter).filter((value2) => value2.trim().length > 0) : [];
   const normalizedEntry = entry.trim();
   const remaining = values.filter((value2) => value2 !== normalizedEntry);
-  return [normalizedEntry, ...remaining].join(import_node_path28.delimiter);
+  return [normalizedEntry, ...remaining].join(import_node_path29.delimiter);
 }
 function createDocyrusSkillsInstallArgs(scope) {
   const args2 = [
@@ -154173,7 +154318,7 @@ function createPackagedDocyrusPlatformInstallArgs(params) {
   return args2;
 }
 async function installExternalDocyrusSkillsOnce(params) {
-  const markerPath = (0, import_node_path28.join)(params.agentRootPath, DOCYRUS_EXTERNAL_SKILL_MARKER_FILE);
+  const markerPath = (0, import_node_path29.join)(params.agentRootPath, DOCYRUS_EXTERNAL_SKILL_MARKER_FILE);
   if ((0, import_node_fs17.existsSync)(markerPath)) {
     return;
   }
@@ -154192,7 +154337,7 @@ async function installExternalDocyrusSkillsOnce(params) {
     );
     return;
   }
-  await (0, import_promises22.writeFile)(markerPath, `${JSON.stringify({
+  await (0, import_promises23.writeFile)(markerPath, `${JSON.stringify({
     source: DOCYRUS_EXTERNAL_SKILL_SOURCE,
     skills: DOCYRUS_MIGRATED_SKILL_NAMES,
     agents: DOCYRUS_EXTERNAL_SKILL_AGENT_IDS,
@@ -154206,7 +154351,7 @@ async function installExternalDocyrusSkillsOnce(params) {
 }
 async function ensureManagedDiffityInstalled(params) {
   const executablePath = resolveManagedDiffityExecutablePath(params.agentRootPath);
-  const binDir = (0, import_node_path28.dirname)(executablePath);
+  const binDir = (0, import_node_path29.dirname)(executablePath);
   if ((0, import_node_fs17.existsSync)(executablePath)) {
     return {
       available: true,
@@ -154245,19 +154390,19 @@ async function ensureManagedDiffityInstalled(params) {
   };
 }
 function resolvePackagedDocyrusPlatformSkillPath(resourceRoot) {
-  return (0, import_node_path28.join)(resourceRoot, "skills", DOCYRUS_PACKAGED_PLATFORM_SKILL_NAME);
+  return (0, import_node_path29.join)(resourceRoot, "skills", DOCYRUS_PACKAGED_PLATFORM_SKILL_NAME);
 }
 function resolvePackagedOfficeCliRootPath(resourceRoot) {
-  return (0, import_node_path28.join)((0, import_node_path28.resolve)(resourceRoot, ".."), "officecli");
+  return (0, import_node_path29.join)((0, import_node_path29.resolve)(resourceRoot, ".."), "officecli");
 }
 function resolvePackagedOfficeCliManifestPath(resourceRoot) {
-  return (0, import_node_path28.join)(resolvePackagedOfficeCliRootPath(resourceRoot), DOCYRUS_OFFICECLI_MANIFEST_FILE_NAME);
+  return (0, import_node_path29.join)(resolvePackagedOfficeCliRootPath(resourceRoot), DOCYRUS_OFFICECLI_MANIFEST_FILE_NAME);
 }
 function resolveManagedOfficeCliInstallRoot(agentRootPath) {
-  return (0, import_node_path28.join)(agentRootPath, "tools", "officecli");
+  return (0, import_node_path29.join)(agentRootPath, "tools", "officecli");
 }
 function resolveManagedOfficeCliExecutablePath(agentRootPath) {
-  return (0, import_node_path28.join)(
+  return (0, import_node_path29.join)(
     resolveManagedOfficeCliInstallRoot(agentRootPath),
     process.platform === "win32" ? "officecli.exe" : "officecli"
   );
@@ -154299,14 +154444,14 @@ function resolveOfficeCliReleaseAssetName(options2 = {}) {
   throw new UserInputError(`OfficeCLI is not supported on ${platform2}/${arch}.`);
 }
 function resolvePackagedOfficeCliExecutablePath(resourceRoot, options2) {
-  return (0, import_node_path28.join)(
+  return (0, import_node_path29.join)(
     resolvePackagedOfficeCliRootPath(resourceRoot),
     "bundled",
     resolveOfficeCliReleaseAssetName(options2)
   );
 }
 async function readPackagedOfficeCliVersion(resourceRoot) {
-  const manifestRaw = await (0, import_promises22.readFile)(resolvePackagedOfficeCliManifestPath(resourceRoot), "utf8");
+  const manifestRaw = await (0, import_promises23.readFile)(resolvePackagedOfficeCliManifestPath(resourceRoot), "utf8");
   const manifest = JSON.parse(manifestRaw);
   const version2 = typeof manifest.version === "string" ? manifest.version.trim() : "";
   if (version2.length === 0) {
@@ -154322,12 +154467,12 @@ async function downloadOfficeCliBinary(params) {
     throw new UserInputError(`OfficeCLI download failed with status ${response.status}.`);
   }
   const binary2 = Buffer.from(await response.arrayBuffer());
-  await (0, import_promises22.writeFile)(params.destinationPath, binary2, {
+  await (0, import_promises23.writeFile)(params.destinationPath, binary2, {
     mode: process.platform === "win32" ? 384 : 448
   });
 }
 function resolveManagedOfficeCliConfigMarkerPath(agentRootPath) {
-  return (0, import_node_path28.join)(resolveManagedOfficeCliInstallRoot(agentRootPath), ".docyrus-officecli-configured.json");
+  return (0, import_node_path29.join)(resolveManagedOfficeCliInstallRoot(agentRootPath), ".docyrus-officecli-configured.json");
 }
 async function disableManagedOfficeCliAutoUpdate(params) {
   const markerPath = resolveManagedOfficeCliConfigMarkerPath(params.agentRootPath);
@@ -154350,7 +154495,7 @@ async function disableManagedOfficeCliAutoUpdate(params) {
     );
     return;
   }
-  await (0, import_promises22.writeFile)(markerPath, `${JSON.stringify({
+  await (0, import_promises23.writeFile)(markerPath, `${JSON.stringify({
     configuredAt: (/* @__PURE__ */ new Date()).toISOString()
   }, null, 2)}
 `, {
@@ -154360,7 +154505,7 @@ async function disableManagedOfficeCliAutoUpdate(params) {
 }
 async function ensureManagedOfficeCliInstalled(params) {
   const executablePath = resolveManagedOfficeCliExecutablePath(params.agentRootPath);
-  const binDir = (0, import_node_path28.dirname)(executablePath);
+  const binDir = (0, import_node_path29.dirname)(executablePath);
   if ((0, import_node_fs17.existsSync)(executablePath)) {
     await disableManagedOfficeCliAutoUpdate({
       agentRootPath: params.agentRootPath,
@@ -154376,13 +154521,13 @@ async function ensureManagedOfficeCliInstalled(params) {
   }
   const tempPath = `${executablePath}.download${process.platform === "win32" ? ".exe" : ""}`;
   try {
-    await (0, import_promises22.mkdir)(binDir, {
+    await (0, import_promises23.mkdir)(binDir, {
       recursive: true,
       mode: 448
     });
     const bundledExecutablePath = resolvePackagedOfficeCliExecutablePath(params.resourceRoot);
     if ((0, import_node_fs17.existsSync)(bundledExecutablePath)) {
-      await (0, import_promises22.cp)(bundledExecutablePath, tempPath, {
+      await (0, import_promises23.cp)(bundledExecutablePath, tempPath, {
         force: true
       });
     } else {
@@ -154392,7 +154537,7 @@ async function ensureManagedOfficeCliInstalled(params) {
       });
     }
     if (process.platform !== "win32") {
-      await (0, import_promises22.chmod)(tempPath, 448);
+      await (0, import_promises23.chmod)(tempPath, 448);
     }
     const verificationResult = params.spawnCommand(tempPath, ["--version"], {
       stdio: ["ignore", "pipe", "pipe"],
@@ -154408,9 +154553,9 @@ async function ensureManagedOfficeCliInstalled(params) {
         verificationResult.error?.message || summarizeFailure3(verificationResult, "officecli --version")
       );
     }
-    await (0, import_promises22.rename)(tempPath, executablePath);
+    await (0, import_promises23.rename)(tempPath, executablePath);
     if (process.platform !== "win32") {
-      await (0, import_promises22.chmod)(executablePath, 448);
+      await (0, import_promises23.chmod)(executablePath, 448);
     }
     await disableManagedOfficeCliAutoUpdate({
       agentRootPath: params.agentRootPath,
@@ -154424,7 +154569,7 @@ async function ensureManagedOfficeCliInstalled(params) {
       binDir
     };
   } catch (error48) {
-    await (0, import_promises22.rm)(tempPath, {
+    await (0, import_promises23.rm)(tempPath, {
       force: true
     });
     process.stderr.write(
@@ -154543,6 +154688,13 @@ function createPiAgentLauncher(options2) {
       cwd,
       spawnCommand
     });
+    const soulId = request.soul?.trim() || await options2.environmentConfigService.getActiveSoulId();
+    const systemPromptPath = await composeSystemPrompt({
+      profile: request.profile,
+      soulId,
+      resourceRoot,
+      agentRootPath
+    });
     spinner.stop();
     const loaderEntryPath = resolveLoaderPath({ cwd });
     const cliEntryPath = resolveCliEntryPath({ cwd });
@@ -154558,6 +154710,8 @@ function createPiAgentLauncher(options2) {
         PI_PACKAGE_DIR: piPackageRoot,
         DOCYRUS_PI_REQUEST: JSON.stringify(request),
         DOCYRUS_PI_VERSION: options2.version || "dev",
+        DOCYRUS_PI_SYSTEM_PROMPT_PATH: systemPromptPath,
+        DOCYRUS_PI_SOUL_ID: soulId,
         DOCYRUS_CLI_EXECUTABLE: processExecPath,
         DOCYRUS_CLI_ENTRY: cliEntryPath,
         DOCYRUS_CLI_SCOPE: options2.settingsPaths.scope,
@@ -154579,11 +154733,11 @@ function createPiAgentLauncher(options2) {
 // src/services/piAgentServerLauncher.ts
 var import_node_child_process9 = require("node:child_process");
 var import_node_fs18 = require("node:fs");
-var import_node_path29 = require("node:path");
+var import_node_path30 = require("node:path");
 function serializePiAgentServerRequest(request) {
   return JSON.stringify(request);
 }
-function resolveServerLoaderEntryPath(cwd, dirname13) {
+function resolveServerLoaderEntryPath(cwd, dirname14) {
   const seen = /* @__PURE__ */ new Set();
   const candidates = [];
   const addCandidate = (candidate) => {
@@ -154593,25 +154747,25 @@ function resolveServerLoaderEntryPath(cwd, dirname13) {
     }
   };
   const collectAncestorCandidates = (startDir) => {
-    let currentDir = (0, import_node_path29.resolve)(startDir);
+    let currentDir = (0, import_node_path30.resolve)(startDir);
     while (true) {
-      addCandidate((0, import_node_path29.join)(currentDir, "dist", "apps", "api-cli", "server-loader.js"));
-      addCandidate((0, import_node_path29.join)(currentDir, "server-loader.js"));
-      if ((0, import_node_path29.basename)(currentDir) === "dist") {
-        addCandidate((0, import_node_path29.join)(currentDir, "apps", "api-cli", "server-loader.js"));
+      addCandidate((0, import_node_path30.join)(currentDir, "dist", "apps", "api-cli", "server-loader.js"));
+      addCandidate((0, import_node_path30.join)(currentDir, "server-loader.js"));
+      if ((0, import_node_path30.basename)(currentDir) === "dist") {
+        addCandidate((0, import_node_path30.join)(currentDir, "apps", "api-cli", "server-loader.js"));
       }
-      const parentDir = (0, import_node_path29.resolve)(currentDir, "..");
+      const parentDir = (0, import_node_path30.resolve)(currentDir, "..");
       if (parentDir === currentDir) {
         break;
       }
       currentDir = parentDir;
     }
   };
-  addCandidate((0, import_node_path29.resolve)(cwd, "dist/apps/api-cli/server-loader.js"));
-  addCandidate((0, import_node_path29.resolve)(dirname13, "../server-loader.js"));
-  addCandidate((0, import_node_path29.resolve)(dirname13, "server-loader.js"));
+  addCandidate((0, import_node_path30.resolve)(cwd, "dist/apps/api-cli/server-loader.js"));
+  addCandidate((0, import_node_path30.resolve)(dirname14, "../server-loader.js"));
+  addCandidate((0, import_node_path30.resolve)(dirname14, "server-loader.js"));
   collectAncestorCandidates(cwd);
-  collectAncestorCandidates(dirname13);
+  collectAncestorCandidates(dirname14);
   const resolved = candidates.find((candidate) => (0, import_node_fs18.existsSync)(candidate));
   if (!resolved) {
     throw new UserInputError(`Unable to locate Docyrus pi server loader entry file. Checked: ${candidates.join(", ")}`);
@@ -154665,13 +154819,20 @@ function createPiAgentServerLauncher(options2) {
     if (request.sandbox) {
       const browserConfigDir = settingsRootPath;
       (0, import_node_fs18.mkdirSync)(browserConfigDir, { recursive: true, mode: 448 });
-      const browserConfigPath = (0, import_node_path29.join)(browserConfigDir, "browser.json");
+      const browserConfigPath = (0, import_node_path30.join)(browserConfigDir, "browser.json");
       const appId = process.env.DOCYRUS_SANDBOX_APP_ID || "";
       (0, import_node_fs18.writeFileSync)(browserConfigPath, JSON.stringify({ mode: "sandbox", appId }, null, 2) + "\n", {
         encoding: "utf8",
         mode: 384
       });
     }
+    const soulId = request.soul?.trim() || await options2.environmentConfigService.getActiveSoulId();
+    const systemPromptPath = await composeSystemPrompt({
+      profile: request.profile,
+      soulId,
+      resourceRoot,
+      agentRootPath
+    });
     spinner.stop();
     const loaderEntryPath = resolveServerLoaderEntryPath(cwd, __dirname);
     const piPackageRoot = resolveInstalledPiPackageRootPath({ cwd });
@@ -154687,6 +154848,8 @@ function createPiAgentServerLauncher(options2) {
         PI_PACKAGE_DIR: piPackageRoot,
         DOCYRUS_PI_REQUEST: serializePiAgentServerRequest(request),
         DOCYRUS_PI_VERSION: options2.version || "dev",
+        DOCYRUS_PI_SYSTEM_PROMPT_PATH: systemPromptPath,
+        DOCYRUS_PI_SOUL_ID: soulId,
         DOCYRUS_CLI_EXECUTABLE: process.execPath,
         DOCYRUS_CLI_ENTRY: cliEntryPath,
         DOCYRUS_CLI_SCOPE: options2.settingsPaths.scope,
@@ -154741,8 +154904,8 @@ async function runWithIncurSkillsOutOfDateWarningSuppressed(params) {
 }
 
 // src/services/tenantOpenApi.ts
-var import_promises23 = require("node:fs/promises");
-var import_node_path30 = require("node:path");
+var import_promises24 = require("node:fs/promises");
+var import_node_path31 = require("node:path");
 function resolveSourceUrl(tenantId, template) {
   return template.replace("{tenantId}", encodeURIComponent(tenantId));
 }
@@ -154767,16 +154930,16 @@ var TenantOpenApiService = class {
   params;
   async #writeOpenApiFile(tenantId, parsedContent) {
     const filePath = this.getTenantOpenApiFilePath(tenantId);
-    await (0, import_promises23.mkdir)((0, import_node_path30.dirname)(filePath), {
+    await (0, import_promises24.mkdir)((0, import_node_path31.dirname)(filePath), {
       recursive: true,
       mode: 448
     });
-    await (0, import_promises23.writeFile)(filePath, `${JSON.stringify(parsedContent, null, 2)}
+    await (0, import_promises24.writeFile)(filePath, `${JSON.stringify(parsedContent, null, 2)}
 `, {
       encoding: "utf8",
       mode: 384
     });
-    await (0, import_promises23.chmod)(filePath, 384);
+    await (0, import_promises24.chmod)(filePath, 384);
     return filePath;
   }
   async #generateTenantOpenApiViaAuthenticatedEndpoint(tenantId, options2) {
@@ -154813,7 +154976,7 @@ var TenantOpenApiService = class {
       throw new AuthSessionError("Tenant ID is required to resolve OpenAPI spec path.");
     }
     const rootPath = this.params?.rootPath || TENANT_OPENAPI_ROOT_PATH;
-    return (0, import_node_path30.join)(rootPath, normalizedTenantId, "openapi.json");
+    return (0, import_node_path31.join)(rootPath, normalizedTenantId, "openapi.json");
   }
   async downloadTenantOpenApi(tenantId, options2 = {}) {
     const normalizedTenantId = tenantId.trim();