@granular-software/sdk 0.1.0 → 0.2.1

package/dist/{types-D46q5WTh.d.mts → types-DiMEb3SE.d.mts}

@@ -10,6 +10,8 @@ interface GranularOptions {
     apiKey: string;
     /** Optional API URL (for on-prem or testing) */
     apiUrl?: string;
+    /** Optional WebSocket constructor (for Node.js environments) */
+    WebSocketCtor?: any;
 }
 /**
  * A user/subject object returned from recordUser()
@@ -60,6 +62,9 @@ interface ConnectOptions {
     sandbox: string;
     /** The user to connect as (from recordUser()) */
     user: User;
+    /** Optional stable client ID. Defaults to `client_${Date.now()}`. Use a fixed
+     *  value for long-lived effect hosts so tool catalogs don't accumulate. */
+    clientId?: string;
 }
 /**
  * A sandbox container
@@ -330,6 +335,40 @@ interface DomainState {
     }>;
     [key: string]: unknown;
 }
+/**
+ * Information about a published tool
+ */
+interface ToolInfo {
+    /** Unique name of the tool */
+    name: string;
+    /** Description of what the tool does */
+    description?: string;
+    /** JSON Schema for tool input */
+    inputSchema?: Record<string, unknown>;
+    /** JSON Schema for tool output */
+    outputSchema?: Record<string, unknown>;
+    /** Client ID that published this tool (absent for domain-only entries) */
+    clientId?: string;
+    /** Whether the tool is ready for use (has a registered handler) */
+    ready: boolean;
+    /** Timestamp when the tool was published */
+    publishedAt?: number;
+    /** Class this tool belongs to (instance/static method) */
+    className?: string;
+    /** Whether this is a static method */
+    static?: boolean;
+}
+/**
+ * Event data when the list of available tools changes
+ */
+interface ToolsChangedEvent {
+    /** The current list of all available tools */
+    tools: ToolInfo[];
+    /** Names of tools that were added or updated */
+    added: string[];
+    /** Names of tools that were removed */
+    removed: string[];
+}
 type JobStatus = 'queued' | 'running' | 'succeeded' | 'failed' | 'timeout' | 'canceled';
 /**
  * Result from submitting a job
@@ -362,6 +401,7 @@ interface WSClientOptions {
     url: string;
     sessionId: string;
     token: string;
+    WebSocketCtor?: any;
 }
 interface RPCRequest {
     type: 'rpc';
@@ -592,4 +632,4 @@ interface DeleteResponse {
     deleted: boolean;
 }
 
-export type { APIError as $, AssignmentListResponse as A, BuildPolicy as B, ConnectOptions as C, DomainState as D, EnvironmentData as E, Prompt as F, GranularOptions as G, RPCRequest as H, InstanceToolHandler as I, Job as J, RPCResponse as K, SyncMessage as L, ModelRef as M, RPCRequestFromServer as N, ToolInvokeParams as O, PublishToolsResult as P, ToolResultParams as Q, RecordUserOptions as R, SandboxListResponse as S, ToolWithHandler as T, User as U, ManifestPropertySpec as V, WSClientOptions as W, ManifestRelationshipDef as X, ManifestOperation as Y, ManifestImport as Z, ManifestVolume as _, ToolHandler as a, GraphQLResult as b, DefineRelationshipOptions as c, RelationshipInfo as d, ManifestContent as e, RecordObjectOptions as f, RecordObjectResult as g, Sandbox as h, CreateSandboxData as i, DeleteResponse as j, PermissionProfile as k, CreatePermissionProfileData as l, CreateEnvironmentData as m, Subject as n, ToolSchema as o, PermissionRules as p, PermissionProfileListResponse as q, Assignment as r, EnvironmentListResponse as s, Manifest as t, ManifestListResponse as u, BuildStatus as v, Build as w, BuildListResponse as x, JobStatus as y, JobSubmitResult as z };
+export type { ManifestImport as $, AssignmentListResponse as A, BuildPolicy as B, ConnectOptions as C, DomainState as D, EnvironmentData as E, JobStatus as F, GranularOptions as G, JobSubmitResult as H, InstanceToolHandler as I, Job as J, Prompt as K, RPCRequest as L, ModelRef as M, RPCResponse as N, SyncMessage as O, PublishToolsResult as P, RPCRequestFromServer as Q, RecordUserOptions as R, SandboxListResponse as S, ToolWithHandler as T, User as U, ToolInvokeParams as V, WSClientOptions as W, ToolResultParams as X, ManifestPropertySpec as Y, ManifestRelationshipDef as Z, ManifestOperation as _, ToolHandler as a, ManifestVolume as a0, APIError as a1, ToolInfo as b, ToolsChangedEvent as c, GraphQLResult as d, DefineRelationshipOptions as e, RelationshipInfo as f, ManifestContent as g, RecordObjectOptions as h, RecordObjectResult as i, Sandbox as j, CreateSandboxData as k, DeleteResponse as l, PermissionProfile as m, CreatePermissionProfileData as n, CreateEnvironmentData as o, Subject as p, ToolSchema as q, PermissionRules as r, PermissionProfileListResponse as s, Assignment as t, EnvironmentListResponse as u, Manifest as v, ManifestListResponse as w, BuildStatus as x, Build as y, BuildListResponse as z };

package/dist/{types-D46q5WTh.d.ts → types-DiMEb3SE.d.ts}

@@ -10,6 +10,8 @@ interface GranularOptions {
     apiKey: string;
     /** Optional API URL (for on-prem or testing) */
     apiUrl?: string;
