mindwire 0.1.50 → 0.1.51

package/dist/native-sessions.d.ts

@@ -0,0 +1,96 @@
+import type { AgentScoped, Mindwire } from "./client.js";
+import type { Attachment, Event, Part, RespondInput, UserInput } from "./types.js";
+/** Per-session permissions. Discovery support alone does not imply control. */
+export interface NativeSessionCapabilities {
+    status: boolean;
+    observe: boolean;
+    input: boolean;
+    interrupt: boolean;
+    respond: boolean;
+}
+export interface SessionActivity {
+    sessionId: string;
+    cwd: string;
+    owner: "native" | "none" | "unknown";
+    state: "running" | "waiting" | "idle" | "stopped" | "unavailable";
+    turnId?: string;
+    startedAt?: string;
+    reason?: string;
+    capabilities: NativeSessionCapabilities;
+}
+export interface NativeSessionSnapshot {
+    connectionId: string;
+    sequence: number;
+    turnId?: string;
+    activity: SessionActivity;
+    /** Recent native turn only. Use messages() for earlier history. */
+    parts: Part[] | null;
+    inputs: UserInput[] | null;
+    historyRequired?: boolean;
+    /** True when earlier or oversized items were omitted from this projection. */
+    partial?: boolean;
+    /** True only for a resume frame: retain your previous projection. */
+    replay?: boolean;
+}
+export interface NativeSessionEvent {
+    connectionId: string;
+    sequence: number;
+    turnId?: string;
+    activity?: SessionActivity;
+    event?: Event;
+    /** Starts a new live projection; older turns remain in native history. */
+    reset?: boolean;
+    historyChanged?: boolean;
+    partial?: boolean;
+}
+export type NativeSessionFrame = {
+    type: "snapshot" | "resume";
+    snapshot: NativeSessionSnapshot;
+} | {
+    type: "update";
+    update: NativeSessionEvent;
+};
+export interface NativeSessionAction {
+    /** Attachment epoch from events(). Never substitute a new epoch when retrying. */
+    connectionId: string;
+    /** Caller-generated idempotency key; retain it on retry. */
+    requestId: string;
+    kind: "input" | "interrupt" | "response";
+    /** Required for Stop; optional for sending into a specific still-running turn. */
+    expectedTurnId?: string;
+    text?: string;
+    /** Uploaded artifact references, local images, or durable workspace file paths. */
+    attachments?: Attachment[];
+    response?: RespondInput;
+}
+export interface NativeSessionReceipt {
+    requestId: string;
+    /** A response is submitted until the native server broadcasts its resolution. */
+    status: "accepted" | "submitted";
+    turnId?: string;
+}
+export interface NativeSessionWatchOptions extends AgentScoped {
+    /** `${connectionId}:${sequence}`; use only when retaining the corresponding UI state. */
+    cursor?: string;
+    signal?: AbortSignal;
+}
+/** Observe and, when supported, control the CLI session already running on the host.
+ * All calls use the existing authenticated Mindwire transport. No extra public port. */
+export declare class NativeSessionsApi {
+    private readonly client;
+    constructor(client: Mindwire);
+    private path;
+    /** A cheap, coalesced status lookup. Does not resume or launch a conversation. */
+    activity(chatId: string, options?: AgentScoped & {
+        signal?: AbortSignal;
+    }): Promise<SessionActivity>;
+    /** Breaking the loop detaches only this viewer. No automatic command resends.
+     * On a replacement snapshot, replace the live projection; on resume, retain it.
+     * Persist the cursor after applying each frame, then reuse it on reconnection. */
+    events(chatId: string, options?: NativeSessionWatchOptions): AsyncGenerator<NativeSessionFrame>;
+    /** Send, stop the exact turn, or answer a pending question. An unknown outcome
+     * requires checking the conversation; do not retry with a fresh requestId. */
+    action(chatId: string, action: NativeSessionAction, options?: AgentScoped & {
+        signal?: AbortSignal;
+    }): Promise<NativeSessionReceipt>;
+}

package/dist/types.d.ts

@@ -320,6 +320,8 @@ export interface CommandInvocation {
 }
 /** Per-agent feature matrix. The core switches on some fields; the client reads the rest as UI hints. */
 export interface Capabilities {
+    /** Static harness hint; check nativeSessions.activity() for this session's controls. */
+    nativeSession?: import("./native-sessions.js").NativeSessionCapabilities;
     protocol: Protocol;
     output: OutputMode;
     history: Support;
@@ -747,6 +749,8 @@ export interface UserInput {
     error?: string;
 }
 export interface Message {
+    /** Native turn identity for reconciling history with a native-session snapshot. */
+    nativeTurnId?: string;
     /** Explicit command selected by the user, when the native transcript or receipt identifies it. */
     command?: CommandInvocation;
     id: string;
@@ -1133,6 +1137,8 @@ export interface Health {
     terminalProtocolVersion?: number;
     turnRequestVersion?: number;
     queuedInputVersion?: number;
+    /** Live attachment to a native CLI owner without a competing harness process. */
+    nativeSessionVersion?: number;
     chatForkVersion?: number;
     /** Image-only input and image attachments retained in message history. */
     imageAttachmentsVersion?: number;

package/dist/workspace.d.ts

@@ -82,7 +82,8 @@ export interface GitOperationRequest {
     expectedHead?: string;
     /** restore_commit only: observed local branch name; omit for detached HEAD. */
     expectedBranch?: string;
-    /** Write-only, for network operations only. Never part of an operation snapshot. */
+    /** Write-only, for network operations and commit hooks (gitOperationsVersion >= 6).
+     * Never part of an operation snapshot; ordinary commits require no GitHub login. */
     auth?: ProjectAuth;
 }
 export interface GitOperation extends Omit<GitOperationRequest, "auth"> {
@@ -92,8 +93,9 @@ export interface GitOperation extends Omit<GitOperationRequest, "auth"> {
     status: "queued" | "running" | "cancelling" | "succeeded" | "failed" | "cancelled" | "interrupted";
     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_branch_changed" | "git_branch_in_use" | "git_branch_unmerged" | "git_restore_in_progress" | "git_restore_commit_unavailable" | "git_restore_local_files" | (string & {});
+    /** git_auth_required asks for GitHub access; refresh status before an explicit retry.
+     * git_identity_required asks for a name/email before a new commit intent. */
+    errorCode?: "git_auth_required" | "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;
@@ -345,7 +347,7 @@ export declare class GitAccessApi {
     run(projectId: string, operation: "fetch" | "pull" | "push", auth?: ProjectAuth): Promise<{
         output: string;
     }>;
-    /** Requires health.gitOperationsVersion >= 1 (>= 2 for switch/create, >= 4 for restore_commit, >= 5 for rename/delete). Acceptance persists before Git runs;
+    /** Requires health.gitOperationsVersion >= 1 (>= 2 for switch/create, >= 4 for restore_commit, >= 5 for rename/delete, >= 6 for commit auth). 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.50",
+  "version": "0.1.51",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "bin": {