@daweifu/capability-menu 0.1.0 → 0.1.2

package/lib/types/registry.d.ts

@@ -9,7 +9,8 @@ import type { ScopeKey } from '@deepseek-ai/dsh-scope';
 import type { JsonSchemaNode } from '@deepseek-ai/dsh-tools';
 /**
  * Kinds of capability the catalog can hold.
- * - `tool`:   action capability — executes a concrete action (an MCP tool).
+ * - `tool`:   action capability — executes a concrete action (an MCP tool or a
+ *   harness-native tool cataloged under the reserved `built-in` server).
  * - `skill`:  action capability — loads the method/instructions for a task.
  */
 export type CapabilityKind = 'tool' | 'skill';
@@ -17,21 +18,41 @@ export type CapabilityKind = 'tool' | 'skill';
  * Stable invocation actions a capability can declare. Each kind maps to one
  * canonical action; a new kind only deserves a new value here when it
  * introduces a new action (not a new flavor of an existing one).
- * `execute` = run the concrete action (an MCP tool, via `ctx.tools.execute`);
+ * `execute` = run the concrete action (a tool — MCP or native — via `ctx.tools.execute`);
  * `load`    = load the method/instructions (a skill).
  */
 export type CapabilityAction = 'execute' | 'load';
-/** Stable identifier prefixes: MCP tools keep `mcp__...`, skills use `skill:<name>`. */
-export declare const SKILL_ID_PREFIX = "skill:";
+/**
+ * Tool id prefixes are part of the REAL registered tool name: MCP tools are
+ * registered as `mcp__<server>__<raw>` by the harness MCP client and natives
+ * keep their bare name (`bash`/`read`/…), so tool records are keyed by that
+ * name. Skills have no name-level namespace: a skill's id IS its bare name and
+ * `kind` disambiguates it from a same-named tool.
+ */
 export declare const MCP_ID_PREFIX = "mcp__";
