zcode-acp-server 0.1.0 → 0.3.0

package/dist/config/runtime-model.js

@@ -1,87 +1,129 @@
 /**
  * runtimeModel overlay plumbing.
  *
- * The backend resolves auth from its OAuth token store, so the `runtimeModel`
- * provider deliberately carries NO `apiKey` (the config.json apiKey is the
- * legacy plain key and has expired → 401). Two uses:
+ * The runtimeModel names the provider+model a session should use. For THIRD-
+ * PARTY providers it also carries `apiKey` as `{source:"inline", value:"<key>"}`;
+ * the backend resolves model-call auth from the overlay itself, so omitting it
+ * yields HTTP 401 "Missing API key". Builtin providers keep using their own
+ * OAuth/config auth and never inline a key. `apiFormat` mirrors `kind`.
  *
- *   1. Resume overlay (`buildResumeRuntimeModel`): a resumed session may carry
- *      a stale provider id in its history that the backend can no longer
- *      authenticate. Sending the *current* enabled provider's runtimeModel at
- *      resume makes the backend overlay it and use its own OAuth creds.
+ * Two uses:
+ *
+ *   1. Resume/load overlay (`buildResumeRuntimeModel`): a resumed session may
+ *      carry a stale/revoked model in its history → send fails with "历史模型
+ *      不可用". The overlay pins the session onto the default model — the FIRST
+ *      enabled provider's FIRST model, the same one a fresh `session/new` lands
+ *      on — so resume never inherits the session's last-used (possibly
+ *      third-party / unavailable) model.
  *
  *   2. Model switch (`applyModelSwitch`): UI/slash model switching goes through
- *      `session/updateRuntimeModelConfig` with `applyModelSelection:true` (a
- *      runtime-only change, sidestepping `session/setModel`'s "no loaded config
- *      file" persistence failure).
+ *      `session/setModel` with both a `model` ref and a `runtimeModel` provider
+ *      definition (runtime-only via `persistAsWorkspaceLastUsed:false`).
+ *
+ * Note: a provider registry push (`workspace/updateProviderRegistry`) is ALSO
+ * required for the backend to recognise third-party providers at all — without
+ * it the turn fails with `provider_not_configured` before auth is even tried.
+ * See provider-registry.ts.
  */
