@agentick/connector 0.5.0

package/README.md

@@ -0,0 +1,272 @@
+# @agentick/connector
+
+Bridge external platforms to Agentick sessions. Handles content filtering,
+delivery timing, rate limiting, and tool confirmations so platform adapters
+only need to handle I/O.
+
+## Install
+
+```sh
+pnpm add @agentick/connector
+```
+
+## Quick Start
+
+```typescript
+import { createConnector } from "@agentick/connector";
+import { TelegramPlatform } from "@agentick/connector-telegram";
+
+const connector = createConnector(
+  client,
+  new TelegramPlatform({
+    token: process.env.TELEGRAM_BOT_TOKEN!,
+  }),
+  {
+    sessionId: "main",
+    contentPolicy: "summarized",
+    deliveryStrategy: "on-idle",
+  },
+);
+
+await connector.start();
+```
+
+## How It Works
+
+```
+External Platform
+    |
+    v
+ConnectorPlatform.start(bridge)
+    |
+    |-- inbound: bridge.send("user message")
+    |       |
+    |       v
+    |   RateLimiter --> ConnectorSession.send() --> AgentickClient
+    |
+    +-- outbound: bridge.onDeliver(handler)
+            ^
+            |
+    DeliveryBuffer (timing) --> ContentPipeline (filter) --> MessageLog
+```
+
+`createConnector` wires a `ConnectorPlatform` to a `ConnectorSession`. The
+session composes `MessageLog` and `ToolConfirmations` from `@agentick/client`
+with `subscribe: false`, adding content filtering and delivery timing on top.
+
+## Content Policy
+
+Controls what content reaches the platform.
+
+```typescript
+type ContentPolicy = "full" | "text-only" | "summarized" | ContentPolicyFn;
+```
+
+- **`"text-only"`** (default) — Strip tool_use and tool_result blocks, keep
+  text and images.
+- **`"summarized"`** — Collapse tool calls into brief summaries
+  (`[Read config.ts]`, `[Ran: npm test]`), keep text.
+- **`"full"`** — Pass through unchanged.
+- **Function** — Full control. Receives a `ChatMessage`, returns it
+  transformed or `null` to drop.
+
+### Custom Tool Summaries
+
+Override the built-in summaries for the `"summarized"` policy:
+
+```typescript
+import { createToolSummarizer } from "@agentick/connector";
+
+const summarizer = createToolSummarizer({
+  my_search: (input) => `[Searched: ${input.query}]`,
+  deploy: () => `[Deploying...]`,
+});
+
+createConnector(client, platform, {
+  sessionId: "main",
+  contentPolicy: "summarized",
+  toolSummarizer: summarizer,
+});
+```
+
+Built-in summaries: `glob`, `grep`, `read_file`/`ReadFile`, `write_file`/
+`WriteFile`, `edit_file`/`EditFile`, `shell`. Unknown tools get `[Used name]`.
+
+## Delivery Strategy
+
+Controls when messages are delivered to the platform.
+
+```typescript
+type DeliveryStrategy = "immediate" | "on-idle" | "debounced";
+```
+
+- **`"on-idle"`** (default) — Deliver only when execution completes. Produces
+  clean, complete messages. Best for iMessage.
+- **`"debounced"`** — Deliver after `debounceMs` (default: 1500) of no new
+  content. Good for Telegram message editing.
+- **`"immediate"`** — Deliver on every state change. For platforms that render
+  incrementally.
+
+## Rate Limiting
+
+Throttle inbound messages with sliding-window per-minute and daily caps.
+
+```typescript
+createConnector(client, platform, {
+  sessionId: "main",
+  rateLimit: {
+    maxPerMinute: 10,
+    maxPerDay: 200,
+    onLimited: ({ remaining, resetMs }) => `Slow down! Try again in ${Math.ceil(resetMs / 1000)}s.`,
+  },
+});
+```
+
+When `onLimited` returns a string, it's delivered as a synthetic message.
+Return `void` to silently drop.
+
+## Tool Confirmations
+
+When the agent requests tool approval, connectors receive the confirmation
+through `bridge.onConfirmation()`. The platform presents it to the user
+(inline keyboard, text prompt, etc.) and calls `respond()` with the result.
+
+The full response text is passed as `reason` so the model can interpret
+nuanced answers like "yes but skip the tests".
+
+```typescript
+import { parseTextConfirmation, formatConfirmationMessage } from "@agentick/connector";
+
+const message = formatConfirmationMessage(request);
+// "Allow shell to execute?\n\n  command: rm -rf /tmp/test"
+
+const response = parseTextConfirmation("yes but only in /tmp");
+// { approved: true, reason: "yes but only in /tmp" }
+```
+
+## ConnectorSession
+
+Use `ConnectorSession` directly for more control:
+
+```typescript
+import { ConnectorSession } from "@agentick/connector";
+
+const session = new ConnectorSession(client, {
+  sessionId: "main",
+  contentPolicy: "summarized",
+  deliveryStrategy: "on-idle",
+});
+
+session.onDeliver((output) => {
+  for (const msg of output.messages) {
+    sendToUser(extractText(msg.content));
+  }
+  if (output.isComplete) {
+    showTypingIndicator(false);
+  }
+});
+
+session.onConfirmation((request, respond) => {
+  promptUser(formatConfirmationMessage(request), (answer) => {
+    respond(parseTextConfirmation(answer));
+  });
+});
+
+session.send("Hello agent!");
+```
+
+## Writing a Platform Adapter
+
+Implement `ConnectorPlatform` — two methods, one interface:
+
+```typescript
+import type { ConnectorPlatform, ConnectorBridge } from "@agentick/connector";
+
+export class MyPlatform implements ConnectorPlatform {
+  async start(bridge: ConnectorBridge): Promise<void> {
+    // 1. Subscribe to your platform's inbound messages
+    this.onMessage((text) => bridge.send(text));
+
+    // 2. Handle outbound delivery
+    bridge.onDeliver((output) => {
+      for (const msg of output.messages) {
+        this.sendToUser(extractText(msg.content));
+      }
+    });
+
+    // 3. Handle tool confirmations
+    bridge.onConfirmation((request, respond) => {
+      this.promptUser(request, (answer) => {
+        respond(parseTextConfirmation(answer));
+      });
+    });
+  }
+
+  async stop(): Promise<void> {
+    // Clean up connections, timers, etc.
+  }
+}
+```
+
+The bridge provides:
+
+| Method                           | Direction | Purpose                            |
+| -------------------------------- | --------- | ---------------------------------- |
+| `bridge.send(text)`              | Inbound   | Push a user message to the agent   |
+| `bridge.sendInput(input)`        | Inbound   | Push a rich `SendInput`            |
+| `bridge.onDeliver(handler)`      | Outbound  | Receive filtered, timed messages   |
+| `bridge.onConfirmation(handler)` | Outbound  | Receive tool confirmation requests |
+| `bridge.abort(reason?)`          | Control   | Cancel current execution           |
+| `bridge.destroy()`               | Control   | Tear down the session              |
+
+All outbound messages are already filtered by the content policy and timed by
+the delivery strategy. The platform just handles I/O.
+
+## Config Reference
+
+```typescript
+interface ConnectorConfig {
+  sessionId: string;
+  contentPolicy?: ContentPolicy; // default: "text-only"
+  deliveryStrategy?: DeliveryStrategy; // default: "on-idle"
+  debounceMs?: number; // default: 1500 (for "debounced")
+  toolSummarizer?: ToolSummarizer; // custom summaries for "summarized"
+  rateLimit?: RateLimitConfig;
+  autoSubscribe?: boolean; // default: true
+}
+```
+
+## Exports
+
+```typescript
+// Core
+export { ConnectorSession } from "./connector-session.js";
+export { createConnector } from "./create-connector.js";
+
+// Content pipeline
+export {
+  buildContentFilter,
+  applyContentPolicy,
+  createToolSummarizer,
+} from "./content-pipeline.js";
+export type { ToolSummarizer } from "./content-pipeline.js";
+
+// Delivery + rate limiting
+export { DeliveryBuffer, RateLimiter } from "./delivery-buffer.js";
+
+// Text utilities
+export { parseTextConfirmation, formatConfirmationMessage } from "./text-utils.js";
+export { extractText } from "@agentick/shared"; // re-exported for convenience
+
+// Types
+export type {
+  ContentPolicy,
+  ContentPolicyFn,
+  DeliveryStrategy,
+  RateLimitConfig,
+  ConnectorConfig,
+  ConnectorOutput,
+  ConnectorPlatform,
+  ConnectorBridge,
+} from "./types.js";
+```

