@s2x5/agentim 1.7.16

package/dist/messageRouter.d.ts

@@ -0,0 +1,41 @@
+/**
+ * MessageRouter - 自适应消息批量合并调度器
+ *
+ * 在同一会话的消息流中，根据消息密度自动调整合并窗口：
+ * - 单条消息无后续：300ms 即 flush（低延迟）
+ * - 消息密集时：窗口自动拉长，最长 5 分钟
+ * - 背压保护：单 key 缓冲超过 maxBufferSize 条时强制 flush
+ */
+export interface IncomingMessage {
+    id: string;
+    conversationId?: string;
+    groupId?: string;
+    senderId: string;
+    senderName: string;
+    senderAvatarUrl?: string;
+    senderUserType?: string;
+    content: string;
+    timestamp: string;
+    type: 'direct' | 'group';
+    messageType?: string;
+    fileUrl?: string;
+    fileName?: string;
+    richContent?: string;
+    thumbnailUrl?: string;
+    ownerConversationId?: string;
+}
+export type MessageHandler = (messages: IncomingMessage[]) => void | Promise<void>;
+export declare class MessageRouter {
+    private buffers;
+    private flushTimers;
+    private firstArrival;
+    private handler;
+    private baseWindowMs;
+    private maxWindowMs;
+    private maxBufferSize;
+    constructor(handler: MessageHandler, baseWindowMs?: number, maxWindowMs?: number, maxBufferSize?: number);
+    push(msg: IncomingMessage): void;
+    private cancelTimer;
+    private flush;
+    dispose(): void;
+}

package/dist/messageSchema.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Zod schemas for validating SSE inbound message payloads.
+ *
+ * Provides structural validation so malformed or adversarial payloads
+ * are rejected before reaching the message processing pipeline.
+ */
+import { z } from 'zod';
+export declare const SseMessageSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    messageId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    conversationId: z.ZodOptional<z.ZodString>;
+    groupId: z.ZodOptional<z.ZodString>;
+    senderId: z.ZodString;
+    senderName: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    senderUserType: z.ZodOptional<z.ZodString>;
+    senderAvatarUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    content: z.ZodString;
+    sentAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    messageType: z.ZodOptional<z.ZodString>;
+    richContent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    fileUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    fileName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    thumbnailUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    isAgentReply: z.ZodOptional<z.ZodBoolean>;
+    replyAgentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    showTime: z.ZodOptional<z.ZodBoolean>;
+    ownerConversationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    targetOwnerUserId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$loose>;
+export type ValidatedSseMessage = z.infer<typeof SseMessageSchema>;
+/**
+ * Validate an SSE message payload.
+ * Returns the validated data on success, or null with a warning on failure.
+ */
+export declare function validateSseMessage(data: unknown): ValidatedSseMessage | null;

package/dist/promptGuard.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Prompt Injection Guard
+ *
+ * Delegates injection scanning and outbound filtering to the AgenTim backend API,
+ * keeping detection patterns off the client-side npm package.
+ * Provides message boundary framing locally (not security-sensitive).
+ */
+export interface InjectionScanResult {
+    detected: boolean;
+    riskLevel: 'none' | 'low' | 'medium' | 'high';
+    patterns: string[];
+}
+export interface PromptGuardClient {
+    baseUrl: string;
+    getToken: () => string | null;
+}
+export declare function initPromptGuardClient(client: PromptGuardClient): void;
+export declare function scanForInjection(content: string): Promise<InjectionScanResult>;
+export declare function filterOutboundText(text: string): Promise<{
+    text: string;
+    redacted: boolean;
+}>;
+export interface MessageRoutingContext {
+    senderId: string;
+    conversationId?: string;
+    groupId?: string;
+    chatType: 'direct' | 'group';
+    ownerConversationId?: string;
+}
+/**
+ * Wrap raw message content with explicit boundary delimiters so the receiving
+ * LLM can distinguish user-authored content from system instructions.
+ */
+export declare function frameMessageBody(rawBody: string, senderName: string, senderType: string | undefined, injection: InjectionScanResult, routing?: MessageRoutingContext): {
+    framedBody: string;
+    framedBodyForAgent: string;
+};

package/dist/sseTransport.d.ts

@@ -0,0 +1,36 @@
+/**
+ * SSE Transport for AgenTim Agent messaging.
+ *
+ * Pure fetch + ReadableStream implementation (no EventSource dependency)
+ * so it works in Node.js without polyfills. Handles automatic reconnection
+ * with exponential back-off and Last-Event-ID based catch-up.
+ */
+import type { ChannelLogSink } from './types';
+export interface SseTransportOptions {
+    baseUrl: string;
+    getToken: () => string | null;
+    onEvent: (event: string, data: unknown) => void;
+    onConnected?: () => void;
+    onError?: (err: Error) => void;
+    log?: ChannelLogSink;
+}
+export declare class SseTransport {
+    private abortController;
+    private lastEventId;
+    private reconnectMs;
+    private reconnectTimer;
+    private stopped;
+    private opts;
+    private static readonly MIN_RECONNECT_MS;
+    private static readonly MAX_RECONNECT_MS;
+    constructor(opts: SseTransportOptions);
+    start(): Promise<void>;
+    stop(): void;
+    /** Force reconnect (e.g. after token refresh). */
+    reconnect(): void;
+    getLastEventId(): string | null;
+    private connect;
+    private readStream;
+    private dispatchEvent;
+    private scheduleReconnect;
+}

