@yu_robotics/remote-cli 1.6.121 → 1.6.128

package/dist/maintenance/ReleaseOverview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReleaseOverview.d.ts","sourceRoot":"","sources":["../../src/maintenance/ReleaseOverview.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,QAAW,CAAC;AACvC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,MAAM,WAAW,aAAa;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAC7E,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,EAAE,CAO5E;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE;IAAE,OAAO,CAAC,EAAE,aAAa,EAAE,CAAA;CAAE,EAAE,EAAE,MAAM,SAAiB,GAAG,eAAe,GAAG,SAAS,CAyBpI"}

package/dist/maintenance/ReleaseOverview.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OVERVIEW_MAX_ITEMS = exports.OVERVIEW_MAX_GROUPS = exports.OVERVIEW_BYTES = void 0;
+exports.validReleaseChanges = validReleaseChanges;
+exports.buildReleaseOverview = buildReleaseOverview;
+exports.OVERVIEW_BYTES = 6 * 1024;
+exports.OVERVIEW_MAX_GROUPS = 6;
+exports.OVERVIEW_MAX_ITEMS = 12;
+function validReleaseChanges(value) {
+    return Array.isArray(value) && value.length >= 1 && value.length <= 3 && value.every(change => change && typeof change.topic === 'string' && /^[a-z][a-z0-9-]{0,39}$/.test(change.topic)
+        && typeof change.title === 'string' && change.title.trim() === change.title && change.title.length > 0
+        && Array.from(change.title).length <= 80 && !/[\r\n\[\]<>|*\x60]/.test(change.title)
+        && typeof change.text === 'string' && change.text.trim() === change.text && change.text.length > 0
+        && !/[\r\n]/.test(change.text) && Buffer.byteLength(change.text) <= 2 * 1024);
+}
+/** Aggregate the full selected range, never only the currently displayed page. */
+function buildReleaseOverview(sections, budget = exports.OVERVIEW_BYTES) {
+    if (!Number.isFinite(budget) || budget <= 0 || !sections.length || sections.some(section => !section.changes))
+        return;
+    const groups = new Map();
+    for (const section of sections)
+        for (const change of section.changes) {
+            let group = groups.get(change.topic);
+            if (!group) {
+                group = { topic: change.topic, title: change.title, items: [], seen: new Set() };
+                groups.set(change.topic, group);
+            }
+            if (!group.seen.has(change.text)) {
+                group.items.push(change.text);
+                group.seen.add(change.text);
+            }
+        }
+    const overview = { groups: [], totalGroups: groups.size,
+        totalItems: [...groups.values()].reduce((total, group) => total + group.items.length, 0) };
+    let shown = 0;
+    const limit = Math.min(budget, exports.OVERVIEW_BYTES);
+    for (const group of groups.values()) {
+        if (overview.groups.length >= exports.OVERVIEW_MAX_GROUPS || shown >= exports.OVERVIEW_MAX_ITEMS)
+            break;
+        const visible = { topic: group.topic, title: group.title, items: [] };
+        overview.groups.push(visible);
+        for (const item of group.items) {
+            if (shown >= exports.OVERVIEW_MAX_ITEMS)
+                break;
+            visible.items.push(item);
+            if (Buffer.byteLength(JSON.stringify(overview)) > limit)
+                visible.items.pop();
+            else
+                shown++;
+        }
+        if (!visible.items.length)
+            overview.groups.pop();
+    }
+    return overview.groups.length ? overview : undefined;
+}
+//# sourceMappingURL=ReleaseOverview.js.map

package/dist/maintenance/ReleaseOverview.js.map

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

package/dist/maintenance/SubscriptionInspection.d.ts

