@graychennpm/codebridge 0.0.0-stage → 0.1.0

package/node_modules/@codebridge/core/dist/types.d.ts

@@ -0,0 +1,363 @@
+/** 唯一标识一次「飞书对话面」 */
+export interface SessionKey {
+    chatId: string;
+    topicId?: string;
+    backendId: string;
+    cwd: string;
+}
+export interface LocalMediaPath {
+    path: string;
+    mimeType?: string;
+    name?: string;
+}
+/** Bridge → Runner：附件以 base64 传输，Runner 落盘后再交给 Agent */
+export interface RunAttachment {
+    name: string;
+    mimeType: string;
+    dataBase64: string;
+}
+export interface RunRequest {
+    runId: string;
+    sessionKey: SessionKey;
+    prompt: string;
+    attachments?: RunAttachment[];
+    resumeSessionId?: string;
+    model?: string;
+    effort?: string;
+    mode?: string;
+    claudePermissionMode?: ClaudePermissionMode;
+    additionalDirectories?: string[];
+    acpConfig?: Record<string, string | boolean>;
+}
+export type RunStatus = "queued" | "running" | "done" | "failed" | "stopped";
+export type AgentMessagePhase = "commentary" | "final_answer";
+export interface ActiveRunStatus {
+    runId: string;
+    startedAt: number;
+    lastActivityAt: number;
+    currentPhase: string;
+    lastCheckpoint?: string;
+}
+export interface RunState {
+    runId: string;
+    status: RunStatus;
+    startedAt: string;
+    error?: string;
+    sessionKey?: SessionKey;
+    prompt?: string;
+}
+export interface AgentPlanEntry {
+    content: string;
+    priority: "high" | "medium" | "low";
+    status: "pending" | "in_progress" | "completed";
+}
+export interface AgentToolLocation {
+    path: string;
+    line?: number | null;
+}
+export interface AgentAvailableCommand {
+    name: string;
+    description: string;
+    input?: {
+        hint: string;
+    } | null;
+}
+export type AgentEvent = {
+    type: "text_delta";
+    text: string;
+    blockId?: string;
+    messageId?: string;
+    phase?: AgentMessagePhase;
+} | {
+    type: "thought_delta";
+    text: string;
+    blockId?: string;
+    messageId?: string;
+} | {
+    type: "tool_start";
+    toolCallId?: string;
+    name: string;
+    sideEffects?: boolean;
+    kind?: string;
+    status?: string;
+    input?: unknown;
+    content?: unknown[];
+    locations?: AgentToolLocation[];
+} | {
+    type: "tool_update";
+    toolCallId: string;
+    name?: string;
+    sideEffects?: boolean;
+    status?: string;
+    content?: unknown[];
+    locations?: AgentToolLocation[];
+    output?: unknown;
+} | {
+    type: "tool_end";
+    toolCallId?: string;
+    name?: string;
+    sideEffects?: boolean;
+    status?: string;
+    content?: unknown[];
+    locations?: AgentToolLocation[];
+    output?: unknown;
+} | {
+    type: "plan";
+    entries: AgentPlanEntry[];
+} | {
+    type: "plan_update";
+    plan: unknown;
+} | {
+    type: "plan_removed";
+    planId: string;
+} | {
+    type: "available_commands_update";
+    availableCommands: AgentAvailableCommand[];
+} | {
+    type: "current_mode_update";
+    currentModeId: string;
+} | {
+    type: "config_option_update";
+    configOptions: BackendConfigOption[];
+} | {
+    type: "session_info_update";
+    title?: string | null;
+    updatedAt?: string | null;
+} | {
+    type: "usage_update";
+    used: number;
+    size: number;
+    cost?: {
+        amount: number;
+        currency: string;
+    } | null;
+} | {
+    type: "session";
+    sessionId: string;
+} | {
+    type: "error";
+    message: string;
+    fatal?: boolean;
+}
+/** prompt_feishu 权限模式：agent 请求权限，等待用户 /approve 或 /deny */
+ | {
+    type: "permission_request";
+    requestId: string;
+    title: string;
+} | {
+    type: "done";
+    exitCode: number;
+}
+/** 请求的 model 未被 ACP 适配器采纳、实际以 effective 落地（见 applySessionConfigOptions） */
+ | {
+    type: "model_resolved";
+    requested: string;
+    effective?: string;
+    effectiveName?: string;
+};
+export interface ChannelRuntimeApproval {
+    id: string;
+    runId: string;
+    stepId: string | null;
+    capabilityId: string | null;
+    status: "requested" | "granted" | "revoked" | "expired" | string;
+    environment: string | null;
+    targetResource: string | null;
+    expiresAt: string | null;
+}
+export interface ChannelSessionMessage {
+    channel: string;
+    conversationId: string;
+    message: string;
+    agentId?: string;
+    cwd?: string;
+    model?: string;
+    inputs?: Record<string, unknown>;
+    actorRef?: {
+        channel: "feishu" | "telegram";
+        id: string;
+    };
+    attachments?: RunAttachment[];
+    idempotencyKey?: string;
+    signal?: AbortSignal;
+    /** 槽位 generation（/new 递增）；缺省 0 */
+    generation?: number;
+    /** 回复锚点：需要回复到的渠道消息 id */
+    replyToMessageId?: string;
+    /** 本次 Delivery 是否展示思考/工具过程；必须与 replyToMessageId 成对提供。 */
+    showThinking?: boolean;
+}
+export interface ChannelSlot {
+    channel: string;
+    conversationId: string;
+    agentId: string;
+    workspaceKey: string;
+    generation: number;
+}
+export interface ChannelSubmitReceipt {
+    sessionId: string;
+    turnId: string;
+    runId: string | null;
+    acceptance: "dispatched" | "queued";
+    queueState: "ready" | "paused";
+    eventSequence: number;
+}
+export interface ChannelCommandContext {
+    sessionId: string | null;
+    activeRunId: string | null;
+    /** Catalog / runtime 上当前槽位绑定的 ACP provider session；未学到则为 null。 */
+    providerSessionId: string | null;
+    /** Last activity of the bound session, read before the incoming message bumps it. */
+    lastActivityAt?: string | null;
+    /** Latest ACP usage_update for the session: context tokens in use and the model window. */
+    contextUsed?: number | null;
+    contextSize?: number | null;
+    /** First usage_update of the session: a resumed or prompt-heavy session already starts large. */
+    contextFirstUsed?: number | null;
+    queuedTurns?: number;
+}
+export interface ChannelSessionEvent {
+    type: string;
+    sequence: number;
+    runId: string | null;
+    executionKind: "agent" | "flow" | null;
+    occurredAt: string | null;
+    target: string | null;
+    resultRef: string | null;
+    payload: Record<string, unknown>;
+}
+export type ChannelDeliveryStatus = "pending" | "dispatched" | "delivering" | "completed";
+export type ChannelRuntimeRunStatus = "queued" | "running" | "waiting" | "succeeded" | "failed" | "cancelled" | "interrupted";
+export interface ChannelDeliveryRunSnapshot {
+    status: ChannelRuntimeRunStatus;
+    createdAt: string;
+    updatedAt: string;
+    leaseExpiresAt: string | null;
+    terminalReason: string | null;
+    sessionActiveRunId: string | null;
+    sessionQueueState: "ready" | "paused";
+}
+export interface ChannelDeliveryInput {
+    channel: string;
+    conversationId: string;
+    replyToMessageId: string;
+    showThinking: boolean;
+}
+export interface ChannelDeliveryRow {
+    turnId: string;
+    sessionId: string;
+    channel: string;
+    conversationId: string;
+    replyToMessageId: string;
+    showThinking: boolean;
+    surfaceMessageId: string | null;
+    /** Feishu CardKit instance id; distinct from the IM message id. */
+    surfaceCardId: string | null;
+    claimOwner: string | null;
+    claimExpiresAt: string | null;
+    acceptedSequence: number;
+    runId: string | null;
+    runTerminalAt: string | null;
+    status: ChannelDeliveryStatus;
+    createdAt: string;
+    updatedAt: string;
+    runSnapshot: ChannelDeliveryRunSnapshot | null;
+}
+export interface ChannelSessionIngress {
+    submit(message: ChannelSessionMessage): Promise<ChannelSubmitReceipt>;
+    listRuntimeApprovals?(runId: string): Promise<ChannelRuntimeApproval[]>;
+    resolveRuntimeApproval?(runId: string, approvalId: string, decision: "approve" | "reject"): Promise<ChannelRuntimeApproval>;
+    events(sessionId: string, opts: {
+        afterSequence: number;
+        signal: AbortSignal;
+    }): AsyncGenerator<ChannelSessionEvent>;
+    replayEvents?(sessionId: string, opts: {
+        afterSequence: number;
+    }): Promise<ChannelSessionEvent[]>;
+    listDeliveries(channel: string, surfaceMessageId?: string): Promise<ChannelDeliveryRow[]>;
+    claimDelivery(turnId: string, owner: string): Promise<boolean>;
+    ackDelivery(turnId: string, owner: string, surfaceMessageId: string, surfaceCardId?: string): Promise<boolean>;
+    completeDelivery(turnId: string, owner: string): Promise<boolean>;
+    getSlotCommandContext(slot: ChannelSlot): Promise<ChannelCommandContext>;
+    /** Task 10：将 Provider Session 绑定到槽位（幂等 + Lease 预检 + 原子建绑） */
+    resumeProviderSession(slot: ChannelSlot, providerSessionId: string): Promise<{
+        sessionId: string;
+    }>;
+    cancelRun(sessionId: string, runId: string): Promise<boolean>;
+    /** /steer：按 runId 向 Runner 注入补充指令（不打 orchestrator 内存表）。 */
+    steerRun(runId: string, prompt: string): Promise<{
+        ok: boolean;
+        outcome?: string;
+        error?: string;
+    }>;
+    resolvePermission(runId: string, approve: boolean): Promise<boolean>;
+    resumeQueue(sessionId: string, commandId: string): Promise<{
+        queueState: "ready" | "paused";
+    }>;
+    resetSlot(slot: ChannelSlot): Promise<boolean>;
+}
+export interface DoctorResult {
+    ok: boolean;
+    checks: Array<{
+        name: string;
+        ok: boolean;
+        message?: string;
+    }>;
+}
+export interface RunContext {
+    runId: string;
+    cwd: string;
+    prompt: string;
+    attachments?: LocalMediaPath[];
+    resumeSessionId?: string;
+    backendConfig: BackendProfile;
+    model?: string;
+    effort?: string;
+    mode?: string;
+    claudePermissionMode?: ClaudePermissionMode;
+    additionalDirectories?: string[];
+    acpConfig?: Record<string, string | boolean>;
+    mcpServers?: import("./mcp-types.js").StdioMcpServerConfig[];
+    /** 注入 Agent 子进程的额外环境变量（如 FCB_* 出站 API 凭据） */
+    extraEnv?: Record<string, string>;
+}
+export type ClaudePermissionMode = "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan";
+export type AcpPermissionPolicy = "auto_allow" | "prompt_deny"
+/** 危险操作在飞书里等 /approve；超时自动拒绝 */
+ | "prompt_feishu";
+/** ACP 适配器 advertise 的会话配置项里的一个可选值（select 分组已展平） */
+export interface BackendConfigOptionValue {
+    value: string;
+    name?: string;
+    description?: string;
+}
+/**
+ * ACP 适配器 advertise 的一个会话配置项（session/new 响应 configOptions 的精简形态）。
+ * category: "model" | "thought_level" | "mode" 等；/model 动态列表取 category === "model"。
+ */
+export interface BackendConfigOption {
+    id: string;
+    name: string;
+    type?: "select" | "boolean";
+    category?: string;
+    /** 适配器当前默认选中的值 */
+    currentValue?: string;
+    values: BackendConfigOptionValue[];
+}
+export interface BackendProfile {
+    type: "cursor-cli" | "claude-code" | "codex" | "generic-spawn" | "pi-sdk";
+    /** ACP spawn 命令；仅 ACP profiles 使用，pi-sdk 由 Node SDK 直接创建 */
+    acpCommand?: string;
+    acpArgs?: string[];
+    model?: string;
+    effort?: string;
+    /** Claude ACP mode 的兼容默认值；飞书非交互场景建议 bypassPermissions */
+    claudePermissionMode?: ClaudePermissionMode;
+    /** true 时，若适配器未 advertise 想要的 model，本轮直接失败而非静默用适配器默认；默认 false */
+    strictModel?: boolean;
+}
+export declare function serializeSessionKey(key: SessionKey): string;
+export declare function parseSessionKey(raw: string): SessionKey;
+export declare const DEFAULT_DATA_DIR: string;
+export declare const VERSION: string;
+//# sourceMappingURL=types.d.ts.map

