@bevel-software/platform-core-backend 0.25.2 → 0.26.0

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

@@ -5,13 +5,14 @@
  * where the text specific to the tool sits, after whatever shared preamble it
  * carried. Agents reported `file_stat`, `read_file`, `write_file` and
  * `write_files` arriving ending in "[truncated]". The rules those descriptions
- * shared now live in one place (see `agent-instructions/shared-file-rules.ts`)
- * and each description ends with one sentence pointing there, which is what
- * makes the cap below reachable rather than aspirational.
+ * shared now live in one place (see `agent-instructions/shared-file-rules.ts`,
+ * served in the guide `get_agent_guide` returns) and each description OPENS
+ * with the one sentence sending the agent there (`guide-first.ts`), which is
+ * what makes the cap below reachable rather than aspirational.
  */
 import { TOOL_PREFIX_CAP } from '@bevel-software/platform-shared';
 import { PREFIXED_TOOLS } from '../agent-instructions/compose.js';
-import { SHARED_RULES_POINTER_MAX, sharedRulesPointer } from '../agent-instructions/shared-file-rules.js';
+import { GUIDE_FIRST_SENTENCE } from './guide-first.js';
 /**
  * The ceiling on what a client is handed for one tool, enforced by
  * `__tests__/tool-description-length.test.ts`.
@@ -22,8 +23,10 @@ import { SHARED_RULES_POINTER_MAX, sharedRulesPointer } from '../agent-instructi
  * could answer: no useful description of `move_file` fits in 500. What answers
  * that one is the ORDER of the text, which is why the deployment's purpose line
  * is prepended rather than appended (see `prefixToolDescription`) and why every
- * description now leads with what the tool does and ends with the pointer: a
- * cut at 500 then takes the pointer and leaves the tool. The other cut is the
+ * description now opens with the guide-first sentence and then what the tool
+ * does, with the tool's own detail last: a cut at 500 keeps the sentence and
+ * the tool's first sentence (see `firstSentenceEnd`) and takes the detail,
+ * which the guide states in full anyway. The other cut is the
  * four-figure one agents reported on `file_stat`, `read_file`, `write_file` and
  * `write_files`, and 1,200 sits below it with room to spare.
  *
@@ -55,9 +58,10 @@ export const TOOL_DESCRIPTION_CAP = 1_200;
 export const CLIENT_SHORT_CUT = 500;
 /**
  * Where the tool's OWN opening sentence ends in the text a client is handed:
- * the purpose prefix counted at its cap, as in {@link clientVisibleLength}, and
- * the pointer not counted at all, since it is the part a short cut is meant to
- * take.
+ * the purpose prefix counted at its cap, as in {@link clientVisibleLength},
+ * and the guide-first sentence every listed tool opens with counted as the
+ * text it is — a client that cuts at 500 must still reach the sentence saying
+ * what the tool does, past that one.
  *
  * A description with no sentence-ending punctuation counts whole — the honest
  * answer for text that never finishes a sentence.
@@ -67,10 +71,15 @@ export function firstSentenceEnd(tool) {
     const description = tool.description ?? '';
     if (description === '')
         return prefix;
-    const pointer = sharedRulesPointer();
-    const own = description.endsWith(pointer) ? description.slice(0, -pointer.length) : description;
+    // The opener and whatever whitespace follows it: `guideFirstDescription`
+    // joins with one space, and leaves a description that already opens with
+    // the sentence as it came — a newline after it is still the opener's.
+    const opener = description.startsWith(GUIDE_FIRST_SENTENCE)
+        ? GUIDE_FIRST_SENTENCE.length + (description.slice(GUIDE_FIRST_SENTENCE.length).match(/^\s*/)?.[0].length ?? 0)
+        : 0;
+    const own = description.slice(opener);
     const firstSentence = own.match(/^[\s\S]*?[.!?](?=\s|$)/)?.[0] ?? own;
