@opentag/lark 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Amplift
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,39 @@
+# @opentag/lark
+
+Lark / Feishu adapter helpers for OpenTag.
+
+Use this package to receive Lark Personal Agent messages, normalize them into OpenTag events, register a Personal Agent by QR scan, and send local replies through the OpenTag dispatcher.
+
+## Install
+
+```bash
+pnpm add @opentag/lark
+```
+
+## Exports
+
+- `createLarkMessageHandler`: handles `im.message.receive_v1` events.
+- `startLarkIngress`: starts a Lark long-connection ingress.
+- `registerLarkPersonalAgent`: creates a Personal Agent registration flow.
+- `normalizeLarkMessage`: converts Lark messages into `OpenTagEvent` objects.
+- `renderLarkFinalResult`: renders OpenTag run results for Lark.
+
+## Example
+
+```ts
+import { startLarkIngress } from "@opentag/lark";
+
+const ingress = startLarkIngress({
+  appId: process.env.LARK_APP_ID!,
+  appSecret: process.env.LARK_APP_SECRET!,
+  domain: "lark",
+  dispatcherUrl: "http://localhost:3030",
+  agentId: "opentag"
+});
+
+await ingress.startPromise;
+```
+
+## Stability
+
+The event normalization and ingress config shapes are public adapter contracts. Add optional fields instead of changing existing required fields.

package/dist/inbound.d.ts

@@ -0,0 +1,73 @@
+import { type OpenTagEvent } from "@opentag/core";
+import type { CreateRunResult } from "@opentag/client";
+import { type LarkChannelBinding } from "./normalize.js";
+export type LarkMention = {
+    key?: string;
+    id?: {
+        open_id?: string;
+    };
+    name?: string;
+};
+export type LarkInboundMessageEvent = {
+    event_id?: string;
+    event_type?: string;
+    create_time?: string;
+    tenant_key?: string;
+    app_id?: string;
+    sender?: {
+        sender_id?: {
+            open_id?: string;
+            user_id?: string;
+            union_id?: string;
+        };
+        sender_type?: string;
+        tenant_key?: string;
+    };
+    message?: {
+        message_id?: string;
+        root_id?: string;
+        parent_id?: string;
+        chat_id?: string;
+        chat_type?: string;
+        message_type?: string;
+        content?: string;
+        mentions?: LarkMention[];
+    };
+};
+export type LarkMessageHandlerConfig = {
+    agentId: string;
+    botOpenId?: string;
+    callbackUri?: string;
+    defaultRepoBinding?: {
+        repoProvider: string;
+        owner: string;
+        repo: string;
+    };
+    resolveChannelBinding(input: {
+        tenantKey: string;
+        chatId: string;
+    }): Promise<LarkChannelBinding | null>;
+    createRun(event: OpenTagEvent): Promise<CreateRunResult>;
+    bindChannel?(input: {
+        tenantKey: string;
+        chatId: string;
+        repoProvider: string;
+        owner: string;
+        repo: string;
+    }): Promise<void>;
+    reply?(input: {
+        messageId: string;
+        text: string;
+    }): Promise<void>;
+    now?(): number;
+};
+export type LarkMessageHandlerOutcome = {
+    status: "created" | "bound" | "ignored_non_text" | "ignored_invalid_payload" | "ignored_group_requires_bot_open_id" | "ignored_not_addressed" | "ignored_bind_usage" | "ignored_bind_unavailable" | "ignored_unbound_chat" | "ignored_empty_command" | "follow_up_queued" | "needs_human_decision";
+    runId?: string;
+    followUpRequestId?: string;
+    reason?: string;
+    tenantKey?: string;
+    chatId?: string;
+};
+export declare function createLarkMessageHandler(config: LarkMessageHandlerConfig): (data: LarkInboundMessageEvent) => Promise<LarkMessageHandlerOutcome>;
+//# sourceMappingURL=inbound.d.ts.map