package/node_modules/@codebridge/core/dist/types.js

@@ -0,0 +1,22 @@
+import { readFileSync } from "node:fs";
+export function serializeSessionKey(key) {
+    const cwd = key.cwd.replace(/\\/g, "/");
+    const topic = key.topicId ?? "";
+    return `${key.chatId}|${topic}|${key.backendId}|${cwd}`;
+}
+export function parseSessionKey(raw) {
+    const parts = raw.split("|");
+    if (parts.length < 4) {
+        throw new Error(`Invalid session key: ${raw}`);
+    }
+    const [chatId, topicId, backendId, ...cwdParts] = parts;
+    return {
+        chatId: chatId,
+        topicId: topicId || undefined,
+        backendId: backendId,
+        cwd: cwdParts.join("|"),
+    };
+}
+export const DEFAULT_DATA_DIR = `${process.env.HOME ?? ""}/.codebridge`;
+export const VERSION = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
+//# sourceMappingURL=types.js.map

package/node_modules/@codebridge/core/dist/workspace-key.d.ts

@@ -0,0 +1,11 @@
+export interface WorkspaceKeyResult {
+    key: string;
+    diagnostic?: string;
+}
+/**
+ * 规范化工作目录为稳定的槽位键。
+ * - 成功：realpath 解析符号链接，去尾部斜杠；
+ * - 失败（目录已删等）：回退到 path.resolve 规范化绝对路径，并记录诊断，不抛错。
+ */
+export declare function canonicalWorkspaceKey(cwd: string): WorkspaceKeyResult;
+//# sourceMappingURL=workspace-key.d.ts.map