+/**
+ * Reserved pseudo-server that groups harness-native (non-MCP) tools in the
+ * management surface. Native tools (bash/read/write/…) are cataloged like MCP
+ * tools — same `server` dimension — so the 能力管理 can group them, classify
+ * them Resident/On-demand/Disabled, and `meta_invoke` can dispatch them.
+ */
+export declare const BUILT_IN_SERVER = "built-in";
+/**
+ * Tool names that never enter the capability catalog: this plugin's own
+ * control plane (`meta_search`/`meta_invoke`, always Resident) and the
+ * reserved Code Mode presentation transport (`run_code`).
+ */
+export declare const CATALOG_EXCLUDED_TOOLS: ReadonlySet<string>;
 /** Capability-stable origin metadata used by search filters and detail views. */
 export interface CapabilityOrigin {
-    /** Human/namespace label, e.g. `gongfeng` or `filesystem`. */
+    /** Human/namespace label: an MCP server name, the reserved `built-in` for native tools, or a skill provider. */
     readonly provider: string;
-    /** MCP server name, present only for `kind: 'tool'`. */
+    /** Server namespace, present only for `kind: 'tool'` (`built-in` for native tools). */
     readonly serverName?: string;
     /** Local skill path, present only for `kind: 'skill'`. */
     readonly path?: string;
+    /** Skill source root label (`project-dsh`/`user-agents`/…), present only for skills. */
+    readonly source?: string;
 }
 /** Objective and subjective usage statistics, written back from `tools/result`. */
 export interface CapabilityStats {
@@ -43,7 +64,7 @@ export interface CapabilityStats {
 }
 /** One indexed capability. */
 export interface CapabilityRecord {
-    /** Stable identifier: `mcp__<server>__<raw>` or `skill:<name>`. */
+    /** Stable identifier: `mcp__<server>__<raw>`, a native tool name, or a bare skill name. */
     readonly id: string;
     readonly kind: CapabilityKind;
     /** The canonical invocation action(s) this capability exposes. */
@@ -72,6 +93,8 @@ export interface CapabilitySummary {
     readonly name: string;
     readonly summary: string;
     readonly server?: string;
+    /** Skill source root label, present only for `kind: 'skill'`. */
+    readonly source?: string;
     readonly tags: readonly string[];
     readonly success_rate?: number;
     readonly uses: number;
@@ -99,7 +122,7 @@ export interface MetaSearchOptions {
     readonly maxResults?: number;
     /**
      * Viewing scope. Retained for caller ergonomics and optional authorization
-     * checks, but the policy does NOT use it to filter visibility — Progressive
+     * checks, but the policy does NOT use it to filter visibility — On-demand
      * capabilities must remain searchable regardless of the caller's projection.
      */
     readonly scope?: ScopeKey | undefined;
@@ -121,14 +144,21 @@ export interface SkillDirEntry {
     readonly name: string;
     readonly type: 'file' | 'directory';
 }
-/** The `ctx.meta` service surface. */
-export interface MetaService {
+/** The `ctx.capability` service surface. */
+export interface CapabilityService {
     /** Enumerate the current catalog (optionally filtered). */
     search(options?: MetaSearchOptions): CapabilitySummary[];
-    /** Resolve one record by id, or undefined. */
-    get(id: string): CapabilityRecord | undefined;
-    /** Resolve one record's full detail (schema, output; skill body optional). */
-    getDetail(id: string, context?: MetaLookupContext): Promise<CapabilityDetail | undefined>;
+    /**
+     * Resolve one record by id, or undefined. Pass `kind` when the caller knows
+     * it (tools and skills may share a bare name, e.g. a skill named `bash`);
+     * without `kind` a same-name tool/skill pair resolves to undefined.
+     */
+    get(id: string, kind?: CapabilityKind): CapabilityRecord | undefined;
+    /**
+     * Resolve one record's full detail (schema, output; skill body optional).
+     * `kind` has the same disambiguation semantics as {@link get}.
+     */
+    getDetail(id: string, kind?: CapabilityKind, context?: MetaLookupContext): Promise<CapabilityDetail | undefined>;
     /**
      * List a skill's directory children (one level deep). The directory is
      * resolved from the skill's own provider path, never from caller input;
@@ -144,17 +174,29 @@ export interface MetaService {
     readSkillFile(id: string, relPath: string): Promise<string | undefined>;
     /** Return the current number of indexed capabilities. */
     size(): number;
+    /**
+     * Absolute path of the on-demand capability catalog YAML, when emission is
+     * enabled. The model can browse this file with grep/read instead of only
+     * reaching the catalog through `meta_search`.
+     */
+    catalogPath(): string | undefined;
+    /**
+     * Number of On-demand capabilities in the latest catalog emission. Used by
+     * the policy's assemble hook to skip the catalog pointer when there is
+     * nothing On-demand to browse.
+     */
+    onDemandCount(): number;
     /**
      * Rebuild the catalog from the current tool/skill registries; resolves when
      * done. In production the registry rebuilds automatically on `tools/change`
      * / `skills/change`; this public handle is for tests and external orchestrators
-     * that want to force a rebuild (e.g. after a `progressiveSkillCatalog` change).
+     * that want to force a rebuild.
      */
     refresh(): Promise<void>;
 }
 declare module '@deepseek-ai/cordis' {
     interface Context {
-        meta: MetaService;
+        capability: CapabilityService;
     }
 }
 /** Registry configuration. */
@@ -168,13 +210,12 @@ export interface Config {
     /** Experience-weighting intensity for ranking (0 disables, default 0.1). */
     weighting?: number;
     /**
-     * Optional path to a Progressive-skill catalog YAML (see §7.2). Each entry
-     * `{ name, description, whenToUse?, path? }` is indexed as a `skill`
-     * CapabilityRecord so `meta_search(kind=skill)` can find Progressive skills
-     * that are not otherwise registered in the session skill registry. The full
-     * SKILL.md is loaded on demand by `meta_invoke` (see the invoke package).
+     * Optional path for the on-demand capability catalog emitted as a YAML file
+     * for model-side grep/read browsing. Defaults to
+     * `~/.dsh/capability-catalog.yaml`; set to an empty string to disable
+     * emission. Disabled capabilities are never written.
      */
-    progressiveSkillCatalog?: string;
+    catalogFile?: string;
 }
 /** Validate and default the registry configuration. */
 export declare const Config: z<Config>;
@@ -184,8 +225,4 @@ export declare const inject: string[];
 export declare function apply(ctx: Context, config?: Config): void;
 /** Derive the server namespace from an `mcp__<server>__<raw>` name. */
 export declare function serverNameOf(publicName: string): string;
-/** Build the stable skill identifier `skill:<name>`. */
-export declare function skillId(name: string): string;
-/** Strip the `skill:` prefix from a capability id. */
-export declare function skillNameOf(id: string): string;
 //# sourceMappingURL=registry.d.ts.map

package/lib/types/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/registry.ts"],"names":[],"mappings":"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"}

package/lib/types/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAIxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAExE,eAAO,MAAM,IAAI,2BAA2B,CAAA;AAC5C,eAAO,MAAM,MAAM,UAAoC,CAAA;AAEvD,gDAAgD;AAChD,MAAM,WAAW,MAAM;IACrB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,mDAAmD;AACnD,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAE3B,CAAA;AAEF,kCAAkC;AAClC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,EAAE,CAAA;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,oCAAoC;AACpC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;CAClC;AAED,mDAAmD;AACnD,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG,sBAAsB,CAAA;AAE5E;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,MAAW,GAAG,IAAI,CA8H7D"}

package/lib/types/server/remote.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Host-side Typert gateway exposing the server-side `ctx.capabilityPolicy`
+ * management surface (see `src/policy.ts`) to the browser. Built as
+ * `lib/server/remote.js` and mounted by the package root entry (`src/index.ts`).
+ *
+ * Consumed by the browser bundle under `src/client` via
+ * `ctx.remote.capabilityPolicy.classifyAll()` / `getConfig()` /
+ * `updateConfig()`.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import type { CapabilityClassification, CapabilityPolicyService, Config as CapabilityPolicyConfig } from '../policy.ts';
+import type { CapabilityDetail, SkillDirEntry, CapabilityService } from '../registry.ts';
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        capabilityPolicy: CapabilityPolicyService;
+        capability: CapabilityService;
+    }
+}
+/** 能力目录查看负载：两份只读「文件」+ 缺失原因。 */
+export interface CatalogDocs {
+    /** 当前生效的三档策略配置（getConfig() + metaTools()），YAML 文本。 */
+    readonly policyYaml: string;
+    /** 按需能力目录物化文件（capability.catalogPath()）。 */
+    readonly catalog?: {
+        readonly path: string;
+        readonly content: string;
+    };
+    /** catalog 不可用原因：'disabled' = catalogFile 为空（未启用物化）；'read-failed' = 读盘失败。 */
+    readonly catalogMissing?: 'disabled' | 'read-failed';
+}
+/**
+ * Host-side remote face for the 能力管理 tab. Every method delegates to the
+ * policy service installed by `@daweifu/capability-menu/policy`; the registry
+ * sibling (`capability`) must be mounted for `classifyAll` to return anything.
+ *
+ * The service registers under a distinct key (`capabilityPolicyGateway`) so it
+ * does not collide with the `capabilityPolicy` service the policy plugin
+ * provides; the Typert wire namespace is still `capabilityPolicy` (matching
+ * the client remote descriptors), and the gateway reads the real policy
+ * service through `this.ctx.capabilityPolicy`.
+ */
+export declare class CapabilityPolicyGateway extends TypertRemoteService {
+    static inject: string[];
+    constructor(ctx: Context);
+    /** Current (resolved) policy config. */
+    getConfig(): CapabilityPolicyConfig;
+    /** Replace a subset of the policy config (recompile rules + rewrite catalog). */
+    updateConfig(partial: Partial<CapabilityPolicyConfig>): Promise<void>;
+    /** Classify every capability currently indexed by `ctx.capability`. */
+    classifyAll(): CapabilityClassification[];
+    /** Resolve one capability's full detail (schema, description; skill body optional). */
+    getDetail(id: string): Promise<CapabilityDetail | undefined>;
+    /** List a skill's directory children (one level deep; optional subpath). */
+    listSkillDir(id: string, relPath?: string): Promise<SkillDirEntry[] | undefined>;
+    /** Read a text file inside a skill's directory. */
+    readSkillFile(id: string, relPath: string): Promise<string | undefined>;
+    /**
+     * 能力目录查看：返回「三档策略配置」语义化视图——默认全部常驻，
+     * tools.resident 按 server 各显示 '*'，例外（on-demand/disabled）按
+     * server → 工具短名 分级列出；skills 无 server 维度，resident 恒为 '*'，
+     * 例外为短名平铺。空例外不渲染 key，避免 []/{} 歧义。
+     * 另返回按需能力目录物化文件（~/.dsh/capability-catalog.yaml）的路径和内容。
+     * 两者都是只读视图——策略持久化入口仍是 cordis.patch.yml。
+     */
+    getCatalogDocs(): Promise<CatalogDocs>;
+}
+/** Register the remote gateway on a context. */
+export declare const name = "capability-menu-remote";
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=remote.d.ts.map

package/lib/types/server/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../../src/server/remote.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,mBAAmB,EAAU,MAAM,kCAAkC,CAAA;AAG9E,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,MAAM,IAAI,sBAAsB,EACjC,MAAM,cAAc,CAAA;AACrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAMxF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,gBAAgB,EAAE,uBAAuB,CAAA;QACzC,UAAU,EAAE,iBAAiB,CAAA;KAC9B;CACF;AAED,+BAA+B;AAC/B,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IACtE,6EAA6E;IAC7E,QAAQ,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,aAAa,CAAA;CACrD;AAED;;;;;;;;;;GAUG;AACH,qBAAa,uBAAwB,SAAQ,mBAAmB;IAC9D,MAAM,CAAC,MAAM,WAAqC;gBAEtC,GAAG,EAAE,OAAO;IAIxB,wCAAwC;IAExC,SAAS,IAAI,sBAAsB;IAInC,iFAAiF;IAE3E,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3E,uEAAuE;IAEvE,WAAW,IAAI,wBAAwB,EAAE;IAIzC,uFAAuF;IAEjF,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAIlE,4EAA4E;IAEtE,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,GAAG,SAAS,CAAC;IAItF,mDAAmD;IAE7C,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAI7E;;;;;;;OAOG;IAEG,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;CAqE7C;AAED,gDAAgD;AAChD,eAAO,MAAM,IAAI,2BAA2B,CAAA;AAC5C,eAAO,MAAM,MAAM,UAAqC,CAAA;AACxD,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAExC"}

package/package.json

@@ -1,17 +1,24 @@
 {
   "name": "@daweifu/capability-menu",
-  "version": "0.1.0",
-  "description": "Unified capability management for the DeepSeek Harness: catalog (registry) + meta_search/meta_invoke + Exposed/Progressive/Blocked projection policy + 能力管理 surface, in one installable bundle.",
+  "version": "0.1.2",
+  "description": "Unified capability management for the DeepSeek Harness: catalog (ctx.capability) + meta_search/meta_invoke + Resident/On-demand/Disabled projection policy + 能力管理 settings tab, in one installable bundle (server + browser).",
   "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PKUfudawei/dsh-capability-menu.git"
+  },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
   },
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
   "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "build": "tsc -p tsconfig.json && tsdown",
+    "bundle": "tsdown",
+    "bridge": "node scripts/bridge-runtime.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.client.json --noEmit",
     "test": "vitest run",
     "prepare": "npm run build"
   },
@@ -36,50 +43,71 @@
       "types": "./lib/types/policy.d.ts",
       "default": "./lib/policy.js"
     },
