@xrkseek/harness 0.6.21 → 0.7.0-rc.1

package/node_modules/@xrkseek/exec-web/README.md

@@ -1,11 +1,11 @@
-# @xrkseek/exec-web
-
-Web capability seam + model-facing `web_search` / `web_fetch` / `browser_*`.
-
-- **Definition**: `WebSearch` · `WebFetch` · `BrowserSession`
-- **Provider**: anonymous HTTP fetch; Tavily / Brave search when a key is set; HTTP browser session via `createHttpBrowserSession`
-- **Consumer**: `createWebTools(access)` — Face cards via `presentCall` / `presentResult` (`card: "web"`); `createBrowserTools(session)` — `browser_open` / `browser_snapshot` / `browser_act` / `browser_vision`; Host may also mount `browser_vault_list` / `browser_vault_fill` (opaque credential handles)
-
-Tools stay registered when search has no key; execute returns `isError` (`WEB_PROVIDER_UNAVAILABLE`). Fetch and browser session reuse the same URL policy. Browser defaults to an HTTP snapshot/act session; Settings → Plugins → **Browser** (or `XRK_BROWSER_CDP_URL`) selects Chrome DevTools. Vault tools never return secrets in tool results.
-
-See [docs/seams.md](../../../docs/seams.md) · [docs/web-tools.md](../../../docs/web-tools.md).
+# @xrkseek/exec-web
+
+Web capability seam + model-facing `web_search` / `web_fetch` / `browser_*`.
+
+- **Definition**: `WebSearch` · `WebFetch` · `BrowserSession`
+- **Provider**: anonymous HTTP fetch; Tavily / Brave search when a key is set; HTTP browser session via `createHttpBrowserSession`
+- **Consumer**: `createWebTools(access)` — Face cards via `presentCall` / `presentResult` (`card: "web"`); `createBrowserTools(session)` — `browser_open` / `browser_snapshot` / `browser_act` / `browser_vision`; Host may also mount `browser_vault_list` / `browser_vault_fill` (opaque credential handles)
+
+Tools stay registered when search has no key; execute returns `isError` (`WEB_PROVIDER_UNAVAILABLE`). Fetch and browser session reuse the same URL policy. Browser defaults to an HTTP snapshot/act session; Settings → Plugins → **Browser** (or `XRK_BROWSER_CDP_URL`) selects Chrome DevTools. Vault tools never return secrets in tool results.
+
+See [docs/seams.md](../../../docs/seams.md) · [docs/web-tools.md](../../../docs/web-tools.md).

package/node_modules/@xrkseek/llm-deepseek/README.md

@@ -1,22 +1,22 @@
-# @xrkseek/llm-deepseek
-
-Thin `LlmAdapter` for DeepSeek’s **OpenAI-compatible** Chat Completions surface.
-
-Defaults: `https://api.deepseek.com` + model `deepseek-flash` (DeepSeek-V41-Flash).
-Implementation delegates to `@xrkseek/llm-openai-compatible` — optional `reasoning` /
-SSE `reasoning-delta`. Default catalog: `deepseek-flash` (text+image) · `deepseek-v4-pro`.
-Retired ids (`deepseek-v4-flash` · `deepseek-v4-flash-vision-exp`) are omitted from the
-Settings seed but still accepted as Flash aliases when a caller sends them. On the
-**official** host, image-capable routes prefer the **Files API** (`file_id` reuse,
-`~/.xrk/llm-deepseek/files-v3.json`) with inline base64 fallback.
-
-```ts
-import { createDeepSeekAdapter } from "@xrkseek/llm-deepseek";
-
-const llm = createDeepSeekAdapter({
-  apiKey: process.env.DEEPSEEK_API_KEY,
-  // model?: "deepseek-flash" | "deepseek-v4-pro"
-});
-```
-
-Specs: [docs/llm-deepseek.md](../../../docs/llm-deepseek.md).
+# @xrkseek/llm-deepseek
+
+Thin `LlmAdapter` for DeepSeek’s **OpenAI-compatible** Chat Completions surface.
+
+Defaults: `https://api.deepseek.com` + model `deepseek-flash` (DeepSeek-V41-Flash).
+Implementation delegates to `@xrkseek/llm-openai-compatible` — optional `reasoning` /
+SSE `reasoning-delta`. Default catalog: `deepseek-flash` (text+image) · `deepseek-v4-pro`.
+Retired ids (`deepseek-v4-flash` · `deepseek-v4-flash-vision-exp`) are omitted from the
+Settings seed but still accepted as Flash aliases when a caller sends them. On the
+**official** host, image-capable routes prefer the **Files API** (`file_id` reuse,
+`~/.xrk/llm-deepseek/files-v3.json`) with inline base64 fallback.
+
+```ts
+import { createDeepSeekAdapter } from "@xrkseek/llm-deepseek";
+
+const llm = createDeepSeekAdapter({
+  apiKey: process.env.DEEPSEEK_API_KEY,
+  // model?: "deepseek-flash" | "deepseek-v4-pro"
+});
+```
+
+Specs: [docs/llm-deepseek.md](../../../docs/llm-deepseek.md).

