@wrongstack/core 0.300.0 → 0.302.0

package/dist/storage/cloud-config-sync.d.ts

@@ -0,0 +1,87 @@
+export { applyNamespacePayload, buildNamespacePayloads, CLOUD_SYNC_CONTRACT, CLOUD_SYNC_NAMESPACES, LOCAL_ONLY_TOP_LEVEL, NAMESPACE_SCHEMA_VERSIONS, stripSecretMaterial, } from './cloud-config-sync/sanitize.js';
+/**
+ * CloudConfigSync — synchronizes the profile config with my.wrongstack.com over the
+ * namespaced sync API v1 (server repo: docs/CLIENT_SYNC_CONTRACT.md).
+ *
+ * Distinct from the legacy GitHub `CloudSync` (whole-file categories to a private repo)
+ * and from the local HQ command center: this speaks the portal's revisioned,
+ * schema-validated, secret-free namespace protocol.
+ *
+ * A sync pass is pull-then-push:
+ *   1. `GET /config?since=<cursor>` — apply changed namespaces at contract granularity
+ *      (locally-kept fields the contract does not own are never clobbered).
+ *   2. For each namespace whose projected payload hash differs from the last synced
+ *      hash: `PUT /config/<ns>` with `baseRevision` + a persisted `mutationId`, so a
+ *      crash-and-retry of the same logical change is idempotent server-side.
+ *   3. `POST /heartbeat` with the cursor and revision map for fleet observability.
+ *
+ * Conflicts (409) resolve by three-way merge at owned-top-level-key granularity: keys the
+ * local machine did not change since its last sync adopt the server value; keys it did
+ * change keep the local value and are re-pushed on top of the server revision.
+ */
+export interface CloudConfigSyncSettings {
+    enabled: boolean;
+    /** Portal base URL, e.g. https://my.wrongstack.com — no trailing slash needed. */
+    url: string;
+    /** Machine bearer token (wst_…), already decrypted. */
+    token: string;
+}
+export interface CloudConfigSyncDeps {
+    /** State file location, e.g. `<profileDir>/cloud-sync-state.json`. */
+    statePath: string;
+    /** Reads the decrypted profile config object (the file layer, not env/CLI merges). */
+    readLocalConfig(): Promise<Record<string, unknown>>;
+    /**
+     * Atomically mutates the profile config file. The mutator receives the decrypted
+     * object and returns the replacement; the writer re-encrypts secrets and persists.
+     */
+    writeLocalConfig(mutator: (config: Record<string, unknown>) => Record<string, unknown>): Promise<void>;
+    /** Resolved cloud-sync settings, or null when unconfigured/disabled. */
+    getSettings(): CloudConfigSyncSettings | null;
+    fetchImpl?: typeof fetch | undefined;
+    appVersion?: string | undefined;
+    logger?: {
+        info(msg: string): void;
+        warn(msg: string): void;
+    } | undefined;
+    randomUUID?: (() => string) | undefined;
+    /** Request timeout per HTTP call. Default 15s. */
+    requestTimeoutMs?: number | undefined;
+}
+export interface CloudSyncPassSummary {
+    ok: boolean;
+    skipped: boolean;
+    pulled: string[];
+    pushed: string[];
+    conflicted: string[];
+    rejected: string[];
+    message: string;
+}
+export declare class CloudConfigSync {
+    private readonly deps;
+    private state;
+    private readonly fetchImpl;
+    private readonly uuid;
+    private readonly timeoutMs;
+    constructor(deps: CloudConfigSyncDeps);
+    /** One full pull-then-push-then-heartbeat pass. Never throws; failures are summarized. */
+    syncOnce(): Promise<CloudSyncPassSummary>;
+    /** Human-readable status for the slash command. */
+    statusText(): Promise<string>;
+    private pullChanges;
+    private applySnapshot;
+    private dirtyNamespaces;
+    private pushDirty;
+    private putNamespace;
+    /**
+     * Three-way merge at owned-top-level-key granularity: keys unchanged locally since the
+     * last sync adopt the server value; locally-changed keys win and are re-pushed on top
+     * of the server revision with a fresh mutation id.
+     */
+    private resolveConflict;
+    private heartbeat;
+    private request;
+    private loadState;
+    private saveState;
+}
+//# sourceMappingURL=cloud-config-sync.d.ts.map

package/dist/storage/index.d.ts

@@ -20,7 +20,7 @@ export { ReplayLogStore, type ReplayEntry, type ReplayLogStoreOptions, } from '.
 export { SessionRecovery, type StaleSession, type RecoveryPlan, } from './session-recovery.js';
 export { ToolAuditLog, type AuditEntry, type ToolAuditLogOptions, type VerifyResult, } from './tool-audit-log.js';
 export { SessionAnalyzer } from './session-analyzer.js';
-export { SessionRegistry, getSessionRegistry, hasSessionRegistry, type SessionRegistryEntry, type AgentEntry, type AgentLiveStatus, type SessionLiveStatus, } from '../session-registry.js';
+export { SessionRegistry, getSessionRegistry, hasSessionRegistry, type SessionRegistryEntry, type SessionWebUIEndpointHint, type AgentEntry, type AgentLiveStatus, type SessionLiveStatus, } from '../session-registry.js';
 export { AgentStatusTracker, type AgentStatusTrackerOptions, } from '../agent-status-tracker.js';
 export { FleetNotifier, type FleetNotifierOptions, } from '../fleet-notifier.js';
 export { DefaultSessionRewinder, type SessionRewinderOptions, } from './session-rewinder.js';
@@ -38,6 +38,7 @@ export { DefaultPromptStore, migratePromptEntry, promptChecksum, type PromptStor
 export { PromptUsageStore, type PromptUsage } from './prompt-usage-store.js';
 export { InputHistoryStore, INPUT_HISTORY_DEFAULT_MAX, } from './input-history-store.js';
 export { CloudSync, type SyncResult, ALL_SYNC_CATEGORIES, } from './cloud-sync.js';
+export { applyNamespacePayload, buildNamespacePayloads, CLOUD_SYNC_CONTRACT, CLOUD_SYNC_NAMESPACES, CloudConfigSync, type CloudConfigSyncDeps, type CloudConfigSyncSettings, type CloudSyncPassSummary, LOCAL_ONLY_TOP_LEVEL, NAMESPACE_SCHEMA_VERSIONS, stripSecretMaterial, } from './cloud-config-sync.js';
 export { createSessionEventBridge, resolveAuditLevel, resolveSessionLoggingConfig, type SessionEventBridge, type AuditLevel, type SessionEventBridgeOptions, type SessionSamplingOptions, type ToolProgressSamplingOptions, CORE_RECONSTRUCT_EVENTS, STANDARD_AUDIT_EVENTS, } from './session-event-bridge.js';
 export type { SyncConfig, SyncCategory } from '../types/config.js';
 //# sourceMappingURL=index.d.ts.map