@introspection-ai/recipes 0.22.1 → 0.24.0

package/README.md

@@ -133,7 +133,7 @@ tests.
   contract: capability descriptors, opaque message references, and the
   registration that binds every tool to the task's own conversation
 - `@introspection-ai/recipe-channel-slack` is the optional Slack adapter. A
-  Recipe adds it as a dependency when it declares Slack in `pi.connectors`.
+  Recipe adds it as a dependency when it declares Slack in `pi.channels`.
 - `@introspection-ai/recipes/agents` — portable agent-run controller and tool
   contract
 - `@introspection-ai/recipes/interactions` — portable user-input and approval contract

package/dist/api/memory.d.ts

@@ -0,0 +1,3 @@
+export { DEFAULT_MEMORY_INDEX_MAX_BYTES, DEFAULT_MEMORY_INDEX_MAX_LINES, MemoryContextConfigError, formatMemoryForPrompt, loadMemoryIndex, } from "../memory.js";
+export type { LoadMemoryIndexOptions, LoadMemoryIndexResult, MemoryContextOverride, MemoryContextSource, MemoryDiagnostic, MemoryIndex, } from "../memory.js";
+//# sourceMappingURL=memory.d.ts.map

package/dist/api/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/api/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,8BAA8B,EAC9B,wBAAwB,EACxB,qBAAqB,EACrB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,GACZ,MAAM,cAAc,CAAC"}

package/dist/api/memory.js

@@ -0,0 +1,2 @@
+export { DEFAULT_MEMORY_INDEX_MAX_BYTES, DEFAULT_MEMORY_INDEX_MAX_LINES, MemoryContextConfigError, formatMemoryForPrompt, loadMemoryIndex, } from "../memory.js";
+//# sourceMappingURL=memory.js.map

package/dist/api/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/api/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,8BAA8B,EAC9B,wBAAwB,EACxB,qBAAqB,EACrB,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/api/session.d.ts

@@ -1,3 +1,4 @@
 export { createAgentSession, RecipeCredentialError, RecipeMcpEnvironmentInUseError, RecipeModelError, RecipeModelTransportError, } from "../session.js";
 export type { CreateAgentSessionOptions, RecipeSessionHandle, RecipeSessionOtelOptions, } from "../session.js";
+export type { MemoryContextOverride, MemoryContextSource, } from "../memory.js";
 //# sourceMappingURL=session.d.ts.map

package/dist/api/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/api/session.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,8BAA8B,EAC9B,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/api/session.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,8BAA8B,EAC9B,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,cAAc,CAAC"}

package/dist/channels/config.d.ts

@@ -0,0 +1,10 @@
+export type ChannelEnvironment = Record<string, string | undefined>;
+/** Provider-neutral destination supplied by the Recipe host. */
+export interface ChannelConfig {
+    provider: string;
+    channel_ref: string;
+    thread_ref: string | null;
+}
+/** Read the channel destination shared by every provider package. */
+export declare function resolveChannelConfig(env?: ChannelEnvironment): ChannelConfig | null;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/channels/config.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEpE,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,qEAAqE;AACrE,wBAAgB,oBAAoB,CAClC,GAAG,GAAE,kBAAgC,GACpC,aAAa,GAAG,IAAI,CAUtB"}

package/dist/channels/config.js