+    /** Optional WebSocket constructor (for Node.js environments) */
+    WebSocketCtor?: any;
 }
 /**
  * A user/subject object returned from recordUser()
@@ -60,6 +62,9 @@ interface ConnectOptions {
     sandbox: string;
     /** The user to connect as (from recordUser()) */
     user: User;
+    /** Optional stable client ID. Defaults to `client_${Date.now()}`. Use a fixed
+     *  value for long-lived effect hosts so tool catalogs don't accumulate. */
+    clientId?: string;
 }
 /**
  * A sandbox container
@@ -330,6 +335,40 @@ interface DomainState {
     }>;
     [key: string]: unknown;
 }
+/**
+ * Information about a published tool
+ */
+interface ToolInfo {
+    /** Unique name of the tool */
+    name: string;
+    /** Description of what the tool does */
+    description?: string;
+    /** JSON Schema for tool input */
+    inputSchema?: Record<string, unknown>;
+    /** JSON Schema for tool output */
+    outputSchema?: Record<string, unknown>;
+    /** Client ID that published this tool (absent for domain-only entries) */
+    clientId?: string;
+    /** Whether the tool is ready for use (has a registered handler) */
+    ready: boolean;
+    /** Timestamp when the tool was published */
+    publishedAt?: number;
+    /** Class this tool belongs to (instance/static method) */
+    className?: string;
+    /** Whether this is a static method */
+    static?: boolean;
+}
+/**
+ * Event data when the list of available tools changes
+ */
+interface ToolsChangedEvent {
+    /** The current list of all available tools */
+    tools: ToolInfo[];
+    /** Names of tools that were added or updated */
+    added: string[];
+    /** Names of tools that were removed */
+    removed: string[];
+}
 type JobStatus = 'queued' | 'running' | 'succeeded' | 'failed' | 'timeout' | 'canceled';
 /**
  * Result from submitting a job
@@ -362,6 +401,7 @@ interface WSClientOptions {
     url: string;
     sessionId: string;
     token: string;
+    WebSocketCtor?: any;
 }
 interface RPCRequest {
     type: 'rpc';
@@ -592,4 +632,4 @@ interface DeleteResponse {
     deleted: boolean;
 }
 
-export type { APIError as $, AssignmentListResponse as A, BuildPolicy as B, ConnectOptions as C, DomainState as D, EnvironmentData as E, Prompt as F, GranularOptions as G, RPCRequest as H, InstanceToolHandler as I, Job as J, RPCResponse as K, SyncMessage as L, ModelRef as M, RPCRequestFromServer as N, ToolInvokeParams as O, PublishToolsResult as P, ToolResultParams as Q, RecordUserOptions as R, SandboxListResponse as S, ToolWithHandler as T, User as U, ManifestPropertySpec as V, WSClientOptions as W, ManifestRelationshipDef as X, ManifestOperation as Y, ManifestImport as Z, ManifestVolume as _, ToolHandler as a, GraphQLResult as b, DefineRelationshipOptions as c, RelationshipInfo as d, ManifestContent as e, RecordObjectOptions as f, RecordObjectResult as g, Sandbox as h, CreateSandboxData as i, DeleteResponse as j, PermissionProfile as k, CreatePermissionProfileData as l, CreateEnvironmentData as m, Subject as n, ToolSchema as o, PermissionRules as p, PermissionProfileListResponse as q, Assignment as r, EnvironmentListResponse as s, Manifest as t, ManifestListResponse as u, BuildStatus as v, Build as w, BuildListResponse as x, JobStatus as y, JobSubmitResult as z };
+export type { ManifestImport as $, AssignmentListResponse as A, BuildPolicy as B, ConnectOptions as C, DomainState as D, EnvironmentData as E, JobStatus as F, GranularOptions as G, JobSubmitResult as H, InstanceToolHandler as I, Job as J, Prompt as K, RPCRequest as L, ModelRef as M, RPCResponse as N, SyncMessage as O, PublishToolsResult as P, RPCRequestFromServer as Q, RecordUserOptions as R, SandboxListResponse as S, ToolWithHandler as T, User as U, ToolInvokeParams as V, WSClientOptions as W, ToolResultParams as X, ManifestPropertySpec as Y, ManifestRelationshipDef as Z, ManifestOperation as _, ToolHandler as a, ManifestVolume as a0, APIError as a1, ToolInfo as b, ToolsChangedEvent as c, GraphQLResult as d, DefineRelationshipOptions as e, RelationshipInfo as f, ManifestContent as g, RecordObjectOptions as h, RecordObjectResult as i, Sandbox as j, CreateSandboxData as k, DeleteResponse as l, PermissionProfile as m, CreatePermissionProfileData as n, CreateEnvironmentData as o, Subject as p, ToolSchema as q, PermissionRules as r, PermissionProfileListResponse as s, Assignment as t, EnvironmentListResponse as u, Manifest as v, ManifestListResponse as w, BuildStatus as x, Build as y, BuildListResponse as z };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@granular-software/sdk",
-  "version": "0.1.0",
-  "description": "TypeScript SDK for Granular - wrap your existing tools and run them in secure sandboxes",
+  "version": "0.2.1",
+  "description": "TypeScript SDK and CLI for Granular - define, build, and deploy AI sandboxes",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -32,6 +32,9 @@
       "require": "./dist/adapters/anthropic.js"
     }
   },
+  "bin": {
+    "granular": "./dist/cli/index.js"
+  },
   "files": [
     "dist",
     "README.md"
@@ -50,6 +53,7 @@
   "keywords": [
     "granular",
     "sdk",
+    "cli",
     "ai",
     "agent",
     "tools",
@@ -66,18 +70,24 @@
     "url": "https://github.com/granular-dev/granular-sdk"
   },
   "dependencies": {
-    "@automerge/automerge": "^2.2.9",
-    "ws": "^8.18.2",
+    "@automerge/automerge": "^3.2.1",
+    "chalk": "^5.4.1",
+    "chokidar": "^4.0.3",
+    "commander": "^13.1.0",
+    "dotenv": "^16.4.7",
+    "ora": "^8.2.0",
     "zod-to-json-schema": "^3.25.1"
   },
   "devDependencies": {
+    "@anthropic-ai/sdk": "^0.10.0",
+    "@langchain/core": "^0.1.0",
+    "@types/commander": "^2.12.5",
+    "@types/node": "^25.2.3",
     "@types/ws": "^8.18.1",
+    "openai": "^4.0.0",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0",
-    "zod": "3.25.76",
-    "@langchain/core": "^0.1.0",
-    "openai": "^4.0.0",
-    "@anthropic-ai/sdk": "^0.10.0"
+    "zod": "3.25.76"
   },
   "peerDependencies": {
     "@mastra/core": ">=0.1.0",