eve-lark 0.5.0 → 0.6.0

package/dist/card.d.ts

@@ -0,0 +1,167 @@
+import type { LarkCard, LarkCardV1, LarkInputRequest } from "./types.js";
+/**
+ * One tool call's renderable state. Mirror of the same name in
+ * streaming-controller.ts to avoid a circular import (controller imports
+ * card builders, not vice versa).
+ */
+export interface ToolCallEntry {
+    name: string;
+    state: "running" | "done" | "failed";
+}
+export interface LarkCardFooterMetrics {
+    elapsedMs?: number | undefined;
+    tokens?: number | undefined;
+    cachedTokens?: number | undefined;
+    contextTokens?: number | undefined;
+    model?: string | undefined;
+}
+/**
+ * Render tool calls as a single grey-on-grey lark_md block above the answer
+ * buffer. Running tools get `⏳`, completed get `✓` (green), failed get `✗`
+ * (red). One line per tool so the user can see the full call history even
+ * after the turn ends. Returns undefined when there are no tool calls so
+ * callers can skip pushing an empty line.
+ */
+export declare function renderToolCalls(calls: readonly ToolCallEntry[]): string | undefined;
+export declare function splitReasoningText(text?: string): {
+    reasoningText?: string;
+    answerText?: string;
+};
+export declare function stripReasoningTags(text: string): string;
+/**
+ * Build a Feishu interactive card that surfaces an eve `authorization.required`
+ * event: the agent needs the user to sign in to an external service. Renders
+ * the connection's display name, a URL button that opens the auth URL, and
+ * the user code (if present) so the user can copy-paste it.
+ */
+export declare function buildAuthCard(opts: {
+    displayName: string;
+    url: string;
+    userCode?: string | undefined;
+}): LarkCardV1;
+/**
+ * Build the "post-authorization" card that replaces the auth card once the
+ * user completes (or declines, or fails) the external sign-in.
+ */
+export declare function buildAuthCompletedCard(opts: {
+    displayName: string;
+    outcome: "authorized" | "declined" | "failed" | "timed-out" | string;
+    reason?: string | undefined;
+}): LarkCardV1;
+/**
+ * Build a simple single-shot card with the given markdown text. Renders via
+ * `div` + `lark_md` so the font size is close to a native chat message
+ * (the bare `markdown` element renders noticeably smaller).
+ */
+export declare function buildTextCard(text: string): LarkCardV1;
+/**
+ * Build a streaming card with optional status prefix, tool-call history,
+ * answer buffer, and inline ask UI. Tool calls render first (so the user
+ * sees what the agent is doing / has done), then status, then the streamed
+ * text. If `askRequest` is set, the prompt renders below the text and an
+ * `action` row of option buttons is appended so the user can answer inline
+ * on the SAME card — no separate ask-card, no separate reply card.
+ */
+export declare function buildStreamingCard(opts: {
+    buffer: string;
+    status?: string | undefined;
+    toolCalls?: readonly ToolCallEntry[] | undefined;
+    askRequest?: LarkInputRequest | null | undefined;
+    reasoningText?: string | undefined;
+    footerMetrics?: LarkCardFooterMetrics | undefined;
+}): LarkCardV1;
+/**
+ * Build an error card displayed when a turn fails.
+ */
+export declare function buildErrorCard(message: string): LarkCardV1;
+/** Marker placed in every ask-card button value so the card-action handler
+ *  can recognise our own callbacks (and ignore card actions from other
+ *  sources on the same message). */
+export declare const ASK_BUTTON_VALUE_MARKER = "__eveLarkAsk";
+export declare const ASK_FORM_VALUE_MARKER = "__eveLarkAskForm";
+/**
+ * Build a Feishu interactive card that surfaces an eve `ask_question`
+ * input request.
+ *
+ * Render choice:
+ * - `display === "select"` OR options > {@link ASK_OPTIONS_BUTTON_MAX}:
+ *   a single `select_static` dropdown. The selected optionId comes back in
+ *   `action.option` (Feishu's select callback shape).
+ * - Otherwise (display "confirmation" or short option list): one button per
+ *   option. Each button's `value` carries `{__eveLarkAsk, requestId,
+ *   optionId}`; Feishu returns it via `action.value` on click.
+ *
+ * For `allowFreeform: true` with no options, renders just the prompt (the
+ * user replies with a normal chat message, which the channel intercepts).
+ * For `allowFreeform: true` WITH options, renders the picker AND a footer
+ * hint that the user can also type a reply.
+ */
+export declare function buildAskCard(request: LarkInputRequest): LarkCardV1;
+export declare function buildAskFormCard(requests: readonly LarkInputRequest[]): LarkCard;
+export declare function buildAskProcessingCard(requests: readonly LarkInputRequest[]): LarkCardV1;
+export declare function buildAskFormProcessingCard(requests: readonly LarkInputRequest[]): LarkCard;
+export declare function buildAskRejectedCard(request: LarkInputRequest, reason: string): LarkCardV1;
+export declare function buildAskFormRejectedCard(requests: readonly LarkInputRequest[], reason: string): LarkCard;
+export declare function buildAskExpiredCard(requests: readonly LarkInputRequest[]): LarkCardV1;
+export declare function buildAskFormExpiredCard(requests: readonly LarkInputRequest[]): LarkCard;
+/**
+ * Build the "post-click" card body that replaces the ask-card once the user
+ * has answered. Disables further clicks by removing the action row and
+ * appending a "✓ <selected label>" line.
+ *
+ * `priorBuffer` is optional streaming text from the controller when the ask
+ * was rendered inline on a streaming card — preserves the prior turn's text
+ * above the answered prompt instead of wiping it.
+ */
+export declare function buildAskAnsweredCard(request: LarkInputRequest, selected: {
+    kind: "option";
+    label: string;
+} | {
+    kind: "freeform";
+    text: string;
+}, priorBuffer?: string | undefined): LarkCardV1;
+export declare function buildAskFormAnsweredCard(requests: readonly LarkInputRequest[], text?: string): LarkCard;
+export declare const CARDKIT_STREAMING_ELEMENT_ID = "eve_lark_answer";
+export interface CardKitV2Card {
+    schema: "2.0";
+    config: {
+        streaming_mode: boolean;
+        wide_screen_mode?: boolean;
+        update_multi?: boolean;
+    };
+    body: {
+        elements: Array<{
+            tag: string;
+            text?: {
+                tag: string;
+                content: string;
+            };
+            [k: string]: unknown;
+        }>;
+    };
+}
+/**
+ * Build a CardKit v2 card body for streaming. `streamingMode: true` for
+ * intermediate patches, `false` for the final card.
+ *
+ * Uses the v2 `markdown` element (not `div+lark_md`) because CardKit v2
+ * renders `markdown` at native chat-message size, while `div+lark_md` in v2
+ * defaults to a larger / "card-like" size that looks unnatural in a chat
+ * thread. (v1 interactive cards render `div+lark_md` at native size; v2
+ * flips the defaults — pick the element that gives the look you want.)
+ */
+export declare function buildCardKitStreamingCard(opts: {
+    buffer: string;
+    status?: string | undefined;
+    streamingMode: boolean;
+    toolCalls?: readonly ToolCallEntry[] | undefined;
+    askRequest?: LarkInputRequest | null | undefined;
+    reasoningText?: string | undefined;
+    footerMetrics?: LarkCardFooterMetrics | undefined;
+}): CardKitV2Card;
+/**
+ * Build a non-streaming CardKit v2 card with the final text. Used as the
+ * terminal patch when the turn completes.
+ */
+export declare function buildCardKitFinalCard(text: string, toolCalls?: readonly ToolCallEntry[] | undefined, askRequest?: LarkInputRequest | null | undefined, reasoningText?: string | undefined, footerMetrics?: LarkCardFooterMetrics | undefined): CardKitV2Card;
+//# sourceMappingURL=card.d.ts.map

