@dejima/sdk 0.8.68 → 0.8.70

package/dist/client.d.ts

@@ -32,8 +32,16 @@ export declare class Client {
     private island;
     /** All islands, most-recently-used first. */
     listIslands(): Promise<any[]>;
-    /** Provision an island. `repo` is a git URL or local path. */
-    createIsland(repo: string, opts?: {
+    /** Provision an island. `repo` is a git URL or local path.
+     *
+     * `noRepo` instead provisions an island with an empty `/workspace` and no
+     * origin — for the things that genuinely have no repo (assistant brains,
+     * headless task runners, scratch sandboxes). It requires `name` and refuses
+     * `repo`/`seedPath`: the daemon never infers the mode from an empty `repo`, so
+     * a URL eaten by the shell fails loudly instead of quietly producing an island
+     * indistinguishable from a failed clone. */
+    createIsland(repo?: string, opts?: {
+        noRepo?: boolean;
         agent?: string;
         name?: string;
         image?: string;
@@ -83,8 +91,11 @@ export declare class Client {
     getAgent(name: string, agentId: string): Promise<any>;
     /** Rename an agent's cosmetic label (`""` clears it). */
     updateAgent(name: string, agentId: string, label: string): Promise<any>;
-    /** Remove a non-primary agent (kills its session, prunes its worktree). */
-    removeAgent(name: string, agentId: string): Promise<void>;
+    /** Remove an agent (kills its session, prunes its worktree; the branch and its
+     * commits are kept). The daemon refuses with a 409 when that worktree holds
+     * uncommitted changes — pruning it discards them permanently — or when it
+     * can't check (island hibernated, container wedged); `force` removes anyway. */
+    removeAgent(name: string, agentId: string, force?: boolean): Promise<void>;
     /** Relaunch an agent in place so it picks up a changed environment (e.g. a new
      * secret). `resume` continues its previous conversation where supported. */
     restartAgent(name: string, agentId: string, opts?: {

package/dist/client.js

@@ -87,10 +87,18 @@ export class Client {
     listIslands() {
         return this.json("GET", "/v1/islands");
     }
-    /** Provision an island. `repo` is a git URL or local path. */
-    createIsland(repo, opts = {}) {
+    /** Provision an island. `repo` is a git URL or local path.
+     *
+     * `noRepo` instead provisions an island with an empty `/workspace` and no
+     * origin — for the things that genuinely have no repo (assistant brains,
+     * headless task runners, scratch sandboxes). It requires `name` and refuses
+     * `repo`/`seedPath`: the daemon never infers the mode from an empty `repo`, so
+     * a URL eaten by the shell fails loudly instead of quietly producing an island
+     * indistinguishable from a failed clone. */
+    createIsland(repo = "", opts = {}) {
         const body = clean({
             repo,
+            no_repo: opts.noRepo || undefined,
             agent: opts.agent,
             name: opts.name,
             image: opts.image,
@@ -170,9 +178,14 @@ export class Client {
     updateAgent(name, agentId, label) {
         return this.json("PATCH", `${this.island(name)}/agents/${this.seg(agentId)}`, { json: { label } });
     }
-    /** Remove a non-primary agent (kills its session, prunes its worktree). */
-    async removeAgent(name, agentId) {
-        await this.request("DELETE", `${this.island(name)}/agents/${this.seg(agentId)}`);
+    /** Remove an agent (kills its session, prunes its worktree; the branch and its
+     * commits are kept). The daemon refuses with a 409 when that worktree holds
+     * uncommitted changes — pruning it discards them permanently — or when it
+     * can't check (island hibernated, container wedged); `force` removes anyway. */
+    async removeAgent(name, agentId, force = false) {
+        await this.request("DELETE", `${this.island(name)}/agents/${this.seg(agentId)}`, {
+            query: force ? { force: true } : undefined,
+        });
     }
     /** Relaunch an agent in place so it picks up a changed environment (e.g. a new
      * secret). `resume` continues its previous conversation where supported. */

package/dist/index.d.ts

@@ -8,12 +8,22 @@
  * console.log(await dj.listIslands());
  * ```
  *
- * Alpha (0.x): fields may change until 1.0. The REST layer mirrors
- * `openapi.yaml`; the only hand-written ergonomic piece is the PTY `Session`.
+ * Alpha (0.x): fields may change until 1.0.
+ *
+ * THIS CLIENT IS HAND-WRITTEN, not generated. It is kept in step with
+ * `openapi.yaml` by hand, and it lags: methods return `any` rather than domain
+ * types, and a field documented in the spec does not reach you until someone
+ * adds it here. An earlier version of this comment said the REST layer
+ * "mirrors openapi.yaml", which reads as generated-and-therefore-current and
+ * is what a client author would reasonably rely on.
+ *
+ * If you want types, generate them from `openapi.yaml` directly — the spec is
+ * gated against the daemon on every commit (sdk/openapi_field_parity.py), so it
+ * is the trustworthy source. This client is not.
  */
 export { Client } from "./client.js";
 export type { ClientOptions } from "./client.js";
 export { Session } from "./session.js";
 export type { SessionEnvelope, WebSocketLike } from "./session.js";
 export { DejimaError } from "./errors.js";
-export declare const VERSION = "0.8.68";
+export declare const VERSION = "0.8.70";

package/dist/index.js

@@ -8,10 +8,20 @@
  * console.log(await dj.listIslands());
  * ```
  *
- * Alpha (0.x): fields may change until 1.0. The REST layer mirrors
- * `openapi.yaml`; the only hand-written ergonomic piece is the PTY `Session`.
+ * Alpha (0.x): fields may change until 1.0.
+ *
+ * THIS CLIENT IS HAND-WRITTEN, not generated. It is kept in step with
+ * `openapi.yaml` by hand, and it lags: methods return `any` rather than domain
+ * types, and a field documented in the spec does not reach you until someone
+ * adds it here. An earlier version of this comment said the REST layer
+ * "mirrors openapi.yaml", which reads as generated-and-therefore-current and
+ * is what a client author would reasonably rely on.
+ *
+ * If you want types, generate them from `openapi.yaml` directly — the spec is
+ * gated against the daemon on every commit (sdk/openapi_field_parity.py), so it
+ * is the trustworthy source. This client is not.
  */
 export { Client } from "./client.js";
 export { Session } from "./session.js";
 export { DejimaError } from "./errors.js";
-export const VERSION = "0.8.68";
+export const VERSION = "0.8.70";

package/dist/session.d.ts

@@ -1,7 +1,7 @@
 import { DejimaError } from "./errors.js";
 /** One PTY session envelope on the wire (see openapi.yaml `SessionEnvelope`). */
 export interface SessionEnvelope {
-    type: "hello" | "data" | "resize" | "error";
+    type: "hello" | "data" | "resize" | "error" | "exit";
     b64?: string;
     rows?: number;
     cols?: number;

package/dist/session.js

@@ -84,6 +84,13 @@ export class Session {
                 this.finish();
                 break;
             }
+            case "exit":
+                // The bridged terminal itself ended (a detach, an `exit`, a tmux that
+                // died on start) — end the session rather than waiting for the socket.
+                // Distinct from a transport drop on purpose: a caller that treats it as
+                // one reconnects forever, respawning a shell nobody can escape.
+                this.finish();
+                break;
         }
     }
     finish() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dejima/sdk",
-  "version": "0.8.68",
+  "version": "0.8.70",
   "description": "TypeScript/JavaScript client for the Dejima API — run a fleet of AI coding agents on hardware you own.",
   "license": "Apache-2.0",
   "type": "module",