@animalabs/agent-framework 0.12.0 → 0.14.0

package/dist/src/tune-out/coordinator.js

@@ -0,0 +1,444 @@
+/**
+ * TuneOutCoordinator (issue #77) — the host-side machinery between a
+ * tuned-out channel and the subconscious resident.
+ *
+ * Responsibilities: classify diverted traffic (stamp everything, wake on
+ * addressed), acknowledge suppressed mentions deterministically, run the
+ * per-channel summary cadence, count wakes durably with max-wakes
+ * auto-cancel, and deliver the cancel dump.
+ *
+ * Voice doctrine ("no words in models' mouths"): everything the resident
+ * reads from the subconscious is the subconscious's verbatim text under its
+ * own participant name. Host-authored framing is system-styled and never
+ * voiced: `<tuned-out-backlog …>` wraps raw diverted messages (the
+ * <backscroll> precedent), and `[Tune-out: …]` bracket notices carry
+ * lifecycle facts (the [Gate: …] precedent).
+ */
+import { randomUUID } from 'node:crypto';
+import { CapabilityGrant } from '../mcpl/capability-grant.js';
+/** Defaults for tune_out tool params. */
+export const TUNE_OUT_DEFAULTS = {
+    cadenceSeconds: 1800,
+    backlogCap: 200,
+    maxWakes: 5,
+};
+/** Coalescing window for wake invocations: a mention storm becomes one
+ *  subconscious turn, and max-wakes counts invocations, not messages. */
+const WAKE_COALESCE_MS = 2_000;
+export class TuneOutCoordinator {
+    channelRegistry;
+    serverRegistry;
+    hooks;
+    cadenceTimers = new Map();
+    /** Duration-expiry timers (params.expiresAtMs); cleared on any cancel. */
+    expiryTimers = new Map();
+    /** Channels with a wake invocation pending inside the coalescing window. */
+    pendingWakes = new Map();
+    /** Diverted-message tallies since the last subconscious invocation, per channel key. */
+    divertedSinceInvocation = new Map();
+    constructor(channelRegistry, serverRegistry, hooks) {
+        this.channelRegistry = channelRegistry;
+        this.serverRegistry = serverRegistry;
+        this.hooks = hooks;
+    }
+    key(serverId, channelId) {
+        return `${serverId}\0${channelId}`;
+    }
+    /** Restart cadence + expiry timers and re-anchor after a process restart. */
+    resumeActiveEpochs() {
+        let oldestAnchor = null;
+        for (const { serverId, channelId, params } of this.listActive()) {
+            // An epoch whose deadline passed while the process was down cancels
+            // immediately — the resident gets their backlog on the schedule they
+            // committed to, not whenever the host happened to restart.
+            if (params.expiresAtMs !== undefined && params.expiresAtMs <= Date.now()) {
+                this.cancel(serverId, channelId, 'duration', 'duration elapsed');
+                continue;
+            }
+            this.startCadence(serverId, channelId, params.cadenceSeconds);
+            this.armExpiry(serverId, channelId, params);
+            if (oldestAnchor === null || params.startedAtSequence < oldestAnchor) {
+                oldestAnchor = params.startedAtSequence;
+            }
+        }
+        if (oldestAnchor !== null) {
+            this.hooks.setSubconsciousAnchor(oldestAnchor);
+        }
+    }
+    armExpiry(serverId, channelId, params) {
+        if (params.expiresAtMs === undefined)
+            return;
+        const key = this.key(serverId, channelId);
+        const existing = this.expiryTimers.get(key);
+        if (existing)
+            clearTimeout(existing);
+        const remaining = Math.max(0, params.expiresAtMs - Date.now());
+        this.expiryTimers.set(key, setTimeout(() => {
+            this.expiryTimers.delete(key);
+            this.cancel(serverId, channelId, 'duration', 'duration elapsed');
+        }, remaining));
+    }
+    listActive() {
+        const active = [];
+        for (const entry of this.channelRegistry.listChannelsRaw()) {
+            const state = this.channelRegistry.getTuneOutState(entry.serverId, entry.descriptor.id);
+            if (state) {
+                active.push({ serverId: entry.serverId, channelId: entry.descriptor.id, params: state.params });
+            }
+        }
+        return active;
+    }
+    // ==========================================================================
+    // Enter / cancel
+    // ==========================================================================
+    enter(serverId, channelId, opts, source) {
+        if (!this.hooks.subconsciousName()) {
+            return { ok: false, error: 'tune-out requires the subconscious resident (framework config `subconscious`)' };
+        }
+        if (this.hooks.isForkBound(channelId)) {
+            return { ok: false, error: `channel ${channelId} is bound to a conversation fork; tune-out and fork routing are mutually exclusive` };
+        }
+        if (this.channelRegistry.getTuneOutState(serverId, channelId)) {
+            return { ok: false, error: `channel ${channelId} is already tuned out (cancel first to change params)` };
+        }
+        const params = {
+            epochId: randomUUID(),
+            cadenceSeconds: Math.max(30, opts.cadenceSeconds ?? TUNE_OUT_DEFAULTS.cadenceSeconds),
+            backlogCap: Math.max(0, opts.backlogCap ?? TUNE_OUT_DEFAULTS.backlogCap),
+            maxWakes: Math.max(1, opts.maxWakes ?? TUNE_OUT_DEFAULTS.maxWakes),
+            startedAtSequence: this.hooks.currentSequence(),
+            ...(opts.durationSeconds !== undefined
+                ? { expiresAtMs: Date.now() + Math.max(60, opts.durationSeconds) * 1000 }
+                : {}),
+        };
+        this.channelRegistry.enterTuneOut(serverId, channelId, params, source);
+        this.armExpiry(serverId, channelId, params);
+        // Window anchor: start of the OLDEST active tune-out. Never move the
+        // anchor forward here — an older active epoch owns it.
+        const oldest = this.listActive().reduce((min, e) => Math.min(min, e.params.startedAtSequence), params.startedAtSequence);
+        this.hooks.setSubconsciousAnchor(oldest);
+        this.divertedSinceInvocation.set(this.key(serverId, channelId), 0);
+        this.startCadence(serverId, channelId, params.cadenceSeconds);
+        this.hooks.emitTrace({ type: 'tune-out:entered', serverId, channelId, epochId: params.epochId });
+        return { ok: true, params };
+    }
+    /**
+     * End a tune-out: durable flip, system-framed backlog dump into the
+     * resident's window (capped), lifecycle notice, one wake for the
+     * resident. `subconsciousNote` is the subconscious's own text (from its
+     * cancel_tuneout call) — delivered verbatim under its name, never
+     * synthesized here.
+     */
+    cancel(serverId, channelId, source, reason, subconsciousNote) {
+        const ended = this.channelRegistry.cancelTuneOut(serverId, channelId, 'open', source);
+        if (!ended) {
+            return { ok: false, error: `channel ${channelId} is not tuned out` };
+        }
+        this.stopCadence(serverId, channelId);
+        const expiry = this.expiryTimers.get(this.key(serverId, channelId));
+        if (expiry) {
+            clearTimeout(expiry);
+            this.expiryTimers.delete(this.key(serverId, channelId));
+        }
+        const pending = this.pendingWakes.get(this.key(serverId, channelId));
+        if (pending) {
+            clearTimeout(pending.timer);
+            this.pendingWakes.delete(this.key(serverId, channelId));
+        }
+        this.divertedSinceInvocation.delete(this.key(serverId, channelId));
+        // Backlog: every message stamped with this epoch, oldest first.
+        const epochId = ended.params.epochId;
+        const backlog = this.hooks.getStoredMessages().filter((m) => m.metadata?.tuneOut?.epochId === epochId);
+        const cap = ended.params.backlogCap;
+        const shown = cap > 0 ? backlog.slice(-cap) : [];
+        const truncated = backlog.length - shown.length;
+        const lines = shown.map((m) => {
+            const author = m.metadata?.author?.name ?? m.participant;
+            const text = m.content
+                .filter((b) => b.type === 'text')
+                .map((b) => b.text)
+                .join('\n');
+            return `${author}: ${text}`;
+        });
+        const attrs = [
+            `channel="${channelId}"`,
+            `messages=${backlog.length}`,
+            ...(truncated > 0 ? [`truncated=${truncated} (oldest; fetch_history covers the rest)`] : []),
+        ];
+        const dump = `<tuned-out-backlog ${attrs.join(' ')}>\n${lines.join('\n')}\n</tuned-out-backlog>`;
+        // Host-framed system artifacts — never voiced as anyone.
+        this.hooks.addMessage('user', [{ type: 'text', text: `[Tune-out: ${channelId} cancelled — ${reason}, ${ended.wakeCount} wake${ended.wakeCount === 1 ? '' : 's'}]\n\n${dump}` }], { system: true, kind: 'tune-out-cancel', channelId, epochId });
+        // The subconscious's own words, under its own name, verbatim.
+        const subName = this.hooks.subconsciousName();
+        if (subconsciousNote && subName) {
+            this.hooks.addMessage(subName, [{ type: 'text', text: subconsciousNote }], { kind: 'subconscious-note', channelId, epochId });
+        }
+        const primary = this.hooks.primaryName();
+        if (primary) {
+            this.hooks.requestInference(primary, `tune-out cancelled (${reason})`, 'tune-out');
+        }
+        // The subconscious gets one cancel turn of its own (unless it initiated
+        // the cancel — its note already carries its words): the issue's cancel
+        // shape is dump + a report from the subconscious, and when the cap
+        // truncated the raw dump, its summary is what covers the tail.
+        if (source !== 'subconscious' && subName) {
+            const truncNote = truncated > 0
+                ? ` ${truncated} of ${backlog.length} diverted messages were above the cap and not delivered raw.`
+                : '';
+            this.hooks.addMessage('user', [{ type: 'text', text: `[Tune-out cancelled: ${channelId} — ${reason}.${truncNote}]` }], { system: true, kind: 'tune-out-cancel-report', channelId }, subName);
+            this.hooks.requestInference(subName, `tune-out cancelled: ${channelId}`, 'tune-out');
+        }
+        this.hooks.emitTrace({ type: 'tune-out:cancelled', serverId, channelId, epochId, reason, wakeCount: ended.wakeCount });
+        return { ok: true };
+    }
+    // ==========================================================================
+    // Ingestion: divert, stamp, classify
+    // ==========================================================================
+    /**
+     * Consulted by the framework for every incoming channel message BEFORE
+     * storage. Null = channel not tuned out (proceed normally). Otherwise the
+     * caller stamps `metadata.tuneOut = { epochId }`, stores the message
+     * without waking the residents, and this coordinator has already handled
+     * wake bookkeeping (coalesced subconscious invocation, durable count,
+     * suppression ack, possible auto-cancel).
+     */
+    onIncoming(serverId, channelId, messageId, tags, authorId, gatePass = true) {
+        const state = this.channelRegistry.getTuneOutState(serverId, channelId);
+        if (!state)
+            return null;
+        const key = this.key(serverId, channelId);
+        this.divertedSinceInvocation.set(key, (this.divertedSinceInvocation.get(key) ?? 0) + 1);
+        // Wake classification: the resident's wake gate composes as a
+        // PRECONDITION (antra, #tuneout-talk: the subconscious is affected BY
+        // main's wake gate, it does not replace it) — an event the gate would
+        // suppress for the resident (muted author, rate-limit) must not wake
+        // the subconscious either; it diverts silently into the backlog and
+        // surfaces in cadence summaries. On top of the gate: addressed
+        // mentions and gate-privileged authors wake, per the issue.
+        const addressed = Array.isArray(tags) && tags.includes('chat:addressed');
+        const privileged = this.hooks.isPrivilegedAuthor(authorId);
+        if (gatePass && addressed) {
+            // The mention-er always gets a deterministic signal, independent of
+            // what the subconscious later decides (grant-gated; decline
+            // precedent). Gate-suppressed mentions get NO reaction: main would
+            // not have signaled either, and reacting would leak the resident's
+            // standing mute to its subject.
+            void this.acknowledgeSuppressed(serverId, channelId, messageId);
+        }
+        if (gatePass && (addressed || privileged)) {
+            this.scheduleWakeInvocation(serverId, channelId);
+        }
+        return { epochId: state.params.epochId };
+    }
+    async acknowledgeSuppressed(serverId, channelId, messageId) {
+        try {
+            const server = this.serverRegistry.getServer(serverId);
+            if (!server || !CapabilityGrant.of(server).has('channels.acknowledge'))
+                return;
+            await server.sendChannelsAcknowledge({
+                channelId,
+                messageId,
+                intent: 'suppressed-tuned-out',
+            });
+        }
+        catch (err) {
+            this.hooks.emitTrace({
+                type: 'tune-out:ack-failed',
+                serverId,
+                channelId,
+                error: err.message,
+            });
+        }
+    }
+    // ==========================================================================
+    // Subconscious invocation (cadence + coalesced wakes)
+    // ==========================================================================
+    startCadence(serverId, channelId, cadenceSeconds) {
+        this.stopCadence(serverId, channelId);
+        const key = this.key(serverId, channelId);
+        const tick = () => {
+            const state = this.channelRegistry.getTuneOutState(serverId, channelId);
+            if (!state)
+                return; // cancelled meanwhile
+            const diverted = this.divertedSinceInvocation.get(key) ?? 0;
+            // An empty period needs no turn at all — skip silently.
+            if (diverted > 0) {
+                this.invokeSubconscious(serverId, channelId, 'cadence', diverted);
+            }
+            this.cadenceTimers.set(key, setTimeout(tick, cadenceSeconds * 1000));
+        };
+        this.cadenceTimers.set(key, setTimeout(tick, cadenceSeconds * 1000));
+    }
+    stopCadence(serverId, channelId) {
+        const key = this.key(serverId, channelId);
+        const timer = this.cadenceTimers.get(key);
+        if (timer)
+            clearTimeout(timer);
+        this.cadenceTimers.delete(key);
+    }
+    scheduleWakeInvocation(serverId, channelId) {
+        const key = this.key(serverId, channelId);
+        const pending = this.pendingWakes.get(key);
+        if (pending) {
+            pending.count++;
+            return;
+        }
+        const timer = setTimeout(() => {
+            const entry = this.pendingWakes.get(key);
+            this.pendingWakes.delete(key);
+            // Count ONE durable wake per coalesced invocation.
+            const counted = this.channelRegistry.recordTuneOutWake(serverId, channelId);
+            if (!counted)
+                return; // cancelled inside the window
+            if (counted.wakeCount > counted.params.maxWakes) {
+                this.cancel(serverId, channelId, 'tune-out-max-wakes', `wake budget exhausted (${counted.params.maxWakes})`);
+                return;
+            }
+            this.invokeSubconscious(serverId, channelId, 'wake', entry?.count ?? 1);
+        }, WAKE_COALESCE_MS);
+        this.pendingWakes.set(key, { count: 1, timer });
+    }
+    /**
+     * One subconscious turn: a system-framed trigger notice (bracket style —
+     * what happened, never what to say) plus standing dispositions, then an
+     * inference request. The merged view supplies the actual traffic.
+     */
+    invokeSubconscious(serverId, channelId, trigger, count) {
+        const subName = this.hooks.subconsciousName();
+        if (!subName)
+            return;
+        const key = this.key(serverId, channelId);
+        this.divertedSinceInvocation.set(key, 0);
+        const notice = trigger === 'wake'
+            ? `[Tune-out wake: ${channelId} — ${count} addressed message${count === 1 ? '' : 's'}]`
+            : `[Tune-out cadence: ${channelId} — ${count} diverted message${count === 1 ? '' : 's'} since your last look]`;
+        this.hooks.addMessage('user', [{ type: 'text', text: notice }], { system: true, kind: `tune-out-${trigger}`, channelId }, subName);
+        this.hooks.requestInference(subName, `tune-out ${trigger}: ${channelId}`, 'tune-out');
+    }
+    // ==========================================================================
+    // Dispositions (standing notes, snapshot slot)
+    // ==========================================================================
+    dispositionsCache = null;
+    get dispositionsStateId() {
+        return `subconscious/${this.hooks.primaryName() ?? 'default'}/dispositions`;
+    }
+    /**
+     * The dispositions as a fixed system-position ContextInjection for the
+     * subconscious's compiles (antra: deliver changes, never let them wash
+     * away — it has no long-term memory, so they must not live in window
+     * content). Bytes change only when a disposition changes: KV-friendly.
+     */
+    getDispositionsInjection() {
+        const dispositions = this.readDispositions();
+        const entries = Object.entries(dispositions);
+        if (entries.length === 0)
+            return null;
+        return {
+            namespace: 'dispositions',
+            position: 'system',
+            content: [{
+                    type: 'text',
+                    text: `[Standing dispositions]\n${entries.map(([k, v]) => `- ${k}: ${v}`).join('\n')}`,
+                }],
+        };
+    }
+    readDispositions() {
+        if (this.dispositionsCache)
+            return this.dispositionsCache;
+        try {
+            const raw = this.channelRegistry.readCoordinatorState(this.dispositionsStateId);
+            this.dispositionsCache = (raw && typeof raw === 'object') ? raw : {};
+        }
+        catch {
+            this.dispositionsCache = {};
+        }
+        return this.dispositionsCache;
+    }
+    noteDisposition(key, text) {
+        const dispositions = { ...this.readDispositions() };
+        if (text === '') {
+            delete dispositions[key];
+        }
+        else {
+            dispositions[key] = text;
+        }
+        this.dispositionsCache = dispositions;
+        this.channelRegistry.writeCoordinatorState(this.dispositionsStateId, dispositions);
+    }
+    // ==========================================================================
+    // Subconscious tool dispatch
+    // ==========================================================================
+    async handleSubconsciousTool(name, input) {
+        switch (name) {
+            case 'deliver_summary': {
+                const text = String(input.text ?? '').trim();
+                const channelId = String(input.channelId ?? '');
+                if (!text)
+                    return { success: false, error: 'empty summary', isError: false };
+                const subName = this.hooks.subconsciousName();
+                if (!subName)
+                    return { success: false, error: 'subconscious not configured', isError: true };
+                // Verbatim, under its own participant name, into the resident's window.
+                this.hooks.addMessage(subName, [{ type: 'text', text }], {
+                    kind: 'subconscious-summary',
+                    channelId,
+                });
+                return { success: true, data: { delivered: true } };
+            }
+            case 'cancel_tuneout': {
+                const channelId = String(input.channelId ?? '');
+                const located = this.findByChannel(channelId);
+                if (!located)
+                    return { success: false, error: `channel ${channelId} is not tuned out`, isError: false };
+                const note = typeof input.text === 'string' && input.text.trim() ? input.text.trim() : undefined;
+                const result = this.cancel(located.serverId, channelId, 'subconscious', 'subconscious judgment', note);
+                return result.ok
+                    ? { success: true, data: { cancelled: true } }
+                    : { success: false, error: result.error, isError: false };
+            }
+            case 'note_disposition': {
+                const key = String(input.key ?? '').trim();
+                if (!key)
+                    return { success: false, error: 'key required', isError: false };
+                this.noteDisposition(key, String(input.text ?? ''));
+                return { success: true, data: { noted: key } };
+            }
+            case 'speak_in_channel': {
+                if (!this.hooks.allowChannelSpeech()) {
+                    return {
+                        success: false,
+                        isError: false,
+                        error: 'channel speech is disabled for the subconscious (recipe: subconscious.allowChannelSpeech)',
+                    };
+                }
+                const channelId = String(input.channelId ?? '');
+                const text = String(input.text ?? '').trim();
+                if (!text)
+                    return { success: false, error: 'empty message', isError: false };
+                return this.channelRegistry.publishForAgent(channelId, text, this.hooks.subconsciousName() ?? 'Subconscious');
+            }
+            default:
+                return { success: false, error: `unknown subconscious tool: ${name}`, isError: true };
+        }
+    }
+    findByChannel(channelId) {
+        for (const entry of this.listActive()) {
+            if (entry.channelId === channelId)
+                return { serverId: entry.serverId };
+        }
+        return null;
+    }
+    /** Stop all timers (framework shutdown). */
+    stop() {
+        for (const timer of this.cadenceTimers.values())
+            clearTimeout(timer);
+        this.cadenceTimers.clear();
+        for (const timer of this.expiryTimers.values())
+            clearTimeout(timer);
+        this.expiryTimers.clear();
+        for (const { timer } of this.pendingWakes.values())
+            clearTimeout(timer);
+        this.pendingWakes.clear();
+    }
+}
+//# sourceMappingURL=coordinator.js.map

