@docyrus/docyrus 0.0.24 → 0.0.26

package/README.md

@@ -219,5 +219,38 @@ Inside the interactive agent TUI:
 ```bash
 /login   # browser or API-key provider chooser
 /logout  # remove saved provider configuration
-/architect <brief>  # discover tenant data sources and generate local planning artifacts under docs/architect/
+/plan [task]  # start a planning-only branch and keep the current plan in .docyrus/plans/
+/end-plan  # leave the planning branch, summarize it, and return to the original branch
+/end-architect  # alias for leaving an architect planning session
+/plan-policy  # show the effective planning-model policy and the resolved planning model
+/architect [brief]  # discover tenant data sources and generate local planning artifacts under ./docyrus/architecture/
 ```
+
+When running through `docyrus server`, `/plan` and `/architect` 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`.
+
+Optional planning-model policy:
+
+- Project config: `<project>/.pi/plan-policy.json`
+- Global config: `~/.pi/agent/plan-policy.json`
+- Project config takes precedence over global config
+
+Example:
+
+```json
+{
+  "models": [
+    { "model": "anthropic/claude-sonnet-4", "thinkingLevel": "high" },
+    "openai-codex/gpt-5.3-codex"
+  ],
+  "profiles": {
+    "codex-implementation": {
+      "match": "openai-codex/gpt-5.3-codex",
+      "models": [
+        { "model": "anthropic/claude-sonnet-4", "thinkingLevel": "medium" }
+      ]
+    }
+  }
+}
+```
+
+`match` is the exact implementation-time `provider/modelId` active when `/plan` starts. The `models` array is an ordered fallback chain. If no configured planning model resolves, `/plan` stays on the current session model.

package/agent-loader.js

@@ -1605,6 +1605,188 @@ function getProviderLabel(providerId) {
   return toLabel(providerId);
 }
 
+// src/agent/authInteractivity.ts
+function toSelectOptions(values) {
+  return values.map((value) => ({ label: value, value }));
+}
+function getProviderFormFields(params) {
+  const provider = params.provider;
+  switch (provider.flow) {
+    case "custom-openai":
+      return [
+        {
+          name: "baseUrl",
+          title: "Custom OpenAI base URL",
+          required: true,
+          component: "text",
+          placeholder: "https://my-proxy.example.com/v1"
+        },
+        {
+          name: "apiKey",
+          title: `${provider.label} API key`,
+          required: true,
+          component: "password"
+        },
+        {
+          name: "modelId",
+          title: "Model ID",
+          required: true,
+          component: "text",
+          placeholder: "gpt-4o"
+        }
+      ];
+    case "azure-openai-responses":
+      return [
+        {
+          name: "apiKey",
+          title: "Azure OpenAI API key",
+          required: true,
+          component: "password"
+        },
+        {
+          name: "configMode",
+          title: "Azure OpenAI configuration",
+          required: true,
+          defaultValue: "base-url",
+          component: "select",
+          options: [
+            { label: "Use a base URL", value: "base-url" },
+            { label: "Use an Azure resource name", value: "resource-name" }
+          ]
+        },
+        {
+          name: "baseUrl",
+          title: "Azure OpenAI base URL",
+          required: true,
+          component: "text",
+          placeholder: "https://my-resource.openai.azure.com/openai/v1",
+          dependsOn: { field: "configMode", equals: "base-url" }
+        },
+        {
+          name: "resourceName",
+          title: "Azure resource name",
+          required: true,
+          component: "text",
+          placeholder: "my-resource",
+          dependsOn: { field: "configMode", equals: "resource-name" }
+        },
+        {
+          name: "modelId",
+          title: "Model ID",
+          required: true,
+          component: params.modelIdsByProvider[provider.id]?.length ? "select" : "text",
+          options: params.modelIdsByProvider[provider.id]?.length ? toSelectOptions(params.modelIdsByProvider[provider.id]) : void 0,
+          defaultValue: params.modelIdsByProvider[provider.id]?.[0] || "gpt-4.1"
+        },
+        {
+          name: "deploymentName",
+          title: "Deployment name",
+          component: "text",
+          placeholder: "gpt-4.1"
+        },
+        {
+          name: "apiVersion",
+          title: "API version",
+          component: "text",
+          defaultValue: "2025-03-01-preview",
+          placeholder: "2025-03-01-preview"
+        }
+      ];
+    case "amazon-bedrock":
+      return [
+        {
+          name: "authMode",
+          title: "Amazon Bedrock authentication",
+          required: true,
+          defaultValue: "profile",
+          component: "select",
+          options: [
+            { label: "Use an AWS profile", value: "profile" },
+            { label: "Paste AWS access keys", value: "access-keys" }
+          ]
+        },
+        {
+          name: "profile",
+          title: "AWS profile name",
+          required: true,
+          defaultValue: "default",
+          component: "text",
+          placeholder: "default",
+          dependsOn: { field: "authMode", equals: "profile" }
+        },
+        {
+          name: "accessKeyId",
+          title: "AWS access key ID",
+          required: true,
+          component: "text",
+          dependsOn: { field: "authMode", equals: "access-keys" }
+        },
+        {
+          name: "secretAccessKey",
+          title: "AWS secret access key",
+          required: true,
+          component: "password",
+          dependsOn: { field: "authMode", equals: "access-keys" }
+        },
+        {
+          name: "sessionToken",
+          title: "AWS session token",
+          component: "password",
+          dependsOn: { field: "authMode", equals: "access-keys" }
+        },
+        {
+          name: "region",
+          title: "AWS region",
+          required: true,
+          defaultValue: "us-east-1",
+          component: "text",
+          placeholder: "us-east-1"
+        },
+        {
+          name: "modelId",
+          title: "Bedrock model ID",
+          required: true,
+          component: params.modelIdsByProvider[provider.id]?.length ? "select" : "text",
+          options: params.modelIdsByProvider[provider.id]?.length ? toSelectOptions(params.modelIdsByProvider[provider.id]) : void 0,
+          defaultValue: params.modelIdsByProvider[provider.id]?.[0] || "anthropic.claude-3-7-sonnet-20250219-v1:0"
+        }
+      ];
+    default:
+      return [
+        {
+          name: "apiKey",
+          title: `${provider.label} API key`,
+          required: true,
+          component: "password"
+        }
+      ];
+  }
+}
+async function refreshSessionAfterCredentialChange(params) {
+  params.modelRegistry.refresh();
+  const availableModels = params.modelRegistry.getAvailable();
+  const preferredModel = params.preferredProviderId && params.preferredModelId ? availableModels.find((model) => model.provider === params.preferredProviderId && model.id === params.preferredModelId) : params.preferredProviderId ? availableModels.find((model) => model.provider === params.preferredProviderId) : void 0;
+  const currentModel = params.session.model;
+  const currentModelStillAvailable = currentModel ? availableModels.some((model) => model.provider === currentModel.provider && model.id === currentModel.id) : false;
+  if (currentModel && !currentModelStillAvailable) {
+    if (preferredModel) {
+      await params.session.setModel(preferredModel);
+      return;
+    }
+    if (availableModels[0]) {
+      await params.session.setModel(availableModels[0]);
+    }
+    return;
+  }
+  if (!currentModel && preferredModel) {
+    await params.session.setModel(preferredModel);
+    return;
+  }
+  if (!currentModel && availableModels[0]) {
+    await params.session.setModel(availableModels[0]);
+  }
+}
+
 // src/agent/interactiveAuth.ts
 function modeAsAny(mode) {
   return mode;
@@ -1674,43 +1856,37 @@ async function showInput(mode, title, placeholder) {
 }
 async function refreshAfterCredentialChange(mode, preferredProviderId, preferredModelId) {
   const modeAny = modeAsAny(mode);
-  modeAny.session.modelRegistry.refresh();
+  await refreshSessionAfterCredentialChange({
+    session: modeAny.session,
+    modelRegistry: modeAny.session.modelRegistry,
+    preferredProviderId,
+    preferredModelId
+  });
   await modeAny.updateAvailableProviderCount?.();
-  const availableModels = modeAny.session.modelRegistry.getAvailable();
-  const preferredModel = preferredProviderId && preferredModelId ? availableModels.find((model) => model.provider === preferredProviderId && model.id === preferredModelId) : preferredProviderId ? availableModels.find((model) => model.provider === preferredProviderId) : void 0;
-  const currentModel = modeAny.session.model;
-  const currentModelStillAvailable = currentModel ? availableModels.some((model) => model.provider === currentModel.provider && model.id === currentModel.id) : false;
-  if (currentModel && !currentModelStillAvailable) {
-    if (preferredModel) {
-      await modeAny.session.setModel(preferredModel);
-      return;
-    }
-    if (availableModels[0]) {
-      await modeAny.session.setModel(availableModels[0]);
-    }
-    return;
-  }
-  if (!currentModel && preferredModel) {
-    await modeAny.session.setModel(preferredModel);
-    return;
-  }
-  if (!currentModel && availableModels[0]) {
-    await modeAny.session.setModel(availableModels[0]);
-  }
+}
+function getField(provider, modelIdsByProvider, fieldName) {
+  return getProviderFormFields({
+    provider,
+    modelIdsByProvider
+  }).find((field) => field.name === fieldName);
 }
 async function runApiKeyProviderFlow(mode, dependencies, provider) {
   const modeAny = modeAsAny(mode);
+  const field = (name) => getField(provider, dependencies.modelIdsByProvider, name);
   switch (provider.flow) {
     case "custom-openai": {
-      const baseUrl = await showInput(mode, "Custom OpenAI base URL", "https://my-proxy.example.com/v1");
+      const baseUrlField = field("baseUrl");
+      const apiKeyField = field("apiKey");
+      const modelIdField = field("modelId");
+      const baseUrl = await showInput(mode, baseUrlField?.title || "Custom OpenAI base URL", baseUrlField?.placeholder);
       if (!baseUrl) {
         return;
       }
-      const apiKey = await showInput(mode, "Custom OpenAI API key");
+      const apiKey = await showInput(mode, apiKeyField?.title || "Custom OpenAI API key");
       if (!apiKey) {
         return;
       }
-      const modelId = await showInput(mode, "Model ID", "gpt-4o");
+      const modelId = await showInput(mode, modelIdField?.title || "Model ID", modelIdField?.placeholder);
       if (!modelId) {
         return;
       }
@@ -1725,22 +1901,33 @@ async function runApiKeyProviderFlow(mode, dependencies, provider) {
       return;
     }
     case "azure-openai-responses": {
-      const apiKey = await showInput(mode, "Azure OpenAI API key");
+      const apiKeyField = field("apiKey");
+      const configModeField = field("configMode");
+      const baseUrlField = field("baseUrl");
+      const resourceNameField = field("resourceName");
+      const modelIdField = field("modelId");
+      const deploymentNameField = field("deploymentName");
+      const apiVersionField = field("apiVersion");
+      const apiKey = await showInput(mode, apiKeyField?.title || "Azure OpenAI API key");
       if (!apiKey) {
         return;
       }
-      const configMode = await showSelection(mode, "Azure OpenAI configuration", [
-        { value: "base-url", label: "Use a base URL" },
-        { value: "resource-name", label: "Use an Azure resource name" }
-      ]);
+      const configMode = await showSelection(
+        mode,
+        configModeField?.title || "Azure OpenAI configuration",
+        (configModeField?.options ?? []).map((option) => ({
+          value: option.value,
+          label: option.label
+        }))
+      );
       if (!configMode) {
         return;
       }
       let baseUrl;
       if (configMode === "base-url") {
-        baseUrl = await showInput(mode, "Azure OpenAI base URL", "https://my-resource.openai.azure.com/openai/v1");
+        baseUrl = await showInput(mode, baseUrlField?.title || "Azure OpenAI base URL", baseUrlField?.placeholder);
       } else {
-        const resourceName = await showInput(mode, "Azure resource name", "my-resource");
+        const resourceName = await showInput(mode, resourceNameField?.title || "Azure resource name", resourceNameField?.placeholder);
         if (resourceName) {
           baseUrl = `https://${resourceName}.openai.azure.com/openai/v1`;
         }