@@ -0,0 +1,49 @@
+import type { BackendKey } from '../types/config';
+import { type WeeklyObservation } from './CodexWeekly';
+import type { SubscriptionReminderStore } from './SubscriptionReminderStore';
+export interface InspectionAdapter {
+    backend: BackendKey;
+    inspect(signal: AbortSignal): Promise<{
+        kind: 'unsupported' | 'unavailable';
+    } | {
+        kind: 'observed';
+        observation: WeeklyObservation;
+    }>;
+}
+export declare function inspectionAdapters(codex: (signal: AbortSignal) => Promise<WeeklyObservation | undefined>): InspectionAdapter[];
+/** Observations stay in memory; acknowledged delivery suppression can survive CLI restarts. */
+export declare class SubscriptionInspection {
+    private readonly adapters;
+    private readonly send;
+    private readonly now;
+    private readonly intervalMs;
+    private readonly retryMs;
+    private readonly store?;
+    private previous?;
+    private reminder?;
+    private suppressed;
+    private accountKey?;
+    private conditionRevision;
+    private persistenceUnavailable;
+    private operations;
+    private supported;
+    private stopped;
+    private inFlight?;
+    private timer?;
+    private deliveryTimer?;
+    private readonly controller;
+    private readonly generation;
+    constructor(adapters: InspectionAdapter[], send: (message: object) => void, now?: () => number, intervalMs?: number, retryMs?: number, store?: SubscriptionReminderStore | undefined);
+    start(): void;
+    registered(supported: boolean): void;
+    disconnected(): void;
+    stop(): Promise<void>;
+    cycle(): Promise<void>;
+    handle(message: any): Promise<void>;
+    private enqueue;
+    private disablePersistence;
+    private scheduleCycle;
+    private deliver;
+    private clearDeliveryTimer;
+}
+//# sourceMappingURL=SubscriptionInspection.d.ts.map

package/dist/maintenance/SubscriptionInspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriptionInspection.d.ts","sourceRoot":"","sources":["../../src/maintenance/SubscriptionInspection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAA8C,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACnG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAE7E,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,UAAU,CAAC;IACpB,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,aAAa,GAAG,aAAa,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,WAAW,EAAE,iBAAiB,CAAA;KAAE,CAAC,CAAC;CACvI;AAID,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,GAAG,iBAAiB,EAAE,CAM9H;AAED,+FAA+F;AAC/F,qBAAa,sBAAsB;IAerB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAAuB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAC/E,OAAO,CAAC,QAAQ,CAAC,GAAG;IAAa,OAAO,CAAC,QAAQ,CAAC,UAAU;IAA2B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAC/G,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IAhBzB,OAAO,CAAC,QAAQ,CAAC,CAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,CAAW;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,CAAgB;IACjC,OAAO,CAAC,KAAK,CAAC,CAAgC;IAC9C,OAAO,CAAC,aAAa,CAAC,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;gBACd,QAAQ,EAAE,iBAAiB,EAAE,EAAmB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EACzF,GAAG,eAAW,EAAmB,UAAU,SAAyB,EAAmB,OAAO,SAAS,EACvG,KAAK,CAAC,EAAE,yBAAyB,YAAA;IAEpD,KAAK,IAAI,IAAI;IACb,UAAU,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IACpC,YAAY,IAAI,IAAI;IACd,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA6CtB,MAAM,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBnC,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,kBAAkB;CAC3B"}

