shennian 0.5.0 → 0.5.2

package/dist/src/session/queued-chat-dispatch.d.ts

@@ -1,12 +0,0 @@
-import type { ReqFrame } from '@shennian/wire';
-import type { SessionManagerRuntime } from './types.js';
-import { type ChatSendExecutionContext } from './handlers/chat.js';
-import { type PreparedManagedRoomTurn } from './queue.js';
-export declare function managedChatContext(prepared: PreparedManagedRoomTurn): ChatSendExecutionContext;
-export declare function managedManagerEventContext(prepared: PreparedManagedRoomTurn): ChatSendExecutionContext;
-export declare function dispatchManagedChat(runtime: SessionManagerRuntime, req: ReqFrame, prepared: PreparedManagedRoomTurn): Promise<void>;
-export declare function dispatchQueuedChat(runtime: SessionManagerRuntime, req: ReqFrame, prepared?: PreparedManagedRoomTurn): Promise<{
-    deliveryMode?: string;
-    queuedSubmissionId?: string;
-}>;
-export declare function interruptQueuedChat(runtime: SessionManagerRuntime, sessionId: string): Promise<void>;

package/dist/src/session/run-recovery/barrier.d.ts

@@ -1,12 +0,0 @@
-export declare class RunRecoveryBarrier {
-    private recovering;
-    private releases;
-    private dispatchFrozen;
-    freezeDispatch(): void;
-    unfreezeDispatch(): void;
-    isDispatchFrozen(): boolean;
-    begin(sessionId: string): void;
-    end(sessionId: string): void;
-    isRecovering(sessionId: string): boolean;
-    wait(sessionId: string): Promise<void>;
-}

package/dist/src/session/run-recovery/coordinator.d.ts

@@ -1,32 +0,0 @@
-import type { AgentRecoveryResult } from '../../agents/adapter.js';
-import type { ActiveRunJournal } from './journal.js';
-import type { RunRecoveryBarrier } from './barrier.js';
-import { type RunJournalRecord } from './schema.js';
-export type RecoveryTerminal = Extract<AgentRecoveryResult, {
-    result: 'interrupted_by_upgrade' | 'recovery_failed';
-}>;
-export declare class RunRecoveryCoordinator {
-    private readonly deps;
-    private pendingBySession;
-    constructor(deps: {
-        journal: ActiveRunJournal;
-        barrier: RunRecoveryBarrier;
-        recover(record: RunJournalRecord, beforeContinueDispatch: () => void): Promise<AgentRecoveryResult>;
-        commitTerminal(record: RunJournalRecord, result: RecoveryTerminal): Promise<void>;
-        /** True only when the local canonical transaction for this run already committed. */
-        isCanonicalTerminal?: (record: RunJournalRecord) => boolean;
-        onOutcome?: (outcome: {
-            adapterType: string;
-            source: RunJournalRecord['source'];
-            result: AgentRecoveryResult['result'];
-            attempts: number;
-            durationMs: number;
-            reason?: string;
-        }) => void;
-        maxAttempts?: number;
-    });
-    recoverAll(): Promise<void>;
-    completeFromProvider(sessionId: string, runId: string): void;
-    private recoverOne;
-    private finishTerminal;
-}

package/dist/src/session/run-recovery/journal.d.ts

