@telora/daemon 0.22.87 → 0.22.97

package/dist/nexus/pending-returns.js

@@ -0,0 +1,194 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/nexus/nexus-pending-returns-paging.test.ts,
+//   packages/daemon/src/nexus/nexus-pending-returns.test.ts,
+//   packages/daemon/src/nexus/nexus-return-path-e2e.test.ts,
+//   packages/daemon/src/nexus/nexus-return-routing.test.ts,
+//   packages/daemon/src/spawn/build-spawn-prompt.test.ts
+// PINNED-BY-END
+/**
+ * Nexus pending returns on the REQUESTING focus: what that focus is waiting on
+ * across products, and what came back.
+ *
+ * A pending return (product_request_pending_returns) is one return -- a
+ * discovery, question or findings entry the requested team sent, or the
+ * request's close / decline -- carried on the requesting focus until the
+ * requesting team acknowledges it. This module owns the READ + RENDER half:
+ *
+ *   - resolveNexusReturnsSection: loads the focus's unacknowledged returns and
+ *     the open outgoing requests the focus waits on (filed from the focus OR
+ *     from one of its deliveries), and renders ONE prompt section with every
+ *     return's FULL content (never truncated). The spawn path folds it into the
+ *     carried section every pass receives -- fresh coding, scoping, resume and
+ *     review -- so no pass on the focus misses a return.
+ *   - buildNexusReturnHandOff: the message handed to a LIVE team when a new
+ *     return arrives mid-session (nexus/return-routing.ts decides when).
+ *
+ * Leaf module: imports only query helpers, never the return / routing passes,
+ * so both the spawn path and the poll pass can import it without a cycle.
+ */
+import { callApi } from '../queries/shared.js';
+import { listAllOutgoingRequests } from '../queries/requests.js';
+import { createLogger } from '../shell/log.js';
+const log = createLogger({ module: 'nexus/pending-returns' });
+/** Rows per pending-return page (the product-api's max `limit`). */
+export const PENDING_RETURNS_PAGE_SIZE = 500;
+/**
+ * Read EVERY pending return matching the filter, oldest first. One list call
+ * serves at most a page, so a burst larger than a page would otherwise leave
+ * returns out of a prompt or out of an engagement pass. Walks the keyset cursor
+ * (the last row's createdAt + id) until a page comes back shorter than the limit
+ * the server applied (it echoes `limit`), so an earlier return acknowledged
+ * mid-walk never shifts a later one out of the read and a server cap below the
+ * requested page never ends the walk early. A full page that does not advance
+ * the cursor THROWS (no partial list read as complete). THROWS on a hard API
+ * error. `deps.callApi` is the test seam.
+ */
+export async function listAllPendingReturns(filter, deps = {}) {
+    const call = deps.callApi ?? callApi;
+    const all = [];
+    let cursor = null;
+    for (;;) {
+        const params = { ...filter, limit: PENDING_RETURNS_PAGE_SIZE, ...(cursor ?? {}) };
+        const res = await call('product_request_list_pending_returns', params);
+        const rows = res.pendingReturns ?? [];
+        all.push(...rows);
+        const served = typeof res.limit === 'number' && res.limit > 0 ? Math.min(res.limit, PENDING_RETURNS_PAGE_SIZE) : PENDING_RETURNS_PAGE_SIZE;
+        if (rows.length < served)
+            return all;
+        const last = rows[rows.length - 1];
+        if (cursor && cursor.afterCreatedAt === last.createdAt && cursor.afterId === last.id) {
+            throw new Error(`listAllPendingReturns: the page after ${last.id} did not advance; refusing a partial read`);
+        }
+        cursor = { afterCreatedAt: last.createdAt, afterId: last.id };
+    }
+}
+/**
+ * Request statuses in which an outgoing request is still open: the requesting
+ * work waits on it. Single definition shared with the source-delivery gate
+ * (nexus/return.ts).
+ */
+export const WAITING_REQUEST_STATUSES = new Set(['open', 'accepted', 'in_progress', 'delivered']);
+/**
+ * Pure: the open outgoing requests a focus waits on -- filed from the focus
+ * itself (with or without a source delivery) or from one of its deliveries.
+ */
+export function selectWaitingOnRequests(outgoing, focusId, deliveryIds) {
+    return outgoing.filter((r) => {
+        if (!r.status || !WAITING_REQUEST_STATUSES.has(r.status))
+            return false;
+        if (r.sourceFocusId === focusId)
+            return true;
+        return !!r.sourceDeliveryId && deliveryIds.has(r.sourceDeliveryId);
+    });
+}
+/** The acknowledge instruction, shared by the spawn section and the live hand-off. */
+function acknowledgeInstructionLines() {
+    return [
+        'For each return:',
+        '1. Act on it in this pass. Fold a discovery or findings into your plan. Answer a question by',
+        '   updating the request or filing a follow-up request. A CLOSED request releases the work that',
+        '   waited on it. A DECLINED request hands that work back to you to re-plan: re-scope the waiting',
+        '   delivery, or file a different request.',
+        '2. Acknowledge it once handled: `telora_product_request` (action: "acknowledge_return",',
+        '   pendingReturnId: "<id>", note: "<what you did>"). An acknowledged return stops appearing in',
+        '   your prompts and never re-engages this focus.',
+    ];
+}
+/** Pure: one return rendered in full (its content is never truncated). */
+export function renderPendingReturnBlock(ret) {
+    const title = ret.requestTitle ? `"${ret.requestTitle}"` : `request ${ret.requestId}`;
+    const anchor = ret.sourceDeliveryId ? ` (for delivery ${ret.sourceDeliveryId})` : '';
+    return [
+        `#### [${ret.returnKind}] ${title}${anchor} -- ${ret.createdAt}`,
+        `pendingReturnId: ${ret.id}`,
+        '',
+        ret.content,
+        '',
+    ];
+}
+/**
+ * Pure: the Nexus section for a focus's prompt. Empty (no lines) when the focus
+ * waits on nothing and has no pending return.
+ */
+export function buildNexusReturnsSection(args) {
+    const { waitingOn, pendingReturns } = args;
+    if (waitingOn.length === 0 && pendingReturns.length === 0)
+        return '';
+    const lines = ['## Nexus: cross-product requests this focus waits on, and what came back', ''];
+    if (waitingOn.length > 0) {
+        lines.push('### Waiting on another product', '', 'This focus filed these requests and they are still open, so the work that asked for them is', 'waiting on another product\'s team. Do not build around the dependency. Plan the work that does', 'not need it, and act on the returns below as they arrive.', '');
+        for (const r of waitingOn) {
+            const origin = r.sourceDeliveryId ? `filed by delivery ${r.sourceDeliveryId}` : 'filed by this focus';
+            lines.push(`- "${r.title ?? r.id}" (request ${r.id}, status: ${r.status ?? 'unknown'}; ${origin})`);
+        }
+        lines.push('');
+    }
+    if (pendingReturns.length > 0) {
+        lines.push('### Returns pending your acknowledgement', '', 'The requested products sent these back on this focus\'s requests, or the request closed or was', 'declined. Each is kept here, in full, in every pass on this focus until you acknowledge it.', '', ...acknowledgeInstructionLines(), '');
+        for (const ret of pendingReturns)
+            lines.push(...renderPendingReturnBlock(ret));
+    }
+    return lines.join('\n').trimEnd();
+}
+/** Pure: the message handed to a live team when new returns arrive mid-session. */
+export function buildNexusReturnHandOff(returns) {
+    const lines = [
+        '## Nexus return arrived while you are working',
+        '',
+        `${returns.length} new return(s) arrived on this focus's cross-product request(s).`,
+        '',
+        ...acknowledgeInstructionLines(),
+        '',
+    ];
+    for (const ret of returns)
+        lines.push(...renderPendingReturnBlock(ret));
+    return lines.join('\n').trimEnd();
+}
+/** The production reads over a product-api client (`apiDeps.callApi` is the test seam). */
+export function nexusReturnsSectionDeps(apiDeps = {}) {
+    return {
+        listFocusPendingReturns: (focusId) => listAllPendingReturns({ focusId }, apiDeps),
+        listOutgoing: (productId) => listAllOutgoingRequests(productId, apiDeps),
+    };
+}
+export const defaultNexusReturnsSectionDeps = nexusReturnsSectionDeps();
+/**
+ * Load + render the focus's Nexus section. Best-effort: each read degrades to
+ * empty on failure (logged) and never blocks a spawn.
+ */
+export async function resolveNexusReturnsSection(args, deps = defaultNexusReturnsSectionDeps) {
+    const { focusId, productId, deliveryIds } = args;
+    const [returnsResult, outgoingResult] = await Promise.allSettled([
+        deps.listFocusPendingReturns(focusId),
+        productId ? deps.listOutgoing(productId) : Promise.resolve([]),
+    ]);
+    if (returnsResult.status === 'rejected') {
+        log.warn(`nexus pending returns read failed for focus ${focusId.slice(0, 8)}: ${returnsResult.reason.message}`);
+    }
+    if (outgoingResult.status === 'rejected') {
+        log.warn(`nexus outgoing requests read failed for focus ${focusId.slice(0, 8)}: ${outgoingResult.reason.message}`);
+    }
+    const pendingReturns = returnsResult.status === 'fulfilled' ? returnsResult.value : [];
+    const outgoing = outgoingResult.status === 'fulfilled' ? outgoingResult.value : [];
+    return buildNexusReturnsSection({
+        waitingOn: selectWaitingOnRequests(outgoing, focusId, new Set(deliveryIds)),
+        pendingReturns,
+    });
+}
+/**
+ * Fold the focus's Nexus section into the section every spawn shape carries
+ * (the answered-escalations carrier: appended to fresh directive + legacy
+ * prompts, the scoping message and the resume delta, for coding AND review
+ * passes). Ids are untouched: they name escalations to consume, not returns --
+ * a return is consumed only by the team's acknowledgement.
+ */
+export async function foldNexusReturnsSection(carried, args, deps = defaultNexusReturnsSectionDeps) {
+    const nexusSection = await resolveNexusReturnsSection(args, deps);
+    if (!nexusSection)
+        return carried;
+    return {
+        ids: carried.ids,
+        section: [carried.section, nexusSection].filter((s) => s.trim()).join('\n\n'),
+    };
+}
+//# sourceMappingURL=pending-returns.js.map

