@glows777/vela-channels 0.0.0-stage → 0.5.0

package/dist/feedback.js

@@ -0,0 +1,470 @@
+import { publishChannelEvent } from '@glows777/vela-core/extension-api';
+import { errorMessage } from "./log.js";
+import { channelSessionId } from "./session-id.js";
+/** An admitted input keeps its acknowledgement across asynchronous task handoff. */
+export class MessageFeedback {
+    message;
+    report;
+    ready;
+    feedback;
+    finished;
+    startPresentation;
+    failed = false;
+    constructor(channel, message, report, acknowledge = true) {
+        this.message = message;
+        this.report = report;
+        this.ready = Promise.resolve()
+            .then(() => channel.startRun?.(message, { acknowledge }))
+            .then((value) => {
+            this.feedback = value || undefined;
+        })
+            .catch(async (error) => {
+            await this.report(error);
+            // A failed initial reaction must not remove the run's Stop control.
+            // Create presentation only; never retry the acknowledgement.
+            this.startPresentation = async () => {
+                if (!acknowledge)
+                    throw error;
+                this.feedback =
+                    (await channel.startRun?.(message, { acknowledge: false })) ||
+                        undefined;
+            };
+        });
+    }
+    fail() {
+        this.failed = true;
+    }
+    event(update) {
+        if (this.startPresentation) {
+            const start = this.startPresentation;
+            this.startPresentation = undefined;
+            return start().then(() => this.event(update));
+        }
+        return this.feedback?.event(update);
+    }
+    finish(outcome) {
+        this.finished ??= this.complete(outcome);
+        return this.finished;
+    }
+    async complete(outcome) {
+        await this.ready;
+        try {
+            await this.feedback?.finish(this.failed ? 'failed' : outcome);
+        }
+        catch (error) {
+            await this.report(error);
+        }
+    }
+}
+/**
+ * A passive input is marked only once the run starts writing an answer, so untagged
+ * group discussion stays unmarked unless Vela replies.
+ */
+class DeferredMessageFeedback {
+    channel;
+    message;
+    report;
+    /** There is no admission acknowledgement to await. */
+    ready = Promise.resolve();
+    feedback;
+    starting;
+    finished;
+    constructor(channel, message, report) {
+        this.channel = channel;
+        this.message = message;
+        this.report = report;
+    }
+    event(update) {
+        if (!this.starting) {
+            if (update.type !== 'agent' ||
+                update.event.type !== 'message_update' ||
+                update.event.assistantMessageEvent.type !== 'text_delta' ||
+                update.event.assistantMessageEvent.delta === '')
+                return;
+            this.starting = Promise.resolve()
+                .then(() => this.channel.startRun?.(this.message, { acknowledge: true }))
+                .then((feedback) => {
+                this.feedback = feedback || undefined;
+            })
+                .catch(this.report);
+        }
+        const starting = this.starting;
+        return starting.then(() => this.feedback?.event(update));
+    }
+    finish(outcome) {
+        this.finished ??= this.complete(outcome);
+        return this.finished;
+    }
+    async complete(outcome) {
+        await this.starting;
+        try {
+            await this.feedback?.finish(outcome);
+        }
+        catch (error) {
+            await this.report(error);
+        }
+    }
+}
+/** Coordinates admitted inputs and controls without owning the gateway's queues. */
+export class RunFeedback {
+    options;
+    active = new Set();
+    runs = new Map();
+    acknowledgements = new WeakMap();
+    constructor(options) {
+        this.options = options;
+    }
+    receive(id, channelName, msg, admitted = Promise.resolve()) {
+        if (msg.passive || msg.routine || msg.externalEvent || msg.handoff)
+            return async () => false;
+        const channel = this.options.channel(channelName);
+        const run = this.runs.get(id);
+        if (channel &&
+            (!msg.requireExistingSession || (run && this.runIsLive(run))))
+            this.acknowledge(channel, msg);
+        let consumed = false;
+        let chosen = false;
+        let decision;
+        let card;
+        const apply = (action) => {
+            if (!run || !channel)
+                return Promise.resolve();
+            const choice = action === 'stop'
+                ? this.applyRunChoice(channel, msg, run, action)
+                : admitted.then(() => this.applyRunChoice(channel, msg, run, action));
+            return choice
+                .then((handled) => {
+                consumed = handled;
+            })
+                .catch(async (error) => {
+                const aborted = this.options.stopped() || run.stopped || isAbort(error);
+                if (!aborted)
+                    await this.feedbackError(channelName, msg, error);
+                else
+                    publishChannelEvent(run.session, {
+                        type: 'channel_error',
+                        channel: channelName,
+                        senderId: msg.senderId,
+                        error,
+                        aborted: true,
+                    });
+                await Promise.all((this.acknowledgements.get(msg) ?? []).map(async (input) => {
+                    if (!aborted)
+                        input.fail();
+                    if (!run.inputs.includes(input))
+                        await input.finish(aborted ? 'stopped' : 'failed');
+                }));
+                consumed = true;
+            })
+                .finally(() => {
+                if (run.stopped)
+                    consumed = true;
+            });
+        };
+        // A person's message never steers into a note's run: it would inherit the note's hop count and limits.
+        if (run &&
+            !run.trigger.passive &&
+            !run.trigger.handoff &&
+            this.runIsLive(run) &&
+            channel) {
+            if (msg.topic) {
+                decision = (run.steering ?? Promise.resolve()).then(() => apply('steer'));
+                run.steering = decision;
+            }
+            else if (channel.startRun) {
+                const input = this.acknowledge(channel, msg)[0];
+                card = input.ready
+                    .then(() => input.event({
+                    type: 'controls',
+                    message: msg,
+                    signal: run.lifetime.signal,
+                    choose: (action) => {
+                        if (chosen || !this.runIsLive(run))
+                            return false;
+                        chosen = true;
+                        if (action !== 'queue')
+                            decision = apply(action);
+                        return true;
+                    },
+                    error: (error) => this.feedbackError(channelName, msg, error),
+                }))
+                    .catch((error) => this.options.logger.warn(`[${channelName}] Failed to send run controls: ${errorMessage(error)}`));
+            }
+        }
+        return async () => {
+            await card;
+            await decision;
+            return consumed;
+        };
+    }
+    runIsLive(run) {
+        return (!this.options.stopped() &&
+            !run.stopped &&
+            !run.lifetime.signal.aborted &&
+            this.runs.get(run.key) === run &&
+            run.session.isRunning);
+    }
+    /** The same cancellation boundary is used by topic commands and card controls. */
+    async stop(id) {
+        const run = this.runs.get(id);
+        if (!run ||
+            this.options.stopped() ||
+            run.stopped ||
+            run.lifetime.signal.aborted)
+            return false;
+        await this.stopRun(run);
+        return true;
+    }
+    async stopRun(run) {
+        run.stopped = true;
+        run.lifetime.abort();
+        // These inputs belong to the cancelled run; the gateway's default queue stays intact.
+        run.session.clearQueue();
+        await Promise.all([
+            run.session.abort(),
+            this.options.directory.finish(run.key, 'stopped'),
+        ]);
+    }
+    /** Apply one reserved card choice; true consumes its gateway input. */
+    async applyRunChoice(channel, msg, run, action) {
+        if (action === 'stop') {
+            await this.stopRun(run);
+            if (!msg.topic)
+                await this.options.reply(run.session, channel.name, msg, 'Stopped the current run.');
+            await Promise.all((this.acknowledgements.get(msg) ?? [])
+                .filter((input) => !run.inputs.includes(input))
+                .map((input) => input.finish('stopped')));
+            return true;
+        }
+        const inputs = this.acknowledge(channel, msg);
+        await Promise.all(inputs.map((input) => input.ready));
+        if (msg.topic)
+            msg.isNewTopic = false;
+        const prepared = channel.prepareMessage
+            ? await channel.prepareMessage(msg, run.trigger)
+            : msg;
+        // History/name lookups can outlast the run. Leave the default queue intact.
+        if (!prepared) {
+            await this.options.directory.forget(run.key, msg.replyToId ? [msg.replyToId] : []);
+            await Promise.all(inputs.map((input) => input.finish('failed')));
+            return true;
+        }
+        if (!this.runIsLive(run)) {
+            if (!run.stopped)
+                return false;
+            await Promise.all(inputs.map((input) => input.finish('stopped')));
+            return true;
+        }
+        run.inputs.push(...inputs);
+        publishChannelEvent(run.session, {
+            type: 'channel_message',
+            channel: channel.name,
+            senderId: prepared.senderId,
+            senderName: prepared.senderName,
+            text: prepared.text,
+        });
+        this.options.recovery.track(run.key, run.session, prepared);
+        await run.session.prompt(prepared.text, {
+            source: 'channel',
+            streamingBehavior: 'steer',
+            images: prepared.images,
+            signal: run.lifetime.signal,
+        });
+        return true;
+    }
+    acknowledge(channel, msg, acknowledge = true) {
+        if (msg.passive)
+            return [];
+        let inputs = this.acknowledgements.get(msg);
+        if (!inputs) {
+            inputs = [
+                new MessageFeedback(channel, msg, (error) => this.feedbackError(channel.name, msg, error), acknowledge && !msg.externalEvent && !msg.handoff),
+            ];
+            this.acknowledgements.set(msg, inputs);
+        }
+        return inputs;
+    }
+    async feedbackError(channelName, msg, error) {
+        const session = this.options.find(channelSessionId(channelName, msg.channelId, msg.topic?.rootId));
+        session &&
+            publishChannelEvent(session, {
+                type: 'channel_error',
+                channel: channelName,
+                senderId: msg.senderId,
+                error,
+                aborted: false,
+            });
+        this.options.logger.error(`[${channelName}] Feedback failed: ${errorMessage(error)}`);
+        if (msg.passive || msg.externalEvent)
+            return;
+        try {
+            await this.options.channel(channelName)?.send({
+                ...msg,
+                recipientId: msg.senderId,
+                text: `Couldn't update task feedback: ${errorMessage(error)}. Check the bot's permissions and connection.`,
+            });
+        }
+        catch (sendError) {
+            this.options.logger.error(`[${channelName}] Could not deliver feedback error: ${errorMessage(sendError)}`);
+        }
+    }
+    async prompt(id, channelName, channel, msg, session, inputs, input) {
+        this.active.add(session);
+        const run = {
+            key: id,
+            session,
+            trigger: msg,
+            lifetime: new AbortController(),
+            stopped: false,
+            inputs,
+        };
+        this.runs.set(id, run);
+        let feedbackErrorReported = false;
+        const report = async (error) => {
+            if (feedbackErrorReported)
+                return;
+            feedbackErrorReported = true;
+            await this.feedbackError(channelName, msg, error);
+        };
+        const feedback = channel && msg.passive
+            ? new DeferredMessageFeedback(channel, msg, report)
+            : channel
+                ? (inputs.find((item) => item.message === input) ??
+                    new MessageFeedback(channel, msg, report, false))
+                : undefined;
+        await feedback?.ready;
+        const pending = [];
+        const unsubscribe = session.subscribe((event) => {
+            try {
+                const update = feedback?.event({ type: 'agent', event });
+                if (update)
+                    pending.push(Promise.resolve(update).catch(report));
+            }
+            catch (error) {
+                pending.push(report(error));
+            }
+            if (event.type === 'agent_settled')
+                run.lifetime.abort();
+        });
+        let outcome = 'done';
+        let answer = '';
+        let failureReported = false;
+        let promptStarted = false;
+        let executionFailed = false;
+        let interrupted = false;
+        // An input handler can handle the message without a run: then there is no new answer to send
+        const previous = session.messages.at(-1);
+        try {
+            if (msg.topic && channel && !msg.passive && feedback) {
+                try {
+                    await feedback.event({
+                        type: 'controls',
+                        message: msg,
+                        signal: run.lifetime.signal,
+                        error: report,
+                        choose: (action) => {
+                            if (action !== 'stop' || !this.runIsLive(run))
+                                return false;
+                            void this.applyRunChoice(channel, msg, run, 'stop').catch((error) => publishChannelEvent(session, {
+                                type: 'channel_error',
+                                channel: channelName,
+                                senderId: msg.senderId,
+                                error,
+                                aborted: this.options.stopped() || isAbort(error),
+                            }));
+                            return true;
+                        },
+                    });
+                }
+                catch (error) {
+                    failureReported = true;
+                    await this.options.reply(session, channelName, msg, `Couldn't show the topic Stop control: ${errorMessage(error)}. Check the bot's send permission and retry.`);
+                    throw error;
+                }
+            }
+            if (run.stopped)
+                throw new DOMException('Stopped before prompting', 'AbortError');
+            await this.options.directory.begin(id, msg);
+            if (run.stopped)
+                throw new DOMException('Stopped before prompting', 'AbortError');
+            this.options.recovery.track(id, session, msg);
+            promptStarted = true;
+            this.options.logger.debug(`[${channelName}] input ${msg.replyToId ?? '-'} prompt at=${new Date().toISOString()}`);
+            await session.prompt(msg.text, { source: 'channel', images: msg.images });
+            if (session.messages.at(-1) !== previous)
+                answer = lastAssistantText(session.messages);
+        }
+        catch (error) {
+            outcome =
+                run.stopped || this.options.stopped() || isAbort(error)
+                    ? 'stopped'
+                    : 'failed';
+            interrupted = this.options.stopped() && !run.stopped;
+            executionFailed = promptStarted && outcome === 'failed';
+            if (outcome === 'failed' && !failureReported) {
+                if (msg.passive)
+                    this.options.logger.error(`[${channelName}] Passive evaluation failed: ${errorMessage(error)}`);
+                else
+                    answer = `Task failed: ${errorMessage(error)}`;
+            }
+            publishChannelEvent(session, {
+                type: 'channel_error',
+                channel: channelName,
+                senderId: msg.senderId,
+                error,
+                aborted: outcome === 'stopped',
+            });
+        }
+        finally {
+            unsubscribe();
+            run.lifetime.abort();
+            await run.steering;
+            await Promise.all(pending);
+            this.runs.delete(id);
+            this.active.delete(session);
+        }
+        await this.options.recovery.settled(session);
+        if (run.handedOff) {
+            await this.options.directory.finish(id, 'done');
+            if (msg.passive)
+                await feedback?.finish('silent');
+            return;
+        }
+        if (run.stopped)
+            outcome = 'stopped';
+        if (outcome === 'stopped')
+            answer = msg.topic ? 'Stopped the current run.' : '';
+        if (run.skipReply)
+            answer = '';
+        const delivered = !answer || (await this.options.reply(session, channelName, msg, answer));
+        if (!delivered)
+            outcome = 'failed';
+        await feedback?.finish(msg.passive && outcome === 'done' && !answer ? 'silent' : outcome);
+        // Shutdown is recoverable, including accepted steers not yet saved. A reported
+        // execution failure is terminal; a failed delivery must remain recoverable.
+        if (!interrupted &&
+            (outcome !== 'failed' || (executionFailed && delivered))) {
+            await this.options.directory.forget(id, [msg, ...run.inputs.map((item) => item.message)].flatMap((item) => item.replyToId ? [item.replyToId] : []));
+            await this.options.directory.finish(id, outcome === 'stopped' ? 'stopped' : 'done', 
+            // A note's run leaves a person's pending decision open, even when silent.
+            outcome === 'done' && (!!answer || !!msg.handoff));
+            await this.options.finished(id, msg, outcome, answer);
+        }
+        return outcome;
+    }
+}
+function isAbort(error) {
+    return error instanceof Error && error.name === 'AbortError';
+}
+/** Text of the last assistant message (this turn's reply). */
+function lastAssistantText(messages) {
+    const last = messages[messages.length - 1];
+    if (last?.role !== 'assistant')
+        return '';
+    if (typeof last.content === 'string')
+        return last.content;
+    return last.content
+        .map((part) => (part.type === 'text' ? part.text : ''))
+        .join('');
+}
+//# sourceMappingURL=feedback.js.map