package/dist/inbound.d.ts.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./normalize.js";
+export * from "./inbound.js";
+export * from "./ingress.js";
+export * from "./outbound.js";
+export * from "./registration.js";
+export * from "./render.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,640 @@
+// src/normalize.ts
+import { commandFromRawText } from "@opentag/core";
+function stripLarkMention(text) {
+  return text.replace(/@_user_\d+/g, " ").replace(/\s+/g, " ").trim();
+}
+function encodeLarkThreadKey(input) {
+  return `${input.tenantKey}|${input.chatId}|${input.messageId}`;
+}
+function parseLarkThreadKey(threadKey) {
+  const [tenantKey, chatId, messageId] = threadKey.split("|");
+  if (!tenantKey || !chatId || !messageId) {
+    throw new Error(`Invalid Lark thread key: ${threadKey}`);
+  }
+  return { tenantKey, chatId, messageId };
+}
+function permissionsForIntent(intent) {
+  const permissions = [
+    {
+      scope: "chat:postMessage",
+      reason: "reply in the originating Lark thread"
+    },
+    {
+      scope: "runner:local",
+      reason: "execute the run on a paired local daemon"
+    }
+  ];
+  if (intent === "fix" || intent === "run") {
+    permissions.push(
+      {
+        scope: "repo:read",
+        reason: "inspect the repository in the paired local checkout"
+      },
+      {
+        scope: "repo:write",
+        reason: "commit code changes on an isolated run branch"
+      },
+      {
+        scope: "pr:create",
+        reason: "open a pull request for completed code changes"
+      }
+    );
+  }
+  return permissions;
+}
+function contextPointersForCommand(command) {
+  const context = [];
+  for (const reference of command.parsed?.references ?? []) {
+    if (reference.kind === "url") {
+      context.push({
+        kind: "url",
+        uri: reference.uri,
+        visibility: "organization",
+        title: reference.title ?? "Command URL reference"
+      });
+      continue;
+    }
+    if (reference.kind === "file" || reference.kind === "path") {
+      context.push({
+        kind: "file",
+        uri: reference.uri,
+        ...reference.line ? { line: reference.line } : {},
+        ...reference.startLine ? { startLine: reference.startLine } : {},
+        ...reference.endLine ? { endLine: reference.endLine } : {},
+        visibility: "organization",
+        title: referenceTitle(reference)
+      });
+    }
+  }
+  return context;
+}
+function referenceTitle(reference) {
+  return reference.title ?? "Command file reference";
+}
+function commandMetadata(command) {
+  if (!command.parsed) return {};
+  return {
+    commandParser: command.parsed.version,
+    commandDiagnostics: command.parsed.diagnostics,
+    ...command.parsed.approval ? { approval: command.parsed.approval } : {},
+    ...command.parsed.network ? { network: command.parsed.network } : {}
+  };
+}
+function normalizeLarkMessage(input) {
+  const rawText = stripLarkMention(input.text);
+  if (!rawText) return null;
+  const command = commandFromRawText(rawText);
+  const agentId = input.agentId ?? "opentag";
+  return {
+    id: `evt_lark_message_${input.eventId}`,
+    source: "lark",
+    sourceEventId: input.eventId,
+    receivedAt: new Date(input.eventTimeMs).toISOString(),
+    actor: {
+      provider: "lark",
+      providerUserId: input.senderOpenId,
+      handle: input.senderOpenId,
+      organizationId: input.tenantKey
+    },
+    target: {
+      mention: input.botOpenId ? `@${input.botOpenId}` : "@app",
+      agentId,
+      ...command.parsed?.executorHint ? { executorHint: command.parsed.executorHint } : {}
+    },
+    command,
+    context: [
+      {
+        provider: "lark",
+        kind: "message",
+        uri: `lark://tenant/${input.tenantKey}/chat/${input.chatId}/message/${input.messageId}`,
+        visibility: "organization",
+        title: "Lark message"
+      },
+      {
+        kind: "text",
+        uri: input.text,
+        visibility: "organization",
+        title: "Lark message text"
+      },
+      ...contextPointersForCommand(command)
+    ],
+    permissions: permissionsForIntent(command.intent),
+    callback: {
+      provider: "lark",
+      uri: input.callbackUri ?? "lark://im/v1/messages",
+      threadKey: encodeLarkThreadKey({
+        tenantKey: input.tenantKey,
+        chatId: input.chatId,
+        messageId: input.messageId
+      })
+    },
+    metadata: {
+      tenantKey: input.tenantKey,
+      chatId: input.chatId,
+      messageId: input.messageId,
+      chatType: input.chatType,
+      ...input.rootId ? { rootId: input.rootId } : {},
+      ...input.botOpenId ? { larkBotOpenId: input.botOpenId } : {},
+      ...commandMetadata(command),
+      repoProvider: input.binding.repoProvider ?? "github",
+      owner: input.binding.owner,
+      repo: input.binding.repo
+    }
+  };
+}
+
+// src/inbound.ts
+import { parseProjectTargetRef } from "@opentag/core";
+var BIND_USAGE = "Usage: /bind <owner>/<repo> \u2014 e.g. /bind amplifthq/opentag (or /bind github:amplifthq/opentag).";
+var UNBOUND_HINT = "This chat isn't connected to a Project Target yet. @-mention me with `/bind <owner>/<repo>` to connect it \u2014 e.g. /bind amplifthq/opentag.";
+function bindingFromDefault(input) {
+  return {
+    tenantKey: input.tenantKey,
+    chatId: input.chatId,
+    repoProvider: input.binding.repoProvider,
+    owner: input.binding.owner,
+    repo: input.binding.repo
+  };
+}
+function shouldMigrateLegacyLocalBinding(input) {
+  return input.defaultBinding.repoProvider === "local" && input.defaultBinding.owner.startsWith("path_") && input.existing.repoProvider === "local" && input.existing.owner === "local" && input.existing.repo === input.defaultBinding.repo;
+}
+function extractText(content) {
+  if (!content) return "";
+  try {
+    const parsed = JSON.parse(content);
+    return typeof parsed.text === "string" ? parsed.text : "";
+  } catch {
+    return "";
+  }
+}
+function mentionsBot(mentions, botOpenId) {
+  return (mentions ?? []).some((mention) => mention.id?.open_id === botOpenId);
+}
+function parseBindCommand(command) {
+  if (!/^\/bind(\s|$)/.test(command)) return null;
+  const match = command.match(/^\/bind\s+(\S+)\s*$/);
+  if (!match) return { ok: false };
+  try {
+    const ref = parseProjectTargetRef(match[1]);
+    return { ok: true, repoProvider: ref.provider, owner: ref.owner, repo: ref.repo };
+  } catch {
+    return { ok: false };
+  }
+}
+function createLarkMessageHandler(config) {
+  return async function handleLarkMessage(data) {
+    const message = data.message;
+    if (!message || message.message_type !== "text") {
+      return { status: "ignored_non_text" };
+    }
+    const tenantKey = data.tenant_key ?? data.sender?.tenant_key;
+    const chatId = message.chat_id;
+    const messageId = message.message_id;
+    const eventId = data.event_id;
+    const senderOpenId = data.sender?.sender_id?.open_id;
+    if (!tenantKey || !chatId || !messageId || !eventId || !senderOpenId) {
+      return { status: "ignored_invalid_payload" };
+    }
+    const isDirect = message.chat_type === "p2p";
+    if (!isDirect) {
+      if (!config.botOpenId) {
+        return { status: "ignored_group_requires_bot_open_id", tenantKey, chatId };
+      }
+      if (!mentionsBot(message.mentions, config.botOpenId)) {
+        return { status: "ignored_not_addressed", tenantKey, chatId };
+      }
+    }
+    const command = stripLarkMention(extractText(message.content));
+    const bindRequest = parseBindCommand(command);
+    if (bindRequest && !config.bindChannel) {
+      return { status: "ignored_bind_unavailable", tenantKey, chatId };
+    }
+    if (bindRequest && config.bindChannel) {
+      if (!bindRequest.ok) {
+        await config.reply?.({ messageId, text: BIND_USAGE });
+        return { status: "ignored_bind_usage", tenantKey, chatId };
+      }
+      await config.bindChannel({
+        tenantKey,
+        chatId,
+        repoProvider: bindRequest.repoProvider,
+        owner: bindRequest.owner,
+        repo: bindRequest.repo
+      });
+      await config.reply?.({
+        messageId,
+        text: `Connected this chat to Project Target ${bindRequest.repoProvider}:${bindRequest.owner}/${bindRequest.repo}. @-mention me with a task to start a run.`
+      });
+      return { status: "bound", tenantKey, chatId };
+    }
+    if (command.trim().length === 0) {
+      return { status: "ignored_empty_command", tenantKey, chatId };
+    }
+    let binding = await config.resolveChannelBinding({ tenantKey, chatId });
+    if (binding && config.defaultRepoBinding && config.bindChannel) {
+      if (shouldMigrateLegacyLocalBinding({ existing: binding, defaultBinding: config.defaultRepoBinding })) {
+        await config.bindChannel({
+          tenantKey,
+          chatId,
+          repoProvider: config.defaultRepoBinding.repoProvider,
+          owner: config.defaultRepoBinding.owner,
+          repo: config.defaultRepoBinding.repo
+        });
+        binding = bindingFromDefault({ tenantKey, chatId, binding: config.defaultRepoBinding });
+      }
+    }
+    if (!binding) {
+      if (config.defaultRepoBinding && config.bindChannel) {
+        await config.bindChannel({
+          tenantKey,
+          chatId,
+          repoProvider: config.defaultRepoBinding.repoProvider,
+          owner: config.defaultRepoBinding.owner,
+          repo: config.defaultRepoBinding.repo
+        });
+        binding = bindingFromDefault({ tenantKey, chatId, binding: config.defaultRepoBinding });
+      } else {
+        await config.reply?.({ messageId, text: UNBOUND_HINT });
+        return { status: "ignored_unbound_chat", tenantKey, chatId };
+      }
+    }
+    const parsedTime = data.create_time ? Number(data.create_time) : Number.NaN;
+    const eventTimeMs = Number.isFinite(parsedTime) ? parsedTime : config.now?.() ?? Date.now();
+    const event = normalizeLarkMessage({
+      tenantKey,
+      chatId,
+      chatType: message.chat_type ?? "group",
+      senderOpenId,
+      text: extractText(message.content),
+      messageId,
+      ...message.root_id ? { rootId: message.root_id } : {},
+      eventId,
+      eventTimeMs,
+      agentId: config.agentId,
+      ...config.botOpenId ? { botOpenId: config.botOpenId } : {},
+      ...config.callbackUri ? { callbackUri: config.callbackUri } : {},
+      binding
+    });
+    if (!event) {
+      return { status: "ignored_empty_command" };
+    }
+    const result = await config.createRun(event);
+    if (result.outcome === "run_created") {
+      return { status: "created", runId: result.run.id, tenantKey, chatId };
+    }
+    if (result.outcome === "follow_up_queued") {
+      return {
+        status: "follow_up_queued",
+        followUpRequestId: result.followUpRequest.id,
+        ...result.decision.activeRunId ? { runId: result.decision.activeRunId } : {},
+        reason: result.decision.reason,
+        tenantKey,
+        chatId
+      };
+    }
+    return {
+      status: "needs_human_decision",
+      reason: result.decision.reason,
+      tenantKey,
+      chatId
+    };
+  };
+}
+
+// src/ingress.ts
+import { randomUUID } from "crypto";
+import * as lark2 from "@larksuiteoapi/node-sdk";
+import { createOpenTagClient } from "@opentag/client";
+import { parseProjectTargetRef as parseProjectTargetRef2 } from "@opentag/core";
+
+// src/outbound.ts
+import * as lark from "@larksuiteoapi/node-sdk";
+
+// src/render.ts
+function nextActionSummary(result) {
+  if (!result.nextAction) return void 0;
+  if (typeof result.nextAction === "string") return result.nextAction;
+  return result.nextAction.summary;
+}
+function renderLarkAcknowledgement(runId) {
+  return `I picked this up: ${runId}`;
+}
+function renderLarkFinalResult(result) {
+  const lines = [`Finished with ${result.conclusion}.`, "", result.summary];
+  if (result.verification?.length) {
+    lines.push("", "Verification");
+    for (const check of result.verification) {
+      lines.push(`- ${check.command}: ${check.outcome}`);
+    }
+  }
+  const nextAction = nextActionSummary(result);
+  if (nextAction) {
+    lines.push("", `Next action: ${nextAction}`);
+  }
+  return lines.join("\n");
+}
+function createLarkTextMessageContent(text) {
+  return JSON.stringify({ text });
+}
+
+// src/outbound.ts
+function createLarkReplyClient(input) {
+  return new lark.Client({
+    appId: input.appId,
+    appSecret: input.appSecret,
+    domain: input.domain === "feishu" ? lark.Domain.Feishu : lark.Domain.Lark
+  });
+}
+async function replyLarkMessage(client, input) {
+  await client.im.message.reply({
+    path: { message_id: input.messageId },
+    data: { content: createLarkTextMessageContent(input.text), msg_type: "text", reply_in_thread: true }
+  });
+}
+
+// src/ingress.ts
+var DEFAULT_AGENT_ID = "opentag";
+function defaultRepoBindingFromEnv(value) {
+  if (!value) return void 0;
+  try {
+    const ref = parseProjectTargetRef2(value);
+    return {
+      repoProvider: ref.provider,
+      owner: ref.owner,
+      repo: ref.repo
+    };
+  } catch {
+    throw new Error("OPENTAG_LARK_DEFAULT_REPO must be formatted as owner/repo or provider:owner/repo");
+  }
+}
+function domainFromEnv(value) {
+  const domain = value ?? "lark";
+  if (domain !== "lark" && domain !== "feishu") {
+    throw new Error("LARK_DOMAIN must be either lark or feishu");
+  }
+  return domain;
+}
+function larkIngressConfigFromEnv(env) {
+  const appId = env.LARK_APP_ID;
+  const appSecret = env.LARK_APP_SECRET;
+  const dispatcherUrl = env.OPENTAG_DISPATCHER_URL;
+  if (!appId || !appSecret) {
+    throw new Error("LARK_APP_ID and LARK_APP_SECRET are required");
+  }
+  if (!dispatcherUrl) {
+    throw new Error("OPENTAG_DISPATCHER_URL is required");
+  }
+  const defaultRepoBinding = defaultRepoBindingFromEnv(env.OPENTAG_LARK_DEFAULT_REPO);
+  return {
+    appId,
+    appSecret,
+    dispatcherUrl,
+    domain: domainFromEnv(env.LARK_DOMAIN),
+    agentId: env.OPENTAG_LARK_AGENT_ID ?? DEFAULT_AGENT_ID,
+    ...env.OPENTAG_DISPATCHER_TOKEN ? { dispatcherToken: env.OPENTAG_DISPATCHER_TOKEN } : {},
+    ...env.LARK_BOT_OPEN_ID ? { botOpenId: env.LARK_BOT_OPEN_ID } : {},
+    ...defaultRepoBinding ? { defaultRepoBinding } : {}
+  };
+}
+function createDefaultWsClient(config) {
+  return new lark2.WSClient({
+    appId: config.appId,
+    appSecret: config.appSecret,
+    domain: config.domain === "feishu" ? lark2.Domain.Feishu : lark2.Domain.Lark
+  });
+}
+function createDefaultEventDispatcher(handler) {
+  return new lark2.EventDispatcher({}).register({
+    "im.message.receive_v1": (data) => handler(data)
+  });
+}
+function logIgnored(outcome) {
+  if (outcome.status === "created" || outcome.status === "bound") return;
+  if (outcome.status === "follow_up_queued") {
+    console.log(
+      `[lark] queued follow-up${outcome.followUpRequestId ? ` follow_up_request_id=${outcome.followUpRequestId}` : ""}${outcome.runId ? ` active_run_id=${outcome.runId}` : ""}`
+    );
+    return;
+  }
+  if (outcome.status === "needs_human_decision") {
+    console.log(`[lark] needs human decision${outcome.reason ? `: ${outcome.reason}` : ""}`);
+    return;
+  }
+  if (outcome.status === "ignored_unbound_chat") {
+    console.log(
+      `[lark] ignored unbound chat - bind it: provider=lark accountId(tenant_key)=${outcome.tenantKey} conversationId(chat_id)=${outcome.chatId} (reply '/bind owner/repo' with a Project Target ref, or POST /v1/channel-bindings)`
+    );
+    return;
+  }
+  console.log(`[lark] ignored event: ${outcome.status}${outcome.chatId ? ` chat_id=${outcome.chatId}` : ""}`);
+}
+function startLarkIngress(config, dependencies = {}) {
+  const dispatcherClient = createOpenTagClient({
+    dispatcherUrl: config.dispatcherUrl,
+    ...config.dispatcherToken ? { pairingToken: config.dispatcherToken } : {}
+  });
+  let replyClient;
+  const reply = dependencies.reply ?? ((input) => {
+    replyClient ??= createLarkReplyClient({ appId: config.appId, appSecret: config.appSecret, domain: config.domain });
+    return replyLarkMessage(replyClient, input);
+  });
+  const handler = createLarkMessageHandler({
+    agentId: config.agentId,
+    ...config.botOpenId ? { botOpenId: config.botOpenId } : {},
+    ...config.defaultRepoBinding ? { defaultRepoBinding: config.defaultRepoBinding } : {},
+    async resolveChannelBinding(input) {
+      try {
+        const { binding } = await dispatcherClient.getChannelBinding({
+          provider: "lark",
+          accountId: input.tenantKey,
+          conversationId: input.chatId
+        });
+        return {
+          tenantKey: binding.accountId,
+          chatId: binding.conversationId,
+          repoProvider: binding.repoProvider,
+          owner: binding.owner,
+          repo: binding.repo
+        };
+      } catch (error) {
+        if (error instanceof Error && error.message.includes("channel_binding_not_found")) {
+          return null;
+        }
+        throw error;
+      }
+    },
+    async bindChannel(input) {
+      await dispatcherClient.bindChannel({
+        provider: "lark",
+        accountId: input.tenantKey,
+        conversationId: input.chatId,
+        repoProvider: input.repoProvider,
+        owner: input.owner,
+        repo: input.repo
+      });
+    },
+    async reply(input) {
+      await reply(input);
+    },
+    async createRun(event) {
+      const runId = `run_${randomUUID()}`;
+      return dispatcherClient.createRun({ runId, event });
+    }
+  });
+  const eventDispatcher = (dependencies.createEventDispatcher ?? createDefaultEventDispatcher)(async (data) => {
+    try {
+      (dependencies.logIgnored ?? logIgnored)(await handler(data));
+    } catch (error) {
+      console.error("[lark] failed to handle inbound message:", error);
+    }
+  });
+  const wsClient = (dependencies.createWsClient ?? createDefaultWsClient)(config);
+  return {
+    startPromise: wsClient.start({ eventDispatcher }),
+    async close() {
+      await wsClient.close?.({ force: true });
+    }
+  };
+}
+
+// src/registration.ts
+import * as lark3 from "@larksuiteoapi/node-sdk";
+var REGISTRATION_SOURCE = "opentag";
+var BOT_INFO_RETRIES = 6;
+var BOT_INFO_RETRY_DELAY_MS = 2e3;
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function accountDomainFor(domain) {
+  return domain === "feishu" ? "accounts.feishu.cn" : "accounts.larksuite.com";
+}
+function sdkDomainFor(domain) {
+  return domain === "feishu" ? lark3.Domain.Feishu : lark3.Domain.Lark;
+}
+function registrationDomainFromUserInfo(requestedDomain, userInfo) {
+  if (userInfo?.tenant_brand === "lark") return "lark";
+  if (userInfo?.tenant_brand === "feishu") return "feishu";
+  return requestedDomain;
+}
+function createDefaultBotInfoClient(input) {
+  return new lark3.Client({
+    appId: input.appId,
+    appSecret: input.appSecret,
+    domain: sdkDomainFor(input.domain)
+  });
+}
+function botInfoFromResponse(response) {
+  const value = response;
+  const bot = value.bot ?? value.data?.bot;
+  if (!bot?.open_id) {
+    return void 0;
+  }
+  return {
+    botOpenId: bot.open_id,
+    botName: bot.app_name || bot.name || "OpenTag"
+  };
+}
+async function fetchBotIdentity(input, options) {
+  const client = options.createBotInfoClient(input);
+  let lastError;
+  for (let attempt = 1; attempt <= BOT_INFO_RETRIES; attempt += 1) {
+    try {
+      const botIdentity = botInfoFromResponse(
+        await client.request({
+          url: "/open-apis/bot/v3/info",
+          method: "GET"
+        })
+      );
+      if (botIdentity) {
+        return botIdentity;
+      }
+      lastError = new Error("bot/v3/info response did not include bot.open_id.");
+    } catch (error) {
+      lastError = error;
+    }
+    if (attempt < BOT_INFO_RETRIES) {
+      await options.sleep(BOT_INFO_RETRY_DELAY_MS);
+    }
+  }
+  const reason = lastError instanceof Error ? lastError.message : String(lastError);
+  options.onWarning?.(
+    `OpenTag could not fetch the Lark bot open_id automatically. Direct chat still works. For group chat, enter the bot open_id manually. Reason: ${reason}`
+  );
+  return {};
+}
+async function registerLarkPersonalAgent(input, dependencies = {}) {
+  const requestedDomain = input.domain ?? "lark";
+  let detectedDomain;
+  const registerApp2 = dependencies.registerApp ?? lark3.registerApp;
+  const registrationOptions = {
+    // The Personal Agent registration flow starts on Feishu and switches to Lark after scan when needed.
+    domain: accountDomainFor("feishu"),
+    larkDomain: accountDomainFor("lark"),
+    source: REGISTRATION_SOURCE,
+    createOnly: true,
+    appPreset: {
+      name: "OpenTag {user}",
+      desc: "Wake your local OpenTag agent from Lark."
+    },
+    addons: {
+      scopes: {
+        tenant: ["im:message:send_as_bot", "im:message.p2p_msg:readonly", "im:message.group_msg:readonly", "im:chat:readonly"]
+      },
+      events: {
+        items: {
+          tenant: ["im.message.receive_v1"]
+        }
+      }
+    },
+    onQRCodeReady: input.onQrCode,
+    onStatusChange(info) {
+      if (info.status === "domain_switched") {
+        detectedDomain = "lark";
+      }
+      input.onStatus?.(info);
+    }
+  };
+  const registration = await registerApp2({
+    ...registrationOptions,
+    ...input.signal ? { signal: input.signal } : {}
+  });
+  const domain = detectedDomain ?? registrationDomainFromUserInfo(requestedDomain, registration.user_info);
+  const botIdentity = await fetchBotIdentity(
+    {
+      appId: registration.client_id,
+      appSecret: registration.client_secret,
+      domain
+    },
+    {
+      createBotInfoClient: dependencies.createBotInfoClient ?? createDefaultBotInfoClient,
+      sleep: dependencies.sleep ?? sleep,
+      ...input.onWarning ? { onWarning: input.onWarning } : {}
+    }
+  );
+  return {
+    appId: registration.client_id,
+    appSecret: registration.client_secret,
+    domain,
+    ...registration.user_info?.open_id ? { operatorOpenId: registration.user_info.open_id } : {},
+    ...botIdentity.botOpenId ? { botOpenId: botIdentity.botOpenId } : {},
+    ...botIdentity.botName ? { botName: botIdentity.botName } : {}
+  };
+}
+export {
+  DEFAULT_AGENT_ID,
+  createLarkMessageHandler,
+  createLarkReplyClient,
+  createLarkTextMessageContent,
+  encodeLarkThreadKey,
+  larkIngressConfigFromEnv,
+  normalizeLarkMessage,
+  parseLarkThreadKey,
+  registerLarkPersonalAgent,
+  renderLarkAcknowledgement,
+  renderLarkFinalResult,
+  replyLarkMessage,
+  startLarkIngress,
+  stripLarkMention
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/normalize.ts","../src/inbound.ts","../src/ingress.ts","../src/outbound.ts","../src/render.ts","../src/registration.ts"],"sourcesContent":["import { commandFromRawText, type ContextPointer, type OpenTagCommand, type OpenTagEvent, type PermissionGrant } from \"@opentag/core\";\n\nexport type LarkChannelBinding = {\n  tenantKey: string;\n  chatId: string;\n  repoProvider?: string;\n  owner: string;\n  repo: string;\n};\n\nexport type LarkMessageInput = {\n  tenantKey: string;\n  chatId: string;\n  chatType: string;\n  senderOpenId: string;\n  text: string;\n  messageId: string;\n  rootId?: string;\n  eventId: string;\n  eventTimeMs: number;\n  agentId?: string;\n  botOpenId?: string;\n  callbackUri?: string;\n  binding: LarkChannelBinding;\n};\n\n// Strip `@_user_N` mention placeholders (whole \\d+ index) and collapse whitespace.\nexport function stripLarkMention(text: string): string {\n  return text\n    .replace(/@_user_\\d+/g, \" \")\n    .replace(/\\s+/g, \" \")\n    .trim();\n}\n\nexport function encodeLarkThreadKey(input: { tenantKey: string; chatId: string; messageId: string }): string {\n  return `${input.tenantKey}|${input.chatId}|${input.messageId}`;\n}\n\nexport function parseLarkThreadKey(threadKey: string): { tenantKey: string; chatId: string; messageId: string } {\n  const [tenantKey, chatId, messageId] = threadKey.split(\"|\");\n  if (!tenantKey || !chatId || !messageId) {\n    throw new Error(`Invalid Lark thread key: ${threadKey}`);\n  }\n  return { tenantKey, chatId, messageId };\n}\n\nfunction permissionsForIntent(intent: OpenTagCommand[\"intent\"]): PermissionGrant[] {\n  const permissions: PermissionGrant[] = [\n    {\n      scope: \"chat:postMessage\",\n      reason: \"reply in the originating Lark thread\"\n    },\n    {\n      scope: \"runner:local\",\n      reason: \"execute the run on a paired local daemon\"\n    }\n  ];\n\n  if (intent === \"fix\" || intent === \"run\") {\n    permissions.push(\n      {\n        scope: \"repo:read\",\n        reason: \"inspect the repository in the paired local checkout\"\n      },\n      {\n        scope: \"repo:write\",\n        reason: \"commit code changes on an isolated run branch\"\n      },\n      {\n        scope: \"pr:create\",\n        reason: \"open a pull request for completed code changes\"\n      }\n    );\n  }\n\n  return permissions;\n}\n\nfunction contextPointersForCommand(command: OpenTagCommand): ContextPointer[] {\n  const context: ContextPointer[] = [];\n\n  for (const reference of command.parsed?.references ?? []) {\n    if (reference.kind === \"url\") {\n      context.push({\n        kind: \"url\",\n        uri: reference.uri,\n        visibility: \"organization\",\n        title: reference.title ?? \"Command URL reference\"\n      });\n      continue;\n    }\n\n    if (reference.kind === \"file\" || reference.kind === \"path\") {\n      context.push({\n        kind: \"file\",\n        uri: reference.uri,\n        ...(reference.line ? { line: reference.line } : {}),\n        ...(reference.startLine ? { startLine: reference.startLine } : {}),\n        ...(reference.endLine ? { endLine: reference.endLine } : {}),\n        visibility: \"organization\",\n        title: referenceTitle(reference)\n      });\n    }\n  }\n\n  return context;\n}\n\nfunction referenceTitle(reference: NonNullable<OpenTagCommand[\"parsed\"]>[\"references\"][number]): string {\n  return reference.title ?? \"Command file reference\";\n}\n\nfunction commandMetadata(command: OpenTagCommand): Record<string, unknown> {\n  if (!command.parsed) return {};\n  return {\n    commandParser: command.parsed.version,\n    commandDiagnostics: command.parsed.diagnostics,\n    ...(command.parsed.approval ? { approval: command.parsed.approval } : {}),\n    ...(command.parsed.network ? { network: command.parsed.network } : {})\n  };\n}\n\nexport function normalizeLarkMessage(input: LarkMessageInput): OpenTagEvent | null {\n  const rawText = stripLarkMention(input.text);\n  if (!rawText) return null;\n\n  const command = commandFromRawText(rawText);\n  const agentId = input.agentId ?? \"opentag\";\n\n  return {\n    id: `evt_lark_message_${input.eventId}`,\n    source: \"lark\",\n    sourceEventId: input.eventId,\n    receivedAt: new Date(input.eventTimeMs).toISOString(),\n    actor: {\n      provider: \"lark\",\n      providerUserId: input.senderOpenId,\n      handle: input.senderOpenId,\n      organizationId: input.tenantKey\n    },\n    target: {\n      mention: input.botOpenId ? `@${input.botOpenId}` : \"@app\",\n      agentId,\n      ...(command.parsed?.executorHint ? { executorHint: command.parsed.executorHint } : {})\n    },\n    command,\n    context: [\n      {\n        provider: \"lark\",\n        kind: \"message\",\n        uri: `lark://tenant/${input.tenantKey}/chat/${input.chatId}/message/${input.messageId}`,\n        visibility: \"organization\",\n        title: \"Lark message\"\n      },\n      {\n        kind: \"text\",\n        uri: input.text,\n        visibility: \"organization\",\n        title: \"Lark message text\"\n      },\n      ...contextPointersForCommand(command)\n    ],\n    permissions: permissionsForIntent(command.intent),\n    callback: {\n      provider: \"lark\",\n      uri: input.callbackUri ?? \"lark://im/v1/messages\",\n      threadKey: encodeLarkThreadKey({\n        tenantKey: input.tenantKey,\n        chatId: input.chatId,\n        messageId: input.messageId\n      })\n    },\n    metadata: {\n      tenantKey: input.tenantKey,\n      chatId: input.chatId,\n      messageId: input.messageId,\n      chatType: input.chatType,\n      ...(input.rootId ? { rootId: input.rootId } : {}),\n      ...(input.botOpenId ? { larkBotOpenId: input.botOpenId } : {}),\n      ...commandMetadata(command),\n      repoProvider: input.binding.repoProvider ?? \"github\",\n      owner: input.binding.owner,\n      repo: input.binding.repo\n    }\n  };\n}\n","import { parseProjectTargetRef, type OpenTagEvent } from \"@opentag/core\";\nimport type { CreateRunResult } from \"@opentag/client\";\nimport { type LarkChannelBinding, normalizeLarkMessage, stripLarkMention } from \"./normalize.js\";\n\nexport type LarkMention = { key?: string; id?: { open_id?: string }; name?: string };\n\n// Flattened `im.message.receive_v1` payload as delivered by the SDK EventDispatcher (header fields + message/sender on the top level). All optional (external input).\nexport type LarkInboundMessageEvent = {\n  event_id?: string;\n  event_type?: string;\n  create_time?: string;\n  tenant_key?: string;\n  app_id?: string;\n  sender?: {\n    sender_id?: { open_id?: string; user_id?: string; union_id?: string };\n    sender_type?: string;\n    tenant_key?: string;\n  };\n  message?: {\n    message_id?: string;\n    root_id?: string;\n    parent_id?: string;\n    chat_id?: string;\n    chat_type?: string;\n    message_type?: string;\n    content?: string;\n    mentions?: LarkMention[];\n  };\n};\n\nexport type LarkMessageHandlerConfig = {\n  agentId: string;\n  botOpenId?: string;\n  callbackUri?: string;\n  defaultRepoBinding?: { repoProvider: string; owner: string; repo: string };\n  resolveChannelBinding(input: { tenantKey: string; chatId: string }): Promise<LarkChannelBinding | null>;\n  createRun(event: OpenTagEvent): Promise<CreateRunResult>;\n  // Self-service binding from within Lark (`/bind owner/repo`); optional so tests can omit it.\n  bindChannel?(input: { tenantKey: string; chatId: string; repoProvider: string; owner: string; repo: string }): Promise<void>;\n  // Reply into the originating thread (onboarding hints, bind confirmations); optional.\n  reply?(input: { messageId: string; text: string }): Promise<void>;\n  now?(): number;\n};\n\nexport type LarkMessageHandlerOutcome = {\n  status:\n    | \"created\"\n    | \"bound\"\n    | \"ignored_non_text\"\n    | \"ignored_invalid_payload\"\n    | \"ignored_group_requires_bot_open_id\"\n    | \"ignored_not_addressed\"\n    | \"ignored_bind_usage\"\n    | \"ignored_bind_unavailable\"\n    | \"ignored_unbound_chat\"\n    | \"ignored_empty_command\"\n    | \"follow_up_queued\"\n    | \"needs_human_decision\";\n  runId?: string;\n  followUpRequestId?: string;\n  reason?: string;\n  tenantKey?: string;\n  chatId?: string;\n};\n\nconst BIND_USAGE =\n  \"Usage: /bind <owner>/<repo> — e.g. /bind amplifthq/opentag (or /bind github:amplifthq/opentag).\";\nconst UNBOUND_HINT =\n  \"This chat isn't connected to a Project Target yet. @-mention me with `/bind <owner>/<repo>` to connect it — e.g. /bind amplifthq/opentag.\";\n\ntype DefaultRepoBinding = NonNullable<LarkMessageHandlerConfig[\"defaultRepoBinding\"]>;\n\nfunction bindingFromDefault(input: { tenantKey: string; chatId: string; binding: DefaultRepoBinding }): LarkChannelBinding {\n  return {\n    tenantKey: input.tenantKey,\n    chatId: input.chatId,\n    repoProvider: input.binding.repoProvider,\n    owner: input.binding.owner,\n    repo: input.binding.repo\n  };\n}\n\nfunction shouldMigrateLegacyLocalBinding(input: {\n  existing: LarkChannelBinding;\n  defaultBinding: DefaultRepoBinding;\n}): boolean {\n  return (\n    input.defaultBinding.repoProvider === \"local\" &&\n    input.defaultBinding.owner.startsWith(\"path_\") &&\n    input.existing.repoProvider === \"local\" &&\n    input.existing.owner === \"local\" &&\n    input.existing.repo === input.defaultBinding.repo\n  );\n}\n\nfunction extractText(content: string | undefined): string {\n  if (!content) return \"\";\n  try {\n    const parsed = JSON.parse(content) as { text?: unknown };\n    return typeof parsed.text === \"string\" ? parsed.text : \"\";\n  } catch {\n    return \"\";\n  }\n}\n\nfunction mentionsBot(mentions: LarkMention[] | undefined, botOpenId: string): boolean {\n  return (mentions ?? []).some((mention) => mention.id?.open_id === botOpenId);\n}\n\n// Parse `/bind owner/repo` (or `/bind provider:owner/repo`). null = not a bind command; {ok:false} = malformed.\nfunction parseBindCommand(\n  command: string\n): { ok: true; repoProvider: string; owner: string; repo: string } | { ok: false } | null {\n  if (!/^\\/bind(\\s|$)/.test(command)) return null;\n  const match = command.match(/^\\/bind\\s+(\\S+)\\s*$/);\n  if (!match) return { ok: false };\n  try {\n    const ref = parseProjectTargetRef(match[1] as string);\n    return { ok: true, repoProvider: ref.provider, owner: ref.owner, repo: ref.repo };\n  } catch {\n    return { ok: false };\n  }\n}\n\n// Handle one inbound Lark message: group messages must @-mention the bot, then handle /bind, resolve binding, normalize, create a run.\nexport function createLarkMessageHandler(config: LarkMessageHandlerConfig) {\n  return async function handleLarkMessage(data: LarkInboundMessageEvent): Promise<LarkMessageHandlerOutcome> {\n    const message = data.message;\n    if (!message || message.message_type !== \"text\") {\n      return { status: \"ignored_non_text\" };\n    }\n\n    const tenantKey = data.tenant_key ?? data.sender?.tenant_key;\n    const chatId = message.chat_id;\n    const messageId = message.message_id;\n    const eventId = data.event_id;\n    const senderOpenId = data.sender?.sender_id?.open_id;\n    if (!tenantKey || !chatId || !messageId || !eventId || !senderOpenId) {\n      return { status: \"ignored_invalid_payload\" };\n    }\n\n    // Group messages must @-mention the bot before triggering a (write-capable) run; p2p is exempt.\n    const isDirect = message.chat_type === \"p2p\";\n    if (!isDirect) {\n      if (!config.botOpenId) {\n        return { status: \"ignored_group_requires_bot_open_id\", tenantKey, chatId };\n      }\n      if (!mentionsBot(message.mentions, config.botOpenId)) {\n        return { status: \"ignored_not_addressed\", tenantKey, chatId };\n      }\n    }\n\n    const command = stripLarkMention(extractText(message.content));\n\n    // Self-service binding: connect this chat to a Project Target without leaving Lark.\n    const bindRequest = parseBindCommand(command);\n    if (bindRequest && !config.bindChannel) {\n      return { status: \"ignored_bind_unavailable\", tenantKey, chatId };\n    }\n    if (bindRequest && config.bindChannel) {\n      if (!bindRequest.ok) {\n        await config.reply?.({ messageId, text: BIND_USAGE });\n        return { status: \"ignored_bind_usage\", tenantKey, chatId };\n      }\n      await config.bindChannel({\n        tenantKey,\n        chatId,\n        repoProvider: bindRequest.repoProvider,\n        owner: bindRequest.owner,\n        repo: bindRequest.repo\n      });\n      await config.reply?.({\n        messageId,\n        text: `Connected this chat to Project Target ${bindRequest.repoProvider}:${bindRequest.owner}/${bindRequest.repo}. @-mention me with a task to start a run.`\n      });\n      return { status: \"bound\", tenantKey, chatId };\n    }\n\n    if (command.trim().length === 0) {\n      return { status: \"ignored_empty_command\", tenantKey, chatId };\n    }\n\n    let binding = await config.resolveChannelBinding({ tenantKey, chatId });\n    if (binding && config.defaultRepoBinding && config.bindChannel) {\n      if (shouldMigrateLegacyLocalBinding({ existing: binding, defaultBinding: config.defaultRepoBinding })) {\n        await config.bindChannel({\n          tenantKey,\n          chatId,\n          repoProvider: config.defaultRepoBinding.repoProvider,\n          owner: config.defaultRepoBinding.owner,\n          repo: config.defaultRepoBinding.repo\n        });\n        binding = bindingFromDefault({ tenantKey, chatId, binding: config.defaultRepoBinding });\n      }\n    }\n    if (!binding) {\n      if (config.defaultRepoBinding && config.bindChannel) {\n        await config.bindChannel({\n          tenantKey,\n          chatId,\n          repoProvider: config.defaultRepoBinding.repoProvider,\n          owner: config.defaultRepoBinding.owner,\n          repo: config.defaultRepoBinding.repo\n        });\n        binding = bindingFromDefault({ tenantKey, chatId, binding: config.defaultRepoBinding });\n      } else {\n        await config.reply?.({ messageId, text: UNBOUND_HINT });\n        return { status: \"ignored_unbound_chat\", tenantKey, chatId };\n      }\n    }\n\n    const parsedTime = data.create_time ? Number(data.create_time) : Number.NaN;\n    const eventTimeMs = Number.isFinite(parsedTime) ? parsedTime : (config.now?.() ?? Date.now());\n\n    const event = normalizeLarkMessage({\n      tenantKey,\n      chatId,\n      chatType: message.chat_type ?? \"group\",\n      senderOpenId,\n      text: extractText(message.content),\n      messageId,\n      ...(message.root_id ? { rootId: message.root_id } : {}),\n      eventId,\n      eventTimeMs,\n      agentId: config.agentId,\n      ...(config.botOpenId ? { botOpenId: config.botOpenId } : {}),\n      ...(config.callbackUri ? { callbackUri: config.callbackUri } : {}),\n      binding\n    });\n    if (!event) {\n      return { status: \"ignored_empty_command\" };\n    }\n\n    const result = await config.createRun(event);\n    if (result.outcome === \"run_created\") {\n      return { status: \"created\", runId: result.run.id, tenantKey, chatId };\n    }\n    if (result.outcome === \"follow_up_queued\") {\n      return {\n        status: \"follow_up_queued\",\n        followUpRequestId: result.followUpRequest.id,\n        ...(result.decision.activeRunId ? { runId: result.decision.activeRunId } : {}),\n        reason: result.decision.reason,\n        tenantKey,\n        chatId\n      };\n    }\n    return {\n      status: \"needs_human_decision\",\n      reason: result.decision.reason,\n      tenantKey,\n      chatId\n    };\n  };\n}\n","import { randomUUID } from \"node:crypto\";\nimport * as lark from \"@larksuiteoapi/node-sdk\";\nimport { createOpenTagClient } from \"@opentag/client\";\nimport { parseProjectTargetRef, type OpenTagEvent } from \"@opentag/core\";\nimport { createLarkReplyClient, replyLarkMessage } from \"./outbound.js\";\nimport { createLarkMessageHandler, type LarkInboundMessageEvent, type LarkMessageHandlerOutcome } from \"./inbound.js\";\n\nexport const DEFAULT_AGENT_ID = \"opentag\";\n\nexport type LarkIngressConfig = {\n  appId: string;\n  appSecret: string;\n  dispatcherUrl: string;\n  dispatcherToken?: string;\n  domain: \"lark\" | \"feishu\";\n  agentId: string;\n  botOpenId?: string;\n  defaultRepoBinding?: { repoProvider: string; owner: string; repo: string };\n};\n\nexport type LarkWsClient = {\n  start(input: { eventDispatcher: unknown }): Promise<void>;\n  close?(input?: { force?: boolean }): void | Promise<void>;\n};\n\nexport type LarkIngressDependencies = {\n  createWsClient?(config: LarkIngressConfig): LarkWsClient;\n  createEventDispatcher?(handler: (data: LarkInboundMessageEvent) => Promise<void>): unknown;\n  reply?(input: { messageId: string; text: string }): Promise<void>;\n  logIgnored?(outcome: LarkMessageHandlerOutcome): void;\n};\n\nexport type LarkIngressHandle = {\n  startPromise: Promise<void>;\n  close(): Promise<void>;\n};\n\nfunction defaultRepoBindingFromEnv(value: string | undefined): LarkIngressConfig[\"defaultRepoBinding\"] {\n  if (!value) return undefined;\n  try {\n    const ref = parseProjectTargetRef(value);\n    return {\n      repoProvider: ref.provider,\n      owner: ref.owner,\n      repo: ref.repo\n    };\n  } catch {\n    throw new Error(\"OPENTAG_LARK_DEFAULT_REPO must be formatted as owner/repo or provider:owner/repo\");\n  }\n}\n\nfunction domainFromEnv(value: string | undefined): LarkIngressConfig[\"domain\"] {\n  const domain = value ?? \"lark\";\n  if (domain !== \"lark\" && domain !== \"feishu\") {\n    throw new Error(\"LARK_DOMAIN must be either lark or feishu\");\n  }\n  return domain;\n}\n\nexport function larkIngressConfigFromEnv(env: NodeJS.ProcessEnv): LarkIngressConfig {\n  const appId = env.LARK_APP_ID;\n  const appSecret = env.LARK_APP_SECRET;\n  const dispatcherUrl = env.OPENTAG_DISPATCHER_URL;\n  if (!appId || !appSecret) {\n    throw new Error(\"LARK_APP_ID and LARK_APP_SECRET are required\");\n  }\n  if (!dispatcherUrl) {\n    throw new Error(\"OPENTAG_DISPATCHER_URL is required\");\n  }\n\n  const defaultRepoBinding = defaultRepoBindingFromEnv(env.OPENTAG_LARK_DEFAULT_REPO);\n\n  return {\n    appId,\n    appSecret,\n    dispatcherUrl,\n    domain: domainFromEnv(env.LARK_DOMAIN),\n    agentId: env.OPENTAG_LARK_AGENT_ID ?? DEFAULT_AGENT_ID,\n    ...(env.OPENTAG_DISPATCHER_TOKEN ? { dispatcherToken: env.OPENTAG_DISPATCHER_TOKEN } : {}),\n    ...(env.LARK_BOT_OPEN_ID ? { botOpenId: env.LARK_BOT_OPEN_ID } : {}),\n    ...(defaultRepoBinding ? { defaultRepoBinding } : {})\n  };\n}\n\nfunction createDefaultWsClient(config: LarkIngressConfig): LarkWsClient {\n  return new lark.WSClient({\n    appId: config.appId,\n    appSecret: config.appSecret,\n    domain: config.domain === \"feishu\" ? lark.Domain.Feishu : lark.Domain.Lark\n  });\n}\n\nfunction createDefaultEventDispatcher(handler: (data: LarkInboundMessageEvent) => Promise<void>): unknown {\n  return new lark.EventDispatcher({}).register({\n    \"im.message.receive_v1\": (data) => handler(data as unknown as LarkInboundMessageEvent)\n  });\n}\n\nfunction logIgnored(outcome: LarkMessageHandlerOutcome): void {\n  if (outcome.status === \"created\" || outcome.status === \"bound\") return;\n  if (outcome.status === \"follow_up_queued\") {\n    console.log(\n      `[lark] queued follow-up${outcome.followUpRequestId ? ` follow_up_request_id=${outcome.followUpRequestId}` : \"\"}${outcome.runId ? ` active_run_id=${outcome.runId}` : \"\"}`\n    );\n    return;\n  }\n  if (outcome.status === \"needs_human_decision\") {\n    console.log(`[lark] needs human decision${outcome.reason ? `: ${outcome.reason}` : \"\"}`);\n    return;\n  }\n  if (outcome.status === \"ignored_unbound_chat\") {\n    console.log(\n      `[lark] ignored unbound chat - bind it: provider=lark accountId(tenant_key)=${outcome.tenantKey} conversationId(chat_id)=${outcome.chatId} (reply '/bind owner/repo' with a Project Target ref, or POST /v1/channel-bindings)`\n    );\n    return;\n  }\n  console.log(`[lark] ignored event: ${outcome.status}${outcome.chatId ? ` chat_id=${outcome.chatId}` : \"\"}`);\n}\n\nexport function startLarkIngress(config: LarkIngressConfig, dependencies: LarkIngressDependencies = {}): LarkIngressHandle {\n  const dispatcherClient = createOpenTagClient({\n    dispatcherUrl: config.dispatcherUrl,\n    ...(config.dispatcherToken ? { pairingToken: config.dispatcherToken } : {})\n  });\n  let replyClient: ReturnType<typeof createLarkReplyClient> | undefined;\n  const reply =\n    dependencies.reply ??\n    ((input: { messageId: string; text: string }) => {\n      replyClient ??= createLarkReplyClient({ appId: config.appId, appSecret: config.appSecret, domain: config.domain });\n      return replyLarkMessage(replyClient, input);\n    });\n\n  const handler = createLarkMessageHandler({\n    agentId: config.agentId,\n    ...(config.botOpenId ? { botOpenId: config.botOpenId } : {}),\n    ...(config.defaultRepoBinding ? { defaultRepoBinding: config.defaultRepoBinding } : {}),\n    async resolveChannelBinding(input) {\n      try {\n        const { binding } = await dispatcherClient.getChannelBinding({\n          provider: \"lark\",\n          accountId: input.tenantKey,\n          conversationId: input.chatId\n        });\n        return {\n          tenantKey: binding.accountId,\n          chatId: binding.conversationId,\n          repoProvider: binding.repoProvider,\n          owner: binding.owner,\n          repo: binding.repo\n        };\n      } catch (error) {\n        if (error instanceof Error && error.message.includes(\"channel_binding_not_found\")) {\n          return null;\n        }\n        throw error;\n      }\n    },\n    async bindChannel(input) {\n      await dispatcherClient.bindChannel({\n        provider: \"lark\",\n        accountId: input.tenantKey,\n        conversationId: input.chatId,\n        repoProvider: input.repoProvider,\n        owner: input.owner,\n        repo: input.repo\n      });\n    },\n    async reply(input) {\n      await reply(input);\n    },\n    async createRun(event: OpenTagEvent) {\n      const runId = `run_${randomUUID()}`;\n      return dispatcherClient.createRun({ runId, event });\n    }\n  });\n\n  const eventDispatcher = (dependencies.createEventDispatcher ?? createDefaultEventDispatcher)(async (data) => {\n    try {\n      (dependencies.logIgnored ?? logIgnored)(await handler(data));\n    } catch (error) {\n      console.error(\"[lark] failed to handle inbound message:\", error);\n    }\n  });\n  const wsClient = (dependencies.createWsClient ?? createDefaultWsClient)(config);\n\n  return {\n    startPromise: wsClient.start({ eventDispatcher }),\n    async close() {\n      await wsClient.close?.({ force: true });\n    }\n  };\n}\n","import * as lark from \"@larksuiteoapi/node-sdk\";\nimport { createLarkTextMessageContent } from \"./render.js\";\n\n// Minimal client surface OpenTag uses; lark.Client satisfies it structurally.\nexport type LarkReplyClient = {\n  im: {\n    message: {\n      reply(payload: {\n        path: { message_id: string };\n        data: { content: string; msg_type: string; reply_in_thread?: boolean; uuid?: string };\n      }): Promise<unknown>;\n    };\n  };\n};\n\nexport function createLarkReplyClient(input: { appId: string; appSecret: string; domain?: \"lark\" | \"feishu\" }): LarkReplyClient {\n  return new lark.Client({\n    appId: input.appId,\n    appSecret: input.appSecret,\n    domain: input.domain === \"feishu\" ? lark.Domain.Feishu : lark.Domain.Lark\n  });\n}\n\nexport async function replyLarkMessage(client: LarkReplyClient, input: { messageId: string; text: string }): Promise<void> {\n  await client.im.message.reply({\n    path: { message_id: input.messageId },\n    data: { content: createLarkTextMessageContent(input.text), msg_type: \"text\", reply_in_thread: true }\n  });\n}\n","import type { OpenTagRunResult } from \"@opentag/core\";\n\nfunction nextActionSummary(result: OpenTagRunResult): string | undefined {\n  if (!result.nextAction) return undefined;\n  if (typeof result.nextAction === \"string\") return result.nextAction;\n  return result.nextAction.summary;\n}\n\nexport function renderLarkAcknowledgement(runId: string): string {\n  return `I picked this up: ${runId}`;\n}\n\nexport function renderLarkFinalResult(result: OpenTagRunResult): string {\n  const lines = [`Finished with ${result.conclusion}.`, \"\", result.summary];\n\n  if (result.verification?.length) {\n    lines.push(\"\", \"Verification\");\n    for (const check of result.verification) {\n      lines.push(`- ${check.command}: ${check.outcome}`);\n    }\n  }\n\n  const nextAction = nextActionSummary(result);\n  if (nextAction) {\n    lines.push(\"\", `Next action: ${nextAction}`);\n  }\n\n  return lines.join(\"\\n\");\n}\n\n// Lark text message content is a JSON-encoded `{ \"text\": \"...\" }` string.\nexport function createLarkTextMessageContent(text: string): string {\n  return JSON.stringify({ text });\n}\n","import * as lark from \"@larksuiteoapi/node-sdk\";\n\nconst REGISTRATION_SOURCE = \"opentag\";\nconst BOT_INFO_RETRIES = 6;\nconst BOT_INFO_RETRY_DELAY_MS = 2000;\n\nexport type LarkDomain = \"lark\" | \"feishu\";\n\nexport type LarkRegistrationQrCodeInfo = {\n  url: string;\n  expireIn: number;\n};\n\nexport type LarkRegistrationStatusInfo = {\n  status: string;\n  interval?: number;\n};\n\nexport type RegisteredLarkPersonalAgent = {\n  appId: string;\n  appSecret: string;\n  domain: LarkDomain;\n  operatorOpenId?: string;\n  botOpenId?: string;\n  botName?: string;\n};\n\ntype LarkRegisterAppResult = {\n  client_id: string;\n  client_secret: string;\n  user_info?: {\n    open_id?: string;\n    tenant_brand?: \"feishu\" | \"lark\";\n  };\n};\n\ntype LarkRegisterApp = (options: {\n  domain?: string;\n  larkDomain?: string;\n  source?: string;\n  signal?: AbortSignal;\n  onQRCodeReady: (info: LarkRegistrationQrCodeInfo) => void;\n  onStatusChange?: (info: LarkRegistrationStatusInfo) => void;\n  appPreset?: { name?: string; desc?: string };\n  addons?: {\n    scopes?: { tenant?: string[] };\n    events?: { items?: { tenant?: string[] } };\n  };\n  createOnly?: boolean;\n}) => Promise<LarkRegisterAppResult>;\n\ntype BotInfoClient = {\n  request(input: { url: string; method: \"GET\" }): Promise<unknown>;\n};\n\nexport type LarkPersonalAgentRegistrationDependencies = {\n  registerApp?: LarkRegisterApp;\n  createBotInfoClient?(input: { appId: string; appSecret: string; domain: LarkDomain }): BotInfoClient;\n  sleep?(ms: number): Promise<void>;\n};\n\nexport type RegisterLarkPersonalAgentInput = {\n  domain?: LarkDomain;\n  signal?: AbortSignal;\n  onQrCode(info: LarkRegistrationQrCodeInfo): void;\n  onStatus?(info: LarkRegistrationStatusInfo): void;\n  onWarning?(message: string): void;\n};\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nfunction accountDomainFor(domain: LarkDomain): string {\n  return domain === \"feishu\" ? \"accounts.feishu.cn\" : \"accounts.larksuite.com\";\n}\n\nfunction sdkDomainFor(domain: LarkDomain): lark.Domain {\n  return domain === \"feishu\" ? lark.Domain.Feishu : lark.Domain.Lark;\n}\n\nfunction registrationDomainFromUserInfo(requestedDomain: LarkDomain, userInfo: LarkRegisterAppResult[\"user_info\"]): LarkDomain {\n  if (userInfo?.tenant_brand === \"lark\") return \"lark\";\n  if (userInfo?.tenant_brand === \"feishu\") return \"feishu\";\n  return requestedDomain;\n}\n\nfunction createDefaultBotInfoClient(input: { appId: string; appSecret: string; domain: LarkDomain }): BotInfoClient {\n  return new lark.Client({\n    appId: input.appId,\n    appSecret: input.appSecret,\n    domain: sdkDomainFor(input.domain)\n  });\n}\n\nfunction botInfoFromResponse(response: unknown): { botOpenId: string; botName: string } | undefined {\n  const value = response as { bot?: { open_id?: string; app_name?: string; name?: string }; data?: { bot?: { open_id?: string; app_name?: string; name?: string } } };\n  const bot = value.bot ?? value.data?.bot;\n  if (!bot?.open_id) {\n    return undefined;\n  }\n  return {\n    botOpenId: bot.open_id,\n    botName: bot.app_name || bot.name || \"OpenTag\"\n  };\n}\n\nasync function fetchBotIdentity(\n  input: { appId: string; appSecret: string; domain: LarkDomain },\n  options: {\n    createBotInfoClient: NonNullable<LarkPersonalAgentRegistrationDependencies[\"createBotInfoClient\"]>;\n    sleep: (ms: number) => Promise<void>;\n    onWarning?: (message: string) => void;\n  }\n): Promise<Pick<RegisteredLarkPersonalAgent, \"botOpenId\" | \"botName\">> {\n  const client = options.createBotInfoClient(input);\n  let lastError: unknown;\n\n  for (let attempt = 1; attempt <= BOT_INFO_RETRIES; attempt += 1) {\n    try {\n      const botIdentity = botInfoFromResponse(\n        await client.request({\n          url: \"/open-apis/bot/v3/info\",\n          method: \"GET\"\n        })\n      );\n      if (botIdentity) {\n        return botIdentity;\n      }\n      lastError = new Error(\"bot/v3/info response did not include bot.open_id.\");\n    } catch (error) {\n      lastError = error;\n    }\n\n    if (attempt < BOT_INFO_RETRIES) {\n      await options.sleep(BOT_INFO_RETRY_DELAY_MS);\n    }\n  }\n\n  const reason = lastError instanceof Error ? lastError.message : String(lastError);\n  options.onWarning?.(\n    `OpenTag could not fetch the Lark bot open_id automatically. Direct chat still works. For group chat, enter the bot open_id manually. Reason: ${reason}`\n  );\n  return {};\n}\n\nexport async function registerLarkPersonalAgent(\n  input: RegisterLarkPersonalAgentInput,\n  dependencies: LarkPersonalAgentRegistrationDependencies = {}\n): Promise<RegisteredLarkPersonalAgent> {\n  const requestedDomain = input.domain ?? \"lark\";\n  let detectedDomain: LarkDomain | undefined;\n\n  const registerApp = dependencies.registerApp ?? lark.registerApp;\n  const registrationOptions = {\n    // The Personal Agent registration flow starts on Feishu and switches to Lark after scan when needed.\n    domain: accountDomainFor(\"feishu\"),\n    larkDomain: accountDomainFor(\"lark\"),\n    source: REGISTRATION_SOURCE,\n    createOnly: true,\n    appPreset: {\n      name: \"OpenTag {user}\",\n      desc: \"Wake your local OpenTag agent from Lark.\"\n    },\n    addons: {\n      scopes: {\n        tenant: [\"im:message:send_as_bot\", \"im:message.p2p_msg:readonly\", \"im:message.group_msg:readonly\", \"im:chat:readonly\"]\n      },\n      events: {\n        items: {\n          tenant: [\"im.message.receive_v1\"]\n        }\n      }\n    },\n    onQRCodeReady: input.onQrCode,\n    onStatusChange(info) {\n      if (info.status === \"domain_switched\") {\n        detectedDomain = \"lark\";\n      }\n      input.onStatus?.(info);\n    }\n  } satisfies Parameters<LarkRegisterApp>[0];\n\n  const registration = await registerApp({\n    ...registrationOptions,\n    ...(input.signal ? { signal: input.signal } : {})\n  });\n\n  const domain = detectedDomain ?? registrationDomainFromUserInfo(requestedDomain, registration.user_info);\n  const botIdentity = await fetchBotIdentity(\n    {\n      appId: registration.client_id,\n      appSecret: registration.client_secret,\n      domain\n    },\n    {\n      createBotInfoClient: dependencies.createBotInfoClient ?? createDefaultBotInfoClient,\n      sleep: dependencies.sleep ?? sleep,\n      ...(input.onWarning ? { onWarning: input.onWarning } : {})\n    }\n  );\n\n  return {\n    appId: registration.client_id,\n    appSecret: registration.client_secret,\n    domain,\n    ...(registration.user_info?.open_id ? { operatorOpenId: registration.user_info.open_id } : {}),\n    ...(botIdentity.botOpenId ? { botOpenId: botIdentity.botOpenId } : {}),\n    ...(botIdentity.botName ? { botName: botIdentity.botName } : {})\n  };\n}\n"],"mappings":"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","names":["lark","parseProjectTargetRef","parseProjectTargetRef","lark","registerApp"]}

