@introspection-ai/recipes 0.34.0 → 0.36.0

package/docs/mcp-configuration.md

@@ -48,6 +48,21 @@ including tools a server may add later; patterns such as `search_*` are invalid.
 `"required": true` must resolve to a bound endpoint at session materialization
 or the session fails closed rather than starting without the capability.
 
+In `mode: tools`, a required server must also be discovered when the session
+starts. A session skips that check for a server only when both of these hold:
+
+- the server's declaration sets `"discovery": "defer"` (default `"require"`),
+  so the Recipe chooses which servers may be skipped and an unmarked one is
+  always checked;
+- the host passes `mcpDiscovery: "defer"` because it boots the session only to
+  prepare it, such as building and caching its workspace. The declaration is
+  part of the Recipe, so every session sees it; this condition keeps a session
+  that does work, including one that checks the Recipe by calling its tools,
+  from skipping the server.
+
+Mark a server that cannot answer where the Recipe is prepared, such as a
+stand-in reachable only from where tasks run.
+
 ## 2. Choose an agent mode and narrow access
 
 An agent selects a subset of the package-permitted servers and tools. It cannot

package/docs/recipe-format.md

@@ -303,7 +303,9 @@ or closing a run interrupts or closes the runs beneath it.
 The `pi.mcp` package block declares capability servers and package-level tool
 policy. Agent `mcp` blocks narrow those declarations. Credentials and concrete
 endpoint bindings MUST NOT be required in distributable Recipe source. A host
-MUST reject an unbound required server before the session begins.
+MUST reject an unbound required server before the session begins. A host
+preparing a session that does no work MAY start it without the discovered
+catalog of a required server declared `"discovery": "defer"`.
 
 See [MCP configuration](mcp-configuration.md) for the complete authored and
 binding grammar.

package/docs/slack.md

@@ -84,6 +84,12 @@ allowed path, and adds the bot token before the request leaves for Slack.
 The adapter refuses to send a task locator when the provider proxy URL is
 missing. It never falls back to sending the locator to Slack.
 
+A proxy-native runtime (`INTROSPECTION_EGRESS_PROXY_NATIVE=1`, or a cloud task
+with no `INTROSPECTION_EGRESS_URL`) calls `https://slack.com/api` directly
+through `HTTPS_PROXY`. The egress terminates TLS for Slack and replaces the
+request's `Authorization` with the bot token, so the adapter sends a fixed
+stand-in token and never the locator.
+
 After `channels reply` or `channels send` succeeds in cloud, the adapter posts
 the `connector_posted` task event to the Data Plane. Cloud checks the agent
 session, current run, and destination before recording follow-up routing.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@introspection-ai/recipes",
-  "version": "0.34.0",
+  "version": "0.36.0",
   "description": "The open format for vertical agents, built on Pi.",
   "license": "Apache-2.0",
   "type": "module",
@@ -84,7 +84,7 @@
     "@introspection-sdk/introspection-pi": "^0.35.0",
     "@opentelemetry/api": "^1.9.1",
     "ajv": "^8.20.0",
