@agentick/connector 0.5.0

package/dist/types.d.ts

@@ -0,0 +1,99 @@
+import type { ChatMessage, RenderMode, ConfirmationPolicy } from "@agentick/client";
+import type { SendInput, ToolConfirmationRequest, ToolConfirmationResponse } from "@agentick/shared";
+import type { ToolSummarizer } from "./content-pipeline.js";
+export type ConnectorStatus = "disconnected" | "connecting" | "connected" | "error";
+export interface ConnectorStatusEvent {
+    status: ConnectorStatus;
+    /** Present when status is "error". */
+    error?: Error;
+    /** Human-readable detail. */
+    message?: string;
+}
+/**
+ * Controls what content reaches the platform.
+ *
+ * - `"full"` — pass through unchanged
+ * - `"text-only"` — strip tool_use/tool_result blocks, keep text + images
+ * - `"summarized"` — collapse tool calls into brief summaries, keep text
+ * - Function — full control over filtering/transformation
+ */
+export type ContentPolicy = "full" | "text-only" | "summarized" | ContentPolicyFn;
+export type ContentPolicyFn = (message: ChatMessage) => ChatMessage | null;
+/**
+ * Controls when messages are delivered to the platform.
+ *
+ * - `"immediate"` — deliver on every state change
+ * - `"on-idle"` — deliver only when execution completes
+ * - `"debounced"` — deliver after N ms of no new content
+ */
+export type DeliveryStrategy = "immediate" | "on-idle" | "debounced";
+export interface RateLimitConfig {
+    /** Maximum inbound messages per minute. */
+    maxPerMinute?: number;
+    /** Maximum inbound messages per day. */
+    maxPerDay?: number;
+    /** Called when a message is rate-limited. Return a string to reply, or void to silently drop. */
+    onLimited?: (info: {
+        remaining: number;
+        resetMs: number;
+    }) => string | void;
+}
+export interface RetryConfig {
+    /** Maximum delivery attempts before giving up. Default: 3. */
+    maxAttempts?: number;
+    /** Base delay in ms for exponential backoff. Default: 1000. */
+    baseDelay?: number;
+    /** Maximum delay in ms. Default: 30000. */
+    maxDelay?: number;
+    /** Called when all retries are exhausted. */
+    onExhausted?: (error: Error, output: ConnectorOutput) => void;
+}
+export interface ConnectorConfig {
+    sessionId: string;
+    contentPolicy?: ContentPolicy;
+    deliveryStrategy?: DeliveryStrategy;
+    debounceMs?: number;
+    renderMode?: RenderMode;
+    confirmationPolicy?: ConfirmationPolicy;
+    autoSubscribe?: boolean;
+    rateLimit?: RateLimitConfig;
+    /** Custom tool summarizer for the "summarized" content policy. */
+    toolSummarizer?: ToolSummarizer;
+    /** Retry config for failed outbound deliveries. */
+    retry?: RetryConfig;
+}
+export interface ConnectorOutput {
+    messages: ChatMessage[];
+    isComplete: boolean;
+}
+/**
+ * Interface for external platform adapters (Telegram, iMessage, etc).
+ * Receives a bridge on start that it uses to send messages in and receive
+ * processed output.
+ */
+export interface ConnectorPlatform {
+    start(bridge: ConnectorBridge): void | Promise<void>;
+    stop(): void | Promise<void>;
+    /** Optional — platform reports its own health. */
+    readonly status?: ConnectorStatus;
+}
+/**
+ * Bridge provided by the framework to the platform adapter.
+ * The platform uses this to push inbound messages and receive
+ * delivery-ready output.
+ */
+export interface ConnectorBridge {
+    send(text: string): void;
+    sendInput(input: SendInput): void;
+    onDeliver(handler: (output: ConnectorOutput) => void | Promise<void>): () => void;
+    onConfirmation(handler: (request: ToolConfirmationRequest, respond: (r: ToolConfirmationResponse) => void) => void): () => void;
+    /** Platform reports status changes to the framework. */
+    reportStatus(status: ConnectorStatus, error?: Error): void;
+    /** Register a handler called when an execution starts. Returns unsubscribe. */
+    onExecutionStart(handler: () => void): () => void;
+    /** Register a handler called when an execution ends. Returns unsubscribe. */
+    onExecutionEnd(handler: () => void): () => void;
+    abort(reason?: string): void;
+    destroy(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@agentick/connector",
+  "version": "0.5.0",
+  "description": "Bridge external platforms to Agentick sessions",
+  "keywords": [
+    "agent",
+    "ai",
+    "bridge",
+    "connector",
+    "platform"
+  ],
+  "license": "MIT",
+  "author": "Ryan Lindgren",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agenticklabs/agentick.git",
+    "directory": "packages/connector"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js"
+      }
+    },
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "echo \"Tests run from workspace root\"",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit",
+    "lint": "oxlint src/",
+    "format:check": "oxfmt --check src/",
+    "clean": "rm -rf dist tsconfig.build.tsbuildinfo",
+    "prepublishOnly": "pnpm build",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "@agentick/client": "workspace:*",
+    "@agentick/shared": "workspace:*"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,34 @@
+export { ConnectorSession } from "./connector-session.js";
+export { createConnector } from "./create-connector.js";
+export type { ConnectorHandle } from "./create-connector.js";
+export {
+  buildContentFilter,
+  applyContentPolicy,
+  createToolSummarizer,
+} from "./content-pipeline.js";
+export type { ToolSummarizer } from "./content-pipeline.js";
+export { DeliveryBuffer, RateLimiter } from "./delivery-buffer.js";
+export { splitMessage } from "./message-splitter.js";
+
+export type {
+  ContentPolicy,
+  ContentPolicyFn,
+  DeliveryStrategy,
+  RateLimitConfig,
+  RetryConfig,
+  ConnectorConfig,
+  ConnectorOutput,
+  ConnectorPlatform,
+  ConnectorBridge,
+  ConnectorStatus,
+  ConnectorStatusEvent,
+} from "./types.js";
+
+export type { DeliveryBufferOptions } from "./delivery-buffer.js";
+export type { SplitOptions } from "./message-splitter.js";
+
+// Re-export extractText from shared — the canonical implementation lives there.
+// Connector-specific text utilities (confirmation parsing/formatting) live here.
+export { extractText } from "@agentick/shared";
+
+export { parseTextConfirmation, formatConfirmationMessage } from "./text-utils.js";