package/dist/connector-session.d.ts

@@ -0,0 +1,56 @@
+import type { AgentickClient } from "@agentick/client";
+import type { SendInput, ToolConfirmationResponse } from "@agentick/shared";
+import type { ToolConfirmationRequest } from "@agentick/shared";
+import type { ConnectorConfig, ConnectorOutput, ConnectorStatus, ConnectorStatusEvent } from "./types.js";
+/**
+ * Bridges an Agentick session to a connector platform.
+ *
+ * Composes `MessageLog` + `ToolConfirmations` with `subscribe: false`
+ * and a single event fan-out — same pattern as `ChatSession`, but
+ * without UI concerns (MessageSteering, LineEditor, AttachmentManager).
+ *
+ * Adds content pipeline (filtering/transformation) and delivery strategy
+ * (buffered outbound) on top.
+ */
+export declare class ConnectorSession {
+    private readonly _messageLog;
+    private readonly _confirmations;
+    private readonly _contentFilter;
+    private readonly _deliveryBuffer;
+    private readonly _rateLimiter;
+    private readonly _retryConfig;
+    private readonly _accessor;
+    private _isExecuting;
+    private _destroyed;
+    private _lastDeliveredCount;
+    private _status;
+    private _deliverListeners;
+    private _confirmationListeners;
+    private _statusListeners;
+    private _executionStartListeners;
+    private _executionEndListeners;
+    private _retryTimers;
+    private _unsubscribeEvents;
+    private _unsubscribeConfirmations;
+    constructor(client: AgentickClient, config: ConnectorConfig);
+    get status(): ConnectorStatus;
+    send(text: string): void;
+    sendInput(input: SendInput): void;
+    respondToConfirmation(response: ToolConfirmationResponse): void;
+    abort(reason?: string): void;
+    reportStatus(status: ConnectorStatus, error?: Error): void;
+    onStatus(handler: (event: ConnectorStatusEvent) => void): () => void;
+    onDeliver(handler: (output: ConnectorOutput) => void | Promise<void>): () => void;
+    onConfirmation(handler: (request: ToolConfirmationRequest, respond: (r: ToolConfirmationResponse) => void) => void): () => void;
+    onExecutionStart(handler: () => void): () => void;
+    onExecutionEnd(handler: () => void): () => void;
+    destroy(): void;
+    /** Returns true if rate-limited (caller should bail). */
+    private _checkRateLimit;
+    private _hasNewContent;
+    private _emitDelivery;
+    private _deliverWithRetry;
+    private _handleDeliveryError;
+    private _emitSyntheticMessage;
+}
+//# sourceMappingURL=connector-session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connector-session.d.ts","sourceRoot":"","sources":["../src/connector-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,KAAK,EAAe,SAAS,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,eAAe,EACf,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAcpB;;;;;;;;;GASG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoB;IACnD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkB;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IAE3B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,OAAO,CAAmC;IAElD,OAAO,CAAC,iBAAiB,CAAgE;IACzF,OAAO,CAAC,sBAAsB,CAE1B;IACJ,OAAO,CAAC,gBAAgB,CAAoD;IAC5E,OAAO,CAAC,wBAAwB,CAAyB;IACzD,OAAO,CAAC,sBAAsB,CAAyB;IAEvD,OAAO,CAAC,YAAY,CAA4C;IAChE,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,yBAAyB,CAA6B;gBAElD,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe;IA8F3D,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAKjC,qBAAqB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,IAAI;IAI/D,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAI5B,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAa1D,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,GAAG,MAAM,IAAI;IAKpE,SAAS,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI;IAKjF,cAAc,CACZ,OAAO,EAAE,CACP,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,CAAC,CAAC,EAAE,wBAAwB,KAAK,IAAI,KAC3C,IAAI,GACR,MAAM,IAAI;IAKb,gBAAgB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAKjD,cAAc,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAK/C,OAAO,IAAI,IAAI;IAkBf,yDAAyD;IACzD,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,oBAAoB;IAuB5B,OAAO,CAAC,qBAAqB;CAoB9B"}