-    return prefix + firstSentence.length;
+    return prefix + opener + firstSentence.length;
 }
 /**
  * The length of the description as a CLIENT receives it — which for the four
@@ -80,12 +89,8 @@ export function firstSentenceEnd(tool) {
  * the cap is what an admin may grow their text to without being told, so a
  * description that only fits beside a short prefix does not really fit.
  *
- * The pointer sentence is measured the same way, for the same reason. It ends
- * every file tool's description and its length moves with a DEPLOYMENT SETTING
- * — the guide's file name — so a description measured beside the nine
- * characters of `AGENTS.md` would pass here and arrive cut on a deployment
- * that renamed its guide. Whatever pointer a description actually carries is
- * discounted and charged at {@link SHARED_RULES_POINTER_MAX} instead.
+ * The guide-first sentence every listed tool opens with is already in the
+ * description the registry lists, so it is measured as the text it is.
  */
 export function clientVisibleLength(tool) {
     const own = tool.description?.length ?? 0;
@@ -95,14 +100,7 @@ export function clientVisibleLength(tool) {
     // text the client got.
     if (own === 0)
         return PREFIXED_TOOLS.has(tool.name) ? TOOL_PREFIX_CAP : 0;
-    // The pointer at its worst case rather than at this layout's: swap the one
-    // it carries for the longest it could be. A description that does not end
-    // with it (`start_session`, the proxied tools) is charged nothing.
-    const pointer = sharedRulesPointer();
-    const atWorstPointer = tool.description.endsWith(pointer)
-        ? own - pointer.length + SHARED_RULES_POINTER_MAX
-        : own;
     // `+ 2` for the blank line `prefixToolDescription` puts between the two.
-    return PREFIXED_TOOLS.has(tool.name) ? atWorstPointer + TOOL_PREFIX_CAP + 2 : atWorstPointer;
+    return PREFIXED_TOOLS.has(tool.name) ? own + TOOL_PREFIX_CAP + 2 : own;
 }
 //# sourceMappingURL=description-length.js.map

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":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAG1G;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAEpC;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAA4C;IAC3E,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;IAC3C,IAAI,WAAW,KAAK,EAAE;QAAE,OAAO,MAAM,CAAC;IACtC,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IACrC,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;IAChG,MAAM,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IACtE,OAAO,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAA4C;IAC9E,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC,CAAC;IAC1C,6EAA6E;IAC7E,6EAA6E;IAC7E,0EAA0E;IAC1E,uBAAuB;IACvB,IAAI,GAAG,KAAK,CAAC;QAAE,OAAO,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,2EAA2E;IAC3E,0EAA0E;IAC1E,mEAAmE;IACnE,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IACrC,MAAM,cAAc,GAAG,IAAI,CAAC,WAAY,CAAC,QAAQ,CAAC,OAAO,CAAC;QACxD,CAAC,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM,GAAG,wBAAwB;QACjD,CAAC,CAAC,GAAG,CAAC;IACR,yEAAyE;IACzE,OAAO,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,GAAG,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC;AAC/F,CAAC"}
+{"version":3,"file":"description-length.js","sourceRoot":"","sources":["../../../src/modules/tool-registry/description-length.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGxD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAEpC;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAA4C;IAC3E,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;IAC3C,IAAI,WAAW,KAAK,EAAE;QAAE,OAAO,MAAM,CAAC;IACtC,yEAAyE;IACzE,yEAAyE;IACzE,sEAAsE;IACtE,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,oBAAoB,CAAC;QACzD,CAAC,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;QAC/G,CAAC,CAAC,CAAC,CAAC;IACN,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IACtE,OAAO,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;AAChD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAA4C;IAC9E,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC,CAAC;IAC1C,6EAA6E;IAC7E,6EAA6E;IAC7E,0EAA0E;IAC1E,uBAAuB;IACvB,IAAI,GAAG,KAAK,CAAC;QAAE,OAAO,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,yEAAyE;IACzE,OAAO,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACzE,CAAC"}

package/dist/modules/tool-registry/guide-first.d.ts

@@ -0,0 +1,23 @@
+import type { UtcpTool } from './tool.contract.js';
+/** The one tool that returns the platform's guide (see `modules/agent-guide`). */
+export declare const GET_AGENT_GUIDE_TOOL = "get_agent_guide";
+/**
+ * The sentence every tool of the platform's own OPENS with: what to do before
+ * anything else here. At the front, not the end, because clients cut a long
+ * description from the end and the one instruction that must survive is this
+ * one. The guide's own tool is the one that does not carry it — it IS what
+ * the sentence points at.
+ */
+export declare const GUIDE_FIRST_SENTENCE = "Call `get_agent_guide` first and read the platform's guide before anything else here.";
+/**
+ * `description` as a client is handed it: the sentence ahead of it, once. A
+ * description that already opens with the sentence is returned as it is, and
+ * an absent or empty one becomes the sentence alone. The ONE place the
+ * sentence is put in front of a description — the registry for the tools it
+ * lists, the MCP service for the meta-tools it builds itself — so the two
+ * cannot drift apart on what "once" means.
+ */
+export declare function guideFirstDescription(description: string | undefined): string;
+/** `tool` as the catalog lists it: the sentence ahead of its own description, except on the guide's own tool. */
+export declare function withGuideFirst(tool: UtcpTool): UtcpTool;
+//# sourceMappingURL=guide-first.d.ts.map

package/dist/modules/tool-registry/guide-first.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-first.d.ts","sourceRoot":"","sources":["../../../src/modules/tool-registry/guide-first.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,kFAAkF;AAClF,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AAEtD;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,0FAAoG,CAAC;AAEtI;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI7E;AAED,iHAAiH;AACjH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAIvD"}

package/dist/modules/tool-registry/guide-first.js

@@ -0,0 +1,32 @@
+/** The one tool that returns the platform's guide (see `modules/agent-guide`). */
+export const GET_AGENT_GUIDE_TOOL = 'get_agent_guide';
+/**
+ * The sentence every tool of the platform's own OPENS with: what to do before
+ * anything else here. At the front, not the end, because clients cut a long
+ * description from the end and the one instruction that must survive is this
+ * one. The guide's own tool is the one that does not carry it — it IS what
+ * the sentence points at.
+ */
+export const GUIDE_FIRST_SENTENCE = `Call \`${GET_AGENT_GUIDE_TOOL}\` first and read the platform's guide before anything else here.`;
+/**
+ * `description` as a client is handed it: the sentence ahead of it, once. A
+ * description that already opens with the sentence is returned as it is, and
+ * an absent or empty one becomes the sentence alone. The ONE place the
+ * sentence is put in front of a description — the registry for the tools it
+ * lists, the MCP service for the meta-tools it builds itself — so the two
+ * cannot drift apart on what "once" means.
+ */
+export function guideFirstDescription(description) {
+    const own = description ?? '';
+    if (own.startsWith(GUIDE_FIRST_SENTENCE))
+        return own;
+    return own ? `${GUIDE_FIRST_SENTENCE} ${own}` : GUIDE_FIRST_SENTENCE;
+}
+/** `tool` as the catalog lists it: the sentence ahead of its own description, except on the guide's own tool. */
+export function withGuideFirst(tool) {
+    if (tool.name === GET_AGENT_GUIDE_TOOL)
+        return tool;
+    const description = guideFirstDescription(tool.description);
+    return description === tool.description ? tool : { ...tool, description };
+}
+//# sourceMappingURL=guide-first.js.map

package/dist/modules/tool-registry/guide-first.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-first.js","sourceRoot":"","sources":["../../../src/modules/tool-registry/guide-first.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,oBAAoB,mEAAmE,CAAC;AAEtI;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAA+B;IACnE,MAAM,GAAG,GAAG,WAAW,IAAI,EAAE,CAAC;IAC9B,IAAI,GAAG,CAAC,UAAU,CAAC,oBAAoB,CAAC;QAAE,OAAO,GAAG,CAAC;IACrD,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,oBAAoB,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,oBAAoB,CAAC;AACvE,CAAC;AAED,iHAAiH;AACjH,MAAM,UAAU,cAAc,CAAC,IAAc;IAC3C,IAAI,IAAI,CAAC,IAAI,KAAK,oBAAoB;QAAE,OAAO,IAAI,CAAC;IACpD,MAAM,WAAW,GAAG,qBAAqB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5D,OAAO,WAAW,KAAK,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,CAAC;AAC5E,CAAC"}

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

@@ -6,6 +6,12 @@ import type { IToolRegistry, ToolListProvider, ToolManualContext, ToolProvider,
  * catalog only aggregates and lists them — the two manual endpoints serialize
  * each list per request. Insertion order is preserved (static tools first, then
  * provider-built ones); a duplicate static name within a surface throws.
+ *
+ * Every listed tool but the guide's own (`get_agent_guide`, which is what the
+ * sentence points at) opens with the one sentence saying what to do before
+ * any of them (`guide-first.ts`): applied here, at the one place both
+ * surfaces list from, so no module that registers a tool has to remember it
+ * and no surface can serve a tool without it.
  */
 export declare class ToolRegistry implements IToolRegistry {
     private readonly external;

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

@@ -1 +1 @@
-{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../../src/modules/tool-registry/tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACT,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;GAOG;AACH,qBAAa,YAAa,YAAW,aAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IACxD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAsB;IACxD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAsB;IACxD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAA0B;IAEhE,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,GAAG,IAAI;IAKzD,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,GAAG,IAAI;IAKzD,qBAAqB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAIjD,YAAY,CAAC,GAAG,GAAE,iBAAsB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAK9D,YAAY,CAAC,GAAG,GAAE,iBAAsB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAMpE,OAAO,CAAC,GAAG;CAMZ"}
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../../src/modules/tool-registry/tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACT,MAAM,oBAAoB,CAAC;AAG5B;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAa,YAAW,aAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IACxD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAsB;IACxD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAsB;IACxD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAA0B;IAEhE,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,GAAG,IAAI;IAKzD,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,GAAG,IAAI;IAKzD,qBAAqB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAIjD,YAAY,CAAC,GAAG,GAAE,iBAAsB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAK9D,YAAY,CAAC,GAAG,GAAE,iBAAsB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAMpE,OAAO,CAAC,GAAG;CAMZ"}

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

@@ -1,3 +1,4 @@
+import { withGuideFirst } from './guide-first.js';
 /**
  * The tool catalog. Modules call `registerExternalTool` / `registerInternalTool`
  * (both, for a `both` tool) with a self-describing UTCP `Tool` def, or a
@@ -5,6 +6,12 @@
  * catalog only aggregates and lists them — the two manual endpoints serialize
  * each list per request. Insertion order is preserved (static tools first, then
  * provider-built ones); a duplicate static name within a surface throws.
+ *
+ * Every listed tool but the guide's own (`get_agent_guide`, which is what the
+ * sentence points at) opens with the one sentence saying what to do before
+ * any of them (`guide-first.ts`): applied here, at the one place both
+ * surfaces list from, so no module that registers a tool has to remember it
+ * and no surface can serve a tool without it.
  */
 export class ToolRegistry {
     external = new Map();
@@ -29,12 +36,12 @@ export class ToolRegistry {
     }
     async listExternal(ctx = {}) {
         const dynamic = await Promise.all(this.externalProviders.map((p) => p(ctx)));
-        return [...this.external.values(), ...dynamic];
+        return [...this.external.values(), ...dynamic].map(withGuideFirst);
     }
     async listInternal(ctx = {}) {
         const dynamic = await Promise.all(this.internalProviders.map((p) => p(ctx)));
         const lists = await Promise.all(this.internalListProviders.map((p) => p(ctx)));
-        return [...this.internal.values(), ...dynamic, ...lists.flat()];
+        return [...this.internal.values(), ...dynamic, ...lists.flat()].map(withGuideFirst);
     }
     add(into, tool, surface) {
         if (into.has(tool.name)) {

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

@@ -1 +1 @@
-{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../../../src/modules/tool-registry/tool-registry.ts"],"names":[],"mappings":"AAQA;;;;;;;GAOG;AACH,MAAM,OAAO,YAAY;IACN,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IACvC,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IACvC,iBAAiB,GAAmB,EAAE,CAAC;IACvC,iBAAiB,GAAmB,EAAE,CAAC;IACvC,qBAAqB,GAAuB,EAAE,CAAC;IAEhE,oBAAoB,CAAC,IAA6B;QAChD,IAAI,OAAO,IAAI,KAAK,UAAU;YAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YAC7D,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IACjD,CAAC;IAED,oBAAoB,CAAC,IAA6B;QAChD,IAAI,OAAO,IAAI,KAAK,UAAU;YAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YAC7D,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IACjD,CAAC;IAED,qBAAqB,CAAC,QAA0B;QAC9C,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAAyB,EAAE;QAC5C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7E,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAAyB,EAAE;QAC5C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC/E,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IAEO,GAAG,CAAC,IAA2B,EAAE,IAAc,EAAE,OAAe;QACtE,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,aAAa,OAAO,gBAAgB,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;CACF"}
+{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../../../src/modules/tool-registry/tool-registry.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,YAAY;IACN,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IACvC,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IACvC,iBAAiB,GAAmB,EAAE,CAAC;IACvC,iBAAiB,GAAmB,EAAE,CAAC;IACvC,qBAAqB,GAAuB,EAAE,CAAC;IAEhE,oBAAoB,CAAC,IAA6B;QAChD,IAAI,OAAO,IAAI,KAAK,UAAU;YAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YAC7D,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IACjD,CAAC;IAED,oBAAoB,CAAC,IAA6B;QAChD,IAAI,OAAO,IAAI,KAAK,UAAU;YAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YAC7D,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IACjD,CAAC;IAED,qBAAqB,CAAC,QAA0B;QAC9C,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAAyB,EAAE;QAC5C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7E,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAAyB,EAAE;QAC5C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC/E,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACtF,CAAC;IAEO,GAAG,CAAC,IAA2B,EAAE,IAAc,EAAE,OAAe;QACtE,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,aAAa,OAAO,gBAAgB,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;CACF"}