@moxxy/channel-kit 0.27.0

package/dist/turn.js

@@ -0,0 +1,106 @@
+/**
+ * Subscribe to ONLY the given turn's events. Returns the unsubscribe function.
+ * The caller controls unsubscribe placement (channels keep their final flush
+ * inside the subscription window so trailing events still feed the renderer).
+ */
+export function subscribeTurn(source, turnId, onEvent) {
+    return source.log.subscribe((event) => {
+        if (event.turnId !== turnId)
+            return;
+        onEvent(event);
+    });
+}
+/**
+ * Run one turn to completion, draining the `runTurn` iterator. Rendering is
+ * expected to happen via a {@link subscribeTurn} subscription, not the yielded
+ * events (which are identical); errors propagate to the caller.
+ */
+export async function driveTurn(session, opts) {
+    for await (const _event of session.runTurn(opts.prompt, {
+        turnId: opts.turnId,
+        ...(opts.model ? { model: opts.model } : {}),
+        signal: opts.signal,
+    })) {
+        void _event;
+    }
+}
+/**
+ * Single-flight turn state for a channel: one turn at a time, a per-turn
+ * AbortController, and a bounded set of turnIds THIS channel initiated.
+ *
+ * The own-turn-id set is what {@link mirrorText} filters on (invariant #8)
+ * rather than the coarse `busy` flag alone — so an `assistant_message`
+ * dispatched for our own turn AFTER `busy` flips false (async event ordering /
+ * RemoteSession replay) isn't re-mirrored as foreign.
+ */
+export class TurnCoordinator {
+    busyFlag = false;
+    active = null;
+    ownTurnIds = new Set();
+    maxOwnTurnIds;
+    constructor(opts = {}) {
+        this.maxOwnTurnIds = opts.maxOwnTurnIds ?? 64;
+    }
+    get busy() {
+        return this.busyFlag;
+    }
+    /** The in-flight turn's controller (null when idle) — for /cancel handlers. */
+    get controller() {
+        return this.active;
+    }
+    /**
+     * Atomically claim the single turn slot. Synchronous on purpose: set `busy`
+     * BEFORE any await so a concurrently dispatched second turn can't slip past
+     * the guard. Returns null when a turn is already running (the channel replies
+     * "still working"); otherwise a lease whose `end()` releases the slot.
+     */
+    begin(turnId) {
+        if (this.busyFlag)
+            return null;
+        this.busyFlag = true;
+        const controller = new AbortController();
+        this.active = controller;
+        this.ownTurnIds.add(turnId);
+        if (this.ownTurnIds.size > this.maxOwnTurnIds) {
+            const oldest = this.ownTurnIds.values().next().value;
+            if (oldest !== undefined)
+                this.ownTurnIds.delete(oldest);
+        }
+        return {
+            turnId,
+            controller,
+            end: () => {
+                this.busyFlag = false;
+                if (this.active === controller)
+                    this.active = null;
+            },
+        };
+    }
+    /** Abort the in-flight turn (stop / cancel paths). No-op when idle. */
+    abort(reason) {
+        if (this.active && !this.active.signal.aborted)
+            this.active.abort(reason);
+    }
+    isOwn(turnId) {
+        return this.ownTurnIds.has(turnId);
+    }
+    /**
+     * Foreign-turn mirror gate: returns the assistant prose to mirror for a turn
+     * this channel did NOT initiate (e.g. a co-attached surface ran one), or null
+     * when the event must not be mirrored — not an `assistant_message`, one of
+     * our own turnIds (invariant #8), a turn of ours currently rendering via the
+     * frame pump (`busy`), or empty content. The channel adds its own
+     * "have I served a target yet" check and does the send.
+     */
+    mirrorText(event) {
+        if (event.type !== 'assistant_message')
+            return null;
+        if (this.ownTurnIds.has(event.turnId))
+            return null;
+        if (this.busyFlag)
+            return null;
+        const text = event.content.trim();
+        return text ? text : null;
+    }
+}
+//# sourceMappingURL=turn.js.map

package/dist/turn.js.map

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

package/dist/voice-reply.d.ts