package/node_modules/@xrkseek/llm-deepseek/package.json

@@ -1,30 +1,30 @@
-{
-  "name": "@xrkseek/llm-deepseek",
-  "version": "0.1.0",
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "dependencies": {
-    "@xrkseek/attachment": "workspace:*",
-    "@xrkseek/llm": "workspace:*",
-    "@xrkseek/llm-openai-compatible": "workspace:*",
-    "@xrkseek/protocol": "workspace:*",
-    "@xrkseek/xrk-home-paths": "workspace:*"
-  },
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/xrkseek/XRK-harness.git",
-    "directory": "packages/llm/deepseek"
-  },
-  "private": true
-}
+{
+  "name": "@xrkseek/llm-deepseek",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@xrkseek/attachment": "workspace:*",
+    "@xrkseek/llm": "workspace:*",
+    "@xrkseek/llm-openai-compatible": "workspace:*",
+    "@xrkseek/protocol": "workspace:*",
+    "@xrkseek/xrk-home-paths": "workspace:*"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xrkseek/XRK-harness.git",
+    "directory": "packages/llm/deepseek"
+  },
+  "private": true
+}

package/node_modules/@xrkseek/llm-registry/dist/index.d.ts

@@ -1,5 +1,5 @@
-export type { AuthMode, BrandEntry, FactoryKind, ProtocolId, ProviderBinding, ResolveInput, RoutableProvider, } from "./types.js";
-export { defaultPathForProtocol, factoryKindForProtocol, normalizeProtocolId, } from "./types.js";
+export type { AuthMode, BrandEntry, BrandModelEntry, BrandModelSpec, FactoryKind, ProtocolId, ProviderBinding, ResolveInput, RoutableProvider, } from "./types.js";
+export { asBrandModelEntry, brandModelId, defaultPathForProtocol, factoryKindForProtocol, normalizeProtocolId, } from "./types.js";
 export { OPENAI_CHAT_BRANDS, getOpenAiChatBrand, } from "./brands-openai-chat.js";
 export { R1_PROTOCOL_BRANDS, getR1Brand } from "./brands-r1.js";
 export { DEFAULT_REGISTRY_BRANDS, REGISTRY_FALLBACK_MODEL, createProviderRegistry, type CreateProviderRegistryOptions, type ProviderRegistry, } from "./registry.js";

package/node_modules/@xrkseek/llm-registry/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,QAAQ,EACR,UAAU,EACV,WAAW,EACX,UAAU,EACV,eAAe,EACf,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,KAAK,6BAA6B,EAClC,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC1B,KAAK,gBAAgB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,8BAA8B,EACnC,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,QAAQ,EACR,UAAU,EACV,eAAe,EACf,cAAc,EACd,WAAW,EACX,UAAU,EACV,eAAe,EACf,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,KAAK,6BAA6B,EAClC,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC1B,KAAK,gBAAgB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,8BAA8B,EACnC,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,sBAAsB,CAAC"}