@@ -1,30 +0,0 @@
-import { type RunJournalRecord } from './schema.js';
-type JournalInput = Omit<RunJournalRecord, 'schemaVersion' | 'lastObservedEventSeq' | 'phase' | 'upgradeJobId' | 'interruptionReason' | 'continueDispatchState' | 'recoveryAttempts' | 'createdAt' | 'updatedAt' | 'recoveryReason' | 'deliveryMode' | 'externalRunId'>;
-export type RunJournalLoadResult = {
-    records: RunJournalRecord[];
-    quarantined: string[];
-};
-export declare class ActiveRunJournal {
-    readonly daemonInstallationId: string;
-    readonly directory: string;
-    readonly quarantineDirectory: string;
-    constructor(daemonInstallationId: string, options?: {
-        directory?: string;
-    });
-    begin(input: JournalInput): RunJournalRecord;
-    update(sessionId: string, runId: string, patch: Partial<Omit<RunJournalRecord, 'schemaVersion' | 'daemonInstallationId' | 'sessionId' | 'runId' | 'createdAt'>>): RunJournalRecord | null;
-    get(sessionId: string, runId: string): RunJournalRecord | null;
-    loadRecoverable(): RunJournalLoadResult;
-    /** Records that still require either provider recovery or terminal cleanup. */
-    loadPendingReconciliation(): RunJournalLoadResult;
-    private load;
-    markPlannedUpgrade(upgradeJobId: string): number;
-    markAborted(sessionId: string, runId: string): void;
-    markSessionAborted(sessionId: string): number;
-    remove(sessionId: string, runId: string): void;
-    sync(): void;
-    private recordPath;
-    private write;
-    private quarantine;
-}
-export {};

package/dist/src/session/run-recovery/schema.d.ts

@@ -1,48 +0,0 @@
-import { type AgentType, type SessionMode } from '@shennian/wire';
-export declare const RUN_JOURNAL_SCHEMA_VERSION: 1;
-export declare const RECOVERY_CONTINUE_TEXT: "Continue.";
-export type RunJournalPhase = 'dispatching' | 'running' | 'waiting_approval' | 'recovering' | 'terminal' | 'interrupted_by_upgrade' | 'recovery_failed' | 'aborted';
-export type RunRecoverySource = 'personal' | 'managed_room' | 'managed_direct' | 'manager_event' | 'manager_worker';
-export type ContinueDispatchState = 'none' | 'intent' | 'accepted';
-export type RunDeliveryMode = 'direct' | 'external_owner_queue';
-export type RunJournalRecord = {
-    schemaVersion: typeof RUN_JOURNAL_SCHEMA_VERSION;
-    daemonInstallationId: string;
-    sessionId: string;
-    runId: string;
-    clientMessageId: string;
-    agentType: AgentType;
-    sessionMode: SessionMode;
-    workDir: string;
-    agentSessionId: string | null;
-    modelId: string | null;
-    reasoningEffort: string | null;
-    nativeSessionVisibility: 'user' | 'internal';
-    providerRunId: string | null;
-    lastObservedEventSeq: number;
-    phase: RunJournalPhase;
-    source: RunRecoverySource;
-    parentSessionId: string | null;
-    /** Public Skill workers use the host's normal full-access provider policy. */
-    managerWorkerNativeFull?: boolean;
-    roomContextRegistryKey: string | null;
-    activationCauseMessageId: string | null;
-    rootCauseMessageId: string | null;
-    activationSequence: string | null;
-    activationHopCount: number | null;
-    managedPolicyVersion?: string | null;
-    managedRuntimePolicyHash?: string | null;
-    upgradeJobId: string | null;
-    interruptionReason: 'daemon_crash' | 'planned_upgrade' | 'os_restart' | null;
-    continueDispatchState: ContinueDispatchState;
-    deliveryMode: RunDeliveryMode;
-    externalRunId: string | null;
-    recoveryAttempts: number;
-    /** Non-sensitive stable reason used to replay a pending terminal commit. */
-    recoveryReason?: string | null;
-    createdAt: string;
-    updatedAt: string;
-};
-/** Strict parsing keeps corrupt or future records out of the recovery path. */
-export declare function parseRunJournalRecord(value: unknown): RunJournalRecord;
-export declare function isRecoverableJournalPhase(phase: RunJournalPhase): boolean;

package/dist/src/session/store.d.ts

