@orthacms/copilot-server 0.4.2 → 0.4.3

package/dist/lib/chat/application/run-engine.service.d.ts

@@ -69,7 +69,16 @@ export interface StartRunInput {
 export declare class UnknownModelChoiceError extends Error {
     constructor(message: string);
 }
-/** Thrown when a run cannot start at all — the controller maps it to a 4xx. */
+/**
+ * Thrown when a run cannot start at all — the controller turns it into an
+ * error frame.
+ *
+ * **Rarely reachable over HTTP**: the copilot's kill switch now unregisters
+ * every controller (`copilot.module.ts`), so a disabled deployment 404s the run
+ * route rather than opening a stream to say no. Kept because the engine is
+ * drainable without a socket, and a caller that gets one anyway deserves a
+ * named reason rather than a 500.
+ */
 export declare class CopilotDisabledError extends Error {
     constructor();
 }

package/dist/lib/chat/application/run-engine.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-engine.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/chat/application/run-engine.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run-engine.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/chat/application/run-engine.service.ts"],"names":[],"mappings":"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"}

package/dist/lib/chat/application/run-engine.service.js

@@ -28,7 +28,16 @@ class UnknownModelChoiceError extends Error {
     }
 }
 exports.UnknownModelChoiceError = UnknownModelChoiceError;