package/dist/ingress.d.ts

@@ -0,0 +1,40 @@
+import { type LarkInboundMessageEvent, type LarkMessageHandlerOutcome } from "./inbound.js";
+export declare const DEFAULT_AGENT_ID = "opentag";
+export type LarkIngressConfig = {
+    appId: string;
+    appSecret: string;
+    dispatcherUrl: string;
+    dispatcherToken?: string;
+    domain: "lark" | "feishu";
+    agentId: string;
+    botOpenId?: string;
+    defaultRepoBinding?: {
+        repoProvider: string;
+        owner: string;
+        repo: string;
+    };
+};
+export type LarkWsClient = {
+    start(input: {
+        eventDispatcher: unknown;
+    }): Promise<void>;
+    close?(input?: {
+        force?: boolean;
+    }): void | Promise<void>;
+};
+export type LarkIngressDependencies = {
+    createWsClient?(config: LarkIngressConfig): LarkWsClient;
+    createEventDispatcher?(handler: (data: LarkInboundMessageEvent) => Promise<void>): unknown;
+    reply?(input: {
+        messageId: string;
+        text: string;
+    }): Promise<void>;
+    logIgnored?(outcome: LarkMessageHandlerOutcome): void;
+};
+export type LarkIngressHandle = {
+    startPromise: Promise<void>;
+    close(): Promise<void>;
+};
+export declare function larkIngressConfigFromEnv(env: NodeJS.ProcessEnv): LarkIngressConfig;
+export declare function startLarkIngress(config: LarkIngressConfig, dependencies?: LarkIngressDependencies): LarkIngressHandle;
+//# sourceMappingURL=ingress.d.ts.map