package/dist/maintenance/SubscriptionInspection.js

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubscriptionInspection = void 0;
+exports.inspectionAdapters = inspectionAdapters;
+const crypto_1 = require("crypto");
+const CodexWeekly_1 = require("./CodexWeekly");
+const BACKENDS = ['claude', 'codex', 'agy', 'pi', 'opencode', 'kimi', 'zcode', 'dsh'];
+function inspectionAdapters(codex) {
+    return BACKENDS.map(backend => ({ backend, inspect: async (signal) => {
+            if (backend !== 'codex')
+                return { kind: 'unsupported' };
+            const observation = await codex(signal);
+            return observation ? { kind: 'observed', observation } : { kind: 'unavailable' };
+        } }));
+}
+/** Observations stay in memory; acknowledged delivery suppression can survive CLI restarts. */
+class SubscriptionInspection {
+    adapters;
+    send;
+    now;
+    intervalMs;
+    retryMs;
+    store;
+    previous;
+    reminder;
+    suppressed = false;
+    accountKey;
+    conditionRevision = 0;
+    persistenceUnavailable = false;
+    operations = Promise.resolve();
+    supported = false;
+    stopped = false;
+    inFlight;
+    timer;
+    deliveryTimer;
+    controller = new AbortController();
+    generation = (0, crypto_1.randomUUID)();
+    constructor(adapters, send, now = Date.now, intervalMs = CodexWeekly_1.INSPECTION_INTERVAL_MS, retryMs = 60_000, store) {
+        this.adapters = adapters;
+        this.send = send;
+        this.now = now;
+        this.intervalMs = intervalMs;
+        this.retryMs = retryMs;
+        this.store = store;
+    }
+    start() { if (!this.stopped && !this.timer && !this.inFlight)
+        this.scheduleCycle(0); }
+    registered(supported) { this.supported = supported; this.deliver(); }
+    disconnected() { this.supported = false; this.clearDeliveryTimer(); }
+    async stop() {
+        this.stopped = true;
+        this.disconnected();
+        this.controller.abort();
+        if (this.timer)
+            clearTimeout(this.timer);
+        this.timer = undefined;
+        await this.inFlight;
+        await this.operations;
+        this.previous = undefined;
+        this.reminder = undefined;
+    }
+    cycle() {
+        if (this.stopped)
+            return Promise.resolve();
+        if (this.inFlight)
+            return this.inFlight;
+        const operation = this.enqueue(async () => {
+            if (this.stopped || this.persistenceUnavailable)
+                return;
+            if (this.store) {
+                try {
+                    await this.store.initialize();
+                }
+                catch {
+                    this.disablePersistence();
+                    return;
+                }
+            }
+            for (const adapter of this.adapters) {
+                if (this.stopped)
+                    break;
+                let result;
+                try {
+                    result = await adapter.inspect(this.controller.signal);
+                }
+                catch {
+                    continue;
+                } // Unavailable evidence never clears delivery suppression or a valid baseline.
+                if (this.stopped || adapter.backend !== 'codex' || result.kind !== 'observed')
+                    continue;
+                try {
+                    const current = result.observation;
+                    if (current.accountKey !== this.accountKey) {
+                        this.suppressed = this.store ? await this.store.isSuppressed(current.accountKey) : false;
+                        this.accountKey = current.accountKey;
+                        this.conditionRevision++;
+                        this.reminder = undefined;
+                        this.clearDeliveryTimer();
+                        this.previous = undefined;
+                    }
+                    if (this.previous && (current.identity !== this.previous.identity || current.observedAt < this.previous.observedAt)) {
+                        this.reminder = undefined;
+                        this.clearDeliveryTimer();
+                        this.previous = undefined;
+                    }
+                    if (!current.candidate) {
+                        this.conditionRevision++;
+                        this.reminder = undefined;
+                        this.clearDeliveryTimer();
+                        if (this.suppressed && this.store)
+                            await this.store.setSuppressed(current.accountKey, false);
+                        this.suppressed = false;
+                    }
+                    if (!this.suppressed && !this.reminder && this.previous && (0, CodexWeekly_1.floatingWeeklyPair)(this.previous, current)) {
+                        this.reminder = { reminderId: (0, crypto_1.randomUUID)(), generation: this.generation, expiresAt: this.now() + 2 * CodexWeekly_1.INSPECTION_INTERVAL_MS,
+                            activationAvailable: false, backend: 'codex' };
+                        this.deliver();
+                    }
+                    // Retry samples within the hourly cadence do not replace the previous independent sample.
+                    if (!this.previous || current.observedAt - this.previous.observedAt >= this.intervalMs - 120_000 || !current.candidate)
+                        this.previous = current;
+                }
+                catch {
+                    this.disablePersistence();
+                    break;
+                }
+            }
+        });
+        this.inFlight = operation;
+        return operation.finally(() => { if (this.inFlight === operation)
+            this.inFlight = undefined; });
+    }
+    handle(message) {
+        if (!this.supported || !this.reminder || !this.accountKey || message.reminderId !== this.reminder.reminderId || message.generation !== this.generation
+            || this.reminder.expiresAt <= this.now())
+            return Promise.resolve();
+        if (message.type === 'subscription_reminder_ack' || message.type === 'subscription_action' && message.decision === 'dismiss') {
+            const accountKey = this.accountKey, revision = this.conditionRevision;
+            this.suppressed = true;
+            this.clearDeliveryTimer();
+            return this.enqueue(async () => {
+                // A valid non-candidate observation takes precedence over an ACK queued during that probe.
+                if (this.persistenceUnavailable || this.accountKey === accountKey && this.conditionRevision !== revision)
+                    return;
+                try {
+                    await this.store?.setSuppressed(accountKey, true);
+                }
+                catch {
+                    this.disablePersistence();
+                }
+            });
+        }
+        // Every other action is ignored: quota notices never execute prompts or trigger extra probes.
+        return Promise.resolve();
+    }
+    enqueue(operation) {
+        const result = this.operations.then(operation);
+        this.operations = result.catch(() => { });
+        return result;
+    }
+    disablePersistence() {
+        if (!this.persistenceUnavailable)
+            console.warn('[Maintenance] Quota reminders paused: local delivery state is unavailable. Normal messaging is unchanged.');
+        this.persistenceUnavailable = true;
+        this.clearDeliveryTimer();
+    }
+    scheduleCycle(delay) {
+        this.timer = setTimeout(() => {
+            this.timer = undefined;
+            void this.cycle().finally(() => { if (!this.stopped)
+                this.scheduleCycle(this.intervalMs); });
+        }, delay);
+        this.timer.unref?.();
+    }
+    deliver() {
+        if (this.stopped || this.persistenceUnavailable || !this.supported || !this.reminder || this.suppressed || this.deliveryTimer)
+            return;
+        if (this.reminder.expiresAt <= this.now()) {
+            this.reminder = undefined;
+            return;
+        }
+        try {
+            this.send({ type: 'subscription_reminder', reminder: this.reminder });
+        }
+        catch { /* Retry only the card, never a model request. */ }
+        this.deliveryTimer = setTimeout(() => { this.deliveryTimer = undefined; this.deliver(); }, this.retryMs);
+        this.deliveryTimer.unref?.();
+    }
+    clearDeliveryTimer() { if (this.deliveryTimer)
+        clearTimeout(this.deliveryTimer); this.deliveryTimer = undefined; }
+}
+exports.SubscriptionInspection = SubscriptionInspection;
+//# sourceMappingURL=SubscriptionInspection.js.map

