telegram-agent-kit 0.1.0

package/dist/interfaces-BRu3W_FZ.d.ts

@@ -0,0 +1,81 @@
+type ChatKey = {
+    chatId: number;
+    agentId: string;
+};
+type Logger = {
+    warn(msg: string, data?: unknown): void;
+    error(msg: string, data?: unknown): void;
+    info?(msg: string, data?: unknown): void;
+};
+/** Raw Bot API transport primitives — one HTTP call each, NO chunking /
+ *  rendering / fallback (the kit owns those). Each throws TelegramApiError
+ *  (see ../errors.ts) on a Bot API error. */
+type BotClient = {
+    sendMessage(p: {
+        chatId: number;
+        text: string;
+        parseMode?: 'HTML';
+    }, signal?: AbortSignal): Promise<void>;
+    sendRichMessage(p: {
+        chatId: number;
+        markdown: string;
+    }, signal?: AbortSignal): Promise<void>;
+    sendPhoto(p: {
+        chatId: number;
+        url: string;
+        caption?: string;
+        parseMode?: 'HTML';
+    }, signal?: AbortSignal): Promise<void>;
+    sendChatAction(p: {
+        chatId: number;
+        action?: string;
+    }, signal?: AbortSignal): Promise<void>;
+    sendMessageDraft(p: {
+        chatId: number;
+        draftId: number;
+        text: string;
+    }, signal?: AbortSignal): Promise<void>;
+    sendRichMessageDraft(p: {
+        chatId: number;
+        draftId: number;
+        markdown: string;
+    }, signal?: AbortSignal): Promise<void>;
+};
+type RenderEvent = {
+    type: 'token';
+    text: string;
+} | {
+    type: 'tool_start';
+    id: string;
+    name: string;
+    args: unknown;
+} | {
+    type: 'tool_end';
+    id: string;
+    durationMs: number;
+    error?: string;
+} | {
+    type: 'error';
+    message: string;
+};
+type StreamInput = {
+    messages: {
+        role: 'user';
+        content: string;
+    }[];
+};
+type AgentStreamContext = {
+    threadId: string;
+    signal?: AbortSignal;
+};
+type AgentStream = (input: StreamInput, context: AgentStreamContext) => AsyncIterable<RenderEvent>;
+type Checkpointer = {
+    snapshot(threadId: string): Promise<string | null>;
+    rollback(threadId: string, checkpointId: string | null): Promise<void>;
+};
+type ThreadStore = {
+    resolve(key: ChatKey, now: number): Promise<string>;
+    touch(key: ChatKey, now: number): Promise<void>;
+};
+
+export type { AgentStream as A, BotClient as B, ChatKey as C, Logger as L, RenderEvent as R, StreamInput as S, ThreadStore as T, Checkpointer as a, AgentStreamContext as b };

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "telegram-agent-kit",
+  "version": "0.1.0",
+  "description": "Render markdown to Telegram, stream agent replies into live drafts, and drive a snapshot/rollback turn-loop — runtime-agnostic.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Ivan Kalinichenko",
+  "homepage": "https://github.com/kalinichenko88/telegram-agent-kit#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kalinichenko88/telegram-agent-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/kalinichenko88/telegram-agent-kit/issues"
+  },
+  "keywords": [
+    "telegram",
+    "telegram-bot",
+    "bot-api",
+    "llm",
+    "agent",
+    "agents",
+    "streaming",
+    "markdown",
+    "html",
+    "langgraph",
+    "deepagents",
+    "esm"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./deepagents": {
+      "types": "./dist/deepagents/index.d.ts",
+      "import": "./dist/deepagents/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "biome check .",
+    "format": "biome format --write ."
+  },
+  "peerDependencies": {
+    "@langchain/core": ">=1",
+    "deepagents": ">=1"
+  },
+  "peerDependenciesMeta": {
+    "@langchain/core": {
+      "optional": true
+    },
+    "deepagents": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.0",
+    "@langchain/core": "^1.2.0",
+    "@types/node": "^22.0.0",
+    "deepagents": "^1.10.5",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  }
+}