@@ -1,128 +0,0 @@
-import { type AgentType, type Envelope, type ManagerConfig, type SessionDeliveryState, type SessionIndexUpdate, type SessionMessageStatusResponse, type SessionMode, type SessionTitleGenerateResponse, type SessionTitleGenerationEligibility, type SessionTitleSource } from '@shennian/wire';
-import { getDaemonInstallationId } from '../personal-sync/identity.js';
-import { PERSONAL_SYNC_V1_ROOT_NAME } from '../personal-sync/paths.js';
-import { CanonicalSessionStore } from './canonical-store.js';
-export { PERSONAL_SYNC_V1_ROOT_NAME };
-export type LocalSessionRecord = {
-    daemonInstallationId: string;
-    sessionId: string;
-    agentType: AgentType;
-    sessionMode?: SessionMode;
-    nativeSessionVisibility?: 'user' | 'internal';
-    managerConfig?: ManagerConfig | null;
-    workDir: string;
-    agentSessionId?: string | null;
-    modelId?: string | null;
-    managerDefaultWorkerAgentType?: AgentType | null;
-    managerDefaultWorkerModelId?: string | null;
-    status?: 'active' | 'completed' | 'failed';
-    createdAt: string;
-    updatedAt: string;
-    lastActivityAt: string;
-    lastMessagePreview?: string | null;
-    lastMessagePreviewMessageId: string | null;
-    lastMessagePreviewAt: string | null;
-    lastVisibleEventAt?: string | null;
-    localReady: boolean;
-    firstUserMessageId: string | null;
-    firstUserBodyRevision: number | null;
-    bodyRevision: number;
-    indexRevision: number;
-    title: string;
-    titleSource: SessionTitleSource;
-    titleRevision: number;
-    titleLockedByUser: boolean;
-    titleOriginEventId: string | null;
-    firstAvailableSeq: number | null;
-    visibleMessageCount: number;
-    lastVisibleMessageId: string | null;
-    attentionCount: number;
-    lastAttentionId: string | null;
-    /** Local-only replay ledger. This field is never included in SessionIndexUpdate. */
-    seenAttentionIds?: string[];
-    lastBodyCommittedAt: string | null;
-    deletionRevision: number;
-    deletedAt: string | null;
-    syncedIndexRevision: number;
-    indexSyncState?: 'pending' | 'applied' | 'quarantined' | 'terminal';
-    indexSyncStateRevision?: number;
-    indexSyncAttempts?: number;
-    indexSyncNextAttemptAt?: string | null;
-    indexSyncErrorCode?: string | null;
-    indexQuarantineCode?: string | null;
-    /** Local attempt marker only. The ephemeral titleSeed is never stored. */
-    titleGenerationAttemptedAt: string | null;
-    /** Local retry schedule for a request that did not produce a title. */
-    titleGenerationNextAttemptAt?: string | null;
-    titleGenerationAttempts?: number;
-};
-export { getDaemonInstallationId };
-export declare function recordSession(input: {
-    sessionId: string;
-    agentType: AgentType;
-    sessionMode?: SessionMode;
-    nativeSessionVisibility?: 'user' | 'internal';
-    managerConfig?: ManagerConfig | null;
-    workDir: string;
-    agentSessionId?: string | null;
-    modelId?: string | null;
-    managerDefaultWorkerAgentType?: AgentType | null;
-    managerDefaultWorkerModelId?: string | null;
-    status?: 'active' | 'completed' | 'failed';
-    lastActivityAt?: string;
-    lastMessagePreview?: string | null;
-    lastMessagePreviewMessageId?: string | null;
-    lastMessagePreviewAt?: string | null;
-    lastVisibleEventAt?: string | null;
-    localReady?: boolean;
-    firstUserMessageId?: string | null;
-    firstUserBodyRevision?: number | null;
-    title?: string;
-    titleSource?: SessionTitleSource;
-    titleRevision?: number;
-    titleLockedByUser?: boolean;
-    titleOriginEventId?: string | null;
-    /** Stable terminal/approval identity; a repeated identity is idempotent. */
-    attentionId?: string | null;
-    deletedAt?: string | null;
-}): LocalSessionRecord;
-export declare function listSessionRecords(): LocalSessionRecord[];
-export declare function purgeSessionRecord(sessionId: string): void;
-export declare function purgeCanonicalSession(sessionId: string): void;
-export declare function listPendingSessionIndexUpdates(): SessionIndexUpdate[];
-export declare function acknowledgeSessionIndexUpdate(sessionId: string, indexRevision: number): void;
-export declare function markAllSessionIndexesForRepublish(): number;
-export declare function recordSessionIndexRejection(input: {
-    sessionId: string;
-    indexRevision: number;
-    code: string;
-    disposition: 'retry' | 'quarantined' | 'terminal';
-    now?: number;
-    maxAttempts?: number;
-}): 'retry' | 'quarantined' | 'terminal';
-export type SessionTitleGenerationCandidate = {
-    sessionId: string;
-    requestId: string;
-    titleSeed: string;
-    baseTitleRevision: number;
-    eligibility: SessionTitleGenerationEligibility;
-};
-/**
- * Claims each fallback at most once. Only the durable attempt timestamp is
- * written; the bounded seed returned to the caller never enters local JSON.
- */
-export declare function claimSessionTitleGenerationCandidates(nowMs?: number, graceMs?: number): SessionTitleGenerationCandidate[];
-export declare function deferSessionTitleGeneration(sessionId: string, nowMs?: number): string | null;
-export declare function applyGeneratedSessionTitle(sessionId: string, result: Extract<SessionTitleGenerateResponse, {
-    generated: true;
-}>): boolean;
-export declare function appendMessage(sessionId: string, envelope: Envelope, deliveryState?: SessionDeliveryState): number;
-export declare function upsertMessage(sessionId: string, envelope: Envelope, deliveryState?: SessionDeliveryState): number;
-export declare function getMessageDeliveryStatus(sessionId: string, clientMessageId: string): SessionMessageStatusResponse;
-export declare function tombstoneMessage(sessionId: string, messageId: string): number;
-export declare function readMessages(sessionId: string, opts?: {
-    limit?: number;
-    before?: number;
-}): Envelope[];
-export declare function listSessions(): string[];
-export declare function getCanonicalSessionStore(): CanonicalSessionStore;

