@introspection-ai/recipes 0.23.0 → 0.24.0

package/dist/channels/types.d.ts

@@ -1,25 +1,12 @@
 /**
  * Provider-neutral channel primitives.
  *
- * A channel-origin task answers exactly one conversation. These types describe
- * what an agent may do *inside* that conversation, in vocabulary that is the
- * same for Slack, Teams, or anything else, so one prompt serves every channel.
- *
- * Two properties are structural rather than documented:
- *
- * - **The destination is bound.** An adapter method takes the conversation from
- *   the trusted `ChannelTarget` the host resolved; no tool schema built from
- *   these types carries a channel, thread, workspace, or user argument.
- * - **Unsupported is absent.** Tools are registered from `ChannelCapabilities`,
- *   so a channel that cannot read earlier messages simply has no read tool. A
- *   tool that always answers "unsupported" costs a model turn and teaches
- *   nothing.
- *
- * Operations outside this bound channel set, including workspace search,
- * directory lookups, and sends to another conversation, are unsupported. Their
- * contract and access model are deferred to a separate proposal.
+ * Reply defaults to the host-resolved origin. Adapters may opt into explicit
+ * read/send destinations within their existing credential session. This is a
+ * tool contract, not a sandbox-wide authorization boundary. Unsupported
+ * operations are absent. Search and directory lookup are not part of it.
  */