package/dist/src/tune-out/coordinator.js.map

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

package/dist/src/tune-out/tools.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The subconscious's tool surface (issue #77).
+ *
+ * Deliberately small and channel-scoped: the subconscious observes the
+ * merged timeline, judges wakes, and reports — it is not a general agent.
+ * Names and results carry no credential/config vocabulary; everything it
+ * says to the resident is its own text (never host-templated), delivered
+ * under its own participant name. Prose is never auto-routed
+ * (proseRouting: 'explicit' on its AgentConfig): speaking into a channel
+ * happens only through speak_in_channel, so a timer-triggered turn can
+ * never leak bare prose to the default locus.
+ */
+import type { ToolDefinition } from '../types/index.js';
+export declare const SUBCONSCIOUS_TOOL_NAMES: readonly ["deliver_summary", "cancel_tuneout", "note_disposition", "speak_in_channel"];
+export type SubconsciousToolName = (typeof SUBCONSCIOUS_TOOL_NAMES)[number];
+export declare const SUBCONSCIOUS_TOOLS: ToolDefinition[];
+/**
+ * Configuration for the subconscious resident (FrameworkConfig.subconscious).
+ */
+export interface SubconsciousConfig {
+    /** Master switch. */
+    enabled: boolean;
+    /**
+     * Registry + participant name. Default 'Subconscious' — following the
+     * Context Manager precedent: a title-case functional voice, not an
+     * agent-prefixed identifier.
+     */
+    name?: string;
+    /** Model id; defaults to the primary agent's (same-model side-process). */
+    model?: string;
+    /**
+     * The voice/criteria mode block — recipe-side and co-authored with the
+     * resident (it is an aspect of their attention). Report-shaped, second
+     * person toward the resident. Canary before fleet use (issue #77).
+     */
+    systemPrompt: string;
+    /** Allow speak_in_channel. Default false until the voice block has
+     *  passed its canary round. */
+    allowChannelSpeech?: boolean;
+    /** WindowedPassthroughStrategy re-anchor fraction (default 0.5). */
+    reAnchorFraction?: number;
+}
+//# sourceMappingURL=tools.d.ts.map