package/dist/src/session/tool-detail-store.d.ts

@@ -1,17 +0,0 @@
-import type { ToolDetailRef } from '@shennian/wire';
-export type LocalToolDetail = {
-    schemaVersion: 1;
-    sessionId: string;
-    toolCallId: string;
-    detailRevision: number;
-    ts: number;
-    name: string;
-    args?: unknown;
-    result?: unknown;
-    status: 'running' | 'completed' | 'failed';
-    durationMs?: number;
-    detailRef: ToolDetailRef;
-};
-export declare function writeToolDetail(detail: Omit<LocalToolDetail, 'schemaVersion'>): void;
-export declare function readToolDetail(sessionId: string, toolCallId: string): LocalToolDetail | null;
-export declare function purgeToolDetails(sessionId: string): void;

package/dist/src/session/turn-trigger.d.ts

@@ -1,43 +0,0 @@
-import type { ManagedWorkerRoomOrigin } from '../manager/registry.js';
-export type ManagedRoomTriggerContext = {
-    registryKey: string;
-    causeMessageId: string;
-    rootCauseMessageId: string;
-    sequence: string;
-    hopCount: number;
-};
-export type TurnTrigger = {
-    kind: 'scheduled';
-    taskId: string;
-    bindingId?: string;
-    roomId?: string;
-} | {
-    kind: 'personal';
-} | {
-    kind: 'managed_direct';
-} | ({
-    kind: 'room_activation';
-} & ManagedRoomTriggerContext) | {
-    kind: 'manager_event';
-    eventId: string;
-    roomOrigin?: ManagedWorkerRoomOrigin;
-} | {
-    kind: 'manager_worker';
-    parentSessionId: string;
-    roomOrigin?: ManagedWorkerRoomOrigin;
-};
-export type RecoveryAuthority = {
-    kind: 'personal';
-} | {
-    kind: 'managed_direct';
-} | ({
-    kind: 'room_activation';
-} & ManagedRoomTriggerContext) | {
-    kind: 'manager_event';
-    eventId: string;
-    roomOrigin?: ManagedWorkerRoomOrigin;
-} | {
-    kind: 'manager_worker';
-    parentSessionId: string;
-    roomOrigin?: ManagedWorkerRoomOrigin;
-};

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