package/node_modules/@xrkseek/llm-registry/dist/index.js

@@ -1,4 +1,4 @@
-export { defaultPathForProtocol, factoryKindForProtocol, normalizeProtocolId, } from "./types.js";
+export { asBrandModelEntry, brandModelId, defaultPathForProtocol, factoryKindForProtocol, normalizeProtocolId, } from "./types.js";
 export { OPENAI_CHAT_BRANDS, getOpenAiChatBrand, } from "./brands-openai-chat.js";
 export { R1_PROTOCOL_BRANDS, getR1Brand } from "./brands-r1.js";
 export { DEFAULT_REGISTRY_BRANDS, REGISTRY_FALLBACK_MODEL, createProviderRegistry, } from "./registry.js";

package/node_modules/@xrkseek/llm-registry/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,GAGvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EACL,wBAAwB,EACxB,mBAAmB,GAIpB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,GAE3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,uBAAuB,EACvB,mBAAmB,GAIpB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,GAGvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EACL,wBAAwB,EACxB,mBAAmB,GAIpB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,GAE3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,uBAAuB,EACvB,mBAAmB,GAIpB,MAAM,sBAAsB,CAAC"}

package/node_modules/@xrkseek/llm-registry/dist/types.d.ts

@@ -3,6 +3,20 @@ export type ProtocolId = "openai-chat"
  | "openai-completions" | "openai-responses" | "anthropic-messages" | "gemini-generate";
 export type AuthMode = "bearer" | "api-key";
 export type FactoryKind = "compat" | "anthropic" | "responses" | "gemini";
