mindwire 0.1.30 → 0.1.33

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

@@ -992,6 +992,10 @@ export interface Health {
     workspaceMetadataVersion?: number;
     /** Durable project creation/clone operations; absent on older daemons. */
     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";
@@ -32,7 +33,7 @@ export interface ProjectGitState {
     stored: boolean;
     repoUrl?: string;
 }
-export type GitAction = "stage" | "unstage" | "discard" | "commit" | "fetch" | "pull" | "push" | "switch_branch" | "create_branch" | "restore_commit";
+export type GitAction = "stage" | "unstage" | "discard" | "commit" | "fetch" | "pull" | "push" | "switch_branch" | "create_branch" | "restore_commit" | "rename_branch" | "delete_branch";
 export interface GitIdentity {
     name: string;
     email: string;
@@ -61,10 +62,16 @@ export interface GitOperationRequest {
     paths?: string[];
     /** Required for commit. Uses the existing author unless identity is explicitly supplied. */
     message?: string;
-    /** Literal branch name for switch_branch/create_branch; requires gitOperationsVersion >= 2. */
+    /** Literal branch name: switch/create require v2; local rename/delete require v5 and expectedTip. */
     branch?: string;
     /** switch_branch only: branch is a remote tracking name, e.g. origin/feature. */
     remote?: boolean;
+    /** rename_branch only: a new local name. Never overwrites another branch. Requires v5. */
+    newName?: string;
+    /** rename_branch/delete_branch: full selected branch tip, guarding stale confirmation. Requires v5. */
+    expectedTip?: string;
+    /** delete_branch only: explicit confirmation to delete unmerged commits. Checked-out branches stay protected. */
+    force?: boolean;
     /** Commit only; requires gitOperationsVersion >= 3. Saves attribution in this repository,
      * then commits under the same durable lock. Never changes global Git configuration. */
     identity?: GitIdentity;
@@ -85,7 +92,7 @@ export interface GitOperation extends Omit<GitOperationRequest, "auth"> {
     output?: string;
     error?: string;
     /** git_identity_required asks the client to collect a name/email before a new commit intent. */
-    errorCode?: "git_identity_required" | "git_restore_dirty" | "git_restore_changed" | "git_restore_in_progress" | "git_restore_commit_unavailable" | "git_restore_local_files" | (string & {});
+    errorCode?: "git_identity_required" | "git_restore_dirty" | "git_restore_changed" | "git_branch_changed" | "git_branch_in_use" | "git_branch_unmerged" | "git_restore_in_progress" | "git_restore_commit_unavailable" | "git_restore_local_files" | (string & {});
     createdAt: string;
     updatedAt: string;
     sequence: number;
@@ -154,14 +161,27 @@ 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;
     /** Omit on edits to preserve; explicitly null restores the workspace default. */
     gitConnection?: GitConnection | null;
+    /** Project-relative SVG/PNG/JPEG/GIF file. Omit to preserve, null to reset. Requires projectIconsVersion >= 1. */
+    iconPath?: string | null;
+}
+export interface ProjectIcon {
+    path: string;
+    mediaType: string;
+    /** Base64-encoded bytes, capped at 1 MiB; served only through the authenticated workspace connection. */
+    content: string;
+    etag: string;
 }
 /** 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;
@@ -225,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>;
@@ -234,6 +255,8 @@ export declare class WorkspaceApi {
     snapshot(options?: {
         refresh?: boolean;
     }): Promise<WorkspaceSnapshot>;
+    /** Read the saved icon, or preview a candidate relative path within the project. Requires projectIconsVersion >= 1. */
+    projectIcon(projectId: string, path?: string): Promise<ProjectIcon>;
     /** Start an operation owned by the daemon. The same ID/payload returns the existing operation. */
     createProject(request: ProjectRequest): Promise<ProjectOperation>;
     /** Permanently remove the confirmed project's directory and membership.
@@ -273,7 +296,7 @@ export declare class GitAccessApi {
     run(projectId: string, operation: "fetch" | "pull" | "push", auth?: ProjectAuth): Promise<{
         output: string;
     }>;
-    /** Requires health.gitOperationsVersion >= 1 (>= 2 for branches, >= 4 for restore_commit). Acceptance persists before Git runs;
+    /** Requires health.gitOperationsVersion >= 1 (>= 2 for switch/create, >= 4 for restore_commit, >= 5 for rename/delete). Acceptance persists before Git runs;
      * disconnecting only detaches the client. The same ID/intent never runs twice.
      */
     start(projectId: string, request: GitOperationRequest): Promise<GitOperation>;

package/package.json

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