@@ -1,93 +0,0 @@
-import type { AgentType, ExternalChannelSessionStatus, SessionMode, SessionRunPhase } from '@shennian/wire';
-import type { AgentAdapter } from '../agents/adapter.js';
-import type { CliRelayClient } from '../relay/client.js';
-import type { NativeSessionFusionService } from '../native-fusion/service.js';
-import type { ManagerRuntimeService } from '../manager/runtime.js';
-import type { ResolveAuthorizedPathResult } from '../fs/boundary.js';
-import type { ManagedRoomExecutor } from '../room/managed-room-ipc.js';
-import type { ActiveRunJournal } from './run-recovery/journal.js';
-import type { RunRecoveryBarrier } from './run-recovery/barrier.js';
-import type { RunJournalRecord } from './run-recovery/schema.js';
-import type { PreparedManagedRoomTurn } from './queue.js';
-export type ActiveSession = {
-    adapter: AgentAdapter;
-    workDir: string;
-    agentType: AgentType;
-    sessionMode?: SessionMode;
-    nativeSessionVisibility?: 'user' | 'internal';
-    agentSessionId: string | null;
-    lastActiveAt: number;
-    currentRunId: string | null;
-    currentRunPhase: SessionRunPhase | null;
-    nextEventSeq: number;
-    heartbeatSeq: number;
-    heartbeatTimer: ReturnType<typeof setInterval> | null;
-    pendingTextEvent: {
-        runId: string;
-        seq: number;
-        text: string;
-        thinking: boolean;
-    } | null;
-    externalChannel?: ExternalChannelSessionStatus | null;
-    externalChannelEnv?: NodeJS.ProcessEnv;
-    externalReplyTarget?: string | null;
-    /** Opaque per-turn Room capability; revoked and cleared on every terminal path. */
-    managedRoomContextToken?: string | null;
-    /** Stable Shennian recovery identity; provider run ids are stored separately. */
-    journalRunId?: string | null;
-};
-export type PendingTransfer = {
-    transferId: string;
-    rootPath: string;
-    lastActivityAt: number;
-};
-export type ChatQueueService = {
-    handleEnqueue(req: import('@shennian/wire').ReqFrame): Promise<boolean>;
-    handleGet(req: import('@shennian/wire').ReqFrame): Promise<void>;
-    handleEdit(req: import('@shennian/wire').ReqFrame): Promise<void>;
-    handleDelete(req: import('@shennian/wire').ReqFrame): Promise<void>;
-    handlePromote(req: import('@shennian/wire').ReqFrame): Promise<void>;
-    noteExternalClaim(sessionId: string, canonicalMessageId: string): void;
-    noteTerminal(sessionId: string): void;
-    purgeSession(sessionId: string): void;
-    getSnapshot(sessionId: string): import('@shennian/wire').ChatQueueSnapshot;
-};
-export type SessionActivityPublisher = {
-    publish(sessionId: string, activity: import('@shennian/wire').SessionActivitySnapshot | null): void;
-};
-export type UpgradePolicyController = {
-    setPolicy(policy: 'none' | 'patch'): void;
-    getPolicy(): 'none' | 'patch';
-};
-export type RemoteAccessPauseController = {
-    prepare(): {
-        disabledAt: string;
-        autoStartDisabled: boolean;
-        autoStartError?: string;
-    };
-    isDisabled(): boolean;
-    shutdownAfterResponse(): void;
-};
-export type SessionManagerRuntime = {
-    client: CliRelayClient;
-    pendingTransfers: Map<string, PendingTransfer>;
-    processedReqIds: Set<string>;
-    reloadCustomAgents: () => void;
-    resolvePath: (pathValue: string) => string;
-    resolveAuthorizedPath: (pathValue: string, rootPath: string) => ResolveAuthorizedPathResult;
-    resolveAuthorizedPathAsync: (pathValue: string, rootPath: string) => Promise<ResolveAuthorizedPathResult>;
-    runTextAcc: Map<string, string>;
-    sessions: Map<string, ActiveSession>;
-    evictIdleSessions: () => void;
-    nativeFusion: NativeSessionFusionService | null;
-    managerRuntime: ManagerRuntimeService | null;
-    chatQueue: ChatQueueService | null;
-    activityPublisher?: SessionActivityPublisher | null;
-    upgradePolicyController?: UpgradePolicyController | null;
-    revokeManagedRoomContextToken?: ((token: string) => void) | null;
-    managedRoomExecutor?: ManagedRoomExecutor | null;
-    runJournal?: ActiveRunJournal | null;
-    recoveryBarrier?: RunRecoveryBarrier | null;
-    /** Rebuilds short-lived Room authority from current server state after restart. */
-    prepareManagedRecovery?: (record: RunJournalRecord) => Promise<PreparedManagedRoomTurn | null>;
-};

