@swarm-agent/sdk 0.1.49 → 0.1.51

package/dist/websocket.js

@@ -165,7 +165,7 @@ export class SwarmWebSocketBridge {
             },
             onPermissionRemoved: permissionId => send({ type: 'permission_removed', permissionId }),
             onPermissionError: (error, permission) => send({ type: 'permission_error', permissionId: permission.id, error: error.message }),
-            onComplete: messages => send({ type: 'done', messages }),
+            onComplete: (messages, run) => send({ type: 'done', messages, run }),
             onError: error => {
                 send({ type: 'error', error: error.message });
                 if (this.activeWatches.get(ws)?.watch === watch) {

package/dist/workers.d.ts

@@ -25,6 +25,12 @@ export declare class SwarmWorkersNamespace {
      * Lists durable workers with pagination, lifecycle filters, and cursor support.
      */
     list(params?: ListWorkersParams): Promise<ListWorkersResult>;
+    /**
+     * Creates and activates the box's missing premade workers (Coder, Designer,
+     * Finder) and returns all three. Existing presets are returned unchanged.
+     * Presets are box-level: every job names its workspace.
+     */
+    ensurePresets(): Promise<WorkerRecord[]>;
     /**
      * Updates a worker's definition with an explicit expected revision for optimistic concurrency.
      * Body carries expected_revision only (no query params, no local_bindings).

package/dist/workers.js

@@ -39,6 +39,8 @@ export class SwarmWorkersNamespace {
             instructions: params.instructions,
             idempotency_key: params.idempotency_key.trim(),
         };
+        if (params.role !== undefined)
+            body.role = params.role;
         if (params.description !== undefined)
             body.description = params.description;
         if (params.requested_capabilities !== undefined)
@@ -132,6 +134,21 @@ export class SwarmWorkersNamespace {
             next_cursor: typeof res.data.next_cursor === 'string' && res.data.next_cursor.length > 0 ? res.data.next_cursor : undefined,
         };
     }
+    /**
+     * Creates and activates the box's missing premade workers (Coder, Designer,
+     * Finder) and returns all three. Existing presets are returned unchanged.
+     * Presets are box-level: every job names its workspace.
+     */
+    async ensurePresets() {
+        const res = await this.transport.request('/v3/workers:ensure-presets', {
+            method: 'POST',
+            body: {},
+        });
+        if (!res.data || typeof res.data !== 'object' || !Array.isArray(res.data.workers)) {
+            throw new SwarmValidationError('Malformed response envelope: expected workers array');
+        }
+        return res.data.workers;
+    }
     /**
      * Updates a worker's definition with an explicit expected revision for optimistic concurrency.
      * Body carries expected_revision only (no query params, no local_bindings).
@@ -151,6 +168,8 @@ export class SwarmWorkersNamespace {
         const body = {
             expected_revision: expectedRevision,
         };
+        if (params.role !== undefined)
+            body.role = params.role;
         if (params.name !== undefined)
             body.name = params.name;
         if (params.description !== undefined)
@@ -593,6 +612,10 @@ export class SwarmWorkersNamespace {
             body.input = params.input;
         if (params.idempotency_key)
             body.idempotency_key = params.idempotency_key.trim();
+        if (params.workspace_id && params.workspace_id.trim() !== '')
+            body.workspace_id = params.workspace_id.trim();
+        if (params.workspace_path && params.workspace_path.trim() !== '')
+            body.workspace_path = params.workspace_path.trim();
         const res = await this.transport.request(`/v3/workers/${encodeURIComponent(params.worker_id.trim())}/direct`, {
             method: 'POST',
             headers,
@@ -629,6 +652,10 @@ export class SwarmWorkersNamespace {
         }
         if (params.idempotency_key)
             body.idempotency_key = params.idempotency_key.trim();
+        if (params.workspace_id && params.workspace_id.trim() !== '')
+            body.workspace_id = params.workspace_id.trim();
+        if (params.workspace_path && params.workspace_path.trim() !== '')
+            body.workspace_path = params.workspace_path.trim();
         const res = await this.transport.request(`/v3/workers/${encodeURIComponent(params.worker_id.trim())}/test`, {
             method: 'POST',
             headers,

package/dist/workspaces.d.ts

@@ -4,12 +4,32 @@ export declare class SwarmWorkspacesNamespace {
     private transport;
     constructor(transport: SwarmTransport);
     createFolder(parent_path: string, name: string): Promise<WorkspaceFolder>;
+    /**
+     * Creates `parent_path/name` as a new, empty Git repository with one initial
+     * commit and registers it as a workspace, in one call. The daemon refuses a
+     * folder that already holds other content. Calling it again for a folder
+     * that is already registered returns that workspace.
+     */
+    create(body: {
+        parent_path: string;
+        name: string;
+        make_current?: boolean;
+    }): Promise<WorkspaceResolution>;
+    /**
+     * Registers an existing folder. A Git repository by default; with
+     * `context_only` any readable folder (a project source, never selected as the
+     * coding workspace), and with `require_existing_content` as well the daemon
+     * refuses empty folders, system/Swarm storage directories and folders inside
+     * an already registered workspace (for folders the person named).
+     */
     add(body: {
         path: string;
         name?: string;
         theme_id?: string;
         make_current?: boolean;
         confirm_committed_only?: boolean;
+        context_only?: boolean;
+        require_existing_content?: boolean;
     }): Promise<WorkspaceResolution>;
     inspectRepository(path: string): Promise<WorkspaceRepository>;
     setupRepository(path: string, expected_resolved_path: string): Promise<WorkspaceRepository>;

package/dist/workspaces.js

@@ -6,6 +6,30 @@ export class SwarmWorkspacesNamespace {
     async createFolder(parent_path, name) {
         return (await this.transport.request('/v1/workspace/folders/create', { method: 'POST', body: { parent_path, name } })).data.folder;
     }
+    /**
+     * Creates `parent_path/name` as a new, empty Git repository with one initial
+     * commit and registers it as a workspace, in one call. The daemon refuses a
+     * folder that already holds other content. Calling it again for a folder
+     * that is already registered returns that workspace.
+     */
+    async create(body) {
+        if (!/^[A-Za-z0-9][A-Za-z0-9_-]{0,62}$/.test(body.name)) {
+            throw new Error('Workspace name must be letters, digits, dashes and underscores (at most 63).');
+        }
+        const parent = body.parent_path.replace(/\/+$/, '');
+        if (!parent.startsWith('/'))
+            throw new Error('parent_path must be absolute.');
+        const path = `${parent}/${body.name}`;
+        await this.setupRepository(path, path);
+        return this.add({ path, name: body.name, make_current: body.make_current ?? false });
+    }
+    /**
+     * Registers an existing folder. A Git repository by default; with
+     * `context_only` any readable folder (a project source, never selected as the
+     * coding workspace), and with `require_existing_content` as well the daemon
+     * refuses empty folders, system/Swarm storage directories and folders inside
+     * an already registered workspace (for folders the person named).
+     */
     async add(body) {
         return (await this.transport.request('/v1/workspace/add', { method: 'POST', body })).data.workspace;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarm-agent/sdk",
-  "version": "0.1.49",
+  "version": "0.1.51",
   "description": "Official TypeScript SDK for Swarm local AI coding workspace",
   "type": "module",
   "main": "./dist/index.js",