@oscharko-dev/keiko-contracts 0.2.8 → 0.2.9

package/dist/voice-playback.js

@@ -0,0 +1,240 @@
+// Public type contract for the optional Voice Digital Twin assistant speech-output playback lifecycle
+// (Epic #491, Issue #501, ADR-0064). This module DEFINES the provider-neutral semantics that let Keiko
+// render and control an *optional* spoken assistant response — preparing, speaking, pausing, resuming,
+// interrupting (barge-in), stopping, failing, and completing — WITHOUT deploying any new text-to-speech
+// model and WITHOUT making speech a precondition for using Keiko. It is pure data + pure functions only:
+// nothing performs IO, crypto, clock reads, randomness, or audio processing, and no provider base URL,
+// credential, or raw audio buffer is ever a field on these types. The playback STATE is content-free by
+// construction — raw assistant audio is media-plane only (`VOICE_MEDIA_PLANE`, `never-persisted`,
+// `raw-media`) and is never a field here (AC3/AC4).
+//
+// It is layered ABOVE the #496 wire protocol (voice-protocol.ts): the wire carries five coarse playback
+// states (`idle`, `playing`, `paused`, `stopped`, `interrupted`) on the single `playback.state` control
+// message, whereas the lifecycle here has eight PHASES that additionally distinguish "not available for
+// this turn" (`unavailable`), provider preparation (`preparing`), provider failure (`failed`), and a
+// natural end (`complete`). Only the phases that have a wire counterpart project onto the wire
+// (`mapVoicePlaybackPhaseToWireState`); `unavailable`, `preparing`, `failed`, and `complete` are derived
+// or local phases, exactly as the #500 transcript lifecycle and the #499 turn manager map a richer
+// semantic set onto the same coarse wire catalog (ADR-0062, ADR-0063). The stateful reducer that drives
+// these phases lives in keiko-ui (`voice-playback-state.ts`) as a synchronous deterministic engine; this
+// leaf contract holds the phase catalog, the classification tables, the legal-transition table, the
+// capability-gating predicates, the effect vocabulary, the validators, and the content-free turn summary
+// so later voice consumers (#502 discussion intelligence and memory review) can read playback outcomes
+// without forking the reducer.
+//
+// `VOICE_PLAYBACK_SCHEMA_VERSION` follows the same evolution rule as `VOICE_PROTOCOL_VERSION` /
+// `VOICE_TRANSCRIPT_SCHEMA_VERSION`: a breaking change introduces a NEW literal rather than mutating "1".
+// It is INDEPENDENT of the wire `VOICE_PROTOCOL_VERSION` and of `CONVERSATION_CAPABILITY_CONTRACT_VERSION`.
+// Leaf-package rule (ADR-0019 direction 1): no `@oscharko-dev/keiko-*` imports may appear here; sibling
+// types are reached by relative path.
+import { VOICE_MEDIA_PLANE, voiceMessageAllowedForProfile } from "./voice-protocol.js";
+// ─── Schema version ───────────────────────────────────────────────────────────
+export const VOICE_PLAYBACK_SCHEMA_VERSION = "1";
+export function isVoicePlaybackSchemaVersionSupported(version) {
+    return version === VOICE_PLAYBACK_SCHEMA_VERSION;
+}
+export const VOICE_PLAYBACK_PHASES = [
+    "unavailable",
+    "preparing",
+    "speaking",
+    "paused",
+    "interrupted",
+    "canceled",
+    "failed",
+    "complete",
+];
+// The phases in which audio is live or imminent. While active, the user-facing controls (pause / resume
+// / stop / interrupt / mute) are meaningful; outside them the surface offers only replay-if-permitted
+// and the always-present text fallback.
+export const VOICE_PLAYBACK_ACTIVE_PHASES = [
+    "preparing",
+    "speaking",
+    "paused",
+];
+// The terminal lifecycle facts of a single assistant turn's playback. These are the durable, content-free
+// outcomes a turn summary or discussion-intelligence pass (#502) may read.
+export const VOICE_PLAYBACK_SETTLED_PHASES = [
+    "interrupted",
+    "canceled",
+    "failed",
+    "complete",
+];
+export const VOICE_PLAYBACK_FAILURE_KINDS = [
+    "rate-limited",
+    "timeout",
+    "provider-error",
+    "unavailable",
+    "internal",
+];
+// ─── Per-phase classification tables (aligned to voice-protocol.ts) ─────────────
+// Keyed by `VoicePlaybackPhase` so adding a phase without classifying it is a compile error (totality).
+//
+// Replay (AC5 reconnect semantics): the durable, settled lifecycle facts (`interrupted`, `canceled`,
+// `failed`, `complete`) are `replayable` — a reconnect re-delivers that the assistant turn ended a
+// certain way so turn accounting stays consistent. The in-flight phases (`preparing`,
+// `speaking`, `paused`) are `ephemeral`: a reconnect never re-delivers them and never re-plays the
+// audio, mirroring `transcript.partial`. `unavailable` is `ephemeral` (dormant, never a durable fact).
+export const VOICE_PLAYBACK_PHASE_REPLAY = {
+    unavailable: "ephemeral",
+    preparing: "ephemeral",
+    speaking: "ephemeral",
+    paused: "ephemeral",
+    interrupted: "replayable",
+    canceled: "replayable",
+    failed: "replayable",
+    complete: "replayable",
+};
+// Redaction: EVERY playback phase is `content-free`. A playback phase is an enum literal describing
+// control state; it never carries reviewable text, secret-bearing signaling, or raw audio. Raw assistant
+// audio is media-plane only (`VOICE_MEDIA_PLANE`: `never-persisted`, `raw-media`) and is never a field on
+// any type in this module. This table is the AC3/AC4 invariant expressed as data: no playback phase is
+// ever anything but `content-free`, so a playback record can never become a channel for audio or
+// credentials.
+export const VOICE_PLAYBACK_PHASE_REDACTION = {
+    unavailable: "content-free",
+    preparing: "content-free",
+    speaking: "content-free",
+    paused: "content-free",
+    interrupted: "content-free",
+    canceled: "content-free",
+    failed: "content-free",
+    complete: "content-free",
+};
+// The media-plane descriptor that governs the raw assistant audio this lifecycle controls. Re-exported
+// from the #496 protocol so the playback contract and the wire agree that audio is never-persisted,
+// raw-media, media-plane only — the typed expression of AC4 ("raw assistant audio is not stored by
+// default"). It is intentionally the SAME object the protocol pins; this module adds no new audio path.
+export const VOICE_PLAYBACK_AUDIO_PLANE = VOICE_MEDIA_PLANE;
+// ─── Legal transition table (Deliverable: reducer / state-machine rules) ────────
+// The set of phases reachable from a given phase by a state-CHANGING transition. Mute is intentionally
+// ABSENT: muting silences output without changing the phase (it is an orthogonal boolean), exactly as a
+// backchannel never changes the turn manager's state. Keyed by phase for totality.
+//
+// `unavailable` → `preparing` arms a new turn; the capability gate (`voicePlaybackAllowedForProfile`)
+// rejects that transition for a profile without speech output, so a no-capability deployment is pinned in
+// `unavailable` permanently (AC1). Every settled phase can be re-armed to `preparing` (a fresh turn or a
+// permitted replay). `preparing` may reach `complete` directly for an empty / instantly-finished
+// utterance. `interrupted` / `canceled` / `failed` / `complete` are otherwise terminal for the turn.
+export const VOICE_PLAYBACK_TRANSITIONS = {
+    unavailable: ["preparing"],
+    preparing: ["speaking", "complete", "canceled", "failed"],
+    speaking: ["paused", "interrupted", "canceled", "failed", "complete"],
+    paused: ["speaking", "interrupted", "canceled", "complete"],
+    interrupted: ["preparing"],
+    canceled: ["preparing"],
+    failed: ["preparing"],
+    complete: ["preparing"],
+};
+// ─── Type guards & lookups ───────────────────────────────────────────────────────
+export function isVoicePlaybackPhase(value) {
+    return typeof value === "string" && VOICE_PLAYBACK_PHASES.includes(value);
+}
+export function isVoicePlaybackFailureKind(value) {
+    return (typeof value === "string" && VOICE_PLAYBACK_FAILURE_KINDS.includes(value));
+}
+export function voicePlaybackPhaseReplayClass(phase) {
+    return VOICE_PLAYBACK_PHASE_REPLAY[phase];
+}
+export function voicePlaybackPhaseRedactionClass(phase) {
+    return VOICE_PLAYBACK_PHASE_REDACTION[phase];
+}
+// Whether audio is live or imminent in this phase (the user-facing transport controls are meaningful).
+export function isActiveVoicePlaybackPhase(phase) {
+    return VOICE_PLAYBACK_ACTIVE_PHASES.includes(phase);
+}
+// Whether this phase is a terminal lifecycle fact of the turn's playback (AC5 consumption).
+export function isSettledVoicePlaybackPhase(phase) {
+    return VOICE_PLAYBACK_SETTLED_PHASES.includes(phase);
+}
+// Whether `to` is reachable from `from` by a legal state-changing transition.
+export function canTransitionVoicePlayback(from, to) {
+    return VOICE_PLAYBACK_TRANSITIONS[from].includes(to);
+}
+// Exhaustiveness guard: a `default` / fall-through that reaches this fails to type-check if a new
+// `VoicePlaybackPhase` is added without handling, mirroring `assertNeverVoiceTranscriptSegmentState`.
+export function assertNeverVoicePlaybackPhase(phase) {
+    throw new Error(`unhandled voice playback phase: ${JSON.stringify(phase)}`);
+}
+// ─── Phase ↔ wire-state mapping ──────────────────────────────────────────────────
+// The coarse wire `VoicePlaybackState` (`playback.state`, voice-protocol.ts) a phase projects onto.
+// `unavailable` has no wire state (dormant — there is nothing to report on the wire) and returns
+// `undefined`. `preparing` and `complete` both map to `idle` (nothing audible); `canceled` and `failed`
+// both map to `stopped` (playback halted). A strict 1:1 phase↔wire map is impossible by design — the
+// same lesson the #499 turn manager and #500 transcript lifecycle record.
+export function mapVoicePlaybackPhaseToWireState(phase) {
+    switch (phase) {
+        case "unavailable":
+            return undefined;
+        case "preparing":
+            return "idle";
+        case "speaking":
+            return "playing";
+        case "paused":
+            return "paused";
+        case "interrupted":
+            return "interrupted";
+        case "canceled":
+            return "stopped";
+        case "failed":
+            return "stopped";
+        case "complete":
+            return "idle";
+        default:
+            return assertNeverVoicePlaybackPhase(phase);
+    }
+}
+export const VOICE_PLAYBACK_EFFECTS = [
+    "request-synthesis",
+    "start-output",
+    "pause-output",
+    "resume-output",
+    "stop-output",
+    "mute-output",
+    "unmute-output",
+    "notify-turn-speech-start",
+    "notify-turn-speech-completed",
+    "notify-turn-speech-stopped",
+    "notify-turn-interrupt",
+];
+export function isVoicePlaybackEffect(value) {
+    return typeof value === "string" && VOICE_PLAYBACK_EFFECTS.includes(value);
+}
+// ─── Capability-gating predicates (AC1/AC2) — derived from the contract ─────────
+// The single source of truth for capability gating is `voiceMessageAllowedForProfile`; these predicates
+// derive the playback-relevant capabilities from it rather than re-encoding the profile table. A profile
+// permits assistant speech output exactly when it permits the `playback.state` control message, and
+// permits interruption (barge-in) exactly when it permits `control.interrupt`. By the #496 profile table
+// `none` and `speech-to-text` permit neither (playback is dormant / `unavailable`), while `speech-output`
+// and `full-realtime` permit both. This is why "the current known deployed voice capability is STT-only"
+// renders no playback affordance (AC1) without any special case here.
+export function voicePlaybackAllowedForProfile(profile) {
+    return voiceMessageAllowedForProfile("playback.state", profile);
+}
+export function voicePlaybackInterruptAllowedForProfile(profile) {
+    return voiceMessageAllowedForProfile("control.interrupt", profile);
+}
+// The phase a freshly constructed controller starts in for a profile: `unavailable` always, because no
+// turn has produced audio yet. For a non-capable profile this is also the permanent phase (the gate
+// rejects every arming transition); for a capable profile it is the disarmed resting phase from which a
+// new turn arms `preparing`.
+export function initialVoicePlaybackPhase(_profile) {
+    return "unavailable";
+}
+// Build the content-free summary for a turn from its final phase and content-free counters. `spoke` is
+// true once the turn ever produced audible output (it reached at least `speaking`), which the caller
+// tracks; `completed` / `interrupted` / `failed` are derived from the terminal phase so they cannot
+// disagree with it.
+export function summarizeVoicePlaybackTurn(input) {
+    return {
+        schemaVersion: VOICE_PLAYBACK_SCHEMA_VERSION,
+        phase: input.phase,
+        available: input.available,
+        spoke: input.spoke,
+        completed: input.phase === "complete",
+        interrupted: input.phase === "interrupted",
+        failed: input.phase === "failed",
+        interruptions: input.interruptions,
+        replays: input.replays,
+        failureKind: input.phase === "failed" ? input.failureKind : undefined,
+    };
+}