-/** Thrown when a run cannot start at all — the controller maps it to a 4xx. */
+/**
+ * Thrown when a run cannot start at all — the controller turns it into an
+ * error frame.
+ *
+ * **Rarely reachable over HTTP**: the copilot's kill switch now unregisters
+ * every controller (`copilot.module.ts`), so a disabled deployment 404s the run
+ * route rather than opening a stream to say no. Kept because the engine is
+ * drainable without a socket, and a caller that gets one anyway deserves a
+ * named reason rather than a 500.
+ */
 class CopilotDisabledError extends Error {
     constructor() {
         super('The copilot is disabled.');
@@ -81,9 +90,12 @@ let RunEngine = RunEngine_1 = class RunEngine {
     /** Runs one turn, yielding events as they happen. */
     async *run(input) {
         if (!this.config.enabled) {
-            // The operator's kill switch (ADR-0005 §10). Checked here rather
-            // than in a guard so the reason reaches the user as a normal
-            // answer instead of an opaque 403.
+            // The operator's kill switch (ADR-0005 §10), belt-and-braces —
+            // `CopilotModule.forRoot` registers no controller when it is off,
+            // so a disabled deployment 404s before it reaches this line. This
+            // is the guard against a future wiring change, and against a
+            // caller that drains the generator without going through HTTP
+            // (a tool, a job, a test).
             throw new CopilotDisabledError();
         }
         const runId = (0, node_crypto_1.randomUUID)();

package/dist/lib/copilot.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"copilot.module.d.ts","sourceRoot":"","sources":["../../src/lib/copilot.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAIH,KAAK,aAAa,EAClB,KAAK,eAAe,EACvB,MAAM,0BAA0B,CAAC;AAIlC,OAAO,EAEH,KAAK,oBAAoB,EAC5B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAqBlE,qDAAqD;AACrD,MAAM,WAAW,oBAAoB;IACjC,sEAAsE;IACtE,SAAS,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC3C,0DAA0D;IAC1D,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACpC,+DAA+D;IAC/D,MAAM,EAAE,mBAAmB,CAAC;CAC/B;AAED;;;;;;;;;GASG;AACH,qBACa,aAAa;IACtB,mEAAmE;IACnE,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa;CAwG/D"}
+{"version":3,"file":"copilot.module.d.ts","sourceRoot":"","sources":["../../src/lib/copilot.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAIH,KAAK,aAAa,EAClB,KAAK,eAAe,EACvB,MAAM,0BAA0B,CAAC;AAIlC,OAAO,EAEH,KAAK,oBAAoB,EAC5B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAqBlE,qDAAqD;AACrD,MAAM,WAAW,oBAAoB;IACjC,sEAAsE;IACtE,SAAS,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC3C,0DAA0D;IAC1D,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACpC,+DAA+D;IAC/D,MAAM,EAAE,mBAAmB,CAAC;CAC/B;AAED;;;;;;;;;GASG;AACH,qBACa,aAAa;IACtB,mEAAmE;IACnE,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa;CAiI/D"}

package/dist/lib/copilot.module.js

@@ -47,11 +47,17 @@ let CopilotModule = CopilotModule_1 = class CopilotModule {
         // and its order is the preference order (`catalogue()` renders in it,
         // and the admin's picker opens on its first entry).
         const [first] = options.providers;
-        if (!first) {
-            throw new Error('CopilotModule requires at least one model provider — the first one registered ' +
+        if (!first && options.config.enabled) {
+            throw new Error('CopilotModule is enabled but has no model provider — the first one registered ' +
                 'is what serves a run that names none.');
         }
-        const resolver = options.resolve ?? (() => first.name);
+        // A disabled copilot registers no controller, so nothing can reach the
+        // resolver and there is no default to name. It still has to resolve to
+        // *something*: the module binds `MODEL_RESOLVER` either way, because the
+        // switch must not change the shape of the DI graph. Asking for a
+        // provider through it fails in `ModelRegistry.get`, naming the empty
+        // catalogue, which is the same error an unknown name gets.
+        const resolver = options.resolve ?? (() => first?.name ?? '');
         return {
             module: CopilotModule_1,
             global: true,
@@ -62,34 +68,52 @@ let CopilotModule = CopilotModule_1 = class CopilotModule {
             // so a deployment running the copilot *without* MCP still has one,
             // and one running both has exactly one.
             imports: [database_1.DatabaseModule, tools_server_1.ToolsModule],
-            controllers: [
-                create_run_controller_1.CreateRunController,
-                // Before `GetConversationController`: `conversations/:id` and
-                // `models` can't collide (different first segments), but keep
-                // the read routes grouped after the run route.
-                list_models_controller_1.ListModelsController,
-                list_conversations_controller_1.ListConversationsController,
-                // `PATCH conversations/:id`. No ordering hazard with the `GET`
-                // wildcard below — Express matches method and path together —
-                // but it reads with the other conversation routes.
-                update_conversation_controller_1.UpdateConversationController,
-                // Before `GetConversationController`, whose `conversations/:id`
-                // is the only wildcard here — Express matches in declaration
-                // order, so the literal-prefixed routes go first.
-                proposals_controller_1.ProposalsController,
-                // Before `GetConversationController` for the same reason as
-                // the others: its `conversations/:id` is the only wildcard, and
-                // Express matches in declaration order.
-                tool_permission_controller_1.ToolPermissionController,
-                // Both skill controllers before the conversation wildcard, for
-                // the same declaration-order reason as the rest. `skills` and
-                // `skills/:id` live in different controllers and cannot
-                // collide (different segment counts); `skills/manage` is
-                // declared above `skills/:id` inside the manage controller.
-                list_skills_controller_1.ListSkillsController,
-                manage_skills_controller_1.ManageSkillsController,
-                get_conversation_controller_1.GetConversationController
-            ],
+            // **The kill switch, applied where MCP applies its own**
+            // (`mcp.module.ts`): a disabled deployment registers no copilot
+            // controller at all, so every `/api/copilot/*` route 404s.
+            //
+            // It used to be read in one place only — `RunEngine.run` — which
+            // made "off" mean *the send button returns an error frame*. The
+            // panel, the Agents view, the model catalogue, the conversation and
+            // skill routes and the tables all stayed live, so a deployment that
+            // had opted out still offered the whole feature and refused at the
+            // last step. Off is now off.
+            //
+            // The providers, the registry and the skill catalogue below stay
+            // bound either way. They cost nothing unbuilt, and the shared
+            // `ToolRegistry` must not change shape with this switch — the MCP
+            // endpoint serves the same catalogue, and a tool contributed by
+            // `content` is registered against `ToolsModule`, not this one.
+            controllers: options.config.enabled
+                ? [
+                    create_run_controller_1.CreateRunController,
+                    // Before `GetConversationController`: `conversations/:id` and
+                    // `models` can't collide (different first segments), but keep
+                    // the read routes grouped after the run route.
+                    list_models_controller_1.ListModelsController,
+                    list_conversations_controller_1.ListConversationsController,
+                    // `PATCH conversations/:id`. No ordering hazard with the `GET`
+                    // wildcard below — Express matches method and path together —
+                    // but it reads with the other conversation routes.
+                    update_conversation_controller_1.UpdateConversationController,
+                    // Before `GetConversationController`, whose `conversations/:id`
+                    // is the only wildcard here — Express matches in declaration
+                    // order, so the literal-prefixed routes go first.
+                    proposals_controller_1.ProposalsController,
+                    // Before `GetConversationController` for the same reason as
+                    // the others: its `conversations/:id` is the only wildcard, and
+                    // Express matches in declaration order.
+                    tool_permission_controller_1.ToolPermissionController,
+                    // Both skill controllers before the conversation wildcard, for
+                    // the same declaration-order reason as the rest. `skills` and
+                    // `skills/:id` live in different controllers and cannot
+                    // collide (different segment counts); `skills/manage` is
+                    // declared above `skills/:id` inside the manage controller.
+                    list_skills_controller_1.ListSkillsController,
+                    manage_skills_controller_1.ManageSkillsController,
+                    get_conversation_controller_1.GetConversationController
+                ]
+                : [],
             providers: [
                 { provide: copilot_tokens_1.COPILOT_CONFIG, useValue: options.config },
                 {

package/dist/lib/infrastructure/model-registry.d.ts

@@ -1,7 +1,7 @@
 import { type ModelProvider, type ModelRegistry } from '@orthacms/copilot-domain';
 /** One provider the host offers, under the name runs refer to it by. */
 export interface ProviderRegistration {
-    /** Unique, operator-chosen name — `claude`, `ollama-big`, `fake`. */
+    /** Unique, operator-chosen name — `claude`, `ollama-big`, `local`. */
     name: string;
     /** The adapter instance, already constructed with its own config. */
     provider: ModelProvider;

package/dist/lib/infrastructure/model-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-registry.d.ts","sourceRoot":"","sources":["../../../src/lib/infrastructure/model-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,aAAa,EAClB,KAAK,aAAa,EACrB,MAAM,0BAA0B,CAAC;AAElC,wEAAwE;AACxE,MAAM,WAAW,oBAAoB;IACjC,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,QAAQ,EAAE,aAAa,CAAC;CAC3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAC9B,aAAa,EAAE,SAAS,oBAAoB,EAAE,GAC/C,aAAa,CA+Cf"}
+{"version":3,"file":"model-registry.d.ts","sourceRoot":"","sources":["../../../src/lib/infrastructure/model-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,aAAa,EAClB,KAAK,aAAa,EACrB,MAAM,0BAA0B,CAAC;AAElC,wEAAwE;AACxE,MAAM,WAAW,oBAAoB;IACjC,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,QAAQ,EAAE,aAAa,CAAC;CAC3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAC9B,aAAa,EAAE,SAAS,oBAAoB,EAAE,GAC/C,aAAa,CA+Cf"}

package/dist/lib/utils/copilot-plugin.d.ts

@@ -20,6 +20,10 @@ export interface CopilotPluginOptions {
      * misspelled, could point at a provider nobody registered, and had to be
      * kept in step with this list on every change. A deployment that should
      * not reach a backend does not register it.
+     *
+     * **May be empty only while `config.enabled` is false.** A copilot that is
+     * on and has nothing to call is a misconfiguration, and fails at
+     * construction rather than on the first message.
      */
     providers: readonly ProviderRegistration[];
     /** Optional custom handler picking a provider per run (plain code). */
@@ -50,13 +54,16 @@ export interface CopilotPluginOptions {
  * engine, the capability profile, and the transcript tables this plugin now
  * owns and migrates.
  *
+ * Each entry is a backend this deployment actually configured. An enabled
+ * copilot needs at least one; a disabled one needs none, and a checkout with no
+ * keys registers none.
+ *
  * @example
  * ```typescript
  * CopilotPlugin({
  *     providers: [
  *         { name: 'claude', provider: createAnthropicProvider(providers.claude) },
- *         { name: 'ollama', provider: createOpenAiProvider(providers.ollama) },
- *         { name: 'fake', provider: createFakeProvider() }
+ *         { name: 'ollama', provider: createOpenAiProvider(providers.ollama) }
  *     ],
  *     config: config.plugins.copilot
  * });

package/dist/lib/utils/copilot-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"copilot-plugin.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/copilot-plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAEH,KAAK,aAAa,EAClB,KAAK,eAAe,EACvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,0DAA0D;AAC1D,MAAM,MAAM,6BAA6B,GAAG,YAAY,GAAG;IACvD,aAAa,EAAE,mBAAmB,CAAC;CACtC,CAAC;AAEF,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACjC;;;;;;;;;;;;OAYG;IACH,SAAS,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC3C,uEAAuE;IACvE,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACpC,+DAA+D;IAC/D,MAAM,EAAE,mBAAmB,CAAC;CAC/B;AAsDD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CACzB,OAAO,EAAE,oBAAoB,GAC9B,6BAA6B,CAa/B"}
+{"version":3,"file":"copilot-plugin.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/copilot-plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAEH,KAAK,aAAa,EAClB,KAAK,eAAe,EACvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,0DAA0D;AAC1D,MAAM,MAAM,6BAA6B,GAAG,YAAY,GAAG;IACvD,aAAa,EAAE,mBAAmB,CAAC;CACtC,CAAC;AAEF,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACjC;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC3C,uEAAuE;IACvE,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACpC,+DAA+D;IAC/D,MAAM,EAAE,mBAAmB,CAAC;CAC/B;AA+DD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,aAAa,CACzB,OAAO,EAAE,oBAAoB,GAC9B,6BAA6B,CAa/B"}

package/dist/lib/utils/copilot-plugin.js

@@ -6,19 +6,28 @@ const copilot_domain_1 = require("@orthacms/copilot-domain");
 const copilot_module_1 = require("../copilot.module");
 /**
  * Validate the wiring **eagerly** (like `ContentPlugin`'s registry and
- * `I18nServerPlugin`'s locales): an empty provider list, or a provider
- * declaring no models, is a misconfiguration that should fail at construction —
- * before boot — rather than on the first chat message, where it is most
- * expensive to diagnose.
+ * `I18nServerPlugin`'s locales): a provider declaring no models, or an enabled
+ * copilot with no provider at all, is a misconfiguration that should fail at
+ * construction — before boot — rather than on the first chat message, where it
+ * is most expensive to diagnose.
+ *
+ * **The empty list is only a misconfiguration when the copilot is on.** A
+ * deployment that has not set `enabled` mounts no controllers and can serve no
+ * run, so it needs no backend — and that is the ordinary state of a fresh
+ * checkout, which configures no keys. There is no scripted offline adapter to
+ * fall back on: the fake provider is a private test fixture, so a host with no
+ * keys registers nothing rather than registering something that answers every
+ * question with a canned sentence.
  *
  * Name uniqueness is enforced by `buildModelRegistry`, which the module builds
  * from the same list.
  */
 function assertOptions(options) {
     const names = options.providers.map((entry) => entry.name);
-    if (names.length === 0) {
-        throw new Error('CopilotPlugin requires at least one model provider. Register one at the composition root, ' +
-            "e.g. `providers: [{ name: 'fake', provider: createFakeProvider() }]`.");
+    if (names.length === 0 && options.config.enabled) {
+        throw new Error('CopilotPlugin is enabled but has no model provider. Configure a backend and register it at ' +
+            "the composition root, e.g. `providers: [{ name: 'claude', provider: createAnthropicProvider(…) }]` " +
+            '— or leave the copilot off.');
     }
     for (const entry of options.providers) {
         if (entry.provider.models().length === 0) {
@@ -59,13 +68,16 @@ function assertOptions(options) {
  * engine, the capability profile, and the transcript tables this plugin now
  * owns and migrates.
  *
+ * Each entry is a backend this deployment actually configured. An enabled
+ * copilot needs at least one; a disabled one needs none, and a checkout with no
+ * keys registers none.
+ *
  * @example
  * ```typescript
  * CopilotPlugin({
  *     providers: [
  *         { name: 'claude', provider: createAnthropicProvider(providers.claude) },
- *         { name: 'ollama', provider: createOpenAiProvider(providers.ollama) },
- *         { name: 'fake', provider: createFakeProvider() }
+ *         { name: 'ollama', provider: createOpenAiProvider(providers.ollama) }
  *     ],
  *     config: config.plugins.copilot
  * });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@orthacms/copilot-server",
-    "version": "0.4.2",
+    "version": "0.4.3",
     "description": "@orthacms/copilot-server — part of Ortha CMS.",
     "license": "MIT",
     "homepage": "https://github.com/ortha-source/ortha-cms/tree/main/packages/copilot/server",
@@ -28,12 +28,12 @@
     "dependencies": {
         "@nestjs/common": "^11.0.0",
         "@nestjs/swagger": "^11.4.6",
-        "@orthacms/bootstrap-server": "^0.4.2",
-        "@orthacms/copilot-domain": "^0.4.2",
-        "@orthacms/database": "^0.4.2",
-        "@orthacms/identity-server": "^0.4.2",
-        "@orthacms/tools-server": "^0.4.2",
-        "@orthacms/workspaces-server": "^0.4.2",
+        "@orthacms/bootstrap-server": "^0.4.3",
+        "@orthacms/copilot-domain": "^0.4.3",
+        "@orthacms/database": "^0.4.3",
+        "@orthacms/identity-server": "^0.4.3",
+        "@orthacms/tools-server": "^0.4.3",
+        "@orthacms/workspaces-server": "^0.4.3",
         "class-transformer": "^0.5.1",
         "class-validator": "^0.15.1",
         "drizzle-orm": "^0.45.0",