package/dist/types.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Local type approximations of OpenClaw plugin interfaces.
+ * These match the real ChannelPlugin / ChannelGatewayAdapter / ChannelOutboundAdapter
+ * types without requiring openclaw as a compile-time dependency.
+ */
+import type { AgenTimAccount } from './apiClient';
+export interface OpenClawConfig {
+    channels?: {
+        agentim?: {
+            accounts?: Record<string, AgenTimAccount>;
+        };
+    };
+    session?: {
+        dmScope?: string;
+        identityLinks?: unknown;
+    };
+    [key: string]: unknown;
+}
+export interface ChannelLogSink {
+    info?: (...args: unknown[]) => void;
+    warn?: (...args: unknown[]) => void;
+    error?: (...args: unknown[]) => void;
+}
+export interface ChannelRuntime {
+    routing: {
+        resolveAgentRoute: (input: {
+            cfg: OpenClawConfig;
+            channel: string;
+            accountId?: string;
+            peer?: {
+                kind: string;
+                id: string;
+            };
+        }) => {
+            agentId?: string;
+            sessionKey: string;
+            accountId?: string;
+        };
+    };
+    reply: {
+        finalizeInboundContext: <T extends Record<string, unknown>>(ctx: T) => T;
+        dispatchReplyWithBufferedBlockDispatcher: (params: {
+            ctx: Record<string, unknown>;
+            cfg: OpenClawConfig;
+            dispatcherOptions: {
+                deliver: (payload: {
+                    text: string;
+                    [key: string]: unknown;
+                }) => Promise<void>;
+            };
+            replyOptions?: Record<string, unknown>;
+        }) => Promise<unknown>;
+    };
+    session: {
+        resolveStorePath: (params: Record<string, unknown>) => string;
+        recordInboundSession: (params: Record<string, unknown>) => Promise<void>;
+    };
+}
+export interface ChannelGatewayContext {
+    cfg: OpenClawConfig;
+    accountId: string;
+    account: AgenTimAccount;
+    runtime: unknown;
+    abortSignal: AbortSignal;
+    log?: ChannelLogSink;
+    getStatus: () => unknown;
+    setStatus: (next: unknown) => void;
+    channelRuntime?: ChannelRuntime;
+}
+export interface ChannelOutboundContext {
+    cfg: OpenClawConfig;
+    to: string;
+    text: string;
+    accountId?: string | null;
+    mediaUrl?: string;
+    replyToId?: string | null;
+    threadId?: string | number | null;
+    identity?: unknown;
+    deps?: unknown;
+    silent?: boolean;
+}
+export interface OutboundDeliveryResult {
+    channel: string;
+    messageId: string;
+}
+export interface OpenClawApi {
+    registerChannel(opts: {
+        plugin: unknown;
+    }): void;
+}
+export interface SessionStoreEntry {
+    sessionId?: string;
+    updatedAt?: number;
+    lastChannel?: string;
+    lastTo?: string;
+    lastAccountId?: string;
+    lastThreadId?: string | number;
+    [key: string]: unknown;
+}
+export interface PluginRuntimeSubset {
+    agent: {
+        session: {
+            loadSessionStore: (storePath?: string) => Record<string, SessionStoreEntry>;
+        };
+    };
+}
+export interface PluginHookBeforePromptBuildResult {
+    systemPrompt?: string;
+    prependContext?: string;
+    prependSystemContext?: string;
+    appendSystemContext?: string;
+}
+export interface OpenClawPluginApi extends OpenClawApi {
+    id: string;
+    name: string;
+    config: OpenClawConfig;
+    registrationMode: 'full' | 'setup-only' | 'setup-runtime';
+    runtime: PluginRuntimeSubset;
+    registerHook(events: string | string[], handler: (...args: unknown[]) => unknown, opts?: {
+        priority?: number;
+    }): void;
+}

package/openclaw.plugin.json

@@ -0,0 +1,28 @@
+{
+  "id": "agentim",
+  "name": "AgenTim Social Platform",
+  "description": "Connect to AgenTim social platform for real-time messaging, contacts, and group chat.",
+  "version": "1.7.16",
+  "channels": [
+    "agentim"
+  ],
+  "skills": [
+    "./skills"
+  ],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  },
+  "configUiHints": {
+    "apiKey": {
+      "label": "API Key",
+      "sensitive": true,
+      "placeholder": "sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+    },
+    "baseUrl": {
+      "label": "Platform URL",
+      "placeholder": "https://your-agentim-instance.com"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@s2x5/agentim",
+  "version": "1.7.16",
+  "description": "OpenClaw Channel Plugin for AgenTim social platform - messaging via HTTP+SSE",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "rm -rf dist && rollup -c rollup.config.mjs && tsc -p tsconfig.build.json",
+    "dev": "tsc --watch",
+    "test": "jest",
+    "version": "node scripts/sync-version.js && git add openclaw.plugin.json ../backend/templates/agentim-install-guide.md",
+    "prepublishOnly": "npm run build"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "keywords": [
+    "openclaw",
+    "agentim",
+    "channel",
+    "plugin",
+    "social",
+    "messaging"
+  ],
+  "author": "AgenTim",
+  "license": "SEE LICENSE IN LICENSE",
+  "peerDependencies": {
+    "openclaw": ">=2026.0.0"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "jest": "^29.7.0",
+    "rollup": "^4.60.1",
+    "ts-jest": "^29.1.0",
+    "tslib": "^2.8.1",
+    "typescript": "^5.4.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist/",
+    "skills/",
+    "openclaw.plugin.json",
+    "README.md",
+    "LICENSE"
+  ]
+}