-/** The conversation a task answers. Resolved by the host, never by the model. */
+/** A conversation within one provider credential session. */
 export interface ChannelTarget {
     readonly provider: string;
     /** Provider conversation id (Slack channel, Teams conversation). */
@@ -39,6 +26,10 @@ export interface ChannelTarget {
  * already wasted a turn on.
  */
 export interface ChannelCapabilities {
+    /** Accept explicit read targets and expose send. Absent preserves bound tools. */
+    readonly targeting?: boolean;
+    /** List conversations available to this provider credential session. */
+    readonly list?: boolean;
     readonly react: boolean;
     readonly edit: boolean;
     readonly retract: boolean;
@@ -67,10 +58,7 @@ export type ChannelCursor = string;
 /**
  * An opaque handle for one file seen in this conversation.
  *
- * Same reasoning as `MessageRef`, and for the same threat: a provider file id
- * is reachable across every conversation the bot belongs to, so accepting one
- * from the model would reintroduce the addressing argument the bound tier
- * exists to remove — just spelled `file` instead of `channel`.
+ * Like message refs, files must have been observed in this credential session.
  */
 export type FileRef = string;
 export interface ChannelAuthor {
@@ -82,22 +70,22 @@ export interface ChannelAttachment {
     /**
      * Opaque session handle, not the provider's file id.
      *
-     * Minted when the file is seen in this conversation, and the only
-     * thing `channel_fetch_file` accepts. A raw provider file id would be an
-     * addressing argument in everything but name: a bot can usually read files
-     * from every conversation it belongs to, so a model that could pass one
-     * could reach a file this conversation never carried.
+     * Minted when the file is seen in this credential session, and the only
+     * thing `channel_fetch_file` accepts. Raw provider file IDs are not accepted.
      */
     readonly id: FileRef;
     readonly name?: string;
     readonly mime_type?: string;
     readonly size?: number;
 }
-/** One message as the model sees it: opaque ref, resolved author, no provider ids. */
+/** A message handle, resolved author, and optional provider thread coordinates. */
 export interface ChannelMessage {
     readonly ref: MessageRef;
     readonly author: ChannelAuthor;
     readonly text: string;
+    /** Provider thread root/topic usable with the read command's thread_id. */
+    readonly thread_id?: string;
+    readonly reply_count?: number;
     readonly timestamp?: string;
     readonly permalink?: string;
     readonly attachments?: readonly ChannelAttachment[];
@@ -105,6 +93,7 @@ export interface ChannelMessage {
 export interface ChannelPostResult {
     readonly ref: MessageRef;
     readonly permalink?: string;
+    readonly target?: ChannelTarget;
     /**
      * Whether the platform recorded the posted thread for reply bridging. False
      * with a reason is not a failure of the post — the message is out.
@@ -115,6 +104,14 @@ export interface ChannelPostResult {
 export interface ChannelReadPage {
     readonly messages: readonly ChannelMessage[];
     readonly cursor?: ChannelCursor;
+    readonly target?: ChannelTarget;
+    /** Direction of subsequent pages; messages within a page are chronological. */
+    readonly next_direction?: "older" | "newer";
+}
+export interface ChannelListEntry {
+    readonly id: string;
+    readonly name: string;
+    readonly kind: "public_channel" | "private_channel";
 }
 export interface ChannelLocalFile {
     readonly id: string;
@@ -136,6 +133,8 @@ export interface ChannelMessageIdentity {
 export interface ChannelFileIdentity {
     readonly conversation: string;
     readonly id: string;
+    /** Read target where this file was observed; absent/null means the timeline. */
+    readonly thread?: string | null;
 }
 /**
  * Resolves opaque handles for one session.
@@ -163,7 +162,7 @@ export interface ChannelAdapterContext {
 /**
  * What a provider package implements.
  *
- * Every method takes the bound conversation from `ChannelAdapterContext`. An
+ * Every method takes its resolved conversation from `ChannelAdapterContext`. An
  * optional method must be present exactly when the matching capability is
  * true — `channelConnectorTools` asserts that, so a capability cannot claim
  * something the adapter cannot do.
@@ -176,6 +175,12 @@ export interface ChannelAdapter {
     reply(ctx: ChannelAdapterContext, input: {
         text: string;
     }): Promise<ChannelPostResult>;
+    /** Explicit send; does not imply cross-channel reply routing support. */
+    send?(ctx: ChannelAdapterContext, input: {
+        text: string;
+    }): Promise<ChannelPostResult>;
+    /** List conversations available to this credential session. */
+    list?(signal?: AbortSignal): Promise<readonly ChannelListEntry[]>;
     react?(ctx: ChannelAdapterContext, input: {
         ref: MessageRef;
         emoji: string;

package/dist/channels/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/channels/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/channels/types.ts"],"names":[],"mappings":"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"}

package/dist/channels/types.js

@@ -1,23 +1,10 @@
 /**
  * Provider-neutral channel primitives.
  *
- * A channel-origin task answers exactly one conversation. These types describe
- * what an agent may do *inside* that conversation, in vocabulary that is the
- * same for Slack, Teams, or anything else, so one prompt serves every channel.
- *
- * Two properties are structural rather than documented:
- *
- * - **The destination is bound.** An adapter method takes the conversation from
- *   the trusted `ChannelTarget` the host resolved; no tool schema built from
- *   these types carries a channel, thread, workspace, or user argument.
- * - **Unsupported is absent.** Tools are registered from `ChannelCapabilities`,
- *   so a channel that cannot read earlier messages simply has no read tool. A
- *   tool that always answers "unsupported" costs a model turn and teaches
- *   nothing.
- *
- * Operations outside this bound channel set, including workspace search,
- * directory lookups, and sends to another conversation, are unsupported. Their
- * contract and access model are deferred to a separate proposal.
+ * Reply defaults to the host-resolved origin. Adapters may opt into explicit
+ * read/send destinations within their existing credential session. This is a
+ * tool contract, not a sandbox-wide authorization boundary. Unsupported
+ * operations are absent. Search and directory lookup are not part of it.
  */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/channels/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/channels/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/channels/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/connector-tools.d.ts

@@ -21,6 +21,8 @@ export interface RecipeConnectorToolLoadout {
 }
 export interface RecipeConnectorModuleOptions {
     tools: readonly string[];
+    commands?: readonly string[];
+    requireReply?: boolean;
     env?: NodeJS.ProcessEnv;
     cwd?: string;
 }

package/dist/connector-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connector-tools.d.ts","sourceRoot":"","sources":["../src/connector-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAGxE,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,WAAW,+BAA+B;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,6BAA6B,EAAE,CAAC;IACzD,eAAe,CAAC,OAAO,EAAE,4BAA4B,GAAG,gBAAgB,CAAC;CAC1E;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,wBAAwB,EAAE,CAAC;IACvC,OAAO,EAAE,0BAA0B,CAAC;CACrC;AAkFD,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,qBAAqB,EAC/B,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,sBAAsB,CAAC,CAqCjC"}
+{"version":3,"file":"connector-tools.d.ts","sourceRoot":"","sources":["../src/connector-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAGxE,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,WAAW,+BAA+B;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,6BAA6B,EAAE,CAAC;IACzD,eAAe,CAAC,OAAO,EAAE,4BAA4B,GAAG,gBAAgB,CAAC;CAC1E;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,wBAAwB,EAAE,CAAC;IACvC,OAAO,EAAE,0BAA0B,CAAC;CACrC;AAkFD,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,qBAAqB,EAC/B,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,sBAAsB,CAAC,CAuCjC"}

package/dist/connector-tools.js

@@ -1,7 +1,7 @@
 import { loadRecipeModule } from "./recipe-extensions.js";
 import { recipeChannelPackageName, } from "./recipe-package.js";
-function connectorModuleError(connector, detail) {
-    return new Error(`Recipe channel package ${recipeChannelPackageName(connector.provider)} ${detail}`);
+function connectorModuleError(channel, detail) {
+    return new Error(`Recipe channel package ${recipeChannelPackageName(channel.provider)} ${detail}`);
 }
 function isConnectorToolDefinition(value) {
     if (!value || typeof value !== "object" || Array.isArray(value)) {
@@ -14,52 +14,54 @@ function isConnectorToolDefinition(value) {
         Boolean(tool.name.trim()) &&
         typeof tool.defaultActive === "boolean");
 }
-function parseRecipeConnectorModule(value, connector) {
+function parseRecipeConnectorModule(value, channel) {
     if (!value || typeof value !== "object") {
-        throw connectorModuleError(connector, "does not export a module");
+        throw connectorModuleError(channel, "does not export a module");
     }
     const module = value;
-    if (module.provider !== connector.provider ||
+    if (module.provider !== channel.provider ||
         !Array.isArray(module.tools) ||
         module.tools.length === 0 ||
         module.tools.some((tool) => !isConnectorToolDefinition(tool)) ||
         typeof module.createExtension !== "function") {
-        throw connectorModuleError(connector, "has an invalid module contract");
+        throw connectorModuleError(channel, "has an invalid module contract");
     }
     const tools = module.tools;
     const ids = tools.map((tool) => tool.id);
     const names = tools.map((tool) => tool.name);
     if (new Set(ids).size !== ids.length ||
         new Set(names).size !== names.length) {
-        throw connectorModuleError(connector, "has duplicate or conflicting tool names");
+        throw connectorModuleError(channel, "has duplicate or conflicting tool names");
     }
     return module;
 }
-async function loadRecipeConnectorModule(recipeDir, connector) {
-    const packageName = recipeChannelPackageName(connector.provider);
+async function loadRecipeConnectorModule(recipeDir, channel) {
+    const packageName = recipeChannelPackageName(channel.provider);
     let imported;
     try {
         imported = await loadRecipeModule(recipeDir, packageName);
     }
     catch (error) {
-        throw new Error(`Recipe connector '${connector.provider}' requires ${packageName} in the Recipe dependencies`, { cause: error });
+        throw new Error(`Recipe channel '${channel.provider}' requires ${packageName} in the Recipe dependencies`, { cause: error });
     }
     const connectorModule = imported &&
         typeof imported === "object" &&
         "default" in imported
         ? imported.default
         : imported;
-    return parseRecipeConnectorModule(connectorModule, connector);
+    return parseRecipeConnectorModule(connectorModule, channel);
 }
 export async function loadRecipeConnectors(manifest, agentTools, options) {
-    const loaded = await Promise.all((manifest.connectors ?? []).map(async (connector) => {
-        const module = await loadRecipeConnectorModule(options.recipeDir, connector);
-        const selected = module.tools.filter((tool) => agentTools.includes(tool.name));
+    const loaded = await Promise.all((manifest.channels ?? []).map(async (channel) => {
+        const module = await loadRecipeConnectorModule(options.recipeDir, channel);
+        const selected = module.tools.filter((tool) => agentTools.includes(tool.name) && channel.commands?.length !== 0);
         return {
             extension: {
-                owner: `<connector:${connector.provider}>`,
+                owner: `<channel:${channel.provider}>`,
                 factory: module.createExtension({
                     tools: selected.map((tool) => tool.id),
+                    ...(channel.commands !== undefined ? { commands: channel.commands } : {}),
+                    ...(channel.requireReply !== undefined ? { requireReply: channel.requireReply } : {}),
                     env: options.env,
                     cwd: options.cwd,
                 }),

package/dist/connector-tools.js.map

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

package/dist/mcp-chunks/{chunk-JZDXKYQM.js → chunk-PLSS6TQZ.js}

@@ -1222,7 +1222,12 @@ var RESOURCE_KEYS = [
   "skills",
   "prompts"
 ];
-var PI_KEYS = /* @__PURE__ */ new Set([...RESOURCE_KEYS, "connectors", "mcp", "runtime"]);
+var PI_KEYS = /* @__PURE__ */ new Set([
+  ...RESOURCE_KEYS,
+  "channels",
+  "mcp",
+  "runtime"
+]);
 
 // src/mcp-policy.ts
 function mcpSelectionAllowsTool(selection, toolName) {

package/dist/mcp-daemon.js

@@ -12,7 +12,7 @@ import {
   installMcpCommandIoRouting,
   mcpDaemonRequestContext,
   serializeMcpDaemonEnvelope
-} from "./mcp-chunks/chunk-JZDXKYQM.js";
+} from "./mcp-chunks/chunk-PLSS6TQZ.js";
 import "./mcp-chunks/chunk-AF74TOWM.js";
 import "./mcp-chunks/chunk-NMFI6AUD.js";
 import "./mcp-chunks/chunk-MOML5C2E.js";

package/dist/mcp-run-worker.js

@@ -2,7 +2,7 @@ import { createRequire as __createRequire } from "node:module"; const require =
 import {
   executeMcpCommand,
   installMcpCommandIoRouting
-} from "./mcp-chunks/chunk-JZDXKYQM.js";
+} from "./mcp-chunks/chunk-PLSS6TQZ.js";
 import "./mcp-chunks/chunk-AF74TOWM.js";
 import "./mcp-chunks/chunk-NMFI6AUD.js";
 import "./mcp-chunks/chunk-MOML5C2E.js";

package/dist/recipe-package.d.ts

@@ -23,8 +23,10 @@ export interface RecipePackageMcpConfig {
     manifests: string[];
     servers: RecipePackageMcpServer[];
 }
-export interface RecipePackageConnector {
+export interface RecipePackageChannel {
     provider: string;
+    commands?: string[];
+    requireReply?: boolean;
 }
 export declare function recipeChannelPackageName(provider: string): string;
 export interface RecipePythonRuntimeRequirement {
@@ -51,7 +53,7 @@ export interface RecipePackageManifest {
     resources: RecipePackageResources;
     /** Whether each resource key was explicitly authored in package.json#pi. */
     resourceDeclarations?: Record<keyof RecipePackageResources, boolean>;
-    connectors?: RecipePackageConnector[];
+    channels?: RecipePackageChannel[];
     mcp: RecipePackageMcpConfig;
     runtime?: RecipeRuntimeRequirements;
 }

package/dist/recipe-package.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recipe-package.d.ts","sourceRoot":"","sources":["../src/recipe-package.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,sBAAsB,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAQD,iFAAiF;AACjF,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAmBlF;AAED,4EAA4E;AAC5E,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,sBAAsB,GAAG,OAAO,CAcxF;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,sBAAsB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,8BAA8B;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,8BAA8B,CAAC;IACxC,MAAM,EAAE;QACN,QAAQ,EAAE,8BAA8B,EAAE,CAAC;KAC5C,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,sBAAsB,CAAC;IAClC,4EAA4E;IAC5E,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,sBAAsB,EAAE,OAAO,CAAC,CAAC;IACrE,UAAU,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACtC,GAAG,EAAE,sBAAsB,CAAC;IAC5B,OAAO,CAAC,EAAE,yBAAyB,CAAC;CACrC;AAED,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AACxD,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AAEtD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,uBAAuB,EAAE,CAAC;CACrC;AAwYD,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAO/F;AA0HD,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AA8GD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,CAqC/E;AAED,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,EAAE,CAuDrF;AAED,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,qBAAqB,EAC1B,GAAG,EAAE,MAAM,sBAAsB,GAChC,MAAM,EAAE,CA0CV;AAED,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,qBAAqB,EAC1B,GAAG,EAAE,MAAM,sBAAsB,GAChC,MAAM,EAAE,CAOV;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,qBAAqB,EAC1B,GAAG,EAAE,MAAM,sBAAsB,GAChC,MAAM,EAAE,CAKV;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,qBAAqB,GAAG,sBAAsB,CAwE5F"}
+{"version":3,"file":"recipe-package.d.ts","sourceRoot":"","sources":["../src/recipe-package.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,sBAAsB,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAQD,iFAAiF;AACjF,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAmBlF;AAED,4EAA4E;AAC5E,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,sBAAsB,GAAG,OAAO,CAcxF;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,sBAAsB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,8BAA8B;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,8BAA8B,CAAC;IACxC,MAAM,EAAE;QACN,QAAQ,EAAE,8BAA8B,EAAE,CAAC;KAC5C,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,sBAAsB,CAAC;IAClC,4EAA4E;IAC5E,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,sBAAsB,EAAE,OAAO,CAAC,CAAC;IACrE,QAAQ,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAClC,GAAG,EAAE,sBAAsB,CAAC;IAC5B,OAAO,CAAC,EAAE,yBAAyB,CAAC;CACrC;AAED,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AACxD,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AAEtD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,uBAAuB,EAAE,CAAC;CACrC;AAqZD,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAO/F;AA0HD,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AA8GD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,CAqC/E;AAED,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,EAAE,CAuDrF;AAED,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,qBAAqB,EAC1B,GAAG,EAAE,MAAM,sBAAsB,GAChC,MAAM,EAAE,CA0CV;AAED,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,qBAAqB,EAC1B,GAAG,EAAE,MAAM,sBAAsB,GAChC,MAAM,EAAE,CAOV;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,qBAAqB,EAC1B,GAAG,EAAE,MAAM,sBAAsB,GAChC,MAAM,EAAE,CAKV;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,qBAAqB,GAAG,sBAAsB,CAwE5F"}

package/dist/recipe-package.js

@@ -42,7 +42,12 @@ const RESOURCE_KEYS = [
     "skills",
     "prompts",
 ];
-const PI_KEYS = new Set([...RESOURCE_KEYS, "connectors", "mcp", "runtime"]);
+const PI_KEYS = new Set([
+    ...RESOURCE_KEYS,
+    "channels",
+    "mcp",
+    "runtime",
+]);
 const SOURCE_FINDINGS = Symbol("recipeSourceFindings");
 function stringArray(value) {
     return Array.isArray(value)
@@ -79,38 +84,46 @@ function sourceShapeFindings(pi, packageName, dependencies) {
             findings.push(finding(`pi.${key}_duplicate`, `package.json#pi.${key} must not contain duplicate entries`, packageName));
         }
     }
-    findings.push(...connectorSourceShapeFindings(pi.connectors, packageName, dependencies));
+    findings.push(...channelSourceShapeFindings(pi.channels, packageName, dependencies));
     findings.push(...mcpSourceShapeFindings(pi.mcp, packageName));
     findings.push(...runtimeSourceShapeFindings(pi.runtime, packageName));
     return findings;
 }
-function connectorSourceShapeFindings(value, packageName, dependencies) {
+function channelSourceShapeFindings(value, packageName, dependencies) {
     if (value === undefined)
         return [];
-    const invalid = (message) => finding("pi.connectors_invalid", message, packageName);
+    const invalid = (message) => finding("pi.channels_invalid", message, packageName);
     if (!Array.isArray(value)) {
-        return [invalid("package.json#pi.connectors must be an array")];
+        return [invalid("package.json#pi.channels must be an array")];
     }
     const findings = [];
     const providers = new Set();
     for (const [index, raw] of value.entries()) {
         if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
-            findings.push(invalid(`package.json#pi.connectors[${index}] must be an object`));
+            findings.push(invalid(`package.json#pi.channels[${index}] must be an object`));
             continue;
         }
         const connector = raw;
-        const unknown = Object.keys(connector).filter((key) => key !== "provider");
+        const unknown = Object.keys(connector).filter((key) => !["provider", "commands", "requireReply"].includes(key));
+        if (connector.requireReply !== undefined && typeof connector.requireReply !== "boolean") {
+            findings.push(invalid(`package.json#pi.channels[${index}].requireReply must be a boolean`));
+        }
+        if (connector.commands !== undefined && (!Array.isArray(connector.commands) ||
+            connector.commands.some((command) => typeof command !== "string" || !command.trim()) ||
+            new Set(connector.commands).size !== connector.commands.length)) {
+            findings.push(invalid(`package.json#pi.channels[${index}].commands must be an array of unique non-empty strings`));
+        }
         if (unknown.length > 0) {
-            findings.push(invalid(`package.json#pi.connectors[${index}] contains unknown field(s): ${unknown.join(", ")}`));
+            findings.push(invalid(`package.json#pi.channels[${index}] contains unknown field(s): ${unknown.join(", ")}`));
         }
         const provider = typeof connector.provider === "string" && connector.provider.trim()
             ? connector.provider.trim()
             : undefined;
         if (!provider) {
-            findings.push(invalid(`package.json#pi.connectors[${index}].provider must be non-empty`));
+            findings.push(invalid(`package.json#pi.channels[${index}].provider must be non-empty`));
         }
         else if (providers.has(provider)) {
-            findings.push(invalid(`package.json#pi.connectors contains duplicate provider '${provider}'`));
+            findings.push(invalid(`package.json#pi.channels contains duplicate provider '${provider}'`));
         }
         else {
             providers.add(provider);
@@ -125,7 +138,7 @@ function connectorSourceShapeFindings(value, packageName, dependencies) {
             const dependencyVersion = declaredDependencies[channelPackage];
             if (typeof dependencyVersion !== "string" ||
                 !dependencyVersion.trim()) {
-                findings.push(invalid(`package.json#pi.connectors provider '${provider ?? "unknown"}' requires dependency '${channelPackage}'`));
+                findings.push(invalid(`package.json#pi.channels provider '${provider ?? "unknown"}' requires dependency '${channelPackage}'`));
             }
         }
     }
@@ -480,18 +493,18 @@ function parseMcpConfig(value) {
     }
     return { manifests, servers };
 }
-function parseConnectors(value) {
+function parseChannels(value) {
     const seen = new Set();
-    const connectors = [];
+    const channels = [];
     for (const raw of Array.isArray(value) ? value : []) {
-        const connector = asRecord(raw);
-        const provider = stringValue(connector.provider);
+        const channel = asRecord(raw);
+        const provider = stringValue(channel.provider);
         if (!provider || seen.has(provider))
             continue;
         seen.add(provider);
-        connectors.push({ provider });
+        channels.push({ provider, ...(Array.isArray(channel.commands) ? { commands: channel.commands } : {}), ...(typeof channel.requireReply === "boolean" ? { requireReply: channel.requireReply } : {}) });
     }
-    return connectors;
+    return channels;
 }
 function parseRuntimeRequirements(value) {
     const runtime = asRecord(value);
@@ -556,7 +569,7 @@ export function readPiPackageManifest(packageDir) {
         path: packageDir,
         resources,
         resourceDeclarations: resourceDeclarations(pi),
-        connectors: parseConnectors(pi.connectors),
+        channels: parseChannels(pi.channels),
         mcp: parseMcpConfig(pi.mcp),
         runtime: parseRuntimeRequirements(pi.runtime),
     };