@modelprofile.com/flexharness 10.17.1 → 10.19.0

package/dist_ts_chat_harness_server/classes.sessionlists.d.ts

@@ -0,0 +1,21 @@
+import type * as plugins from './plugins.js';
+import type { IFlexHarnessChatCaller, IFlexHarnessChatPeers } from './interfaces.js';
+type TSessionEvent = plugins.IFlexSessionCreatedEvent | plugins.IFlexSessionUpdatedEvent | plugins.IFlexSessionDeletedEvent;
+/**
+ * The conversation lists of the attached tabs: a conversation created, changed or deleted in a
+ * tab's scope reaches the tab as a push. Pushes are best effort; a tab that misses one attaches
+ * again after it reconnects and gets the whole list.
+ */
+export declare class FlexHarnessChatSessionLists {
+    private readonly peers;
+    private readonly toSessionMeta;
+    private readonly attached;
+    constructor(peersArg: IFlexHarnessChatPeers, toSessionMetaArg: (sessionArg: plugins.IFlexSession) => plugins.IHarnessSessionMeta);
+    get tabs(): IFlexHarnessChatCaller[];
+    attach(tabArg: IFlexHarnessChatCaller): void;
+    forget(tabArg: IFlexHarnessChatCaller): void;
+    clear(): void;
+    publish(eventArg: TSessionEvent): void;
+    private pump;
+}
+export {};

package/dist_ts_chat_harness_server/classes.sessionlists.js