package/dist/voice-protocol.d.ts

@@ -0,0 +1,165 @@
+import type { VoicePersona, VoiceProfile, VoiceProviderLocality, VoiceUnavailableReason } from "./gateway.js";
+export declare const VOICE_PROTOCOL_VERSION: "1";
+export declare function isVoiceProtocolVersionSupported(version: unknown): boolean;
+export type VoicePlane = "control" | "media";
+export declare const VOICE_PLANES: readonly VoicePlane[];
+export type VoiceControlTransport = "loopback-http-sse" | "loopback-websocket";
+export declare const VOICE_CONTROL_TRANSPORTS: readonly VoiceControlTransport[];
+export declare const VOICE_CONTROL_TRANSPORT_V1: VoiceControlTransport;
+export type VoiceMediaTransport = "none" | "gateway-batch" | "webrtc";
+export declare const VOICE_MEDIA_TRANSPORTS: readonly VoiceMediaTransport[];
+export type VoiceNegotiationMode = "proxied-sdp" | "direct-ephemeral" | "disabled";
+export declare const VOICE_NEGOTIATION_MODES: readonly VoiceNegotiationMode[];
+export declare const PREFERRED_VOICE_NEGOTIATION_MODE: VoiceNegotiationMode;
+export type VoiceReplayClass = "replayable" | "ephemeral" | "never-persisted";
+export declare const VOICE_REPLAY_CLASSES: readonly VoiceReplayClass[];
+export type VoiceRedactionClass = "content-free" | "reviewable-text" | "secret-bearing" | "raw-media";
+export declare const VOICE_REDACTION_CLASSES: readonly VoiceRedactionClass[];
+export type VoiceMessageDirection = "client-to-host" | "host-to-client";
+export declare const VOICE_MESSAGE_DIRECTIONS: readonly VoiceMessageDirection[];
+export type VoiceMediaTrackKind = "audio-in" | "audio-out";
+export declare const VOICE_MEDIA_TRACK_KINDS: readonly VoiceMediaTrackKind[];
+export interface VoiceMediaPlaneDescriptor {
+    readonly plane: "media";
+    readonly transport: "webrtc";
+    readonly trackKinds: readonly VoiceMediaTrackKind[];
+    readonly replay: "never-persisted";
+    readonly redaction: "raw-media";
+}
+export declare const VOICE_MEDIA_PLANE: VoiceMediaPlaneDescriptor;
+export type VoiceControlMessageKind = "session.create" | "session.created" | "session.close" | "session.closed" | "capability.offer" | "capability.select" | "signal.sdp.offer" | "signal.sdp.answer" | "signal.ice.candidate" | "media.track.state" | "control.cancel" | "control.interrupt" | "transcript.partial" | "transcript.committed" | "transcript.discarded" | "playback.state" | "policy.decision" | "error";
+export declare const VOICE_CONTROL_MESSAGE_KINDS: readonly VoiceControlMessageKind[];
+export type VoiceDataChannelEventKind = "control.interrupt" | "transcript.partial" | "playback.state";
+export declare const VOICE_DATA_CHANNEL_EVENT_KINDS: readonly VoiceDataChannelEventKind[];
+export type VoiceSessionCloseReason = "client-request" | "host-request" | "policy-disabled" | "provider-unreachable" | "timeout" | "protocol-error";
+export declare const VOICE_SESSION_CLOSE_REASONS: readonly VoiceSessionCloseReason[];
+export type VoiceMediaTrackState = "negotiating" | "live" | "muted" | "ended";
+export declare const VOICE_MEDIA_TRACK_STATES: readonly VoiceMediaTrackState[];
+export type VoicePlaybackState = "idle" | "playing" | "paused" | "stopped" | "interrupted";
+export declare const VOICE_PLAYBACK_STATES: readonly VoicePlaybackState[];
+export type VoicePolicyDecision = "allow" | "deny" | "degrade";
+export declare const VOICE_POLICY_DECISIONS: readonly VoicePolicyDecision[];
+export type VoiceProtocolErrorCode = "unsupported-version" | "invalid-message" | "capability-unavailable" | "not-allowed-for-profile" | "negotiation-failed" | "rate-limited" | "internal";
+export declare const VOICE_PROTOCOL_ERROR_CODES: readonly VoiceProtocolErrorCode[];
+interface VoiceControlEnvelope<K extends VoiceControlMessageKind> {
+    readonly protocolVersion: typeof VOICE_PROTOCOL_VERSION;
+    readonly sessionId: string;
+    readonly seq: number;
+    readonly direction: VoiceMessageDirection;
+    readonly kind: K;
+}
+export interface VoiceSessionMemoryContext {
+    readonly enabled: boolean;
+    readonly budgetTokens?: number | undefined;
+}
+export type VoiceSessionGroundingKind = "files" | "knowledge" | "hybrid" | "multi";
+export interface VoiceSessionGroundingContext {
+    readonly enabled: boolean;
+    readonly sourceCount: number;
+    readonly kind: VoiceSessionGroundingKind;
+}
+export interface VoiceSessionChatContext {
+    readonly chatId: string;
+    readonly memory?: VoiceSessionMemoryContext | undefined;
+    readonly grounding?: VoiceSessionGroundingContext | undefined;
+}
+export interface VoiceSessionCreateMessage extends VoiceControlEnvelope<"session.create"> {
+    readonly idempotencyKey: string;
+    readonly requestedProfile: VoiceProfile;
+    readonly negotiationMode: VoiceNegotiationMode;
+    readonly persona?: VoicePersona | undefined;
+    readonly chatContext?: VoiceSessionChatContext | undefined;
+}
+export interface VoiceSessionCreatedMessage extends VoiceControlEnvelope<"session.created"> {
+    readonly profile: VoiceProfile;
+    readonly controlTransport: VoiceControlTransport;
+    readonly mediaTransport: VoiceMediaTransport;
+    readonly negotiationMode: VoiceNegotiationMode;
+    readonly providerLocality?: VoiceProviderLocality | undefined;
+}
+export interface VoiceSessionCloseMessage extends VoiceControlEnvelope<"session.close"> {
+    readonly reason: VoiceSessionCloseReason;
+}
+export interface VoiceSessionClosedMessage extends VoiceControlEnvelope<"session.closed"> {
+    readonly reason: VoiceSessionCloseReason;
+}
+export interface VoiceCapabilityOfferMessage extends VoiceControlEnvelope<"capability.offer"> {
+    readonly profile: VoiceProfile;
+    readonly capabilities: {
+        readonly speechToText: boolean;
+        readonly speechOutput: boolean;
+        readonly realtimeVoice: boolean;
+    };
+}
+export interface VoiceCapabilitySelectMessage extends VoiceControlEnvelope<"capability.select"> {
+    readonly profile: VoiceProfile;
+}
+export interface VoiceSdpOfferMessage extends VoiceControlEnvelope<"signal.sdp.offer"> {
+    readonly sdp: string;
+}
+export interface VoiceSdpAnswerMessage extends VoiceControlEnvelope<"signal.sdp.answer"> {
+    readonly sdp: string;
+}
+export interface VoiceIceCandidateMessage extends VoiceControlEnvelope<"signal.ice.candidate"> {
+    readonly candidate: string;
+    readonly sdpMid?: string | null | undefined;
+    readonly sdpMLineIndex?: number | null | undefined;
+}
+export interface VoiceMediaTrackStateMessage extends VoiceControlEnvelope<"media.track.state"> {
+    readonly track: VoiceMediaTrackKind;
+    readonly state: VoiceMediaTrackState;
+}
+export type VoiceControlCancelMessage = VoiceControlEnvelope<"control.cancel">;
+export interface VoiceControlInterruptMessage extends VoiceControlEnvelope<"control.interrupt"> {
+    readonly atMs?: number | undefined;
+}
+export interface VoiceTranscriptPartialMessage extends VoiceControlEnvelope<"transcript.partial"> {
+    readonly text: string;
+}
+export interface VoiceTranscriptCommittedMessage extends VoiceControlEnvelope<"transcript.committed"> {
+    readonly text: string;
+}
+export type VoiceTranscriptDiscardedMessage = VoiceControlEnvelope<"transcript.discarded">;
+export interface VoicePlaybackStateMessage extends VoiceControlEnvelope<"playback.state"> {
+    readonly state: VoicePlaybackState;
+}
+export interface VoicePolicyDecisionMessage extends VoiceControlEnvelope<"policy.decision"> {
+    readonly decision: VoicePolicyDecision;
+    readonly reason?: VoiceUnavailableReason | undefined;
+}
+export interface VoiceErrorMessage extends VoiceControlEnvelope<"error"> {
+    readonly code: VoiceProtocolErrorCode;
+}
+export type VoiceControlMessage = VoiceSessionCreateMessage | VoiceSessionCreatedMessage | VoiceSessionCloseMessage | VoiceSessionClosedMessage | VoiceCapabilityOfferMessage | VoiceCapabilitySelectMessage | VoiceSdpOfferMessage | VoiceSdpAnswerMessage | VoiceIceCandidateMessage | VoiceMediaTrackStateMessage | VoiceControlCancelMessage | VoiceControlInterruptMessage | VoiceTranscriptPartialMessage | VoiceTranscriptCommittedMessage | VoiceTranscriptDiscardedMessage | VoicePlaybackStateMessage | VoicePolicyDecisionMessage | VoiceErrorMessage;
+export declare const VOICE_CONTROL_MESSAGE_REPLAY: Record<VoiceControlMessageKind, VoiceReplayClass>;
+export declare const VOICE_CONTROL_MESSAGE_REDACTION: Record<VoiceControlMessageKind, VoiceRedactionClass>;
+export declare const VOICE_PROFILE_ALLOWED_MESSAGE_KINDS: Record<VoiceProfile, readonly VoiceControlMessageKind[]>;
+export declare const VOICE_PROFILE_MEDIA_TRANSPORT: Record<VoiceProfile, VoiceMediaTransport>;
+export declare const VOICE_PROFILE_NEGOTIATION_MODE: Record<VoiceProfile, VoiceNegotiationMode>;
+export interface VoiceProtocolTimeouts {
+    readonly sessionCreateMs: number;
+    readonly signalingMs: number;
+    readonly heartbeatIntervalMs: number;
+    readonly reconnectBackoffInitialMs: number;
+    readonly reconnectBackoffMaxMs: number;
+    readonly maxReconnectAttempts: number;
+}
+export declare const DEFAULT_VOICE_PROTOCOL_TIMEOUTS: VoiceProtocolTimeouts;
+export type VoiceProtocolValidation = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly reasons: readonly string[];
+};
+export declare function isVoiceControlMessageKind(value: unknown): value is VoiceControlMessageKind;
+export declare function isVoiceMessageDirection(value: unknown): value is VoiceMessageDirection;
+export declare function isVoiceNegotiationMode(value: unknown): value is VoiceNegotiationMode;
+export declare function voiceControlMessageReplayClass(kind: VoiceControlMessageKind): VoiceReplayClass;
+export declare function voiceControlMessageRedactionClass(kind: VoiceControlMessageKind): VoiceRedactionClass;
+export declare function isVoiceReplayEligible(kind: VoiceControlMessageKind): boolean;
+export declare function voiceMessageAllowedForProfile(kind: VoiceControlMessageKind, profile: VoiceProfile): boolean;
+export declare function assertNeverVoiceControlMessageKind(kind: never): never;
+export declare function isVoiceControlMessage(value: unknown): value is VoiceControlMessage;
+export declare function validateVoiceControlMessage(value: unknown): VoiceProtocolValidation;
+export {};
+//# sourceMappingURL=voice-protocol.d.ts.map

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

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