package/dist/connector-session.js

@@ -0,0 +1,271 @@
+import { MessageLog, ToolConfirmations } from "@agentick/client";
+import { buildContentFilter, applyContentPolicy } from "./content-pipeline.js";
+import { DeliveryBuffer, RateLimiter } from "./delivery-buffer.js";
+let syntheticIdCounter = 0;
+/**
+ * Bridges an Agentick session to a connector platform.
+ *
+ * Composes `MessageLog` + `ToolConfirmations` with `subscribe: false`
+ * and a single event fan-out — same pattern as `ChatSession`, but
+ * without UI concerns (MessageSteering, LineEditor, AttachmentManager).
+ *
+ * Adds content pipeline (filtering/transformation) and delivery strategy
+ * (buffered outbound) on top.
+ */
+export class ConnectorSession {
+    _messageLog;
+    _confirmations;
+    _contentFilter;
+    _deliveryBuffer;
+    _rateLimiter;
+    _retryConfig;
+    _accessor;
+    _isExecuting = false;
+    _destroyed = false;
+    _lastDeliveredCount = 0;
+    _status = "disconnected";
+    _deliverListeners = new Set();
+    _confirmationListeners = new Set();
+    _statusListeners = new Set();
+    _executionStartListeners = new Set();
+    _executionEndListeners = new Set();
+    _retryTimers = new Set();
+    _unsubscribeEvents = null;
+    _unsubscribeConfirmations = null;
+    constructor(client, config) {
+        const sessionId = config.sessionId;
+        this._contentFilter = buildContentFilter(config.contentPolicy ?? "text-only", config.toolSummarizer);
+        this._rateLimiter = config.rateLimit ? new RateLimiter(config.rateLimit) : null;
+        const retry = config.retry ?? {};
+        this._retryConfig = {
+            maxAttempts: retry.maxAttempts ?? 3,
+            baseDelay: retry.baseDelay ?? 1000,
+            maxDelay: retry.maxDelay ?? 30_000,
+            onExhausted: retry.onExhausted,
+        };
+        // Create primitives in externally-driven mode
+        this._messageLog = new MessageLog(client, {
+            sessionId,
+            renderMode: config.renderMode ?? "message",
+            subscribe: false,
+        });
+        this._confirmations = new ToolConfirmations(client, {
+            sessionId,
+            policy: config.confirmationPolicy,
+            subscribe: false,
+        });
+        // Delivery buffer controls outbound timing
+        this._deliveryBuffer = new DeliveryBuffer({
+            strategy: config.deliveryStrategy ?? "on-idle",
+            debounceMs: config.debounceMs ?? 1500,
+            onDeliver: () => this._emitDelivery(),
+        });
+        // Single event subscription — fan out to message log + delivery buffer
+        const accessor = client.session(sessionId);
+        this._accessor = accessor;
+        if (config.autoSubscribe !== false) {
+            accessor.subscribe();
+        }
+        this._unsubscribeEvents = accessor.onEvent((event) => {
+            this._messageLog.processEvent(event);
+            if (event.type === "execution_start") {
+                this._isExecuting = true;
+                for (const listener of this._executionStartListeners) {
+                    try {
+                        listener();
+                    }
+                    catch (e) {
+                        console.error("Error in execution start listener:", e);
+                    }
+                }
+            }
+            if (event.type === "execution_end") {
+                this._isExecuting = false;
+                for (const listener of this._executionEndListeners) {
+                    try {
+                        listener();
+                    }
+                    catch (e) {
+                        console.error("Error in execution end listener:", e);
+                    }
+                }
+                this._deliveryBuffer.markIdle();
+                return;
+            }
+            // Poke delivery buffer on message changes
+            if (this._hasNewContent()) {
+                this._deliveryBuffer.poke();
+            }
+        });
+        this._unsubscribeConfirmations = accessor.onToolConfirmation((request, respond) => {
+            this._confirmations.handleConfirmation(request, respond);
+            // Notify connector listeners
+            for (const listener of this._confirmationListeners) {
+                try {
+                    listener(request, respond);
+                }
+                catch (e) {
+                    console.error("Error in connector confirmation listener:", e);
+                }
+            }
+        });
+    }
+    // --- Public API ---
+    get status() {
+        return this._status;
+    }
+    send(text) {
+        if (this._checkRateLimit())
+            return;
+        this._accessor.send({ messages: [{ role: "user", content: [{ type: "text", text }] }] });
+    }
+    sendInput(input) {
+        if (this._checkRateLimit())
+            return;
+        this._accessor.send(input);
+    }
+    respondToConfirmation(response) {
+        this._confirmations.respond(response);
+    }
+    abort(reason) {
+        this._accessor.abort(reason);
+    }
+    reportStatus(status, error) {
+        this._status = status;
+        const event = { status };
+        if (error)
+            event.error = error;
+        for (const listener of this._statusListeners) {
+            try {
+                listener(event);
+            }
+            catch (e) {
+                console.error("Error in connector status listener:", e);
+            }
+        }
+    }
+    onStatus(handler) {
+        this._statusListeners.add(handler);
+        return () => this._statusListeners.delete(handler);
+    }
+    onDeliver(handler) {
+        this._deliverListeners.add(handler);
+        return () => this._deliverListeners.delete(handler);
+    }
+    onConfirmation(handler) {
+        this._confirmationListeners.add(handler);
+        return () => this._confirmationListeners.delete(handler);
+    }
+    onExecutionStart(handler) {
+        this._executionStartListeners.add(handler);
+        return () => this._executionStartListeners.delete(handler);
+    }
+    onExecutionEnd(handler) {
+        this._executionEndListeners.add(handler);
+        return () => this._executionEndListeners.delete(handler);
+    }
+    destroy() {
+        this._destroyed = true;
+        this._unsubscribeEvents?.();
+        this._unsubscribeConfirmations?.();
+        this._messageLog.destroy();
+        this._confirmations.destroy();
+        this._deliveryBuffer.destroy();
+        for (const timer of this._retryTimers)
+            clearTimeout(timer);
+        this._retryTimers.clear();
+        this._deliverListeners.clear();
+        this._confirmationListeners.clear();
+        this._statusListeners.clear();
+        this._executionStartListeners.clear();
+        this._executionEndListeners.clear();
+    }
+    // --- Private ---
+    /** Returns true if rate-limited (caller should bail). */
+    _checkRateLimit() {
+        if (!this._rateLimiter)
+            return false;
+        const check = this._rateLimiter.check();
+        if (check.allowed)
+            return false;
+        if (check.reply)
+            this._emitSyntheticMessage(check.reply);
+        return true;
+    }
+    _hasNewContent() {
+        return this._messageLog.messages.length > this._lastDeliveredCount;
+    }
+    _emitDelivery() {
+        const allMessages = this._messageLog.messages;
+        const newMessages = allMessages.slice(this._lastDeliveredCount);
+        this._lastDeliveredCount = allMessages.length;
+        if (newMessages.length === 0)
+            return;
+        // Only deliver assistant messages — user messages originated from an input
+        // source and should never be echoed back to the platform.
+        const assistantOnly = newMessages.filter((m) => m.role === "assistant");
+        if (assistantOnly.length === 0 && this._isExecuting)
+            return;
+        const filtered = applyContentPolicy(assistantOnly, this._contentFilter);
+        const isComplete = !this._isExecuting;
+        if (filtered.length === 0 && !isComplete)
+            return;
+        const output = {
+            messages: filtered,
+            isComplete,
+        };
+        for (const listener of this._deliverListeners) {
+            this._deliverWithRetry(listener, output);
+        }
+    }
+    _deliverWithRetry(listener, output, attempt = 0) {
+        try {
+            const result = listener(output);
+            if (result && typeof result.then === "function") {
+                result.then(undefined, (err) => {
+                    this._handleDeliveryError(err, listener, output, attempt);
+                });
+            }
+        }
+        catch (err) {
+            this._handleDeliveryError(err, listener, output, attempt);
+        }
+    }
+    _handleDeliveryError(err, listener, output, attempt) {
+        if (this._destroyed)
+            return;
+        const nextAttempt = attempt + 1;
+        if (nextAttempt >= this._retryConfig.maxAttempts) {
+            console.error(`Delivery failed after ${this._retryConfig.maxAttempts} attempts:`, err);
+            this._retryConfig.onExhausted?.(err, output);
+            return;
+        }
+        const delay = Math.min(this._retryConfig.baseDelay * 2 ** attempt, this._retryConfig.maxDelay);
+        const timer = setTimeout(() => {
+            this._retryTimers.delete(timer);
+            this._deliverWithRetry(listener, output, nextAttempt);
+        }, delay);
+        this._retryTimers.add(timer);
+    }
+    _emitSyntheticMessage(text) {
+        const output = {
+            messages: [
+                {
+                    id: `synthetic_${++syntheticIdCounter}`,
+                    role: "assistant",
+                    content: text,
+                },
+            ],
+            isComplete: true,
+        };
+        for (const listener of this._deliverListeners) {
+            try {
+                listener(output);
+            }
+            catch (e) {
+                console.error("Error in connector delivery listener:", e);
+            }
+        }
+    }
+}
+//# sourceMappingURL=connector-session.js.map

