@docyrus/docyrus 0.0.63 → 0.0.65

package/README.md

@@ -362,8 +362,27 @@ Inside the interactive agent TUI:
 /end-read-only    # exit read-only mode and resume normal operation
 /tasks            # browse the canonical project-plan phases, features, and tasks
 /todos            # interactive todo manager
+/souls            # list available agent "souls" (communication styles)
+/soul <id>        # switch the agent's soul (e.g. caveman, master-yoda, pirate) — takes effect next session
 ```
 
+#### Souls
+
+A "soul" is a style-only prompt overlay that changes how the agent *talks* without changing what it *does*. Tool usage, Docyrus CLI rules, and structured (`--json`) output are always preserved; souls only affect narrative prose.
+
+Select a soul inside the pi agent (`docyrus agent` / `docyrus coder`) with `/soul <id>` and list available souls with `/souls`. The selection is persisted in `<settings-root>/config.json` (same scope as environment/auth) and takes effect on the next agent session.
+
+Over HTTP (`docyrus server`):
+
+```bash
+curl http://localhost:3111/api/souls
+curl -X POST http://localhost:3111/api/souls/select \
+  -H 'content-type: application/json' \
+  -d '{"soulId":"pirate"}'
+```
+
+Full server API reference for **Soul**, **MCP**, and **Skill** endpoints: [`docs/server-api.md`](./docs/server-api.md).
+
 When running through `docyrus server`, `/plan` can be sent through `/api/chat` as normal chat input. If clarification is needed, the server emits a synthetic `ask_user` client tool. Frontends using AI SDK `useChat` should render that tool and submit structured answers back with `addToolOutput`.
 
 ### Planning-Model Policy

package/agent-loader.js

@@ -1334,6 +1334,60 @@ function createCustomOpenAiProviderConfig(params) {
     ]
   };
 }
+var DEEPSEEK_BASE_URL = "https://api.deepseek.com";
+var DEEPSEEK_MODELS = [
+  {
+    id: "deepseek-v4-flash",
+    name: "DeepSeek V4 Flash",
+    cost: {
+      input: 0.14,
+      output: 0.28,
+      cacheRead: 0.028,
+      cacheWrite: 0.14
+    }
+  },
+  {
+    id: "deepseek-v4-pro",
+    name: "DeepSeek V4 Pro",
+    cost: {
+      input: 1.74,
+      output: 3.48,
+      cacheRead: 0.145,
+      cacheWrite: 1.74
+    }
+  }
+];
+function createDeepseekProviderConfig() {
+  return {
+    baseUrl: DEEPSEEK_BASE_URL,
+    apiKey: "env:DEEPSEEK_API_KEY",
+    api: "openai-completions",
+    models: DEEPSEEK_MODELS.map((model) => ({
+      id: model.id,
+      name: model.name,
+      reasoning: true,
+      input: ["text"],
+      contextWindow: 1e6,
+      maxTokens: 384e3,
+      cost: {
+        input: model.cost.input,
+        output: model.cost.output,
+        cacheRead: model.cost.cacheRead,
+        cacheWrite: model.cost.cacheWrite
+      },
+      compat: {
+        supportsReasoningEffort: true,
+        reasoningEffortMap: {
+          minimal: "high",
+          low: "high",
+          medium: "high",
+          high: "high",
+          xhigh: "max"
+        }
+      }
+    }))
+  };
+}
 function createAzureProviderConfig(params) {
   const providerConfig = {
     baseUrl: params.baseUrl,
@@ -1405,6 +1459,20 @@ async function saveCustomOpenAiConfig(params) {
   }));
   params.settingsManager.setDefaultModelAndProvider("custom-openai", params.modelId.trim());
 }
+async function saveDeepseekConfig(params) {
+  const apiKey = params.apiKey.trim();
+  const modelId = params.modelId?.trim() || DEEPSEEK_MODELS[0].id;
+  params.authStorage.set("deepseek", {
+    type: "api_key",
+    key: apiKey
+  });
+  await params.envStore.removeMany(["DEEPSEEK_API_KEY"]);
+  await params.envStore.setMany({
+    DEEPSEEK_API_KEY: apiKey
+  });
+  await upsertModelsProvider(params.modelsJsonPath, "deepseek", createDeepseekProviderConfig());
+  params.settingsManager.setDefaultModelAndProvider("deepseek", modelId);
+}
 async function saveAzureConfig(params) {
   const modelId = params.modelId.trim();
   const useCustomModel = params.useCustomModel ?? false;
@@ -1482,6 +1550,12 @@ async function clearProviderConfig(params) {
     ]);
     await removeModelsProvider(params.modelsJsonPath, "custom-openai");
   }
+  if (params.providerId === "deepseek") {
+    await params.envStore.removeMany([
+      "DEEPSEEK_API_KEY"
+    ]);
+    await removeModelsProvider(params.modelsJsonPath, "deepseek");
+  }
   if (params.providerId === "azure-openai-responses") {
     await params.envStore.removeMany([
       "AZURE_OPENAI_API_KEY",
@@ -1552,6 +1626,7 @@ var PROVIDER_LABELS = {
   mistral: "Mistral",
   minimax: "MiniMax",
   "minimax-cn": "MiniMax CN",
+  deepseek: "DeepSeek",
   huggingface: "Hugging Face",
   opencode: "OpenCode",
   "opencode-go": "OpenCode Go",
@@ -1565,6 +1640,7 @@ var PROVIDER_LABELS = {
 var PROVIDER_HINTS = {
   anthropic: "recommended",
   "custom-openai": "custom base URL + API key",
+  deepseek: "API key (OpenAI-compatible preset)",
   "azure-openai-responses": "API key + base URL/resource + deployment",
   "amazon-bedrock": "AWS profile or access key pair",
   "openai-codex": "browser auth",
@@ -1607,6 +1683,8 @@ function getApiKeyProviderOptions(providerIds) {
       flow = "azure-openai-responses";
     } else if (providerId === "amazon-bedrock") {
       flow = "amazon-bedrock";
+    } else if (providerId === "deepseek") {
+      flow = "deepseek";
     }
     return {
       id: providerId,
@@ -1621,6 +1699,12 @@ function getApiKeyProviderOptions(providerIds) {
     hint: toHint("custom-openai"),
     flow: "custom-openai"
   });
+  baseProviders.push({
+    id: "deepseek",
+    label: toLabel("deepseek"),
+    hint: toHint("deepseek"),
+    flow: "deepseek"
+  });
   const deduped = /* @__PURE__ */ new Map();
   for (const provider of baseProviders) {
     deduped.set(provider.id, provider);
@@ -1673,6 +1757,23 @@ function getProviderFormFields(params) {
           placeholder: "gpt-4o"
         }
       ];
+    case "deepseek":
+      return [
+        {
+          name: "apiKey",
+          title: `${provider.label} API key`,
+          required: true,
+          component: "password"
+        },
+        {
+          name: "modelId",
+          title: "Model",
+          required: true,
+          component: "select",
+          options: DEEPSEEK_MODELS.map((model) => ({ label: model.name, value: model.id })),
+          defaultValue: DEEPSEEK_MODELS[0].id
+        }
+      ];
     case "azure-openai-responses":
       return [
         {
@@ -1944,6 +2045,33 @@ async function runApiKeyProviderFlow(mode, dependencies, provider) {
       modeAny.showStatus(`Configured ${provider.label}`);
       return;
     }
+    case "deepseek": {
+      const apiKeyField = field("apiKey");
+      const modelIdField = field("modelId");
+      const apiKey = await showInput(mode, apiKeyField?.title || "DeepSeek API key");
+      if (!apiKey) {
+        return;
+      }
+      const modelId = await showSelection(
+        mode,
+        modelIdField?.title || "Choose DeepSeek model",
+        (modelIdField?.options ?? DEEPSEEK_MODELS.map((model) => ({ label: model.name, value: model.id }))).map((option) => ({
+          value: option.value,
+          label: option.label
+        }))
+      );
+      if (!modelId) {
+        return;
+      }
+      await saveDeepseekConfig({
+        ...dependencies,
+        apiKey,
+        modelId
+      });
+      await refreshAfterCredentialChange(mode, dependencies.envStore, "deepseek", modelId);
+      modeAny.showStatus(`Configured ${provider.label}`);
+      return;
+    }
     case "azure-openai-responses": {
       const apiKeyField = field("apiKey");
       const configModeField = field("configMode");
@@ -2201,7 +2329,8 @@ async function shouldRunOnboarding(params) {
     knownProviderIds: [
       ...params.browserProviders.map((provider) => provider.id),
       ...params.apiKeyProviderIds,
-      "custom-openai"
+      "custom-openai",
+      "deepseek"
     ]
   });
   return !existingProvider;
@@ -2404,6 +2533,32 @@ async function runAzureFlow(clack, pico, dependencies) {
   clack.log.success(`Azure OpenAI configured for ${pico.green(String(modelId).trim())}`);
   return true;
 }
+async function runDeepseekFlow(clack, pico, dependencies) {
+  const apiKey = await clack.password({
+    message: "Paste your DeepSeek API key:",
+    mask: "\u25CF"
+  });
+  if (clack.isCancel(apiKey) || !apiKey) {
+    return false;
+  }
+  const modelId = await clack.select({
+    message: "Choose a DeepSeek model:",
+    options: DEEPSEEK_MODELS.map((model) => ({
+      value: model.id,
+      label: model.name
+    }))
+  });
+  if (clack.isCancel(modelId) || !modelId) {
+    return false;
+  }
+  await saveDeepseekConfig({
+    ...dependencies,
+    apiKey: String(apiKey).trim(),
+    modelId: String(modelId).trim()
+  });
+  clack.log.success(`DeepSeek configured for ${pico.green(String(modelId).trim())}`);
+  return true;
+}
 async function runBedrockFlow(clack, pico, dependencies) {
   const authMode = await clack.select({
     message: "How do you want to authenticate with Amazon Bedrock?",
@@ -2489,6 +2644,8 @@ async function runProviderFlow(clack, pico, dependencies, provider) {
       return await runOAuthFlow(clack, pico, dependencies, provider.id);
     case "custom-openai":
       return await runCustomOpenAiFlow(clack, pico, dependencies);
+    case "deepseek":
+      return await runDeepseekFlow(clack, pico, dependencies);
     case "azure-openai-responses":
       return await runAzureFlow(clack, pico, dependencies);
     case "amazon-bedrock":
@@ -2515,7 +2672,8 @@ async function runOnboarding(dependencies) {
     knownProviderIds: [
       ...dependencies.browserProviders.map((provider) => provider.id),
       ...dependencies.apiKeyProviderIds,
-      "custom-openai"
+      "custom-openai",
+      "deepseek"
     ]
   });
   const authOptions = [];
@@ -2679,25 +2837,11 @@ async function readPipedStdin() {
     process.stdin.resume();
   });
 }
-function buildTools(profile, cwd, pi) {
+function buildTools(profile) {
   if (profile === "agent") {
-    return [
-      pi.createReadTool(cwd),
-      pi.createBashTool(cwd),
-      pi.createGrepTool(cwd),
-      pi.createFindTool(cwd),
-      pi.createLsTool(cwd)
-    ];
+    return ["read", "bash", "grep", "find", "ls"];
   }
-  return [
-    pi.createReadTool(cwd),
-    pi.createBashTool(cwd),
-    pi.createEditTool(cwd),
-    pi.createWriteTool(cwd),
-    pi.createGrepTool(cwd),
-    pi.createFindTool(cwd),
-    pi.createLsTool(cwd)
-  ];
+  return ["read", "bash", "edit", "write", "grep", "find", "ls"];
 }
 function resolveRequestedModel(params) {
   const { request, modelRegistry } = params;
@@ -2861,7 +3005,7 @@ async function main() {
     agentDir,
     settingsManager,
     additionalExtensionPaths: packagedExtensionPaths,
-    systemPrompt: (0, import_node_path4.join)(
+    systemPrompt: process.env.DOCYRUS_PI_SYSTEM_PROMPT_PATH ?? (0, import_node_path4.join)(
       resourceRoot,
       "prompts",
       request.profile === "agent" ? "agent-system.md" : "coder-system.md"
@@ -2869,7 +3013,7 @@ async function main() {
   });
   await resourceLoader.reload();
   spinner.update("Creating session...");
-  const tools = buildTools(request.profile, cwd, pi);
+  const tools = buildTools(request.profile);
   const createRuntime = async (options) => {
     const created = await pi.createAgentSession({
       cwd: options.cwd,