package/node_modules/@codebridge/core/dist/workspace-key.js

@@ -0,0 +1,25 @@
+import fs from "node:fs";
+import path from "node:path";
+function stripTrailingSlashes(value) {
+    const stripped = value.replace(/[\\/]+$/, "");
+    // 保留文件系统根（"/" 或 "C:\"）不被剥成空串
+    return stripped === "" ? value : stripped;
+}
+/**
+ * 规范化工作目录为稳定的槽位键。
+ * - 成功：realpath 解析符号链接，去尾部斜杠；
+ * - 失败（目录已删等）：回退到 path.resolve 规范化绝对路径，并记录诊断，不抛错。
+ */
+export function canonicalWorkspaceKey(cwd) {
+    const normalized = path.resolve(cwd);
+    try {
+        return { key: stripTrailingSlashes(fs.realpathSync(normalized)) };
+    }
+    catch (error) {
+        return {
+            key: stripTrailingSlashes(normalized),
+            diagnostic: `workspace realpath failed (${error instanceof Error ? error.message : String(error)}), falling back to resolved path`,
+        };
+    }
+}
+//# sourceMappingURL=workspace-key.js.map

package/node_modules/@codebridge/core/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@codebridge/core",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./session-event-wire": {
+      "types": "./dist/session-event-wire.d.ts",
+      "import": "./dist/session-event-wire.js"
+    }
+  },
+  "license": "MIT",
+  "dependencies": {
+    "yaml": "2.9.0",
+    "zod": "3.25.76"
+  }
+}