package/dist/src/tools/markdown-to-pdf.d.ts

@@ -1,42 +0,0 @@
-export declare const MARKDOWN_PDF_SKILL_ID = "markdown-to-pdf";
-export declare const MARKDOWN_PDF_BROWSER_DOCTOR_ID = "markdownPdf.browser";
-export declare const MARKDOWN_PDF_MANAGED_CHROMIUM_ACTION_ID = "markdownPdf.installManagedChromium";
-export declare const MARKDOWN_PDF_SETUP_REQUIRED_CODE = "SKILL_SETUP_REQUIRED";
-export declare const PLAYWRIGHT_VERSION_FOR_MANAGED_CHROMIUM = "1.59.1";
-export type MarkdownPdfSetupRequiredPayload = {
-    code: typeof MARKDOWN_PDF_SETUP_REQUIRED_CODE;
-    skillId: typeof MARKDOWN_PDF_SKILL_ID;
-    doctorId: typeof MARKDOWN_PDF_BROWSER_DOCTOR_ID;
-    recommendedRepairActionId: typeof MARKDOWN_PDF_MANAGED_CHROMIUM_ACTION_ID;
-};
-export declare function markdownPdfSetupRequiredPayload(): MarkdownPdfSetupRequiredPayload;
-export declare class MarkdownPdfBrowserMissingError extends Error {
-    readonly code = "SKILL_SETUP_REQUIRED";
-    readonly setup: MarkdownPdfSetupRequiredPayload;
-    constructor(message?: string);
-}
-export type MarkdownToPdfOptions = {
-    outputPath?: string;
-    title?: string;
-    keepHtml?: boolean;
-    chromePath?: string;
-};
-export type MarkdownToPdfResult = {
-    inputPath: string;
-    outputPath: string;
-    htmlPath: string | null;
-    browserPath: string;
-};
-export declare function defaultPdfOutputPath(inputPath: string): string;
-export declare function renderMarkdownBody(markdown: string, sourceDir?: string): string;
-export declare function renderMarkdownHtml(markdown: string, options?: {
-    title?: string;
-    sourceDir?: string;
-}): string;
-export declare function managedChromiumBrowsersPath(): string;
-export declare function findChromiumExecutable(explicitPath?: string): Promise<string>;
-export declare function installManagedChromium(): Promise<{
-    browsersPath: string;
-    output: string;
-}>;
-export declare function convertMarkdownToPdf(inputPath: string, options?: MarkdownToPdfOptions): Promise<MarkdownToPdfResult>;

package/dist/src/upgrade/channel.d.ts

@@ -1,5 +0,0 @@
-export type UpgradeChannel = 'stable' | 'preview';
-/** Separate from identity config: selecting a channel must never rewrite pairing data. */
-export declare function getUpgradeChannel(): UpgradeChannel;
-export declare function setUpgradeChannel(channel: string): void;
-export declare function getUpgradeDistTag(): 'latest' | 'next';