package/dist/ingress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingress.d.ts","sourceRoot":"","sources":["../src/ingress.ts"],"names":[],"mappings":"AAKA,OAAO,EAA4B,KAAK,uBAAuB,EAAE,KAAK,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEtH,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5E,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,CAAC,KAAK,EAAE;QAAE,eAAe,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,cAAc,CAAC,CAAC,MAAM,EAAE,iBAAiB,GAAG,YAAY,CAAC;IACzD,qBAAqB,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;IAC3F,KAAK,CAAC,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,UAAU,CAAC,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAwBF,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,iBAAiB,CAuBlF;AAqCD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,EAAE,YAAY,GAAE,uBAA4B,GAAG,iBAAiB,CAwEzH"}

package/dist/normalize.d.ts

@@ -0,0 +1,36 @@
+import { type OpenTagEvent } from "@opentag/core";
+export type LarkChannelBinding = {
+    tenantKey: string;
+    chatId: string;
+    repoProvider?: string;
+    owner: string;
+    repo: string;
+};
+export type LarkMessageInput = {
+    tenantKey: string;
+    chatId: string;
+    chatType: string;
+    senderOpenId: string;
+    text: string;
+    messageId: string;
+    rootId?: string;
+    eventId: string;
+    eventTimeMs: number;
+    agentId?: string;
+    botOpenId?: string;
+    callbackUri?: string;
+    binding: LarkChannelBinding;
+};
+export declare function stripLarkMention(text: string): string;
+export declare function encodeLarkThreadKey(input: {
+    tenantKey: string;
+    chatId: string;
+    messageId: string;
+}): string;
+export declare function parseLarkThreadKey(threadKey: string): {
+    tenantKey: string;
+    chatId: string;
+    messageId: string;
+};
+export declare function normalizeLarkMessage(input: LarkMessageInput): OpenTagEvent | null;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgE,KAAK,YAAY,EAAwB,MAAM,eAAe,CAAC;AAEtI,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,kBAAkB,CAAC;CAC7B,CAAC;AAGF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE3G;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAM9G;AA8ED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,GAAG,YAAY,GAAG,IAAI,CA+DjF"}