package/dist/nexus/pending-returns.js.map

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

package/dist/nexus/return-routing.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Nexus return routing: every return reaches the REQUESTING focus within one
+ * poll, whatever pass that focus is in, and engages it at most once.
+ *
+ * Runs per product in the poll loop (listener runNexusPasses), right after the
+ * resolve pass so a close decided this tick routes this tick, and BEFORE the
+ * spawn pass so a re-armed focus spawns the same tick.
+ *
+ *   1. ROUTE -- product_request_route_returns materializes every not-yet-routed
+ *      return of the product's outgoing requests (new entries, closes, declines)
+ *      into pending returns on the requesting focus. Set-based over EVERY
+ *      outgoing request, idempotent by dedupe key, so it is safe each tick and no
+ *      request's end goes unread however many requests the product has.
+ *   2. ENGAGE -- each not-yet-engaged return is engaged ONCE, by focus state:
+ *        live team        -> 'handed': the return is written to the lead's stdin
+ *                            now, without waiting for a respawn;
+ *        armed, no team   -> 'rearmed': the focus's re-arm signal is set (the
+ *                            escalation-answer path), so it spawns once for it
+ *                            even with no actionable delivery;
+ *        un-armed         -> left pending: visible on the focus, no spawn. It is
+ *                            engaged if and when the focus is armed.
+ *      A stamp is written only once its engagement is PROVEN, so no return is
+ *      ever marked engaged with nothing carrying it:
+ *        handed  -- the hand-off is written to stdin FIRST; only a landed write
+ *                   is stamped. A write that did not land stamps nothing and is
+ *                   retried next poll; a stamp that fails after a landed write
+ *                   re-hands next poll (at-least-once to a live team, never lost).
+ *        rearmed -- the stamp and the re-arm signal are one transaction
+ *                   (engage_product_request_returns): no signal, no stamp. It
+ *                   writes a fresh signal value per engaged batch, and the spawn
+ *                   side clears only the value it spawned for, so a batch engaged
+ *                   after a spawn rendered its prompt gets its own spawn.
+ *      Every unengaged return is read (paged) and engaged in batches of at most
+ *      ENGAGE_BATCH_SIZE, so a burst of any size is engaged in one poll. A stamp
+ *      covers only returns not already engaged or acknowledged, so one return is
+ *      handed / re-arms at most once -- the billed-respawn-loop hazard cannot form
+ *      around an unconsumed input.
+ *
+ * Every pass that spawns on the focus renders the unacknowledged returns in full
+ * (nexus/pending-returns.ts), and the requesting team's acknowledgement
+ * (telora_product_request acknowledge_return) is the durable consumed state.
+ *
+ * This replaces the nexus_request_resolved / nexus_clarification_requested
+ * escalations the return path used to file: those reached an agent only inside a
+ * coding spawn, truncated findings to the escalation cap, and spawned nothing.
+ */
+import type { Writable } from 'node:stream';
+import type { DaemonConfig } from '../types/index.js';
+import { type CallApiDeps } from '../queries/shared.js';
+import { type PendingReturn } from './pending-returns.js';
+/** Ids per engage call (the product-api's per-call cap). */
+export declare const ENGAGE_BATCH_SIZE = 200;
+/** How a not-yet-engaged return is engaged this tick. */
+export type ReturnEngagementDecision = 'handed' | 'rearmed' | 'leave_pending';
+/** Pure: the engagement a return gets from its requesting focus's state. */
+export declare function decideReturnEngagement(state: {
+    hasLiveTeam: boolean;
+    armed: boolean;
+}): ReturnEngagementDecision;
+/** Pure: group returns by requesting focus; a return with no focus has no team to engage. */
+export declare function groupReturnsByFocus(returns: readonly PendingReturn[]): Map<string, PendingReturn[]>;
+export interface NexusReturnRoutingDeps {
+    /** Route the product's not-yet-routed returns; returns how many were created. */
+    routeReturns: (productId: string) => Promise<number>;
+    /** The product's pending returns no team has been engaged for yet. */
+    listUnengagedReturns: (productId: string) => Promise<PendingReturn[]>;
+    /** focusId -> armed (active + assigned agent role), for the product's active focuses. */
+    listFocusArmState: (productId: string) => Promise<Map<string, boolean>>;
+    /** The live team lead's stdin for a focus, or null when no team is live. */
+    getLiveTeamStdin: (focusId: string) => Writable | null;
+    /** Stamp returns engaged (only not-yet-engaged ones); returns the ids actually stamped. */
+    engageReturns: (focusId: string, pendingReturnIds: string[], engagement: 'handed' | 'rearmed') => Promise<string[]>;
+    /** Write a message to a live team's stdin; false when the write did not land. */
+    handToLiveTeam: (focusId: string, stdin: Writable, message: string) => boolean;
+    log?: (msg: string) => void;
+}
+/**
+ * The production deps. `apiDeps.callApi` replaces the product-api client for
+ * every API-backed dep (route, list, engage), so an end-to-end test drives this
+ * exact wiring over one shared fake API.
+ */
+export declare function defaultNexusReturnRoutingDeps(apiDeps?: CallApiDeps): NexusReturnRoutingDeps;
+/**
+ * Poll one product: route its returns, then engage each requesting focus once.
+ * Best-effort throughout: a route failure still engages already-routed returns,
+ * and one focus's failure never aborts the others.
+ */
+export declare function routeNexusReturns(config: DaemonConfig, deps?: NexusReturnRoutingDeps): Promise<void>;
+//# sourceMappingURL=return-routing.d.ts.map