package/dist/src/upgrade/distribution.d.ts

@@ -1,21 +0,0 @@
-import { type UpgradeChannel } from './channel.js';
-export type CliDistribution = {
-    schemaVersion: 1;
-    channel: UpgradeChannel;
-    version: string;
-    artifact: {
-        url: string;
-        size: number;
-        integrity: string;
-    };
-};
-export type CliUpdateSourceOrder = 'npm-first' | 'oss-first';
-export declare function getCliUpdateSourceOrder(value?: string | undefined): CliUpdateSourceOrder;
-export declare function parseCliDistribution(value: unknown, channel: UpgradeChannel): CliDistribution;
-export declare function fetchCliDistribution(options?: {
-    baseUrl?: string;
-    channel?: UpgradeChannel;
-    machineToken?: string;
-    timeoutMs?: number;
-}): Promise<CliDistribution>;
-export declare function fetchOwnedCliArtifact(version: string): Promise<CliDistribution['artifact'] | null>;

package/dist/src/upgrade/engine.d.ts

@@ -1,104 +0,0 @@
-export type UpgradeProgress = {
-    step: 'checking';
-} | {
-    step: 'backing-up';
-} | {
-    step: 'installing';
-    version: string;
-} | {
-    step: 'verifying';
-    version: string;
-} | {
-    step: 'restarting';
-    from: string;
-    to: string;
-} | {
-    step: 'done';
-    from: string;
-    to: string;
-};
-export type UpgradeResult = {
-    ok: true;
-    from: string;
-    to: string;
-} | {
-    ok: false;
-    error: string;
-    rolledBack?: boolean;
-};
-export type UpgradeAttempt = {
-    from: string;
-    to: string;
-    attemptCount: number;
-    attemptAt: number;
-    jobId?: string;
-    operation?: 'upgrade' | 'rollback';
-};
-export type UpgradeFailureRecord = {
-    version: string;
-    failureCount: number;
-    firstFailedAt: number;
-    lastFailedAt: number;
-    nextRetryAt: number;
-    error: string;
-};
-export type UpgradeFailures = {
-    versions: Record<string, UpgradeFailureRecord>;
-};
-export declare function getCurrentVersion(): string;
-export declare function findPackageJson(startFilePath?: string): string | null;
-export declare function fetchLatestVersion(): Promise<string>;
-/**
- * Compare semver strings. Returns:
- *   'none'  — same or older
- *   'patch' — only patch differs
- *   'minor' — minor or patch differs
- *   'major' — major differs
- */
-export declare function compareVersions(current: string, latest: string): 'none' | 'patch' | 'minor' | 'major';
-export declare function resolveNpmGlobalPrefixFromPackageJson(packageJsonPath: string, platform?: NodeJS.Platform): string | null;
-export declare function readUpgradeAttempt(): UpgradeAttempt | null;
-export declare function writeUpgradeAttempt(attempt: UpgradeAttempt): void;
-export declare function clearUpgradeAttempt(): void;
-export type UpgradeLock = {
-    release(): void;
-};
-export declare function acquireUpgradeLock(filePath?: string, opts?: {
-    now?: number;
-    pid?: number;
-    isProcessAlive?: (pid: number) => boolean;
-}): UpgradeLock;
-export declare function readUpgradeFailures(filePath?: string): UpgradeFailures;
-export declare function getUpgradeRetryDelayMs(failureCount: number): number;
-export declare function isUpgradeVersionInCooldown(version: string, now?: number, failures?: UpgradeFailures): boolean;
-export declare function recordUpgradeFailure(version: string, error: string, now?: number): UpgradeFailureRecord;
-export declare function clearUpgradeFailure(version: string): void;
-/**
- * Called on daemon startup. Detects crash loops from a failed upgrade and
- * requests an external rollback if crash count exceeds threshold.
- * Package replacement remains owned by the npm-package-independent Updater.
- */
-export declare function handleStartupCrashCheck(): Promise<UpgradeAttempt | null>;
-export declare function performUpgrade(targetVersion: string, onProgress: (p: UpgradeProgress) => void, opts?: {
-    currentVersion?: string;
-}): Promise<UpgradeResult>;
-export declare function npmExecOptionsForPlatform(platform: NodeJS.Platform, timeout: number): {
-    timeout: number;
-    windowsHide: boolean;
-    shell: boolean;
-};
-export declare function installShennianVersion(targetVersion: string): Promise<void>;
-export declare function verifyInstalledVersion(targetVersion: string): Promise<void>;
-export declare function rollbackToExactVersion(version: string, deps?: {
-    install?: (version: string) => Promise<void>;
-    verify?: (version: string) => Promise<void>;
-}): Promise<void>;
-export type VersionCheckResult = {
-    hasUpdate: false;
-} | {
-    hasUpdate: true;
-    current: string;
-    latest: string;
-    changeType: 'patch' | 'minor' | 'major';
-};
-export declare function checkForUpdate(currentVersion?: string): Promise<VersionCheckResult>;