package/dist/maintenance/SubscriptionInspection.js.map

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

package/dist/maintenance/SubscriptionReminderStore.d.ts

@@ -0,0 +1,12 @@
+/** Persist delivery suppression, never credentials, raw account IDs, or quota observations. */
+export declare class SubscriptionReminderStore {
+    private readonly store;
+    private accounts;
+    private initializing?;
+    private operations;
+    constructor(configDir: string, serverUrl: string, deviceId: string);
+    initialize(): Promise<void>;
+    isSuppressed(accountKey: string): Promise<boolean>;
+    setSuppressed(accountKey: string, suppressed: boolean): Promise<void>;
+}
+//# sourceMappingURL=SubscriptionReminderStore.d.ts.map

package/dist/maintenance/SubscriptionReminderStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriptionReminderStore.d.ts","sourceRoot":"","sources":["../../src/maintenance/SubscriptionReminderStore.ts"],"names":[],"mappings":"AAcA,+FAA+F;AAC/F,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,YAAY,CAAC,CAAgB;IACrC,OAAO,CAAC,UAAU,CAAqB;gBAE3B,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAKlE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOxD,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAatE"}

package/dist/maintenance/SubscriptionReminderStore.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubscriptionReminderStore = void 0;
+const path_1 = __importDefault(require("path"));
+const crypto_1 = require("crypto");
+const PrivateStore_1 = require("./PrivateStore");
+const FINGERPRINT = /^[a-f0-9]{64}$/;
+const MAX_ACCOUNTS = 256;
+function validLedger(value) {
+    return value?.format === 1 && Object.keys(value).every(key => key === 'format' || key === 'suppressedAccounts')
+        && Array.isArray(value.suppressedAccounts) && value.suppressedAccounts.length <= MAX_ACCOUNTS
+        && value.suppressedAccounts.every((key) => typeof key === 'string' && FINGERPRINT.test(key))
+        && new Set(value.suppressedAccounts).size === value.suppressedAccounts.length;
+}
+/** Persist delivery suppression, never credentials, raw account IDs, or quota observations. */
+class SubscriptionReminderStore {
+    store;
+    accounts = new Set();
+    initializing;
+    operations = Promise.resolve();
+    constructor(configDir, serverUrl, deviceId) {
+        const namespace = (0, crypto_1.createHash)('sha256').update(JSON.stringify([serverUrl, deviceId])).digest('hex');
+        this.store = new PrivateStore_1.PrivateStore(path_1.default.join(configDir, 'subscription-reminders', `${namespace}.json`), validLedger);
+    }
+    initialize() {
+        return this.initializing ??= this.store.read().then(ledger => {
+            this.accounts = new Set(ledger?.suppressedAccounts ?? []);
+        });
+    }
+    async isSuppressed(accountKey) {
+        if (!FINGERPRINT.test(accountKey))
+            throw new Error('Invalid quota account fingerprint.');
+        await this.initialize();
+        await this.operations;
+        return this.accounts.has(accountKey);
+    }
+    setSuppressed(accountKey, suppressed) {
+        const operation = this.operations.then(async () => {
+            if (!FINGERPRINT.test(accountKey))
+                throw new Error('Invalid quota account fingerprint.');
+            await this.initialize();
+            if (this.accounts.has(accountKey) === suppressed)
+                return;
+            const next = new Set(this.accounts);
+            if (suppressed)
+                next.add(accountKey);
+            else
+                next.delete(accountKey);
+            await this.store.write({ format: 1, suppressedAccounts: [...next] });
+            this.accounts = next;
+        });
+        this.operations = operation.catch(() => { });
+        return operation;
+    }
+}
+exports.SubscriptionReminderStore = SubscriptionReminderStore;
+//# sourceMappingURL=SubscriptionReminderStore.js.map