@@ -0,0 +1,139 @@
+import { spawn } from 'node:child_process';
+import type { SynthesizeOptions, Synthesizer } from '@moxxy/sdk';
+/**
+ * Voice-reply machinery shared by messaging channels that can speak the final
+ * assistant reply through the session's active {@link Synthesizer}
+ * (text-to-speech). Everything here is transport-agnostic — turning text into
+ * audio, cleaning markdown for speech, transcoding to OGG/Opus, and picking a
+ * filename. The messenger-specific delivery (grammy `sendVoice`, a discord.js
+ * `AttachmentBuilder`) stays in each channel plugin behind the
+ * {@link VoiceReplySink}.
+ *
+ * The load-bearing guarantee is that NOTHING here throws into the turn path: a
+ * missing synthesizer, a TTS failure, a missing ffmpeg, or a transport error
+ * all resolve to a typed result. Callers send the text reply first and treat a
+ * voice reply as best-effort, so a synth/transcode/delivery failure never
+ * breaks the (already-sent) text answer.
+ */
+/** The slice of a session the voice-reply path needs: the synthesizer view. */
+export interface SynthesizerSource {
+    readonly synthesizers: {
+        tryGetActive(): Synthesizer | null;
+    };
+}
+/**
+ * Strip markdown down to what should be *spoken*. Code fences become a short
+ * "(code omitted)" placeholder (reading a diff aloud is noise), links keep only
+ * their label, and the inline emphasis/heading/quote/bullet marks are removed
+ * so a TTS engine doesn't voice the punctuation. Whitespace is collapsed.
+ */
+export declare function toSpeech(markdown: string): string;
+export interface SynthesizeReplyOptions extends SynthesizeOptions {
+    /** Max characters of speech text handed to the backend. Default 1200. */
+    readonly maxChars?: number;
+}
+export type SynthesizeReplyResult = {
+    readonly ok: true;
+    readonly audio: Uint8Array;
+    readonly mimeType: string;
+} | {
+    readonly ok: false;
+    readonly reason: 'no-synthesizer' | 'empty' | 'failed';
+    readonly error?: string;
+};
+/**
+ * Synthesize a reply through the session's active synthesizer. Cleans markdown
+ * for speech ({@link toSpeech}), truncates sensibly, and NEVER throws — every
+ * failure mode is a typed `ok:false` result so the turn path stays intact.
+ */
+export declare function synthesizeReply(session: SynthesizerSource, text: string, opts?: SynthesizeReplyOptions): Promise<SynthesizeReplyResult>;
+/** Map an audio mime type to a sensible file extension (for the attachment name
+ *  a messenger uses to sniff the format). Falls back to `audio` when unknown. */
+export declare function audioExtForMime(mimeType: string): string;
+export interface EnsureOggOpusOptions {
+    /** Injectable `spawn` for tests. When set, the ffmpeg presence probe is NOT
+     *  process-cached (so each test drives a deterministic outcome). */
+    readonly spawnImpl?: typeof spawn;
+}
+export interface EnsureOggOpusResult {
+    readonly audio: Uint8Array;
+    readonly mimeType: string;
+    /** True when ffmpeg ran to produce these bytes. */
+    readonly transcoded: boolean;
+    /** True when `audio` is OGG/Opus (safe to send as a native voice note); false
+     *  when we returned the ORIGINAL bytes because ffmpeg was unavailable — the
+     *  caller should then send plain audio instead of a voice note. */
+    readonly isOpus: boolean;
+}
+/**
+ * Ensure audio is OGG/Opus for a native voice note. Passthrough when it already
+ * is; otherwise transcode via ffmpeg (stdin→stdout). Gated on an ffmpeg
+ * presence probe (mirrors `checkVoiceCaptureAvailable`, cached per process). On
+ * no-ffmpeg — or any transcode failure — returns the ORIGINAL bytes with
+ * `isOpus:false` so the caller falls back to a plain audio message. Never throws.
+ */
+export declare function ensureOggOpus(audio: Uint8Array, mimeType: string, opts?: EnsureOggOpusOptions): Promise<EnsureOggOpusResult>;
+/** Reset the cached ffmpeg probe (tests only). */
+export declare function __resetFfmpegProbeForTest(): void;
+/** The transport boundary: a channel implements this to actually deliver the
+ *  synthesized audio (grammy `sendVoice`/`sendAudio`, discord.js attachment). */
+export interface VoiceReplySink {
+    send(audio: Uint8Array, meta: {
+        readonly mimeType: string;
+        /** Suggested attachment filename, e.g. `reply.ogg` / `reply.mp3`. */
+        readonly filename: string;
+        /** True when the bytes are OGG/Opus (send as a native voice note); false
+         *  when they are plain audio (no ffmpeg to transcode). */
+        readonly isVoiceNote: boolean;
+    }): Promise<void>;
+}
+export type VoiceReplyOutcome = {
+    readonly status: 'sent';
+    readonly transcoded: boolean;
+    readonly isVoiceNote: boolean;
+} | {
+    readonly status: 'skipped';
+    readonly reason: 'no-synthesizer' | 'empty';
+} | {
+    readonly status: 'failed';
+    readonly reason: 'synth' | 'delivery';
+    readonly error?: string;
+};
+export type DeliverVoiceReplyOptions = SynthesizeReplyOptions & EnsureOggOpusOptions;
+/**
+ * End-to-end best-effort voice reply: synthesize → ensure OGG/Opus → deliver
+ * through the channel's {@link VoiceReplySink}. NEVER throws — every failure is
+ * a typed outcome — so a caller can invoke it AFTER sending the text reply and
+ * be sure the (already-sent) text is never broken by a voice failure.
+ */
+export declare function deliverVoiceReply(session: SynthesizerSource, text: string, sink: VoiceReplySink, opts?: DeliverVoiceReplyOptions): Promise<VoiceReplyOutcome>;
+export interface VoiceToggleInput {
+    /** The `/voice` argument (`''`, `on`, `off`, `status`, or anything → toggle). */
+    readonly arg: string;
+    /** Current persisted state. */
+    readonly enabled: boolean;
+    /** Whether a synthesizer is active right now. */
+    readonly hasSynthesizer: boolean;
+    /** How this channel delivers audio, e.g. `a voice note` / `an audio file`. */
+    readonly delivery: string;
+    /** Install-guidance line appended when enabling with no active synthesizer. */
+    readonly noSynthesizerHint: string;
+}
+export interface VoiceToggleResult {
+    /** Desired enabled state after the command. */
+    readonly enabled: boolean;
+    /** Whether the caller should persist `enabled` (false for `status`). */
+    readonly persist: boolean;
+    /** User-facing reply text. */
+    readonly reply: string;
+}
+/**
+ * Resolve a channel-agnostic `/voice` toggle command into the new state + the
+ * reply to show. `on`/`off` are explicit, `status` just reports, anything else
+ * flips. Enabling with no active synthesizer still turns the preference on (so
+ * replies start speaking once a backend is installed) but appends install
+ * guidance. Wording is parameterized (`delivery`, `noSynthesizerHint`) so each
+ * messenger keeps its own phrasing.
+ */
+export declare function resolveVoiceToggle(input: VoiceToggleInput): VoiceToggleResult;
+//# sourceMappingURL=voice-reply.d.ts.map