package/dist/feedback.js.map

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

package/dist/gateway.d.ts

@@ -0,0 +1,76 @@
+import type { SessionOptions, VelaLogger, VelaSession } from '@glows777/vela-core/extension-api';
+import { ChannelEvents } from './events.ts';
+import { ChannelHandoff } from './handoff.ts';
+import { ChannelRoutines } from './routines.ts';
+import type { ChannelDefinition, IncomingMessage } from './types.ts';
+interface GatewayOptions {
+    dataDir?: string;
+    /** Opens (or returns) a session by id; one shared session per channel and conversation */
+    session: (id: string, options?: SessionOptions) => VelaSession;
+    /** The open session with this id, without opening one */
+    find: (id: string) => VelaSession | undefined;
+    /** A channel session with no message for this long is closed; the next message resumes it. Default 10 minutes */
+    idleMs?: number;
+    logger?: VelaLogger;
+    eventDefaultTarget?: {
+        channel: string;
+        chatId: string;
+    };
+}
+export declare class ChannelGateway {
+    private options;
+    readonly routines: ChannelRoutines;
+    readonly events: ChannelEvents;
+    readonly handoff: ChannelHandoff;
+    private readonly directory;
+    private readonly recovery;
+    private readonly sessions;
+    private admitting;
+    private readonly commands;
+    private readonly usage;
+    private channels;
+    /** Channels whose `start()` reported a connection; `serve` refuses to idle when this is empty */
+    private started;
+    /** Messages are processed serially per session: the next message in a chat waits for the previous reply */
+    private queues;
+    private subscribed;
+    private saveFailures;
+    /** Idle sessions waiting to be closed, by session id */
+    private idleTimers;
+    /** Sessions being closed: a new message for the id waits until the close is done, then reopens it */
+    private closing;
+    private readonly admission;
+    private readonly feedback;
+    private stopped;
+    private readonly logger;
+    constructor(options: GatewayOptions);
+    /** Internal storage-success notification, including saves outside a channel prompt. */
+    sessionSaved(id: string): void;
+    private topics;
+    private find;
+    register(channel: ChannelDefinition): void;
+    startAll(toolNames?: readonly string[]): Promise<void>;
+    stopAll(): Promise<void>;
+    /** Handles one channel message; the returned Promise settles once the reply is sent (or fails). */
+    handleIncoming(channelName: string, msg: IncomingMessage): Promise<void>;
+    private admit;
+    private releaseQueue;
+    /**
+     * Channel sessions would otherwise stay open (and in memory) for as long as the process runs, one per
+     * conversation. Once a chat's queue is empty, the session is closed after `idleMs`; its history
+     * is saved, and the next message reopens and resumes it.
+     */
+    private closeWhenIdle;
+    private closeIdleSession;
+    private process;
+    private processRun;
+    private sendReply;
+    list(): Array<{
+        name: string;
+        description: string;
+    }>;
+    /** Channels whose last `start()` reported a connection (not `false`, and it did not throw) */
+    running(): string[];
+}
+export {};
+//# sourceMappingURL=gateway.d.ts.map

