swarmlord 0.1.2 → 0.1.3

package/README.md

@@ -82,7 +82,7 @@ for await (const event of session.stream("Add tests")) {
 await session.summarize(); // trigger context compaction
 await session.revert(messageId); // undo to a specific message
 await session.abort(); // cancel current turn
-await session.delete(); // clean up
+await session.end(); // clean up
 
 // Direct sandbox access
 const shellResult = await session.shell("npm test");

package/dist/index.cjs

@@ -103,6 +103,7 @@ function createSessionHandle(id, opts, agentConfig) {
         content: input,
         agent: agentConfig?.name,
         model: agentConfig?.model,
+        tools: agentConfig?.tools,
         config: agentConfig?.config
       };
     }
@@ -110,6 +111,7 @@ function createSessionHandle(id, opts, agentConfig) {
       parts: input.parts,
       agent: input.agent ?? agentConfig?.name,
       model: input.model ?? agentConfig?.model,
+      tools: input.tools ?? agentConfig?.tools,
       config: input.config ?? agentConfig?.config
     };
   }
@@ -273,9 +275,13 @@ function createSessionHandle(id, opts, agentConfig) {
       });
       if (!res.ok) throw new Error(`Failed to get file: ${res.status}`);
       const b64 = await res.text();
-      const bin = atob(b64);
-      const bytes = new Uint8Array(bin.length);
-      for (let i = 0; i < bin.length; i++) bytes[i] = bin.charCodeAt(i);
+      if (typeof Buffer !== "undefined") {
+        const decoded = Buffer.from(b64, "base64");
+        return decoded.buffer.slice(decoded.byteOffset, decoded.byteOffset + decoded.byteLength);
+      }
+      const raw = atob(b64);
+      const bytes = new Uint8Array(raw.length);
+      for (let i = 0; i < raw.length; i++) bytes[i] = raw.charCodeAt(i);
       return bytes.buffer;
     },
     async getArtifact(key) {
@@ -300,9 +306,9 @@ function createSessionHandle(id, opts, agentConfig) {
       });
       if (!res.ok) throw new Error(`Failed to update session: ${res.status}`);
     },
