@swarm-agent/sdk 0.1.56 → 0.1.57

package/dist/job-automations.d.ts

@@ -181,6 +181,11 @@ export interface JobAutomation {
     revision: number;
     created_at: number;
     updated_at: number;
+    history_count?: number;
+    last_change?: {
+        time: number;
+        who: string;
+    };
     latest_deliveries?: JobDelivery[];
 }
 export interface SetJobAutomationParams {
@@ -307,6 +312,32 @@ export interface ListJobDeliveriesParams {
     /** Default 50, at most 200. */
     limit?: number;
 }
+export type WorkflowDefinition = Omit<SetJobAutomationParams, 'scope'> & {
+    swarm_workflow: 1;
+    scope: Omit<JobAutomationScope, 'folder'> & {
+        folder?: string;
+    };
+};
+export type WorkflowImportResult = {
+    automation: JobAutomation;
+    created: boolean;
+    unchanged?: boolean;
+} | {
+    files: {
+        path: string;
+        status: 'created' | 'updated' | 'unchanged' | 'refused';
+        error?: string;
+    }[];
+};
+export interface WorkflowHistoryRecord {
+    revision: number;
+    time: number;
+    kind: 'created' | 'updated' | 'deleted' | 'restored';
+    source: 'set' | 'import' | 'restore' | 'delete';
+    who: string;
+    changed_fields: string[];
+    deleted?: boolean;
+}
 /** Workflows and their deliveries (`/v3/workflows`, `/v3/job-deliveries`). */
 export declare class SwarmJobAutomationsNamespace {
     private readonly transport;
@@ -322,6 +353,40 @@ export declare class SwarmJobAutomationsNamespace {
         automation: JobAutomation;
         created: boolean;
     }>;
+    /** Export to .swarm/workflows, commit, and import on another machine. Empty path selects the default filename. */
+    exportWorkflow(params: {
+        name?: string;
+        id?: string;
+        path?: string;
+        overwrite?: boolean;
+    }): Promise<WorkflowDefinition>;
+    /** Import one definition/file or every *.json in a directory; run steps require a full key. */
+    importWorkflow(params: {
+        definition?: WorkflowDefinition;
+        path?: string;
+        project?: string;
+        workspace?: string;
+    }): Promise<WorkflowImportResult>;
+    /** Retained changes newest first, also for deleted workflows; a revision returns portable JSON. */
+    history(params: {
+        name?: string;
+        id?: string;
+        revision?: number;
+    }): Promise<{
+        history: WorkflowHistoryRecord[];
+    } | WorkflowDefinition | {
+        revision: number;
+        deleted: true;
+    }>;
+    /** Save an old definition as a new revision. Run steps require the owner's full key. */
+    restore(params: {
+        name?: string;
+        id?: string;
+        revision: number;
+    }): Promise<{
+        automation: JobAutomation;
+        created: boolean;
+    }>;
     delete(id: string): Promise<void>;
     /** The machine-wide stop switch. */
     stopState(): Promise<JobAutomationStop>;

package/dist/job-automations.js

@@ -23,6 +23,29 @@ export class SwarmJobAutomationsNamespace {
         });
         return { automation: res.data.automation, created: Boolean(res.data.created) };
     }
+    /** Export to .swarm/workflows, commit, and import on another machine. Empty path selects the default filename. */
+    async exportWorkflow(params) {
+        return (await this.transport.request('/v3/workflows/export', { method: 'POST', body: params })).data;
+    }
+    /** Import one definition/file or every *.json in a directory; run steps require a full key. */
+    async importWorkflow(params) {
+        return (await this.transport.request('/v3/workflows/import', { method: 'POST', body: params })).data;
+    }
+    /** Retained changes newest first, also for deleted workflows; a revision returns portable JSON. */
+    async history(params) {
+        const q = new URLSearchParams();
+        if (params.name)
+            q.set('name', params.name);
+        if (params.id)
+            q.set('id', params.id);
+        if (params.revision !== undefined)
+            q.set('revision', String(params.revision));
+        return (await this.transport.request(`/v3/workflows/history?${q}`, { method: 'GET' })).data;
+    }
+    /** Save an old definition as a new revision. Run steps require the owner's full key. */
+    async restore(params) {
+        return (await this.transport.request('/v3/workflows/restore', { method: 'POST', body: params })).data;
+    }
     async delete(id) {
         await this.transport.request(`/v3/workflows/${encodeURIComponent(id)}`, { method: 'DELETE' });
     }

package/dist/settings.d.ts

@@ -1,5 +1,6 @@
 import type { SwarmTransport } from './transport.js';
 export interface ProviderStatus {
+    runs_agents: boolean;
     id: string;
     ready: boolean;
     runnable: boolean;

package/dist/types.d.ts

@@ -632,6 +632,7 @@ export interface ProjectTaskAttempt {
     [key: string]: unknown;
 }
 export interface ProjectTaskRecord {
+    speech?: SpeechSettings;
     id: string;
     project_id: string;
     account_id?: string;
@@ -774,7 +775,16 @@ export interface CancelDesignJobResult {
     task_id: string;
     status: string;
 }
+export interface SpeechSettings {
+    text: string;
+    voice: string;
+    style?: string;
+    language?: string;
+    format?: 'wav';
+}
 export interface CreateProjectTaskParams {
+    operation?: 'create' | 'edit' | 'extend' | 'speech';
+    speech?: SpeechSettings;
     id?: string;
     title: string;
     description?: string;

package/package.json

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