@punica/editor 1.48.1 → 1.49.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@punica/editor",
-  "version": "1.48.1",
+  "version": "1.49.0",
   "description": "Punica Editor",
   "private": false,
   "type": "module",

package/types/punica.module.kernel.llm.d.ts

@@ -257,6 +257,18 @@ declare module 'punica' {
         originExtension?: string;
         productId?: string;
         outputSchemaSummary?: string;
+        /**
+         * Present and `true` only when the workspace has overridden this
+         * class. Absent on an ordinary one, so a stock list carries no
+         * extra field.
+         */
+        overridden?: true;
+        /**
+         * The extension whose shipped class this override replaces —
+         * absent when the override stands alone (its extension was
+         * uninstalled, or nothing ever shipped the id).
+         */
+        overridesExtension?: string;
       }
 
       /**
@@ -274,6 +286,39 @@ declare module 'punica' {
           originExtension?: string
         ): void;
 
+        /**
+         * Register a workspace override for an id.
+         *
+         * The registry holds two layers per id: the **base**, registered by
+         * the extension that ships the class, and this **override**,
+         * registered by whoever owns the workspace. Every read — `get`,
+         * `list`, `getCapability` — answers the override when there is one,
+         * so an override reaches `llm.invoke` and the tool catalogue alike.
+         *
+         * The base is neither mutated nor deleted, which is what makes
+         * `removeOverride` a restore rather than a reinstall. Unlike
+         * `register`, this never throws on an existing entry: saving over
+         * an override is the ordinary case.
+         *
+         * Contract: `docs/instruction-class-overrides.md`.
+         */
+        registerOverride(
+          instructionClass: InstructionClass,
+          originExtension?: string
+        ): void;
+
+        /** Drop the override for `id`; the shipped class answers again. */
+        removeOverride(id: string): void;
+
+        /** True when the workspace has replaced this class. */
+        isOverridden(id: string): boolean;
+
+        /**
+         * The class as its extension ships it, ignoring any override — what
+         * a "compare with the shipped version" surface reads.
+         */
+        getBase(id: string): InstructionClass | undefined;
+
         /**
          * Inject a product → originExtension resolver.
          *
@@ -291,6 +336,11 @@ declare module 'punica' {
 
         /**
          * Unregister an instruction class by ID.
+         *
+         * An override is removed in preference to the base, so one call
+         * undoes a workspace edit and leaves the shipped class registered.
+         * With no override, the base itself goes.
+         *
          * @param id Instruction class ID to unregister
          */
         unregister(id: string): void;