@introspection-ai/recipes 0.30.1 → 0.32.0

package/dist/tool-search.js

@@ -1,176 +1,48 @@
-import { Type } from "typebox";
+import { createToolSearchExtension, } from "@earendil-works/pi-coding-agent";
 export const RECIPE_TOOL_SEARCH_NAME = "tool_search";
 export const LEGACY_MCP_TOOL_SEARCH_NAME = "mcp_search";
-function words(value) {
-    return value
-        .toLowerCase()
-        .split(/[^a-z0-9]+/)
-        .filter(Boolean);
-}
-function schemaSearchTerms(schema) {
-    const propertyNames = [];
-    const propertyDescriptions = [];
-    const visited = new Set();
-    const visit = (value) => {
-        if (!value || typeof value !== "object" || visited.has(value))
-            return;
-        visited.add(value);
-        const record = value;
-        if (record.properties && typeof record.properties === "object") {
-            for (const [name, property] of Object.entries(record.properties)) {
-                propertyNames.push(name);
-                if (property && typeof property === "object") {
-                    const description = property.description;
-                    if (typeof description === "string") {
-                        propertyDescriptions.push(description);
-                    }
-                }
-                visit(property);
-            }
-        }
-        for (const keyword of [
-            "allOf",
-            "anyOf",
-            "oneOf",
-            "items",
-            "additionalProperties",
-        ]) {
-            const nested = record[keyword];
-            if (Array.isArray(nested)) {
-                for (const entry of nested)
-                    visit(entry);
-            }
-            else {
-                visit(nested);
-            }
-        }
-    };
-    visit(schema);
-    return {
-        propertyNames: propertyNames.join(" ").toLowerCase(),
-        propertyDescriptions: propertyDescriptions.join(" ").toLowerCase(),
-    };
-}
-function scoreTool(tool, query) {
-    const normalizedQuery = query.trim().toLowerCase();
-    if (!normalizedQuery)
-        return 0;
-    const name = tool.name.toLowerCase();
-    const label = (tool.label ?? tool.name).toLowerCase();
-    const description = tool.description.toLowerCase();
-    const { propertyNames, propertyDescriptions } = schemaSearchTerms(tool.parameters);
-    let score = 0;
-    if (name === normalizedQuery)
-        score += 500;
-    if (label === normalizedQuery)
-        score += 300;
-    if (name.includes(normalizedQuery))
-        score += 120;
-    if (label.includes(normalizedQuery))
-        score += 100;
-    if (description.includes(normalizedQuery))
-        score += 60;
-    const nameTerms = new Set(words(name));
-    const labelTerms = new Set(words(label));
-    const propertyNameTerms = new Set(words(propertyNames));
-    for (const term of words(normalizedQuery)) {
-        if (nameTerms.has(term))
-            score += 40;
-        else if (name.includes(term))
-            score += 20;
-        if (labelTerms.has(term))
-            score += 30;
-        else if (label.includes(term))
-            score += 15;
-        if (description.includes(term))
-            score += 16;
-        if (propertyNameTerms.has(term))
-            score += 12;
-        else if (propertyNames.includes(term))
-            score += 6;
-        if (propertyDescriptions.includes(term))
-            score += 6;
-    }
-    return score;
-}
-export function createRecipeToolSearch(options) {
-    const toolsByName = new Map(options.tools.map((tool) => [tool.name, tool]));
-    const deferred = [...new Set(options.deferredToolNames)].map((name) => {
-        const tool = toolsByName.get(name);
-        if (!tool) {
-            throw new Error(`Recipe deferred tool '${name}' was not registered before tool search`);
-        }
-        return tool;
-    });
-    if (deferred.length === 0)
-        return undefined;
-    if (toolsByName.has(RECIPE_TOOL_SEARCH_NAME)) {
-        throw new Error(`Recipe tool name '${RECIPE_TOOL_SEARCH_NAME}' is reserved by the session`);
-    }
-    return {
-        name: RECIPE_TOOL_SEARCH_NAME,
-        label: "Tool search",
-        description: "Search inactive tools allowed for this Recipe and enable the best matches for the next model request.",
-        parameters: Type.Object({
-            query: Type.String({
-                description: "Capability or task to find a tool for.",
-            }),
-            limit: Type.Optional(Type.Integer({ minimum: 1, maximum: 10, default: 3 })),
-        }),
-        executionMode: "sequential",
-        async execute(_toolCallId, params) {
-            const input = params;
-            const query = typeof input.query === "string" ? input.query : "";
-            const limit = typeof input.limit === "number" ? input.limit : 3;
-            const active = new Set(options.activation.getActiveTools());
-            const matches = deferred
-                .filter((tool) => !active.has(tool.name))
-                .map((tool) => ({ tool, score: scoreTool(tool, query) }))
-                .filter((match) => match.score > 0)
-                .sort((left, right) => right.score - left.score ||
-                left.tool.name.localeCompare(right.tool.name))
-                .slice(0, limit);
-            const added = matches.map((match) => match.tool.name);
-            if (added.length > 0) {
-                options.activation.setActiveTools([...active, ...added]);
-            }
-            const details = {
-                matches: matches.map(({ tool }) => ({
-                    name: tool.name,
-                    label: tool.label ?? tool.name,
-                    description: tool.description,
-                })),
-                added,
-            };
-            const text = matches.length === 0
-                ? `No inactive Recipe tools matched "${query}".`
-                : [
-                    `Enabled ${matches.length} Recipe tool(s) for the next model request:`,
-                    ...matches.map(({ tool }) => `- ${tool.name}${tool.description ? `: ${tool.description}` : ""}`),
-                ].join("\n");
-            return {
-                content: [{ type: "text", text }],
-                details,
-            };
+/**
+ * Pi's `tool_search`, plus `mcp_search` as an alias when MCP tools are
+ * deferred. It searches tools registered with `deferred` exposure and declares
+ * the matches for the next model request.
+ */
+export function createRecipeToolSearchTools(tools, includeLegacyMcpAlias) {
+    let search;
+    createToolSearchExtension()({
+        ...tools,
+        registerTool: (definition) => {
+            search = definition;
         },
-    };
-}
-export function createRecipeToolSearchTools(options, includeLegacyMcpAlias) {
-    const search = createRecipeToolSearch(options);
+    });
     if (!search)
-        return [];
-    if (!includeLegacyMcpAlias)
-        return [search];
-    if (options.tools.some((tool) => tool.name === LEGACY_MCP_TOOL_SEARCH_NAME)) {
-        throw new Error(`Recipe tool name '${LEGACY_MCP_TOOL_SEARCH_NAME}' is reserved by the session`);
-    }
-    return [
-        search,
-        {
-            ...search,
-            name: LEGACY_MCP_TOOL_SEARCH_NAME,
-            label: "MCP search",
+        throw new Error("Pi did not provide tool_search");
+    const { defaultActive: _defaultActive, ...definition } = search;
+    return includeLegacyMcpAlias
+        ? [
+            definition,
+            {
+                ...definition,
+                name: LEGACY_MCP_TOOL_SEARCH_NAME,
+                label: LEGACY_MCP_TOOL_SEARCH_NAME,
+            },
+        ]
+        : [definition];
+}
+/** Register the named tools with `deferred` exposure, so tool search can load them. */
+export function deferTools(factory, deferredToolNames) {
+    if (deferredToolNames.length === 0)
+        return factory;
+    const deferred = new Set(deferredToolNames);
+    return (pi) => factory(new Proxy(pi, {
+        get(target, property, receiver) {
+            const value = Reflect.get(target, property, receiver);
+            if (property !== "registerTool" || typeof value !== "function") {
+                return typeof value === "function" ? value.bind(target) : value;
+            }
+            return (definition) => value.call(target, deferred.has(definition.name)
+                ? { ...definition, exposure: "deferred" }
+                : definition);
         },
-    ];
+    }));
 }
 //# sourceMappingURL=tool-search.js.map

package/dist/tool-search.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-search.js","sourceRoot":"","sources":["../src/tool-search.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-search.js","sourceRoot":"","sources":["../src/tool-search.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,GAI1B,MAAM,iCAAiC,CAAC;AAEzC,MAAM,CAAC,MAAM,uBAAuB,GAAG,aAAa,CAAC;AACrD,MAAM,CAAC,MAAM,2BAA2B,GAAG,YAAY,CAAC;AAOxD;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAA2B,EAC3B,qBAA8B;IAE9B,IAAI,MAAkC,CAAC;IACvC,yBAAyB,EAAE,CAAC;QAC1B,GAAG,KAAK;QACR,YAAY,EAAE,CAAC,UAA0B,EAAE,EAAE;YAC3C,MAAM,GAAG,UAAU,CAAC;QACtB,CAAC;KACyB,CAAC,CAAC;IAC9B,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAC/D,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,UAAU,EAAE,GAAG,MAAM,CAAC;IAChE,OAAO,qBAAqB;QAC1B,CAAC,CAAC;YACE,UAAU;YACV;gBACE,GAAG,UAAU;gBACb,IAAI,EAAE,2BAA2B;gBACjC,KAAK,EAAE,2BAA2B;aACnC;SACF;QACH,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;AACnB,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,UAAU,CACxB,OAAyB,EACzB,iBAAoC;IAEpC,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACnD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,EAAE,EAAE,CACZ,OAAO,CACL,IAAI,KAAK,CAAC,EAAE,EAAE;QACZ,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ;YAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACtD,IAAI,QAAQ,KAAK,cAAc,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAC/D,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YAClE,CAAC;YACD,OAAO,CAAC,UAA0B,EAAE,EAAE,CACpC,KAAK,CAAC,IAAI,CACR,MAAM,EACN,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;gBAC3B,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;gBACzC,CAAC,CAAC,UAAU,CACf,CAAC;QACN,CAAC;KACF,CAAC,CACH,CAAC;AACN,CAAC"}

package/docs/mcp-configuration.md

@@ -91,11 +91,13 @@ to hide all authorized tools for a server, then optionally list exact tools in
 or a sole `"*"` selector. `eager` wins when a tool matches both fields, but
 neither field can authorize a tool excluded by `include`/`exclude`.
 
-Deferred tools remain authorized and discoverable. When at least one connector
-or MCP tool is deferred, Recipes registers `tool_search`. Calling it searches
-the inactive tools already allowed for the agent and adds the best matches to
-Pi's active tool set for the next model request. It never grants access beyond
-the Recipe manifest and agent policy. Recipes also registers `mcp_search` as a
+Deferred tools remain authorized and discoverable. Recipes registers them with
+Pi's `deferred` exposure and, when at least one connector or MCP tool is
+deferred, activates Pi's `tool_search`. Calling it ranks the deferred tools by
+the words in their names, descriptions and input schemas (BM25, default limit
+8) and declares the best matches for the next model request. Pi records the
+change in the session, so loaded tools survive resume. It never grants access
+beyond the Recipe manifest and agent policy. Recipes also registers `mcp_search` as a
 compatibility alias when MCP tools are deferred.
 
 `defer` and `eager` are invalid in CLI mode. An omitted agent `mcp` block

package/docs/pi-extension.md

@@ -29,7 +29,7 @@ For direct Pi use:
 pi install npm:@introspection-ai/recipes
 ```
 
-Recipes currently requires Node.js 24 or later and Pi `>=0.86.1`.
+Recipes currently requires Node.js 24 or later and Pi `>=1.1.0`.
 
 ## Selection
 

package/docs/recipe-judges.md

@@ -83,6 +83,45 @@ llm:
 Unknown fields are errors at every level. The obsolete top-level `model:`
 block is rejected.
 
+## Judge types
+
+`type` says when a judge runs:
+
+- `online`, the default: at the end of every runtime conversation.
+- `offline`: at the end of each eval trial. It has the same shape as `online`.
+- `mission`: on a request leaving the sandbox, which a route in the Recipe's
+  `policies/routes.yaml` names. Its answers reach the Recipe's Cedar policy
+  before the request is allowed.
+
+A mission judge asks yes-or-no questions instead of grading against a rubric, and
+the platform chooses the model:
+
+```yaml
+name: booking
+type: mission
+description: Is this booking what the traveller asked for?
+attrs: [city, check_in, check_out, total_cents]
+questions:
+  requested:
+    instructions: >
+      Is the booking something the traveller asked for, or a natural part of
+      that trip?
+    criteria:
+      "true": The same destination and dates.
+      "false": Another place, other dates, or something they never asked for.
+  personal:
+    instructions: Did the traveller describe this part of the trip as personal?
+```
+
+- `questions` maps between one and eight lowercase identifiers to questions;
+  each name is the field its answer is read as.
+- `instructions` is non-empty text. `criteria` is optional and, when present,
+  describes both `true` and `false` in non-empty text.
+- `attrs` lists the request attributes the judge sees, and is empty to show
+  them all.
+- `on` and `llm` belong to `online` and `offline` judges and are rejected on a
+  mission judge; `questions` and `attrs` are rejected on the others.
+
 ### LLM settings
 
 - `provider` is a 1-64 byte lowercase slug containing ASCII letters, digits,
@@ -141,4 +180,5 @@ Invalid Recipe content is reported through the normal diagnostics model. Judge
 diagnostics use stable `judge.*` codes, Recipe-relative source paths, useful
 help text, and deterministic ordering. YAML syntax failures use
 `judge.yaml_malformed` and include a 1-based source span when the parser
-provides one.
+provides one. An invalid mission judge reports `judge.mission_invalid`, and a
+`type` outside `online`, `offline` and `mission` reports `judge.type_invalid`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@introspection-ai/recipes",
-  "version": "0.30.1",
+  "version": "0.32.0",
   "description": "The open format for vertical agents, built on Pi.",
   "license": "Apache-2.0",
   "type": "module",
@@ -88,17 +88,17 @@
     "yaml": "^2.9.0"
   },
   "peerDependencies": {
-    "@earendil-works/pi-agent-core": ">=0.86.1",
-    "@earendil-works/pi-ai": ">=0.86.1",
-    "@earendil-works/pi-coding-agent": ">=0.86.1",
-    "@earendil-works/pi-tui": ">=0.86.1",
+    "@earendil-works/pi-agent-core": ">=1.1.0 <2.0.0",
+    "@earendil-works/pi-ai": ">=1.1.0 <2.0.0",
+    "@earendil-works/pi-coding-agent": ">=1.1.0 <2.0.0",
+    "@earendil-works/pi-tui": ">=1.1.0 <2.0.0",
     "typebox": "*"
   },
   "devDependencies": {
-    "@earendil-works/pi-agent-core": "0.99.2",
-    "@earendil-works/pi-ai": "0.99.2",
-    "@earendil-works/pi-coding-agent": "0.99.2",
-    "@earendil-works/pi-tui": "0.99.2",
+    "@earendil-works/pi-agent-core": "1.1.0",
+    "@earendil-works/pi-ai": "1.1.0",
+    "@earendil-works/pi-coding-agent": "1.1.0",
+    "@earendil-works/pi-tui": "1.1.0",
     "@types/node": "^26.1.2",
     "esbuild": "^0.28.1",
     "typebox": "^1.0.56",
@@ -106,10 +106,10 @@
     "vitest": "^5.0.1"
   },
   "optionalDependencies": {
-    "@introspection-ai/mcp-client-linux-x64": "0.30.1",
-    "@introspection-ai/mcp-client-linux-arm64": "0.30.1",
-    "@introspection-ai/mcp-client-darwin-arm64": "0.30.1",
-    "@introspection-ai/mcp-client-darwin-x64": "0.30.1"
+    "@introspection-ai/mcp-client-linux-x64": "0.32.0",
+    "@introspection-ai/mcp-client-linux-arm64": "0.32.0",
+    "@introspection-ai/mcp-client-darwin-arm64": "0.32.0",
+    "@introspection-ai/mcp-client-darwin-x64": "0.32.0"
   },
   "scripts": {
     "build": "pnpm build:ts && pnpm build:native",