package/dist/src/upgrade/scheduler.d.ts

@@ -1,60 +0,0 @@
-import type { RuntimeAutoUpgradePolicy } from '../config/index.js';
-import { type VersionCheckResult } from './engine.js';
-export type UpgradeIdleState = {
-    idle: boolean;
-    reasons: string[];
-};
-export type CliReleasePolicy = {
-    automaticPatchEnabled: boolean;
-    rolloutPercentage: number;
-    pausedVersions: string[];
-    blockedVersions: string[];
-    blockedCurrentVersions: string[];
-    killSwitch: boolean;
-    releaseLevel: 'normal' | 'required' | 'blocked';
-    /** Legacy wire field; normal updates now wait for idle without a deadline. */
-    maxIdleWaitMs: number;
-    minimumSessionSyncProtocolVersion?: number;
-    minimumDataEpoch?: number;
-    requiredCapabilities: string[];
-    externalUpdaterEnabled: boolean;
-    minimumUpdaterProtocolVersion?: number;
-};
-type AutoUpgradeSchedulerDeps = {
-    currentVersion: string;
-    machineId: string;
-    serverUrl: string;
-    getIdleState: () => UpgradeIdleState;
-    startUpgrade: (targetVersion: string, mandatory?: boolean) => Promise<void>;
-    checkForUpdate?: (currentVersion?: string) => Promise<VersionCheckResult>;
-    fetchReleasePolicy?: () => Promise<CliReleasePolicy>;
-    inCooldown?: (version: string) => boolean;
-    initialDelayMs?: number;
-    intervalMs?: number;
-    setTimeout?: (handler: () => void, delayMs: number) => ReturnType<typeof setTimeout>;
-    clearTimeout?: (timer: ReturnType<typeof setTimeout>) => void;
-    random?: () => number;
-    sessionSyncProtocolVersion?: number;
-    dataEpoch?: number;
-    advertisedCapabilities?: readonly string[];
-    updaterProtocolVersion?: number;
-};
-export declare function deterministicRolloutBucket(machineId: string): number;
-export declare function isAutomaticPatchAllowed(policy: CliReleasePolicy, machineId: string, currentVersion: string, targetVersion: string): boolean;
-export declare function fetchCliReleasePolicy(serverUrl: string): Promise<CliReleasePolicy>;
-export declare class AutoUpgradeScheduler {
-    private deps;
-    private policy;
-    private timer;
-    private started;
-    private upgradeInFlight;
-    constructor(deps: AutoUpgradeSchedulerDeps);
-    start(): void;
-    stop(): void;
-    setPolicy(policy: RuntimeAutoUpgradePolicy): void;
-    getPolicy(): RuntimeAutoUpgradePolicy;
-    runOnce(): Promise<void>;
-    private nextIntervalMs;
-    private arm;
-}
-export {};