package/dist/nexus/return-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"return-routing.d.ts","sourceRoot":"","sources":["../../src/nexus/return-routing.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAIjE,OAAO,EAAkD,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK1G,4DAA4D;AAC5D,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,yDAAyD;AACzD,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,SAAS,GAAG,eAAe,CAAC;AAE9E,4EAA4E;AAC5E,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,wBAAwB,CAIhH;AAED,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CASnG;AAED,MAAM,WAAW,sBAAsB;IACrC,iFAAiF;IACjF,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,sEAAsE;IACtE,oBAAoB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACtE,yFAAyF;IACzF,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACxE,4EAA4E;IAC5E,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,QAAQ,GAAG,IAAI,CAAC;IACvD,2FAA2F;IAC3F,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,GAAG,SAAS,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpH,iFAAiF;IACjF,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAC/E,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,GAAE,WAAgB,GAAG,sBAAsB,CA4B/F;AA4CD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,YAAY,EACpB,IAAI,GAAE,sBAAwD,GAC7D,OAAO,CAAC,IAAI,CAAC,CAqCf"}

package/dist/nexus/return-routing.js

@@ -0,0 +1,148 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/nexus/nexus-return-path-e2e.test.ts,
+//   packages/daemon/src/nexus/nexus-return-routing.test.ts
+// PINNED-BY-END
+import { sendMessage } from '@telora/daemon-core';
+import { callApi } from '../queries/shared.js';
+import { getActiveFocuses } from '../queries/focus-discovery.js';
+import { getActiveTeams } from '../focus/focus-team-state.js';
+import { recordStdinMessageSent } from '../completion/stdin-turn-tracker.js';
+import { buildNexusReturnHandOff, listAllPendingReturns } from './pending-returns.js';
+import { createLogger } from '../shell/log.js';
+const dlog = createLogger({ module: 'nexus/return-routing' });
+/** Ids per engage call (the product-api's per-call cap). */
+export const ENGAGE_BATCH_SIZE = 200;
+/** Pure: the engagement a return gets from its requesting focus's state. */
+export function decideReturnEngagement(state) {
+    if (state.hasLiveTeam)
+        return 'handed';
+    if (state.armed)
+        return 'rearmed';
+    return 'leave_pending';
+}
+/** Pure: group returns by requesting focus; a return with no focus has no team to engage. */
+export function groupReturnsByFocus(returns) {
+    const byFocus = new Map();
+    for (const ret of returns) {
+        if (!ret.sourceFocusId)
+            continue;
+        const list = byFocus.get(ret.sourceFocusId);
+        if (list)
+            list.push(ret);
+        else
+            byFocus.set(ret.sourceFocusId, [ret]);
+    }
+    return byFocus;
+}
+/**
+ * The production deps. `apiDeps.callApi` replaces the product-api client for
+ * every API-backed dep (route, list, engage), so an end-to-end test drives this
+ * exact wiring over one shared fake API.
+ */
+export function defaultNexusReturnRoutingDeps(apiDeps = {}) {
+    const call = apiDeps.callApi ?? callApi;
+    return {
+        routeReturns: async (productId) => {
+            const res = await call('product_request_route_returns', { productId });
+            return res.routed ?? 0;
+        },
+        listUnengagedReturns: (productId) => listAllPendingReturns({ productId, unengagedOnly: true }, apiDeps),
+        listFocusArmState: async (productId) => {
+            const focuses = await getActiveFocuses('', productId);
+            return new Map(focuses.map((f) => [f.focus_id, f.status === 'active' && !!f.assigned_agent_role_id]));
+        },
+        getLiveTeamStdin: (focusId) => getActiveTeams().get(focusId)?.leadStdin ?? null,
+        engageReturns: async (focusId, pendingReturnIds, engagement) => {
+            const res = await call('product_request_engage_returns', {
+                focusId,
+                pendingReturnIds,
+                engagement,
+            });
+            return res.engagedIds ?? [];
+        },
+        handToLiveTeam: (focusId, stdin, message) => {
+            const sent = sendMessage(stdin, message);
+            if (sent)
+                recordStdinMessageSent(focusId);
+            return sent;
+        },
+        log: (msg) => dlog.info(msg),
+    };
+}
+/** Stamp ids in batches the engage call accepts; returns every id actually stamped. */
+async function engageInBatches(focusId, ids, engagement, deps) {
+    const stamped = [];
+    for (let i = 0; i < ids.length; i += ENGAGE_BATCH_SIZE) {
+        stamped.push(...(await deps.engageReturns(focusId, ids.slice(i, i + ENGAGE_BATCH_SIZE), engagement)));
+    }
+    return stamped;
+}
+/** Engage one focus's not-yet-engaged returns per its state; a stamp follows proof. */
+async function engageFocusReturns(focusId, returns, armed, deps, log) {
+    const stdin = deps.getLiveTeamStdin(focusId);
+    const decision = decideReturnEngagement({ hasLiveTeam: stdin !== null, armed });
+    if (decision === 'leave_pending')
+        return;
+    const ids = returns.map((r) => r.id);
+    if (decision === 'rearmed') {
+        const engagedIds = await engageInBatches(focusId, ids, 'rearmed', deps);
+        if (engagedIds.length > 0) {
+            log(`[nexus] re-armed focus ${focusId.slice(0, 8)} for ${engagedIds.length} pending return(s)`);
+        }
+        return;
+    }
+    const landed = stdin !== null && deps.handToLiveTeam(focusId, stdin, buildNexusReturnHandOff(returns));
+    if (!landed) {
+        log(`[nexus] live hand-off to focus ${focusId.slice(0, 8)} did not land; ${ids.length} return(s) stay unengaged and are retried next poll`);
+        return;
+    }
+    const engagedIds = await engageInBatches(focusId, ids, 'handed', deps);
+    log(`[nexus] handed ${ids.length} pending return(s) to the live team on focus ${focusId.slice(0, 8)} (${engagedIds.length} stamped)`);
+}
+/**
+ * Poll one product: route its returns, then engage each requesting focus once.
+ * Best-effort throughout: a route failure still engages already-routed returns,
+ * and one focus's failure never aborts the others.
+ */
+export async function routeNexusReturns(config, deps = defaultNexusReturnRoutingDeps()) {
+    const productId = config.productId;
+    if (!productId)
+        return;
+    const log = deps.log ?? ((msg) => dlog.info(msg));
+    try {
+        const routed = await deps.routeReturns(productId);
+        if (routed > 0)
+            log(`[nexus] routed ${routed} new return(s) to requesting focuses for ${productId}`);
+    }
+    catch (err) {
+        log(`[nexus] failed to route returns for ${productId}: ${err.message}`);
+    }
+    let unengaged = [];
+    try {
+        unengaged = await deps.listUnengagedReturns(productId);
+    }
+    catch (err) {
+        log(`[nexus] failed to list unengaged returns for ${productId}: ${err.message}`);
+        return;
+    }
+    const byFocus = groupReturnsByFocus(unengaged);
+    if (byFocus.size === 0)
+        return;
+    let armState = new Map();
+    try {
+        armState = await deps.listFocusArmState(productId);
+    }
+    catch (err) {
+        // Unknown arm state: a live team is still handed its returns; nothing re-arms.
+        log(`[nexus] failed to read focus arm state for ${productId}: ${err.message}`);
+    }
+    for (const [focusId, returns] of byFocus) {
+        try {
+            await engageFocusReturns(focusId, returns, armState.get(focusId) === true, deps, log);
+        }
+        catch (err) {
+            log(`[nexus] failed to engage returns on focus ${focusId.slice(0, 8)}: ${err.message}`);
+        }
+    }
+}
+//# sourceMappingURL=return-routing.js.map

