@nxisai/agent-harness 0.5.0 → 0.7.0

package/dist/handoff/controller.d.ts.map

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

package/dist/handoff/controller.js

@@ -0,0 +1,543 @@
+/**
+ * Runs handoffs: one per conversation, to an agent or a person, over A2A
+ * through the site's relay.
+ *
+ * The controller is headless. It starts a handoff, sends what the visitor types
+ * while one is open, ends it, and turns what the target sends back into
+ * {@link HandoffEvent}s, dispatched as `handoff` events. A UI renders those; the
+ * packaged element does.
+ *
+ * A handoff outlives the page it started on. Its task id, and the key the
+ * relay tied it to, are kept per conversation in `localStorage`, and
+ * {@link HandoffController.resume} picks it up on the next page. A stream the
+ * host cuts off mid-handoff is picked up the same way, after a short wait.
+ *
+ * @module
+ */
+import { A2AClient, A2AError, } from './a2a.js';
+import { HANDOFF_EXTENSION, envelopeMessage, readHandBack, readOperator, readQueue, readableText, visitorMessage, } from './envelope.js';
+/** Whether a handoff in this state is over. */
+export const isHandoffOver = (state) => state === 'handed-back' || state === 'ended' || state === 'failed';
+const STORAGE_KEY = 'nxis:handoffs:v1';
+/** A finished handoff is kept a day, so its hand-back survives a reload; an open one a month. */
+const KEEP_FINISHED_MS = 24 * 60 * 60 * 1000;
+const KEEP_OPEN_MS = 30 * 24 * 60 * 60 * 1000;
+const TARGETS_TTL_MS = 30 * 1000;
+const MAX_SEEN = 200;
+const MAX_RESUME_DELAY_MS = 15000;
+/** The response header a relay ties a task to this browser with. */
+export const HANDOFF_KEY_HEADER = 'Nxis-Handoff-Key';
+function defaultStorage() {
+    try {
+        return typeof localStorage === 'undefined' ? null : localStorage;
+    }
+    catch {
+        return null;
+    }
+}
+/** A failure in words a visitor can read. */
+function describeFailure(err, label) {
+    if (err instanceof A2AError) {
+        if (err.status === 429) {
+            return `${label} is busy right now.${err.retryAfter ? ` Try again in about ${Math.ceil(err.retryAfter / 60)} minute(s).` : ''}`;
+        }
+        if (err.status === 404)
+            return `${label} isn't available on this site.`;
+        if (err.status === 403)
+            return `This conversation can't reach ${label} from here.`;
+    }
+    return `I couldn't reach ${label}.`;
+}
+/** Runs handoffs for every conversation on the page. Dispatches `handoff` events. */
+export class HandoffController extends EventTarget {
+    constructor(opts) {
+        super();
+        this.opts = opts;
+        this.sessions = new Map();
+        /** The stream open for each conversation, so a new one can close it first. */
+        this.live = new Map();
+        /** Consecutive resumes that brought nothing, per conversation, for backoff. */
+        this.idle = new Map();
+        this.timers = new Map();
+        this.targetsCache = null;
+        /** Events reported so far, so a stream can tell whether it brought anything new. */
+        this.reported = 0;
+        this.loaded = false;
+        this.storage = opts.storage === undefined ? defaultStorage() : opts.storage;
+    }
+    /** The page's target config. */
+    get config() {
+        return { relay: this.opts.relay, targets: this.opts.targets };
+    }
+    /**
+     * The targets that can be offered: those both in the page's config and on
+     * the relay's list, with the relay's availability.
+     *
+     * Cached for thirty seconds. A relay that can't be reached offers none.
+     */
+    targets() {
+        const now = this.now();
+        if (this.targetsCache && now - this.targetsCache.at < TARGETS_TTL_MS)
+            return this.targetsCache.list;
+        const list = this.fetchTargets().catch((err) => {
+            console.warn('[nxis-handoff] could not read the relay:', err);
+            this.targetsCache = null;
+            return [];
+        });
+        this.targetsCache = { at: now, list };
+        return list;
+    }
+    async fetchTargets() {
+        const doFetch = this.opts.fetchImpl ?? fetch;
+        const res = await doFetch(this.opts.relay, { headers: { Accept: 'application/json' }, credentials: 'same-origin' });
+        if (!res.ok)
+            throw new Error(`GET ${this.opts.relay} → ${res.status}`);
+        const body = (await res.json());
+        const out = [];
+        for (const t of body.targets ?? []) {
+            const name = String(t.name ?? '');
+            const mine = this.opts.targets[name];
+            // The page decides what is offered and how it is named; the relay decides what is reachable.
+            if (!mine)
+                continue;
+            out.push({
+                name,
+                kind: mine.kind,
+                label: mine.label,
+                description: mine.description ?? t.description,
+                available: t.available !== false,
+                hours: t.hours,
+                queueLength: t.queueLength,
+                waitMinutes: t.waitMinutes ?? null,
+                transcript: t.transcript === true,
+            });
+        }
+        return out;
+    }
+    /** A conversation's handoff, open or finished, if it has one. */
+    session(conversationId) {
+        this.load();
+        return this.sessions.get(conversationId) ?? null;
+    }
+    /** A conversation's handoff while it is open, else null. */
+    active(conversationId) {
+        if (!conversationId)
+            return null;
+        const s = this.session(conversationId);
+        return s && !isHandoffOver(s.state) ? s : null;
+    }
+    /**
+     * Hand a conversation to a target.
+     *
+     * Resolves once the relay has accepted it; what the target says arrives as
+     * events. Call only after the visitor has confirmed what is being sent.
+     *
+     * @throws When the target is not configured, the conversation is already
+     * handed off, or the relay refuses. The session is marked failed first.
+     */
+    async start(conversationId, target, envelope) {
+        const config = this.opts.targets[target];
+        if (!config)
+            throw new Error(`"${target}" is not a handoff target on this page.`);
+        if (this.active(conversationId))
+            throw new Error('This conversation is already handed off.');
+        const now = this.now();
+        const session = {
+            conversationId,
+            target,
+            label: config.label,
+            kind: config.kind,
+            state: 'connecting',
+            startedAt: now,
+            updatedAt: now,
+            seen: [],
+        };
+        this.sessions.set(conversationId, session);
+        this.setState(session, 'connecting');
+        const message = envelopeMessage(envelope);
+        session.seen.push(message.messageId);
+        let stream;
+        const abort = this.openLive(conversationId);
+        try {
+            stream = await this.client(target).stream('SendStreamingMessage', { message, configuration: { acceptedOutputModes: ['text/plain', 'application/json'] } }, { signal: abort.signal });
+        }
+        catch (err) {
+            this.live.delete(conversationId);
+            session.error = describeFailure(err, config.label);
+            this.setState(session, 'failed');
+            throw err;
+        }
+        const key = stream.headers.get(HANDOFF_KEY_HEADER);
+        if (key)
+            session.key = key;
+        this.save();
+        void this.pump(session, stream, abort);
+        return session;
+    }
+    /**
+     * Send what the visitor typed to the target handling this conversation.
+     *
+     * @throws When nothing is handed off, or the target hasn't answered yet.
+     */
+    async send(conversationId, text) {
+        const session = this.active(conversationId);
+        if (!session)
+            throw new Error('This conversation is not handed off.');
+        if (!session.taskId && !session.contextId)
+            throw new Error(`Still connecting to ${session.label}.`);
+        const message = visitorMessage(text, { taskId: session.taskId, contextId: session.contextId });
+        this.remember(session, message.messageId);
+        const abort = this.openLive(conversationId);
+        try {
+            const stream = await this.client(session.target).stream('SendStreamingMessage', { message, configuration: { acceptedOutputModes: ['text/plain', 'application/json'] } }, { signal: abort.signal, headers: this.keyHeader(session) });
+            void this.pump(session, stream, abort);
+        }
+        catch (err) {
+            if (abort.signal.aborted)
+                return;
+            this.live.delete(conversationId);
+            session.error = describeFailure(err, session.label);
+            this.setState(session, 'failed');
+            throw err;
+        }
+    }
+    /**
+     * End a handoff at the visitor's request: "Back to the assistant".
+     *
+     * Cancels the task at the target. A target that won't cancel still loses the
+     * visitor: the handoff is ended here either way.
+     */
+    async end(conversationId) {
+        const session = this.active(conversationId);
+        if (!session)
+            return;
+        this.closeLive(conversationId);
+        if (session.taskId) {
+            try {
+                await this.client(session.target).call('CancelTask', { id: session.taskId }, { headers: this.keyHeader(session) });
+            }
+            catch {
+                // Already finished, or unreachable: the visitor has left it regardless.
+            }
+        }
+        this.setState(session, 'ended');
+    }
+    /**
+     * Pick up an open handoff after a page change or reload.
+     *
+     * Subscribes to the task while it runs, or reads it once when it is waiting
+     * on the visitor. Safe to call for any conversation, at any time: it does
+     * nothing when there is no open handoff or a stream is already open.
+     */
+    async resume(conversationId) {
+        const session = this.active(conversationId);
+        if (!session || this.live.has(conversationId))
+            return;
+        if (!session.taskId) {
+            // It never got as far as a task: the page left before the target answered.
+            session.error = `The connection to ${session.label} was lost before it started.`;
+            this.setState(session, 'failed');
+            return;
+        }
+        // An agent waiting on the visitor has nothing more to say until they answer. A person might.
+        if (session.state === 'awaiting-visitor' && session.kind === 'agent') {
+            await this.readOnce(session);
+            return;
+        }
+        const abort = this.openLive(conversationId);
+        try {
+            const stream = await this.client(session.target).stream('SubscribeToTask', { id: session.taskId }, { signal: abort.signal, headers: this.keyHeader(session) });
+            void this.pump(session, stream, abort);
+        }
+        catch (err) {
+            this.live.delete(conversationId);
+            if (abort.signal.aborted)
+                return;
+            if (err instanceof A2AError && (err.status === 403 || err.status === 404)) {
+                session.error = `The conversation with ${session.label} has expired.`;
+                this.setState(session, 'failed');
+                return;
+            }
+            // Finished while we were away (subscribing to a finished task is refused), or a blip.
+            await this.readOnce(session);
+        }
+    }
+    /** Stop every stream and pending resume. The sessions stay saved for the next page. */
+    dispose() {
+        for (const id of [...this.live.keys()])
+            this.closeLive(id);
+        for (const t of this.timers.values())
+            clearTimeout(t);
+        this.timers.clear();
+    }
+    // ── Streams ────────────────────────────────────────────────────────────────
+    client(target) {
+        const relay = this.opts.relay.replace(/\/+$/, '');
+        return new A2AClient({
+            endpoint: `${relay}/${encodeURIComponent(target)}`,
+            extensions: [HANDOFF_EXTENSION],
+            fetchImpl: this.opts.fetchImpl,
+        });
+    }
+    keyHeader(session) {
+        return session.key ? { [HANDOFF_KEY_HEADER]: session.key } : {};
+    }
+    /** A fresh abort signal for a conversation's stream, closing the one before it. */
+    openLive(conversationId) {
+        this.closeLive(conversationId);
+        const abort = new AbortController();
+        this.live.set(conversationId, abort);
+        return abort;
+    }
+    closeLive(conversationId) {
+        this.live.get(conversationId)?.abort();
+        this.live.delete(conversationId);
+        const timer = this.timers.get(conversationId);
+        if (timer)
+            clearTimeout(timer);
+        this.timers.delete(conversationId);
+    }
+    /** Read a stream to its end, then resume it if the task is still running. */
+    async pump(session, stream, abort) {
+        const id = session.conversationId;
+        // Progress is what the visitor would notice: a new message, a new state. A resubscribe that only
+        // repeats the task as it stood is not progress, and must back off like an empty one.
+        const before = this.reported;
+        try {
+            for await (const event of stream.events) {
+                if (abort.signal.aborted)
+                    return;
+                this.apply(session, event);
+            }
+        }
+        catch (err) {
+            if (abort.signal.aborted)
+                return;
+            console.warn(`[nxis-handoff] stream from ${session.label} broke:`, err);
+        }
+        if (abort.signal.aborted)
+            return;
+        if (this.live.get(id) === abort)
+            this.live.delete(id);
+        if (isHandoffOver(session.state))
+            return;
+        // Waiting on the visitor: their next message opens the next stream.
+        if (session.state === 'awaiting-visitor' && session.kind === 'agent')
+            return;
+        // The stream ended with the task still running: the host cut it off. Come back for the rest.
+        const quiet = this.reported > before ? 0 : (this.idle.get(id) ?? 0) + 1;
+        this.idle.set(id, quiet);
+        const base = this.opts.resumeDelayMs ?? 1000;
+        const delay = Math.min(base * 2 ** Math.max(0, quiet - 1), MAX_RESUME_DELAY_MS);
+        this.timers.set(id, setTimeout(() => {
+            this.timers.delete(id);
+            void this.resume(id);
+        }, delay));
+    }
+    /** Read a task once, for a handoff that can't or needn't be streamed. */
+    async readOnce(session) {
+        if (!session.taskId)
+            return;
+        try {
+            const { result } = await this.client(session.target).call('GetTask', { id: session.taskId, historyLength: 50 }, { headers: this.keyHeader(session) });
+            const task = result.task ?? result;
+            this.apply(session, { task });
+        }
+        catch (err) {
+            session.error =
+                err instanceof A2AError && (err.status === 403 || err.status === 404)
+                    ? `The conversation with ${session.label} has expired.`
+                    : describeFailure(err, session.label);
+            this.setState(session, 'failed');
+        }
+    }
+    // ── Events ─────────────────────────────────────────────────────────────────
+    apply(session, event) {
+        if (event.task) {
+            const task = event.task;
+            this.adopt(session, task.id, task.contextId);
+            for (const message of task.history ?? [])
+                this.message(session, message);
+            for (const artifact of task.artifacts ?? [])
+                this.parts(session, artifact.parts, artifact.artifactId);
+            this.status(session, task.status);
+        }
+        else if (event.statusUpdate) {
+            this.adopt(session, event.statusUpdate.taskId, event.statusUpdate.contextId);
+            this.status(session, event.statusUpdate.status);
+        }
+        else if (event.artifactUpdate) {
+            this.adopt(session, event.artifactUpdate.taskId, event.artifactUpdate.contextId);
+            const a = event.artifactUpdate.artifact;
+            this.parts(session, a.parts, a.artifactId);
+        }
+        else if (event.message) {
+            // A reply with no task: the target answered at once. The context carries the conversation on.
+            this.adopt(session, event.message.taskId, event.message.contextId);
+            this.message(session, event.message);
+            if (session.state === 'connecting' || session.state === 'queued')
+                this.setState(session, 'active');
+        }
+    }
+    adopt(session, taskId, contextId) {
+        let changed = false;
+        if (taskId && session.taskId !== taskId) {
+            session.taskId = taskId;
+            changed = true;
+        }
+        if (contextId && session.contextId !== contextId) {
+            session.contextId = contextId;
+            changed = true;
+        }
+        if (changed)
+            this.save();
+    }
+    status(session, status) {
+        const queue = readQueue(status.message?.parts);
+        if (queue)
+            session.queue = queue;
+        // Who is speaking is known before what they say, so "Sam has joined" comes first.
+        const operator = readOperator(status.message?.parts);
+        if (operator)
+            session.operator = operator.name;
+        // A hand-back is read before the state is decided: it is what makes COMPLETED "handed back".
+        const handBack = readHandBack(status.message?.parts);
+        const next = handBack && status.state === 'TASK_STATE_COMPLETED' ? 'handed-back' : this.stateFor(status.state, session);
+        const changed = !!next && (next !== session.state || !!queue);
+        // A state that continues the conversation is announced before the message that comes with it;
+        // one that ends it after the last word.
+        if (changed && !isHandoffOver(next))
+            this.setState(session, next);
+        if (status.message)
+            this.message(session, status.message);
+        if (!next)
+            return;
+        if (changed && isHandoffOver(next))
+            this.setState(session, next);
+        if (isHandoffOver(next))
+            this.closeLive(session.conversationId);
+    }
+    stateFor(state, session) {
+        switch (state) {
+            case 'TASK_STATE_SUBMITTED':
+                return session.kind === 'person' ? 'queued' : 'connecting';
+            case 'TASK_STATE_WORKING':
+                return 'active';
+            case 'TASK_STATE_INPUT_REQUIRED':
+                return 'awaiting-visitor';
+            case 'TASK_STATE_COMPLETED':
+                return session.handBack ? 'handed-back' : 'ended';
+            case 'TASK_STATE_CANCELED':
+                return 'ended';
+            case 'TASK_STATE_AUTH_REQUIRED':
+                session.error = `${session.label} needs you to sign in, which isn't supported here yet.`;
+                return 'failed';
+            case 'TASK_STATE_FAILED':
+            case 'TASK_STATE_REJECTED':
+                session.error ?? (session.error = `${session.label} couldn't take this conversation.`);
+                return 'failed';
+            default:
+                return null;
+        }
+    }
+    /** One message from the target: who is speaking, a hand-back, and the words. */
+    message(session, message) {
+        if (message.role === 'ROLE_USER') {
+            this.remember(session, message.messageId);
+            return;
+        }
+        if (message.messageId && session.seen.includes(message.messageId))
+            return;
+        this.remember(session, message.messageId);
+        this.parts(session, message.parts);
+    }
+    parts(session, parts = [], artifactId) {
+        if (artifactId) {
+            const seenKey = `artifact:${artifactId}`;
+            if (session.seen.includes(seenKey))
+                return;
+            this.remember(session, seenKey);
+        }
+        const operator = readOperator(parts);
+        if (operator) {
+            session.operator = operator.name;
+            this.save();
+        }
+        const handBack = readHandBack(parts);
+        const text = readableText(parts);
+        // The last words first, then what they hand back: the references follow the goodbye.
+        if (text) {
+            this.emit({
+                type: 'message',
+                conversationId: session.conversationId,
+                session,
+                from: session.operator ?? session.label,
+                fromKind: operator?.kind ?? session.kind,
+                text,
+            });
+        }
+        if (handBack && !session.handBack) {
+            session.handBack = handBack;
+            this.save();
+            this.emit({ type: 'handback', conversationId: session.conversationId, session, handBack });
+        }
+    }
+    remember(session, id) {
+        if (!id || session.seen.includes(id))
+            return;
+        session.seen.push(id);
+        if (session.seen.length > MAX_SEEN)
+            session.seen.splice(0, session.seen.length - MAX_SEEN);
+        this.save();
+    }
+    setState(session, state) {
+        session.state = state;
+        session.updatedAt = this.now();
+        if (state !== 'queued')
+            delete session.queue;
+        if (isHandoffOver(state))
+            this.idle.delete(session.conversationId);
+        this.save();
+        this.emit({ type: 'state', conversationId: session.conversationId, session, state });
+    }
+    emit(detail) {
+        this.reported++;
+        this.dispatchEvent(new CustomEvent('handoff', { detail }));
+    }
+    // ── Storage ────────────────────────────────────────────────────────────────
+    now() {
+        return this.opts.now?.() ?? Date.now();
+    }
+    load() {
+        if (this.loaded)
+            return;
+        this.loaded = true;
+        if (!this.storage)
+            return;
+        try {
+            const raw = JSON.parse(this.storage.getItem(STORAGE_KEY) || '{}');
+            const now = this.now();
+            for (const [id, s] of Object.entries(raw)) {
+                const keep = isHandoffOver(s.state) ? KEEP_FINISHED_MS : KEEP_OPEN_MS;
+                if (s && typeof s.target === 'string' && now - (s.updatedAt ?? 0) < keep && !this.sessions.has(id)) {
+                    this.sessions.set(id, { ...s, seen: Array.isArray(s.seen) ? s.seen : [] });
+                }
+            }
+        }
+        catch {
+            // Unreadable: start afresh.
+        }
+    }
+    save() {
+        if (!this.storage)
+            return;
+        this.load();
+        try {
+            this.storage.setItem(STORAGE_KEY, JSON.stringify(Object.fromEntries(this.sessions)));
+        }
+        catch {
+            // Full or blocked: the handoff still runs, it just won't survive a reload.
+        }
+    }
+}
+//# sourceMappingURL=controller.js.map

package/dist/handoff/controller.js.map

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