package/dist/card.d.ts.map

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

package/dist/channel.d.ts

@@ -0,0 +1,28 @@
+import { type Channel } from "eve/channels";
+import type { LarkChannelOptions, LarkContinuationToken } from "./types.js";
+/**
+ * Continuation token format: `${chatId}:${rootMessageId ?? "_"}`.
+ * The framework prepends the channel file stem before handing the token to
+ * the runtime; consumers should call this helper rather than concatenate.
+ */
+export declare function larkContinuationToken(chatId: string, rootMessageId: string | null): LarkContinuationToken;
+/**
+ * Create a Lark/Feishu channel for the eve agent framework.
+ *
+ * The channel mounts a single POST webhook that verifies the request,
+ * decrypts the body when an encrypt key is configured, deduplicates events
+ * by id, parses the inbound message, and starts or resumes an eve session.
+ *
+ * Streaming happens via eve's native channel events: `message.appended`
+ * drives live card patches, `message.completed` finalizes the card, and
+ * `turn.failed` aborts it. In `replyMode: "static"` the controller is
+ * skipped and `message.completed` delivers a single card.
+ *
+ * **Delivery guarantee**: every terminal event (`message.completed` or
+ * `turn.failed`) delivers *something* to the user. If the streaming card
+ * path fails, we fall back to a fresh card; if that fails, plain text; if
+ * even that fails, the error is logged. The user is never left looking at
+ * a typing-emoji reaction with no reply.
+ */
+export declare function createLarkChannel(optionsInput: LarkChannelOptions): Channel<undefined, Record<string, unknown>, Record<string, unknown>>;
+//# sourceMappingURL=channel.d.ts.map

