@docyrus/docyrus 0.0.32 → 0.0.34

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docyrus/docyrus",
-  "version": "0.0.32",
+  "version": "0.0.34",
   "private": false,
   "description": "Docyrus API CLI",
   "main": "./main.js",

package/resources/pi-agent/skills/officecli/SKILL.md

@@ -0,0 +1,113 @@
+---
+name: officecli
+description: Use OfficeCLI to create, inspect, validate, and modify Office documents (.docx, .xlsx, .pptx) from the terminal. Use when the user wants Office document automation, extraction, validation, or editing.
+---
+
+# OfficeCLI
+
+OfficeCLI is available in Docyrus pi sessions as a local command-line tool for Word, Excel, and PowerPoint files.
+
+Use the CLI directly in this environment. Do not run `officecli mcp ...` unless the user explicitly asks to register OfficeCLI with another editor or agent.
+
+## First Principles
+
+- Prefer structured output by adding `--json` whenever you need to inspect or transform results.
+- Work from higher-level commands down:
+  - L1 read and inspection: `view`, `get`, `query`, `validate`
+  - L2 DOM edits: `set`, `add`, `remove`, `move`, `batch`
+  - L3 raw XML fallback: `raw`, `raw-set`, `add-part`
+- When unsure about element names, property names, or allowed value formats, run help instead of guessing.
+- After making changes, run `officecli validate <file>` and, when useful, `officecli view <file> issues`.
+- For multi-step edits on a single file, use `open` and `close` to keep the document in memory.
+
+## Verify Availability
+
+```bash
+officecli --version
+officecli --help
+```
+
+If a command fails unexpectedly, inspect the help for the specific document type before trying alternatives.
+
+## Help-First Workflow
+
+```bash
+officecli docx set
+officecli docx set paragraph
+officecli xlsx set cell.value
+officecli pptx add chart
+officecli pptx query
+```
+
+Use the deepest help entry you already know. One help lookup is better than guessing and retrying.
+
+## Common Commands
+
+Create a new document:
+
+```bash
+officecli create report.docx
+officecli create model.xlsx
+officecli create deck.pptx
+```
+
+Inspect document structure or extracted text:
+
+```bash
+officecli view report.docx outline
+officecli view report.docx text --max-lines 80
+officecli view deck.pptx issues
+officecli get deck.pptx /slide[1] --depth 1 --json
+officecli query model.xlsx 'cell[value~=Revenue]' --json
+```
+
+Modify content:
+
+```bash
+officecli set report.docx /body/p[1] --prop style=Heading1 --prop text="Executive Summary"
+officecli add deck.pptx / --type slide --prop title="Q4 Report"
+officecli add deck.pptx /slide[1] --type shape --prop text="Revenue grew 25%" --prop x=2cm --prop y=5cm
+officecli set model.xlsx /Sheet1/A1 --prop value="Name" --prop bold=true
+```
+
+Batch related changes:
+
+```bash
+echo '[{"command":"set","path":"/Sheet1/A1","props":{"value":"Name","bold":"true"}},{"command":"set","path":"/Sheet1/B1","props":{"value":"Score","bold":"true"}}]' | officecli batch model.xlsx --json
+```
+
+Keep a document open for a longer edit session:
+
+```bash
+officecli open report.docx
+officecli set report.docx /body/p[2] --prop text="Updated paragraph"
+officecli close report.docx
+```
+
+## Practical Guidance
+
+- Prefer `view`, `get`, or `query` to understand the document before editing it.
+- Use `query` to locate matching elements instead of hard-coding guessed paths.
+- Keep outputs bounded for large files with flags such as `--max-lines`, `--start`, or `--end`.
+- Path indexing is 1-based: `/body/p[3]` means the third paragraph.
+- Use `batch` when several changes should be applied in one save cycle.
+- Use `watch` for PowerPoint only when the user explicitly wants a live preview flow.
+
+## When Raw XML Is Appropriate
+
+Only fall back to `raw` or `raw-set` when:
+
+- the higher-level commands cannot express the change,
+- you already inspected the target part with `get` or `raw`,
+- and you are prepared to validate immediately afterwards.
+
+## Validation Checklist
+
+After editing:
+
+```bash
+officecli validate <file>
+officecli view <file> issues
+```
+
+If validation fails, fix the issue before presenting the result as complete.

package/server-loader.js

