weaver-work-cli 0.1.32 → 0.1.36

package/dist/chunks/{workflow-DJ7SYWAF.js → workflow-D74NFK3C.js}

@@ -2,15 +2,22 @@ import { createRequire as __esbuildCreateRequire } from 'node:module';
 const require = __esbuildCreateRequire(import.meta.url);
 import {
   createWorkflowHost
-} from "./chunk-WSKBSQ2U.js";
+} from "./chunk-VPXOPQJI.js";
 import {
+  USER_INTENT_RULE_FILE,
+  aigroupUserDir,
   asObject,
   assertNoForbiddenKeys,
   compactStdoutPaths,
+  emptyRuleFile,
   getWorkflowOperation,
+  loadRuleFile,
+  loadRules,
+  resetActiveRules,
+  validateRuleFile,
   workflowOperationDefinitions,
   workflowSuccess
-} from "./chunk-WKI2FBIQ.js";
+} from "./chunk-VPUTVEMC.js";
 import {
   createWorkflowContinuationSigner
 } from "./chunk-EZALDOQH.js";
@@ -21,8 +28,8 @@ import {
 } from "./chunk-FMPJJYYI.js";
 import "./chunk-EG6ZU444.js";
 import "./chunk-AJ62BGAW.js";
-import "./chunk-DW6AUUKS.js";
-import "./chunk-2GA5ZIQL.js";
+import "./chunk-JUXVYKII.js";
+import "./chunk-JNG42JKG.js";
 import {
   isCliError,
   toErrorEnvelope
@@ -82,6 +89,8 @@ function clarificationEnvelope(error, operation) {
   const candidates = Array.isArray(details.candidates) ? details.candidates : [];
   const question = typeof details.clarificationQuestion === "string" && details.clarificationQuestion ? details.clarificationQuestion : error.message;
   const reason = typeof details.clarificationReason === "string" ? details.clarificationReason : "";
+  const missingInput = Array.isArray(details.missingInput) ? details.missingInput.map(String) : [];
+  const requiredInput = details.requiredInput && typeof details.requiredInput === "object" ? details.requiredInput : null;
   return workflowSuccess(operation, {
     type: "workflowClarification",
     status: "NEEDS_CLARIFICATION",
@@ -89,6 +98,8 @@ function clarificationEnvelope(error, operation) {
     clarificationKeyword: details.clarificationKeyword ?? null,
     clarificationQuestion: question,
     ...reason ? { clarificationReason: reason } : {},
+    ...missingInput.length ? { missingInput } : {},
+    ...missingInput.length && requiredInput ? { requiredInput } : {},
     candidates,
     candidateCount: candidates.length,
     note: clarificationNote(reason, candidates.length)
@@ -96,6 +107,9 @@ function clarificationEnvelope(error, operation) {
 }
 function clarificationNote(reason, candidateCount) {
   const base = "\u8FD9\u4E0D\u662F\u5931\u8D25\uFF0C\u4E5F**\u4E0D\u4EE3\u8868\u67E5\u8BE2\u5DF2\u6267\u884C**\uFF1A\u672C\u6B21\u67E5\u8BE2\u5DF2\u505C\u6B62\uFF0C\u6CA1\u6709\u8FD4\u56DE\u4EFB\u4F55\u6D41\u7A0B\u6570\u636E\u3002";
+  if (reason === "workflow_required") {
+    return "\u672C\u6B21\u547D\u4EE4**\u6CA1\u6709\u62FF\u5230\u5FC5\u586B\u5165\u53C2 `workflow`**\uFF08\u6CA1\u5199\u8FD9\u4E2A\u952E\u3001\u7A7A\u6570\u7EC4\u3001\u7A7A\u5B57\u7B26\u4E32\u90FD\u7B97\u6CA1\u7ED9\uFF09\u2014\u2014\u547D\u4EE4\u505C\u5728\u4E86\u67E5\u8BE2\u4E4B\u524D\uFF1A**\u6CA1\u6709\u53D1\u8D77\u4EFB\u4F55\u6D41\u7A0B**\uFF0C\u4E5F\u6CA1\u6709\u53BB\u67E5\u53EF\u53D1\u8D77\u5217\u8868\uFF0C\u8FD9\u65E2\u4E0D\u662F\u6267\u884C\u5931\u8D25\uFF0C\u4E5F\u4E0D\u4EE3\u8868\u300C\u6CA1\u6709\u5339\u914D\u7684\u6D41\u7A0B\u300D\u3002\u8BF7\u5148\u5411\u7528\u6237\u786E\u8BA4\u8981\u53D1\u8D77\u54EA\u4E2A\u6D41\u7A0B\uFF08**\u5FC5\u987B\u95EE\uFF0C\u4E0D\u8981\u81EA\u5DF1\u731C\uFF0C\u4E5F\u4E0D\u8981\u62FF\u76F8\u4F3C\u7684\u540D\u5B57\u4EE3\u66FF**\uFF09\uFF0C\u518D\u6309 `requiredInput.workflow` \u7ED9\u51FA\u7684\u5F62\u6001\u628A\u5165\u53C2\u8865\u4E0A\u3001\u91CD\u53D1\u540C\u4E00\u6761\u547D\u4EE4\u3002\u6CE8\u610F `--input` \u63A5\u6536\u7684\u662F**\u6587\u4EF6\u8DEF\u5F84**\uFF08`-` \u8868\u793A\u6807\u51C6\u8F93\u5165\uFF09\uFF0C\u5185\u8054 JSON \u8981\u7528 `--input-json`\u3002";
+  }
   if (reason === "workflow_not_exist") {
     return base + '\u8BF7\u5982\u5B9E\u544A\u77E5\u7528\u6237\uFF1A\u8BE5\u5DE5\u4F5C\u6D41\u4E0D\u5B58\u5728\uFF08\u53EF\u80FD\u5DF2\u5220\u9664\u6216\u88AB\u505C\u7528\uFF09\uFF0C\u8BF7\u7528\u6237\u6539\u7528\u8BE5\u6D41\u7A0B\u7684\u5B8C\u6574\u540D\u79F0\uFF08\u6216\u5176\u5B83\u53EF\u7528\u4E8E\u68C0\u7D22\u7684\u5173\u952E\u8BCD\uFF09\u91CD\u65B0\u6307\u5B9A\u2014\u2014**\u4E0D\u8981\u5411\u7528\u6237\u7D22\u53D6 ID**\u3002**\u4E0D\u8981**\u8BF4\u6210"\u6CA1\u6709\u53EF\u53D1\u8D77\u7684\u5DE5\u4F5C\u6D41"\u8FD9\u7C7B\u6A21\u7CCA\u8BF4\u6CD5\u2014\u2014\u95EE\u9898\u5C31\u51FA\u5728\u8FD9\u4E2A\u76EE\u6807\u4E0A\u3002';
   }
@@ -129,6 +143,86 @@ async function executeWorkflowOperation(operation, rawInput, context) {
   return result;
 }
 
+// src/shortcuts/workflow/index.ts
+import { join as join2 } from "node:path";
+
+// src/shortcuts/workflow/operations/todoSmartConvert/aigroupStore.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+function normalizeIntentPayload(payload) {
+  if (Array.isArray(payload)) return payload;
+  if (payload && typeof payload === "object") {
+    const record = payload;
+    if (Array.isArray(record.rules)) return record.rules;
+    if (record.workflowName !== void 0) return [record];
+  }
+  throw workflowValidationError("aigroup_invalid", "\u5165\u53C2\u5FC5\u987B\u662F\u89C4\u5219\u5BF9\u8C61\u3001\u89C4\u5219\u6570\u7EC4\uFF0C\u6216 { rules: [...] }");
+}
+function namesOf(rule) {
+  const raw = rule?.workflowName;
+  if (typeof raw === "string") return [raw.trim()].filter(Boolean);
+  if (Array.isArray(raw)) return raw.map((item) => String(item ?? "").trim()).filter(Boolean);
+  return [];
+}
+function saveUserIntents(payload, options = {}) {
+  const dir = options.dir ?? aigroupUserDir(options.ctx);
+  const warnings = [];
+  const entries = normalizeIntentPayload(payload);
+  if (entries.length === 0) throw workflowValidationError("aigroup_invalid", "\u5165\u53C2\u91CC\u6CA1\u6709\u89C4\u5219\u6761\u76EE");
+  const starred = entries.filter((rule) => namesOf(rule).includes("*"));
+  if (starred.length > 0) {
+    throw workflowValidationError(
+      "aigroup_wildcard_unsupported",
+      "\u7528\u6237\u610F\u56FE\u4E0D\u80FD\u4F7F\u7528\u901A\u914D workflowName\u300C*\u300D\uFF1A\u515C\u5E95\u89C4\u5219\u7531 aigroup/default.json \u51B3\u5B9A"
+    );
+  }
+  const check = validateRuleFile({ schemaVersion: 2, defaults: {}, rules: entries });
+  if (check.length > 0) {
+    throw workflowValidationError("aigroup_invalid", `\u89C4\u5219\u6821\u9A8C\u5931\u8D25\uFF1A${check.join("\uFF1B")}`);
+  }
+  const file = join(dir, USER_INTENT_RULE_FILE);
+  const existing = existsSync(file) ? loadRuleFile(file) : emptyRuleFile();
+  if (existing.error) {
+    warnings.push(`${existing.error}\uFF1B\u672C\u6B21\u5C06\u91CD\u5EFA\u8BE5\u6587\u4EF6`);
+  }
+  const byName = /* @__PURE__ */ new Map();
+  const replaced = [];
+  for (const rule of existing.file.rules) {
+    for (const name of namesOf(rule)) byName.set(name, rule);
+  }
+  for (const rule of entries) {
+    const names = namesOf(rule);
+    for (const name of names) {
+      if (byName.has(name)) replaced.push(name);
+      byName.set(name, rule);
+    }
+  }
+  const merged = [...new Set(byName.values())];
+  const text = `${JSON.stringify({ schemaVersion: 2, rules: merged }, null, 2)}
+`;
+  mkdirSync(dir, { recursive: true, mode: 448 });
+  writeFileSync(file, text, { mode: 384 });
+  return { file, saved: entries.length, total: merged.length, replaced: [...new Set(replaced)], warnings };
+}
+function readUserIntents(options = {}) {
+  const dir = options.dir ?? aigroupUserDir(options.ctx);
+  const file = join(dir, USER_INTENT_RULE_FILE);
+  if (!existsSync(file)) return { dir, file, exists: false, error: null, rules: [] };
+  const loaded = loadRuleFile(file);
+  return { dir, file, exists: true, error: loaded.error, rules: loaded.file.rules };
+}
+function clearUserIntents(options = {}) {
+  const dir = options.dir ?? aigroupUserDir(options.ctx);
+  const file = join(dir, USER_INTENT_RULE_FILE);
+  mkdirSync(dir, { recursive: true, mode: 448 });
+  writeFileSync(file, `${JSON.stringify({ schemaVersion: 2, rules: [] }, null, 2)}
+`, { mode: 384 });
+  return file;
+}
+function readRawUserIntents(file) {
+  return readFileSync(file, "utf8");
+}
+
 // src/shortcuts/workflow/index.ts
 function asOptions(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
@@ -218,6 +312,43 @@ async function executeAndPrint(ctx, operation, input) {
     process.exitCode = isCliError(error) ? error.exitCode : 1 /* GeneralError */;
   }
 }
+function fieldNamesOf(inputSchema) {
+  const properties = inputSchema.properties;
+  if (!properties || typeof properties !== "object" || Array.isArray(properties)) return [];
+  return Object.keys(properties);
+}
+function manifestIndex() {
+  return {
+    schemaVersion: workflowManifest.schemaVersion,
+    name: workflowManifest.name,
+    title: workflowManifest.title,
+    version: workflowManifest.version,
+    host: workflowManifest.host,
+    status: workflowManifest.status,
+    sourceSkill: workflowManifest.sourceSkill,
+    capabilities: workflowManifest.capabilities,
+    operationCount: workflowManifest.operations.length,
+    operations: workflowManifest.operations.map((definition) => ({
+      name: definition.name,
+      resource: definition.resource,
+      summary: definition.summary,
+      ...definition.capability ? { capability: definition.capability } : {},
+      risk: definition.risk,
+      ...definition.requiresConfirmation ? { requiresConfirmation: true } : {},
+      fields: fieldNamesOf(definition.inputSchema)
+    })),
+    withheldOperations: workflowManifest.withheldOperations,
+    operationsHint: "\u9ED8\u8BA4\u53EA\u5217 operation \u4E0E\u5B57\u6BB5\u540D\uFF1B\u5B57\u6BB5\u7C7B\u578B\u3001\u679A\u4E3E\u548C\u586B\u5199\u53E3\u5F84\u7528 `workflow schema --operation <name>` \u5355\u53D6\uFF0C\u6574\u4EFD\u5B8C\u6574 manifest \u7528 `workflow schema --full`\u3002"
+  };
+}
+function findOperationContract(name) {
+  const full = name.startsWith("workflow.") ? name : `workflow.${name}`;
+  const matched = workflowManifest.operations.find((definition) => definition.name === full);
+  if (!matched) {
+    throw workflowValidationError("operation_unknown", `\u6D41\u7A0B\u6A21\u5757\u4E0D\u652F\u6301\u64CD\u4F5C\uFF1A${name}`);
+  }
+  return matched;
+}
 function withJsonInputOptions(command) {
   command.option("--input <path>", "JSON input file, or - for stdin").option("--input-json <json>", "inline JSON input object");
   return command;
@@ -228,8 +359,50 @@ var workflowShortcut = {
   category: "shortcut",
   register({ program, action }) {
     const workflow = program.command("workflow").description("\u6CDB\u5FAEE10\u6D41\u7A0B\u667A\u80FD\u52A9\u624B\uFF08\u5F85\u529E/\u5DF2\u529E/\u6211\u53D1\u8D77/\u5168\u90E8\u3001\u8BE6\u60C5\u3001\u64CD\u4F5C\u3001\u6279\u91CF\u3001\u53D1\u8D77\u3001\u4FEE\u6539\uFF09");
-    workflow.command("schema").description("Print workflow operation manifest for agents").action(action((ctx) => {
-      ctx.output.write(workflowManifest, { json: true });
+    workflow.command("schema").description("Print workflow operation manifest for agents").option("--operation <name>", "print one operation with its full inputSchema").option("--full", "print the whole manifest (about 65 KB; stdout may be trimmed)").action(action((ctx, options) => {
+      const opts = asOptions(options);
+      const requested = String(opts.operation ?? "").trim();
+      if (requested && opts.full === true) {
+        throw workflowValidationError("option_conflict", "\u4E0D\u80FD\u540C\u65F6\u4F20 --operation \u548C --full");
+      }
+      if (opts.full === true) {
+        ctx.output.write(workflowManifest, { json: true });
+        return;
+      }
+      if (requested) {
+        ctx.output.write(findOperationContract(requested), { json: true });
+        return;
+      }
+      ctx.output.write(manifestIndex(), { json: true });
+    }));
+    const aigroup = workflow.command("aigroup").description("ai\u4E8C\u6B21\u5206\u7EC4\u89C4\u5219\u5E93\uFF08\u9ED8\u8BA4\u89C4\u5219 + \u7528\u6237\u610F\u56FE\uFF09");
+    aigroup.command("show").description("Print effective ai-group rules (default merged with user intents)").option("--raw", "also print user-intents.json as stored on disk").action(action((ctx, options) => {
+      const opts = asOptions(options);
+      const loaded = loadRules({ ctx });
+      const user = readUserIntents({ ctx });
+      ctx.output.write({
+        dir: loaded.dir,
+        defaultFile: join2(loaded.dir, "default.json"),
+        userIntentFile: user.file,
+        userIntentExists: user.exists,
+        userIntentError: user.error,
+        defaults: loaded.file.defaults,
+        rules: loaded.file.rules,
+        userRules: user.rules,
+        warnings: loaded.warnings,
+        ...opts.raw === true && user.exists ? { rawUserIntents: readRawUserIntents(user.file) } : {}
+      }, { json: true });
+    }));
+    withJsonInputOptions(aigroup.command("set").description("Save user-intent rules: validated, whole-entry replace by workflowName").action(action(async (ctx, options) => {
+      const payload = await inputFrom(options);
+      const result = saveUserIntents(payload, { ctx });
+      resetActiveRules();
+      ctx.output.write(result, { json: true });
+    })));
+    aigroup.command("clear").description("Empty user-intent rules (default.json is never touched)").action(action((ctx) => {
+      const file = clearUserIntents({ ctx });
+      resetActiveRules();
+      ctx.output.write({ cleared: true, file }, { json: true });
     }));
     withJsonInputOptions(workflow.command("run").description("Run a workflow operation with JSON input").argument("<operation>", "operation name, e.g. workflow.search")).action(action(async (ctx, operation, options) => {
       await executeAndPrint(ctx, String(operation), await inputFrom(options));

package/dist/index.js

@@ -7,12 +7,12 @@ import {
   firstPositionalToken,
   registerCommands,
   toCommandMetadata
-} from "./chunks/chunk-6RKD4DRZ.js";
+} from "./chunks/chunk-JYKABYCV.js";
 import "./chunks/chunk-EG6ZU444.js";
 import "./chunks/chunk-AJ62BGAW.js";
-import "./chunks/chunk-H7J4DC5R.js";
-import "./chunks/chunk-DW6AUUKS.js";
-import "./chunks/chunk-2GA5ZIQL.js";
+import "./chunks/chunk-JCSN3JGM.js";
+import "./chunks/chunk-JUXVYKII.js";
+import "./chunks/chunk-JNG42JKG.js";
 import "./chunks/chunk-LUSPKZKY.js";
 import "./chunks/chunk-BUSC6UAE.js";
 
@@ -29,7 +29,7 @@ function lazyShortcut(definition) {
       placeholder.allowExcessArguments(true);
       placeholder.helpOption(false);
       placeholder.action(async () => {
-        const { dispatchLazyShortcut } = await import("./chunks/lazy-dispatch-JQXBW3GM.js");
+        const { dispatchLazyShortcut } = await import("./chunks/lazy-dispatch-QXW7P4X3.js");
         await dispatchLazyShortcut(definition, shortcutMetadata());
       });
     }
@@ -39,102 +39,112 @@ var builtinShortcuts = [
   lazyShortcut({
     name: "invoice",
     description: "E10 \u4E1A\u7968\u901A\u53D1\u7968\u7BA1\u7406 CLI",
-    load: async () => (await import("./chunks/invoice-ZK3WCX2U.js")).invoiceShortcut
+    load: async () => (await import("./chunks/invoice-2Z6YPMIS.js")).invoiceShortcut
   }),
   lazyShortcut({
     name: "ehr",
     description: "\u6CDB\u5FAEE10\u805A\u624D\u6797\uFF08\u4EBA\u4E8B/\u51FA\u52E4/\u85AA\u916C\uFF09CLI",
-    load: async () => (await import("./chunks/ehr-HMFY6VIL.js")).ehrShortcut
+    load: async () => (await import("./chunks/ehr-EAP77IMT.js")).ehrShortcut
+  }),
+  lazyShortcut({
+    name: "cowork",
+    description: "\u6CDB\u5FAEE10\u534F\u4F5C\u533A\uFF08\u534F\u4F5C\u4E8B\u9879/\u8BA8\u8BBA/\u5BA1\u6279/\u5171\u4EAB\u6743\u9650\uFF09CLI",
+    load: async () => (await import("./chunks/cowork-SCPGLBA4.js")).coworkShortcut
   }),
   lazyShortcut({
     name: "archive",
     description: "E10 \u6587\u4E66\u5B9A\u6863\u6848\u7BA1\u7406 CLI",
-    load: async () => (await import("./chunks/archive-UMGX72K6.js")).archiveShortcut
+    load: async () => (await import("./chunks/archive-XBVH7JU7.js")).archiveShortcut
   }),
   lazyShortcut({
     name: "archive-oa",
     description: "E10 \u6863\u6848\u5B9A\u4F4D\u4E0E OA \u5546\u52A1\u5408\u540C\u501F\u9605 CLI",
-    load: async () => (await import("./chunks/archive-oa-N2IYBLF3.js")).archiveOaShortcut
+    load: async () => (await import("./chunks/archive-oa-MZM3EKFQ.js")).archiveOaShortcut
   }),
   lazyShortcut({
     name: "calendar",
     description: "\u6CDB\u5FAEE10\u65E5\u7A0B\u7BA1\u7406 CLI\uFF08\u521B\u5EFA/\u67E5\u8BE2/\u66F4\u65B0/\u5220\u9664/\u5B57\u5178\uFF09",
-    load: async () => (await import("./chunks/calendar-JKPIRKFD.js")).calendarShortcut
+    load: async () => (await import("./chunks/calendar-MXEMTIO4.js")).calendarShortcut
   }),
   lazyShortcut({
     name: "fna",
     description: "\u6CDB\u5FAEE10\u9F50\u4E1A\u6210\u8D39\u63A7\u4E2D\u5FC3\uFF08\u9884\u7B97/\u8D39\u7528\u4E2D\u5FC3/\u501F\u6B3E\u7BA1\u7406/\u53D1\u7968\u6838\u9500\uFF09CLI",
-    load: async () => (await import("./chunks/fna-B7RKPAZD.js")).fnaShortcut
+    load: async () => (await import("./chunks/fna-2X7ZE7BU.js")).fnaShortcut
   }),
   lazyShortcut({
     name: "hrm",
     description: "\u6CDB\u5FAEE10\u7EC4\u7EC7\u7BA1\u7406\uFF08\u5458\u5DE5/\u7EC4\u7EC7/\u5C97\u4F4D\u67E5\u8BE2\uFF09CLI",
-    load: async () => (await import("./chunks/hrm-2KAZGUHI.js")).hrmShortcut
+    load: async () => (await import("./chunks/hrm-YXERJM76.js")).hrmShortcut
   }),
   lazyShortcut({
     name: "mail",
     description: "\u6CDB\u5FAEE10\u90AE\u4EF6\u7BA1\u7406 CLI",
-    load: async () => (await import("./chunks/mail-S2HDDXO2.js")).mailShortcut
+    load: async () => (await import("./chunks/mail-7GZ6CPBJ.js")).mailShortcut
   }),
   lazyShortcut({
     name: "meeting",
     description: "\u6CDB\u5FAEE10\u4F1A\u8BAE\u7BA1\u7406 CLI\uFF08\u6807\u51C6\u7248\uFF1A\u67E5\u8BE2/\u51B2\u7A81/\u9884\u7EA6/\u56DE\u6267/\u7B7E\u5230\uFF09",
-    load: async () => (await import("./chunks/meeting-QVN3I37L.js")).meetingShortcut
+    load: async () => (await import("./chunks/meeting-3NMGA3MB.js")).meetingShortcut
   }),
   lazyShortcut({
     name: "okr",
     description: "\u6CDB\u5FAEE10 OKR \u76EE\u6807\u7BA1\u7406 CLI\uFF08\u76EE\u6807\u67E5\u8BE2/\u65B0\u5EFA/\u7F16\u8F91\u3001\u5173\u952E\u6210\u679C\u3001\u76EE\u6807\u5BF9\u9F50\u3001\u8BC4\u8BBA\uFF09",
-    load: async () => (await import("./chunks/okr-QNG4VC2Q.js")).okrShortcut
+    load: async () => (await import("./chunks/okr-BZ6XUOAG.js")).okrShortcut
   }),
   lazyShortcut({
     name: "plan",
     description: "\u6CDB\u5FAEE10\u8BA1\u5212\u62A5\u544A CLI\uFF08\u67E5\u8BE2/\u65B0\u5EFA/\u4FEE\u6539/\u53D1\u5E03/\u64A4\u56DE/\u63D0\u4EA4\u63D0\u9192/\u8BC4\u8BBA\uFF09",
-    load: async () => (await import("./chunks/plan-A25EMW6U.js")).planShortcut
+    load: async () => (await import("./chunks/plan-DR5CMUYP.js")).planShortcut
   }),
   lazyShortcut({
     name: "esb",
     description: "\u6CDB\u5FAEE10 ESB \u4E2D\u5FC3\u81EA\u5B9A\u4E49\u89E6\u53D1\u52A8\u4F5C\u6D41 CLI",
-    load: async () => (await import("./chunks/esb-ZYSVB7SG.js")).esbShortcut
+    load: async () => (await import("./chunks/esb-2TGGXEE7.js")).esbShortcut
   }),
   lazyShortcut({
     name: "ebuilder-form",
     description: "\u6CDB\u5FAEE10 eBuilder \u8868\u5355\u83DC\u5355\u3001\u5217\u8868\u548C\u8868\u5355\u6570\u636E CLI",
-    load: async () => (await import("./chunks/ebuilder-form-V5FG2EHC.js")).ebuilderFormShortcut
+    load: async () => (await import("./chunks/ebuilder-form-EYLHNOTA.js")).ebuilderFormShortcut
   }),
   lazyShortcut({
     name: "jiuchuanhui",
     description: "\u6CDB\u5FAEE10\u4E5D\u6C1A\u6C47\u8425\u9500\u7BA1\u7406 CLI\uFF08\u5BA2\u6237/\u8054\u7CFB\u4EBA/\u5546\u673A/\u7EBF\u7D22/\u8054\u7CFB\u8BA1\u5212/\u516C\u6D77\uFF09",
-    load: async () => (await import("./chunks/jiuchuanhui-5PQD3IL2.js")).jiuchuanhuiShortcut
+    load: async () => (await import("./chunks/jiuchuanhui-AR5GMKZB.js")).jiuchuanhuiShortcut
   }),
   lazyShortcut({
     name: "asset",
     description: "E10 \u8D44\u4EA7\u7BA1\u7406\uFF08\u8D44\u7BA1\u5BB6\uFF09CLI",
-    load: async () => (await import("./chunks/asset-GLEGKFG5.js")).assetShortcut
+    load: async () => (await import("./chunks/asset-4XO7UOUW.js")).assetShortcut
   }),
   lazyShortcut({
     name: "im",
     description: "\u6CDB\u5FAEE10\u6613\u79D2\u529E\uFF08\u5373\u65F6\u901A\u8BAF\uFF09CLI",
-    load: async () => (await import("./chunks/im-ACJJWH4U.js")).imShortcut
+    load: async () => (await import("./chunks/im-A4VZN2TQ.js")).imShortcut
   }),
   lazyShortcut({
     name: "project",
     description: "\u6CDB\u5FAEE10\u4E8B\u4E95\u7136\u9879\u76EE\u7BA1\u7406 CLI\uFF08\u9879\u76EE/\u4EFB\u52A1\u67E5\u8BE2\u4E0E\u786E\u8BA4\u5199\u5165\uFF09",
-    load: async () => (await import("./chunks/project-G6XV66DZ.js")).projectShortcut
+    load: async () => (await import("./chunks/project-6J63MK33.js")).projectShortcut
   }),
   lazyShortcut({
     name: "workflow",
     description: "\u6CDB\u5FAEE10\u6D41\u7A0B\u667A\u80FD\u52A9\u624B CLI\uFF08\u67E5\u8BE2/\u67E5\u770B/\u64CD\u4F5C/\u6279\u91CF/\u53D1\u8D77/\u4FEE\u6539\uFF09",
-    load: async () => (await import("./chunks/workflow-DJ7SYWAF.js")).workflowShortcut
+    load: async () => (await import("./chunks/workflow-D74NFK3C.js")).workflowShortcut
   }),
   lazyShortcut({
     name: "blog",
     description: "\u6CDB\u5FAEE10\u5DE5\u4F5C\u65E5\u62A5 CLI\uFF08\u67E5\u8BE2/\u53D1\u5E03/\u7F16\u8F91/\u8BC4\u8BBA/\u70B9\u8D5E/\u63D0\u9192/\u5BFC\u51FA\uFF09",
-    load: async () => (await import("./chunks/blog-E44OTVDA.js")).blogShortcut
+    load: async () => (await import("./chunks/blog-PGZKOPSC.js")).blogShortcut
   }),
   lazyShortcut({
     name: "caizhilian",
     description: "\u6CDB\u5FAEE10\u91C7\u77E5\u8FDE\uFF08\u6587\u6863\u4E2D\u5FC3\uFF09CLI",
-    load: async () => (await import("./chunks/caizhilian-DQUFZXZL.js")).caizhilianShortcut
+    load: async () => (await import("./chunks/caizhilian-BH4ZVGUN.js")).caizhilianShortcut
+  }),
+  lazyShortcut({
+    name: "contract",
+    description: "\u6CDB\u5FAEE10\u4ECA\u627F\u8FBE\u5408\u540C\u7BA1\u7406 CLI",
+    load: async () => (await import("./chunks/contract-XI2EEIZU.js")).contractShortcut
   })
 ];
 function shortcutMetadata() {

package/dist/internal/e10/auth-recovery.js

@@ -1,3 +1,4 @@
+import { isXiaoERuntimeAgent } from '../../core/runtime-agent.js';
 import { getActiveProfile } from './auth/session.js';
 import { hasXiaoEEnv, tryXiaoEUnifiedLogin } from './auth/xiaoe.js';
 const AUTH_REQUIRED_CODES = new Set(['-2', '401']);
@@ -94,12 +95,21 @@ export function isE10AuthenticationRequired(response) {
 function globalOptions(ctx) {
     return typeof ctx.getGlobalOptions === 'function' ? ctx.getGlobalOptions() : {};
 }
-/** XiaoE automatic recovery is opt-in through explicit runtime evidence. */
-export function canAutomaticallyRecoverXiaoE(ctx) {
+/**
+ * Decide whether an expired session can be recovered through XiaoE without
+ * involving the caller/Agent. Runtime evidence is preferred, but a persisted
+ * XiaoE login is also authoritative: business commands often run in a fresh
+ * process where the host no longer injects its original XIAOE_* markers.
+ */
+export function canAutomaticallyRecoverXiaoE(ctx, currentSession) {
     const options = globalOptions(ctx);
     // An explicitly supplied auth file is caller-owned and must not be replaced
     // by a profile-backed XiaoE session behind the caller's back.
-    return !options.auth && hasXiaoEEnv(ctx.env || process.env, options);
+    if (options.auth)
+        return false;
+    return hasXiaoEEnv(ctx.env || process.env, options)
+        || currentSession?.loginSource === 'xiaoe-unified'
+        || isXiaoERuntimeAgent(currentSession?.agentType);
 }
 /**
  * Silently refresh a stale XiaoE session. Concurrent requests for the same
@@ -107,7 +117,7 @@ export function canAutomaticallyRecoverXiaoE(ctx) {
  * does not start a burst of login attempts.
  */
 export async function recoverXiaoEAuthSession(ctx, currentSession) {
-    if (!canAutomaticallyRecoverXiaoE(ctx))
+    if (!canAutomaticallyRecoverXiaoE(ctx, currentSession))
         return null;
     const options = globalOptions(ctx);
     const profile = options.profile || getActiveProfile();

package/dist/internal/e10/fetch-timing.js

@@ -0,0 +1,31 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+const storage = new AsyncLocalStorage();
+export function createFetchTimingSink() {
+    return { fetchMs: 0, fetchCount: 0, fetchStart: null, fetchEnd: null };
+}
+/** 在 `sink` 的上下文里执行 `fn`：期间发生的 fetch 都会记到它上面。 */
+export function runWithFetchTiming(sink, fn) {
+    return storage.run(sink, fn);
+}
+/**
+ * fetch 前调一次，拿到的结束函数在 fetch 落定（成功或失败）时调一次。
+ * 返回 `null` 表示当前没有 sink（非计时路径）⇒ 调用方跳过全部计时动作。
+ */
+export function startFetchTiming() {
+    const sink = storage.getStore();
+    if (!sink)
+        return null;
+    const startedAt = Date.now();
+    let finished = false;
+    return () => {
+        if (finished)
+            return;
+        finished = true;
+        const endedAt = Date.now();
+        sink.fetchMs += Math.max(0, endedAt - startedAt);
+        sink.fetchCount += 1;
+        // 重试会有多次 fetch：起点取最早、终点取最晚，中间的空档（如换票据）不计入 fetchCost。
+        sink.fetchStart = sink.fetchStart === null ? startedAt : Math.min(sink.fetchStart, startedAt);
+        sink.fetchEnd = sink.fetchEnd === null ? endedAt : Math.max(sink.fetchEnd, endedAt);
+    };
+}

package/dist/internal/e10/request-runtime.js

@@ -1,5 +1,6 @@
 import { CliError, ExitCode } from '../../core/errors.js';
 import { isE10AuthenticationRequired, recoverXiaoEAuthSession, sameE10SessionIdentity, } from './auth-recovery.js';
+import { startFetchTiming } from './fetch-timing.js';
 const DEFAULT_TIMEOUT_MS = 30_000;
 const DEFAULT_BIG_INT_STRINGS = true;
 const RESERVED_HEADERS = [
@@ -220,6 +221,9 @@ export class E10RequestRuntime {
     async fetchWithTimeout(url, init, timeoutMs) {
         const controller = new AbortController();
         const timer = setTimeout(() => controller.abort(), timeoutMs);
+        // 「纯 fetch」= 发出请求 → 收到响应头（`fetch` 落定那一刻，不含读响应体/解析）。没有计时上下文
+        // （`startFetchTiming()` 返回 `null`）时它什么都不做，非计时路径零开销。
+        const stopFetchTiming = startFetchTiming();
         try {
             return await this.fetchFn(url, { ...init, signal: controller.signal });
         }
@@ -238,6 +242,7 @@ export class E10RequestRuntime {
         }
         finally {
             clearTimeout(timer);
+            stopFetchTiming?.();
         }
     }
     async readResponse(response, responseType, bigIntStrings = DEFAULT_BIG_INT_STRINGS, maxResponseBytes, timeoutMs = DEFAULT_TIMEOUT_MS) {

package/dist/shortcuts/contract/host.js

@@ -3,6 +3,7 @@ import { basename } from 'node:path';
 import { E10_SESSION_EXPIRED_MESSAGE } from '../../internal/e10/auth/messages.js';
 import { requireE10Session } from '../../internal/e10/context.js';
 import { getActiveProfile } from '../../internal/e10/auth/session.js';
+import { E10ApiError, createE10RequestRuntime, } from '../../internal/e10/request-runtime.js';
 import { ContractCliError, contractAuthError, contractNetworkError, contractValidationError, } from './errors.js';
 const DEFAULT_TIMEOUT_MS = 30_000;
 function assertPath(requestPath) {
@@ -16,38 +17,6 @@ function assertPath(requestPath) {
         throw contractValidationError('path_not_allowed', '今承达合同管理只能调用 /api/ 路径');
     }
 }
-function withQuery(baseUrl, requestPath, query = {}) {
-    const url = new URL(`${baseUrl}${requestPath}`);
-    for (const [key, value] of Object.entries(query)) {
-        if (value === undefined || value === null || value === '')
-            continue;
-        if (Array.isArray(value)) {
-            for (const item of value)
-                url.searchParams.append(key, String(item));
-        }
-        else {
-            url.searchParams.set(key, String(value));
-        }
-    }
-    return url;
-}
-async function fetchWithTimeout(url, options, timeoutMs) {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), timeoutMs);
-    try {
-        return await fetch(url, { ...options, signal: controller.signal, redirect: 'manual' });
-    }
-    catch (error) {
-        if (error instanceof Error && error.name === 'AbortError') {
-            throw contractNetworkError('timeout', `请求超时（${timeoutMs}ms）`, { retryable: false });
-        }
-        const message = error instanceof Error ? error.message : String(error);
-        throw contractNetworkError('transport', `请求失败：${message}`, { retryable: true });
-    }
-    finally {
-        clearTimeout(timer);
-    }
-}
 function textOf(value, keys) {
     for (const key of keys) {
         const candidate = value?.[key];
@@ -131,15 +100,6 @@ function inferProfile(ctx) {
     const options = ctx.getGlobalOptions();
     return options.profile || getActiveProfile();
 }
-function requestHeaders(session) {
-    return {
-        Accept: 'application/json, text/plain, */*',
-        Cookie: session.cookieHeader(),
-        eteamsid: session.eteamsId,
-        'User-Agent': session.uaHeader(),
-        Origin: session.getBaseUrl(),
-    };
-}
 export function createContractHost(ctx, dependencies = {}) {
     let e10Session = null;
     let sessionContext = null;
@@ -164,10 +124,9 @@ export function createContractHost(ctx, dependencies = {}) {
         assertPath(path);
         const session = await ensureSession();
         const context = await getSession();
-        const headers = { ...requestHeaders(session), ...(extraHeaders ?? {}) };
-        const finalQuery = { ...query };
+        const finalQuery = Object.fromEntries(Object.entries(query).filter(([, value]) => value !== undefined && value !== null && value !== ''));
         let finalBody = body;
-        const init = { method, headers };
+        let formData;
         if (userIdField) {
             if (!context.userId) {
                 throw contractAuthError('user_id_missing', '当前会话没有可用的用户 ID，请确认 E10 登录态');
@@ -178,9 +137,9 @@ export function createContractHost(ctx, dependencies = {}) {
                 finalBody = { ...finalBody, [userIdField]: context.userId };
         }
         if (form || file) {
-            const data = new FormData();
+            formData = new FormData();
             for (const [key, value] of Object.entries(form ?? {}))
-                data.append(key, value);
+                formData.append(key, value);
             if (file) {
                 let buffer;
                 try {
@@ -190,25 +149,41 @@ export function createContractHost(ctx, dependencies = {}) {
                     throw contractValidationError('file_unreadable', `无法读取文件：${file.path}`);
                 }
                 const filename = file.filename ?? basename(file.path);
-                data.append(file.field ?? 'file', new Blob([new Uint8Array(buffer)], { type: file.contentType ?? 'application/octet-stream' }), filename);
+                formData.append(file.field ?? 'file', new Blob([new Uint8Array(buffer)], { type: file.contentType ?? 'application/octet-stream' }), filename);
             }
-            init.body = data;
         }
-        else if (finalBody !== undefined) {
-            headers['Content-Type'] = 'application/json;charset=UTF-8';
-            init.body = JSON.stringify(finalBody);
+        const runtime = createE10RequestRuntime(ctx, session, {
+            interceptors: dependencies.interceptors,
+            fetch: dependencies.fetch,
+            recoverAuthentication: dependencies.recoverAuthentication,
+        });
+        let response;
+        try {
+            response = await runtime.requestJson({
+                module: 'contract',
+                method,
+                path,
+                query: finalQuery,
+                body: formData ? undefined : finalBody,
+                formData,
+                headers: extraHeaders,
+                timeoutMs,
+            });
+        }
+        catch (error) {
+            if (error instanceof E10ApiError && error.type === 'network') {
+                throw contractNetworkError(error.subtype, error.message, {
+                    retryable: error.retryable,
+                    details: error.details,
+                });
+            }
+            throw error;
         }
-        const url = withQuery(context.baseUrl, path, finalQuery);
-        const response = await fetchWithTimeout(url, init, timeoutMs);
         if (response.status === 401 || response.status === 302) {
             throw contractAuthError('session_expired', E10_SESSION_EXPIRED_MESSAGE, { httpStatus: response.status, path });
         }
-        const text = await response.text();
-        let value = {};
-        try {
-            value = text ? JSON.parse(text) : {};
-        }
-        catch {
+        const { text, value } = response;
+        if (response.parseError) {
             throw contractNetworkError('protocol', `接口返回不是合法 JSON（HTTP ${response.status}）`, {
                 retryable: false,
                 details: { path, status: response.status },