-    "./invariant": {
-      "types": "./lib/types/invariant.d.ts",
-      "default": "./lib/invariant.js"
+    "./client": {
+      "types": "./lib/client.d.ts",
+      "default": "./lib/client.js"
     },
     "./cordis.patch.yml": "./cordis.patch.yml",
     "./src/*": "./src/*",
     "./package.json": "./package.json"
   },
   "files": [
-    "lib/index.js",
-    "lib/registry.js",
-    "lib/search.js",
-    "lib/invoke.js",
-    "lib/policy.js",
-    "lib/invariant.js",
-    "cordis.patch.yml",
-    "lib/types/**/*.d.ts"
+    "lib",
+    "cordis.patch.yml"
   ],
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-api-remotes"
+      ],
+      "external": [
+        "react",
+        "react/jsx-runtime"
+      ],
+      "platform": "web"
     }
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-llm": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-scope": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-session": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-skill": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.7",
-    "@deepseek-ai/schemastery": "^3.18.1"
+    "@deepseek-ai/dsh-agent": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-scope": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-session": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-skill": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-schema-form": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-web-react": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "react": "^18.2.0"
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
     "js-yaml": "^4.1.0"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-skill-filesystem": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-skill-filesystem": "^0.1.2-rc.1",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.0.0",
+    "@types/react": "^18.2.0",
+    "tsdown": "^0.22.2",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.8"
+    "vitest": "^4.1.8",
+    "zod": "^4.4.3",
+    "@deepseek-ai/dsh-util-values": "^0.1.2-rc.1"
   }
 }

