mindwire 0.1.32 → 0.1.34

package/dist/project-sync.d.ts

@@ -0,0 +1,101 @@
+import type { Mindwire } from "./client.js";
+import { MindwireError } from "./errors.js";
+export interface ProjectSyncEntry {
+    kind: "file" | "directory" | "symlink";
+    mode: number;
+    size: number;
+    chunks?: string[];
+    link?: string;
+    jsonLines?: boolean;
+}
+export interface ProjectSyncCheckpoint {
+    id: string;
+    projectId: string;
+    parents: string[];
+    manifest: ProjectSyncEntry;
+    objectCount: number;
+    bytes: number;
+}
+export interface ProjectSyncRequest {
+    /** Durable idempotency key. Keep the same ID after a lost acknowledgement. */
+    id: string;
+    projectId?: string;
+    checkpointId?: string;
+    /** Only needed on first import; subsequent imports find the preserved replica. */
+    path?: string;
+}
+export interface ProjectSyncConflict {
+    path: string;
+    kind: "file" | "conversation" | "git" | "recovery";
+    message: string;
+}
+export interface ProjectSyncOperation extends ProjectSyncRequest {
+    kind: "export" | "import";
+    status: "queued" | "exporting" | "preparing" | "applying" | "succeeded" | "conflicts" | "failed" | "recovery_required";
+    phase: string;
+    progress: number;
+    resultProjectId?: string;
+    resultCheckpointId?: string;
+    recoveryCheckpointId?: string;
+    conflicts?: ProjectSyncConflict[];
+    error?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ProjectSyncProgress {
+    phase: "checkpoint" | "transfer" | "apply";
+    transferredBytes: number;
+    operation?: ProjectSyncOperation;
+}
+export declare class ProjectSyncError extends MindwireError {
+    readonly operation: ProjectSyncOperation;
+    constructor(operation: ProjectSyncOperation);
+}
+type Options = {
+    signal?: AbortSignal;
+};
+/** Shared checkpoint protocol over the existing authenticated workspace transport.
+ * No Git hosting service or third-party storage is involved. Native adapters in
+ * the daemon own export/import; clients only relay verified immutable chunks.
+ */
+export declare class ProjectSyncApi {
+    private readonly mw;
+    private readonly flights;
+    constructor(mw: Mindwire);
+    export(request: ProjectSyncRequest, options?: Options): Promise<ProjectSyncOperation>;
+    import(request: ProjectSyncRequest, options?: Options): Promise<ProjectSyncOperation>;
+    list(options?: Options): Promise<ProjectSyncOperation[]>;
+    get(id: string, options?: Options): Promise<ProjectSyncOperation>;
+    retry(id: string, options?: Options): Promise<ProjectSyncOperation>;
+    cancel(id: string): Promise<ProjectSyncOperation>;
+    checkpoint(id: string, options?: Options): Promise<ProjectSyncCheckpoint>;
+    acceptCheckpoint(checkpoint: ProjectSyncCheckpoint, options?: Options): Promise<ProjectSyncCheckpoint>;
+    objects(id: string, cursor?: number, options?: Options): Promise<{
+        objects: string[];
+        next?: number;
+    }>;
+    missing(objects: string[], options?: Options): Promise<string[]>;
+    /** Base64 chunk, at most 256 KiB before encoding. */
+    getObject(id: string, options?: Options): Promise<string>;
+    putObject(id: string, data: string, options?: Options): Promise<void>;
+    wait(id: string, options?: Options & {
+        onUpdate?: (operation: ProjectSyncOperation) => void;
+    }): Promise<ProjectSyncOperation>;
+    /** Repeating this relay skips acknowledged checkpoints and verified chunks.
+     * Aborting detaches the relay; daemon export/apply operations remain durable.
+     */
+    relayCheckpoint(target: ProjectSyncApi, id: string, options?: Options & {
+        onBytes?: (bytes: number) => void;
+    }): Promise<void>;
+    /** Safe X → Y and Y → X. Persist request.id until acknowledged. A conflict
+     * throws ProjectSyncError carrying the complete conflict/recovery operation.
+     */
+    switchTo(target: ProjectSyncApi, request: {
+        id: string;
+        projectId: string;
+        path?: string;
+    }, options?: Options & {
+        onProgress?: (progress: ProjectSyncProgress) => void;
+    }): Promise<ProjectSyncOperation>;
+}
+export {};

package/dist/types.d.ts

@@ -994,6 +994,8 @@ export interface Health {
     projectOperationsVersion?: number;
     /** Project-relative icons and authenticated image previews. */
     projectIconsVersion?: number;
+    /** Preserved workspace replicas, native chat checkpoints and recoverable three-way import. */
+    projectSyncVersion?: number;
     /** Workspace/project GitHub bindings and operation/run credential forwarding. */
     gitAccessVersion?: number;
     /** Durable Git writes: v2 adds branches; v3 adds repository-scoped commit author setup. */

package/dist/workspace.d.ts

@@ -1,4 +1,5 @@
 import type { Mindwire } from "./client.js";
+import { ProjectSyncApi } from "./project-sync.js";
 /** Write-only credentials. Never persisted in operation snapshots or conversation state. */
 export type ProjectAuth = ({
     kind: "token";
@@ -160,6 +161,8 @@ export interface WorkspaceAgent extends WorkspaceRecord {
     notificationsMuted?: boolean;
 }
 export interface WorkspaceProject extends WorkspaceRecord {
+    /** Logical project identity shared by preserved workspace copies. */
+    syncId?: string;
     name: string;
     path: string;
     repoUrl?: string;
@@ -177,6 +180,8 @@ export interface ProjectIcon {
 }
 /** Chat membership; transcript content continues to come from /chats/:id/messages. */
 export interface WorkspaceChat extends WorkspaceRecord {
+    /** Logical conversation identity; the local id remains unique per workspace. */
+    syncId?: string;
     agentId: string;
     projectId: string;
     title: string;
@@ -240,6 +245,7 @@ export declare class WorkspaceCollection<T extends WorkspaceRecord> {
 /** Workspace metadata is shared by all harnesses; withAgent() never scopes these requests. */
 export declare class WorkspaceApi {
     private readonly mw;
+    readonly sync: ProjectSyncApi;
     readonly git: GitAccessApi;
     readonly operations: ProjectOperationsApi;
     readonly agents: WorkspaceCollection<WorkspaceAgent>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindwire",
-  "version": "0.1.32",
+  "version": "0.1.34",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "bin": {