package/dist/connector-session.js.map

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

package/dist/content-pipeline.d.ts

@@ -0,0 +1,23 @@
+import type { ChatMessage } from "@agentick/client";
+import type { ContentPolicy, ContentPolicyFn } from "./types.js";
+/**
+ * Summarize a tool call as human-readable text.
+ * Connectors can override this per-tool via ContentPolicy functions,
+ * or provide a custom `summarizeTool` in ConnectorConfig.
+ */
+export type ToolSummarizer = (name: string, input: Record<string, unknown>) => string;
+/**
+ * Create a tool summarizer with optional custom overrides.
+ * Custom summaries are checked first, then defaults, then generic fallback.
+ */
+export declare function createToolSummarizer(custom?: Record<string, (input: Record<string, unknown>) => string>): ToolSummarizer;
+/**
+ * Build a filter function from a ContentPolicy.
+ */
+export declare function buildContentFilter(policy: ContentPolicy, toolSummarizer?: ToolSummarizer): ContentPolicyFn;
+/**
+ * Apply the content filter to a batch of messages.
+ * Returns only messages that survive filtering.
+ */
+export declare function applyContentPolicy(messages: readonly ChatMessage[], filter: ContentPolicyFn): ChatMessage[];
+//# sourceMappingURL=content-pipeline.d.ts.map

package/dist/content-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-pipeline.d.ts","sourceRoot":"","sources":["../src/content-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjE;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;AAsCtF;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,GAClE,cAAc,CAchB;AAKD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EACrB,cAAc,CAAC,EAAE,cAAc,GAC9B,eAAe,CAajB;AAgDD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,MAAM,EAAE,eAAe,GACtB,WAAW,EAAE,CAYf"}