@hopgoldy/agent-bridge 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,171 @@
+type ClientOutputEvent = {
+    type: "user.message";
+    clientSessionId: string;
+    text: string;
+} | {
+    type: "command.session.new";
+    clientSessionId: string;
+} | {
+    type: "command.session.compact";
+    clientSessionId: string;
+} | {
+    type: "command.session.stop";
+    clientSessionId: string;
+};
+type AgentInputEvent = {
+    type: "user.message";
+    text: string;
+} | {
+    type: "command.session.compact";
+};
+interface OutboundAttachment {
+    kind: "image" | "file";
+    filePath: string;
+    fileName?: string;
+    caption?: string;
+}
+type AgentOutputPayload = {
+    type: "assistant.message";
+    text: string;
+    attachments?: OutboundAttachment[];
+} | {
+    type: "assistant.thinking";
+    text?: string;
+} | {
+    type: "assistant.tool.running";
+    toolName: string;
+    text?: string;
+} | {
+    type: "assistant.tool.done";
+    toolName: string;
+    text?: string;
+} | {
+    type: "assistant.tool.error";
+    toolName: string;
+    text?: string;
+} | {
+    type: "session.compacting";
+    text?: string;
+};
+type AgentOutputEvent = AgentOutputPayload & {
+    agentSessionId: string;
+};
+type ClientInputEvent = AgentOutputPayload & {
+    clientSessionId: string;
+};
+type LegacyAgentInputEvent = AgentInputEvent;
+interface IMAdapter {
+    start(onOutput: (event: ClientOutputEvent) => Promise<void> | void): Promise<void>;
+    stop(): Promise<void>;
+    input(event: ClientInputEvent): Promise<void>;
+    isBusy(): Promise<boolean>;
+}
+interface AgentAdapter {
+    start(onOutput: (event: AgentOutputEvent) => Promise<void> | void): Promise<void>;
+    stop(): Promise<void>;
+    abort?(): Promise<void>;
+    input(event: AgentInputEvent): Promise<void>;
+    isBusy(): Promise<boolean>;
+}
+interface ConfigSelectOption {
+    label: string;
+    value: string;
+}
+interface ConfigInputOptions {
+    defaultValue?: string;
+    required?: boolean;
+    secret?: boolean;
+    validate?: (value: string) => string | null;
+}
+interface ConfigCollectContext {
+    input(label: string, opts?: ConfigInputOptions): Promise<string>;
+    select(label: string, options: ConfigSelectOption[]): Promise<string>;
+    confirm(label: string, defaultValue?: boolean): Promise<boolean>;
+    close(): void;
+}
+interface ConfigAdapter<TConfig = unknown> {
+    collect(ctx: ConfigCollectContext): Promise<TConfig>;
+    validate(config: TConfig): Promise<void> | void;
+    summarize?(config: TConfig): string;
+}
+interface ClientModule<TConfig = unknown> {
+    readonly type: string;
+    createConfigCollector?: () => ConfigAdapter<TConfig>;
+    createClientAdapter(config: TConfig): IMAdapter;
+}
+interface AgentModule<TConfig = unknown> {
+    readonly type: string;
+    createConfigCollector?: () => ConfigAdapter<TConfig>;
+    createAgentSession(args: {
+        config: TConfig;
+    }): Promise<{
+        agentSessionId: string;
+        agentAdapter: AgentAdapter;
+    }>;
+    resumeAgentSession?(args: {
+        config: TConfig;
+        agentSessionId: string;
+    }): Promise<AgentAdapter>;
+}
+interface FeishuClientConfig {
+    appId: string;
+    appSecret: string;
+    domain?: "feishu" | "lark";
+    encryptKey?: string;
+    verificationToken?: string;
+    requireMentionInGroup?: boolean;
+}
+interface PiCodingAgentConfig {
+    bin?: string;
+    sessionDir?: string;
+    model?: string;
+    extraArgs?: string[];
+}
+type ClientConfig = {
+    type: "feishu";
+    config: FeishuClientConfig;
+};
+type AgentConfig = {
+    type: "pi-coding-agent";
+    config: PiCodingAgentConfig;
+};
+interface ChannelConfig {
+    client: ClientConfig;
+    agent: AgentConfig;
+}
+interface AppDefaults {
+    agentIdleTimeoutMs: number;
+}
+interface AppConfig {
+    channels: Record<string, ChannelConfig>;
+    defaults: AppDefaults;
+}
+interface ChannelRunner {
+    stop(): Promise<void>;
+}
+interface GatewayCoreOptions {
+    imAdapter: IMAdapter;
+    agentModule: AgentModule<any>;
+    agentConfig: AgentConfig["config"];
+    agentIdleTimeoutMs: number;
+    bindingStore?: SessionBindingStore;
+}
+interface SessionBindingStore {
+    load(): Promise<Record<string, string>>;
+    save(bindings: Record<string, string>): Promise<void>;
+}
+interface RunChannelOptions {
+    channelName: string;
+    channelConfig: ChannelConfig;
+    defaults: AppDefaults;
+}
+interface FeishuInboundMessage {
+    chatId: string;
+    chatType: "p2p" | "group";
+    messageId: string;
+    text: string;
+    mentionedBot?: boolean;
+    raw?: unknown;
+}
+
+export type { AgentAdapter, AgentConfig, AgentInputEvent, AgentModule, AgentOutputEvent, AppConfig, AppDefaults, ChannelConfig, ChannelRunner, ClientConfig, ClientInputEvent, ClientModule, ClientOutputEvent, ConfigAdapter, ConfigCollectContext, ConfigInputOptions, ConfigSelectOption, FeishuClientConfig, FeishuInboundMessage, GatewayCoreOptions, IMAdapter, LegacyAgentInputEvent, OutboundAttachment, PiCodingAgentConfig, RunChannelOptions, SessionBindingStore };