package/dist/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,OAAO,EAEb,MAAM,cAAc,CAAC;AAoCtB,OAAO,KAAK,EAEV,kBAAkB,EAClB,qBAAqB,EAUtB,MAAM,YAAY,CAAC;AA2GpB;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,qBAAqB,CAEvB;AAoZD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,kBAAkB,GAC/B,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAusDtE"}

package/dist/crypto.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Verify an `X-Lark-Signature` header against the raw webhook body.
+ *
+ * Feishu computes: `sha256(timestamp + nonce + encrypt_key + body)` and ships
+ * the hex digest (optionally prefixed with `sha256=`) in `X-Lark-Signature`.
+ * We concatenate the string parts first, then the raw bytes of the body, to
+ * avoid a UTF-8 round-trip on the request body.
+ *
+ * Constant-time compare. Returns false on length mismatch instead of throwing.
+ */
+export declare function verifySignature(opts: {
+    timestamp: string;
+    nonce: string;
+    encryptKey: string;
+    rawBody: Buffer;
+    signatureHeader: string;
+}): boolean;
+/**
+ * Decrypt the `encrypt` field from a Feishu webhook body.
+ *
+ * Layout:
+ *   key = SHA256(encrypt_key)              // 32 bytes → AES-256
+ *   buf = base64decode(encrypt_field)
+ *   iv  = buf[0:16]
+ *   ct  = buf[16:]                        // AES-256-CBC ciphertext
+ *   plaintext = AES_256_CBC_decrypt(key, iv, ct)  // PKCS#7 unpadded
+ *
+ * Returns the raw plaintext bytes. The caller is expected to JSON.parse them.
+ */
+export declare function decryptPayload(encryptB64: string, encryptKey: string): Buffer;
+//# sourceMappingURL=crypto.d.ts.map

package/dist/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CASV;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CA0B7E"}

package/dist/dedup.d.ts

@@ -0,0 +1,28 @@
+/**
+ * In-process deduplication for Feishu webhook events.
+ *
+ * Feishu retries delivery on non-2xx responses and during brief outage windows,
+ * so consumers must idempotently ack events they've already seen. We key by
+ * `header.event_id` (or `message.message_id` as a fallback) and remember each
+ * key for the TTL window.
+ *
+ * Backed by an insertion-ordered Map so FIFO eviction is O(1) at the front.
+ * Lazy sweep on every insert prevents unbounded growth of expired entries;
+ * no `setInterval` so this is safe in serverless.
+ */
+export declare class DedupMap {
+    private readonly entries;
+    private readonly ttlMs;
+    private readonly maxEntries;
+    private insertsSinceSweep;
+    constructor(ttlMs: number, maxEntries: number);
+    has(key: string): boolean;
+    set(key: string): void;
+    /**
+     * Walk the insertion-ordered map from the front and drop expired entries.
+     * Stops at the first non-expired entry since events arrive roughly in time
+     * order. Called on every set, so cost is amortized.
+     */
+    private maybeSweep;
+}
+//# sourceMappingURL=dedup.d.ts.map

package/dist/dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../src/dedup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,iBAAiB,CAAK;IAE9B,YAAY,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAG5C;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQxB;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAWrB;IAED;;;;OAIG;IACH,OAAO,CAAC,UAAU;CAYnB"}