-    "mcporter": "0.14.2",
+    "mcporter": "0.15.0",
     "yaml": "^2.9.0"
   },
   "peerDependencies": {
@@ -95,10 +95,10 @@
     "typebox": "*"
   },
   "devDependencies": {
-    "@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",
+    "@earendil-works/pi-agent-core": "1.3.0",
+    "@earendil-works/pi-ai": "1.3.0",
+    "@earendil-works/pi-coding-agent": "1.3.0",
+    "@earendil-works/pi-tui": "1.3.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.34.0",
-    "@introspection-ai/mcp-client-linux-arm64": "0.34.0",
-    "@introspection-ai/mcp-client-darwin-arm64": "0.34.0",
-    "@introspection-ai/mcp-client-darwin-x64": "0.34.0"
+    "@introspection-ai/mcp-client-linux-x64": "0.36.0",
+    "@introspection-ai/mcp-client-linux-arm64": "0.36.0",
+    "@introspection-ai/mcp-client-darwin-arm64": "0.36.0",
+    "@introspection-ai/mcp-client-darwin-x64": "0.36.0"
   },
   "scripts": {
     "build": "pnpm build:ts && pnpm build:native",

package/dist/mcp-chunks/call-arguments-ER7NWEPS.js

@@ -1,16 +0,0 @@
-import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
-import {
-  parseCallArguments
-} from "./chunk-CO4CYU5W.js";
-import "./chunk-ALLS7CUV.js";
-import "./chunk-VWNF5PIF.js";
-import "./chunk-HM26TIPK.js";
-import "./chunk-UHXTAPEC.js";
-import "./chunk-27XDYSXJ.js";
-import "./chunk-P3S4OJPI.js";
-import "./chunk-T4MQCFIK.js";
-import "./chunk-JQCSGX6E.js";
-import "./chunk-LRKZP7DJ.js";
-export {
-  parseCallArguments
-};

package/dist/mcp-chunks/client-MQMNAYYW.js

@@ -1,31 +0,0 @@
-import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
-import {
-  DaemonClient,
-  resolveDaemonPaths
-} from "./chunk-VRTH73R5.js";
-import "./chunk-YGRORKGT.js";
-import "./chunk-GJ7DWMRT.js";
-import "./chunk-7ZZZ7MR2.js";
-import "./chunk-FVZKQMZS.js";
-import "./chunk-SONMFI3S.js";
-import "./chunk-OURSGEZX.js";
-import "./chunk-M7VINGHY.js";
-import "./chunk-JRU5LZJQ.js";
-import "./chunk-2IO3FXZJ.js";
-import "./chunk-IWXEOLJL.js";
-import "./chunk-P3S4OJPI.js";
-import "./chunk-FWWPRZ37.js";
-import "./chunk-XDARNDP3.js";
-import "./chunk-7OQUF6V6.js";
-import "./chunk-43QNQO5C.js";
-import "./chunk-ZLV5S5UP.js";
-import "./chunk-T4MQCFIK.js";
-import "./chunk-JQCSGX6E.js";
-import "./chunk-EIXFNLU6.js";
-import "./chunk-35JUFDQI.js";
-import "./chunk-IR5SMKTP.js";
-import "./chunk-LRKZP7DJ.js";
-export {
-  DaemonClient,
-  resolveDaemonPaths
-};

package/dist/mcp-chunks/daemon-command-OMOZ5MP7.js

@@ -1,31 +0,0 @@
-import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
-import {
-  handleDaemonCli
-} from "./chunk-R636HUNL.js";
-import "./chunk-FQAJT6U2.js";
-import "./chunk-VRTH73R5.js";
-import "./chunk-YGRORKGT.js";
-import "./chunk-GJ7DWMRT.js";
-import "./chunk-7ZZZ7MR2.js";
-import "./chunk-FVZKQMZS.js";
-import "./chunk-SONMFI3S.js";
-import "./chunk-OURSGEZX.js";
-import "./chunk-M7VINGHY.js";
-import "./chunk-JRU5LZJQ.js";
-import "./chunk-2IO3FXZJ.js";
-import "./chunk-IWXEOLJL.js";
-import "./chunk-P3S4OJPI.js";
-import "./chunk-FWWPRZ37.js";
-import "./chunk-XDARNDP3.js";
-import "./chunk-7OQUF6V6.js";
-import "./chunk-43QNQO5C.js";
-import "./chunk-ZLV5S5UP.js";
-import "./chunk-T4MQCFIK.js";
-import "./chunk-JQCSGX6E.js";
-import "./chunk-EIXFNLU6.js";
-import "./chunk-35JUFDQI.js";
-import "./chunk-IR5SMKTP.js";
-import "./chunk-LRKZP7DJ.js";
-export {
-  handleDaemonCli
-};

package/dist/mcp-chunks/generated-daemon-runtime-SRFULTIT.js

@@ -1,31 +0,0 @@
-import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
-import {
-  createGeneratedKeepAliveRuntime
-} from "./chunk-FUKRLUU7.js";
-import "./chunk-YTO7DITJ.js";
-import "./chunk-VRTH73R5.js";
-import "./chunk-YGRORKGT.js";
-import "./chunk-GJ7DWMRT.js";
-import "./chunk-7ZZZ7MR2.js";
-import "./chunk-FVZKQMZS.js";
-import "./chunk-SONMFI3S.js";
-import "./chunk-OURSGEZX.js";
-import "./chunk-M7VINGHY.js";
-import "./chunk-JRU5LZJQ.js";
-import "./chunk-2IO3FXZJ.js";
-import "./chunk-IWXEOLJL.js";
-import "./chunk-P3S4OJPI.js";
-import "./chunk-FWWPRZ37.js";
-import "./chunk-XDARNDP3.js";
-import "./chunk-7OQUF6V6.js";
-import "./chunk-43QNQO5C.js";
-import "./chunk-ZLV5S5UP.js";
-import "./chunk-T4MQCFIK.js";
-import "./chunk-JQCSGX6E.js";
-import "./chunk-EIXFNLU6.js";
-import "./chunk-35JUFDQI.js";
-import "./chunk-IR5SMKTP.js";
-import "./chunk-LRKZP7DJ.js";
-export {
-  createGeneratedKeepAliveRuntime
-};

package/dist/mcp-chunks/runtime-Q4SCCOQE.js

@@ -1,38 +0,0 @@
-import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
-import {
-  callOnce,
-  createRuntime
-} from "./chunk-YGRORKGT.js";
-import "./chunk-GJ7DWMRT.js";
-import "./chunk-7ZZZ7MR2.js";
-import "./chunk-FVZKQMZS.js";
-import "./chunk-SONMFI3S.js";
-import "./chunk-OURSGEZX.js";
-import "./chunk-M7VINGHY.js";
-import "./chunk-JRU5LZJQ.js";
-import "./chunk-2IO3FXZJ.js";
-import {
-  MCPORTER_VERSION
-} from "./chunk-IWXEOLJL.js";
-import "./chunk-P3S4OJPI.js";
-import "./chunk-FWWPRZ37.js";
-import "./chunk-XDARNDP3.js";
-import {
-  readJsonFile,
-  writeJsonFile
-} from "./chunk-7OQUF6V6.js";
-import "./chunk-43QNQO5C.js";
-import "./chunk-ZLV5S5UP.js";
-import "./chunk-T4MQCFIK.js";
-import "./chunk-JQCSGX6E.js";
-import "./chunk-EIXFNLU6.js";
-import "./chunk-35JUFDQI.js";
-import "./chunk-IR5SMKTP.js";
-import "./chunk-LRKZP7DJ.js";
-export {
-  MCPORTER_VERSION,
-  callOnce,
-  createRuntime,
-  readJsonFile,
-  writeJsonFile
-};