package/lib/invariant.js

@@ -1,22 +0,0 @@
-/**
- * Package-owned invariant companion for `@daweifu/capability-menu`.
- * @module @daweifu/capability-menu/invariant
- */
-const PACKAGE_NAME = '@daweifu/capability-menu';
-/** Cordis companion plugin name. */
-export const name = 'capability-menu-invariant';
-/** Service required before the companion can reserve package ownership. */
-export const inject = ['invariants'];
-/**
- * No runtime invariant: the capability catalog has no independent lifecycle
- * stream; its index mirrors the tools/skills registries it observes.
- */
-const install = () => { };
-/**
- * Register this package's invariant companion.
- * @param ctx - Cordis context carrying the invariant service.
- * @returns the installed registration's disposer after setup succeeds.
- */
-export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
-/* jscpd:ignore-end */
-//# sourceMappingURL=invariant.js.map

package/lib/types/invariant.d.ts

@@ -1,16 +0,0 @@
-/**
- * Package-owned invariant companion for `@daweifu/capability-menu`.
- * @module @daweifu/capability-menu/invariant
- */
-import type { Context } from '@deepseek-ai/cordis';
-/** Cordis companion plugin name. */
-export declare const name = "capability-menu-invariant";
-/** Service required before the companion can reserve package ownership. */
-export declare const inject: string[];
-/**
- * Register this package's invariant companion.
- * @param ctx - Cordis context carrying the invariant service.
- * @returns the installed registration's disposer after setup succeeds.
- */
-export declare const apply: (ctx: Context) => Promise<() => void>;
-//# sourceMappingURL=invariant.d.ts.map