+/** One catalog row a brand may advertise (id required; rest optional). */
+export interface BrandModelEntry {
+    readonly id: string;
+    readonly name?: string;
+    readonly description?: string;
+    /** Declared context window (tokens); omit → Face leaves unset. */
+    readonly contextWindow?: number;
+    /** Declared intake modalities; omit → Face leaves unset (adapter default). */
+    readonly inputModalities?: readonly ("text" | "image")[];
+}
+/** Brand catalog model: bare id string or a richer entry. */
+export type BrandModelSpec = string | BrandModelEntry;
+export declare function brandModelId(spec: BrandModelSpec): string;
+export declare function asBrandModelEntry(spec: BrandModelSpec): BrandModelEntry;
 export interface BrandEntry {
     readonly id: string;
     readonly displayName: string;
@@ -12,7 +26,22 @@ export interface BrandEntry {
     readonly authMode?: AuthMode;
     readonly apiKeyEnv?: string;
     readonly defaultModel?: string;
+    /**
+     * Optional catalog rows for `autoCatalog` brands. When set (and non-empty),
+     * Face lists these instead of a single `defaultModel`. Omit to keep the
+     * one-model fallback. Entries may be plain ids or
+     * `{ id, name?, contextWindow?, inputModalities? }`.
+     */
+    readonly models?: readonly BrandModelSpec[];
     readonly notes?: string;
+    /**
+     * The brand row itself is a complete route (baseUrl + defaultModel, no user
+     * profile required). Catalog lists `models` when present, else `defaultModel`
+     * alone. Used by bundled providers whose endpoint is decided at runtime; a
+     * provider the user must configure first keeps relying on
+     * `llm-pi-ai.providers.<id>`.
+     */
+    readonly autoCatalog?: boolean;
 }
 export interface ResolveInput {
     readonly provider?: string;

package/node_modules/@xrkseek/llm-registry/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAClB,aAAa;AACf,yDAAyD;GACvD,oBAAoB,GACpB,kBAAkB,GAClB,oBAAoB,GACpB,iBAAiB,CAAC;AAEtB,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE5C,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,WAAW,GACX,WAAW,GACX,QAAQ,CAAC;AAEb,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;IAC/B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAcxE;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,UAAU,GAAG,WAAW,CAYxE;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,CAYnE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAClB,aAAa;AACf,yDAAyD;GACvD,oBAAoB,GACpB,kBAAkB,GAClB,oBAAoB,GACpB,iBAAiB,CAAC;AAEtB,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE5C,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,WAAW,GACX,WAAW,GACX,QAAQ,CAAC;AAEb,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC;CAC1D;AAED,6DAA6D;AAC7D,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,eAAe,CAAC;AAEtD,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAEzD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,eAAe,CAiBvE;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;IAC/B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAcxE;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,UAAU,GAAG,WAAW,CAYxE;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,CAYnE"}

package/node_modules/@xrkseek/llm-registry/dist/types.js

@@ -1,3 +1,24 @@
+export function brandModelId(spec) {
+    return typeof spec === "string" ? spec.trim() : spec.id.trim();
+}
+export function asBrandModelEntry(spec) {
+    if (typeof spec === "string")
+        return { id: spec.trim() };
+    const contextWindow = typeof spec.contextWindow === "number" &&
+        Number.isFinite(spec.contextWindow) &&
+        spec.contextWindow > 0
+        ? Math.floor(spec.contextWindow)
+        : undefined;
+    return {
+        id: spec.id.trim(),
+        ...(spec.name?.trim() ? { name: spec.name.trim() } : {}),
+        ...(spec.description?.trim() ? { description: spec.description.trim() } : {}),
+        ...(contextWindow !== undefined ? { contextWindow } : {}),
+        ...(spec.inputModalities && spec.inputModalities.length > 0
+            ? { inputModalities: [...spec.inputModalities] }
+            : {}),
+    };
+}
 export function normalizeProtocolId(raw) {
     if (typeof raw !== "string")
         return undefined;

package/node_modules/@xrkseek/llm-registry/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA4DA,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,IACE,GAAG,KAAK,aAAa;QACrB,GAAG,KAAK,oBAAoB;QAC5B,GAAG,KAAK,kBAAkB;QAC1B,GAAG,KAAK,oBAAoB;QAC5B,GAAG,KAAK,iBAAiB,EACzB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,IAAI,GAAG,KAAK,mBAAmB,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,aAAa,CAAC;IACpE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAoB;IACzD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,oBAAoB;YACvB,OAAO,WAAW,CAAC;QACrB,KAAK,kBAAkB;YACrB,OAAO,WAAW,CAAC;QACrB,KAAK,iBAAiB;YACpB,OAAO,QAAQ,CAAC;QAClB,KAAK,aAAa,CAAC;QACnB,KAAK,oBAAoB;YACvB,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAoB;IACzD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,oBAAoB;YACvB,OAAO,cAAc,CAAC;QACxB,KAAK,kBAAkB;YACrB,OAAO,YAAY,CAAC;QACtB,KAAK,iBAAiB;YACpB,OAAO,SAAS,CAAC;QACnB,KAAK,aAAa,CAAC;QACnB,KAAK,oBAAoB;YACvB,OAAO,mBAAmB,CAAC;IAC/B,CAAC;AACH,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/node_modules/@xrkseek/mcp/README.md

@@ -1,78 +1,78 @@
-# @xrkseek/mcp
-
-MCP client：stdio 或 streamable-http（或测试注入 transport）→ `listTools` / `callTool` → 可选挂到 `ToolRegistry`。
-
-## Status
-
-**能跑**：stdio · streamable-http · 命名 `mcp__<server>__<tool>` · `registerMcpTools` · **默认 `mcp.connect` deny** · **resources list/templates/read + `mcp.resource` policy（默认 allow）** · 共享工具 `list_mcp_resources` / `list_mcp_resource_templates` / `read_mcp_resource` · **stdio/HTTP 有界进程重连**（`Client.onclose`；HTTP 另有 SDK SSE `reconnectionOptions`）· **HTTP 设备码 OAuth**（RFC 8628 登录 + 到期 refresh；端点缺失时按 RFC 9728 / RFC 8414 发现）。  
-Host 接线：`XRK_MCP_SERVERS`（`command` 或 `url`）+ `XRK_MCP_ALLOW=1`（见 [server-host 模块笔记](../../docs/modules/server-host.md)）。  
-`registerMcpTools` 默认 watch `tools/list_changed`（拉表失败含重复分页游标 / 超页硬顶时保留上一代；gave-up 卸工具）。`connect` 经 SDK initialize 协商协议并声明空 client capabilities；无 `tools` 能力的 server 不调 `tools/list`（空表兼容）。`listTools` 排空分页并拒绝重复 `nextCursor` 或超过 100 页。Face `mcp.servers` 可落盘；空 `XRK_MCP_SERVERS` 时 Host 在 mutate 后热挂载。Plugins → MCP 卡硬刷见 `product-shell-mcp.e2e.ts`。
-
-门禁见 [docs/policy.md](../../docs/policy.md)。状态：[docs/status.md](../../docs/status.md)。  
-**文件地图**：[docs/modules/mcp.md](../../docs/modules/mcp.md)。
-
-## API
-
-```ts
-import { createMcpClient, registerMcpTools } from "@xrkseek/mcp";
-import { createPolicyEngine } from "@xrkseek/policy";
-import { createToolRegistry } from "@xrkseek/core-tools";
-
-const policy = createPolicyEngine({
-  defaults: { "mcp.connect": "allow" }, // product default remains deny
-});
-
-const client = createMcpClient({
-  serverName: "fs",
-  command: "npx",
-  args: ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
-  policy,
-});
-
-await client.connect();
-const registry = createToolRegistry();
-const wired = await registerMcpTools(registry, client);
-// … agent turn …
-wired.dispose();
-await client.dispose();
-```
-
-HTTP：`createMcpClient({ transport: "http", serverName, url, policy })`。
-
-设备码 OAuth（RFC 8628）：登录一次，之后每次连接自动带 Bearer 并在到期前 refresh。
-
-```ts
-import {
-  McpDeviceTokenStore,
-  createMcpClient,
-  discoverDeviceCodeEndpoints,
-  loginWithDeviceCode,
-} from "@xrkseek/mcp";
-
-const store = new McpDeviceTokenStore({ file: "~/.xrk/mcp-tokens/linear.json" });
-
-if (!store.isLoggedIn()) {
-  // 端点未知时先发现（RFC 9728 protected-resource → RFC 8414 authorization-server）
-  const endpoints = await discoverDeviceCodeEndpoints({ url: "https://mcp.example.com/mcp" });
-  await loginWithDeviceCode({
-    client: { id: "xrk-cli" },
-    ...endpoints,
-    store,
-    onPrompt: (start) => console.log(start.verificationUri, start.userCode),
-  });
-}
-
-const client = createMcpClient({
-  transport: "http",
-  serverName: "linear",
-  url: "https://mcp.example.com/mcp",
-  policy,
-  auth: store, // McpHttpAuthProvider：headers() → { authorization: "Bearer …" }
-});
-```
-
-`auth` 只影响 HTTP transport；stdio 不读令牌。`headers()` 与调用方 `requestInit.headers` 合并（大小写不敏感，同名以 auth 为准），`openTransport` 失败即抛出，不降级成匿名连接。产品路径请直接用 `xrkh mcp login|status|logout|list|path`（见 [apps/cli](../../apps/cli/README.md)）。
-
-`connect()` 先 `assertPolicyAllow({ kind: "mcp.connect", serverId })`。显式同名工具优先，插件/MCP 不覆盖。
-
-协议：https://modelcontextprotocol.io/specification/2025-11-25/
+# @xrkseek/mcp
+
+MCP client：stdio 或 streamable-http（或测试注入 transport）→ `listTools` / `callTool` → 可选挂到 `ToolRegistry`。
+
+## Status
+
+**能跑**：stdio · streamable-http · 命名 `mcp__<server>__<tool>` · `registerMcpTools` · **默认 `mcp.connect` deny** · **resources list/templates/read + `mcp.resource` policy（默认 allow）** · 共享工具 `list_mcp_resources` / `list_mcp_resource_templates` / `read_mcp_resource` · **stdio/HTTP 有界进程重连**（`Client.onclose`；HTTP 另有 SDK SSE `reconnectionOptions`）· **HTTP 设备码 OAuth**（RFC 8628 登录 + 到期 refresh；端点缺失时按 RFC 9728 / RFC 8414 发现）。  
+Host 接线：`XRK_MCP_SERVERS`（`command` 或 `url`）+ `XRK_MCP_ALLOW=1`（见 [server-host 模块笔记](../../docs/modules/server-host.md)）。  
+`registerMcpTools` 默认 watch `tools/list_changed`（拉表失败含重复分页游标 / 超页硬顶时保留上一代；gave-up 卸工具）。`connect` 经 SDK initialize 协商协议并声明空 client capabilities；无 `tools` 能力的 server 不调 `tools/list`（空表兼容）。`listTools` 排空分页并拒绝重复 `nextCursor` 或超过 100 页。Face `mcp.servers` 可落盘；空 `XRK_MCP_SERVERS` 时 Host 在 mutate 后热挂载。Plugins → MCP 卡硬刷见 `product-shell-mcp.e2e.ts`。
+
+门禁见 [docs/policy.md](../../docs/policy.md)。状态：[docs/status.md](../../docs/status.md)。  
+**文件地图**：[docs/modules/mcp.md](../../docs/modules/mcp.md)。
+
+## API
+
+```ts
+import { createMcpClient, registerMcpTools } from "@xrkseek/mcp";
+import { createPolicyEngine } from "@xrkseek/policy";
+import { createToolRegistry } from "@xrkseek/core-tools";
+
+const policy = createPolicyEngine({
+  defaults: { "mcp.connect": "allow" }, // product default remains deny
+});
+
+const client = createMcpClient({
+  serverName: "fs",
+  command: "npx",
+  args: ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
+  policy,
+});
+
+await client.connect();
+const registry = createToolRegistry();
+const wired = await registerMcpTools(registry, client);
+// … agent turn …
+wired.dispose();
+await client.dispose();
+```
+
+HTTP：`createMcpClient({ transport: "http", serverName, url, policy })`。
+
+设备码 OAuth（RFC 8628）：登录一次，之后每次连接自动带 Bearer 并在到期前 refresh。
+
+```ts
+import {
+  McpDeviceTokenStore,
+  createMcpClient,
+  discoverDeviceCodeEndpoints,
+  loginWithDeviceCode,
+} from "@xrkseek/mcp";
+
+const store = new McpDeviceTokenStore({ file: "~/.xrk/mcp-tokens/linear.json" });
+
+if (!store.isLoggedIn()) {
+  // 端点未知时先发现（RFC 9728 protected-resource → RFC 8414 authorization-server）
+  const endpoints = await discoverDeviceCodeEndpoints({ url: "https://mcp.example.com/mcp" });
+  await loginWithDeviceCode({
+    client: { id: "xrk-cli" },
+    ...endpoints,
+    store,
+    onPrompt: (start) => console.log(start.verificationUri, start.userCode),
+  });
+}
+
+const client = createMcpClient({
+  transport: "http",
+  serverName: "linear",
+  url: "https://mcp.example.com/mcp",
+  policy,
+  auth: store, // McpHttpAuthProvider：headers() → { authorization: "Bearer …" }
+});
+```
+
+`auth` 只影响 HTTP transport；stdio 不读令牌。`headers()` 与调用方 `requestInit.headers` 合并（大小写不敏感，同名以 auth 为准），`openTransport` 失败即抛出，不降级成匿名连接。产品路径请直接用 `xrkh mcp login|status|logout|list|path`（见 [apps/cli](../../apps/cli/README.md)）。
+
+`connect()` 先 `assertPolicyAllow({ kind: "mcp.connect", serverId })`。显式同名工具优先，插件/MCP 不覆盖。
+
+协议：https://modelcontextprotocol.io/specification/2025-11-25/

package/node_modules/@xrkseek/policy/README.md

@@ -1,18 +1,18 @@
-# @xrkseek/policy
-
-Policy plane: `tool.call` · `provider.use` · `mcp.connect` → allow | deny | ask.
-
-## Shipped
-
-- `createPolicyEngine` — ordered rules  
-- Rule helpers + pipeline bridges (`createPolicyToolPre` / `Guard`)  
-- Write-path floor: `createWritePathSecurityPre` / `Post` (sensitive path deny + content pattern advisory)  
-- **Ruleset JSON**: `parsePolicyRuleset` · `loadPolicyRulesetFile` · `policyRulesetJsonSchema`  
-
-Hardline argv floor lives in `@xrkseek/exec-sandbox` (`createHardlineArgvPre`) and is wired **before** policy in the harness preset.
-
-See `docs/policy.md`.
-
-## Not shipped
-
-Hot reload · YAML · approval UI · live MCP connect.
+# @xrkseek/policy
+
+Policy plane: `tool.call` · `provider.use` · `mcp.connect` → allow | deny | ask.
+
+## Shipped
+
+- `createPolicyEngine` — ordered rules  
+- Rule helpers + pipeline bridges (`createPolicyToolPre` / `Guard`)  
+- Write-path floor: `createWritePathSecurityPre` / `Post` (sensitive path deny + content pattern advisory)  
+- **Ruleset JSON**: `parsePolicyRuleset` · `loadPolicyRulesetFile` · `policyRulesetJsonSchema`  
+
+Hardline argv floor lives in `@xrkseek/exec-sandbox` (`createHardlineArgvPre`) and is wired **before** policy in the harness preset.
+
+See `docs/policy.md`.
+
+## Not shipped
+
+Hot reload · YAML · approval UI · live MCP connect.

package/node_modules/@xrkseek/policy/package.json

@@ -1,31 +1,31 @@
-{
-  "name": "@xrkseek/policy",
-  "version": "0.1.0",
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "dependencies": {
-    "@xrkseek/core-tools": "workspace:*",
-    "js-yaml": "^4.3.1",
-    "smol-toml": "^1.8.0"
-  },
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/xrkseek/XRK-harness.git",
-    "directory": "packages/policy"
-  },
-  "private": true,
-  "devDependencies": {
-    "@types/js-yaml": "^4.0.9"
-  }
-}
+{
+  "name": "@xrkseek/policy",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@xrkseek/core-tools": "workspace:*",
+    "js-yaml": "^4.3.1",
+    "smol-toml": "^1.8.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xrkseek/XRK-harness.git",
+    "directory": "packages/policy"
+  },
+  "private": true,
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9"
+  }
+}