package/dist/outbound.d.ts

@@ -0,0 +1,27 @@
+export type LarkReplyClient = {
+    im: {
+        message: {
+            reply(payload: {
+                path: {
+                    message_id: string;
+                };
+                data: {
+                    content: string;
+                    msg_type: string;
+                    reply_in_thread?: boolean;
+                    uuid?: string;
+                };
+            }): Promise<unknown>;
+        };
+    };
+};
+export declare function createLarkReplyClient(input: {
+    appId: string;
+    appSecret: string;
+    domain?: "lark" | "feishu";
+}): LarkReplyClient;
+export declare function replyLarkMessage(client: LarkReplyClient, input: {
+    messageId: string;
+    text: string;
+}): Promise<void>;
+//# sourceMappingURL=outbound.d.ts.map

package/dist/outbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound.d.ts","sourceRoot":"","sources":["../src/outbound.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE;QACF,OAAO,EAAE;YACP,KAAK,CAAC,OAAO,EAAE;gBACb,IAAI,EAAE;oBAAE,UAAU,EAAE,MAAM,CAAA;iBAAE,CAAC;gBAC7B,IAAI,EAAE;oBAAE,OAAO,EAAE,MAAM,CAAC;oBAAC,QAAQ,EAAE,MAAM,CAAC;oBAAC,eAAe,CAAC,EAAE,OAAO,CAAC;oBAAC,IAAI,CAAC,EAAE,MAAM,CAAA;iBAAE,CAAC;aACvF,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;SACtB,CAAC;KACH,CAAC;CACH,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;CAAE,GAAG,eAAe,CAM9H;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAKzH"}