package/dist/src/tune-out/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tune-out/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,eAAO,MAAM,uBAAuB,wFAK1B,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,eAAO,MAAM,kBAAkB,EAAE,cAAc,EA6E9C,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;mCAC+B;IAC/B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/dist/src/tune-out/tools.js

@@ -0,0 +1,93 @@
+/**
+ * The subconscious's tool surface (issue #77).
+ *
+ * Deliberately small and channel-scoped: the subconscious observes the
+ * merged timeline, judges wakes, and reports — it is not a general agent.
+ * Names and results carry no credential/config vocabulary; everything it
+ * says to the resident is its own text (never host-templated), delivered
+ * under its own participant name. Prose is never auto-routed
+ * (proseRouting: 'explicit' on its AgentConfig): speaking into a channel
+ * happens only through speak_in_channel, so a timer-triggered turn can
+ * never leak bare prose to the default locus.
+ */
+export const SUBCONSCIOUS_TOOL_NAMES = [
+    'deliver_summary',
+    'cancel_tuneout',
+    'note_disposition',
+    'speak_in_channel',
+];
+export const SUBCONSCIOUS_TOOLS = [
+    {
+        name: 'deliver_summary',
+        description: 'Deliver a summary into the resident\'s context, in your own voice, ' +
+            'addressed to them (second person). Use at cadence when the diverted ' +
+            'traffic merits it; staying silent is always allowed — an empty ' +
+            'period needs no report.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                text: {
+                    type: 'string',
+                    description: 'The summary, verbatim as the resident will read it.',
+                },
+                channelId: {
+                    type: 'string',
+                    description: 'The tuned-out channel this summary covers.',
+                },
+            },
+            required: ['text', 'channelId'],
+        },
+    },
+    {
+        name: 'cancel_tuneout',
+        description: 'End the tune-out on a channel now — use when something needs the ' +
+            'resident\'s full attention. The diverted backlog is delivered to ' +
+            'them (capped), and normal attention resumes. Add your own note in ' +
+            '`text`; it arrives alongside the backlog, in your voice.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                channelId: { type: 'string' },
+                text: {
+                    type: 'string',
+                    description: 'Your accompanying note to the resident (optional).',
+                },
+            },
+            required: ['channelId'],
+        },
+    },
+    {
+        name: 'note_disposition',
+        description: 'Record a standing disposition for yourself — a durable note that ' +
+            'shapes how you treat future traffic ("antra\'s pings always ' +
+            'escalate", "ignore release-bot"). Replaces any previous note under ' +
+            'the same key.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                key: { type: 'string', description: 'Short stable identifier.' },
+                text: {
+                    type: 'string',
+                    description: 'The disposition. Empty string deletes the key.',
+                },
+            },
+            required: ['key', 'text'],
+        },
+    },
+    {
+        name: 'speak_in_channel',
+        description: 'Post a message into a tuned-out channel, clearly as yourself (not ' +
+            'as the resident). Use sparingly — e.g. to tell someone the resident ' +
+            'is tuned out and when to expect them. Disabled unless the resident\'s ' +
+            'configuration allows it.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                channelId: { type: 'string' },
+                text: { type: 'string' },
+            },
+            required: ['channelId', 'text'],
+        },
+    },
+];
+//# sourceMappingURL=tools.js.map