-import { readFileSync } from "node:fs";
-import { ZCODE_CREDS_PATH, log, warn } from "../utils.js";
-const DEFAULTS = {
-    providerId: "builtin:bigmodel-coding-plan",
-    kind: "anthropic",
-    baseURL: "https://open.bigmodel.cn/api/anthropic",
-    modelId: "GLM-5.2",
-    models: ["GLM-5.2"],
-};
-/** Read the enabled provider's config from config.json (no apiKey). */
-function readEnabledProvider() {
-    try {
-        const cfg = JSON.parse(readFileSync(ZCODE_CREDS_PATH, "utf8"));
-        for (const [pid, p] of Object.entries(cfg.provider ?? {})) {
-            if (p?.enabled) {
-                const opts = p.options ?? {};
-                const modelKeys = Object.keys(p.models ?? {});
-                return {
-                    providerId: pid,
-                    kind: p.kind ?? DEFAULTS.kind,
-                    baseURL: opts.baseURL || DEFAULTS.baseURL,
-                    modelId: modelKeys[0] ?? DEFAULTS.modelId,
-                    models: modelKeys.length > 0 ? modelKeys : DEFAULTS.models,
-                };
-            }
-        }
+import { buildModelElement } from "./provider-registry.js";
+import { findProviderConfig, formatModelValue, isBuiltinProvider, loadAllModels, parseModelValue, } from "./options.js";
+import { log, warn } from "../utils.js";
+const DEFAULT_KIND = "anthropic";
+const DEFAULT_BASE_URL = "https://open.bigmodel.cn/api/anthropic";
+/** Map config.json `kind` → backend `apiFormat`. */
+function apiFormatForKind(kind) {
+    if (kind?.includes("anthropic"))
+        return "anthropic-messages";
+    return "openai-chat-completions";
+}
+/**
+ * Build a runtimeModel overlay for the given provider+model.
+ *
+ * For THIRD-PARTY providers the overlay MUST carry `apiKey` as the inline union
+ * `{source:"inline", value:"<key>"}` — the backend resolves model-call auth from
+ * the runtimeModel itself, so omitting it yields HTTP 401 "Missing API key".
+ * (This was previously believed unnecessary; live probing proved otherwise.)
+ * Builtin providers resolve auth from their own OAuth/config store, so no
+ * apiKey is sent for them. `apiFormat` mirrors `kind` per the backend's catalog.
+ */
+export function buildRuntimeModel(ref, revision = "bridge") {
+    const p = findProviderConfig(ref.providerId);
+    if (!p) {
+        log(`runtime-model: provider "${ref.providerId}" not in config.json`);
+        return null;
     }
-    catch (e) {
-        log(`runtime-model: read config.json failed (${e instanceof Error ? e.message : String(e)})`);
+    const baseURL = p.options?.baseURL ?? DEFAULT_BASE_URL;
+    // Model elements must carry the full definition (reasoning variants /
+    // contextWindow / label) — a bare {modelId} overlay makes the backend fall
+    // back to the apiFormat's default 2-state thought levels (enabled/disabled),
+    // silently resetting the session's max/high/low dropdown on resume/switch.
+    const models = Object.entries(p.models ?? {}).map(([modelId, m]) => buildModelElement(modelId, (m ?? {})));
+    if (models.length === 0)
+        models.push({ modelId: ref.modelId });
+    const provider = {
+        providerId: ref.providerId,
+        kind: p.kind ?? DEFAULT_KIND,
+        apiFormat: apiFormatForKind(p.kind),
+        baseURL,
+        models,
+    };
+    // Third-party providers must inline their apiKey — the backend won't resolve
+    // it from anywhere else and the call fails with 401 without it. Builtin
+    // providers use OAuth/config auth and must NOT send an inline key.
+    if (!isBuiltinProvider(ref.providerId) && p.options?.apiKey) {
+        provider.apiKey = { source: "inline", value: p.options.apiKey };
     }
-    return DEFAULTS;
-}
-/** Build a runtimeModel overlay object for the enabled provider. */
-export function buildRuntimeModel(modelId, revision = "bridge") {
-    const pc = readEnabledProvider();
-    const targetModel = modelId ?? pc.modelId;
     return {
         revision,
         generatedAt: Date.now(),
-        model: { providerId: pc.providerId, modelId: targetModel },
-        provider: {
-            providerId: pc.providerId,
-            kind: pc.kind,
-            baseURL: pc.baseURL,
-            models: pc.models.map((m) => ({ modelId: m })),
-        },
+        model: { providerId: ref.providerId, modelId: ref.modelId },
+        provider,
     };
 }
-/** Build the resume-time overlay (current enabled provider, default model). */
+/**
+ * Build the resume-time overlay pinned to the default model: the FIRST enabled
+ * provider's FIRST model (the same one a fresh `session/new` lands on). This
+ * ensures resume never inherits the session's last-used model, which may be a
+ * now-unavailable third-party model (e.g. Nvidia) and cause "历史模型不可用".
+ */
 export function buildResumeRuntimeModel() {
-    return buildRuntimeModel(undefined, "bridge-resume");
+    const first = loadAllModels()[0];
+    if (!first) {
+        log("runtime-model: no enabled provider in config.json (resume overlay skipped)");
+        return null;
+    }
+    return buildRuntimeModel(first, "bridge-resume");
 }
 /**
- * Switch a session's model via session/updateRuntimeModelConfig.
+ * Switch a session's model via `session/setModel`.
+ *
+ * `value` is the configOption value: either `"providerId\modelId"` (encoded) or
+ * a legacy plain modelId (resolved to the first enabled builtin provider).
+ *
+ * Sends BOTH a `model` ref (the target) AND a `runtimeModel` (the full provider
+ * definition). The runtimeModel lets the backend register the provider into its
+ * workspace catalog (so even third-party / non-default models are recognised),
+ * while `model` names the selection. `persistAsWorkspaceLastUsed:false` keeps
+ * this a runtime-only change. Invalidates the model cache on success.
  *
- * Uses `applyModelSelection:true` so the change applies at runtime without
- * persistence — sidestepping `session/setModel`'s "no loaded config file"
- * failure. Invalidates the model cache on success. Returns true on success.
+ * NOTE: the older `session/updateRuntimeModelConfig` path returns `changed:false`
+ * on current backends without applying — `session/setModel` is the working
+ * protocol since the backend model-management refactor.
  */
-export async function applyModelSwitch(server, zcodeSid, modelId) {
-    const runtimeModel = buildRuntimeModel(modelId, "bridge-switch");
+export async function applyModelSwitch(server, zcodeSid, value) {
+    const { providerId, modelId } = parseModelValue(value);
+    const runtimeModel = buildRuntimeModel({ providerId, providerName: providerId, modelId });
     if (runtimeModel === null) {
-        log("runtime-model: cannot read provider config (config.json)");
+        log(`runtime-model: cannot build overlay for "${value}" (provider not found)`);
         return false;
     }
     const backend = server.ensureBackend();
-    const resp = await backend.request(server.nextId(), "session/updateRuntimeModelConfig", { sessionId: zcodeSid, runtimeModel, applyModelSelection: true }, 15000);
+    const resp = await backend.request(server.nextId(), "session/setModel", {
+        sessionId: zcodeSid,
+        model: { providerId, modelId },
+        runtimeModel,
+        persistAsWorkspaceLastUsed: false,
+    }, 15000);
     if (resp.error) {
         warn(`runtime-model: switch failed: ${resp.error.message}`);
         return false;
@@ -93,4 +135,6 @@ export async function applyModelSwitch(server, zcodeSid, modelId) {
 export function invalidateModelCache(server, zcodeSid) {
     server.modelCache.delete(zcodeSid);
 }
+// Re-exported so callers that only import runtime-model.ts can format values.
+export { formatModelValue };
 //# sourceMappingURL=runtime-model.js.map

package/dist/config/runtime-model.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-model.js","sourceRoot":"","sources":["../../src/config/runtime-model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime-model.js","sourceRoot":"","sources":["../../src/config/runtime-model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,iBAAiB,EAAmB,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGxC,MAAM,YAAY,GAAG,WAAW,CAAC;AACjC,MAAM,gBAAgB,GAAG,wCAAwC,CAAC;AAElE,oDAAoD;AACpD,SAAS,gBAAgB,CAAC,IAAwB;IAChD,IAAI,IAAI,EAAE,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,oBAAoB,CAAC;IAC7D,OAAO,yBAAyB,CAAC;AACnC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAa,EAAE,QAAQ,GAAG,QAAQ;IAClE,MAAM,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,4BAA4B,GAAG,CAAC,UAAU,sBAAsB,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,IAAI,gBAAgB,CAAC;IACvD,sEAAsE;IACtE,2EAA2E;IAC3E,6EAA6E;IAC7E,2EAA2E;IAC3E,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CACjE,iBAAiB,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAe,CAAC,CACpD,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAA4B;QACxC,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,YAAY;QAC5B,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC;QACnC,OAAO;QACP,MAAM;KACP,CAAC;IACF,6EAA6E;IAC7E,wEAAwE;IACxE,mEAAmE;IACnE,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAC5D,QAAQ,CAAC,MAAM,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;IAClE,CAAC;IACD,OAAO;QACL,QAAQ;QACR,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;QACvB,KAAK,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;QAC3D,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,GAAG,CAAC,4EAA4E,CAAC,CAAC;QAClF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,iBAAiB,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;AACnD,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAsB,EACtB,QAAgB,EAChB,KAAa;IAEb,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,YAAY,GAAG,iBAAiB,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1F,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,GAAG,CAAC,4CAA4C,KAAK,wBAAwB,CAAC,CAAC;QAC/E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAChC,MAAM,CAAC,MAAM,EAAE,EACf,kBAAkB,EAClB;QACE,SAAS,EAAE,QAAQ;QACnB,KAAK,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE;QAC9B,YAAY;QACZ,0BAA0B,EAAE,KAAK;KAClC,EACD,KAAK,CACN,CAAC;IACF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,iCAAiC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5D,OAAO,KAAK,CAAC;IACf,CAAC;IACD,oBAAoB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,oBAAoB,CAAC,MAAsB,EAAE,QAAgB;IAC3E,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED,8EAA8E;AAC9E,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/config/skill-discovery.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Skill discovery — scans the same directories ZCode uses to discover Skills,
+ * reads each SKILL.md frontmatter, and returns entries suitable for the ACP
+ * `available_commands_update` notification.
+ *
+ * Each discovered skill becomes its own `/skill-name` slash command in the
+ * editor's completion menu (matching Claude Code's behaviour). The model
+ * resolves the invocation via its `Skill` tool — the bridge just lists them
+ * and passes the text through.
+ *
+ * Discovery sources (in priority order — first occurrence wins on name clash):
+ *   1. ~/.zcode/skills/*/SKILL.md          (user scope, ZCode native)
+ *   2. ~/.agents/skills/*/SKILL.md          (user scope, shared agents)
+ *   3. enabled plugin <cache>/skills/&#42;/SKILL.md
+ *   4. <cwd>/.agents/skills/&#42;/SKILL.md      (project scope)
+ *
+ * Skills explicitly disabled in `~/.zcode/cli/config.json` (skills map with
+ * `enable: false`, keyed by absolute SKILL.md path) are excluded.
+ */
+/** A slash-command entry compatible with `sendAvailableCommands`. */
+export interface SkillEntry {
+    name: string;
+    description: string;
+    input?: {
+        hint: string;
+    };
+}
+/**
+ * Discover all enabled skills from the filesystem.
+ *
+ * Returns entries suitable for `available_commands_update`. Best-effort:
+ * failures are logged and swallowed (returns whatever was found).
+ */
+export declare function loadSkillCommands(): SkillEntry[];
+//# sourceMappingURL=skill-discovery.d.ts.map

package/dist/config/skill-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-discovery.d.ts","sourceRoot":"","sources":["../../src/config/skill-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AASH,qEAAqE;AACrE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1B;AAkHD;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,EAAE,CAwDhD"}

package/dist/config/skill-discovery.js

@@ -0,0 +1,188 @@
+/**
+ * Skill discovery — scans the same directories ZCode uses to discover Skills,
+ * reads each SKILL.md frontmatter, and returns entries suitable for the ACP
+ * `available_commands_update` notification.
+ *
+ * Each discovered skill becomes its own `/skill-name` slash command in the
+ * editor's completion menu (matching Claude Code's behaviour). The model
+ * resolves the invocation via its `Skill` tool — the bridge just lists them
+ * and passes the text through.
+ *
+ * Discovery sources (in priority order — first occurrence wins on name clash):
+ *   1. ~/.zcode/skills/*/SKILL.md          (user scope, ZCode native)
+ *   2. ~/.agents/skills/*/SKILL.md          (user scope, shared agents)
+ *   3. enabled plugin <cache>/skills/&#42;/SKILL.md
+ *   4. <cwd>/.agents/skills/&#42;/SKILL.md      (project scope)
+ *
+ * Skills explicitly disabled in `~/.zcode/cli/config.json` (skills map with
+ * `enable: false`, keyed by absolute SKILL.md path) are excluded.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+import process from "node:process";
+import { compareVersions, log } from "../utils.js";
+const HOME = homedir();
+/** Path to the ZCode CLI config (skills enable/disable, plugins, mcp). */
+const CLI_CONFIG_PATH = path.join(HOME, ".zcode", "cli", "config.json");
+/** Root of the plugin cache directory. */
+const PLUGIN_CACHE_DIR = path.join(HOME, ".zcode", "cli", "plugins", "cache");
+/** Max description length before truncation with ellipsis. */
+const MAX_DESC_LEN = 80;
+/**
+ * Parse YAML-like frontmatter from a SKILL.md file.
+ * Returns a map of key→string (values have surrounding quotes stripped).
+ */
+function parseFrontmatter(content) {
+    const fm = {};
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+    if (!match)
+        return fm;
+    const lines = match[1].split(/\r?\n/);
+    for (const line of lines) {
+        const idx = line.indexOf(":");
+        if (idx <= 0)
+            continue;
+        const key = line.slice(0, idx).trim();
+        let val = line.slice(idx + 1).trim();
+        if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'"))) {
+            val = val.slice(1, -1);
+        }
+        if (key)
+            fm[key] = val;
+    }
+    return fm;
+}
+/** Truncate a description to MAX_DESC_LEN, appending "…" if truncated. */
+function truncateDesc(desc) {
+    if (desc.length <= MAX_DESC_LEN)
+        return desc;
+    return desc.slice(0, MAX_DESC_LEN - 1) + "…";
+}
+/** Read the disabled skill paths from config.json (set of absolute paths). */
+function loadDisabledSkillPaths(config) {
+    const disabled = new Set();
+    if (!config?.skills)
+        return disabled;
+    for (const [skillPath, cfg] of Object.entries(config.skills)) {
+        if (cfg?.enable === false)
+            disabled.add(skillPath);
+    }
+    return disabled;
+}
+/** Scan a directory for skill subdirectories containing SKILL.md. */
+function scanSkillDir(dir, disabledPaths, results, seen) {
+    if (!existsSync(dir))
+        return;
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const skillDir = path.join(dir, entry);
+        try {
+            if (!statSync(skillDir).isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        const skillMd = path.join(skillDir, "SKILL.md");
+        if (!existsSync(skillMd))
+            continue;
+        // Resolve absolute path for disabled-check.
+        const absPath = path.resolve(skillMd);
+        if (disabledPaths.has(absPath))
+            continue;
+        const content = readFileSync(skillMd, "utf8");
+        const fm = parseFrontmatter(content);
+        const name = fm["name"] ?? entry;
+        const description = fm["description"] ?? "";
+        if (!description)
+            continue;
+        // Skip explicitly non-user-invocable skills.
+        if (fm["user-invocable"] === "false")
+            continue;
+        // Prefix with $ so the editor groups skills visually (e.g. "$tdd") and
+        // handleSlashCommand can route by prefix.
+        const cmdName = `$${name}`;
+        if (seen.has(cmdName))
+            continue;
+        seen.add(cmdName);
+        const skillEntry = {
+            name: cmdName,
+            description: truncateDesc(description),
+        };
+        // Only request follow-up input when the skill author explicitly declares
+        // an argument-hint — matching plugin-commands.ts behaviour. Skills without
+        // argument-hint (e.g. $tdd, $setup-matt-pocock-skills) send immediately on
+        // selection; skills with one (e.g. $handoff, $teach) wait for user input.
+        const hint = fm["argument-hint"];
+        if (hint)
+            skillEntry.input = { hint };
+        results.push(skillEntry);
+    }
+}
+/**
+ * Discover all enabled skills from the filesystem.
+ *
+ * Returns entries suitable for `available_commands_update`. Best-effort:
+ * failures are logged and swallowed (returns whatever was found).
+ */
+export function loadSkillCommands() {
+    const results = [];
+    const seen = new Set();
+    // Load config for disabled-skills list + enabled-plugins list.
+    let config = null;
+    try {
+        if (existsSync(CLI_CONFIG_PATH)) {
+            config = JSON.parse(readFileSync(CLI_CONFIG_PATH, "utf8"));
+        }
+    }
+    catch (e) {
+        log(`skill-discovery: config read failed (${e instanceof Error ? e.message : String(e)})`);
+    }
+    const disabledPaths = loadDisabledSkillPaths(config);
+    // 1. ~/.zcode/skills/
+    scanSkillDir(path.join(HOME, ".zcode", "skills"), disabledPaths, results, seen);
+    // 2. ~/.agents/skills/
+    scanSkillDir(path.join(HOME, ".agents", "skills"), disabledPaths, results, seen);
+    // 3. Enabled plugin skills.
+    const enabledPlugins = config?.plugins?.enabledPlugins ?? {};
+    for (const [pluginKey, enabledFlag] of Object.entries(enabledPlugins)) {
+        if (!enabledFlag)
+            continue;
+        const atIdx = pluginKey.indexOf("@");
+        if (atIdx <= 0)
+            continue;
+        const pluginName = pluginKey.slice(0, atIdx);
+        const marketplace = pluginKey.slice(atIdx + 1);
+        const pluginDir = path.join(PLUGIN_CACHE_DIR, marketplace, pluginName);
+        if (!existsSync(pluginDir))
+            continue;
+        // Find the latest version directory.
+        let latestVersion = "";
+        try {
+            for (const entry of readdirSync(pluginDir)) {
+                const vDir = path.join(pluginDir, entry);
+                if (statSync(vDir).isDirectory() && compareVersions(entry, latestVersion) > 0) {
+                    latestVersion = entry;
+                }
+            }
+        }
+        catch {
+            continue;
+        }
+        if (!latestVersion)
+            continue;
+        scanSkillDir(path.join(pluginDir, latestVersion, "skills"), disabledPaths, results, seen);
+    }
+    // 4. Project-level .agents/skills/ (if exists).
+    scanSkillDir(path.join(process.cwd(), ".agents", "skills"), disabledPaths, results, seen);
+    log(`skill-discovery: loaded ${results.length} skill(s)`);
+    return results;
+}
+//# sourceMappingURL=skill-discovery.js.map

package/dist/config/skill-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-discovery.js","sourceRoot":"","sources":["../../src/config/skill-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAgBnD,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;AAEvB,0EAA0E;AAC1E,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;AAExE,0CAA0C;AAC1C,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAE9E,8DAA8D;AAC9D,MAAM,YAAY,GAAG,EAAE,CAAC;AAExB;;;GAGG;AACH,SAAS,gBAAgB,CAAC,OAAe;IACvC,MAAM,EAAE,GAA2B,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC3D,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,GAAG,IAAI,CAAC;YAAE,SAAS;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACtC,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC7F,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;QACD,IAAI,GAAG;YAAE,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACzB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,0EAA0E;AAC1E,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,IAAI,CAAC,MAAM,IAAI,YAAY;QAAE,OAAO,IAAI,CAAC;IAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;AAC/C,CAAC;AAED,8EAA8E;AAC9E,SAAS,sBAAsB,CAAC,MAAwB;IACtD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,MAAM;QAAE,OAAO,QAAQ,CAAC;IACrC,KAAK,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7D,IAAI,GAAG,EAAE,MAAM,KAAK,KAAK;YAAE,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,qEAAqE;AACrE,SAAS,YAAY,CACnB,GAAW,EACX,aAA0B,EAC1B,OAAqB,EACrB,IAAiB;IAEjB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO;IAC7B,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE;gBAAE,SAAS;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,SAAS;QAEnC,4CAA4C;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,SAAS;QAEzC,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC9C,MAAM,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC;QACjC,MAAM,WAAW,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,WAAW;YAAE,SAAS;QAE3B,6CAA6C;QAC7C,IAAI,EAAE,CAAC,gBAAgB,CAAC,KAAK,OAAO;YAAE,SAAS;QAE/C,uEAAuE;QACvE,0CAA0C;QAC1C,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,SAAS;QAChC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClB,MAAM,UAAU,GAAe;YAC7B,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,YAAY,CAAC,WAAW,CAAC;SACvC,CAAC;QACF,yEAAyE;QACzE,2EAA2E;QAC3E,2EAA2E;QAC3E,0EAA0E;QAC1E,MAAM,IAAI,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;QACjC,IAAI,IAAI;YAAE,UAAU,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,+DAA+D;IAC/D,IAAI,MAAM,GAAqB,IAAI,CAAC;IACpC,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YAChC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAc,CAAC;QAC1E,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,GAAG,CAAC,wCAAwC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,aAAa,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAErD,sBAAsB;IACtB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAEhF,uBAAuB;IACvB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAEjF,4BAA4B;IAC5B,MAAM,cAAc,GAAG,MAAM,EAAE,OAAO,EAAE,cAAc,IAAI,EAAE,CAAC;IAC7D,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QACtE,IAAI,CAAC,WAAW;YAAE,SAAS;QAC3B,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,KAAK,IAAI,CAAC;YAAE,SAAS;QACzB,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC7C,MAAM,WAAW,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAE/C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QACvE,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,SAAS;QAErC,qCAAqC;QACrC,IAAI,aAAa,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;gBACzC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,IAAI,eAAe,CAAC,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC9E,aAAa,GAAG,KAAK,CAAC;gBACxB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,CAAC,aAAa;YAAE,SAAS;QAE7B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5F,CAAC;IAED,gDAAgD;IAChD,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAE1F,GAAG,CAAC,2BAA2B,OAAO,CAAC,MAAM,WAAW,CAAC,CAAC;IAC1D,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/handlers/account.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Account-level usage stats — Proposal 0002 (`account/usage_stats`).
+ *
+ * Exposes the combined dual-provider quota behind the `zcode-quota` CLI
+ * (GLM Coding Plan + Opencode Go) to remote clients as a pull-only ACP
+ * method, callable any time after `initialize` (no session required — quota
+ * is account-level, so it fits no `session/update` kind).
+ *
+ * The response mirrors the CLI card's data model so clients can reproduce it
+ * exactly: one GLM section (plan level + per-window items with per-model
+ * details) and one Opencode Go section (rolling/weekly/monthly windows, the
+ * relative reset countdown converted to an absolute timestamp). Provider
+ * failures are reported per-section as `kind` strings rather than throwing —
+ * the client renders the same status line the CLI would (a `not_configured`
+ * Go section is simply omitted, matching the CLI).
+ */
+import type { GoQueryResult, GoWindowKey } from "../quota/opencode-go/types.js";
+import type { QuotaItem, QuotaResult } from "../quota/types.js";
+/** GLM section — `items` present only on success. */
+export interface GlmUsageStats {
+    kind: QuotaResult["kind"];
+    level?: string;
+    items?: QuotaItem[];
+}
+/** One Opencode Go window with the reset countdown resolved to epoch ms. */
+export interface GoWindowEntry {
+    key: GoWindowKey;
+    label: string;
+    usagePercent: number;
+    resetsAt: number;
+}
+/** Opencode Go section — `windows` present only on success. */
+export interface GoUsageStats {
+    kind: GoQueryResult["kind"];
+    windows?: GoWindowEntry[];
+}
+export interface UsageStatsResult {
+    glm: GlmUsageStats;
+    opencode: GoUsageStats;
+}
+/** `account/usage_stats` handler — both providers, queried in parallel. */
+export declare function accountUsageStats(): Promise<UsageStatsResult>;
+//# sourceMappingURL=account.d.ts.map

package/dist/handlers/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../src/handlers/account.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhE,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,WAAW,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,+DAA+D;AAC/D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,aAAa,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;CACxB;AAsCD,2EAA2E;AAC3E,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAGnE"}

package/dist/handlers/account.js

@@ -0,0 +1,59 @@
+/**
+ * Account-level usage stats — Proposal 0002 (`account/usage_stats`).
+ *
+ * Exposes the combined dual-provider quota behind the `zcode-quota` CLI
+ * (GLM Coding Plan + Opencode Go) to remote clients as a pull-only ACP
+ * method, callable any time after `initialize` (no session required — quota
+ * is account-level, so it fits no `session/update` kind).
+ *
+ * The response mirrors the CLI card's data model so clients can reproduce it
+ * exactly: one GLM section (plan level + per-window items with per-model
+ * details) and one Opencode Go section (rolling/weekly/monthly windows, the
+ * relative reset countdown converted to an absolute timestamp). Provider
+ * failures are reported per-section as `kind` strings rather than throwing —
+ * the client renders the same status line the CLI would (a `not_configured`
+ * Go section is simply omitted, matching the CLI).
+ */
+import { queryCombined } from "../quota/combined.js";
+/** Window labels matching the CLI's card (`5h` / `Week` / `Month`). */
+const GO_WINDOW_LABELS = {
+    rolling: "5h",
+    weekly: "Week",
+    monthly: "Month",
+};
+/** GLM items pass through verbatim — the client renders the CLI layout. */
+function toGlmStats(result) {
+    if (result.kind !== "success")
+        return { kind: result.kind };
+    return { kind: "success", level: result.level, items: result.items };
+}
+/**
+ * Go windows with the same absolute-reset math the CLI formatter uses:
+ * subtract the elapsed time since the fetch snapshot from `resetInSec`.
+ */
+function toGoStats(result, now = Date.now()) {
+    if (result.kind !== "success")
+        return { kind: result.kind };
+    const elapsedSec = Math.max(0, (now - result.fetchedAt) / 1000);
+    const windows = ["rolling", "weekly", "monthly"].flatMap((key) => {
+        const w = result[key];
+        if (!w)
+            return [];
+        const remainingSec = Math.max(0, w.resetInSec - elapsedSec);
+        return [
+            {
+                key,
+                label: GO_WINDOW_LABELS[key],
+                usagePercent: w.usagePercent,
+                resetsAt: result.fetchedAt + remainingSec * 1000,
+            },
+        ];
+    });
+    return { kind: "success", windows };
+}
+/** `account/usage_stats` handler — both providers, queried in parallel. */
+export async function accountUsageStats() {
+    const { glm, go } = await queryCombined("all");
+    return { glm: toGlmStats(glm), opencode: toGoStats(go) };
+}
+//# sourceMappingURL=account.js.map

package/dist/handlers/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../src/handlers/account.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AA8BrD,uEAAuE;AACvE,MAAM,gBAAgB,GAAgC;IACpD,OAAO,EAAE,IAAI;IACb,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,OAAO;CACjB,CAAC;AAEF,2EAA2E;AAC3E,SAAS,UAAU,CAAC,MAAmB;IACrC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;AACvE,CAAC;AAED;;;GAGG;AACH,SAAS,SAAS,CAAC,MAAqB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IACxD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;IAChE,MAAM,OAAO,GAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAW,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QAC1E,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;QAClB,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,GAAG,UAAU,CAAC,CAAC;QAC5D,OAAO;YACL;gBACE,GAAG;gBACH,KAAK,EAAE,gBAAgB,CAAC,GAAG,CAAC;gBAC5B,YAAY,EAAE,CAAC,CAAC,YAAY;gBAC5B,QAAQ,EAAE,MAAM,CAAC,SAAS,GAAG,YAAY,GAAG,IAAI;aACjD;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AACtC,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,EAAE,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;AAC3D,CAAC"}