package/dist/voice-reply.d.ts.map

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

package/dist/voice-reply.js

@@ -0,0 +1,333 @@
+import { Buffer } from 'node:buffer';
+import { spawn } from 'node:child_process';
+/**
+ * Strip markdown down to what should be *spoken*. Code fences become a short
+ * "(code omitted)" placeholder (reading a diff aloud is noise), links keep only
+ * their label, and the inline emphasis/heading/quote/bullet marks are removed
+ * so a TTS engine doesn't voice the punctuation. Whitespace is collapsed.
+ */
+export function toSpeech(markdown) {
+    let t = markdown ?? '';
+    // Fenced code blocks (closed, then any unterminated trailing fence) → a short
+    // spoken placeholder. Must run BEFORE inline-code stripping (fences contain
+    // backticks).
+    t = t.replace(/```[\s\S]*?```/g, ' (code omitted) ');
+    t = t.replace(/```[\s\S]*$/g, ' (code omitted) ');
+    // Images `![alt](url)` → alt; links `[label](url)` → label.
+    t = t.replace(/!\[([^\]]*)\]\([^)]*\)/g, '$1');
+    t = t.replace(/\[([^\]]+)\]\([^)]*\)/g, '$1');
+    // Inline code `x` → x.
+    t = t.replace(/`([^`]+)`/g, '$1');
+    // Emphasis / strikethrough marks.
+    t = t.replace(/(\*\*|__|~~|\*|_)/g, '');
+    // Leading heading / blockquote / list markers (line-anchored).
+    t = t.replace(/^\s{0,3}#{1,6}\s*/gm, '');
+    t = t.replace(/^\s{0,3}>\s?/gm, '');
+    t = t.replace(/^\s{0,3}[-*+]\s+/gm, '');
+    // Collapse runs of spaces/tabs and excess blank lines.
+    t = t.replace(/[ \t]+/g, ' ');
+    t = t.replace(/\n{3,}/g, '\n\n');
+    return t.trim();
+}
+/** Default ceiling on the characters we hand a TTS backend for one reply. Long
+ *  answers are truncated at a sentence/word boundary so synthesis stays fast
+ *  and cheap (a spoken 30-page essay helps no one). */
+const DEFAULT_MAX_SPEECH_CHARS = 1_200;
+function truncateForSpeech(text, max) {
+    if (text.length <= max)
+        return text;
+    const slice = text.slice(0, max);
+    const sentence = Math.max(slice.lastIndexOf('. '), slice.lastIndexOf('! '), slice.lastIndexOf('? '), slice.lastIndexOf('\n'));
+    const cut = sentence > max * 0.5 ? sentence + 1 : slice.lastIndexOf(' ');
+    const head = (cut > 0 ? slice.slice(0, cut) : slice).trim();
+    return `${head}…`;
+}
+/**
+ * Synthesize a reply through the session's active synthesizer. Cleans markdown
+ * for speech ({@link toSpeech}), truncates sensibly, and NEVER throws — every
+ * failure mode is a typed `ok:false` result so the turn path stays intact.
+ */
+export async function synthesizeReply(session, text, opts = {}) {
+    let synth;
+    try {
+        synth = session.synthesizers.tryGetActive();
+    }
+    catch (err) {
+        return { ok: false, reason: 'failed', error: err instanceof Error ? err.message : String(err) };
+    }
+    if (!synth)
+        return { ok: false, reason: 'no-synthesizer' };
+    const speech = truncateForSpeech(toSpeech(text), opts.maxChars ?? DEFAULT_MAX_SPEECH_CHARS);
+    if (!speech)
+        return { ok: false, reason: 'empty' };
+    const synthOpts = {};
+    if (opts.voice !== undefined)
+        synthOpts.voice = opts.voice;
+    if (opts.language !== undefined)
+        synthOpts.language = opts.language;
+    if (opts.rate !== undefined)
+        synthOpts.rate = opts.rate;
+    if (opts.signal !== undefined)
+        synthOpts.signal = opts.signal;
+    try {
+        const result = await synth.synthesize(speech, synthOpts);
+        if (!result?.audio || result.audio.byteLength === 0) {
+            return { ok: false, reason: 'failed', error: 'synthesizer returned no audio' };
+        }
+        return { ok: true, audio: result.audio, mimeType: result.mimeType };
+    }
+    catch (err) {
+        return { ok: false, reason: 'failed', error: err instanceof Error ? err.message : String(err) };
+    }
+}
+/** True for a mime type Telegram accepts as a native voice note (OGG/Opus). */
+function isOggOpusMime(mimeType) {
+    const m = mimeType.toLowerCase();
+    return m.includes('opus') || m.includes('ogg');
+}
+/** Map an audio mime type to a sensible file extension (for the attachment name
+ *  a messenger uses to sniff the format). Falls back to `audio` when unknown. */
+export function audioExtForMime(mimeType) {
+    const m = (mimeType || '').toLowerCase();
+    if (m.includes('opus') || m.includes('ogg'))
+        return 'ogg';
+    if (m.includes('mpeg') || m.includes('mp3'))
+        return 'mp3';
+    if (m.includes('wav'))
+        return 'wav';
+    if (m.includes('webm'))
+        return 'webm';
+    if (m.includes('aac') || m.includes('m4a') || m.includes('mp4'))
+        return 'm4a';
+    if (m.includes('flac'))
+        return 'flac';
+    return 'audio';
+}
+const TRANSCODE_ARGS = [
+    '-hide_banner',
+    '-loglevel',
+    'error',
+    '-i',
+    'pipe:0',
+    '-f',
+    'ogg',
+    '-c:a',
+    'libopus',
+    '-b:a',
+    '32k',
+    '-ac',
+    '1',
+    'pipe:1',
+];
+/** Ceiling on transcoded output we buffer (a runaway/adversarial input can't
+ *  grow memory without bound). 25MB is well past any spoken reply. */
+const MAX_TRANSCODE_OUTPUT_BYTES = 25 * 1024 * 1024;
+/**
+ * Ensure audio is OGG/Opus for a native voice note. Passthrough when it already
+ * is; otherwise transcode via ffmpeg (stdin→stdout). Gated on an ffmpeg
+ * presence probe (mirrors `checkVoiceCaptureAvailable`, cached per process). On
+ * no-ffmpeg — or any transcode failure — returns the ORIGINAL bytes with
+ * `isOpus:false` so the caller falls back to a plain audio message. Never throws.
+ */
+export async function ensureOggOpus(audio, mimeType, opts = {}) {
+    if (isOggOpusMime(mimeType)) {
+        return { audio, mimeType: 'audio/ogg', transcoded: false, isOpus: true };
+    }
+    const available = await probeFfmpeg(opts.spawnImpl);
+    if (!available)
+        return { audio, mimeType, transcoded: false, isOpus: false };
+    try {
+        const out = await transcodeToOggOpus(audio, opts.spawnImpl ?? spawn);
+        if (out.byteLength === 0)
+            return { audio, mimeType, transcoded: false, isOpus: false };
+        return { audio: out, mimeType: 'audio/ogg', transcoded: true, isOpus: true };
+    }
+    catch {
+        return { audio, mimeType, transcoded: false, isOpus: false };
+    }
+}
+// Process-cached ffmpeg availability (the probe spawns a subprocess; caching
+// keeps a chatty channel from re-probing on every reply). Tests inject a
+// `spawnImpl`, which bypasses the cache.
+let ffmpegAvailable = null;
+async function probeFfmpeg(spawnImpl) {
+    if (spawnImpl)
+        return runFfmpegProbe(spawnImpl);
+    ffmpegAvailable ??= runFfmpegProbe(spawn);
+    return ffmpegAvailable;
+}
+/** Reset the cached ffmpeg probe (tests only). */
+export function __resetFfmpegProbeForTest() {
+    ffmpegAvailable = null;
+}
+function runFfmpegProbe(spawnImpl, command = 'ffmpeg', timeoutMs = 1_500) {
+    return new Promise((resolve) => {
+        let settled = false;
+        const done = (v) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve(v);
+        };
+        let child;
+        try {
+            child = spawnImpl(command, ['-version'], { stdio: ['ignore', 'ignore', 'ignore'] });
+        }
+        catch {
+            resolve(false);
+            return;
+        }
+        const timer = setTimeout(() => {
+            try {
+                if (!child.killed)
+                    child.kill('SIGKILL');
+            }
+            catch {
+                /* ignore */
+            }
+            done(false);
+        }, timeoutMs);
+        timer.unref?.();
+        child.once('error', () => done(false));
+        child.once('close', (code) => done(code === 0));
+    });
+}
+function transcodeToOggOpus(audio, spawnImpl, command = 'ffmpeg', timeoutMs = 15_000) {
+    return new Promise((resolve, reject) => {
+        let child;
+        try {
+            child = spawnImpl(command, TRANSCODE_ARGS, { stdio: ['pipe', 'pipe', 'pipe'] });
+        }
+        catch (err) {
+            reject(err instanceof Error ? err : new Error(String(err)));
+            return;
+        }
+        const out = [];
+        const errChunks = [];
+        let outBytes = 0;
+        let over = false;
+        let settled = false;
+        const finish = (fn) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            fn();
+        };
+        const timer = setTimeout(() => {
+            try {
+                if (!child.killed)
+                    child.kill('SIGKILL');
+            }
+            catch {
+                /* ignore */
+            }
+            finish(() => reject(new Error('ffmpeg transcode timed out')));
+        }, timeoutMs);
+        timer.unref?.();
+        child.stdout?.on('data', (c) => {
+            if (over)
+                return;
+            if (outBytes + c.byteLength > MAX_TRANSCODE_OUTPUT_BYTES) {
+                over = true;
+                try {
+                    child.kill('SIGKILL');
+                }
+                catch {
+                    /* ignore */
+                }
+                return;
+            }
+            outBytes += c.byteLength;
+            out.push(Buffer.from(c));
+        });
+        child.stderr?.on('data', (c) => {
+            errChunks.push(Buffer.from(c));
+            while (Buffer.concat(errChunks).byteLength > 4_096)
+                errChunks.shift();
+        });
+        child.once('error', (err) => finish(() => reject(err instanceof Error ? err : new Error(String(err)))));
+        child.once('close', (code) => finish(() => {
+            if (code === 0 && out.length > 0) {
+                resolve(new Uint8Array(Buffer.concat(out)));
+            }
+            else if (code === 0) {
+                reject(new Error('ffmpeg produced no output'));
+            }
+            else {
+                reject(new Error(`ffmpeg exited ${code}: ${Buffer.concat(errChunks).toString('utf8').trim()}`));
+            }
+        }));
+        const stdin = child.stdin;
+        if (stdin) {
+            stdin.on('error', () => {
+                // EPIPE if ffmpeg died before consuming stdin — the close/error handler
+                // reports the real failure; swallow this to avoid an unhandled 'error'.
+            });
+            try {
+                stdin.end(Buffer.from(audio));
+            }
+            catch {
+                /* the close/error path reports it */
+            }
+        }
+    });
+}
+/**
+ * End-to-end best-effort voice reply: synthesize → ensure OGG/Opus → deliver
+ * through the channel's {@link VoiceReplySink}. NEVER throws — every failure is
+ * a typed outcome — so a caller can invoke it AFTER sending the text reply and
+ * be sure the (already-sent) text is never broken by a voice failure.
+ */
+export async function deliverVoiceReply(session, text, sink, opts = {}) {
+    const synth = await synthesizeReply(session, text, opts);
+    if (!synth.ok) {
+        if (synth.reason === 'failed') {
+            return synth.error !== undefined
+                ? { status: 'failed', reason: 'synth', error: synth.error }
+                : { status: 'failed', reason: 'synth' };
+        }
+        return { status: 'skipped', reason: synth.reason };
+    }
+    const prepared = await ensureOggOpus(synth.audio, synth.mimeType, opts);
+    const filename = prepared.isOpus ? 'reply.ogg' : `reply.${audioExtForMime(prepared.mimeType)}`;
+    try {
+        await sink.send(prepared.audio, {
+            mimeType: prepared.mimeType,
+            filename,
+            isVoiceNote: prepared.isOpus,
+        });
+    }
+    catch (err) {
+        return { status: 'failed', reason: 'delivery', error: err instanceof Error ? err.message : String(err) };
+    }
+    return { status: 'sent', transcoded: prepared.transcoded, isVoiceNote: prepared.isOpus };
+}
+/**
+ * Resolve a channel-agnostic `/voice` toggle command into the new state + the
+ * reply to show. `on`/`off` are explicit, `status` just reports, anything else
+ * flips. Enabling with no active synthesizer still turns the preference on (so
+ * replies start speaking once a backend is installed) but appends install
+ * guidance. Wording is parameterized (`delivery`, `noSynthesizerHint`) so each
+ * messenger keeps its own phrasing.
+ */
+export function resolveVoiceToggle(input) {
+    const arg = input.arg.trim().toLowerCase();
+    const hint = input.hasSynthesizer ? '' : `\n\n${input.noSynthesizerHint}`;
+    if (arg === 'status') {
+        const state = input.enabled ? 'ON' : 'OFF';
+        const note = input.enabled ? hint : '';
+        return { enabled: input.enabled, persist: false, reply: `Voice replies are ${state}.${note}` };
+    }
+    const desired = arg === 'on' ? true : arg === 'off' ? false : !input.enabled;
+    if (!desired) {
+        return { enabled: false, persist: true, reply: '🔇 Voice replies OFF.' };
+    }
+    return {
+        enabled: true,
+        persist: true,
+        reply: `🔊 Voice replies ON — I'll speak my final reply as ${input.delivery}.${hint}`,
+    };
+}
+//# sourceMappingURL=voice-reply.js.map

package/dist/voice-reply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-reply.js","sourceRoot":"","sources":["../src/voice-reply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAwB3C;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,IAAI,CAAC,GAAG,QAAQ,IAAI,EAAE,CAAC;IACvB,8EAA8E;IAC9E,4EAA4E;IAC5E,cAAc;IACd,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;IACrD,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;IAClD,4DAA4D;IAC5D,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,yBAAyB,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC;IAC9C,uBAAuB;IACvB,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAClC,kCAAkC;IAClC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IACxC,+DAA+D;IAC/D,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;IACzC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IACpC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IACxC,uDAAuD;IACvD,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;AAClB,CAAC;AAED;;uDAEuD;AACvD,MAAM,wBAAwB,GAAG,KAAK,CAAC;AAEvC,SAAS,iBAAiB,CAAC,IAAY,EAAE,GAAW;IAClD,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CACvB,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EACvB,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EACvB,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EACvB,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CACxB,CAAC;IACF,MAAM,GAAG,GAAG,QAAQ,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5D,OAAO,GAAG,IAAI,GAAG,CAAC;AACpB,CAAC;AAcD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAA0B,EAC1B,IAAY,EACZ,OAA+B,EAAE;IAEjC,IAAI,KAAyB,CAAC;IAC9B,IAAI,CAAC;QACH,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAClG,CAAC;IACD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAE3D,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,QAAQ,IAAI,wBAAwB,CAAC,CAAC;IAC5F,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAEnD,MAAM,SAAS,GAAsB,EAAE,CAAC;IACxC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAG,SAAgC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACnF,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;QAAG,SAAmC,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC/F,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAG,SAA+B,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IAC/E,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAG,SAAsC,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAE5F,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;YACpD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,+BAA+B,EAAE,CAAC;QACjF,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;IACtE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAClG,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,SAAS,aAAa,CAAC,QAAgB;IACrC,MAAM,CAAC,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACjC,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACjD,CAAC;AAED;iFACiF;AACjF,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACzC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1D,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1D,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACtC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACtC,OAAO,OAAO,CAAC;AACjB,CAAC;AAmBD,MAAM,cAAc,GAAG;IACrB,cAAc;IACd,WAAW;IACX,OAAO;IACP,IAAI;IACJ,QAAQ;IACR,IAAI;IACJ,KAAK;IACL,MAAM;IACN,SAAS;IACT,MAAM;IACN,KAAK;IACL,KAAK;IACL,GAAG;IACH,QAAQ;CACT,CAAC;AAEF;sEACsE;AACtE,MAAM,0BAA0B,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAiB,EACjB,QAAgB,EAChB,OAA6B,EAAE;IAE/B,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC3E,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACpD,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC7E,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,CAAC;QACrE,IAAI,GAAG,CAAC,UAAU,KAAK,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACvF,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC/E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,yEAAyE;AACzE,yCAAyC;AACzC,IAAI,eAAe,GAA4B,IAAI,CAAC;AAEpD,KAAK,UAAU,WAAW,CAAC,SAAwB;IACjD,IAAI,SAAS;QAAE,OAAO,cAAc,CAAC,SAAS,CAAC,CAAC;IAChD,eAAe,KAAK,cAAc,CAAC,KAAK,CAAC,CAAC;IAC1C,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,yBAAyB;IACvC,eAAe,GAAG,IAAI,CAAC;AACzB,CAAC;AAED,SAAS,cAAc,CACrB,SAAuB,EACvB,OAAO,GAAG,QAAQ,EAClB,SAAS,GAAG,KAAK;IAEjB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,IAAI,GAAG,CAAC,CAAU,EAAQ,EAAE;YAChC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,CAAC,CAAC,CAAC;QACb,CAAC,CAAC;QACF,IAAI,KAA+B,CAAC;QACpC,IAAI,CAAC;YACH,KAAK,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QACtF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,CAAC;YACf,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC;gBACH,IAAI,CAAC,KAAK,CAAC,MAAM;oBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC3C,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,CAAC;QACd,CAAC,EAAE,SAAS,CAAC,CAAC;QACd,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB,CACzB,KAAiB,EACjB,SAAuB,EACvB,OAAO,GAAG,QAAQ,EAClB,SAAS,GAAG,MAAM;IAElB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,KAA+B,CAAC;QACpC,IAAI,CAAC;YACH,KAAK,GAAG,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC5D,OAAO;QACT,CAAC;QACD,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,IAAI,IAAI,GAAG,KAAK,CAAC;QACjB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,EAAc,EAAQ,EAAE;YACtC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,EAAE,EAAE,CAAC;QACP,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC;gBACH,IAAI,CAAC,KAAK,CAAC,MAAM;oBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC3C,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;YACD,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC,CAAC;QAChE,CAAC,EAAE,SAAS,CAAC,CAAC;QACd,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QAEhB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;YACrC,IAAI,IAAI;gBAAE,OAAO;YACjB,IAAI,QAAQ,GAAG,CAAC,CAAC,UAAU,GAAG,0BAA0B,EAAE,CAAC;gBACzD,IAAI,GAAG,IAAI,CAAC;gBACZ,IAAI,CAAC;oBACH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACxB,CAAC;gBAAC,MAAM,CAAC;oBACP,YAAY;gBACd,CAAC;gBACD,OAAO;YACT,CAAC;YACD,QAAQ,IAAI,CAAC,CAAC,UAAU,CAAC;YACzB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;YACrC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/B,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,UAAU,GAAG,KAAK;gBAAE,SAAS,CAAC,KAAK,EAAE,CAAC;QACxE,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAC1B,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAC1E,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAC3B,MAAM,CAAC,GAAG,EAAE;YACV,IAAI,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjC,OAAO,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC9C,CAAC;iBAAM,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC,CAAC;YACjD,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB,IAAI,KAAK,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;YAClG,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QAEF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC1B,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACrB,wEAAwE;gBACxE,wEAAwE;YAC1E,CAAC,CAAC,CAAC;YACH,IAAI,CAAC;gBACH,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAChC,CAAC;YAAC,MAAM,CAAC;gBACP,qCAAqC;YACvC,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAyBD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAA0B,EAC1B,IAAY,EACZ,IAAoB,EACpB,OAAiC,EAAE;IAEnC,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACd,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC,KAAK,KAAK,SAAS;gBAC9B,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;gBAC3D,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAC5C,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;IACrD,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC/F,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE;YAC9B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,QAAQ;YACR,WAAW,EAAE,QAAQ,CAAC,MAAM;SAC7B,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAC3G,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,WAAW,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;AAC3F,CAAC;AAwBD;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAuB;IACxD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,iBAAiB,EAAE,CAAC;IAE1E,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;QAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,qBAAqB,KAAK,IAAI,IAAI,EAAE,EAAE,CAAC;IACjG,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;IAC7E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;IAC3E,CAAC;IACD,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,sDAAsD,KAAK,CAAC,QAAQ,IAAI,IAAI,EAAE;KACtF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@moxxy/channel-kit",
+  "version": "0.27.0",
+  "description": "Shared channel-building machinery for moxxy messaging channels: throttled send-once-then-edit frame pump, turnId-filtered turn running with single-flight coordination, pairing state machines (host-issued code + TOFU), vault-backed secret resolution, audited allow-list permissions, and an inbound-webhook ingest scaffold.",
+  "keywords": [
+    "moxxy",
+    "agent",
+    "channel",
+    "framework"
+  ],
+  "homepage": "https://moxxy.ai",
+  "bugs": {
+    "url": "https://github.com/moxxy-ai/moxxy/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/moxxy-ai/moxxy.git",
+    "directory": "packages/channel-kit"
+  },
+  "author": "Michal Makowski <michal.makowski97@gmail.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@moxxy/sdk": "0.27.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.8",
+    "@moxxy/vitest-preset": "0.0.0",
+    "@moxxy/tsconfig": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist .turbo"
+  }
+}