package/dist/src/tune-out/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/tune-out/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,iBAAiB;IACjB,gBAAgB;IAChB,kBAAkB;IAClB,kBAAkB;CACV,CAAC;AAIX,MAAM,CAAC,MAAM,kBAAkB,GAAqB;IAClD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,qEAAqE;YACrE,sEAAsE;YACtE,iEAAiE;YACjE,yBAAyB;QAC3B,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qDAAqD;iBACnE;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4CAA4C;iBAC1D;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC;SAChC;KACF;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,mEAAmE;YACnE,mEAAmE;YACnE,oEAAoE;YACpE,0DAA0D;QAC5D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC7B,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oDAAoD;iBAClE;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,CAAC;SACxB;KACF;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,mEAAmE;YACnE,8DAA8D;YAC9D,qEAAqE;YACrE,eAAe;QACjB,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;gBAChE,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gDAAgD;iBAC9D;aACF;YACD,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;SAC1B;KACF;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,oEAAoE;YACpE,sEAAsE;YACtE,wEAAwE;YACxE,0BAA0B;QAC5B,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC7B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aACzB;YACD,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;SAChC;KACF;CACF,CAAC"}

package/dist/src/types/agent.d.ts

@@ -164,6 +164,13 @@ export interface AgentConfig {
      *   send externally; prose remains in Chronicle with a private suppression receipt.
      */
     proseRouting?: 'locus' | 'explicit' | 'hybrid' | 'disabled';
+    /**
+     * Fail-closed containment for a text response whose entire visible prose is
+     * an invocation-shaped wrapper naming a tool registered on that exact turn.
+     * The wrapper is neither executed nor stored as assistant continuity; a
+     * content-free system receipt is stored instead. Default false.
+     */
+    toolWrapperProseGuard?: boolean;
 }
 /** The intentionally small set of agent settings that may change in-process. */
 export interface AgentRuntimeSettingsPatch {
@@ -302,5 +309,15 @@ export interface InferenceRequest {
      * so a household ledger can say who woke whom; carries no content.
      */
     counterparty?: string;
+    /**
+     * Where the wake came from, for telemetry ONLY — never a speech locus.
+     * Set by the EventGate for batched wakes (composite channel id of the
+     * chosen event when the event carried one; push-event raw ids are not
+     * used). Routing keeps reading `channelId`, which only the direct channel
+     * paths set from normalized ids — a gate wake leaves it unset, as before.
+     */
+    wakeChannelId?: string;
+    /** Timestamp of the event the wake provenance was taken from (ms). */
+    wakeAt?: number;
 }
 //# sourceMappingURL=agent.d.ts.map