package/dist/maintenance/SubscriptionReminderStore.js.map

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

package/dist/maintenance/UpdateNotices.d.ts

@@ -0,0 +1,21 @@
+/** A notice tracks successful starts, not package installation or WebSocket OPEN. */
+export declare class UpdateNotices {
+    private readonly send;
+    private readonly retryMs;
+    private ledger?;
+    private index?;
+    private supported;
+    private timer?;
+    private stopped;
+    private operations;
+    private readonly store;
+    constructor(configDir: string, serverUrl: string, deviceId: string, send: (message: object) => void, retryMs?: number);
+    started(version: string): Promise<void>;
+    registered(supported: boolean): void;
+    disconnected(): void;
+    stop(): void;
+    handle(message: any): Promise<void>;
+    private deliver;
+    private clearTimer;
+}
+//# sourceMappingURL=UpdateNotices.d.ts.map

package/dist/maintenance/UpdateNotices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpdateNotices.d.ts","sourceRoot":"","sources":["../../src/maintenance/UpdateNotices.ts"],"names":[],"mappings":"AAsBA,qFAAqF;AACrF,qBAAa,aAAa;IAS4C,OAAO,CAAC,QAAQ,CAAC,IAAI;IACvF,OAAO,CAAC,QAAQ,CAAC,OAAO;IAT1B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,KAAK,CAAC,CAAe;IAC7B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAC,CAAgC;IAC9C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;gBAEjC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAmB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EACjG,OAAO,SAAS;IAK7B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB7C,UAAU,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IACpC,YAAY,IAAI,IAAI;IACpB,IAAI,IAAI,IAAI;IAEZ,MAAM,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBnC,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,UAAU;CACnB"}

package/dist/maintenance/UpdateNotices.js