@@ -3515,7 +3515,7 @@ function createCustomOpenAiProviderConfig(params) {
 function createAzureProviderConfig(params) {
   const providerConfig = {
     baseUrl: params.baseUrl,
-    apiKey: "env:AZURE_OPENAI_API_KEY"
+    apiKey: "AZURE_OPENAI_API_KEY"
   };
   if (params.useCustomModel) {
     providerConfig.api = "azure-openai-responses";
@@ -3544,6 +3544,22 @@ function trimOrUndefined(value) {
   const trimmed = value?.trim();
   return trimmed && trimmed.length > 0 ? trimmed : void 0;
 }
+function normalizeAzureBaseUrl(baseUrl) {
+  const trimmed = baseUrl.trim().replace(/\/+$/, "");
+  try {
+    const url = new URL(trimmed);
+    url.search = "";
+    url.hash = "";
+    if (url.pathname.endsWith("/openai/v1")) {
+      url.pathname = url.pathname.slice(0, -3);
+    } else if (url.pathname.endsWith("/openai/responses")) {
+      url.pathname = url.pathname.slice(0, -10);
+    }
+    return url.toString().replace(/\/+$/, "");
+  } catch {
+    return trimmed.replace(/\/openai\/v1$/i, "/openai").replace(/\/openai\/responses$/i, "/openai");
+  }
+}
 async function saveGenericApiKey(params) {
   params.authStorage.set(params.providerId, {
     type: "api_key",
@@ -3570,6 +3586,7 @@ async function saveCustomOpenAiConfig(params) {
 async function saveAzureConfig(params) {
   const modelId = params.modelId.trim();
   const useCustomModel = params.useCustomModel ?? false;
+  const normalizedBaseUrl = normalizeAzureBaseUrl(params.baseUrl);
   params.authStorage.set("azure-openai-responses", {
     type: "api_key",
     key: params.apiKey.trim()
@@ -3594,7 +3611,7 @@ async function saveAzureConfig(params) {
   }
   await params.envStore.setMany(envValues);
   await upsertModelsProvider(params.modelsJsonPath, "azure-openai-responses", createAzureProviderConfig({
-    baseUrl: params.baseUrl.trim(),
+    baseUrl: normalizedBaseUrl,
     modelId,
     useCustomModel
   }));
@@ -3841,7 +3858,7 @@ function getProviderFormFields(params) {
           title: "Azure OpenAI base URL",
           required: true,
           component: "text",
-          placeholder: "https://my-resource.openai.azure.com/openai/v1",
+          placeholder: "https://my-resource.openai.azure.com/openai",
           dependsOn: { field: "configMode", equals: "base-url" }
         },
         {
@@ -3870,8 +3887,8 @@ function getProviderFormFields(params) {
           name: "apiVersion",
           title: "API version",
           component: "text",
-          defaultValue: "2025-03-01-preview",
-          placeholder: "2025-03-01-preview"
+          defaultValue: "2025-04-01-preview",
+          placeholder: "2025-04-01-preview"
         }
       ];
     case "amazon-bedrock":
@@ -4063,7 +4080,7 @@ async function applyProviderLogin(params) {
       return { providerId: provider.id, preferredModelId: params.input.modelId };
     }
     case "azure-openai-responses": {
-      const baseUrl = params.input.baseUrl ?? (params.input.resourceName ? `https://${params.input.resourceName}.openai.azure.com/openai/v1` : void 0);
+      const baseUrl = params.input.baseUrl ?? (params.input.resourceName ? `https://${params.input.resourceName}.openai.azure.com/openai` : void 0);
       if (!baseUrl) {
         throw new Error("Azure login requires either baseUrl or resourceName.");
       }
@@ -4103,9 +4120,14 @@ async function applyProviderLogin(params) {
   }
 }
 async function refreshSessionAfterCredentialChange(params) {
+  await params.envStore?.hydrateProcessEnv(process.env);
   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;
+  if (preferredModel) {
+    await params.session.setModel(preferredModel);
+    return;
+  }
   const currentModel = params.session.model;
   const currentModelStillAvailable = currentModel ? availableModels.some((model) => model.provider === currentModel.provider && model.id === currentModel.id) : false;
   if (currentModel && !currentModelStillAvailable) {
@@ -5436,6 +5458,7 @@ async function createAgentServer(params) {
       await refreshSessionAfterCredentialChange({
         session: activeSession,
         modelRegistry,
+        envStore: authRuntime.envStore,
         preferredProviderId: result.providerId,
         preferredModelId: result.preferredModelId
       });
@@ -5467,6 +5490,7 @@ async function createAgentServer(params) {
         await refreshSessionAfterCredentialChange({
           session: activeSession,
           modelRegistry,
+          envStore: authRuntime.envStore,
           preferredProviderId: providerId
         });
       }
@@ -5498,7 +5522,8 @@ async function createAgentServer(params) {
       modelRegistry.refresh();
       await refreshSessionAfterCredentialChange({
         session: activeSession,
-        modelRegistry
+        modelRegistry,
+        envStore: authRuntime.envStore
       });
       return c.json({
         ok: true,