package/dist/nexus/return-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"return-routing.js","sourceRoot":"","sources":["../../src/nexus/return-routing.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,sEAAsE;AACtE,2DAA2D;AAC3D,gBAAgB;AAkDhB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,OAAO,EAAoB,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAsB,MAAM,sBAAsB,CAAC;AAC1G,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,IAAI,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAC;AAE9D,4DAA4D;AAC5D,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAKrC,4EAA4E;AAC5E,MAAM,UAAU,sBAAsB,CAAC,KAA+C;IACpF,IAAI,KAAK,CAAC,WAAW;QAAE,OAAO,QAAQ,CAAC;IACvC,IAAI,KAAK,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAClC,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,mBAAmB,CAAC,OAAiC;IACnE,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IACnD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,aAAa;YAAE,SAAS;QACjC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC5C,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;;YACpB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAkBD;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAAC,UAAuB,EAAE;IACrE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC;IACxC,OAAO;QACL,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;YAChC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAsB,+BAA+B,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;YAC5F,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;QACzB,CAAC;QACD,oBAAoB,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,qBAAqB,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC;QACvG,iBAAiB,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;YACrC,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;YACtD,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QACxG,CAAC;QACD,gBAAgB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,SAAS,IAAI,IAAI;QAC/E,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,EAAE;YAC7D,MAAM,GAAG,GAAG,MAAM,IAAI,CAA4B,gCAAgC,EAAE;gBAClF,OAAO;gBACP,gBAAgB;gBAChB,UAAU;aACX,CAAC,CAAC;YACH,OAAO,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;QAC9B,CAAC;QACD,cAAc,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC1C,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACzC,IAAI,IAAI;gBAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;KAC7B,CAAC;AACJ,CAAC;AAED,uFAAuF;AACvF,KAAK,UAAU,eAAe,CAC5B,OAAe,EACf,GAAa,EACb,UAAgC,EAChC,IAA4B;IAE5B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,iBAAiB,EAAE,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,iBAAiB,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACxG,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,uFAAuF;AACvF,KAAK,UAAU,kBAAkB,CAC/B,OAAe,EACf,OAAwB,EACxB,KAAc,EACd,IAA4B,EAC5B,GAA0B;IAE1B,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,sBAAsB,CAAC,EAAE,WAAW,EAAE,KAAK,KAAK,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAChF,IAAI,QAAQ,KAAK,eAAe;QAAE,OAAO;IACzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACrC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QACxE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,GAAG,CAAC,0BAA0B,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,UAAU,CAAC,MAAM,oBAAoB,CAAC,CAAC;QAClG,CAAC;QACD,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC;IACvG,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,GAAG,CAAC,kCAAkC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,kBAAkB,GAAG,CAAC,MAAM,qDAAqD,CAAC,CAAC;QAC5I,OAAO;IACT,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACvE,GAAG,CAAC,kBAAkB,GAAG,CAAC,MAAM,gDAAgD,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC,MAAM,WAAW,CAAC,CAAC;AACxI,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAoB,EACpB,OAA+B,6BAA6B,EAAE;IAE9D,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACnC,IAAI,CAAC,SAAS;QAAE,OAAO;IACvB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAE1D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,kBAAkB,MAAM,4CAA4C,SAAS,EAAE,CAAC,CAAC;IACvG,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,uCAAuC,SAAS,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,IAAI,SAAS,GAAoB,EAAE,CAAC;IACpC,IAAI,CAAC;QACH,SAAS,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,gDAAgD,SAAS,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5F,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC/C,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO;IAE/B,IAAI,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC1C,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,+EAA+E;QAC/E,GAAG,CAAC,8CAA8C,SAAS,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,OAAO,EAAE,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QACxF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,6CAA6C,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;AACH,CAAC"}