@rynx-ai/plugin-channel-lark 0.1.9

package/dist/host-adapters.js

@@ -0,0 +1,404 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { createHash } from "node:crypto";
+import { AgentRuntimeError, } from "@rynx-ai/core";
+import { FileLarkActiveSessionStore, } from "./lark-session-store.js";
+/** Slow consumers fail the run instead of retaining an unbounded event stream. */
+export const LARK_RUN_EVENT_QUEUE_MAX_ITEMS = 256;
+export const LARK_RUN_EVENT_QUEUE_MAX_BYTES = 8 * 1024 * 1024;
+/**
+ * ConversationRuntime-shaped adapter backed exclusively by capability-checked
+ * Host RPC. The plugin never receives the daemon's runtime, abort controller,
+ * steer controller, or session bus.
+ */
+export class HostConversationRuntime {
+    host;
+    constructor(host) {
+        this.host = host;
+    }
+    async runLive(input) {
+        if (!input.threadId) {
+            throw new AgentRuntimeError("a daemon-provisioned session id is required", 400, "session_required");
+        }
+        if (input.signal?.aborted) {
+            throw new AgentRuntimeError("conversation run was cancelled", 499, "codex_cancelled");
+        }
+        const queue = new AsyncEventQueue({
+            maxItems: LARK_RUN_EVENT_QUEUE_MAX_ITEMS,
+            maxBytes: LARK_RUN_EVENT_QUEUE_MAX_BYTES,
+            sizeOf: jsonByteLength,
+            overflowError: runEventQueueOverflowError,
+        });
+        let runId;
+        let terminal = false;
+        const earlyEvents = [];
+        let earlyEventBytes = 0;
+        let earlyOverflow = false;
+        let unsubscribeEvents = () => { };
+        const interrupt = () => {
+            if (!runId || terminal)
+                return;
+            void this.host.call("session.interrupt", { runId }).catch(() => undefined);
+        };
+        const accept = (event, payload) => {
+            if (!runId) {
+                if (earlyOverflow)
+                    return;
+                const bytes = jsonByteLength({ event, payload });
+                if (earlyEvents.length >= LARK_RUN_EVENT_QUEUE_MAX_ITEMS
+                    || bytes > LARK_RUN_EVENT_QUEUE_MAX_BYTES - earlyEventBytes) {
+                    earlyOverflow = true;
+                    earlyEvents.length = 0;
+                    earlyEventBytes = 0;
+                    unsubscribeEvents();
+                    return;
+                }
+                earlyEvents.push({ event, payload });
+                earlyEventBytes += bytes;
+                return;
+            }
+            if (event === "session.run.event") {
+                const value = runEventPayload(payload);
+                if (value?.runId === runId && queue.push(value.event) === "overflow") {
+                    interrupt();
+                    terminal = true;
+                    unsubscribeEvents();
+                }
+                return;
+            }
+            if (event === "session.run.completed") {
+                const value = runTerminalPayload(payload);
+                if (value?.runId === runId) {
+                    terminal = true;
+                    queue.end();
+                }
+                return;
+            }
+            if (event === "session.run.failed") {
+                const value = runTerminalPayload(payload);
+                if (value?.runId === runId) {
+                    terminal = true;
+                    queue.fail(hostRunError(value));
+                }
+            }
+        };
+        unsubscribeEvents = this.host.events.subscribe(({ event, payload }) => accept(event, payload));
+        if (earlyOverflow)
+            unsubscribeEvents();
+        let started;
+        try {
+            started = await this.host.call("session.run", {
+                sessionId: input.threadId,
+                message: input.message,
+                ...(input.provider ? { provider: input.provider } : {}),
+                ...(input.model ? { model: input.model } : {}),
+                ...(input.reasoningEffort ? { reasoningEffort: input.reasoningEffort } : {}),
+                ...(input.cwd ? { cwd: input.cwd } : {}),
+                ...(input.agentName ? { agent: input.agentName } : {}),
+                ...(input.developerInstructions
+                    ? { developerInstructions: input.developerInstructions }
+                    : {}),
+            });
+            runId = started.runId;
+            if (earlyOverflow) {
+                queue.fail(runEventQueueOverflowError(), true);
+                interrupt();
+                terminal = true;
+            }
+            else {
+                for (const early of earlyEvents.splice(0))
+                    accept(early.event, early.payload);
+                earlyEventBytes = 0;
+            }
+        }
+        catch (error) {
+            unsubscribeEvents();
+            throw toAgentRuntimeError(error);
+        }
+        const unsteer = input.steer?.subscribe((text) => {
+            if (!runId || terminal)
+                return;
+            void this.host.call("session.steer", { runId, text }).catch(() => undefined);
+        });
+        input.signal?.addEventListener("abort", interrupt, { once: true });
+        const generator = (async function* () {
+            try {
+                for await (const event of queue)
+                    yield event;
+            }
+            finally {
+                if (!terminal)
+                    interrupt();
+                input.signal?.removeEventListener("abort", interrupt);
+                unsteer?.();
+                unsubscribeEvents();
+            }
+        })();
+        return {
+            provider: started.provider,
+            threadId: started.sessionId,
+            model: started.model,
+            authSource: started.authSource,
+            generator,
+        };
+    }
+}
+/** Agent command adapter used by /models, /goal, and /fork. */
+export class HostAgentCapabilities {
+    host;
+    constructor(host) {
+        this.host = host;
+    }
+    listModels(runtime) {
+        return this.host.call("session.models", runtime ? { runtime } : {});
+    }
+    getGoal(sessionId) {
+        return this.host.call("session.goal.get", { sessionId });
+    }
+    setGoal(sessionId, objective) {
+        return this.host.call("session.goal.set", { sessionId, objective });
+    }
+    clearGoal(sessionId) {
+        return this.host.call("session.goal.clear", { sessionId });
+    }
+    forkSession(fromSessionId, toSessionId) {
+        return this.host.call("session.fork", { fromSessionId, toSessionId });
+    }
+}
+/** Narrow agent catalog + first-turn execution resolver backed by Host RPC. */
+export class HostAgentCatalog {
+    host;
+    constructor(host) {
+        this.host = host;
+    }
+    list() {
+        return this.host.call("agent.catalog.list", {});
+    }
+    get(id) {
+        return this.host.call("agent.catalog.get", { id });
+    }
+    resolveExecution(input) {
+        return this.host.call("agent.execution.resolve", input);
+    }
+}
+/** Daemon-owned session allocator. operationId must identify one allocation attempt durably. */
+export class HostSessionProvisioner {
+    host;
+    instanceId;
+    constructor(host, instanceId) {
+        this.host = host;
+        this.instanceId = instanceId;
+    }
+    async provision(operationId) {
+        const result = await this.host.call("session.ensure", {
+            scopeId: this.instanceId,
+            operationId,
+            session: {},
+        });
+        if (!result?.sessionId)
+            throw new Error("host did not return a provisioned session id");
+        return result.sessionId;
+    }
+    allocationOperationId(sessionKey, previousSessionId) {
+        return stableOperationId("allocate", this.instanceId, sessionKey, previousSessionId ?? "initial");
+    }
+    forkOperationId(fromSessionId, newSessionKey) {
+        return stableOperationId("fork", this.instanceId, fromSessionId, newSessionKey);
+    }
+    async setTitle(sessionId, title) {
+        await this.host.call("session.meta.setTitle", { sessionId, title });
+    }
+}
+/**
+ * File-backed Lark routing state whose every newly allocated machine session is
+ * minted by the daemon. Allocation operation ids are derived from the previous
+ * committed routing record, so a child crash between RPC and file commit replays
+ * the same host operation instead of creating a duplicate session.
+ */
+export class HostProvisionedLarkSessionStore extends FileLarkActiveSessionStore {
+    operation;
+    mutationTail = Promise.resolve();
+    constructor(options) {
+        const operation = new AsyncLocalStorage();
+        super({
+            filePath: options.filePath,
+            defaultAgent: options.defaultAgent,
+            now: options.now,
+            createSessionId: async () => {
+                const operationId = operation.getStore();
+                if (!operationId)
+                    throw new Error("session allocation is missing its stable operation id");
+                return options.provisioner.provision(operationId);
+            },
+        });
+        this.operation = operation;
+        this.provisioner = options.provisioner;
+    }
+    provisioner;
+    async ensure(sessionKey) {
+        return this.runMutation(async () => {
+            const current = await super.get(sessionKey);
+            if (current)
+                return { ...current, source: "existing" };
+            return this.withAllocation(sessionKey, undefined, () => super.ensure(sessionKey));
+        });
+    }
+    async set(sessionKey, sessionId, cwd) {
+        return this.runMutation(() => super.set(sessionKey, sessionId, cwd));
+    }
+    async rotate(sessionKey) {
+        return this.runMutation(async () => {
+            const current = await super.get(sessionKey);
+            return this.withAllocation(sessionKey, current?.sessionId, () => super.rotate(sessionKey));
+        });
+    }
+    async bindCwd(sessionKey, cwd) {
+        return this.runMutation(async () => {
+            const current = await super.get(sessionKey);
+            return this.withAllocation(sessionKey, current?.sessionId, () => super.bindCwd(sessionKey, cwd));
+        });
+    }
+    async applySettings(sessionKey, settings) {
+        return this.runMutation(async () => {
+            if (!settings.rotate && (await super.get(sessionKey))) {
+                return super.applySettings(sessionKey, settings);
+            }
+            const current = await super.get(sessionKey);
+            return this.withAllocation(sessionKey, current?.sessionId, () => super.applySettings(sessionKey, settings));
+        });
+    }
+    async setAgent(sessionKey, agentName) {
+        return this.runMutation(async () => {
+            const current = await super.get(sessionKey);
+            return this.withAllocation(sessionKey, current?.sessionId, () => super.setAgent(sessionKey, agentName));
+        });
+    }
+    async freeze(sessionKey, execution) {
+        return this.runMutation(async () => {
+            const current = await super.get(sessionKey);
+            if (current)
+                return super.freeze(sessionKey, execution);
+            return this.withAllocation(sessionKey, undefined, () => super.freeze(sessionKey, execution));
+        });
+    }
+    withAllocation(sessionKey, previousSessionId, run) {
+        return this.operation.run(this.provisioner.allocationOperationId(sessionKey, previousSessionId), run);
+    }
+    async runMutation(run) {
+        const previous = this.mutationTail;
+        let release;
+        this.mutationTail = new Promise((resolve) => {
+            release = resolve;
+        });
+        await previous.catch(() => undefined);
+        try {
+            return await run();
+        }
+        finally {
+            release();
+        }
+    }
+}
+export function stableOperationId(kind, ...parts) {
+    const digest = createHash("sha256").update(parts.join("\0")).digest("hex");
+    return `${kind}-${digest}`;
+}
+class AsyncEventQueue {
+    options;
+    values = [];
+    waiters = [];
+    bufferedBytes = 0;
+    ended = false;
+    failure;
+    constructor(options) {
+        this.options = options;
+    }
+    push(value) {
+        if (this.ended || this.failure)
+            return "closed";
+        const waiter = this.waiters.shift();
+        if (waiter) {
+            waiter.resolve({ value, done: false });
+            return "accepted";
+        }
+        const bytes = this.options.sizeOf(value);
+        if (this.values.length >= this.options.maxItems
+            || !Number.isSafeInteger(bytes)
+            || bytes < 0
+            || bytes > this.options.maxBytes - this.bufferedBytes) {
+            this.fail(this.options.overflowError(), true);
+            return "overflow";
+        }
+        this.values.push({ value, bytes });
+        this.bufferedBytes += bytes;
+        return "accepted";
+    }
+    end() {
+        if (this.ended || this.failure)
+            return;
+        this.ended = true;
+        for (const waiter of this.waiters.splice(0))
+            waiter.resolve({ value: undefined, done: true });
+    }
+    fail(error, discardBuffered = false) {
+        if (this.ended || this.failure)
+            return;
+        this.failure = error;
+        if (discardBuffered) {
+            this.values.length = 0;
+            this.bufferedBytes = 0;
+        }
+        for (const waiter of this.waiters.splice(0))
+            waiter.reject(error);
+    }
+    [Symbol.asyncIterator]() {
+        return {
+            next: () => {
+                const entry = this.values.shift();
+                if (entry) {
+                    this.bufferedBytes -= entry.bytes;
+                    return Promise.resolve({ value: entry.value, done: false });
+                }
+                if (this.failure)
+                    return Promise.reject(this.failure);
+                if (this.ended)
+                    return Promise.resolve({ value: undefined, done: true });
+                return new Promise((resolve, reject) => this.waiters.push({ resolve, reject }));
+            },
+        };
+    }
+}
+function jsonByteLength(value) {
+    try {
+        const encoded = JSON.stringify(value);
+        return encoded === undefined ? 0 : Buffer.byteLength(encoded, "utf8");
+    }
+    catch {
+        return Number.POSITIVE_INFINITY;
+    }
+}
+function runEventQueueOverflowError() {
+    return new AgentRuntimeError(`host run event queue exceeded ${LARK_RUN_EVENT_QUEUE_MAX_ITEMS} items or ${LARK_RUN_EVENT_QUEUE_MAX_BYTES} bytes; the run was interrupted`, 503, "plugin_event_queue_overflow");
+}
+function runEventPayload(value) {
+    if (!isRecord(value) || typeof value.runId !== "string" || !isRecord(value.event))
+        return undefined;
+    return value;
+}
+function runTerminalPayload(value) {
+    if (!isRecord(value) || typeof value.runId !== "string")
+        return undefined;
+    return value;
+}
+function hostRunError(payload) {
+    const code = payload.error?.code || "plugin_host_run_failed";
+    return new AgentRuntimeError(payload.error?.message || "host conversation run failed", code === "codex_cancelled" ? 499 : 500, code);
+}
+function toAgentRuntimeError(error) {
+    if (error instanceof AgentRuntimeError)
+        return error;
+    const code = isRecord(error) && typeof error.code === "string" ? error.code : "plugin_host_call_failed";
+    return new AgentRuntimeError(error instanceof Error ? error.message : String(error), 500, code);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/** Public Lark plugin API. The manifest executable is the self-contained
+ * `dist/runtime.mjs`, loaded only by @rynx-ai/plugin-runner; this module exports
+ * no legacy in-process `RynxPlugin` manifest or daemon Channel factory. */
+export { LocalLarkBotRuntime } from "./lark.js";
+export { authorizeLark, larkConfigSchema, LARK_BOT_SCOPES, LARK_BOT_EVENTS, } from "./lark-setup.js";
+export { activate, createLarkPluginRuntime, LARK_CHANNEL_ID, type LarkPluginRuntimeOptions, } from "./runtime.js";
+export { HostAgentCapabilities, HostAgentCatalog, HostConversationRuntime, HostProvisionedLarkSessionStore, HostSessionProvisioner, stableOperationId, } from "./host-adapters.js";

package/dist/index.js

@@ -0,0 +1,7 @@
+/** Public Lark plugin API. The manifest executable is the self-contained
+ * `dist/runtime.mjs`, loaded only by @rynx-ai/plugin-runner; this module exports
+ * no legacy in-process `RynxPlugin` manifest or daemon Channel factory. */
+export { LocalLarkBotRuntime } from "./lark.js";
+export { authorizeLark, larkConfigSchema, LARK_BOT_SCOPES, LARK_BOT_EVENTS, } from "./lark-setup.js";
+export { activate, createLarkPluginRuntime, LARK_CHANNEL_ID, } from "./runtime.js";
+export { HostAgentCapabilities, HostAgentCatalog, HostConversationRuntime, HostProvisionedLarkSessionStore, HostSessionProvisioner, stableOperationId, } from "./host-adapters.js";