@@ -1748,12 +1935,15 @@ async function runApiKeyProviderFlow(mode, dependencies, provider) {
       if (!baseUrl) {
         return;
       }
-      const modelId = await showInput(mode, "Model ID", dependencies.modelIdsByProvider["azure-openai-responses"]?.[0] || "gpt-4.1");
+      const modelId = modelIdField?.options?.length ? await showSelection(mode, modelIdField.title, modelIdField.options.map((option) => ({
+        value: option.value,
+        label: option.label
+      }))) : await showInput(mode, modelIdField?.title || "Model ID", modelIdField?.placeholder || modelIdField?.defaultValue);
       if (!modelId) {
         return;
       }
-      const deploymentName = await showInput(mode, "Deployment name (optional)", modelId);
-      const apiVersion = await showInput(mode, "API version (optional)", "2025-03-01-preview");
+      const deploymentName = await showInput(mode, deploymentNameField?.title || "Deployment name", deploymentNameField?.placeholder || modelId);
+      const apiVersion = await showInput(mode, apiVersionField?.title || "API version", apiVersionField?.placeholder || apiVersionField?.defaultValue);
       const builtInModelIds = new Set(dependencies.modelIdsByProvider["azure-openai-responses"] || []);
       await saveAzureConfig({
         ...dependencies,
@@ -1769,10 +1959,21 @@ async function runApiKeyProviderFlow(mode, dependencies, provider) {
       return;
     }
     case "amazon-bedrock": {
-      const authMode = await showSelection(mode, "Amazon Bedrock authentication", [
-        { value: "profile", label: "Use an AWS profile" },
-        { value: "access-keys", label: "Paste AWS access keys" }
-      ]);
+      const authModeField = field("authMode");
+      const profileField = field("profile");
+      const accessKeyIdField = field("accessKeyId");
+      const secretAccessKeyField = field("secretAccessKey");
+      const sessionTokenField = field("sessionToken");
+      const regionField = field("region");
+      const modelIdField = field("modelId");
+      const authMode = await showSelection(
+        mode,
+        authModeField?.title || "Amazon Bedrock authentication",
+        (authModeField?.options ?? []).map((option) => ({
+          value: option.value,
+          label: option.label
+        }))
+      );
       if (!authMode) {
         return;
       }
@@ -1781,26 +1982,29 @@ async function runApiKeyProviderFlow(mode, dependencies, provider) {
       let secretAccessKey;
       let sessionToken;
       if (authMode === "profile") {
-        profile = await showInput(mode, "AWS profile name", "default");
+        profile = await showInput(mode, profileField?.title || "AWS profile name", profileField?.placeholder || profileField?.defaultValue);
         if (!profile) {
           return;
         }
       } else {
-        accessKeyId = await showInput(mode, "AWS access key ID");
+        accessKeyId = await showInput(mode, accessKeyIdField?.title || "AWS access key ID");
         if (!accessKeyId) {
           return;
         }
-        secretAccessKey = await showInput(mode, "AWS secret access key");
+        secretAccessKey = await showInput(mode, secretAccessKeyField?.title || "AWS secret access key");
         if (!secretAccessKey) {
           return;
         }
-        sessionToken = await showInput(mode, "AWS session token (optional)");
+        sessionToken = await showInput(mode, sessionTokenField?.title || "AWS session token");
       }
-      const region = await showInput(mode, "AWS region", "us-east-1");
+      const region = await showInput(mode, regionField?.title || "AWS region", regionField?.placeholder || regionField?.defaultValue);
       if (!region) {
         return;
       }
-      const modelId = await showInput(mode, "Bedrock model ID", dependencies.modelIdsByProvider["amazon-bedrock"]?.[0] || "anthropic.claude-3-7-sonnet-20250219-v1:0");
+      const modelId = modelIdField?.options?.length ? await showSelection(mode, modelIdField.title, modelIdField.options.map((option) => ({
+        value: option.value,
+        label: option.label
+      }))) : await showInput(mode, modelIdField?.title || "Bedrock model ID", modelIdField?.placeholder || modelIdField?.defaultValue);
       if (!modelId) {
         return;
       }