package/dist/errors.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Typed error hierarchy for eve-lark.
+ *
+ * All errors extend a common base so consumers can `instanceof LarkChannelError`
+ * to catch anything thrown by the channel.
+ */
+export declare class LarkChannelError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class LarkConfigError extends LarkChannelError {
+}
+export declare class LarkSignatureError extends LarkChannelError {
+}
+export declare class LarkDecryptError extends LarkChannelError {
+}
+export interface LarkApiErrorBody {
+    code?: number | undefined;
+    msg?: string | undefined;
+}
+export declare class LarkApiError extends LarkChannelError {
+    readonly code: number | undefined;
+    readonly body: LarkApiErrorBody | undefined;
+    readonly status: number | undefined;
+    constructor(message: string, opts?: {
+        code?: number | undefined;
+        body?: LarkApiErrorBody | undefined;
+        status?: number | undefined;
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACF;AAED,qBAAa,eAAgB,SAAQ,gBAAgB;CAAG;AAExD,qBAAa,kBAAmB,SAAQ,gBAAgB;CAAG;AAE3D,qBAAa,gBAAiB,SAAQ,gBAAgB;CAAG;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,qBAAa,YAAa,SAAQ,gBAAgB;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAEpC,YACE,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,IAAI,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;QACpC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,EAMF;CACF"}

package/dist/event-policy.d.ts

@@ -0,0 +1,29 @@
+import type { LarkChatType, LarkEventHeader } from "./types.js";
+export declare function isEventOwnedByApp(header: Pick<LarkEventHeader, "app_id"> | undefined, appId: string): boolean;
+export declare function isEventExpired(header: Pick<LarkEventHeader, "create_time"> | undefined, nowMs: number, ttlMs: number): boolean;
+export declare function isAbortText(text: string): boolean;
+export declare class ChatTaskQueue {
+    private readonly chains;
+    enqueue<T>(key: string, task: () => Promise<T>): Promise<T>;
+    has(key: string): boolean;
+}
+export declare class BotLoopGuard {
+    private readonly maxBotTurns;
+    private readonly counts;
+    constructor(opts: {
+        maxBotTurns: number;
+    });
+    record(key: string, senderType: "user" | "app"): boolean;
+}
+export interface ParsedReactionCreated {
+    sourceMessageId: string;
+    chatId: string | null;
+    chatType: LarkChatType | null;
+    messageId: string;
+    senderOpenId: string;
+    text: string;
+    rootId: string | null;
+    parentId: string | null;
+}
+export declare function parseReactionCreatedEvent(event: unknown): ParsedReactionCreated | null;
+//# sourceMappingURL=event-policy.d.ts.map

package/dist/event-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-policy.d.ts","sourceRoot":"","sources":["../src/event-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEhE,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,GAAG,SAAS,EACnD,KAAK,EAAE,MAAM,GACZ,OAAO,CAGT;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,GAAG,SAAS,EACxD,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAKT;AA0BD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOjD;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAE3D,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAc1D;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAExB;CACF;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IAEpD,YAAY,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,EAExC;IAED,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAQvD;CACF;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,GAAG,IAAI,CA0CtF"}

package/dist/feishu-emoji.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Valid Feishu emoji type strings for the message-reactions API.
+ *
+ * Feishu emoji types are case-sensitive and inconsistent: most are uppercase
+ * (`THUMBSUP`, `OK`), but a meaningful subset is CamelCase (`Typing`,
+ * `CrossMark`, `EatingFood`, `Drumstick`, …). Passing the wrong case fails
+ * with HTTP 400 code=231001 "reaction type is invalid" — silent unless the
+ * caller is watching logs.
+ *
+ * Source: openclaw-lark's `VALID_FEISHU_EMOJI_TYPES` (which references the
+ * official Feishu emoji doc).
+ */
+export declare const VALID_FEISHU_EMOJI_TYPES: ReadonlySet<string>;
+/** Returns true iff `s` is a valid Feishu emoji type string (case-sensitive). */
+export declare function isValidFeishuEmojiType(s: string): boolean;
+//# sourceMappingURL=feishu-emoji.d.ts.map

package/dist/feishu-emoji.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feishu-emoji.d.ts","sourceRoot":"","sources":["../src/feishu-emoji.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,MAAM,CA8BvD,CAAC;AAEH,iFAAiF;AACjF,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAEzD"}