package/dist/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../src/gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,WAAW,EACZ,MAAM,mCAAmC,CAAA;AAQ1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAG7C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAI/C,OAAO,KAAK,EACV,iBAAiB,EAEjB,eAAe,EAEhB,MAAM,YAAY,CAAA;AAGnB,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,0FAA0F;IAC1F,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,WAAW,CAAA;IAC9D,yDAAyD;IACzD,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAA;IAC7C,iHAAiH;IACjH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,kBAAkB,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CACzD;AAOD,qBAAa,cAAc;IA0Bb,OAAO,CAAC,OAAO;IAzB3B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;IAClC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAuC;IACvD,iGAAiG;IACjG,OAAO,CAAC,OAAO,CAAoB;IACnC,2GAA2G;IAC3G,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,YAAY,CAA4B;IAChD,wDAAwD;IACxD,OAAO,CAAC,UAAU,CAAmD;IACrE,qGAAqG;IACrG,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IACtC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;gBAEf,OAAO,EAAE,cAAc;IAiF3C,uFAAuF;IACvF,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK9B,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,IAAI;IAIZ,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAuEpC,QAAQ,CAAC,SAAS,GAAE,SAAS,MAAM,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAkE1D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqC9B,mGAAmG;IACnG,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA0DxE,OAAO,CAAC,KAAK;IA+Bb,OAAO,CAAC,YAAY;IAQpB;;;;OAIG;IACH,OAAO,CAAC,aAAa;YA8BP,gBAAgB;YAoBhB,OAAO;YA6BP,UAAU;YA0IV,SAAS;IAuCvB,IAAI,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAOpD,8FAA8F;IAC9F,OAAO,IAAI,MAAM,EAAE;CAGpB"}