mindwire 0.1.1 → 0.1.3

package/dist/target/container.d.ts

@@ -32,6 +32,8 @@ export interface ContainerHandle {
     containerId: string;
     /** The ephemeral host port the in-container daemon is published to, on the base machine's loopback. */
     hostPort: number;
+    /** Bearer token generated for the daemon in this container. */
+    token: string;
     /** Tear down: `docker rm -f` the container if we created it and `stopOnExit` is set. Idempotent. */
     stop(): Promise<void>;
 }

package/dist/target/docker.d.ts

@@ -36,8 +36,10 @@ export interface DockerConfig {
     docker?: DockerodeLike;
     /** How to reach the Docker engine (remote host / socket / TLS). Ignored when `docker` is passed. */
     engine?: DockerEngineOptions;
-    /** Create + own a container from this image. */
+    /** Create + own a container from this image. Defaults to the SDK-matched MindWire runtime image. */
     image?: string;
+    /** Image acquisition policy for a container MindWire creates. Defaults to pulling only when absent. */
+    pull?: "missing" | "always" | "never";
     /** Attach to an existing container (id or name) instead of creating one. */
     container?: string;
     /** Extra options merged into `createContainer` (native dockerode/Docker API fields). */
@@ -103,6 +105,10 @@ interface ContainerLike {
 }
 export interface DockerodeLike {
     getContainer(id: string): ContainerLike;
+    getImage(name: string): {
+        inspect(): Promise<unknown>;
+    };
+    pull(name: string): Promise<DuplexLike>;
     createContainer(opts: Record<string, unknown>): Promise<ContainerLike>;
 }
 /**

package/dist/target/host.d.ts

@@ -29,16 +29,23 @@ export interface EnsureDaemonConfig {
     agent: string;
     /** `AGENT_CWD` — working directory agents run in, inside the sandbox. */
     agentCwd: string;
-    /** Explicit path to a Linux `mindwired` to deploy (else resolved from the platform package). */
+    /**
+     * Explicit path to a Linux `mindwired` to deploy (else downloaded from the matching GitHub Release).
+     * `{arch}` is expanded to the destination architecture (`amd64` or `arm64`), allowing a development
+     * launcher to build both artifacts without guessing the sandbox architecture in advance.
+     */
     daemonBin?: string;
     /** Redeploy when the running daemon's version differs from `desiredVersion`. Off by default. */
     autoUpdate?: boolean;
+    /** Redeploy even when the reported version matches. Intended only for a locally built development daemon. */
+    forceDeploy?: boolean;
     /** Version to reconcile against. Defaults to {@link SDK_VERSION} (the bundled binary's version). */
     desiredVersion?: string;
     /** Destination label carried on every {@link EnsureEvent} (e.g. `"ssh"`/`"docker"`/`"oblien"`). */
     target?: string;
     /** Receives a step {@link EnsureEvent} at each phase. A throwing callback can't abort provisioning. */
     onLog?: (e: EnsureEvent) => void;
+    token?: string;
 }
 /**
  * A progress event emitted at each phase of the ensure cycle (and, one-shot, by the `local`/`remote`
@@ -54,7 +61,7 @@ export interface EnsureDaemonConfig {
  * `connect → install → provision → probe → (skip | upload → launch → ready)`.
  */
 export interface EnsureEvent {
-    phase: "connect" | "install" | "provision" | "probe" | "download" | "upload" | "launch" | "ready" | "skip" | "error";
+    phase: "connect" | "install" | "provision" | "pull" | "probe" | "download" | "upload" | "launch" | "ready" | "skip" | "error";
     /** Destination label, e.g. `"ssh"` / `"docker"` / `"oblien"` / `"local"` / `"remote"`. */
     target: string;
     /** Human-readable one-line status. */
@@ -70,10 +77,11 @@ export interface EnsureEvent {
 }
 /**
  * Make sure a healthy `mindwired` of the desired version is reachable at `127.0.0.1:<port>` inside the
- * sandbox, deploying it if absent (or redeploying if stale and `autoUpdate` is set). Idempotent: a
- * healthy, current daemon (e.g. an image that autostarts it, or a reused sandbox) is a no-op.
+ * sandbox, deploying it if absent (or redeploying if stale and `autoUpdate` is set). `forceDeploy`
+ * deliberately replaces even a version match for local source development. Otherwise a healthy,
+ * current daemon (e.g. an image that autostarts it, or a reused sandbox) is a no-op.
  */
-export declare function ensureDaemon(host: SandboxHost, cfg: EnsureDaemonConfig): Promise<void>;
+export declare function ensureDaemon(host: SandboxHost, cfg: EnsureDaemonConfig): Promise<string>;
 /**
  * Resolve a Linux `mindwired` on the host running the SDK: an explicit `daemonBin`, else download the
  * SDK-matched release binary, verify its checksum, and return its local cache path for upload.

package/dist/target/oblien.d.ts

@@ -19,10 +19,12 @@ export interface OblienConfig {
     agentCwd?: string;
     /** Loopback port the in-workspace daemon listens on. */
     port?: number;
-    /** Explicit path to a Linux `mindwired` to deploy (else resolved from the platform package). */
+    /** Explicit local Linux `mindwired` to deploy. `{arch}` expands to the workspace architecture. */
     daemonBin?: string;
     /** Redeploy the daemon when the running version differs from the SDK's bundled binary. Off by default. */
     autoUpdate?: boolean;
+    /** Replace even a healthy version match. Use only with a locally built development daemon. */
+    forceDeploy?: boolean;
     /** On `close()`, tear the workspace down (delete one we created / stop one we reused). */
     stopOnExit?: boolean;
     /** Image for a new workspace. Ideally one that already runs `mindwired` and ships the target agent CLI. */
@@ -37,6 +39,8 @@ export interface OblienConfig {
     memoryMb?: number;
     /** Disk (MB) for a new workspace. */
     diskMb?: number;
+    /** Called as soon as the workspace identity is known, before daemon installation begins. */
+    onWorkspace?: (workspaceId: string) => void | Promise<void>;
     /** Lifecycle: `temporary` (auto-reaped) or `permanent`. */
     mode?: "temporary" | "permanent";
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindwire",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "devDependencies": {
@@ -33,7 +33,7 @@
       "require": "./dist/index.cjs"
     }
   },
-  "description": "TypeScript SDK for the mindwire daemon — one client for every coding-agent harness (Claude Code, Codex, Copilot CLI, opencode).",
+  "description": "TypeScript SDK for the MindWire runtime — one client for every coding-agent harness (Claude Code, Codex, Grok Build, opencode).",
   "engines": {
     "node": ">=18"
   },
@@ -45,6 +45,7 @@
     "coding-agent",
     "claude-code",
     "codex",
+    "grok",
     "copilot",
     "opencode",
     "agent",
@@ -61,7 +62,6 @@
   "scripts": {
     "prepack": "bun run build",
     "build": "tsup && tsc --emitDeclarationOnly",
-    "build:daemon": "node scripts/build-daemon.mjs",
     "docs:api": "node scripts/gen-sdk-docs.mjs",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",