@bevel-software/platform-core-backend 0.32.0 → 0.34.0

package/dist/modules/tool-manuals/tool-manuals.tools.js

@@ -1,5 +1,4 @@
-import { toolDef } from '../tool-helpers/tool-def.js';
-import { declareRouteTool } from '../tool-helpers/route-tool-schemas.js';
+import { toolDef, declareRouteTool } from '../tool-helpers/index.js';
 import { utcpNamespacedKey } from '../../shared/utcp-namespace.js';
 /**
  * Registers the tool-manual catalog tools (both surfaces) and hosts their
@@ -13,16 +12,26 @@ import { utcpNamespacedKey } from '../../shared/utcp-namespace.js';
  *    admin pastes them into the tool editor; users sign in on /connect.
  */
 export function registerToolManualsTools(registry, router, toolAuth, toolHandler, toolManualService, deps) {
-    registry.registerExternalTool((ctx) => buildListLocalToolsDef(toolManualService, ctx.userEmail));
+    registry.registerExternalTool((ctx) => buildListLocalToolsDef(toolManualService, ctx.userEmail, ctx.connectionScope?.connectorFilter()));
     registry.registerInternalTool((ctx) => buildListLocalToolsDef(toolManualService, ctx.userEmail));
     // The def above is built per catalog listing (its description names the
     // tools configured for THIS caller), so declare the arguments here as well:
     // a direct REST call that lands before the first listing must be checked
     // against them too.
     declareRouteTool('list_local_tools', LIST_LOCAL_TOOLS_INPUTS);
-    router.post('/agent/tools/list_local_tools', toolAuth, toolHandler(async (_args, ctx) => ({
-        tools: await toolManualService.listLocalOnly(ctx.user.email),
-    })));
+    // The local server's discovery read (`discovery`): it asks this route at
+    // startup for the connectors it must materialize, whatever tools the
+    // connection is offered — a connection made as an agent configuration that omits
+    // the tool is answered its connectors, not refused, or the local server
+    // could not start for that agent at all.
+    router.post('/agent/tools/list_local_tools', toolAuth, toolHandler(async (_args, ctx) => {
+        const within = ctx.connectionScope?.connectorFilter();
+        return {
+            tools: await (within
+                ? toolManualService.listLocalOnly(ctx.user.email, within)
+                : toolManualService.listLocalOnly(ctx.user.email)),
+        };
+    }, { discovery: true }));
     // A FUNCTION, not a constant — this factory runs at boot, and on a
     // setup-screen deployment the branch model is applied AFTER boot. Only a
     // read inside a handler body sees the configured default branch; a
@@ -187,12 +196,17 @@ export function registerToolManualsTools(registry, router, toolAuth, toolHandler
     router.post('/agent/tools/list_tool_setup', toolAuth, toolHandler(async (args, ctx) => {
         // The in-app agent is focused on its own draft; an external caller names it.
         const branch = typeof args.branch === 'string' && args.branch ? args.branch : ctx.focusedBranch;
+        const within = ctx.connectionScope?.connectorFilter();
         // The catalog comes back whole — what parsed AND what was refused — from
         // ONE scan, so the refused files cost no second walk of the workspace and
         // the two halves cannot disagree about which files made it.
         const [{ tools: manuals, invalid }, pending] = await Promise.all([
-            toolManualService.listAccessibleCatalog(ctx.user.email),
-            branch ? toolManualService.listDeclaredOnlyOnBranch(ctx.user.email, branch) : Promise.resolve([]),
+            // Only the connectors the caller's connection loads: setup is counted
+            // for the tools this connection can call, not every one the person can.
+            within
+                ? toolManualService.listAccessibleCatalog(ctx.user.email, within)
+                : toolManualService.listAccessibleCatalog(ctx.user.email),
+            branch ? toolManualService.listDeclaredOnlyOnBranch(ctx.user.email, branch, within) : Promise.resolve([]),
         ]);
         const allKeys = manuals.flatMap((m) => (m.variables ?? []).map((v) => varKey(m.name, v.name)));
         const status = await deps.variableStatus.statusFor(ctx.user.id, allKeys);
@@ -241,17 +255,17 @@ export function registerToolManualsTools(registry, router, toolAuth, toolHandler
     }));
 }
 /** "Local-only tools configured for you: `a`, `b`." (or a none note), filtered to what the caller may read. */
-async function localToolsLine(svc, userEmail) {
+async function localToolsLine(svc, userEmail, within) {
     if (!userEmail)
         return 'No local-only tools are currently configured.';
-    const tools = await svc.listLocalOnly(userEmail);
+    const tools = await (within ? svc.listLocalOnly(userEmail, within) : svc.listLocalOnly(userEmail));
     if (tools.length === 0)
         return 'No local-only tools are currently configured.';
     return `Local-only tools configured for you: ${tools.map((t) => `\`${t.name}\``).join(', ')}.`;
 }
 /** `list_local_tools` takes nothing; a const so the route and the def share one declaration. */
 const LIST_LOCAL_TOOLS_INPUTS = { type: 'object', properties: {}, additionalProperties: false };
-async function buildListLocalToolsDef(svc, userEmail) {
+async function buildListLocalToolsDef(svc, userEmail, within) {
     return toolDef({
         name: 'list_local_tools',
         description: 'List tools your workspace admins configured that run ONLY in a local environment ' +
@@ -263,7 +277,7 @@ async function buildListLocalToolsDef(svc, userEmail) {
             'machine. Otherwise each entry gives the tool’s name and its `.tool` file ' +
             'path in the knowledge base — read that file with `read_file` and wire the tool into your local ' +
             'setup by hand. ' +
-            (await localToolsLine(svc, userEmail)),
+            (await localToolsLine(svc, userEmail, within)),
         path: '/api/agent/tools/list_local_tools',
         inputs: LIST_LOCAL_TOOLS_INPUTS,
         outputs: {

package/dist/modules/tool-manuals/tool-manuals.tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-manuals.tools.js","sourceRoot":"","sources":["../../../src/modules/tool-manuals/tool-manuals.tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-manuals.tools.js","sourceRoot":"","sources":["../../../src/modules/tool-manuals/tool-manuals.tools.ts"],"names":[],"mappings":"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"}

package/dist/modules/tool-registry/description-length.js

@@ -12,8 +12,8 @@
  */
 import { callLine, splitCallLine } from '@bevel-software/platform-mcp-core';
 import { TOOL_PREFIX_CAP } from '@bevel-software/platform-shared';
-import { PREFIXED_TOOLS } from '../agent-instructions/compose.js';
-import { EXTERNAL_KB_MANUAL_NAME } from '../tool-manuals/tool-manuals.contract.js';
+import { PREFIXED_TOOLS } from '../agent-instructions/index.js';
+import { EXTERNAL_KB_MANUAL_NAME } from '../tool-manuals/index.js';
 import { GUIDE_FIRST_SENTENCE } from './guide-first.js';
 /**
  * The ceiling on what a client is handed for one tool, enforced by

package/dist/modules/tool-registry/description-length.js.map

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

package/dist/modules/tool-registry/index.d.ts

@@ -0,0 +1,8 @@
+export { declaresWrite, type IToolRegistry, type JsonSchema, type ToolListProvider, type ToolManualContext, type ToolProvider, type UtcpTool, } from './tool.contract.js';
+export { ToolRegistry } from './tool-registry.js';
+export { createManualRoutes, type ResolveUserEmail } from './manual.routes.js';
+export type { IToolReadOnlyHints, ToolReadOnlyEntry } from './read-only-hints.contract.js';
+export { TOOL_READ_ONLY_SETTING, ToolReadOnlyHints, UnknownToolError, createToolHintsAgentRoutes, createToolHintsRoutes, } from './read-only-hints.js';
+export { TOOL_DESCRIPTION_CAP } from './description-length.js';
+export { GET_AGENT_GUIDE_TOOL, GUIDE_FIRST_SENTENCE, guideFirstDescription, withGuideFirst } from './guide-first.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/tool-registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/tool-registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,QAAQ,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAC3F,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/modules/tool-registry/index.js

@@ -0,0 +1,8 @@
+export { declaresWrite, } from './tool.contract.js';
+export { ToolRegistry } from './tool-registry.js';
+export { createManualRoutes } from './manual.routes.js';
+export { TOOL_READ_ONLY_SETTING, ToolReadOnlyHints, UnknownToolError, createToolHintsAgentRoutes, createToolHintsRoutes, } from './read-only-hints.js';
+// Reached by other modules; exported here so they stop importing the files.
+export { TOOL_DESCRIPTION_CAP } from './description-length.js';
+export { GET_AGENT_GUIDE_TOOL, GUIDE_FIRST_SENTENCE, guideFirstDescription, withGuideFirst } from './guide-first.js';
+//# sourceMappingURL=index.js.map

package/dist/modules/tool-registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/tool-registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,GAOd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAyB,MAAM,oBAAoB,CAAC;AAE/E,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,4EAA4E;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/modules/tool-registry/manual.routes.d.ts

@@ -1,6 +1,48 @@
 import express, { type RequestHandler } from 'express';
-import type { IToolRegistry } from './tool.contract.js';
+import { type IToolRegistry } from './tool.contract.js';
+import { type IAgentScopeResolver } from '../agent-scope/index.js';
+import type { IToolReadOnlyHints } from './read-only-hints.contract.js';
 /** Resolve a connection-key/internal-token user id to its email (for per-caller provider defs). */
 export type ResolveUserEmail = (userId: string) => Promise<string | undefined>;
-export declare function createManualRoutes(registry: IToolRegistry, manualAuth: RequestHandler, resolveUserEmail?: ResolveUserEmail): express.Router;
+/**
+ * The two discovery endpoints — dynamically-built UTCP specs over the catalog:
+ *   GET /agent/utcp           — external tools (pipeline-agent, MCP proxy)
+ *   GET /agent/internal/utcp  — internal tools (our agent's code-mode client)
+ *
+ * Both are gated by `manualAuth` — a read-only superset of `toolAuth` that also
+ * accepts a browser JWT (`source: 'session'`) so a logged-in user can browse the
+ * catalog with their session; tool EXECUTION routes keep the strict `toolAuth`,
+ * so a JWT can read the manual but never invoke a tool. The internal catalog
+ * additionally requires `requireInternalSource`, so neither an external
+ * connection key nor a browser session can enumerate the internal tool surface.
+ * Both must mount BEFORE the JWT-protected `/api` mounts (Express fires the outer
+ * JWT middleware before route matching otherwise). The catalog is resolved **per
+ * request** (`registry.list*` awaits any `ToolProvider`s), so a tool whose def is
+ * built lazily — e.g. the skill tools, whose description names the current skills
+ * — stays current without a restart. Static tools resolve to the same def every
+ * time, so this is cheap.
+ *
+ * The internal catalog is ALSO scope-filtered: a read-scoped caller (e.g. a
+ * consumer persona's internal token) is served only the tools it can actually
+ * invoke — write-tagged tools are dropped so its `list_tools`/manual never
+ * advertises a tool that would 403 at call time. The call-time write-scope
+ * refusal in `toolHandler` stays as the enforcement; this is least-information
+ * on top of it. (External callers are always write-scoped, so the external
+ * manual needs no variant.)
+ */
+export declare function createManualRoutes(registry: IToolRegistry, manualAuth: RequestHandler, resolveUserEmail?: ResolveUserEmail, 
+/**
+ * The read-only hints (`read-only-hints.ts`), put on the AGENT manual's tools
+ * as the `read-only` tag the hosted MCP endpoint turns into
+ * `annotations.readOnlyHint` — the built-in value; the endpoint joins an
+ * admin's override on at listing time.
+ * Absent, the manual carries the tools' own tags only.
+ */
+readOnlyHints?: Pick<IToolReadOnlyHints, 'apply'>, 
+/**
+ * Resolves the scope of a connection made as an agent configuration: the external
+ * manual then lists only the platform tools it loads, and the providers word
+ * their descriptions for it (`modules/agent-scope`).
+ */
+agentScope?: Pick<IAgentScopeResolver, 'resolve'>): express.Router;
 //# sourceMappingURL=manual.routes.d.ts.map

package/dist/modules/tool-registry/manual.routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manual.routes.d.ts","sourceRoot":"","sources":["../../../src/modules/tool-registry/manual.routes.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,EAAE,EAAgB,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAErE,OAAO,KAAK,EAAE,aAAa,EAA+B,MAAM,oBAAoB,CAAC;AAGrF,mGAAmG;AACnG,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAiD/E,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,cAAc,EAC1B,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,OAAO,CAAC,MAAM,CA2BhB"}
+{"version":3,"file":"manual.routes.d.ts","sourceRoot":"","sources":["../../../src/modules/tool-registry/manual.routes.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,EAAE,EAAgB,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAErE,OAAO,EAAiB,KAAK,aAAa,EAAyC,MAAM,oBAAoB,CAAC;AAE9G,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC3F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAExE,mGAAmG;AACnG,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAmB/E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,cAAc,EAC1B,gBAAgB,CAAC,EAAE,gBAAgB;AACnC;;;;;;GAMG;AACH,aAAa,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC;AACjD;;;;GAIG;AACH,UAAU,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,GAChD,OAAO,CAAC,MAAM,CA0ChB"}

package/dist/modules/tool-registry/manual.routes.js

@@ -1,6 +1,8 @@
 import express from 'express';
 import { UtcpManualSerializer } from '@utcp/sdk';
-import { requireInternalSource } from '../tool-auth/tool-auth.middleware.js';
+import { declaresWrite } from './tool.contract.js';
+import { requireInternalSource } from '../tool-auth/index.js';
+import { resolveConnectionScope } from '../agent-scope/index.js';
 const manualSerializer = new UtcpManualSerializer();
 /**
  * Serialize a catalog slice into a UTCP manual. The manual is the registry's
@@ -42,10 +44,21 @@ function toManual(tools) {
  * on top of it. (External callers are always write-scoped, so the external
  * manual needs no variant.)
  */
-function isWriteTool(tool) {
-    return (tool.tags ?? []).includes('write');
-}
-export function createManualRoutes(registry, manualAuth, resolveUserEmail) {
+export function createManualRoutes(registry, manualAuth, resolveUserEmail, 
+/**
+ * The read-only hints (`read-only-hints.ts`), put on the AGENT manual's tools
+ * as the `read-only` tag the hosted MCP endpoint turns into
+ * `annotations.readOnlyHint` — the built-in value; the endpoint joins an
+ * admin's override on at listing time.
+ * Absent, the manual carries the tools' own tags only.
+ */
+readOnlyHints, 
+/**
+ * Resolves the scope of a connection made as an agent configuration: the external
+ * manual then lists only the platform tools it loads, and the providers word
+ * their descriptions for it (`modules/agent-scope`).
+ */
+agentScope) {
     const router = express.Router();
     // Build the per-caller context once per request: resolve the caller's email
     // so a `ToolProvider` (e.g. the skill tools) can tailor its def to who's
@@ -54,21 +67,35 @@ export function createManualRoutes(registry, manualAuth, resolveUserEmail) {
         const userId = req.toolAuth?.userId;
         if (!userId)
             return {};
-        if (!resolveUserEmail)
-            return { userId };
+        let userEmail;
         try {
-            return { userId, userEmail: await resolveUserEmail(userId) };
+            userEmail = resolveUserEmail ? await resolveUserEmail(userId) : undefined;
         }
         catch {
-            return { userId };
+            userEmail = undefined;
         }
+        // Everything adds nothing to the context, so its providers are asked
+        // exactly what they were asked before connections could be narrowed.
+        const agentPath = req.toolAuth?.agentPath;
+        const connectionScope = agentPath ? await resolveConnectionScope(agentScope, userEmail, agentPath) : undefined;
+        return {
+            userId,
+            ...(userEmail !== undefined ? { userEmail } : {}),
+            ...(connectionScope ? { connectionScope } : {}),
+        };
     }
     router.get('/agent/utcp', manualAuth, async (req, res) => {
-        res.json(toManual(await registry.listExternal(await context(req))));
+        const ctx = await context(req);
+        const tools = await registry.listExternal(ctx);
+        // A connection made as an agent configuration is offered only the platform
+        // tools that file loads; a call to another is refused at its route.
+        const scope = ctx.connectionScope;
+        const offered = scope ? tools.filter((t) => scope.allowsPlatformTool(t.name)) : tools;
+        res.json(toManual(readOnlyHints ? readOnlyHints.apply(offered) : offered));
     });
     router.get('/agent/internal/utcp', manualAuth, requireInternalSource, async (req, res) => {
         const internal = await registry.listInternal(await context(req));
-        const tools = req.toolAuth?.scope === 'read' ? internal.filter((t) => !isWriteTool(t)) : internal;
+        const tools = req.toolAuth?.scope === 'read' ? internal.filter((t) => !declaresWrite(t)) : internal;
         res.json(toManual(tools));
     });
     return router;

package/dist/modules/tool-registry/manual.routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"manual.routes.js","sourceRoot":"","sources":["../../../src/modules/tool-registry/manual.routes.ts"],"names":[],"mappings":"AAAA,OAAO,OAA8C,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAK7E,MAAM,gBAAgB,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAEpD;;;;;;GAMG;AACH,SAAS,QAAQ,CAAC,KAAiB;IACjC,OAAO,gBAAgB,CAAC,YAAY,CAAC;QACnC,YAAY,EAAE,OAAO;QACrB,cAAc,EAAE,OAAO;QACvB,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,SAAS,WAAW,CAAC,IAAyB;IAC5C,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,QAAuB,EACvB,UAA0B,EAC1B,gBAAmC;IAEnC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAEhC,4EAA4E;IAC5E,yEAAyE;IACzE,yEAAyE;IACzE,KAAK,UAAU,OAAO,CAAC,GAAY;QACjC,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC;QACpC,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC,gBAAgB;YAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QACzC,IAAI,CAAC;YACH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,MAAM,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACvD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,QAAQ,CAAC,YAAY,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,GAAG,CAAC,sBAAsB,EAAE,UAAU,EAAE,qBAAqB,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACvF,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QACjE,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,EAAE,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAClG,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"manual.routes.js","sourceRoot":"","sources":["../../../src/modules/tool-registry/manual.routes.ts"],"names":[],"mappings":"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"}

package/dist/modules/tool-registry/read-only-hints.contract.d.ts

@@ -0,0 +1,52 @@
+import type { UtcpTool } from './tool.contract.js';
+/** One tool's read-only hint as the Tools page shows it. */
+export interface ToolReadOnlyEntry {
+    name: string;
+    /** `platform`: an endpoint of this deployment. `meta`: a feature of the MCP servers. */
+    kind: 'platform' | 'meta';
+    /** What the tool's own declaration makes it. */
+    builtIn: boolean;
+    /** The admin's override, or null when there is none. */
+    override: boolean | null;
+    /** What clients are told: the override when set, else the built-in value. */
+    readOnly: boolean;
+}
+/**
+ * What MCP clients are told about each platform tool's and code-mode
+ * meta-tool's effect, and an admin's per-deployment overrides of it. The
+ * routes, the agent manual and the core services depend on this, not on the
+ * implementation (`ToolReadOnlyHints` in `read-only-hints.ts`).
+ */
+export interface IToolReadOnlyHints {
+    /** The overrides in effect, as the database has them now. */
+    overrides(): Promise<Record<string, boolean>>;
+    /**
+     * The given manual tools, each tagged `read-only` exactly when its BUILT-IN
+     * hint is true. Overrides are not in it: a listing joins them on itself.
+     */
+    apply(tools: UtcpTool[]): UtcpTool[];
+    /** Every platform tool, then every meta-tool, with its built-in, override and effective value. */
+    describe(): Promise<ToolReadOnlyEntry[]>;
+    /** Every tool's effective hint, by name. */
+    hints(): Promise<Record<string, boolean>>;
+    /**
+     * Set one tool's override, or remove it (`null`). `updatedBy` is the admin's
+     * user id. Throws `UnknownToolError` for a name that is neither kind of tool.
+     */
+    set(name: string, readOnly: boolean | null, updatedBy: string | null): Promise<ToolReadOnlyEntry>;
+}
+/**
+ * Where the overrides are stored: the three operations on one deployment
+ * setting that `ToolReadOnlyHints` needs, and nothing of the settings module's
+ * own shape. `DeploymentSettingsService` is the store the composition root
+ * passes; a test passes anything with these three.
+ */
+export interface ToolReadOnlySettingsStore {
+    /** The setting's value as the database has it now, blank when nothing is set. */
+    reload(key: string): Promise<string>;
+    /** Store `value` only if nothing is stored yet; false when something was. */
+    recordIfAbsent(key: string, value: string, updatedBy: string | null): Promise<boolean>;
+    /** Replace `expected` with `next` (null removes the row); false when the stored value was not `expected`. */
+    swapIfValue(key: string, expected: string, next: string | null, updatedBy: string | null): Promise<boolean>;
+}
+//# sourceMappingURL=read-only-hints.contract.d.ts.map

package/dist/modules/tool-registry/read-only-hints.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-only-hints.contract.d.ts","sourceRoot":"","sources":["../../../src/modules/tool-registry/read-only-hints.contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,wFAAwF;IACxF,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;IAC1B,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,6EAA6E;IAC7E,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9C;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAAC;IACrC,kGAAkG;IAClG,QAAQ,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACzC,4CAA4C;IAC5C,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1C;;;OAGG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACnG;AAED;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,iFAAiF;IACjF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,6EAA6E;IAC7E,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvF,6GAA6G;IAC7G,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7G"}

package/dist/modules/tool-registry/read-only-hints.contract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=read-only-hints.contract.js.map

package/dist/modules/tool-registry/read-only-hints.contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-only-hints.contract.js","sourceRoot":"","sources":["../../../src/modules/tool-registry/read-only-hints.contract.ts"],"names":[],"mappings":""}

package/dist/modules/tool-registry/read-only-hints.d.ts

@@ -0,0 +1,89 @@
+import express, { type RequestHandler } from 'express';
+import { type IToolRegistry, type UtcpTool } from './tool.contract.js';
+import type { IToolReadOnlyHints, ToolReadOnlyEntry, ToolReadOnlySettingsStore } from './read-only-hints.contract.js';
+import type { IAdminAccessService } from '../admin/index.js';
+import '../auth/index.js';
+/** The deployment setting the overrides live in — see `CORE_SETTINGS`. */
+export declare const TOOL_READ_ONLY_SETTING = "toolReadOnlyOverrides";
+/** A name that is neither a platform tool nor a meta-tool. */
+export declare class UnknownToolError extends Error {
+    readonly toolName: string;
+    constructor(toolName: string);
+}
+/**
+ * What MCP clients are told about each platform tool's effect.
+ *
+ * Every platform tool declares whether it writes (the `write` tag `toolDef`
+ * puts on it), and that declaration is its BUILT-IN read-only hint: a tool
+ * that declares no write only reads. The same declaration already decides
+ * branch handling and the write gate, so a tool cannot be a reader there and
+ * a writer here. The code-mode meta-tools are not in the manual, so theirs is
+ * `META_TOOL_READ_ONLY`.
+ *
+ * An admin may override either kind per deployment, in either direction, from
+ * the Tools page. The override is the `toolReadOnlyOverrides` deployment
+ * setting, read from the database on every use — so a change made on one
+ * replica is in the next listing of every other, without a restart.
+ *
+ * Carried to the two MCP servers in two ways, both from here, and both joined
+ * on at LISTING time, never baked into anything cached: the hosted endpoint
+ * lists each platform tool with the built-in hint the agent manual's
+ * `read-only` tag carries (`GET /agent/utcp`), then applies {@link overrides}
+ * read for that very listing; the local `hexis-mcp` — whose discovery goes
+ * through the MCP endpoint, where tags do not survive — reads every effective
+ * hint from `GET /agent/tool-hints` per listing. Tools from the knowledge base (`.tool` manuals,
+ * plugin MCP servers) are not the registry's and are untouched.
+ */
+export declare class ToolReadOnlyHints implements IToolReadOnlyHints {
+    private readonly registry;
+    private readonly settings;
+    constructor(registry: Pick<IToolRegistry, 'listExternal'>, settings: ToolReadOnlySettingsStore);
+    /**
+     * The overrides in effect, as the database has them now. A value that cannot
+     * be read, or is not a map, is no override: every consumer then serves the
+     * built-in hints rather than failing its listing.
+     */
+    overrides(): Promise<Record<string, boolean>>;
+    /**
+     * The agent manual's tools, each tagged `read-only` exactly when its
+     * BUILT-IN hint is true — its write declaration, never an override. The
+     * hosted endpoint caches the tool surface it builds from this manual, so an
+     * override in it would outlive the toggle that set it; the override is
+     * joined on per listing instead (see the class note). New objects: the
+     * registry's own defs are shared by every request and are never written to.
+     */
+    apply(tools: UtcpTool[]): UtcpTool[];
+    /** Every platform tool, then every meta-tool, with its built-in, override and effective value. */
+    describe(): Promise<ToolReadOnlyEntry[]>;
+    /** Every tool's effective hint, by name — what `hexis-mcp` lists. */
+    hints(): Promise<Record<string, boolean>>;
+    /**
+     * Set one tool's override, or remove it (`null`), and answer the tool as it
+     * now stands. A compare-and-swap on the stored map, retried, so two admins
+     * saving different tools at once both land.
+     *
+     * `updatedBy` is the admin's USER ID, never their email: it lands in
+     * `deployment_settings.updated_by`, a uuid referencing `users.id`, and
+     * anything else is refused by the database.
+     */
+    set(name: string, readOnly: boolean | null, updatedBy: string | null): Promise<ToolReadOnlyEntry>;
+}
+/**
+ * The routes over {@link IToolReadOnlyHints}:
+ *
+ *   GET /agent/tool-hints     — every tool's effective hint, for `hexis-mcp`
+ *                               (behind `manualAuth`, like the manual itself)
+ *   GET /tool-hints           — every tool with its effective value, for the
+ *                               Tools page; any signed-in person, plus whether
+ *                               they may edit. The built-in value and the
+ *                               override go to an admin only: who changed what
+ *                               clients are told is the admins' business.
+ *   PUT /tool-hints/:name     — `{ readOnly: true | false | null }`, admins only;
+ *                               null removes the override
+ *
+ * The agent route is returned separately so it can mount on the tools router,
+ * ahead of the JWT `/api` mounts; the other two mount behind `authMiddleware`.
+ */
+export declare function createToolHintsAgentRoutes(hints: IToolReadOnlyHints, manualAuth: RequestHandler): express.Router;
+export declare function createToolHintsRoutes(hints: IToolReadOnlyHints, adminAccess: Pick<IAdminAccessService, 'isAdmin'>): express.Router;
+//# sourceMappingURL=read-only-hints.d.ts.map

package/dist/modules/tool-registry/read-only-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-only-hints.d.ts","sourceRoot":"","sources":["../../../src/modules/tool-registry/read-only-hints.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,EAAE,EAAgB,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAErE,OAAO,EAAiB,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EAC1B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG7D,OAAO,kBAAkB,CAAC;AAI1B,0EAA0E;AAC1E,eAAO,MAAM,sBAAsB,0BAA0B,CAAC;AAE9D,8DAA8D;AAC9D,qBAAa,gBAAiB,SAAQ,KAAK;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM;gBAAhB,QAAQ,EAAE,MAAM;CAItC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,iBAAkB,YAAW,kBAAkB;IAExD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,EAC7C,QAAQ,EAAE,yBAAyB;IAGtD;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAgBnD;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE;IAQpC,kGAAkG;IAC5F,QAAQ,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAmB9C,qEAAqE;IAC/D,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI/C;;;;;;;;OAQG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAqBxG;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAWhH;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,kBAAkB,EACzB,WAAW,EAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,GAChD,OAAO,CAAC,MAAM,CA0ChB"}