-    async delete() {
+    async end() {
       const res = await fetch(`${baseUrl}/session/${id}`, { method: "DELETE", headers: headers() });
-      if (!res.ok) throw new Error(`Failed to delete session: ${res.status}`);
+      if (!res.ok) throw new Error(`Failed to end session: ${res.status}`);
     },
     async runCommand(name, args) {
       const res = await fetch(`${baseUrl}/session/${id}/command`, {
@@ -571,6 +577,7 @@ function createAgentHandle(clientOpts, config) {
         headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
         body: JSON.stringify({
           title: sessionOpts?.title,
+          tools: config.tools,
           config: config.config,
           webhook: sessionOpts?.webhook
         })
@@ -605,10 +612,14 @@ function createAgentHandle(clientOpts, config) {
 
 const DEFAULT_BASE_URL = "https://api.swarmlord.ai";
 function createClient(opts) {
-  const baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
-  const normalizedOpts = { ...opts, baseUrl };
+  const apiKey = opts?.apiKey ?? (typeof process !== "undefined" ? process.env.SWARMLORD_API_KEY : void 0);
+  if (!apiKey) {
+    throw new Error("Missing API key. Pass it to createClient({ apiKey: '...' }) or set SWARMLORD_API_KEY.");
+  }
+  const baseUrl = (opts?.baseUrl ?? (typeof process !== "undefined" ? process.env.SWARMLORD_URL : void 0) ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+  const normalizedOpts = { apiKey, baseUrl };
   function headers() {
-    return { Authorization: `Bearer ${opts.apiKey}`, "Content-Type": "application/json" };
+    return { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" };
   }
   return {
     agent(nameOrConfig) {

package/dist/index.d.cts

@@ -3,12 +3,15 @@ interface ClientOptions {
     baseUrl: string;
 }
 type AgentName = "build" | "plan" | "explore" | "general" | (string & {});
+type ToolName = "bash" | "read" | "write" | "edit" | "grep" | "glob" | "task" | "todoread" | "todowrite" | "websearch" | "webfetch" | "browser" | "batch" | (string & {});
+type ToolsConfig = Partial<Record<ToolName, boolean>>;
 interface AgentConfig {
     name?: AgentName;
     model?: string;
     instructions?: string[];
     permission?: PermissionConfig;
     temperature?: number;
+    tools?: ToolsConfig;
     config?: Config;
 }
 type PermissionConfig = string | Record<string, string | Record<string, string>>;
@@ -18,6 +21,7 @@ interface Config {
     default_agent?: string;
     instructions?: string[];
     permission?: PermissionConfig;
+    tools?: ToolsConfig;
     command?: Record<string, {
         template: string;
         description?: string;
@@ -253,6 +257,7 @@ type MessageInput = {
     parts: Array<TextInput | FileInput>;
     agent?: string;
     model?: string;
+    tools?: ToolsConfig;
     config?: Config;
 };
 interface SendResult {
@@ -482,7 +487,7 @@ interface SessionHandle {
         title?: string;
         archived?: boolean;
     }): Promise<void>;
-    delete(): Promise<void>;
+    end(): Promise<void>;
     runCommand(name: string, args?: Record<string, string>): Promise<string>;
     replyToPermission(requestId: string, reply: "once" | "always" | "reject", message?: string): Promise<void>;
     events(lastEventId?: number): Promise<ReadableStream<Uint8Array>>;
@@ -606,10 +611,8 @@ interface SwarmlordClient {
         data: ProviderModel[];
     }>;
 }
-type CreateClientOptions = Omit<ClientOptions, "baseUrl"> & {
-    baseUrl?: string;
-};
-declare function createClient(opts: CreateClientOptions): SwarmlordClient;
+type CreateClientOptions = Partial<ClientOptions>;
+declare function createClient(opts?: CreateClientOptions): SwarmlordClient;
 
 export { createClient };
-export type { AgentConfig, AgentEvent, AgentHandle, AgentName, AgentPart, AssistantMessageInfo, ClientOptions, CompactionPart, Config, CreateClientOptions, CreateScheduleOpts, CreateTriggerOpts, FileInput, FilePart, MessageInfo, MessageInput, MessagePart, OutputConfig, Part, PermissionConfig, PermissionReply, PermissionRequest, ProviderModel, ReasoningPart, RetryPart, ScheduleHandle, ScheduleInfo, SendResult, SessionHandle, SessionInfo, SessionMetrics, SessionStatus, ShellResult, StepFinishPart, StepStartPart, StreamCallbacks, SubtaskPart, SwarmlordClient, TaskHandle, TaskResult, TaskStatus, TextInput, TextPart, TodoItem, Tokens, ToolPart, ToolState, ToolStateCompleted, ToolStateError, ToolStatePending, ToolStateRunning, TriggerHandle, TriggerInfo, TriggerProviderName, UpdateScheduleOpts, UpdateTriggerOpts, UserMessageInfo, WithParts };
+export type { AgentConfig, AgentEvent, AgentHandle, AgentName, AgentPart, AssistantMessageInfo, ClientOptions, CompactionPart, Config, CreateClientOptions, CreateScheduleOpts, CreateTriggerOpts, FileInput, FilePart, MessageInfo, MessageInput, MessagePart, OutputConfig, Part, PermissionConfig, PermissionReply, PermissionRequest, ProviderModel, ReasoningPart, RetryPart, ScheduleHandle, ScheduleInfo, SendResult, SessionHandle, SessionInfo, SessionMetrics, SessionStatus, ShellResult, StepFinishPart, StepStartPart, StreamCallbacks, SubtaskPart, SwarmlordClient, TaskHandle, TaskResult, TaskStatus, TextInput, TextPart, TodoItem, Tokens, ToolName, ToolPart, ToolState, ToolStateCompleted, ToolStateError, ToolStatePending, ToolStateRunning, ToolsConfig, TriggerHandle, TriggerInfo, TriggerProviderName, UpdateScheduleOpts, UpdateTriggerOpts, UserMessageInfo, WithParts };

package/dist/index.d.mts

@@ -3,12 +3,15 @@ interface ClientOptions {
     baseUrl: string;
 }
 type AgentName = "build" | "plan" | "explore" | "general" | (string & {});
+type ToolName = "bash" | "read" | "write" | "edit" | "grep" | "glob" | "task" | "todoread" | "todowrite" | "websearch" | "webfetch" | "browser" | "batch" | (string & {});
+type ToolsConfig = Partial<Record<ToolName, boolean>>;
 interface AgentConfig {
     name?: AgentName;
     model?: string;
     instructions?: string[];
     permission?: PermissionConfig;
     temperature?: number;
+    tools?: ToolsConfig;
     config?: Config;
 }
 type PermissionConfig = string | Record<string, string | Record<string, string>>;
@@ -18,6 +21,7 @@ interface Config {
     default_agent?: string;
     instructions?: string[];
     permission?: PermissionConfig;
+    tools?: ToolsConfig;
     command?: Record<string, {
         template: string;
         description?: string;
@@ -253,6 +257,7 @@ type MessageInput = {
     parts: Array<TextInput | FileInput>;
     agent?: string;
     model?: string;
+    tools?: ToolsConfig;
     config?: Config;
 };
 interface SendResult {
@@ -482,7 +487,7 @@ interface SessionHandle {
         title?: string;
         archived?: boolean;
     }): Promise<void>;
-    delete(): Promise<void>;
+    end(): Promise<void>;
     runCommand(name: string, args?: Record<string, string>): Promise<string>;
     replyToPermission(requestId: string, reply: "once" | "always" | "reject", message?: string): Promise<void>;
     events(lastEventId?: number): Promise<ReadableStream<Uint8Array>>;
@@ -606,10 +611,8 @@ interface SwarmlordClient {
         data: ProviderModel[];
     }>;
 }
-type CreateClientOptions = Omit<ClientOptions, "baseUrl"> & {
-    baseUrl?: string;
-};
-declare function createClient(opts: CreateClientOptions): SwarmlordClient;
+type CreateClientOptions = Partial<ClientOptions>;
+declare function createClient(opts?: CreateClientOptions): SwarmlordClient;
 
 export { createClient };
-export type { AgentConfig, AgentEvent, AgentHandle, AgentName, AgentPart, AssistantMessageInfo, ClientOptions, CompactionPart, Config, CreateClientOptions, CreateScheduleOpts, CreateTriggerOpts, FileInput, FilePart, MessageInfo, MessageInput, MessagePart, OutputConfig, Part, PermissionConfig, PermissionReply, PermissionRequest, ProviderModel, ReasoningPart, RetryPart, ScheduleHandle, ScheduleInfo, SendResult, SessionHandle, SessionInfo, SessionMetrics, SessionStatus, ShellResult, StepFinishPart, StepStartPart, StreamCallbacks, SubtaskPart, SwarmlordClient, TaskHandle, TaskResult, TaskStatus, TextInput, TextPart, TodoItem, Tokens, ToolPart, ToolState, ToolStateCompleted, ToolStateError, ToolStatePending, ToolStateRunning, TriggerHandle, TriggerInfo, TriggerProviderName, UpdateScheduleOpts, UpdateTriggerOpts, UserMessageInfo, WithParts };
+export type { AgentConfig, AgentEvent, AgentHandle, AgentName, AgentPart, AssistantMessageInfo, ClientOptions, CompactionPart, Config, CreateClientOptions, CreateScheduleOpts, CreateTriggerOpts, FileInput, FilePart, MessageInfo, MessageInput, MessagePart, OutputConfig, Part, PermissionConfig, PermissionReply, PermissionRequest, ProviderModel, ReasoningPart, RetryPart, ScheduleHandle, ScheduleInfo, SendResult, SessionHandle, SessionInfo, SessionMetrics, SessionStatus, ShellResult, StepFinishPart, StepStartPart, StreamCallbacks, SubtaskPart, SwarmlordClient, TaskHandle, TaskResult, TaskStatus, TextInput, TextPart, TodoItem, Tokens, ToolName, ToolPart, ToolState, ToolStateCompleted, ToolStateError, ToolStatePending, ToolStateRunning, ToolsConfig, TriggerHandle, TriggerInfo, TriggerProviderName, UpdateScheduleOpts, UpdateTriggerOpts, UserMessageInfo, WithParts };

package/dist/index.d.ts

@@ -3,12 +3,15 @@ interface ClientOptions {
     baseUrl: string;
 }
 type AgentName = "build" | "plan" | "explore" | "general" | (string & {});
+type ToolName = "bash" | "read" | "write" | "edit" | "grep" | "glob" | "task" | "todoread" | "todowrite" | "websearch" | "webfetch" | "browser" | "batch" | (string & {});
+type ToolsConfig = Partial<Record<ToolName, boolean>>;
 interface AgentConfig {
     name?: AgentName;
     model?: string;
     instructions?: string[];
     permission?: PermissionConfig;
     temperature?: number;
+    tools?: ToolsConfig;
     config?: Config;
 }
 type PermissionConfig = string | Record<string, string | Record<string, string>>;
@@ -18,6 +21,7 @@ interface Config {
     default_agent?: string;
     instructions?: string[];
     permission?: PermissionConfig;
+    tools?: ToolsConfig;
     command?: Record<string, {
         template: string;
         description?: string;
@@ -253,6 +257,7 @@ type MessageInput = {
     parts: Array<TextInput | FileInput>;
     agent?: string;
     model?: string;
+    tools?: ToolsConfig;
     config?: Config;
 };
 interface SendResult {
@@ -482,7 +487,7 @@ interface SessionHandle {
         title?: string;
         archived?: boolean;
     }): Promise<void>;
-    delete(): Promise<void>;
+    end(): Promise<void>;
     runCommand(name: string, args?: Record<string, string>): Promise<string>;
     replyToPermission(requestId: string, reply: "once" | "always" | "reject", message?: string): Promise<void>;
     events(lastEventId?: number): Promise<ReadableStream<Uint8Array>>;
@@ -606,10 +611,8 @@ interface SwarmlordClient {
         data: ProviderModel[];
     }>;
 }
-type CreateClientOptions = Omit<ClientOptions, "baseUrl"> & {
-    baseUrl?: string;
-};
-declare function createClient(opts: CreateClientOptions): SwarmlordClient;
+type CreateClientOptions = Partial<ClientOptions>;
+declare function createClient(opts?: CreateClientOptions): SwarmlordClient;
 
 export { createClient };
-export type { AgentConfig, AgentEvent, AgentHandle, AgentName, AgentPart, AssistantMessageInfo, ClientOptions, CompactionPart, Config, CreateClientOptions, CreateScheduleOpts, CreateTriggerOpts, FileInput, FilePart, MessageInfo, MessageInput, MessagePart, OutputConfig, Part, PermissionConfig, PermissionReply, PermissionRequest, ProviderModel, ReasoningPart, RetryPart, ScheduleHandle, ScheduleInfo, SendResult, SessionHandle, SessionInfo, SessionMetrics, SessionStatus, ShellResult, StepFinishPart, StepStartPart, StreamCallbacks, SubtaskPart, SwarmlordClient, TaskHandle, TaskResult, TaskStatus, TextInput, TextPart, TodoItem, Tokens, ToolPart, ToolState, ToolStateCompleted, ToolStateError, ToolStatePending, ToolStateRunning, TriggerHandle, TriggerInfo, TriggerProviderName, UpdateScheduleOpts, UpdateTriggerOpts, UserMessageInfo, WithParts };
+export type { AgentConfig, AgentEvent, AgentHandle, AgentName, AgentPart, AssistantMessageInfo, ClientOptions, CompactionPart, Config, CreateClientOptions, CreateScheduleOpts, CreateTriggerOpts, FileInput, FilePart, MessageInfo, MessageInput, MessagePart, OutputConfig, Part, PermissionConfig, PermissionReply, PermissionRequest, ProviderModel, ReasoningPart, RetryPart, ScheduleHandle, ScheduleInfo, SendResult, SessionHandle, SessionInfo, SessionMetrics, SessionStatus, ShellResult, StepFinishPart, StepStartPart, StreamCallbacks, SubtaskPart, SwarmlordClient, TaskHandle, TaskResult, TaskStatus, TextInput, TextPart, TodoItem, Tokens, ToolName, ToolPart, ToolState, ToolStateCompleted, ToolStateError, ToolStatePending, ToolStateRunning, ToolsConfig, TriggerHandle, TriggerInfo, TriggerProviderName, UpdateScheduleOpts, UpdateTriggerOpts, UserMessageInfo, WithParts };

package/dist/index.mjs

@@ -101,6 +101,7 @@ function createSessionHandle(id, opts, agentConfig) {
         content: input,
         agent: agentConfig?.name,
         model: agentConfig?.model,
+        tools: agentConfig?.tools,
         config: agentConfig?.config
       };
     }
@@ -108,6 +109,7 @@ function createSessionHandle(id, opts, agentConfig) {
       parts: input.parts,
       agent: input.agent ?? agentConfig?.name,
       model: input.model ?? agentConfig?.model,
+      tools: input.tools ?? agentConfig?.tools,
       config: input.config ?? agentConfig?.config
     };
   }
@@ -271,9 +273,13 @@ function createSessionHandle(id, opts, agentConfig) {
       });
       if (!res.ok) throw new Error(`Failed to get file: ${res.status}`);
       const b64 = await res.text();
-      const bin = atob(b64);
-      const bytes = new Uint8Array(bin.length);
-      for (let i = 0; i < bin.length; i++) bytes[i] = bin.charCodeAt(i);
+      if (typeof Buffer !== "undefined") {
+        const decoded = Buffer.from(b64, "base64");
+        return decoded.buffer.slice(decoded.byteOffset, decoded.byteOffset + decoded.byteLength);
+      }
+      const raw = atob(b64);
+      const bytes = new Uint8Array(raw.length);
+      for (let i = 0; i < raw.length; i++) bytes[i] = raw.charCodeAt(i);
       return bytes.buffer;
     },
     async getArtifact(key) {
@@ -298,9 +304,9 @@ function createSessionHandle(id, opts, agentConfig) {
       });
       if (!res.ok) throw new Error(`Failed to update session: ${res.status}`);
     },
-    async delete() {
+    async end() {
       const res = await fetch(`${baseUrl}/session/${id}`, { method: "DELETE", headers: headers() });
-      if (!res.ok) throw new Error(`Failed to delete session: ${res.status}`);
+      if (!res.ok) throw new Error(`Failed to end session: ${res.status}`);
     },
     async runCommand(name, args) {
       const res = await fetch(`${baseUrl}/session/${id}/command`, {
@@ -569,6 +575,7 @@ function createAgentHandle(clientOpts, config) {
         headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
         body: JSON.stringify({
           title: sessionOpts?.title,
+          tools: config.tools,
           config: config.config,
           webhook: sessionOpts?.webhook
         })
@@ -603,10 +610,14 @@ function createAgentHandle(clientOpts, config) {
 
 const DEFAULT_BASE_URL = "https://api.swarmlord.ai";
 function createClient(opts) {
-  const baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
-  const normalizedOpts = { ...opts, baseUrl };
+  const apiKey = opts?.apiKey ?? (typeof process !== "undefined" ? process.env.SWARMLORD_API_KEY : void 0);
+  if (!apiKey) {
+    throw new Error("Missing API key. Pass it to createClient({ apiKey: '...' }) or set SWARMLORD_API_KEY.");
+  }
+  const baseUrl = (opts?.baseUrl ?? (typeof process !== "undefined" ? process.env.SWARMLORD_URL : void 0) ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+  const normalizedOpts = { apiKey, baseUrl };
   function headers() {
-    return { Authorization: `Bearer ${opts.apiKey}`, "Content-Type": "application/json" };
+    return { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" };
   }
   return {
     agent(nameOrConfig) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "swarmlord",
-    "version": "0.1.2",
+    "version": "0.1.3",
     "type": "module",
     "description": "TypeScript SDK for Swarmlord — spawn cloud agents",
     "author": "Zach Grimaldi",