@@ -0,0 +1,104 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateNotices = void 0;
+const path_1 = __importDefault(require("path"));
+const crypto_1 = require("crypto");
+const PrivateStore_1 = require("./PrivateStore");
+const Version_1 = require("./Version");
+const ReleaseNotes_1 = require("./ReleaseNotes");
+const UUID = /^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$/i;
+function validLedger(value) {
+    return value?.format === 1 && (0, Version_1.validNoticeVersion)(value.lastStartedVersion) && (0, Version_1.validNoticeVersion)(value.notificationBaselineVersion)
+        && (0, Version_1.validNoticeVersion)(value.firstAdoptionVersion) && (!value.pending || UUID.test(value.pending.noticeKey)
+        && (0, Version_1.validNoticeVersion)(value.pending.fromVersion) && (0, Version_1.validNoticeVersion)(value.pending.toVersion)
+        && value.pending.fromVersion === value.notificationBaselineVersion && (0, Version_1.compareNoticeVersions)(value.pending.fromVersion, value.pending.toVersion) < 0);
+}
+/** A notice tracks successful starts, not package installation or WebSocket OPEN. */
+class UpdateNotices {
+    send;
+    retryMs;
+    ledger;
+    index;
+    supported = false;
+    timer;
+    stopped = false;
+    operations = Promise.resolve();
+    store;
+    constructor(configDir, serverUrl, deviceId, send, retryMs = 60_000) {
+        this.send = send;
+        this.retryMs = retryMs;
+        const namespace = (0, crypto_1.createHash)('sha256').update(JSON.stringify([serverUrl, deviceId])).digest('hex');
+        this.store = new PrivateStore_1.PrivateStore(path_1.default.join(configDir, 'update-notices', `${namespace}.json`), validLedger);
+    }
+    async started(version) {
+        if (!(0, Version_1.validNoticeVersion)(version))
+            throw new Error('Invalid running CLI version.');
+        this.index = await (0, ReleaseNotes_1.loadReleaseIndex)();
+        const previous = await this.store.read();
+        const next = previous ? { ...previous, lastStartedVersion: version } : {
+            format: 1, lastStartedVersion: version, notificationBaselineVersion: version, firstAdoptionVersion: version,
+        };
+        if (previous) {
+            if ((0, Version_1.compareNoticeVersions)(version, next.notificationBaselineVersion) <= 0
+                || (0, Version_1.compareNoticeVersions)(version, previous.lastStartedVersion) < 0)
+                delete next.pending;
+            else if ((0, Version_1.compareNoticeVersions)(version, previous.lastStartedVersion) > 0)
+                next.pending = {
+                    noticeKey: (0, crypto_1.randomUUID)(), fromVersion: next.notificationBaselineVersion, toVersion: version,
+                };
+        }
+        await this.store.write(next);
+        this.ledger = next;
+        this.deliver();
+    }
+    registered(supported) { this.supported = supported; this.deliver(); }
+    disconnected() { this.supported = false; this.clearTimer(); }
+    stop() { this.stopped = true; this.disconnected(); }
+    handle(message) {
+        const operation = this.operations.then(async () => {
+            if (!this.supported || this.stopped || !this.ledger)
+                return;
+            if (message.type === 'update_notice_ack') {
+                const pending = this.ledger.pending;
+                if (!pending || message.noticeKey !== pending.noticeKey || message.fromVersion !== pending.fromVersion
+                    || message.toVersion !== pending.toVersion)
+                    return;
+                const next = { ...this.ledger, notificationBaselineVersion: pending.toVersion };
+                delete next.pending;
+                await this.store.write(next);
+                this.ledger = next;
+                this.clearTimer();
+            }
+            else if (message.type === 'update_notice_view') {
+                const { fromVersion: from, toVersion: to, offset, requestId, noticeKey } = message;
+                if (!UUID.test(requestId) || !UUID.test(noticeKey) || !(0, Version_1.validNoticeVersion)(from) || !(0, Version_1.validNoticeVersion)(to)
+                    || (0, Version_1.compareNoticeVersions)(from, this.ledger.firstAdoptionVersion) < 0
+                    || (0, Version_1.compareNoticeVersions)(to, this.ledger.lastStartedVersion) > 0 || (0, Version_1.compareNoticeVersions)(from, to) >= 0
+                    || !Number.isSafeInteger(offset) || offset < 0 || offset > 10000)
+                    return;
+                this.send({ type: 'update_notice_page', noticeKey, requestId, fromVersion: from, toVersion: to,
+                    page: (0, ReleaseNotes_1.releasePage)(this.index, from, to, offset) });
+            }
+        });
+        this.operations = operation.catch(() => { });
+        return operation;
+    }
+    deliver() {
+        if (this.stopped || !this.supported || !this.ledger?.pending || this.timer)
+            return;
+        const pending = this.ledger.pending;
+        try {
+            this.send({ type: 'update_notice', ...pending, page: (0, ReleaseNotes_1.releasePage)(this.index, pending.fromVersion, pending.toVersion) });
+        }
+        catch { /* Retain the notice for a later compatible connection. */ }
+        this.timer = setTimeout(() => { this.timer = undefined; this.deliver(); }, this.retryMs);
+        this.timer.unref?.();
+    }
+    clearTimer() { if (this.timer)
+        clearTimeout(this.timer); this.timer = undefined; }
+}
+exports.UpdateNotices = UpdateNotices;
+//# sourceMappingURL=UpdateNotices.js.map

