instar 1.3.1111 → 1.3.1113

package/dist/core/TopicAwareness.d.ts

@@ -0,0 +1,134 @@
+/**
+ * TopicAwareness — the temporal projection over Topic Intent evidence.
+ *
+ * Topic Intent confidence tiers answer "how well supported is this ref?".
+ * These three awareness levels answer the orthogonal question "over what
+ * horizon is the conversation moving?": whole topic, most-recent arc, and
+ * current work.  The projection is orientation only; it never promotes a ref
+ * or grants authority.
+ */
+export type AwarenessSpeaker = 'user' | 'agent';
+export interface AwarenessLayerDraft {
+    goal: string;
+    trend: string;
+    themes: string[];
+}
+export interface ArcTransitionDraft {
+    kind: 'continue' | 'new';
+    /** Exact excerpt from the current USER message that grounds a requested transition. */
+    evidenceQuote?: string;
+}
+export interface AwarenessDraft {
+    topic: AwarenessLayerDraft;
+    recentArc: AwarenessLayerDraft;
+    currentWork: AwarenessLayerDraft;
+    arcTransition?: ArcTransitionDraft;
+}
+export interface AwarenessLayer extends AwarenessLayerDraft {
+    updatedAt: string;
+    sourceMessageId: string;
+    sourceSpeaker: AwarenessSpeaker;
+    sourceTurn: number;
+}
+export interface TopicAnchor {
+    goal: string;
+    capturedAt: string;
+    sourceMessageId: string;
+    /** Conversation order, so completion order cannot choose the origin. */
+    sourceTurn: number;
+}
+export interface TopicAwarenessArc {
+    arcId: string;
+    /** Stable conversation-order ordinal; 1 retains the legacy arc id. */
+    sequence: number;
+    status: 'active' | 'closed';
+    startedAt: string;
+    startedTurn: number;
+    boundaryKind: 'initial' | 'explicit' | 'implicit';
+    boundaryMessageId: string;
+    endedAt?: string;
+    endedTurn?: number;
+    layer: AwarenessLayer;
+}
+/**
+ * Bounded reorder journal for the semantic arc dimension. LLM calls run
+ * concurrently, so a later completion can arrive before an earlier boundary.
+ * Keeping the last two rate windows lets us refold that boundary in
+ * conversation order without serialising the intelligence calls.
+ */
+export interface RecentArcEvent {
+    messageId: string;
+    at: string;
+    turn: number;
+    speaker: AwarenessSpeaker;
+    layer: AwarenessLayerDraft;
+    requestedNew: boolean;
+    grounded: boolean;
+    explicit: boolean;
+}
+export interface PendingArcCandidate {
+    goal: string;
+    firstSeenAt: string;
+    lastSeenAt: string;
+    confirmations: number;
+}
+export interface TopicAwarenessState {
+    version: 1;
+    /** Immutable first user-grounded topic goal. Evolution never overwrites it. */
+    anchor: TopicAnchor;
+    /** Evolving whole-topic view. */
+    topic: AwarenessLayer;
+    /** Compact semantic arc history; exactly one arc is active. */
+    arcs: TopicAwarenessArc[];
+    currentArcId: string;
+    /** Immediate work view, updated independently of the broader arc. */
+    currentWork: AwarenessLayer;
+    /** Hysteresis for an implicit (not explicitly phrased) arc transition. */
+    pendingArcCandidate?: PendingArcCandidate;
+    /** Bounded completion-reorder journal; never an authority/evidence store. */
+    recentArcEvents: RecentArcEvent[];
+    /** Closed arcs omitted from `arcs` by the hard history cap. */
+    archivedArcCount: number;
+    updatedAt: string;
+    turnAtUpdate: number;
+}
+export interface AwarenessUpdateInput {
+    topicId: number;
+    messageId: string;
+    messageText: string;
+    fromUser: boolean;
+    at: string;
+    turn: number;
+}
+export interface AwarenessUpdateResult {
+    state: TopicAwarenessState;
+    effectiveArcId: string;
+    transitioned: boolean;
+    /** False when a slower, older extraction completed after newer state. */
+    applied: boolean;
+    stale: boolean;
+    /** A stale completion may still move the anchor monotonically earlier. */
+    anchorCorrected: boolean;
+    /** True when stale input still changed the bounded order journal/arcs. */
+    stateReconciled: boolean;
+}
+/** 30 captures/minute × 60s provider wall; 64 covers the full inversion window. */
+export declare const MAX_RECENT_ARC_EVENTS = 64;
+/** Initial arc + 63 most-recent arcs; older closed history is counted, not retained. */
+export declare const MAX_RETAINED_ARCS = 64;
+/** Validate + bound model-authored awareness before it can touch durable state. */
+export declare function normalizeAwarenessDraft(value: unknown): AwarenessDraft | null;
+/** Bounded lexical similarity is used only for transition hysteresis, never meaning/authority. */
+export declare function awarenessGoalSimilarity(a: string, b: string): number;
+/**
+ * Apply one validated projection update.
+ *
+ * An explicit user shift (grounded by an exact quote containing shift language)
+ * transitions immediately. An implicit shift requires two similar consecutive
+ * user-grounded candidates. Agent turns can update orientation but can never
+ * create the topic anchor or switch arcs by themselves.
+ */
+export declare function applyAwarenessUpdate(existing: TopicAwarenessState | undefined, draft: AwarenessDraft, input: AwarenessUpdateInput): AwarenessUpdateResult | null;
+/** Safe, bounded representation for the extractor's untrusted-data prompt block. */
+export declare function awarenessForPrompt(state: TopicAwarenessState | undefined): string;
+//# sourceMappingURL=TopicAwareness.d.ts.map