package/dist/registration.d.ts

@@ -0,0 +1,73 @@
+export type LarkDomain = "lark" | "feishu";
+export type LarkRegistrationQrCodeInfo = {
+    url: string;
+    expireIn: number;
+};
+export type LarkRegistrationStatusInfo = {
+    status: string;
+    interval?: number;
+};
+export type RegisteredLarkPersonalAgent = {
+    appId: string;
+    appSecret: string;
+    domain: LarkDomain;
+    operatorOpenId?: string;
+    botOpenId?: string;
+    botName?: string;
+};
+type LarkRegisterAppResult = {
+    client_id: string;
+    client_secret: string;
+    user_info?: {
+        open_id?: string;
+        tenant_brand?: "feishu" | "lark";
+    };
+};
+type LarkRegisterApp = (options: {
+    domain?: string;
+    larkDomain?: string;
+    source?: string;
+    signal?: AbortSignal;
+    onQRCodeReady: (info: LarkRegistrationQrCodeInfo) => void;
+    onStatusChange?: (info: LarkRegistrationStatusInfo) => void;
+    appPreset?: {
+        name?: string;
+        desc?: string;
+    };
+    addons?: {
+        scopes?: {
+            tenant?: string[];
+        };
+        events?: {
+            items?: {
+                tenant?: string[];
+            };
+        };
+    };
+    createOnly?: boolean;
+}) => Promise<LarkRegisterAppResult>;
+type BotInfoClient = {
+    request(input: {
+        url: string;
+        method: "GET";
+    }): Promise<unknown>;
+};
+export type LarkPersonalAgentRegistrationDependencies = {
+    registerApp?: LarkRegisterApp;
+    createBotInfoClient?(input: {
+        appId: string;
+        appSecret: string;
+        domain: LarkDomain;
+    }): BotInfoClient;
+    sleep?(ms: number): Promise<void>;
+};
+export type RegisterLarkPersonalAgentInput = {
+    domain?: LarkDomain;
+    signal?: AbortSignal;
+    onQrCode(info: LarkRegistrationQrCodeInfo): void;
+    onStatus?(info: LarkRegistrationStatusInfo): void;
+    onWarning?(message: string): void;
+};
+export declare function registerLarkPersonalAgent(input: RegisterLarkPersonalAgentInput, dependencies?: LarkPersonalAgentRegistrationDependencies): Promise<RegisteredLarkPersonalAgent>;
+export {};
+//# sourceMappingURL=registration.d.ts.map

package/dist/registration.d.ts.map

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

package/dist/render.d.ts

@@ -0,0 +1,5 @@
+import type { OpenTagRunResult } from "@opentag/core";
+export declare function renderLarkAcknowledgement(runId: string): string;
+export declare function renderLarkFinalResult(result: OpenTagRunResult): string;
+export declare function createLarkTextMessageContent(text: string): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAQtD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAgBtE;AAGD,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjE"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@opentag/lark",
+  "version": "0.2.0",
+  "description": "Lark/Feishu message normalization and callback helpers for OpenTag.",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "development": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "opentag",
+    "lark",
+    "feishu",
+    "events",
+    "agents"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@larksuiteoapi/node-sdk": "^1.68.0",
+    "@opentag/core": "0.2.0",
+    "@opentag/client": "0.2.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsup && tsc -b tsconfig.json --emitDeclarationOnly --force",
+    "lint": "tsc --noEmit"
+  }
+}