package/dist/maintenance/UpdateNotices.js.map

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

package/dist/maintenance/Version.d.ts

@@ -0,0 +1,3 @@
+export declare function validNoticeVersion(value: unknown): value is string;
+export declare function compareNoticeVersions(a: string, b: string): number;
+//# sourceMappingURL=Version.d.ts.map

package/dist/maintenance/Version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Version.d.ts","sourceRoot":"","sources":["../../src/maintenance/Version.ts"],"names":[],"mappings":"AAaA,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAkC;AAErG,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAclE"}

package/dist/maintenance/Version.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validNoticeVersion = validNoticeVersion;
+exports.compareNoticeVersions = compareNoticeVersions;
+/** Strict SemVer precedence for maintenance notices; updater semantics are unchanged. */
+const PATTERN = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$/;
+function parse(value) {
+    if (typeof value !== 'string' || value.length > 100)
+        return;
+    const match = PATTERN.exec(value);
+    if (!match)
+        return;
+    const core = match.slice(1, 4).map(Number);
+    const pre = match[4]?.split('.') ?? [];
+    if (core.some(n => !Number.isSafeInteger(n)) || pre.some(s => /^\d+$/.test(s) && (s.length > 1 && s[0] === '0')))
+        return;
+    return { core, pre };
+}
+function validNoticeVersion(value) { return Boolean(parse(value)); }
+function compareNoticeVersions(a, b) {
+    const left = parse(a), right = parse(b);
+    if (!left || !right)
+        throw new Error('Invalid maintenance version.');
+    for (let i = 0; i < 3; i++)
+        if (left.core[i] !== right.core[i])
+            return left.core[i] < right.core[i] ? -1 : 1;
+    if (!left.pre.length || !right.pre.length)
+        return left.pre.length === right.pre.length ? 0 : left.pre.length ? -1 : 1;
+    for (let i = 0; i < Math.max(left.pre.length, right.pre.length); i++) {
+        const l = left.pre[i], r = right.pre[i];
+        if (l === undefined || r === undefined)
+            return l === r ? 0 : l === undefined ? -1 : 1;
+        if (l === r)
+            continue;
+        const ln = /^\d+$/.test(l), rn = /^\d+$/.test(r);
+        if (ln && rn)
+            return l.length === r.length ? (l < r ? -1 : 1) : l.length < r.length ? -1 : 1;
+        return ln !== rn ? ln ? -1 : 1 : l < r ? -1 : 1;
+    }
+    return 0;
+}
+//# sourceMappingURL=Version.js.map

package/dist/maintenance/Version.js.map

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

package/dist/maintenance/release-notes.json