package/dist/index.js

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/media-prompt.js

@@ -0,0 +1,13 @@
+// src/modules/agent/pi-coding-agent/adapter/media-prompt.ts
+var MEDIA_CONVENTION_PROMPT = `When you want to send a local image or file to the user in this chat, include a line containing \`MEDIA:<absolute_path>\` in your reply (the path must point to a file that actually exists on disk). You can put it inline in a sentence or on its own line. Do not use this for files the user should not receive (e.g. credentials, temp scratch files unrelated to the request).`;
+function media_prompt_default(pi) {
+  pi.on("before_agent_start", (event) => ({
+    systemPrompt: `${event.systemPrompt}
+
+${MEDIA_CONVENTION_PROMPT}`
+  }));
+}
+export {
+  MEDIA_CONVENTION_PROMPT,
+  media_prompt_default as default
+};

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@hopgoldy/agent-bridge",
+  "version": "0.1.1",
+  "private": false,
+  "description": "IM to Pi bridge with dual-adapter architecture",
+  "keywords": [
+    "im",
+    "bridge",
+    "feishu",
+    "pi",
+    "cli"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/HoPGoldy/agent-bridge"
+  },
+  "bugs": {
+    "url": "https://github.com/HoPGoldy/agent-bridge/issues"
+  },
+  "homepage": "https://github.com/HoPGoldy/agent-bridge#readme",
+  "type": "module",
+  "bin": {
+    "agent-bridge": "./dist/agent-bridge.js"
+  },
+  "main": "./dist/cli.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.7.0",
+    "@larksuiteoapi/node-sdk": "^1.64.0",
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "@vitest/coverage-v8": "^3.2.7",
+    "commit-and-tag-version": "^12.7.3",
+    "cross-env": "^10.0.0",
+    "tsup": "^8.5.1",
+    "tsx": "^4.20.4",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "npm run build",
+    "dev": "cross-env NODE_ENV=development tsx bin/agent-bridge.ts",
+    "test": "vitest run --passWithNoTests",
+    "test:coverage": "vitest run --coverage",
+    "start": "node ./dist/agent-bridge.js",
+    "release": "commit-and-tag-version && git push --follow-tags origin main"
+  }
+}