@niq.run/lark-worker 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,71 @@
-# Temporary Holding Version
+# @niq.run/lark-worker
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A **Feishu / Lark WebSocket bridge** for [niq](https://github.com/niq-run/niq).
+It listens for Feishu messages, forwards them to a bound **reason worker** as
+`worker.input` events, and pushes the reason worker's reply back into the
+Feishu chat. Chat → worker routing is persistent and reconfigurable at runtime
+(per-chat → default → fallback).
+
+Built on [`@niq.run/worker-sdk`](https://www.npmjs.com/package/@niq.run/worker-sdk).
+It is an out-of-process extension worker: it connects to a niq bus over
+HTTP + SSE and is meant to be launched by the niq project supervisor (or by you,
+for a standalone bridge).
+
+## Install
+
+```sh
+npm install -g @niq.run/lark-worker
+```
+
+## Run
+
+The package ships a `niq-lark` bin (compiled app entry `dist/start.js`), so you
+can start it directly — with `npx` (no install needed):
+
+```sh
+# npx — most convenient for launching, e.g. from a niq project's worker config
+npx @niq.run/lark-worker --reason-worker reason.sales
+
+# same thing once installed globally
+niq-lark --reason-worker reason.sales
+
+# or run it via node from a checkout
+node dist/start.js --reason-worker reason.sales
+```
+
+Connection to the bus comes from the environment the supervisor injects
+(`NIQ_BUS_URL`, `NIQ_WORKER_ID`, `NIQ_WORKER_CREDENTIAL`), so a niq project can
+spawn it with `npx @niq.run/lark-worker` and nothing else. CLI flags override
+the env.
+
+## Configuration
+
+| Purpose | Env | Flag |
+|---|---|---|
+| Feishu app id | `LARK_APP_ID` | `--app-id` |
+| Feishu app secret | `LARK_APP_SECRET` | `--app-secret` |
+| Feishu/Lark domain | `LARK_DOMAIN` | `--domain` |
+| Proactive message recipient | `LARK_DEFAULT_USER_ID` | `--default-user` |
+| **Default reason worker** | `NIQ_REASON_WORKER` | `--reason-worker` |
+| **Fallback reason worker** | `LARK_FALLBACK_REASON_WORKER` | `--fallback-reason-worker` |
+| **Per-chat routing** | `LARK_REASON_WORKER_MAPPINGS` | `--reason-mappings` |
+| Persisted routing state | `LARK_STATE_FILE` | `--state-file` |
+
+At least one of the default or fallback reason worker must be configured.
+Run `niq-lark --help` for the full flag list.
+
+## Usage in code
+
+```ts
+import { LarkWorker, larkConfigFromEnv } from "@niq.run/lark-worker";
+```
+
+## Details
+
+See [`src/README.md`](src/README.md) for the full design: the `worker.input`
+flow, `lark.reason.*` runtime routing (`lark.reason.set` / `unset` / `get`),
+and the persisted routing state (`LARK_STATE_FILE`).
+
+## License
+
+MIT

package/dist/start.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=start.d.ts.map

package/dist/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":""}

package/dist/start.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+/**
+ * Shipped as the binary `niq-lark` (@niq.run/lark-worker). Entry point for
+ * running the Lark/Feishu worker as its own process (the "worker as an app"
+ * model):
+ *
+ *   node dist/start.js [--key value ...]
+ *
+ * Feishu long-connection + bus bridge to reason workers. Connects to Feishu
+ * (LARK_APP_ID / LARK_APP_SECRET) and the bus (NIQ_BUS_URL /
+ * NIQ_WORKER_ID / NIQ_WORKER_CREDENTIAL, merged by the SDK helper
+ * `busConnFromArgs`); forwards Feishu messages as worker.input to the default
+ * worker named by NIQ_REASON_WORKER (overridable per-chat via --reason-mappings
+ * / LARK_REASON_WORKER_MAPPINGS, a JSON object of {chat_id: worker_id}). When
+ * neither a per-chat mapping nor the default resolves, messages go to the
+ * last-resort fallback named by --fallback-reason-worker /
+ * LARK_FALLBACK_REASON_WORKER. The chat→worker routing is persisted
+ * (--state-file / LARK_STATE_FILE, default ./lark-reason-state.json).
+ *
+ * Proactive reason→lark messages use lark.send with no target and fall back to
+ * --default-user / LARK_DEFAULT_USER_ID (a Feishu open_id) when the reason
+ * worker supplies no explicit target.
+ */
+import { HTTPWorkerClient, busConnFromArgs, parseCliArgs, runWorkerApp, } from "@niq.run/worker-sdk";
+import { LarkWorker, larkConfigFromEnv } from "./worker.js";
+function usage() {
+    console.error("usage: niq-lark [--key value ...]\n" +
+        "  --bus-url <url>      bus base URL (else NIQ_BUS_URL)\n" +
+        "  --worker-id <id>     bus identity (else NIQ_WORKER_ID)\n" +
+        "  --credential <cred>  bus credential (else NIQ_WORKER_CREDENTIAL)\n" +
+        "  lark: --app-id <id>, --app-secret <secret> (default: LARK_APP_ID / LARK_APP_SECRET), " +
+        "--default-user <open_id> (default: LARK_DEFAULT_USER_ID), --reason-worker <id> (default: NIQ_REASON_WORKER), " +
+        "--fallback-reason-worker <id> (default: LARK_FALLBACK_REASON_WORKER), " +
+        "--reason-mappings <json> (default: LARK_REASON_WORKER_MAPPINGS; {chat_id: worker_id}), " +
+        "--state-file <path> (default: LARK_STATE_FILE / ./lark-reason-state.json)");
+}
+const { help, opts } = parseCliArgs(process.argv);
+if (help) {
+    usage();
+    process.exit(0);
+}
+await runWorkerApp(async () => {
+    const bus = new HTTPWorkerClient(busConnFromArgs(opts));
+    const reasonWorkerID = String(opts["reason-worker"] ?? process.env.NIQ_REASON_WORKER ?? process.env.LARK_REASON_WORKER ?? "");
+    const fallbackReasonWorkerID = String(opts["fallback-reason-worker"] ?? process.env.LARK_FALLBACK_REASON_WORKER ?? "");
+    if (!reasonWorkerID && !fallbackReasonWorkerID) {
+        throw new Error("at least one of NIQ_REASON_WORKER / --reason-worker or LARK_FALLBACK_REASON_WORKER / --fallback-reason-worker must be set (bound reason worker id; fallback is the last resort)");
+    }
+    const lark = larkConfigFromEnv();
+    if (opts["app-id"] !== undefined)
+        lark.appId = String(opts["app-id"]);
+    if (opts["app-secret"] !== undefined)
+        lark.appSecret = String(opts["app-secret"]);
+    if (opts["domain"] !== undefined)
+        lark.domain = String(opts["domain"]);
+    const defaultUserOpenId = String(opts["default-user"] ?? process.env.LARK_DEFAULT_USER_ID ?? "");
+    // Optional initial chat → reason worker routing from config.
+    let reasonWorkerMappings;
+    const mappingsRaw = opts["reason-mappings"] ?? process.env.LARK_REASON_WORKER_MAPPINGS;
+    if (mappingsRaw) {
+        let parsed;
+        try {
+            parsed = JSON.parse(String(mappingsRaw));
+        }
+        catch (err) {
+            throw new Error(`invalid reason mappings JSON: ${err.message}`);
+        }
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+            throw new Error("reason mappings must be an object of {chat_id: worker_id}");
+        }
+        reasonWorkerMappings = parsed;
+    }
+    const stateFile = String(opts["state-file"] ?? process.env.LARK_STATE_FILE ?? "");
+    const workerOpts = {
+        ...lark,
+        bus,
+        ...(reasonWorkerID ? { reasonWorkerID } : {}),
+        ...(fallbackReasonWorkerID ? { fallbackReasonWorkerID } : {}),
+        ...(reasonWorkerMappings ? { reasonWorkerMappings } : {}),
+        ...(stateFile ? { stateFile } : {}),
+        ...(defaultUserOpenId ? { defaultUserOpenId } : {}),
+    };
+    const worker = new LarkWorker(workerOpts);
+    await worker.run();
+});
+//# sourceMappingURL=start.js.map

package/dist/start.js.map

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

package/dist/worker.d.ts

@@ -0,0 +1,221 @@
+import type { LarkChannelOptions, NormalizedMessage, RejectEvent, SendInput } from "@larksuite/channel";
+import { type WorkerSideChannel } from "@niq.run/worker-sdk";
+/** Minimal surface of `@larksuite/channel` this worker uses. Injectable for tests. */
+export interface LarkChannel {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    on(name: "message", handler: (msg: NormalizedMessage) => void | Promise<void>): () => void;
+    on(name: "error", handler: (err: unknown) => void | Promise<void>): () => void;
+    on(name: "reject", handler: (evt: RejectEvent) => void | Promise<void>): () => void;
+    on(name: "reconnecting" | "reconnected", handler: () => void | Promise<void>): () => void;
+    onRawEvent(type: string, handler: (payload: unknown) => void | Promise<void>): () => void;
+    send(to: string, input: SendInput): Promise<{
+        messageId: string;
+    }>;
+    /** Rewrite an already-sent text message's content in place (Feishu message edit). */
+    editMessage(messageId: string, text: string): Promise<void>;
+}
+/** A minimal logger interface, satisfied by `console`. */
+export interface Logger {
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+}
+/** Wrap a logger so every line is prefixed with an ISO timestamp. */
+export declare function withTimestamps<T extends Logger>(base: T): T;
+/** The subset of the `fs/promises` API the file state store uses. Injectable. */
+export interface StateFileFs {
+    mkdir(dir: string, opts: {
+        recursive: boolean;
+    }): Promise<string | undefined>;
+    readFile(file: string, enc: "utf8"): Promise<string>;
+    writeFile(file: string, data: string, enc: "utf8"): Promise<void>;
+    rename(oldPath: string, newPath: string): Promise<void>;
+}
+/**
+ * Persistence for the reason-routing state. Injected for tests; the default
+ * is {@link FileLarkStateStore}. This is the seam a future snapshot/restore
+ * implementation can plug into without touching the worker's logic.
+ */
+export interface LarkStateStore {
+    load(): Promise<Record<string, unknown>>;
+    save(state: Record<string, unknown>): Promise<void>;
+}
+/**
+ * A {@link LarkStateStore} backed by a local JSON file, written atomically
+ * (temp file + rename) so a crash mid-write cannot corrupt the saved state.
+ * A missing file loads as an empty state.
+ */
+export declare class FileLarkStateStore implements LarkStateStore {
+    private readonly file;
+    private readonly fs;
+    constructor(file: string, fsImpl?: StateFileFs);
+    load(): Promise<Record<string, unknown>>;
+    save(state: Record<string, unknown>): Promise<void>;
+}
+/** The default state file path when none is configured. */
+export declare function defaultStateFile(env?: Record<string, string | undefined>): string;
+/** Connection settings for the Lark side, read from the environment by default. */
+export interface LarkConfig {
+    appId: string;
+    appSecret: string;
+    /** Request domain, e.g. `https://open.feishu.cn` (default) or a Lark domain. */
+    domain?: string;
+    /** Extra options forwarded to the channel (see {@link LarkChannelOptions}). */
+    channel?: Omit<LarkChannelOptions, "appId" | "appSecret" | "domain">;
+    /** Injectable factory — defaults to {@link createLarkChannel}. */
+    createChannel?: (opts: LarkChannelOptions) => LarkChannel;
+}
+/** Build a {@link LarkConfig} from env. Throws naming any missing vars. */
+export declare function larkConfigFromEnv(env?: Record<string, string | undefined>): LarkConfig;
+/** Configuration for the assembled bridge. */
+export interface LarkBridgeOptions extends LarkConfig {
+    /** Worker-side bus channel. Injected for tests; built from env otherwise. */
+    bus: WorkerSideChannel;
+    /**
+     * The default reason worker Feishu messages are forwarded to when a chat has
+     * no per-chat override (see {@link LarkBridgeOptions.reasonWorkerMappings}),
+     * unless a persisted state file overrides it. Optional: when unset, routing
+     * falls through to {@link LarkBridgeOptions.fallbackReasonWorkerID}. Config
+     * only seeds this value.
+     */
+    reasonWorkerID?: string;
+    /**
+     * The last-resort reason worker used when neither a per-chat mapping nor the
+     * default resolves. Optional; config only seeds it (mutable at runtime and
+     * persisted like the rest of the routing).
+     */
+    fallbackReasonWorkerID?: string;
+    /**
+     * Initial chat_id → reason worker id routing. Config only seeds the runtime
+     * map; it is updateable at runtime via the `lark.reason.*` extensions and
+     * persisted (see {@link LarkBridgeOptions.stateStore}).
+     */
+    reasonWorkerMappings?: Record<string, string>;
+    /**
+     * Persistence backend for the reason-routing state. Defaults to a local JSON
+     * file at {@link LarkBridgeOptions.stateFile}. Inject for tests to avoid I/O.
+     * This is the seam a future snapshot/restore implementation plugs into.
+     */
+    stateStore?: LarkStateStore;
+    /**
+     * Path for the default file state store (ignored when `stateStore` is given).
+     * Falls back to `LARK_STATE_FILE`, then `./lark-reason-state.json`.
+     */
+    stateFile?: string;
+    /**
+     * Optional replacement for the default `<system-reminder>` prepended to
+     * outbound worker.input text.
+     */
+    systemReminder?: string;
+    /** When set, echo Feishu messages back instead of forwarding (connectivity check). */
+    echo?: boolean;
+    /**
+     * Default Feishu user (open_id) a `lark.send` call falls back to when the
+     * reason worker does not supply an explicit `target` (e.g. a proactive push
+     * with no chat context). Without a target and no default user, the call
+     * fails with `request.failed`.
+     */
+    defaultUserOpenId?: string;
+    /**
+     * When a reason worker makes several `lark.send` calls to the same target
+     * within one reply turn, append each piece of text onto the message it last
+     * sent to that target (updating it in place via Feishu's message edit) instead
+     * of posting a brand-new message per call. Each new inbound Feishu message
+     * starts a fresh target message. Defaults to `true`.
+     */
+    appendOutbound?: boolean;
+    /** Where to send diagnostics. Defaults to `console`. */
+    logger?: Logger;
+}
+/**
+ * The extension lark exposes to peers (reason) for sending a Feishu message to
+ * a user/chat. Non-SelfOnly so it is discovered by reason and callable.
+ */
+export declare const LARK_SEND_EVENT = "lark.send";
+/**
+ * The group of extensions lark exposes for managing the chat → reason worker
+ * routing at runtime. All are non-SelfOnly so a control plane / admin peer can
+ * discover and call them. Each mutation also persists the new routing.
+ */
+/** Route a Feishu chat (or set the default) to a specific reason worker. */
+export declare const LARK_REASON_SET = "lark.reason.set";
+/** Stop routing a chat to its own worker; fall back to the default. */
+export declare const LARK_REASON_UNSET = "lark.reason.unset";
+/** Return the current routing (default + per-chat overrides). */
+export declare const LARK_REASON_GET = "lark.reason.get";
+/**
+ * The Feishu ⇄ reason bridge. Connect both sides, then forward Feishu
+ * messages to the bound reason worker and push its replies back to Feishu.
+ */
+export declare class LarkWorker {
+    private readonly lark;
+    private readonly bus;
+    private readonly base;
+    private readonly workerID;
+    /** Default reason worker; overridden per-chat by {@link perChat}. Mutable at runtime. */
+    private defaultReasonWorker;
+    /** Last-resort worker used when neither per-chat nor default resolves. Mutable at runtime. */
+    private fallbackReasonWorker;
+    /** chat_id → reason worker id. Updated by config seed, runtime events, and persisted state. */
+    private readonly perChat;
+    private readonly stateStore;
+    private readonly systemReminder;
+    private readonly echo;
+    private readonly defaultUserOpenId;
+    private readonly appendMode;
+    /** target → the last outbound message this worker is extending (append mode); text is the in-place accumulated content. */
+    private readonly appendTargets;
+    private readonly logger;
+    /** Settled once both the bus and Feishu sides are connected (see connect()). */
+    private readonly ready;
+    private readonly markReady;
+    constructor(opts: LarkBridgeOptions);
+    /** Connect both the Feishu long connection and the bus; announce presence. */
+    connect(): Promise<void>;
+    /** Connect and then run the bus event loop (blocks until {@link close}). */
+    run(): Promise<void>;
+    /** Close both sides. */
+    close(): Promise<void>;
+    private handleFeishuMessage;
+    /**
+     * Resolve the reason worker a chat's messages are forwarded to: per-chat
+     * mapping, else the default, else the last-resort fallback. Returns "" when
+     * none is configured.
+     */
+    private reasonWorkerFor;
+    /**
+     * Restore persisted routing on top of the config seed. A persisted value wins
+     * over config because it is the most recent state (last write wins).
+     */
+    private loadState;
+    /** Persist the current routing. Best-effort: a failed write is logged, not thrown. */
+    private persistState;
+    /** Fill the {chat_id} / {sender_open_id} placeholders in the reminder template. */
+    private renderReminder;
+    /**
+     * Serve the peer-callable lark.send extension: a tool invocation from reason
+     * (via the discovery/tool bridge) carrying `target` (chat_id / open_id /
+     * user_id, falling back to the default user) and `text`. Replied with a
+     * request.completed / request.failed echoing the call id.
+     */
+    private handleLarkSend;
+    /**
+     * Append-mode send: if this target already has an in-progress message from
+     * this turn, extend it in place; otherwise post a fresh message and remember
+     * it. Repeated `lark.send` calls to the same target therefore assemble into
+     * one message instead of flooding the Feishu chat.
+     */
+    private sendAppended;
+    /**
+     * Serve the `lark.reason.set` extension: route a chat to a worker (`chat_id`),
+     * set the default (neither `chat_id` nor `fallback`), or set the last-resort
+     * fallback (`fallback: true`). Persists the change so it survives a restart.
+     */
+    private handleReasonSet;
+    /** Serve the `lark.reason.unset` extension: drop a chat override or clear the fallback. */
+    private handleReasonUnset;
+    /** Serve the `lark.reason.get` extension: return the current routing as JSON. */
+    private handleReasonGet;
+}
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,SAAS,EACV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAOL,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAC;AAE7B,sFAAsF;AACtF,MAAM,WAAW,WAAW;IAC1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,EAAE,CACA,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACxD,MAAM,IAAI,CAAC;IACd,EAAE,CACA,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC9C,MAAM,IAAI,CAAC;IACd,EAAE,CACA,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAClD,MAAM,IAAI,CAAC;IACd,EAAE,CACA,IAAI,EAAE,cAAc,GAAG,aAAa,EACpC,OAAO,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAClC,MAAM,IAAI,CAAC;IACd,UAAU,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAClD,MAAM,IAAI,CAAC;IACd,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,qFAAqF;IACrF,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED,0DAA0D;AAC1D,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACjC;AAED,qEAAqE;AACrE,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAO3D;AAID,iFAAiF;AACjF,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAc;gBAErB,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,WAAoD;IAKhF,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAexC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAM1D;AAED,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAC9B,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,MAAM,CAER;AAED,mFAAmF;AACnF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAC,CAAC;IACrE,kEAAkE;IAClE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,WAAW,CAAC;CAC3D;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAC/B,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,UAAU,CAgBZ;AAcD,8CAA8C;AAC9C,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,6EAA6E;IAC7E,GAAG,EAAE,iBAAiB,CAAC;IACvB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C;;;;OAIG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sFAAsF;IACtF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID;;;GAGG;AACH,eAAO,MAAM,eAAe,cAAc,CAAC;AAE3C;;;;GAIG;AAEH,4EAA4E;AAC5E,eAAO,MAAM,eAAe,oBAAoB,CAAC;AACjD,uEAAuE;AACvE,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AACrD,iEAAiE;AACjE,eAAO,MAAM,eAAe,oBAAoB,CAAC;AAEjD;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,yFAAyF;IACzF,OAAO,CAAC,mBAAmB,CAAS;IACpC,8FAA8F;IAC9F,OAAO,CAAC,oBAAoB,CAAS;IACrC,+FAA+F;IAC/F,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,2HAA2H;IAC3H,OAAO,CAAC,QAAQ,CAAC,aAAa,CAG1B;IACJ,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,gFAAgF;IAChF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;gBAE3B,IAAI,EAAE,iBAAiB;IAwJnC,8EAA8E;IACxE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC9B,4EAA4E;IACtE,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAY1B,wBAAwB;IAClB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAOd,mBAAmB;IA8CjC;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAOvB;;;OAGG;YACW,SAAS;IA0BvB,sFAAsF;YACxE,YAAY;IAY1B,mFAAmF;IACnF,OAAO,CAAC,cAAc;IAMtB;;;;;OAKG;YACW,cAAc;IAmD5B;;;;;OAKG;YACW,YAAY;IAmB1B;;;;OAIG;YACW,eAAe;IA8B7B,2FAA2F;YAC7E,iBAAiB;IA2B/B,iFAAiF;YACnE,eAAe;CAY9B"}

package/dist/worker.js

@@ -0,0 +1,552 @@
+/**
+ * Lark worker — a WebSocket bridge between the niq event bus and Feishu/Lark,
+ * built on `@larksuite/channel` (which wraps the official
+ * `@larksuiteoapi/node-sdk`).
+ *
+ * Flow:
+ *   Feishu message ──worker.input──▶ bound reason worker
+ *   reason reply   ──lark.send────▶ this worker      ──send──▶ Feishu chat
+ *
+ * Inbound: every Feishu message is forwarded to a single bound reason worker
+ * as a `worker.input` event with `input_mode: "append"`, payload
+ * `{ text, chat_id, sender_open_id }`. The text is prefixed with a
+ * `<system-reminder>` telling reason this came from Feishu and to reply with
+ * the `lark.send` extension targeting the `chat_id`.
+ *
+ * Outbound: the reason worker replies by calling the `lark.send` extension
+ * (exposed by this worker) with `target` (a chat_id / open_id / user_id) and
+ * `text`. This worker sends that text to the target Feishu chat. The worker
+ * does NOT consume `worker.input` events as replies — `lark.send` is the only
+ * inbound path for reason → Feishu output.
+ *
+ * Credentials come from the environment: `LARK_APP_ID` / `LARK_APP_SECRET`
+ * (+ `LARK_DOMAIN`), and the bus via `NIQ_BUS_URL` / `NIQ_WORKER_ID` /
+ * `NIQ_WORKER_CREDENTIAL` — the niq project supervisor injects these as launch
+ * args (project.json env). The default reason worker id comes from
+ * `NIQ_REASON_WORKER`; an initial per-chat override map can come from
+ * `LARK_REASON_WORKER_MAPPINGS` (a JSON object of {chat_id: worker_id}).
+ *
+ * Routing (which reason worker a Feishu chat is forwarded to) is a mutable,
+ * persisted property: configured on startup, updated at runtime via the
+ * `lark.reason.*` extension group, and saved to a state file so it survives
+ * restarts. The runtime saves it via an injectable {@link LarkStateStore}.
+ * (Third-party process snapshot/restore is not implemented yet; the worker
+ * persists its own state for now.)
+ *
+ * Both external sides sit behind narrow interfaces so tests run without real
+ * Feishu credentials or a live bus.
+ */
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { createLarkChannel } from "@larksuite/channel";
+import { BaseWorker, argString, createEvent, EventType, parseToolCall, } from "@niq.run/worker-sdk";
+/** Wrap a logger so every line is prefixed with an ISO timestamp. */
+export function withTimestamps(base) {
+    const ts = () => new Date().toISOString();
+    for (const m of ["info", "warn", "error"]) {
+        const orig = base[m].bind(base);
+        base[m] = (...args) => orig(`[${ts()}]`, ...args);
+    }
+    return base;
+}
+const DEFAULT_LOGGER = withTimestamps(console);
+/**
+ * A {@link LarkStateStore} backed by a local JSON file, written atomically
+ * (temp file + rename) so a crash mid-write cannot corrupt the saved state.
+ * A missing file loads as an empty state.
+ */
+export class FileLarkStateStore {
+    file;
+    fs;
+    constructor(file, fsImpl = { mkdir, readFile, writeFile, rename }) {
+        this.file = file;
+        this.fs = fsImpl;
+    }
+    async load() {
+        let raw;
+        try {
+            raw = await this.fs.readFile(this.file, "utf8");
+        }
+        catch (err) {
+            // First run: no state file yet — start from config defaults.
+            if (err?.code === "ENOENT")
+                return {};
+            throw err;
+        }
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed)
+            ? parsed
+            : {};
+    }
+    async save(state) {
+        const tmp = `${this.file}.${process.pid}.${Date.now()}.tmp`;
+        await this.fs.mkdir(dirname(this.file), { recursive: true });
+        await this.fs.writeFile(tmp, JSON.stringify(state, null, 2), "utf8");
+        await this.fs.rename(tmp, this.file);
+    }
+}
+/** The default state file path when none is configured. */
+export function defaultStateFile(env = process.env) {
+    return env.LARK_STATE_FILE?.trim() || "lark-reason-state.json";
+}
+/** Build a {@link LarkConfig} from env. Throws naming any missing vars. */
+export function larkConfigFromEnv(env = process.env) {
+    const appId = env.LARK_APP_ID?.trim() ?? "";
+    const appSecret = env.LARK_APP_SECRET?.trim() ?? "";
+    const domain = env.LARK_DOMAIN?.trim() || "https://open.feishu.cn";
+    const missing = [];
+    if (!appId)
+        missing.push("LARK_APP_ID");
+    if (!appSecret)
+        missing.push("LARK_APP_SECRET");
+    if (missing.length > 0) {
+        throw new Error(`niq: missing environment variable(s): ${missing.join(", ")}. ` +
+            `Provide them as launch args (project.json env) when the worker is ` +
+            `started by the niq project supervisor.`);
+    }
+    return { appId, appSecret, domain };
+}
+const DEFAULT_SYSTEM_REMINDER = `<system-reminder>
+This message was sent by a user over Feishu (Lark).
+Chat id: {chat_id}
+Sender open_id: {sender_open_id}
+Reply to the user by calling the lark.send tool with target = "{chat_id}" and
+text = your reply. The reply is delivered straight back into the user's Feishu
+chat. Several lark.send calls to the same target within one reply are appended
+into a single message, so just send your answer — do not number or header each
+piece. Keep your answer in the language the user wrote in, and do not preface it
+with any system notes.
+</system-reminder>`;
+const NS = "lark";
+/**
+ * The extension lark exposes to peers (reason) for sending a Feishu message to
+ * a user/chat. Non-SelfOnly so it is discovered by reason and callable.
+ */
+export const LARK_SEND_EVENT = "lark.send";
+/**
+ * The group of extensions lark exposes for managing the chat → reason worker
+ * routing at runtime. All are non-SelfOnly so a control plane / admin peer can
+ * discover and call them. Each mutation also persists the new routing.
+ */
+/** Route a Feishu chat (or set the default) to a specific reason worker. */
+export const LARK_REASON_SET = "lark.reason.set";
+/** Stop routing a chat to its own worker; fall back to the default. */
+export const LARK_REASON_UNSET = "lark.reason.unset";
+/** Return the current routing (default + per-chat overrides). */
+export const LARK_REASON_GET = "lark.reason.get";
+/**
+ * The Feishu ⇄ reason bridge. Connect both sides, then forward Feishu
+ * messages to the bound reason worker and push its replies back to Feishu.
+ */
+export class LarkWorker {
+    lark;
+    bus;
+    base;
+    workerID;
+    /** Default reason worker; overridden per-chat by {@link perChat}. Mutable at runtime. */
+    defaultReasonWorker;
+    /** Last-resort worker used when neither per-chat nor default resolves. Mutable at runtime. */
+    fallbackReasonWorker;
+    /** chat_id → reason worker id. Updated by config seed, runtime events, and persisted state. */
+    perChat = new Map();
+    stateStore;
+    systemReminder;
+    echo;
+    defaultUserOpenId;
+    appendMode;
+    /** target → the last outbound message this worker is extending (append mode); text is the in-place accumulated content. */
+    appendTargets = new Map();
+    logger;
+    /** Settled once both the bus and Feishu sides are connected (see connect()). */
+    ready;
+    markReady;
+    constructor(opts) {
+        const create = opts.createChannel ?? createLarkChannel;
+        this.lark = create({
+            appId: opts.appId,
+            appSecret: opts.appSecret,
+            domain: opts.domain,
+            ...opts.channel,
+        });
+        this.bus = opts.bus;
+        this.workerID = opts.bus.id;
+        // Config seeds the routing state; a persisted state file overrides it on load.
+        this.defaultReasonWorker = opts.reasonWorkerID ?? "";
+        this.fallbackReasonWorker = opts.fallbackReasonWorkerID ?? "";
+        for (const [chat, wid] of Object.entries(opts.reasonWorkerMappings ?? {})) {
+            if (wid)
+                this.perChat.set(chat, wid);
+        }
+        this.stateStore =
+            opts.stateStore ??
+                new FileLarkStateStore(opts.stateFile ?? defaultStateFile());
+        this.systemReminder = opts.systemReminder ?? DEFAULT_SYSTEM_REMINDER;
+        this.echo = opts.echo ?? false;
+        this.defaultUserOpenId = opts.defaultUserOpenId ?? "";
+        this.appendMode = opts.appendOutbound ?? true;
+        this.logger = opts.logger ?? DEFAULT_LOGGER;
+        this.base = new BaseWorker({
+            id: this.workerID,
+            subscriptions: [
+                { type: LARK_REASON_SET },
+                { type: LARK_REASON_UNSET },
+                { type: LARK_REASON_GET },
+            ],
+            channel: this.bus,
+        });
+        // Expose a peer-callable extension so reason can send Feishu messages with
+        // an explicit target (chat_id / open_id / user_id). Non-SelfOnly so it is
+        // discovered by reason and invoked via the tool-name bridge.
+        this.base.register({
+            event: LARK_SEND_EVENT,
+            description: "Send a message to a Feishu user or chat. Provide target (chat_id, open_id, or user_id) and text.",
+            parameters: {
+                type: "object",
+                properties: {
+                    target: {
+                        type: "string",
+                        description: "Feishu chat_id, open_id, or user_id of the recipient",
+                    },
+                    text: { type: "string", description: "Message text" },
+                },
+            },
+        }, (evt) => this.handleLarkSend(evt));
+        // The lark.reason.* group: manage the chat → reason worker routing at
+        // runtime. Every mutation is persisted so the routing survives restarts.
+        this.base.register({
+            event: LARK_REASON_SET,
+            description: "Route a Feishu chat to a reason worker, set the default, or set the fallback. " +
+                "Provide worker_id. Include chat_id to route only that chat; include fallback=true " +
+                "(no chat_id) to set the last-resort fallback; otherwise the default reason worker is set.",
+            parameters: {
+                type: "object",
+                properties: {
+                    chat_id: {
+                        type: "string",
+                        description: "Feishu chat_id to route (omit to set the default or fallback)",
+                    },
+                    worker_id: {
+                        type: "string",
+                        description: "Reason worker id to route matching messages to",
+                    },
+                    fallback: {
+                        type: "boolean",
+                        description: "Set the last-resort fallback reason worker instead of the default (ignored when chat_id is given)",
+                    },
+                },
+            },
+        }, (evt) => this.handleReasonSet(evt));
+        this.base.register({
+            event: LARK_REASON_UNSET,
+            description: "Stop routing a Feishu chat to its own reason worker and fall back to the default, " +
+                "or clear the fallback. Provide chat_id to drop a chat override; include fallback=true " +
+                "(chat_id optional) to clear the fallback.",
+            parameters: {
+                type: "object",
+                properties: {
+                    chat_id: {
+                        type: "string",
+                        description: "Feishu chat_id to stop overriding, falling back to the default",
+                    },
+                    fallback: {
+                        type: "boolean",
+                        description: "Clear the fallback reason worker",
+                    },
+                },
+            },
+        }, (evt) => this.handleReasonUnset(evt));
+        this.base.register({
+            event: LARK_REASON_GET,
+            description: "Return the current chat → reason worker routing (default + per-chat overrides).",
+        }, (evt) => this.handleReasonGet(evt));
+        let markReady;
+        this.ready = new Promise((resolve) => {
+            markReady = resolve;
+        });
+        this.markReady = markReady;
+        // The message handler is registered once, in the constructor, so a Feishu
+        // message can never be missed due to connect() ordering. handleFeishuMessage
+        // awaits this.ready before touching the bus, which preserves the original
+        // guarantee: we never publish to the bus before it is connected (the WS can
+        // be live before the bus SSE is ready).
+        this.lark.on("message", (msg) => this.handleFeishuMessage(msg));
+        this.lark.on("error", (err) => this.logger.error(`[${NS}] feishu error:`, err));
+        this.lark.on("reject", (evt) => this.logger.warn(`[${NS}] feishu message REJECTED by policy: ${JSON.stringify(evt)}`));
+        // Lowest-level probe: logs any im.message.receive_v1 the WS actually
+        // delivers, before normalization / policy. If this fires but the
+        // normalized 'message' event does not, the drop is in the channel's
+        // normalization or policy layer, not in Feishu delivery.
+        this.lark.onRawEvent("im.message.receive_v1", () => this.logger.info(`[${NS}] raw im.message.receive_v1 received on WS`));
+        this.lark.on("reconnecting", () => this.logger.warn(`[${NS}] feishu websocket reconnecting`));
+        this.lark.on("reconnected", () => this.logger.info(`[${NS}] feishu websocket reconnected`));
+    }
+    /** Connect both the Feishu long connection and the bus; announce presence. */
+    async connect() {
+        await Promise.all([
+            this.bus.connect().catch((err) => {
+                this.logger.error(`[${NS}] bus connect failed:`, err);
+                throw err;
+            }),
+            this.lark.connect().catch((err) => {
+                this.logger.error(`[${NS}] feishu connect failed:`, err);
+                throw err;
+            }),
+        ]);
+        // Restore persisted routing before being ready, so the first Feishu message
+        // already uses the saved chat → reason worker mapping.
+        await this.loadState();
+        this.markReady();
+        this.logger.info(`[${NS}] connected: bus worker_id=${this.workerID} default_reason=${this.defaultReasonWorker || "—"} fallback=${this.fallbackReasonWorker || "—"} per_chat=${this.perChat.size} feishu app=${this.lark.constructor.name}`);
+        // Presence is live-only, not durable history. The SDK's announceReady would
+        // persist this worker.ready into the project event store (it sets no
+        // transient flag); a presence stalling the durable log is noise. Broadcast
+        // a transient ready instead so lark's presence never lands in events.db.
+        const ready = createEvent(EventType.WorkerReady, {
+            type: "lark",
+            watch: this.base.watchEntries(false),
+            publishes: [
+                { type: "worker.input", description: "Feishu messages forwarded to reason" },
+            ],
+        });
+        ready.transient = true; // presence: live-only, not durable history
+        ready.exclude_worker_id = this.workerID;
+        await this.base.channel.broadcast(ready);
+        this.logger.info(`[${NS}] announced worker.ready (transient)`);
+    }
+    /** Connect and then run the bus event loop (blocks until {@link close}). */
+    async run() {
+        await this.connect();
+        // The worker never acts on `worker.input` events — reason does not reply
+        // to lark that way. Replies arrive only via the `lark.send` extension, and
+        // routing is managed via the `lark.reason.*` extensions; every event is
+        // dispatched to the registered extension handlers (unknown events are
+        // ignored).
+        for await (const evt of this.bus.events()) {
+            this.base.dispatchExtension(evt);
+        }
+    }
+    /** Close both sides. */
+    async close() {
+        await Promise.all([
+            this.bus.close().catch(() => { }),
+            this.lark.disconnect().catch(() => { }),
+        ]);
+    }
+    async handleFeishuMessage(msg) {
+        // Wait until the bus is connected before doing anything, so we never
+        // publish before the bus is up. The handler is registered in the
+        // constructor, so a message arriving during connect() simply waits here.
+        await this.ready;
+        // Don't relay the bot's own outbound messages if Feishu delivers them.
+        if (msg.senderType === "bot") {
+            this.logger.info(`[${NS}] skip bot-originated message chat=${msg.chatId} msg=${msg.messageId}`);
+            return;
+        }
+        this.logger.info(`[${NS}] feishu message chat=${msg.chatId} msg=${msg.messageId} sender=${msg.senderId} type=${msg.senderType ?? "na"} text=${JSON.stringify(msg.content)}`);
+        if (this.echo) {
+            await this.lark.send(msg.chatId, { text: "echo: " + msg.content });
+            return;
+        }
+        // A new user message begins a fresh reply: forget any in-progress
+        // outbound append so the next lark.send posts a new message instead of
+        // extending the previous turn's.
+        this.appendTargets.delete(msg.chatId);
+        const input = createEvent("worker.input", {
+            text: this.renderReminder(msg) + "\n" + msg.content,
+            chat_id: msg.chatId,
+            sender_open_id: msg.senderId,
+            input_mode: "append",
+        });
+        const reasonWorker = this.reasonWorkerFor(msg.chatId);
+        if (!reasonWorker) {
+            this.logger.warn(`[${NS}] drop feishu message chat=${msg.chatId} msg=${msg.messageId}: no reason worker (no per-chat mapping, default, or fallback)`);
+            return;
+        }
+        await this.bus.send(input, reasonWorker);
+        this.logger.info(`[${NS}] sent worker.input → reason ${reasonWorker} (chat ${msg.chatId})`);
+    }
+    /**
+     * Resolve the reason worker a chat's messages are forwarded to: per-chat
+     * mapping, else the default, else the last-resort fallback. Returns "" when
+     * none is configured.
+     */
+    reasonWorkerFor(chatId) {
+        const perChat = this.perChat.get(chatId);
+        if (perChat)
+            return perChat;
+        if (this.defaultReasonWorker)
+            return this.defaultReasonWorker;
+        return this.fallbackReasonWorker;
+    }
+    /**
+     * Restore persisted routing on top of the config seed. A persisted value wins
+     * over config because it is the most recent state (last write wins).
+     */
+    async loadState() {
+        let state;
+        try {
+            state = await this.stateStore.load();
+        }
+        catch (err) {
+            this.logger.error(`[${NS}] failed to load reason state:`, err);
+            return;
+        }
+        if (typeof state["default_reason_worker"] === "string" && state["default_reason_worker"]) {
+            this.defaultReasonWorker = state["default_reason_worker"];
+        }
+        if (typeof state["fallback_reason_worker"] === "string" && state["fallback_reason_worker"]) {
+            this.fallbackReasonWorker = state["fallback_reason_worker"];
+        }
+        const perChat = state["per_chat"];
+        if (perChat && typeof perChat === "object" && !Array.isArray(perChat)) {
+            this.perChat.clear();
+            for (const [chat, wid] of Object.entries(perChat)) {
+                if (typeof wid === "string" && wid)
+                    this.perChat.set(chat, wid);
+            }
+        }
+        this.logger.info(`[${NS}] loaded reason state: default=${this.defaultReasonWorker || "—"} fallback=${this.fallbackReasonWorker || "—"} per_chat=${this.perChat.size}`);
+    }
+    /** Persist the current routing. Best-effort: a failed write is logged, not thrown. */
+    async persistState() {
+        try {
+            await this.stateStore.save({
+                default_reason_worker: this.defaultReasonWorker,
+                fallback_reason_worker: this.fallbackReasonWorker,
+                per_chat: Object.fromEntries(this.perChat),
+            });
+        }
+        catch (err) {
+            this.logger.error(`[${NS}] failed to persist reason state:`, err);
+        }
+    }
+    /** Fill the {chat_id} / {sender_open_id} placeholders in the reminder template. */
+    renderReminder(msg) {
+        return this.systemReminder
+            .replaceAll("{chat_id}", msg.chatId)
+            .replaceAll("{sender_open_id}", msg.senderId);
+    }
+    /**
+     * Serve the peer-callable lark.send extension: a tool invocation from reason
+     * (via the discovery/tool bridge) carrying `target` (chat_id / open_id /
+     * user_id, falling back to the default user) and `text`. Replied with a
+     * request.completed / request.failed echoing the call id.
+     */
+    async handleLarkSend(evt) {
+        const tc = parseToolCall(evt);
+        const target = argString(tc.args, "target") ||
+            argString(tc.args, "chat_id") ||
+            argString(tc.args, "open_id") ||
+            argString(tc.args, "user_id") ||
+            this.defaultUserOpenId;
+        const text = argString(tc.args, "text");
+        if (!text) {
+            await this.base.replyFailed(tc.callerID, tc.callID, "text is required", tc.traceID);
+            return;
+        }
+        if (!target) {
+            await this.base.replyFailed(tc.callerID, tc.callID, "no target given and no default user open_id configured", tc.traceID);
+            return;
+        }
+        try {
+            if (this.appendMode) {
+                await this.sendAppended(target, text);
+            }
+            else {
+                await this.lark.send(target, { text });
+                this.logger.info(`[${NS}] lark.send → ${target} text=${JSON.stringify(text)}`);
+            }
+            await this.base.replyCompleted(tc.callerID, tc.callID, "sent", tc.traceID);
+        }
+        catch (err) {
+            // Failed mid-append: drop the half-updated entry so the next send starts
+            // a fresh message rather than corrupting the accumulated text.
+            this.appendTargets.delete(target);
+            this.logger.error(`[${NS}] lark.send failed:`, err);
+            await this.base.replyFailed(tc.callerID, tc.callID, err.message, tc.traceID);
+        }
+    }
+    /**
+     * Append-mode send: if this target already has an in-progress message from
+     * this turn, extend it in place; otherwise post a fresh message and remember
+     * it. Repeated `lark.send` calls to the same target therefore assemble into
+     * one message instead of flooding the Feishu chat.
+     */
+    async sendAppended(target, text) {
+        const pending = this.appendTargets.get(target);
+        if (!pending) {
+            const res = await this.lark.send(target, { text });
+            this.appendTargets.set(target, { messageId: res.messageId, text });
+            this.logger.info(`[${NS}] lark.send → ${target} text=${JSON.stringify(text)}`);
+            return;
+        }
+        // Join segments with a single newline so separate sends read as distinct
+        // parts, not run-on text.
+        const merged = pending.text.replace(/\s+$/, "") + "\n" + text.replace(/\s+$/, "");
+        await this.lark.editMessage(pending.messageId, merged);
+        pending.text = merged;
+        this.logger.info(`[${NS}] lark.append → ${target} (extended ${pending.messageId})`);
+    }
+    /**
+     * Serve the `lark.reason.set` extension: route a chat to a worker (`chat_id`),
+     * set the default (neither `chat_id` nor `fallback`), or set the last-resort
+     * fallback (`fallback: true`). Persists the change so it survives a restart.
+     */
+    async handleReasonSet(evt) {
+        const tc = parseToolCall(evt);
+        const workerId = argString(tc.args, "worker_id") || argString(tc.args, "workerId");
+        const chatId = argString(tc.args, "chat_id") || argString(tc.args, "chatId");
+        const isFallback = tc.args["fallback"] === true;
+        if (!workerId) {
+            await this.base.replyFailed(tc.callerID, tc.callID, "worker_id is required", tc.traceID);
+            return;
+        }
+        if (chatId) {
+            this.perChat.set(chatId, workerId);
+            this.logger.info(`[${NS}] lark.reason.set chat=${chatId} → ${workerId}`);
+        }
+        else if (isFallback) {
+            this.fallbackReasonWorker = workerId;
+            this.logger.info(`[${NS}] lark.reason.set fallback → ${workerId}`);
+        }
+        else {
+            this.defaultReasonWorker = workerId;
+            this.logger.info(`[${NS}] lark.reason.set default → ${workerId}`);
+        }
+        await this.persistState();
+        await this.base.replyCompleted(tc.callerID, tc.callID, "ok", tc.traceID);
+    }
+    /** Serve the `lark.reason.unset` extension: drop a chat override or clear the fallback. */
+    async handleReasonUnset(evt) {
+        const tc = parseToolCall(evt);
+        const chatId = argString(tc.args, "chat_id") || argString(tc.args, "chatId");
+        const isFallback = tc.args["fallback"] === true;
+        if (isFallback) {
+            this.fallbackReasonWorker = "";
+            await this.persistState();
+            await this.base.replyCompleted(tc.callerID, tc.callID, "ok", tc.traceID);
+            this.logger.info(`[${NS}] lark.reason.unset fallback cleared`);
+            return;
+        }
+        if (!chatId) {
+            await this.base.replyFailed(tc.callerID, tc.callID, "chat_id is required (or set fallback=true to clear the fallback)", tc.traceID);
+            return;
+        }
+        this.perChat.delete(chatId);
+        await this.persistState();
+        await this.base.replyCompleted(tc.callerID, tc.callID, "ok", tc.traceID);
+        this.logger.info(`[${NS}] lark.reason.unset chat=${chatId} → default ${this.defaultReasonWorker}`);
+    }
+    /** Serve the `lark.reason.get` extension: return the current routing as JSON. */
+    async handleReasonGet(evt) {
+        const tc = parseToolCall(evt);
+        const result = JSON.stringify({
+            default_reason_worker: this.defaultReasonWorker,
+            fallback_reason_worker: this.fallbackReasonWorker,
+            per_chat: Object.fromEntries(this.perChat),
+        });
+        await this.base.replyCompleted(tc.callerID, tc.callID, result, tc.traceID);
+        this.logger.info(`[${NS}] lark.reason.get default=${this.defaultReasonWorker || "—"} fallback=${this.fallbackReasonWorker || "—"} per_chat=${this.perChat.size}`);
+    }
+}
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

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

package/package.json

@@ -1,6 +1,39 @@
 {
   "name": "@niq.run/lark-worker",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Feishu/Lark WebSocket bridge Worker for niq — forwards Feishu messages to a bound reason worker and pushes its replies back. Built on @niq.run/worker-sdk.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/niq-run/workers.git"
+  },
+  "homepage": "https://www.npmjs.com/package/@niq.run/lark-worker",
+  "type": "module",
+  "main": "./dist/worker.js",
+  "types": "./dist/worker.d.ts",
+  "bin": {
+    "niq-lark": "./dist/start.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "release": "git diff --quiet && git diff --cached --quiet || { echo \"Error: git working tree not clean\" >&2; exit 1; } && npm run test && npm run typecheck && npm run build && npm version --no-git-tag-version && npm publish"
+  },
+  "dependencies": {
+    "@larksuite/channel": "^0.6.0",
+    "@niq.run/worker-sdk": "*"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.3",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.0"
+  },
+  "license": "MIT"
 }