package/node_modules/@xrkseek/preset-harness/README.md

@@ -1,8 +1,8 @@
-# presets/harness
-
-**XRK Harness** session composition（Face 徽章 id `harness`）：fs + bash + std · web · lsp · pty · sandbox · workspace inject · nested subagents · optional `run_code`。
-
-Host 入口名 `server`（`presets/server`）只包一层 `AgentFactory`，工具面与本包相同；`web` / `serve` 默认徽章即 `harness`。
-
-`workspaceInject` / `slashRecipes` default on with assemble — see `docs/workspace-inject.md`, `docs/slash-recipes.md`, `docs/profiles.md`.
+# presets/harness
+
+**XRK Harness** session composition（Face 徽章 id `harness`）：fs + bash + std · web · lsp · pty · sandbox · workspace inject · nested subagents · optional `run_code`。
+
+Host 入口名 `server`（`presets/server`）只包一层 `AgentFactory`，工具面与本包相同；`web` / `serve` 默认徽章即 `harness`。
+
+`workspaceInject` / `slashRecipes` default on with assemble — see `docs/workspace-inject.md`, `docs/slash-recipes.md`, `docs/profiles.md`.
 插件扩展：`docs/plugin-development.md`。

package/node_modules/@xrkseek/preset-harness/dist/mods.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Claude Code plugins inside the harness composition.
+ *
+ * The composition owns the three things the bridge needs and the bridge cannot
+ * discover for itself: the tool pipeline, the filesystem seam, and the session
+ * identity. This module is the only place that knows all three, so it is where
+ * a plugin directory becomes live behaviour.
+ *
+ * Lifecycle, matching the reference host:
+ *
+ * - `ensure()` — find installed plugins and build the runtime. Lazy and
+ *   idempotent, called from `createAgent()`; a composition with no plugins
+ *   installed does no work at all.
+ * - `attach(handle)` — once per agent, raises `session.start` before the first
+ *   prompt.
+ * - `wrap(handle)` — `continueTurn` raises `prompt.submit` (a plugin may rewrite
+ *   the text or drop the prompt), then `turn.start`, then `turn.complete`.
+ * - `dispose()` — raises `session.end` while `$.state` is still readable, then
+ *   unloads.
+ *
+ * A plugin failure never fails a turn: every dispatch is awaited but its errors
+ * are reported and swallowed, because a broken third-party hook must not stop
+ * the user's conversation.
+ * @module
+ */
+import { type ModsRuntime, type UserQuestionsService } from "@xrkseek/claude-code-mods";
+import type { AgentHandle } from "@xrkseek/core-agent";
+import { type SessionStore } from "@xrkseek/core-session";
+import type { ToolPipeline, ToolRegistry } from "@xrkseek/core-tools";
+import type { FsService } from "@xrkseek/exec-fs";
+export interface HarnessModsOptions {
+    readonly pipeline: ToolPipeline;
+    /** The composition's tool registry — `$.tool.*` acts on this one, not a copy. */
+    readonly tools?: ToolRegistry;
+    readonly fs: FsService;
+    /** Shared with the shell tools so a plugin's `$.process.run` is the same runner. */
+    readonly subprocess?: unknown;
+    readonly sessionId: string;
+    /** The composition's session log — `$.session.messages` / `turns` fold it. */
+    readonly store: SessionStore;
+    /** Active route's model id, for `$.session.model`. */
+    readonly model?: string;
+    /** Absolute workspace root; also `$.session.cwd` and the `$.fs` root. */
+    readonly workspaceRoot: string;
+    /** Directory holding installed Claude Code plugins. */
+    readonly pluginsRoot: string;
+    /**
+     * Face (or Cordis) answerer for `$.ui.ask`. When set, `session.start` reports
+     * `isInteractive: true` and plugins can block on a human reply.
+     */
+    readonly userQuestions?: UserQuestionsService;
+    /** Diagnostics sink (Host log). */
+    readonly report?: (line: string) => void;
+}
+export interface HarnessMods {
+    /** The live runtime, once `ensure()` has resolved one. */
+    runtime(): ModsRuntime | undefined;
+    /** Load plugins (idempotent). Returns undefined when none are installed. */
+    ensure(): Promise<ModsRuntime | undefined>;
+    /** Raise `session.start` for this agent. */
+    attach(handle: AgentHandle): Promise<void>;
+    /** Wrap a handle so prompts and turns are published to plugins. */
+    wrap(handle: AgentHandle): AgentHandle;
+    /** Raise `session.end` and unload everything. */
+    dispose(): Promise<void>;
+}
+export declare function createHarnessMods(options: HarnessModsOptions): HarnessMods;
+//# sourceMappingURL=mods.d.ts.map

package/node_modules/@xrkseek/preset-harness/dist/mods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mods.d.ts","sourceRoot":"","sources":["../mods.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,OAAO,EAOL,KAAK,WAAW,EAChB,KAAK,oBAAoB,EAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,WAAW,EAIZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAKlD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,iFAAiF;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,oFAAoF;IACpF,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,uDAAuD;IACvD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAC;IAC9C,mCAAmC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,OAAO,IAAI,WAAW,GAAG,SAAS,CAAC;IACnC,4EAA4E;IAC5E,MAAM,IAAI,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAC3C,4CAA4C;IAC5C,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,mEAAmE;IACnE,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAAC;IACvC,iDAAiD;IACjD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAwRD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAwS1E"}