@@ -0,0 +1,13 @@
+/** Read the channel destination shared by every provider package. */
+export function resolveChannelConfig(env = process.env) {
+    const provider = env.INTROSPECTION_TASK_CHANNEL_PROVIDER?.trim();
+    const channelRef = env.INTROSPECTION_TASK_CHANNEL_ID?.trim();
+    if (!provider || !channelRef)
+        return null;
+    return {
+        provider,
+        channel_ref: channelRef,
+        thread_ref: env.INTROSPECTION_TASK_THREAD_ID?.trim() || null,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/channels/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/channels/config.ts"],"names":[],"mappings":"AASA,qEAAqE;AACrE,MAAM,UAAU,oBAAoB,CAClC,GAAG,GAAuB,OAAO,CAAC,GAAG;IAErC,MAAM,QAAQ,GAAG,GAAG,CAAC,mCAAmC,EAAE,IAAI,EAAE,CAAC;IACjE,MAAM,UAAU,GAAG,GAAG,CAAC,6BAA6B,EAAE,IAAI,EAAE,CAAC;IAC7D,IAAI,CAAC,QAAQ,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAE1C,OAAO;QACL,QAAQ;QACR,WAAW,EAAE,UAAU;QACvB,UAAU,EAAE,GAAG,CAAC,4BAA4B,EAAE,IAAI,EAAE,IAAI,IAAI;KAC7D,CAAC;AACJ,CAAC"}

package/dist/channels/index.d.ts

@@ -1,7 +1,9 @@
 export { ChannelRefStore } from "./refs.js";
-export { CHANNEL_TOOL_IDS, channelConnectorTools, channelToolIdsFor, channelToolName, registerChannelTools, } from "./tools.js";
+export { resolveChannelConfig } from "./config.js";
+export type { ChannelConfig, ChannelEnvironment } from "./config.js";
+export { CHANNEL_TOOL_IDS, channelConnectorTools, channelToolIdsFor, registerChannelTools, } from "./tools.js";
 export type { ChannelToolHost, ChannelToolId, RegisterChannelToolsOptions, } from "./tools.js";
 export { createChannelConnectorModule } from "./module.js";
 export type { ChannelConnectorModuleOptions, ChannelConnectorSession, } from "./module.js";
-export type { ChannelAdapter, ChannelAdapterContext, ChannelAttachment, ChannelAuthor, ChannelCapabilities, ChannelCursor, ChannelFileIdentity, ChannelReadPage, ChannelLocalFile, ChannelMessage, ChannelMessageIdentity, ChannelPostResult, ChannelReactionAction, ChannelRefResolver, ChannelTarget, FileRef, MessageRef, } from "./types.js";
+export type { ChannelAdapter, ChannelAdapterContext, ChannelAttachment, ChannelAuthor, ChannelCapabilities, ChannelCursor, ChannelFileIdentity, ChannelListEntry, ChannelReadPage, ChannelLocalFile, ChannelMessage, ChannelMessageIdentity, ChannelPostResult, ChannelReactionAction, ChannelRefResolver, ChannelTarget, FileRef, MessageRef, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,eAAe,EACf,aAAa,EACb,2BAA2B,GAC5B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAC3D,YAAY,EACV,6BAA6B,EAC7B,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,OAAO,EACP,UAAU,GACX,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,eAAe,EACf,aAAa,EACb,2BAA2B,GAC5B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAC3D,YAAY,EACV,6BAA6B,EAC7B,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,OAAO,EACP,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/channels/index.js

@@ -1,4 +1,5 @@
 export { ChannelRefStore } from "./refs.js";
-export { CHANNEL_TOOL_IDS, channelConnectorTools, channelToolIdsFor, channelToolName, registerChannelTools, } from "./tools.js";
+export { resolveChannelConfig } from "./config.js";
+export { CHANNEL_TOOL_IDS, channelConnectorTools, channelToolIdsFor, registerChannelTools, } from "./tools.js";
 export { createChannelConnectorModule } from "./module.js";
 //# sourceMappingURL=index.js.map

package/dist/channels/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAMpB,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAMpB,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC"}

package/dist/channels/module.d.ts

@@ -1,9 +1,13 @@
 import type { RecipeConnectorModule } from "../connector-tools.js";
+import type { ChannelConfig } from "./config.js";
+import { type ChannelToolId } from "./tools.js";
 import type { ChannelAdapter, ChannelCapabilities, ChannelTarget } from "./types.js";
 export interface ChannelConnectorSession {
     readonly adapter: ChannelAdapter;
     /** Resolved lazily so a task with no channel origin still starts. */
     readonly target: ChannelTarget | (() => ChannelTarget);
+    /** Optional tool-layer target policy, not a sandbox egress boundary. */
+    readonly validateTarget?: (target: ChannelTarget, operation: ChannelToolId) => void | Promise<void>;
 }
 export interface ChannelConnectorModuleOptions {
     provider: string;
@@ -16,12 +20,13 @@ export interface ChannelConnectorModuleOptions {
      */
     capabilities: ChannelCapabilities;
     /**
-     * Resolve the bound conversation and a client for it.
+     * Resolve the default conversation and a client for one credential session.
      *
-     * Called once per session. Throwing is the right failure for a task with no
-     * channel origin: the tools would have nowhere to act.
+     * Called once per session. Return a lazy target for originless tasks so
+     * explicit read/send calls can still use the credential session.
      */
     createSession(options: {
+        config: ChannelConfig | null;
         env: NodeJS.ProcessEnv;
         cwd: string;
     }): ChannelConnectorSession;
@@ -32,12 +37,12 @@ export interface ChannelConnectorModuleOptions {
  * A provider package supplies transport plus a capability descriptor; the
  * neutral tool schemas, the opaque handles, and the capability filtering live
  * here. Two providers therefore cannot drift into differently-shaped versions
- * of the same operation, and neither can quietly grow an addressing argument,
- * because neither writes a tool schema at all.
+ * of the same operation. Targeting uses the common capability and schema,
+ * not provider-defined arguments.
  *
  * The result satisfies the existing connector contract. The manifest selects
  * the provider package, the agent list selects tools from its catalog, and
- * `tool_search` exposes selected tools that are not active by default.
+ * `channels` is active immediately; the connector can restrict its commands.
  */
 export declare function createChannelConnectorModule(options: ChannelConnectorModuleOptions): RecipeConnectorModule;
 //# sourceMappingURL=module.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../src/channels/module.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAQnE,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,CAAC,MAAM,aAAa,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,YAAY,EAAE,mBAAmB,CAAC;IAClC;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE;QACrB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;QACvB,GAAG,EAAE,MAAM,CAAC;KACb,GAAG,uBAAuB,CAAC;CAC7B;AAgBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,6BAA6B,GACrC,qBAAqB,CA+CvB"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../src/channels/module.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,CAAC,MAAM,aAAa,CAAC,CAAC;IACvD,wEAAwE;IACxE,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrG;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,YAAY,EAAE,mBAAmB,CAAC;IAClC;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE;QACrB,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;QAC7B,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;QACvB,GAAG,EAAE,MAAM,CAAC;KACb,GAAG,uBAAuB,CAAC;CAC7B;AAkBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,6BAA6B,GACrC,qBAAqB,CAqDvB"}

package/dist/channels/module.js

@@ -1,8 +1,11 @@
+import { resolveChannelConfig } from "./config.js";
 import { ChannelRefStore } from "./refs.js";
 import { CHANNEL_TOOL_IDS, channelConnectorTools, registerChannelTools, } from "./tools.js";
 const channelToolIds = new Set(CHANNEL_TOOL_IDS);
 /** Whether two capability descriptors say the same thing. */
 function sameCapabilities(left, right) {
+    left = { ...left, targeting: left.targeting ?? false, list: left.list ?? false };
+    right = { ...right, targeting: right.targeting ?? false, list: right.list ?? false };
     const keys = Object.keys(right);
     return (Object.keys(left).length === keys.length &&
         keys.every((key) => left[key] === right[key]));
@@ -13,29 +16,37 @@ function sameCapabilities(left, right) {
  * A provider package supplies transport plus a capability descriptor; the
  * neutral tool schemas, the opaque handles, and the capability filtering live
  * here. Two providers therefore cannot drift into differently-shaped versions
- * of the same operation, and neither can quietly grow an addressing argument,
- * because neither writes a tool schema at all.
+ * of the same operation. Targeting uses the common capability and schema,
+ * not provider-defined arguments.
  *
  * The result satisfies the existing connector contract. The manifest selects
  * the provider package, the agent list selects tools from its catalog, and
- * `tool_search` exposes selected tools that are not active by default.
+ * `channels` is active immediately; the connector can restrict its commands.
  */
 export function createChannelConnectorModule(options) {
     const connectorTools = channelConnectorTools(options.capabilities);
-    const deferredToolIds = new Set(connectorTools
-        .filter((tool) => !tool.defaultActive)
-        .map((tool) => tool.id));
     return {
         provider: options.provider,
         tools: connectorTools,
         createExtension(moduleOptions) {
-            const unknown = moduleOptions.tools.filter((tool) => !channelToolIds.has(tool));
+            const unknown = moduleOptions.tools.filter((tool) => tool !== "channels");
             if (unknown.length > 0) {
                 throw new Error(`Unknown ${options.provider} channel tool(s): ${unknown.join(", ")}`);
             }
-            const tools = moduleOptions.tools;
+            const commands = moduleOptions.commands;
+            const requireReply = moduleOptions.requireReply ?? (moduleOptions.tools.includes("channels") && commands?.length !== 0);
+            if (requireReply && (!moduleOptions.tools.includes("channels") ||
+                (commands !== undefined && !commands.includes("reply")))) {
+                throw new Error("requireReply needs the channels tool with the reply command enabled");
+            }
+            if (commands?.some((command) => !channelToolIds.has(command))) {
+                throw new Error("Unknown channels command in connector allowlist");
+            }
             return (pi) => {
+                if (!moduleOptions.tools.includes("channels"))
+                    return;
                 const session = options.createSession({
+                    config: resolveChannelConfig(moduleOptions.env ?? process.env),
                     env: moduleOptions.env ?? process.env,
                     cwd: moduleOptions.cwd ?? process.cwd(),
                 });
@@ -50,9 +61,10 @@ export function createChannelConnectorModule(options) {
                 }
                 registerChannelTools(pi, session.adapter, {
                     target: session.target,
-                    tools,
-                    deferredTools: tools.filter((tool) => deferredToolIds.has(tool)),
+                    commands: commands,
+                    requireReply,
                     refs: new ChannelRefStore(),
+                    validateTarget: session.validateTarget,
                 });
             };
         },

package/dist/channels/module.js.map

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

package/dist/channels/refs.d.ts

@@ -3,7 +3,7 @@ import type { ChannelCursor, ChannelFileIdentity, ChannelMessageIdentity, Channe
  * Session-scoped opaque handles for messages and pagination cursors.
  *
  * The model only ever sees a handle this store minted, so it cannot name a
- * message it was never shown, and provider id formats stay out of tool schemas.
+ * message it was never shown to edit, retract, or react to.
  * The store is also where authorship lives. `resolveAuthored` is the single
  * check behind `channel_edit` and `channel_retract`, which keeps those tools
  * scoped to the agent's own messages rather than everything the provider
@@ -20,8 +20,8 @@ export declare class ChannelRefStore implements ChannelRefResolver {
     message(identity: ChannelMessageIdentity): MessageRef;
     resolveMessage(ref: MessageRef): ChannelMessageIdentity;
     resolveAuthored(ref: MessageRef): ChannelMessageIdentity;
-    cursor(providerCursor: string): ChannelCursor;
-    resolveCursor(cursor: ChannelCursor): string;
+    cursor(providerCursor: string, scope?: string): ChannelCursor;
+    resolveCursor(cursor: ChannelCursor, scope?: string): string;
     file(identity: ChannelFileIdentity): FileRef;
     resolveFile(ref: FileRef): ChannelFileIdentity;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/channels/refs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,OAAO,EACP,UAAU,EACX,MAAM,YAAY,CAAC;AAUpB;;;;;;;;;;;GAWG;AACH,qBAAa,eAAgB,YAAW,kBAAkB;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiD;IAC1E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiC;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2C;IACjE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA8B;IAE7D,OAAO,CAAC,QAAQ,EAAE,sBAAsB,GAAG,UAAU,CAiBpD;IAED,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,sBAAsB,CAQtD;IAED,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,sBAAsB,CAQvD;IAED,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,aAAa,CAI5C;IAED,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAQ3C;IAED,IAAI,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAQ3C;IAED,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,mBAAmB,CAW7C;CACF"}
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/channels/refs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,OAAO,EACP,UAAU,EACX,MAAM,YAAY,CAAC;AAUpB;;;;;;;;;;;GAWG;AACH,qBAAa,eAAgB,YAAW,kBAAkB;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiD;IAC1E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiC;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+D;IACvF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2C;IACjE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA8B;IAE7D,OAAO,CAAC,QAAQ,EAAE,sBAAsB,GAAG,UAAU,CAiBpD;IAED,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,sBAAsB,CAQtD;IAED,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,sBAAsB,CAQvD;IAED,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,CAI5D;IAED,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAW3D;IAED,IAAI,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAQ3C;IAED,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,mBAAmB,CAW7C;CACF"}

package/dist/channels/refs.js

@@ -9,7 +9,7 @@ function handle(prefix) {
  * Session-scoped opaque handles for messages and pagination cursors.
  *
  * The model only ever sees a handle this store minted, so it cannot name a
- * message it was never shown, and provider id formats stay out of tool schemas.
+ * message it was never shown to edit, retract, or react to.
  * The store is also where authorship lives. `resolveAuthored` is the single
  * check behind `channel_edit` and `channel_retract`, which keeps those tools
  * scoped to the agent's own messages rather than everything the provider
@@ -24,7 +24,7 @@ export class ChannelRefStore {
     files = new Map();
     byFileIdentity = new Map();
     message(identity) {
-        const key = `${identity.conversation} ${identity.id}`;
+        const key = JSON.stringify([identity.conversation, identity.thread ?? null, identity.id]);
         const existing = this.byIdentity.get(key);
         if (existing) {
             const previous = this.messages.get(existing);
@@ -55,20 +55,23 @@ export class ChannelRefStore {
         }
         return identity;
     }
-    cursor(providerCursor) {
+    cursor(providerCursor, scope) {
         const cursor = handle(CURSOR_PREFIX);
-        this.cursors.set(cursor, providerCursor);
+        this.cursors.set(cursor, { value: providerCursor, scope });
         return cursor;
     }
-    resolveCursor(cursor) {
+    resolveCursor(cursor, scope) {
         const providerCursor = this.cursors.get(cursor);
         if (!providerCursor) {
-            throw new Error(`Unknown cursor '${cursor}'. Use a cursor returned by a previous channel_read call.`);
+            throw new Error(`Unknown cursor '${cursor}'. Use a cursor returned by a previous channels read call.`);
         }
-        return providerCursor;
+        if (providerCursor.scope !== scope) {
+            throw new Error("Cursor belongs to another channel or thread. Repeat the original read target.");
+        }
+        return providerCursor.value;
     }
     file(identity) {
-        const key = `${identity.conversation} ${identity.id}`;
+        const key = JSON.stringify([identity.conversation, identity.thread ?? null, identity.id]);
         const existing = this.byFileIdentity.get(key);
         if (existing)
             return existing;

package/dist/channels/refs.js.map

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

package/dist/channels/tools.d.ts

@@ -4,16 +4,14 @@ import type { ChannelAdapter, ChannelCapabilities, ChannelTarget } from "./types
 /**
  * The neutral operation vocabulary.
  *
- * These ids are private to the channel implementation. An agent writes the
- * complete `channel_<id>` name in its YAML tool list.
+ * Commands of the registered `channels` tool.
  */
-export declare const CHANNEL_TOOL_IDS: readonly ["reply", "read", "react", "edit", "retract", "attach", "fetch_file", "post_document"];
+export declare const CHANNEL_TOOL_IDS: readonly ["reply", "send", "list", "read", "react", "edit", "retract", "attach", "fetch_file", "post_document"];
 export type ChannelToolId = (typeof CHANNEL_TOOL_IDS)[number];
-export declare function channelToolName(id: ChannelToolId): string;
 /** Which operations an adapter's capabilities actually support. */
 export declare function channelToolIdsFor(capabilities: ChannelCapabilities): ChannelToolId[];
-export declare function channelConnectorTools(capabilities: ChannelCapabilities): {
-    id: "attach" | "edit" | "fetch_file" | "post_document" | "react" | "read" | "reply" | "retract";
+export declare function channelConnectorTools(_capabilities: ChannelCapabilities): {
+    id: string;
     name: string;
     defaultActive: boolean;
 }[];
@@ -27,30 +25,25 @@ export interface RegisterChannelToolsOptions {
      * run from a non-channel trigger such as an automation.
      */
     target: ChannelTarget | (() => ChannelTarget);
-    /** Restrict registration to these ids; defaults to everything supported. */
-    tools?: readonly ChannelToolId[];
-    /** Selected tools that require `tool_search` before the model may call them. */
-    deferredTools?: readonly ChannelToolId[];
+    /** Restrict commands; defaults to everything supported. An empty list exposes no tool. */
+    commands?: readonly ChannelToolId[];
+    /** Require a successful final reply on inbound turns. Defaults to true for enabled tools. */
+    requireReply?: boolean;
     refs?: ChannelRefStore;
+    /** Optional host tool-layer policy. This does not constrain shell/API egress. */
+    validateTarget?: (target: ChannelTarget, operation: ChannelToolId) => void | Promise<void>;
 }
 /** Host surface used here. Opaque so Pi's TypeBox copy stays behind this seam. */
 export interface ChannelToolHost {
     registerTool(...args: never[]): unknown;
     on: ExtensionAPI["on"];
+    sendMessage?: ExtensionAPI["sendMessage"];
 }
 /**
- * Register the bound channel tools an adapter supports.
- *
- * Two invariants are enforced by construction rather than by review:
- *
- * 1. **No schema below carries a conversation, thread, workspace, or user
- *    argument.** The conversation comes from `options.target`, closed over
- *    here. A model that cannot name a destination cannot reach one, so an
- *    agent bound to a thread stays bound to that thread even if the underlying
- *    credential could reach the whole workspace.
- * 2. **Unsupported operations are absent**, not stubs that answer "this
- *    channel cannot do that" — such a stub costs a turn every time and teaches
- *    the model nothing durable.
+ * Register tools for ONE provider credential session. Never share the adapter
+ * or reference store between installations. Explicit targeting is opt-in;
+ * reply/attach/documents retain their origin default. References identify
+ * previously observed resources; they are not durable authorization grants.
  */
 export declare function registerChannelTools(pi: ChannelToolHost, adapter: ChannelAdapter, options: RegisterChannelToolsOptions): void;
 //# sourceMappingURL=tools.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/channels/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAGpE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EACV,cAAc,EAEd,mBAAmB,EAEnB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,YAC3B,OAAO,EACP,MAAM,EACN,OAAO,EACP,MAAM,EACN,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,eAAe,CACP,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAS9D,wBAAgB,eAAe,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,CAEzD;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,mBAAmB,GAChC,aAAa,EAAE,CAUjB;AAED,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,mBAAmB;;;;IAOtE;AAkCD,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;OAOG;IACH,MAAM,EAAE,aAAa,GAAG,CAAC,MAAM,aAAa,CAAC,CAAC;IAC9C,4EAA4E;IAC5E,KAAK,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACjC,gFAAgF;IAChF,aAAa,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB;AAED,kFAAkF;AAClF,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IACxC,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;CACxB;AAgDD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,eAAe,EACnB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,2BAA2B,GACnC,IAAI,CAsRN"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/channels/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAIpE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EACV,cAAc,EAEd,mBAAmB,EAEnB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,YAC3B,OAAO,EACP,MAAM,EACN,MAAM,EACN,MAAM,EACN,OAAO,EACP,MAAM,EACN,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,eAAe,CACP,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,mEAAmE;AACnE,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,mBAAmB,GAChC,aAAa,EAAE,CAYjB;AAED,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,mBAAmB;;;;IAEvE;AAsCD,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;OAOG;IACH,MAAM,EAAE,aAAa,GAAG,CAAC,MAAM,aAAa,CAAC,CAAC;IAC9C,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACpC,6FAA6F;IAC7F,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,iFAAiF;IACjF,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5F;AAED,kFAAkF;AAClF,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IACxC,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;IACvB,WAAW,CAAC,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC;CAC3C;AAsCD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,eAAe,EACnB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,2BAA2B,GACnC,IAAI,CA0cN"}