@@ -0,0 +1 @@
+{"format":1,"firstVersion":"1.6.123","sections":[{"version":"1.6.128","text":"### 按功能汇总更新\n- 跨多个版本升级时，按功能汇总当前设备尚未收到的变化；逐版本记录保留在折叠详情中。","changes":[{"topic":"upgrade-notices","title":"升级通知","text":"跨多个版本升级时，按功能汇总当前设备尚未收到的变化；逐版本记录保留在折叠详情中。"}],"details":"### Changed\n- Aggregate upgrade summaries by stable feature tags across each device's full pending version range, deduplicate identical items, and keep per-version summaries and technical details collapsed. Bounded overviews report omitted items while retaining complete paged records, with additive old-peer fallback and no runtime model calls."},{"version":"1.6.127","text":"### 升级通知更易读\n- 升级卡片优先展示中文摘要，快速了解有哪些变化。\n- 技术细节保留在折叠区域，需要时再展开查看。","changes":[{"topic":"upgrade-notices","title":"升级通知","text":"升级卡片优先展示中文摘要，快速了解有哪些变化。"},{"topic":"upgrade-notices","title":"升级通知","text":"技术细节保留在折叠区域，需要时再展开查看。"}],"details":"### Changed\n- Bundle concise Chinese user release summaries alongside English technical changelog entries. Upgrade cards display localized summaries directly and keep technical details collapsed, with legacy-peer fallback and the existing silent first-adoption behavior.\n- Require matching technical and user-summary entries for the current release during CLI builds, with bounded summary structure and package payloads."},{"version":"1.6.126","text":"### 提醒更稳定，卡片更简洁\n- 修复 Codex Reset 提醒在 CLI 升级、重启后容易重复出现的问题。\n- 移除多余的 Dismiss 按钮，无需手动关闭提醒。","changes":[{"topic":"codex-reset","title":"Codex 提醒","text":"修复 Codex Reset 提醒在 CLI 升级、重启后容易重复出现的问题。"},{"topic":"codex-reset","title":"Codex 提醒","text":"移除多余的 Dismiss 按钮，无需手动关闭提醒。"}],"details":"### Fixed\n- Preserve acknowledged Codex quota-reminder suppression across CLI upgrades, restarts, reconnects, and credential refreshes using a private local fingerprint ledger. Valid non-candidate observations rearm reminders; unavailable probes do not, and shutdown waits for accepted acknowledgement writes.\n\n### Changed\n- Remove the redundant Dismiss button from new quota-reminder cards while retaining validated legacy callbacks and the existing notification-only inspection criteria."},{"version":"1.6.125","text":"### Codex 提醒更直观\n- 额度提醒改名为 Codex Reset，明确显示每周额度为 100%。\n- 简化卡片说明，保留开始新一轮使用的操作指引。","changes":[{"topic":"codex-reset","title":"Codex 提醒","text":"额度提醒改名为 Codex Reset，明确显示每周额度为 100%。"},{"topic":"codex-reset","title":"Codex 提醒","text":"简化卡片说明，保留开始新一轮使用的操作指引。"}],"details":"### Changed\n- Rename Codex weekly-quota reminders to \"Codex Reset\" with a target emoji and the summary \"Weekly quota reset: 100%\", and remove their sampling-disclaimer footer, retaining normal-task guidance, optional dismissal, and the existing inspection logic."},{"version":"1.6.124","text":"### Claude 输出更干净\n- 隐藏 Claude 子 agent 偶尔显示的无关模型警告，保留真正的接口和登录错误。","changes":[{"topic":"claude-output","title":"Claude 输出","text":"隐藏 Claude 子 agent 偶尔显示的无关模型警告，保留真正的接口和登录错误。"}],"details":"### Fixed\n- Suppress Claude Code model-recognition stderr diagnostics from session-title generation as well as SDK queries, including delegated-worker streaming and results. Preserve real API/authentication errors, nonzero exits, assistant text, and other backends."},{"version":"1.6.123","text":"### 新增升级通知与额度提醒\n- 升级后可查看跳过版本的更新内容，首次启用不会发送历史通知。\n- 新增 Codex 每周额度状态提醒，提示何时可以开始新一轮使用。","changes":[{"topic":"upgrade-notices","title":"升级通知","text":"升级后可查看跳过版本的更新内容，首次启用不会发送历史通知。"},{"topic":"codex-reset","title":"Codex 提醒","text":"新增 Codex 每周额度状态提醒，提示何时可以开始新一轮使用。"}],"details":"### Added\n- Standalone CLI upgrade notices with cumulative bundled release notes, offline delivery, and a silent baseline on first adoption.\n- Hourly, status-only Codex weekly-quota inspection and explicit maintenance reminders, without changing user threads or other backends.\n- Notification-only weekly-quota snapshots with backend-specific explanations and normal-task guidance, without verification steps, activation requests, or claims that a quota reset occurred. Dismissal remains optional."}]}