@@ -0,0 +1,70 @@
+import { tabKey } from './functions.validation.js';
+/**
+ * The conversation lists of the attached tabs: a conversation created, changed or deleted in a
+ * tab's scope reaches the tab as a push. Pushes are best effort; a tab that misses one attaches
+ * again after it reconnects and gets the whole list.
+ */
+export class FlexHarnessChatSessionLists {
+    peers;
+    toSessionMeta;
+    attached = new Map();
+    constructor(peersArg, toSessionMetaArg) {
+        this.peers = peersArg;
+        this.toSessionMeta = toSessionMetaArg;
+    }
+    get tabs() {
+        return [...this.attached.values()].map((entry) => entry.tab);
+    }
+    attach(tabArg) {
+        this.attached.set(tabKey(tabArg), {
+            tab: { tabId: tabArg.tabId, scopeId: tabArg.scopeId },
+            upserts: new Map(),
+            deletedIds: new Set(),
+            sending: false,
+        });
+    }
+    forget(tabArg) {
+        this.attached.delete(tabKey(tabArg));
+    }
+    clear() {
+        this.attached.clear();
+    }
+    publish(eventArg) {
+        for (const [key, entry] of this.attached) {
+            if (entry.tab.scopeId !== eventArg.scopeId)
+                continue;
+            if (eventArg.type === 'session.deleted') {
+                entry.upserts.delete(eventArg.sessionId);
+                entry.deletedIds.add(eventArg.sessionId);
+            }
+            else {
+                entry.deletedIds.delete(eventArg.sessionId);
+                entry.upserts.set(eventArg.sessionId, this.toSessionMeta(eventArg.session));
+            }
+            void this.pump(key, entry);
+        }
+    }
+    async pump(keyArg, entryArg) {
+        if (entryArg.sending)
+            return;
+        entryArg.sending = true;
+        try {
+            while (entryArg.upserts.size || entryArg.deletedIds.size) {
+                const peer = await this.peers.find(entryArg.tab).catch(() => null);
+                if (!peer) {
+                    if (this.attached.get(keyArg) === entryArg)
+                        this.attached.delete(keyArg);
+                    return;
+                }
+                const push = { upserts: [...entryArg.upserts.values()], deletedIds: [...entryArg.deletedIds] };
+                entryArg.upserts.clear();
+                entryArg.deletedIds.clear();
+                await peer.sessions(push).catch(() => undefined);
+            }
+        }
+        finally {
+            entryArg.sending = false;
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5zZXNzaW9ubGlzdHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19jaGF0X2hhcm5lc3Nfc2VydmVyL2NsYXNzZXMuc2Vzc2lvbmxpc3RzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQWdCbkQ7Ozs7R0FJRztBQUNILE1BQU0sT0FBTywyQkFBMkI7SUFDckIsS0FBSyxDQUF3QjtJQUM3QixhQUFhLENBQW9FO0lBQ2pGLFFBQVEsR0FBRyxJQUFJLEdBQUcsRUFBd0IsQ0FBQztJQUU1RCxZQUNFLFFBQStCLEVBQy9CLGdCQUFtRjtRQUVuRixJQUFJLENBQUMsS0FBSyxHQUFHLFFBQVEsQ0FBQztRQUN0QixJQUFJLENBQUMsYUFBYSxHQUFHLGdCQUFnQixDQUFDO0lBQ3hDLENBQUM7SUFFRCxJQUFXLElBQUk7UUFDYixPQUFPLENBQUMsR0FBRyxJQUFJLENBQUMsUUFBUSxDQUFDLE1BQU0sRUFBRSxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUMsS0FBSyxFQUFFLEVBQUUsQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLENBQUM7SUFDL0QsQ0FBQztJQUVNLE1BQU0sQ0FBQyxNQUE4QjtRQUMxQyxJQUFJLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLEVBQUU7WUFDaEMsR0FBRyxFQUFFLEVBQUUsS0FBSyxFQUFFLE1BQU0sQ0FBQyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0sQ0FBQyxPQUFPLEVBQUU7WUFDckQsT0FBTyxFQUFFLElBQUksR0FBRyxFQUFFO1lBQ2xCLFVBQVUsRUFBRSxJQUFJLEdBQUcsRUFBRTtZQUNyQixPQUFPLEVBQUUsS0FBSztTQUNmLENBQUMsQ0FBQztJQUNMLENBQUM7SUFFTSxNQUFNLENBQUMsTUFBOEI7UUFDMUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLE1B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

package/dist_ts_chat_harness_server/classes.turngate.d.ts

@@ -0,0 +1,38 @@
+import * as plugins from './plugins.js';
+import type { IFlexHarnessChatCaller, IFlexHarnessChatLimits, IFlexHarnessChatTurn } from './interfaces.js';
+/** The harness calls the gate makes. */
+export type TFlexHarnessChatGateHarness = Pick<plugins.FlexHarness<unknown>, 'enqueuePrompt' | 'steerPrompt' | 'getPromptQueueEntry' | 'cancelPrompt'>;
+/**
+ * Admits messages: one turn per conversation, bound to the tab that started it and the context it
+ * was sent with, since FlexHarness carries no per-prompt context. A message sent while a turn runs
+ * steers it; a steer the turn no longer takes waits for the ending turn and starts the next one.
+ */
+export declare class FlexHarnessChatTurnGate<TContext> {
+    private readonly harness;
+    private readonly limits;
+    private readonly bindings;
+    /** serializes the admission of messages per conversation */
+    private readonly locks;
+    /** the admissions under way, each settling once its message was admitted or refused */
+    private readonly admissions;
+    private stopped;
+    constructor(harnessArg: TFlexHarnessChatGateHarness, limitsArg: IFlexHarnessChatLimits);
+    turnOf(scopeIdArg: string, sessionIdArg: string): IFlexHarnessChatTurn<TContext> | undefined;
+    /** Whether a turn the tab started still runs. */
+    hasTurnOf(tabArg: IFlexHarnessChatCaller): boolean;
+    /** Takes one harness event: a prompt that runs now takes steers. */
+    takeEvent(eventArg: plugins.TFlexHarnessEvent): void;
+    /** Admits a message under the conversation's lock; every wait ends at the deadline. */
+    admit(callerArg: IFlexHarnessChatCaller, sessionIdArg: string, sendArg: plugins.IHarnessComposerSendDetail, contextArg: TContext, deadlineArg: number): Promise<plugins.TFlexHarnessChatResponse<'flexHarnessChatSend'>>;
+    /**
+     * Refuses new messages, stops every turn this gate started, also those admitted while it stops,
+     * and waits until the admissions under way were refused and every turn ended.
+     */
+    stop(): Promise<void>;
+    private cancelTurns;
+    private cancel;
+    private assertOpen;
+    private withLock;
+    private admitLocked;
+    private startTurn;
+}

package/dist_ts_chat_harness_server/classes.turngate.js

@@ -0,0 +1,207 @@
+import * as plugins from './plugins.js';
+import { FlexHarnessChatRequestError } from './errors.js';
+import { STOPPED_MESSAGE } from './functions.validation.js';
+const STILL_FINISHING_MESSAGE = 'The assistant is still finishing its previous reply. Send your message again in a moment.';
+const bindingKey = (scopeIdArg, sessionIdArg) => `${scopeIdArg}\n${sessionIdArg}`;
+/** Whether the promise settled before the deadline (a time in ms since the epoch). */
+const settlesBefore = async (promiseArg, deadlineArg) => {
+    let timer;
+    const expired = new Promise((resolve) => {
+        timer = setTimeout(() => resolve(false), Math.max(0, deadlineArg - Date.now()));
+    });
+    try {
+        return await Promise.race([promiseArg.then(() => true, () => true), expired]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+};
+/**
+ * Admits messages: one turn per conversation, bound to the tab that started it and the context it
+ * was sent with, since FlexHarness carries no per-prompt context. A message sent while a turn runs
+ * steers it; a steer the turn no longer takes waits for the ending turn and starts the next one.
+ */
+export class FlexHarnessChatTurnGate {
+    harness;
+    limits;
+    bindings = new Map();
+    /** serializes the admission of messages per conversation */
+    locks = new Map();
+    /** the admissions under way, each settling once its message was admitted or refused */
+    admissions = new Set();
+    stopped = false;
+    constructor(harnessArg, limitsArg) {
+        this.harness = harnessArg;
+        this.limits = limitsArg;
+    }
+    turnOf(scopeIdArg, sessionIdArg) {
+        const binding = this.bindings.get(bindingKey(scopeIdArg, sessionIdArg));
+        return binding
+            ? { scopeId: binding.scopeId, sessionId: binding.sessionId, tabId: binding.tabId, context: binding.context }
+            : undefined;
+    }
+    /** Whether a turn the tab started still runs. */
+    hasTurnOf(tabArg) {
+        for (const binding of this.bindings.values()) {
+            if (binding.tabId === tabArg.tabId && binding.scopeId === tabArg.scopeId)
+                return true;
+        }
+        return false;
+    }
+    /** Takes one harness event: a prompt that runs now takes steers. */
+    takeEvent(eventArg) {
+        if (eventArg.type !== 'prompt.running' && eventArg.type !== 'prompt.finished')
+            return;
+        const binding = this.bindings.get(bindingKey(eventArg.scopeId, eventArg.sessionId));
+        if (binding && binding.queueId === eventArg.queueId)
+            binding.markRunning();
+    }
+    /** Admits a message under the conversation's lock; every wait ends at the deadline. */
+    admit(callerArg, sessionIdArg, sendArg, contextArg, deadlineArg) {
+        if (this.stopped)
+            return Promise.reject(new FlexHarnessChatRequestError(STOPPED_MESSAGE));
+        const admission = this.withLock(bindingKey(callerArg.scopeId, sessionIdArg), () => this.admitLocked(callerArg, sessionIdArg, sendArg, contextArg, deadlineArg));
+        const settled = admission.then(() => undefined, () => undefined);
+        this.admissions.add(settled);
+        void settled.then(() => this.admissions.delete(settled));
+        return admission;
+    }
+    /**
+     * Refuses new messages, stops every turn this gate started, also those admitted while it stops,
+     * and waits until the admissions under way were refused and every turn ended.
+     */
+    async stop() {
+        this.stopped = true;
+        this.cancelTurns();
+        await Promise.all([...this.admissions]);
+        // a turn whose prompt was being queued when the gate stopped was cancelled by its admission
+        this.cancelTurns();
+        await Promise.all([...this.bindings.values()].map((binding) => binding.settled));
+    }
+    cancelTurns() {
+        for (const binding of this.bindings.values()) {
+            clearTimeout(binding.timer);
+            if (binding.queueId)
+                this.cancel(binding.scopeId, binding.sessionId, binding.queueId);
+        }
+    }
+    cancel(scopeIdArg, sessionIdArg, queueIdArg) {
+        void this.harness.cancelPrompt(scopeIdArg, sessionIdArg, queueIdArg).catch(() => false);
+    }
+    assertOpen() {
+        if (this.stopped)
+            throw new FlexHarnessChatRequestError(STOPPED_MESSAGE);
+    }
+    async withLock(keyArg, fnArg) {
+        const previous = this.locks.get(keyArg) ?? Promise.resolve();
+        let release;
+        const current = new Promise((resolve) => (release = resolve));
+        const chained = previous.then(() => current);
+        this.locks.set(keyArg, chained);
+        await previous;
+        try {
+            return await fnArg();
+        }
+        finally {
+            release();
+            if (this.locks.get(keyArg) === chained)
+                this.locks.delete(keyArg);
+        }
+    }
+    async admitLocked(callerArg, sessionIdArg, sendArg, contextArg, deadlineArg) {
+        const waitFor = async (promiseArg) => {
+            if (!(await settlesBefore(promiseArg, deadlineArg)))
+                throw new FlexHarnessChatRequestError(STILL_FINISHING_MESSAGE);
+        };
+        this.assertOpen();
+        const target = { scopeId: callerArg.scopeId, sessionId: sessionIdArg };
+        const binding = this.bindings.get(bindingKey(target.scopeId, target.sessionId));
+        if (binding?.queueId) {
+            for (let attempt = 0; attempt < 2; attempt++) {
+                const intent = intentOf(target, { ...sendArg, delivery: 'steer' }, binding.queueId);
+                if (intent.type !== 'steerPrompt')
+                    break;
+                this.assertOpen();
+                try {
+                    await this.harness.steerPrompt(target.scopeId, target.sessionId, intent.queueId, {
+                        steerId: intent.steerId,
+                        prompt: intent.prompt,
+                    });
+                    return { sessionId: sessionIdArg, steerId: intent.steerId };
+                }
+                catch (error) {
+                    if (!(error instanceof plugins.FlexHarnessSteerRejectedError) || error.reason !== 'not-running')
+                        throw error;
+                }
+                // a prompt still waiting for its run takes steers once it runs
+                const entry = await this.harness
+                    .getPromptQueueEntry(target.scopeId, target.sessionId, binding.queueId)
+                    .catch(() => undefined);
+                if (!entry || !['queued', 'starting', 'scheduled'].includes(entry.status))
+                    break;
+                await waitFor(Promise.race([binding.running, binding.settled]));
+            }
+            await waitFor(binding.settled);
+        }
+        else if (binding) {
+            await waitFor(binding.settled);
+        }
+        this.assertOpen();
+        return this.startTurn(callerArg, sessionIdArg, sendArg, contextArg);
+    }
+    async startTurn(callerArg, sessionIdArg, sendArg, contextArg) {
+        const key = bindingKey(callerArg.scopeId, sessionIdArg);
+        const intent = intentOf({ scopeId: callerArg.scopeId, sessionId: sessionIdArg }, { ...sendArg, delivery: 'turn' });
+        if (intent.type !== 'enqueuePrompt')
+            throw new Error('A new turn must be queued.');
+        let markSettled;
+        let markRunning;
+        const binding = {
+            scopeId: callerArg.scopeId,
+            sessionId: sessionIdArg,
+            tabId: callerArg.tabId,
+            context: contextArg,
+            running: new Promise((resolve) => (markRunning = resolve)),
+            markRunning: () => markRunning(),
+            settled: new Promise((resolve) => (markSettled = resolve)),
+        };
+        const end = () => {
+            clearTimeout(binding.timer);
+            if (this.bindings.get(key) === binding)
+                this.bindings.delete(key);
+            markRunning();
+            markSettled();
+        };
+        // bound before the prompt is queued: the model resolver may run at once
+        this.bindings.set(key, binding);
+        let queued;
+        try {
+            queued = await this.harness.enqueuePrompt(callerArg.scopeId, sessionIdArg, intent.prompt);
+        }
+        catch (error) {
+            end();
+            throw error;
+        }
+        binding.queueId = queued.queueId;
+        // the outcome of a turn is in its conversation; a failed turn is not an error of this request
+        void queued.completion.then(() => undefined, () => undefined).finally(end);
+        if (this.stopped) {
+            // the gate stopped while the prompt was being queued: the turn never runs on
+            this.cancel(callerArg.scopeId, sessionIdArg, queued.queueId);
+            throw new FlexHarnessChatRequestError(STOPPED_MESSAGE);
+        }
+        binding.timer = setTimeout(() => this.cancel(callerArg.scopeId, sessionIdArg, queued.queueId), this.limits.turnTimeoutMs);
+        binding.timer.unref?.();
+        return { sessionId: sessionIdArg, queueId: queued.queueId };
+    }
+}
+/** The harness call a composer message becomes; an attachment the composer could not read whole is refused. */
+const intentOf = (targetArg, sendArg, activeQueueIdArg) => {
+    try {
+        return plugins.flexHarnessSendIntent(targetArg, sendArg, activeQueueIdArg ? { activeQueueId: activeQueueIdArg } : {});
+    }
+    catch (error) {
+        throw new FlexHarnessChatRequestError(error?.message || 'The message could not be read.');
+    }
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy50dXJuZ2F0ZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzX2NoYXRfaGFybmVzc19zZXJ2ZXIvY2xhc3Nlcy50dXJuZ2F0ZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUN4QyxPQUFPLEVBQUUsMkJBQTJCLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFDMUQsT0FBTyxFQUFFLGVBQWUsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBRzVELE1BQU0sdUJBQXVCLEdBQzNCLDJGQUEyRixDQUFDO0FBb0I5RixNQUFNLFVBQVUsR0FBRyxDQUFDLFVBQWtCLEVBQUUsWUFBb0IsRUFBRSxFQUFFLENBQUMsR0FBRyxVQUFVLEtBQUssWUFBWSxFQUFFLENBQUM7QUFFbEcsc0ZBQXNGO0FBQ3RGLE1BQU0sYUFBYSxHQUFHLEtBQUssRUFBRSxVQUE0QixFQUFFLFdBQW1CLEVBQW9CLEVBQUU7SUFDbEcsSUFBSSxLQUFnRCxDQUFDO0lBQ3JELE1BQU0sT0FBTyxHQUFHLElBQUksT0FBTyxDQUFRLENBQUMsT0FBTyxFQUFFLEVBQUU7UUFDN0MsS0FBSyxHQUFHLFVBQVUsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDLEVBQUUsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDLEVBQUUsV0FBVyxHQUFHLElBQUksQ0FBQyxHQUFHLEVBQUUsQ0FBQyxDQUFDLENBQUM7SUFDbEYsQ0FBQyxDQUFDLENBQUM7SUFDSCxJQUFJLENBQUM7UUFDSCxPQUFPLE1BQU0sT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLFVBQVUsQ0FBQyxJQUFJLENBQUMsR0FBRyxFQUFFLENBQUMsSUFBYSxFQUFFLEdBQUcsRUFBRSxDQUFDLElBQWEsQ0FBQyxFQUFFLE9BQU8sQ0FBQyxDQUFDLENBQUM7SUFDbEcsQ0FBQztZQUFTLENBQUM7UUFDVCxZQUFZLENBQUMsS0FBSyxDQUFDLENBQUM7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

package/dist_ts_chat_harness_server/errors.d.ts

@@ -0,0 +1,5 @@
+export { FlexHarnessChatRequestError } from './plugins.js';
+/** The tab of a turn is gone or did not answer a tool call in time. */
+export declare class FlexHarnessChatTabUnavailableError extends Error {
+    constructor(options?: ErrorOptions);
+}

package/dist_ts_chat_harness_server/errors.js

@@ -0,0 +1,9 @@
+export { FlexHarnessChatRequestError } from './plugins.js';
+/** The tab of a turn is gone or did not answer a tool call in time. */
+export class FlexHarnessChatTabUnavailableError extends Error {
+    constructor(options) {
+        super('The tab that started this turn is closed, lost its connection or did not answer in time.', options);
+        this.name = 'FlexHarnessChatTabUnavailableError';
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHNfY2hhdF9oYXJuZXNzX3NlcnZlci9lcnJvcnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLDJCQUEyQixFQUFFLE1BQU0sY0FBYyxDQUFDO0FBRTNELHVFQUF1RTtBQUN2RSxNQUFNLE9BQU8sa0NBQW1DLFNBQVEsS0FBSztJQUMzRCxZQUFZLE9BQXNCO1FBQ2hDLEtBQUssQ0FBQywwRkFBMEYsRUFBRSxPQUFPLENBQUMsQ0FBQztRQUMzRyxJQUFJLENBQUMsSUFBSSxHQUFHLG9DQUFvQyxDQUFDO0lBQ25ELENBQUM7Q0FDRiJ9

package/dist_ts_chat_harness_server/functions.errorprojector.d.ts

@@ -0,0 +1,11 @@
+import * as plugins from './plugins.js';
+export interface IFlexHarnessChatErrorProjectorOptions {
+    /** The host's own projection, tried first; return `undefined` for errors it does not know. */
+    project?: (error: unknown, context: plugins.IFlexExternalErrorContext) => plugins.IFlexErrorInfo | undefined;
+}
+/**
+ * An `externalErrorProjector` for chat conversations: what a failed model call, tool or resolver
+ * shows in the conversation, never a provider's response text. The host's projection comes first;
+ * then a tab that is gone, a model limit, an HTTP status of the model provider, and a fixed message.
+ */
+export declare function createFlexHarnessChatErrorProjector(options?: IFlexHarnessChatErrorProjectorOptions): plugins.TFlexExternalErrorProjector;

package/dist_ts_chat_harness_server/functions.errorprojector.js

@@ -0,0 +1,32 @@
+import * as plugins from './plugins.js';
+import { FlexHarnessChatTabUnavailableError } from './errors.js';
+/**
+ * An `externalErrorProjector` for chat conversations: what a failed model call, tool or resolver
+ * shows in the conversation, never a provider's response text. The host's projection comes first;
+ * then a tab that is gone, a model limit, an HTTP status of the model provider, and a fixed message.
+ */
+export function createFlexHarnessChatErrorProjector(options = {}) {
+    return (error, context) => {
+        const projected = options.project?.(error, context);
+        if (projected)
+            return projected;
+        if (error instanceof FlexHarnessChatTabUnavailableError) {
+            return { name: 'TabUnavailable', message: error.message, code: 'FLEX_CHAT_TAB_UNAVAILABLE' };
+        }
+        const limit = plugins.modelLimitErrorInfo(error);
+        if (limit)
+            return limit;
+        if (context.source === 'agentSession') {
+            const failure = plugins.describeModelFailure(error);
+            if (failure.kind === 'http' && failure.status) {
+                return {
+                    name: 'ModelProviderError',
+                    message: `The model provider answered with HTTP ${failure.status}.`,
+                    code: 'FLEX_CHAT_MODEL_HTTP_ERROR',
+                };
+            }
+        }
+        return { name: 'AssistantError', message: 'The assistant could not complete that request.', code: 'FLEX_CHAT_FAILED' };
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZnVuY3Rpb25zLmVycm9ycHJvamVjdG9yLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHNfY2hhdF9oYXJuZXNzX3NlcnZlci9mdW5jdGlvbnMuZXJyb3Jwcm9qZWN0b3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxjQUFjLENBQUM7QUFDeEMsT0FBTyxFQUFFLGtDQUFrQyxFQUFFLE1BQU0sYUFBYSxDQUFDO0FBVWpFOzs7O0dBSUc7QUFDSCxNQUFNLFVBQVUsbUNBQW1DLENBQ2pELFVBQWlELEVBQUU7SUFFbkQsT0FBTyxDQUFDLEtBQUssRUFBRSxPQUFPLEVBQUUsRUFBRTtRQUN4QixNQUFNLFNBQVMsR0FBRyxPQUFPLENBQUMsT0FBTyxFQUFFLENBQUMsS0FBSyxFQUFFLE9BQU8sQ0FBQyxDQUFDO1FBQ3BELElBQUksU0FBUztZQUFFLE9BQU8sU0FBUyxDQUFDO1FBQ2hDLElBQUksS0FBSyxZQUFZLGtDQUFrQyxFQUFFLENBQUM7WUFDeEQsT0FBTyxFQUFFLElBQUksRUFBRSxnQkFBZ0IsRUFBRSxPQUFPLEVBQUUsS0FBSyxDQUFDLE9BQU8sRUFBRSxJQUFJLEVBQUUsMkJBQTJCLEVBQUUsQ0FBQztRQUMvRixDQUFDO1FBQ0QsTUFBTSxLQUFLLEdBQUcsT0FBTyxDQUFDLG1CQUFtQixDQUFDLEtBQUssQ0FBQyxDQUFDO1FBQ2pELElBQUksS0FBSztZQUFFLE9BQU8sS0FBSyxDQUFDO1FBQ3hCLElBQUksT0FBTyxDQUFDLE1BQU0sS0FBSyxjQUFjLEVBQUUsQ0FBQztZQUN0QyxNQUFNLE9BQU8sR0FBRyxPQUFPLENBQUMsb0JBQW9CLENBQUMsS0FBSyxDQUFDLENBQUM7WUFDcEQsSUFBSSxPQUFPLENBQUMsSUFBSSxLQUFLLE1BQU0sSUFBSSxPQUFPLENBQUMsTUFBTSxFQUFFLENBQUM7Z0JBQzlDLE9BQU87b0JBQ0wsSUFBSSxFQUFFLG9CQUFvQjtvQkFDMUIsT0FBTyxFQUFFLHlDQUF5QyxPQUFPLENBQUMsTUFBTSxHQUFHO29CQUNuRSxJQUFJLEVBQUUsNEJBQTRCO2lCQUNuQyxDQUFDO1lBQ0osQ0FBQztRQUNILENBQUM7UUFDRCxPQUFPLEVBQUUsSUFBSSxFQUFFLGdCQUFnQixFQUFFLE9BQU8sRUFBRSxnREFBZ0QsRUFBRSxJQUFJLEVBQUUsa0JBQWtCLEVBQUUsQ0FBQztJQUN6SCxDQUFDLENBQUM7QUFDSixDQUFDIn0=

package/dist_ts_chat_harness_server/functions.validation.d.ts

@@ -0,0 +1,18 @@
+import type * as plugins from './plugins.js';
+import type { IFlexHarnessChatCaller, IFlexHarnessChatLimits } from './interfaces.js';
+export declare const BAD_REQUEST_MESSAGE = "The request is malformed. Reload the page and try again.";
+export declare const STOPPED_MESSAGE = "The assistant has stopped. Reload the page and try again.";
+/** One key per tab and scope: the same tab id in two scopes names two tabs. */
+export declare const tabKey: (tabArg: IFlexHarnessChatCaller) => string;
+export declare const isSameTab: (leftArg: IFlexHarnessChatCaller, rightArg: IFlexHarnessChatCaller) => boolean;
+/** A subscription id: 16 random bytes in hex, chosen by the tab. */
+export declare const readRandomId: (valueArg: unknown) => string;
+export declare const readSessionId: (valueArg: unknown, notFoundMessageArg: string) => string;
+export declare const readTitle: (valueArg: unknown, limitsArg: IFlexHarnessChatLimits) => string;
+/** A conversation title from its first message: the first line, shortened. */
+export declare const titleFromMessage: (sendArg: plugins.IHarnessComposerSendDetail) => string;
+/**
+ * The parts of a composer message the hub uses, checked. The composer's model, account and effort
+ * choices are not among them: the host's model resolver decides, from the turn's context.
+ */
+export declare const readSendDetail: (valueArg: unknown, limitsArg: IFlexHarnessChatLimits) => plugins.IHarnessComposerSendDetail;

package/dist_ts_chat_harness_server/functions.validation.js

@@ -0,0 +1,88 @@
+import { FlexHarnessChatRequestError } from './errors.js';
+export const BAD_REQUEST_MESSAGE = 'The request is malformed. Reload the page and try again.';
+export const STOPPED_MESSAGE = 'The assistant has stopped. Reload the page and try again.';
+const RANDOM_ID_PATTERN = /^[0-9a-f]{32}$/;
+const MAX_SESSION_ID_CHARS = 256;
+const TITLE_MAX_CHARS = 80;
+const ATTACHMENT_KINDS = ['image', 'text', 'binary'];
+/** One key per tab and scope: the same tab id in two scopes names two tabs. */
+export const tabKey = (tabArg) => `${tabArg.scopeId}\n${tabArg.tabId}`;
+export const isSameTab = (leftArg, rightArg) => leftArg.tabId === rightArg.tabId && leftArg.scopeId === rightArg.scopeId;
+const badRequest = () => new FlexHarnessChatRequestError(BAD_REQUEST_MESSAGE);
+const isRecord = (valueArg) => !!valueArg && typeof valueArg === 'object' && !Array.isArray(valueArg);
+/** A subscription id: 16 random bytes in hex, chosen by the tab. */
+export const readRandomId = (valueArg) => {
+    if (typeof valueArg !== 'string' || !RANDOM_ID_PATTERN.test(valueArg))
+        throw badRequest();
+    return valueArg;
+};
+export const readSessionId = (valueArg, notFoundMessageArg) => {
+    if (typeof valueArg !== 'string' || !valueArg || valueArg.length > MAX_SESSION_ID_CHARS) {
+        throw new FlexHarnessChatRequestError(notFoundMessageArg);
+    }
+    return valueArg;
+};
+export const readTitle = (valueArg, limitsArg) => {
+    const title = typeof valueArg === 'string' ? valueArg.trim() : '';
+    if (!title || title.length > limitsArg.maxTitleChars) {
+        throw new FlexHarnessChatRequestError(`A title has 1 to ${limitsArg.maxTitleChars} characters.`);
+    }
+    return title;
+};
+/** A conversation title from its first message: the first line, shortened. */
+export const titleFromMessage = (sendArg) => {
+    const text = sendArg.text || sendArg.attachments.map((attachment) => attachment.name).join(', ');
+    const line = text.split('\n').map((part) => part.trim()).find((part) => !!part) || 'New conversation';
+    return line.length > TITLE_MAX_CHARS ? line.slice(0, TITLE_MAX_CHARS - 1).trimEnd() + '…' : line;
+};
+const readOptionalString = (valueArg, maxCharsArg) => {
+    if (valueArg === undefined)
+        return undefined;
+    if (typeof valueArg !== 'string' || valueArg.length > maxCharsArg)
+        throw badRequest();
+    return valueArg;
+};
+const readAttachment = (valueArg, limitsArg) => {
+    if (!isRecord(valueArg)
+        || typeof valueArg.id !== 'string'
+        || typeof valueArg.name !== 'string'
+        || typeof valueArg.mediaType !== 'string'
+        || typeof valueArg.size !== 'number'
+        || typeof valueArg.kind !== 'string'
+        || !ATTACHMENT_KINDS.includes(valueArg.kind)) {
+        throw badRequest();
+    }
+    const text = readOptionalString(valueArg.text, limitsArg.maxAttachmentChars);
+    const dataBase64 = readOptionalString(valueArg.dataBase64, limitsArg.maxAttachmentChars);
+    return {
+        id: valueArg.id.slice(0, 128),
+        name: valueArg.name.slice(0, 255),
+        mediaType: valueArg.mediaType.slice(0, 255),
+        size: valueArg.size,
+        kind: valueArg.kind,
+        ...(text === undefined ? {} : { text }),
+        ...(dataBase64 === undefined ? {} : { dataBase64 }),
+        ...(valueArg.truncated === true ? { truncated: true } : {}),
+    };
+};
+/**
+ * The parts of a composer message the hub uses, checked. The composer's model, account and effort
+ * choices are not among them: the host's model resolver decides, from the turn's context.
+ */
+export const readSendDetail = (valueArg, limitsArg) => {
+    if (!isRecord(valueArg) || typeof valueArg.text !== 'string' || valueArg.text.length > limitsArg.maxMessageChars) {
+        throw badRequest();
+    }
+    if (!Array.isArray(valueArg.attachments) || valueArg.attachments.length > limitsArg.maxAttachments) {
+        throw badRequest();
+    }
+    const attachments = valueArg.attachments.map((entry) => readAttachment(entry, limitsArg));
+    const chars = attachments.reduce((sum, attachment) => sum + (attachment.text?.length ?? 0) + (attachment.dataBase64?.length ?? 0), 0);
+    if (chars > limitsArg.maxAttachmentChars)
+        throw new FlexHarnessChatRequestError('The attachments are too large.');
+    if (!valueArg.text.trim() && attachments.length === 0)
+        throw new FlexHarnessChatRequestError('The message is empty.');
+    // a message sent while a turn runs steers it, whatever delivery the composer chose
+    return { delivery: 'turn', text: valueArg.text, attachments };
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZnVuY3Rpb25zLnZhbGlkYXRpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19jaGF0X2hhcm5lc3Nfc2VydmVyL2Z1bmN0aW9ucy52YWxpZGF0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sRUFBRSwyQkFBMkIsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUcxRCxNQUFNLENBQUMsTUFBTSxtQkFBbUIsR0FBRywwREFBMEQsQ0FBQztBQUM5RixNQUFNLENBQUMsTUFBTSxlQUFlLEdBQUcsMkRBQTJELENBQUM7QUFDM0YsTUFBTSxpQkFBaUIsR0FBRyxnQkFBZ0IsQ0FBQztBQUMzQyxNQUFNLG9CQUFvQixHQUFHLEdBQUcsQ0FBQztBQUNqQyxNQUFNLGVBQWUsR0FBRyxFQUFFLENBQUM7QUFDM0IsTUFBTSxnQkFBZ0IsR0FBc0IsQ0FBQyxPQUFPLEVBQUUsTUFBTSxFQUFFLFFBQVEsQ0FBQyxDQUFDO0FBRXhFLCtFQUErRTtBQUMvRSxNQUFNLENBQUMsTUFBTSxNQUFNLEdBQUcsQ0FBQyxNQUE4QixFQUFVLEVBQUUsQ0FBQyxHQUFHLE1BQU0sQ0FBQyxPQUFPLEtBQUssTUFBTSxDQUFDLEtBQUssRUFBRSxDQUFDO0FBRXZHLE1BQU0sQ0FBQyxNQUFNLFNBQVMsR0FBRyxDQUFDLE9BQStCLEVBQUUsUUFBZ0MsRUFBVyxFQUFFLENBQ3RHLE9BQU8sQ0FBQyxLQUFLLEtBQUssUUFBUSxDQUFDLEtBQUssSUFBSSxPQUFPLENBQUMsT0FBTyxLQUFLLFFBQVEsQ0FBQyxPQUFPLENBQUM7QUFFM0UsTUFBTSxVQUFVLEdBQUcsR0FBRyxFQUFFLENBQUMsSUFBSSwyQkFBMkIsQ0FBQyxtQkFBbUIsQ0FBQyxDQUFDO0FBRTlFLE1BQU0sUUFBUSxHQUFHLENBQUMsUUFBaUIsRUFBdUMsRUFBRSxDQUMxRSxDQUFDLENBQUMsUUFBUSxJQUFJLE9BQU8sUUFBUSxLQUFLLFFBQVEsSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMs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

package/dist_ts_chat_harness_server/index.d.ts

@@ -0,0 +1,4 @@
+export { FlexHarnessChatHub, defaultFlexHarnessChatLimits, flexHarnessChatSessionMeta, } from './classes.chathub.js';
+export { FlexHarnessChatRequestError, FlexHarnessChatTabUnavailableError } from './errors.js';
+export { createFlexHarnessChatErrorProjector, type IFlexHarnessChatErrorProjectorOptions, } from './functions.errorprojector.js';
+export type { IFlexHarnessChatCaller, IFlexHarnessChatHubOptions, IFlexHarnessChatLimits, IFlexHarnessChatPeer, IFlexHarnessChatPeers, IFlexHarnessChatTurn, TFlexHarnessChatHubHarness, } from './interfaces.js';

package/dist_ts_chat_harness_server/index.js

@@ -0,0 +1,4 @@
+export { FlexHarnessChatHub, defaultFlexHarnessChatLimits, flexHarnessChatSessionMeta, } from './classes.chathub.js';
+export { FlexHarnessChatRequestError, FlexHarnessChatTabUnavailableError } from './errors.js';
+export { createFlexHarnessChatErrorProjector, } from './functions.errorprojector.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19jaGF0X2hhcm5lc3Nfc2VydmVyL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFDTCxrQkFBa0IsRUFDbEIsNEJBQTRCLEVBQzVCLDBCQUEwQixHQUMzQixNQUFNLHNCQUFzQixDQUFDO0FBQzlCLE9BQU8sRUFBRSwyQkFBMkIsRUFBRSxrQ0FBa0MsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUM5RixPQUFPLEVBQ0wsbUNBQW1DLEdBRXBDLE1BQU0sK0JBQStCLENBQUMifQ==

package/dist_ts_chat_harness_server/interfaces.d.ts

@@ -0,0 +1,67 @@
+import type * as plugins from './plugins.js';
+/**
+ * Who a request is from, as the host established it: the tab, and the scope whose conversations it
+ * may reach. A tab is named by both: the same tab id in two scopes names two tabs.
+ */
+export interface IFlexHarnessChatCaller {
+    /** the browser tab, a per-page secret; pushes and tool calls of its turns go to it */
+    tabId: string;
+    /** derived by the host from its own authentication, never taken from the browser */
+    scopeId: string;
+}
+/** One tab, reached over its current connection. */
+export interface IFlexHarnessChatPeer {
+    update(push: plugins.IFlexHarnessChatUpdate): Promise<void>;
+    sessions(push: plugins.IFlexHarnessChatSessionsPush): Promise<void>;
+    runTool(request: plugins.IFlexHarnessChatToolRequest, options: {
+        timeoutMs: number;
+        abortSignal?: AbortSignal;
+    }): Promise<plugins.TJsonValue>;
+}
+/** Where the hub finds the tabs it talks to. */
+export interface IFlexHarnessChatPeers {
+    /** The tab's current connection in its scope, or null when the tab is gone. */
+    find(tab: IFlexHarnessChatCaller): Promise<IFlexHarnessChatPeer | null>;
+}
+/** The running turn of a conversation: the tab that started it and the context it was sent with. */
+export interface IFlexHarnessChatTurn<TContext> {
+    readonly scopeId: string;
+    readonly sessionId: string;
+    readonly tabId: string;
+    readonly context: TContext;
+}
+export interface IFlexHarnessChatLimits {
+    /** A turn that runs longer is stopped. Default: 10 minutes. */
+    turnTimeoutMs: number;
+    /** How long a message may wait for a turn that is already ending. Default: 30 seconds. */
+    admissionWaitMs: number;
+    /** A tool call of the tab that is not answered in time fails. Default: 2 minutes. */
+    toolTimeoutMs: number;
+    /** Deltas one update may carry; a tab further behind gets the changed rows. Default: 2000. */
+    maxPendingDeltas: number;
+    /** Characters of a message's text. Default: 100 000. */
+    maxMessageChars: number;
+    /** Attachments of one message. Default: 16. */
+    maxAttachments: number;
+    /** Characters of all attachment payloads of one message, as sent. Default: 8 MiB. */
+    maxAttachmentChars: number;
+    /** Characters of a conversation title. Default: 200. */
+    maxTitleChars: number;
+    /** How often tabs that are gone are forgotten. Default: 5 minutes. */
+    sweepIntervalMs: number;
+}
+/** The harness calls a hub makes; a `FlexHarness` of any scope provides them. */
+export type TFlexHarnessChatHubHarness = Pick<plugins.FlexHarness<unknown>, 'subscribe' | 'listSessions' | 'createSession' | 'getSession' | 'updateSession' | 'deleteSession' | 'getSessionView' | 'getSessionReversionInfo' | 'enqueuePrompt' | 'steerPrompt' | 'getPromptQueueEntry' | 'abort' | 'cancelPrompt' | 'respondToPermission' | 'undoSession' | 'redoSession'>;
+export interface IFlexHarnessChatHubOptions<TContext> {
+    /**
+     * The harness the conversations run on. The host keeps configuring it: its model resolver and
+     * tool provider read the running turn with `hub.turnOf()`.
+     */
+    harness: TFlexHarnessChatHubHarness;
+    peers: IFlexHarnessChatPeers;
+    /** Checks the context a message is sent with and returns it as the turn carries it; throw to refuse. */
+    readContext(value: plugins.TJsonValue): TContext;
+    /** The title of a conversation a message starts. Defaults to the message's first line. */
+    titleOf?(send: plugins.IHarnessComposerSendDetail): string;
+    limits?: Partial<IFlexHarnessChatLimits>;
+}

package/dist_ts_chat_harness_server/interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzX2NoYXRfaGFybmVzc19zZXJ2ZXIvaW50ZXJmYWNlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=