package/dist/core/TopicAwareness.d.ts.map

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

package/dist/core/TopicAwareness.js

@@ -0,0 +1,454 @@
+/**
+ * TopicAwareness — the temporal projection over Topic Intent evidence.
+ *
+ * Topic Intent confidence tiers answer "how well supported is this ref?".
+ * These three awareness levels answer the orthogonal question "over what
+ * horizon is the conversation moving?": whole topic, most-recent arc, and
+ * current work.  The projection is orientation only; it never promotes a ref
+ * or grants authority.
+ */
+const MAX_GOAL_CHARS = 500;
+const MAX_TREND_CHARS = 600;
+const MAX_THEME_CHARS = 240;
+const MAX_THEMES = 5;
+/** 30 captures/minute × 60s provider wall; 64 covers the full inversion window. */
+export const MAX_RECENT_ARC_EVENTS = 64;
+/** Initial arc + 63 most-recent arcs; older closed history is counted, not retained. */
+export const MAX_RETAINED_ARCS = 64;
+const EXPLICIT_SHIFT = /\b(?:instead|now|switch(?:ing|ed)?|move(?:d|ing)? on|next|new (?:goal|phase|focus|task)|different (?:goal|phase|focus|task)|no longer|from here)\b/i;
+function compact(value, max) {
+    if (typeof value !== 'string')
+        return null;
+    const text = value.replace(/\s+/g, ' ').trim();
+    if (!text)
+        return null;
+    return text.slice(0, max);
+}
+/** Validate + bound model-authored awareness before it can touch durable state. */
+export function normalizeAwarenessDraft(value) {
+    if (!value || typeof value !== 'object')
+        return null;
+    const raw = value;
+    const layer = (candidate) => {
+        if (!candidate || typeof candidate !== 'object')
+            return null;
+        const c = candidate;
+        const goal = compact(c.goal, MAX_GOAL_CHARS);
+        const trend = compact(c.trend, MAX_TREND_CHARS);
+        if (!goal || !trend || !Array.isArray(c.themes))
+            return null;
+        const themes = c.themes
+            .map((theme) => compact(theme, MAX_THEME_CHARS))
+            .filter((theme) => Boolean(theme))
+            .slice(0, MAX_THEMES);
+        if (themes.length === 0)
+            return null;
+        return { goal, trend, themes };
+    };
+    const topic = layer(raw.topic);
+    const recentArc = layer(raw.recentArc);
+    const currentWork = layer(raw.currentWork);
+    if (!topic || !recentArc || !currentWork)
+        return null;
+    let arcTransition;
+    if (raw.arcTransition && typeof raw.arcTransition === 'object') {
+        const transition = raw.arcTransition;
+        if (transition.kind === 'continue') {
+            arcTransition = { kind: 'continue' };
+        }
+        else if (transition.kind === 'new') {
+            const evidenceQuote = compact(transition.evidenceQuote, 300);
+            arcTransition = { kind: 'new', ...(evidenceQuote ? { evidenceQuote } : {}) };
+        }
+    }
+    return { topic, recentArc, currentWork, arcTransition };
+}
+function materializeLayer(draft, input) {
+    return {
+        ...draft,
+        updatedAt: input.at,
+        sourceMessageId: input.messageId,
+        sourceSpeaker: input.fromUser ? 'user' : 'agent',
+        sourceTurn: input.turn,
+    };
+}
+function normalizedWords(text) {
+    return new Set(text.toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, ' ')
+        .split(/\s+/)
+        .filter((word) => word.length >= 4));
+}
+/** Bounded lexical similarity is used only for transition hysteresis, never meaning/authority. */
+export function awarenessGoalSimilarity(a, b) {
+    const left = normalizedWords(a);
+    const right = normalizedWords(b);
+    if (left.size === 0 || right.size === 0)
+        return 0;
+    let intersection = 0;
+    for (const word of left)
+        if (right.has(word))
+            intersection++;
+    return intersection / new Set([...left, ...right]).size;
+}
+function quoteIsGrounded(quote, messageText) {
+    if (!quote)
+        return false;
+    return messageText.toLowerCase().includes(quote.toLowerCase());
+}
+function arcId(topicId, sequence) {
+    return sequence === 1 ? `arc-${topicId}` : `arc-${topicId}-${sequence}`;
+}
+function compareArcEvents(a, b) {
+    if (a.turn !== b.turn)
+        return a.turn - b.turn;
+    if (a.speaker !== b.speaker)
+        return a.speaker === 'user' ? -1 : 1;
+    const byTime = Date.parse(a.at) - Date.parse(b.at);
+    if (Number.isFinite(byTime) && byTime !== 0)
+        return byTime;
+    return a.messageId.localeCompare(b.messageId);
+}
+function recordArcEvent(state, draft, input) {
+    const requestedNew = input.fromUser && draft.arcTransition?.kind === 'new';
+    const quote = draft.arcTransition?.evidenceQuote;
+    const grounded = Boolean(requestedNew && quoteIsGrounded(quote, input.messageText));
+    const event = {
+        messageId: input.messageId,
+        at: input.at,
+        turn: input.turn,
+        speaker: input.fromUser ? 'user' : 'agent',
+        layer: draft.recentArc,
+        requestedNew,
+        grounded,
+        explicit: Boolean(grounded && EXPLICIT_SHIFT.test(quote ?? '')),
+    };
+    const events = state.recentArcEvents ?? [];
+    const existingIndex = events.findIndex((candidate) => candidate.messageId === event.messageId && candidate.speaker === event.speaker);
+    if (existingIndex >= 0) {
+        if (JSON.stringify(events[existingIndex]) === JSON.stringify(event))
+            return false;
+        events[existingIndex] = event;
+    }
+    else {
+        events.push(event);
+    }
+    events.sort(compareArcEvents);
+    state.recentArcEvents = events.slice(-MAX_RECENT_ARC_EVENTS);
+    return true;
+}
+function deriveRecentBoundaries(events) {
+    const boundaries = [];
+    let pendingEvent;
+    for (const event of events.filter((candidate) => candidate.speaker === 'user').sort(compareArcEvents)) {
+        if (event.requestedNew && event.grounded && event.explicit) {
+            boundaries.push({ event, kind: 'explicit' });
+            pendingEvent = undefined;
+            continue;
+        }
+        if (event.requestedNew && event.grounded) {
+            if (pendingEvent && awarenessGoalSimilarity(pendingEvent.layer.goal, event.layer.goal) >= 0.55) {
+                boundaries.push({ event, kind: 'implicit' });
+                pendingEvent = undefined;
+            }
+            else {
+                pendingEvent = event;
+            }
+            continue;
+        }
+        // A later user continuation/ungrounded proposal disconfirms the candidate.
+        pendingEvent = undefined;
+    }
+    return {
+        boundaries,
+        ...(pendingEvent ? {
+            pending: {
+                goal: pendingEvent.layer.goal,
+                firstSeenAt: pendingEvent.at,
+                lastSeenAt: pendingEvent.at,
+                confirmations: 1,
+            },
+        } : {}),
+    };
+}
+function layerFromEvent(event) {
+    return {
+        ...event.layer,
+        updatedAt: event.at,
+        sourceMessageId: event.messageId,
+        sourceSpeaker: event.speaker,
+        sourceTurn: event.turn,
+    };
+}
+function boundaryFingerprint(arcs) {
+    return arcs
+        .map((arc) => `${arc.startedTurn}:${arc.boundaryKind}:${arc.boundaryMessageId}:${arc.sequence}`)
+        .join('|');
+}
+/**
+ * Refold the bounded transition journal in conversation order. Existing arcs
+ * older than the journal are frozen compact history. Arcs inside the journal
+ * are rebuilt, so a late earlier boundary can insert itself and an apparent
+ * implicit pair can be withdrawn when its intervening user turn arrives.
+ */
+function reconcileArcs(state, topicId) {
+    const before = boundaryFingerprint(state.arcs);
+    const events = [...(state.recentArcEvents ?? [])].sort(compareArcEvents);
+    if (events.length === 0)
+        return { changed: false, addedBoundary: false };
+    const oldestTurn = events[0].turn;
+    const existingArcs = state.arcs.map((arc, index) => ({
+        ...arc,
+        sequence: arc.sequence ?? index + 1,
+        startedTurn: arc.startedTurn ?? (index === 0 ? state.anchor.sourceTurn : state.turnAtUpdate),
+        boundaryKind: arc.boundaryKind ?? (index === 0 ? 'initial' : 'explicit'),
+        boundaryMessageId: arc.boundaryMessageId ?? arc.layer.sourceMessageId,
+    }));
+    // The first successful completion is not necessarily the first user turn.
+    // When a slower earlier completion corrects the anchor, the initial arc must
+    // move with it; otherwise its later startedTurn freezes out real boundaries
+    // between the corrected anchor and the first completion.
+    if (existingArcs[0]) {
+        existingArcs[0] = {
+            ...existingArcs[0],
+            arcId: arcId(topicId, 1),
+            sequence: 1,
+            startedAt: state.anchor.capturedAt,
+            startedTurn: state.anchor.sourceTurn,
+            boundaryKind: 'initial',
+            boundaryMessageId: state.anchor.sourceMessageId,
+        };
+    }
+    // Initial history is always retained. Other arcs older than the reorder
+    // window are immutable compact history and keep their sequence/id.
+    const frozen = existingArcs.filter((arc, index) => index === 0 || arc.startedTurn < oldestTurn);
+    const lastFrozenTurn = frozen.reduce((max, arc) => Math.max(max, arc.startedTurn), state.anchor.sourceTurn);
+    const { boundaries, pending } = deriveRecentBoundaries(events);
+    const derived = boundaries
+        .filter(({ event }) => event.turn > lastFrozenTurn)
+        .sort((a, b) => compareArcEvents(a.event, b.event));
+    const starts = frozen
+        .sort((a, b) => a.startedTurn - b.startedTurn)
+        .map((arc) => ({
+        turn: arc.startedTurn,
+        at: arc.startedAt,
+        kind: arc.boundaryKind,
+        messageId: arc.boundaryMessageId,
+        sequence: arc.sequence,
+        existing: arc,
+    }));
+    if (starts.length === 0) {
+        starts.push({
+            turn: state.anchor.sourceTurn,
+            at: state.anchor.capturedAt,
+            kind: 'initial',
+            messageId: state.anchor.sourceMessageId,
+            sequence: 1,
+        });
+    }
+    // `archivedArcCount` represents omitted middle history. Together with the
+    // retained frozen starts it gives the exact next conversation-order ordinal,
+    // even after the hard arc cap has pruned old objects.
+    let nextSequence = (state.archivedArcCount ?? 0) + starts.length + 1;
+    for (const boundary of derived) {
+        if (starts.some((start) => start.turn === boundary.event.turn))
+            continue;
+        starts.push({
+            turn: boundary.event.turn,
+            at: boundary.event.at,
+            kind: boundary.kind,
+            messageId: boundary.event.messageId,
+            sequence: nextSequence++,
+        });
+    }
+    starts.sort((a, b) => a.turn - b.turn || a.sequence - b.sequence);
+    let arcs = starts.map((start, index) => {
+        const next = starts[index + 1];
+        const candidates = events.filter((event) => event.turn >= start.turn && (!next || event.turn < next.turn));
+        const latest = candidates.sort(compareArcEvents).at(-1);
+        const fallback = start.existing?.layer
+            ?? existingArcs.find((arc) => arc.startedTurn === start.turn)?.layer
+            ?? state.arcs.at(-1)?.layer;
+        const layer = latest ? layerFromEvent(latest) : fallback;
+        // An awareness state always has at least its initial event/layer.
+        if (!layer)
+            throw new Error('TopicAwareness reconcile has no layer');
+        return {
+            arcId: arcId(topicId, start.sequence),
+            sequence: start.sequence,
+            status: next ? 'closed' : 'active',
+            startedAt: start.at,
+            startedTurn: start.turn,
+            boundaryKind: start.kind,
+            boundaryMessageId: start.messageId,
+            ...(next ? { endedAt: next.at, endedTurn: next.turn } : {}),
+            layer,
+        };
+    });
+    if (arcs.length > MAX_RETAINED_ARCS) {
+        const removedArcs = arcs.slice(1, arcs.length - (MAX_RETAINED_ARCS - 1));
+        const tail = arcs.slice(-(MAX_RETAINED_ARCS - 1));
+        const removed = removedArcs.length;
+        arcs = [arcs[0], ...tail];
+        state.archivedArcCount = (state.archivedArcCount ?? 0) + removed;
+        const cutoffTurn = Math.max(...removedArcs.map((arc) => arc.startedTurn));
+        // The pruned boundaries are now represented by archivedArcCount. Drop their
+        // reorder events too so a later refold cannot materialize them a second time.
+        state.recentArcEvents = state.recentArcEvents.filter((event) => event.turn > cutoffTurn);
+    }
+    const effective = [...arcs]
+        .filter((arc) => arc.startedTurn <= state.turnAtUpdate)
+        .sort((a, b) => b.startedTurn - a.startedTurn)[0] ?? arcs[arcs.length - 1];
+    state.arcs = arcs;
+    state.currentArcId = effective.arcId;
+    if (pending)
+        state.pendingArcCandidate = pending;
+    else
+        delete state.pendingArcCandidate;
+    const after = boundaryFingerprint(arcs);
+    const beforeKeys = new Set(before.split('|').filter(Boolean));
+    const afterKeys = after.split('|').filter(Boolean);
+    return {
+        changed: before !== after,
+        addedBoundary: afterKeys.some((key) => !beforeKeys.has(key) && !key.includes(':initial:')),
+    };
+}
+function effectiveArcIdForTurn(state, turn) {
+    return [...state.arcs]
+        .filter((arc) => arc.startedTurn <= turn)
+        .sort((a, b) => b.startedTurn - a.startedTurn)[0]?.arcId ?? state.currentArcId;
+}
+/**
+ * Capture is deliberately fire-and-forget, so LLM completions can arrive out
+ * of message order. User-turn number is the primary clock. Within one turn an
+ * agent reply follows its user message; same-speaker ties use event time.
+ */
+function isOlderThanProjection(existing, input) {
+    if (input.turn !== existing.turnAtUpdate)
+        return input.turn < existing.turnAtUpdate;
+    const existingFromUser = existing.currentWork.sourceSpeaker === 'user';
+    if (input.fromUser !== existingFromUser) {
+        // For a shared turn number, user message first, agent reply second.
+        return input.fromUser;
+    }
+    const priorMs = Date.parse(existing.updatedAt);
+    const inputMs = Date.parse(input.at);
+    if (Number.isFinite(priorMs) && Number.isFinite(inputMs))
+        return inputMs <= priorMs;
+    // With no usable tie-breaker, preserve already-durable state.
+    return true;
+}
+/**
+ * Apply one validated projection update.
+ *
+ * An explicit user shift (grounded by an exact quote containing shift language)
+ * transitions immediately. An implicit shift requires two similar consecutive
+ * user-grounded candidates. Agent turns can update orientation but can never
+ * create the topic anchor or switch arcs by themselves.
+ */
+export function applyAwarenessUpdate(existing, draft, input) {
+    const normalized = normalizeAwarenessDraft(draft);
+    if (!normalized)
+        return null;
+    if (!existing) {
+        // Do not let an agent-authored observation become the immutable user anchor.
+        if (!input.fromUser)
+            return null;
+        const arcId = `arc-${input.topicId}`;
+        const topic = materializeLayer(normalized.topic, input);
+        const state = {
+            version: 1,
+            anchor: {
+                goal: normalized.topic.goal,
+                capturedAt: input.at,
+                sourceMessageId: input.messageId,
+                sourceTurn: input.turn,
+            },
+            topic,
+            arcs: [{
+                    arcId,
+                    sequence: 1,
+                    status: 'active',
+                    startedAt: input.at,
+                    startedTurn: input.turn,
+                    boundaryKind: 'initial',
+                    boundaryMessageId: input.messageId,
+                    layer: materializeLayer(normalized.recentArc, input),
+                }],
+            currentArcId: arcId,
+            currentWork: materializeLayer(normalized.currentWork, input),
+            recentArcEvents: [],
+            archivedArcCount: 0,
+            updatedAt: input.at,
+            turnAtUpdate: input.turn,
+        };
+        recordArcEvent(state, normalized, input);
+        return {
+            state,
+            effectiveArcId: arcId,
+            transitioned: false,
+            applied: true,
+            stale: false,
+            anchorCorrected: false,
+            stateReconciled: false,
+        };
+    }
+    if (isOlderThanProjection(existing, input)) {
+        const state = structuredClone(existing);
+        state.recentArcEvents ??= [];
+        state.archivedArcCount ??= 0;
+        const anchorCorrected = input.fromUser && input.turn < existing.anchor.sourceTurn;
+        if (anchorCorrected) {
+            // The projection itself is stale, but the earliest valid user projection
+            // wins the origin regardless of LLM completion order. This is monotonic:
+            // a later turn can never rewrite the anchor.
+            state.anchor = {
+                goal: normalized.topic.goal,
+                capturedAt: input.at,
+                sourceMessageId: input.messageId,
+                sourceTurn: input.turn,
+            };
+        }
+        const eventRecorded = recordArcEvent(state, normalized, input);
+        const reconciled = reconcileArcs(state, input.topicId);
+        return {
+            state,
+            effectiveArcId: effectiveArcIdForTurn(state, input.turn),
+            transitioned: reconciled.addedBoundary,
+            applied: false,
+            stale: true,
+            anchorCorrected,
+            stateReconciled: anchorCorrected || eventRecorded || reconciled.changed,
+        };
+    }
+    const state = structuredClone(existing);
+    state.recentArcEvents ??= [];
+    state.archivedArcCount ??= 0;
+    state.topic = materializeLayer(normalized.topic, input);
+    state.currentWork = materializeLayer(normalized.currentWork, input);
+    state.updatedAt = input.at;
+    state.turnAtUpdate = input.turn;
+    recordArcEvent(state, normalized, input);
+    const reconciled = reconcileArcs(state, input.topicId);
+    return {
+        state,
+        effectiveArcId: effectiveArcIdForTurn(state, input.turn),
+        transitioned: reconciled.addedBoundary,
+        applied: true,
+        stale: false,
+        anchorCorrected: false,
+        stateReconciled: reconciled.changed,
+    };
+}
+/** Safe, bounded representation for the extractor's untrusted-data prompt block. */
+export function awarenessForPrompt(state) {
+    if (!state)
+        return '(no awareness projection yet)';
+    const active = state.arcs.find((arc) => arc.arcId === state.currentArcId);
+    return JSON.stringify({
+        initialTopicAnchor: state.anchor.goal,
+        topic: state.topic,
+        recentArc: active?.layer ?? null,
+        currentWork: state.currentWork,
+    }).slice(0, 5000);
+}
+//# sourceMappingURL=TopicAwareness.js.map

package/dist/core/TopicAwareness.js.map

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