@elevasis/sdk 0.4.1 → 0.4.3

package/dist/index.d.ts

@@ -1584,6 +1584,8 @@ interface ResourceDefinition {
     domains?: ResourceDomain[];
     /** Whether the agent supports multi-turn sessions (agents only) */
     sessionCapable?: boolean;
+    /** Whether the resource is local (monorepo) or remote (externally deployed) */
+    origin?: 'local' | 'remote';
 }
 /**
  * Domain definition for Command View filtering
@@ -1877,6 +1879,7 @@ interface HumanCheckpointDefinition extends ResourceDefinition {
 
 declare const DOMAINS: {
     readonly ACQUISITION: "acquisition";
+    readonly LEADS: "leads";
     readonly SUPPORT: "support";
     readonly DELIVERY: "delivery";
     readonly OPERATIONS: "operations";
@@ -1923,9 +1926,9 @@ interface ElevasConfig {
 /**
  * Runtime values for SDK developers.
  *
- * These are standalone definitions (not re-exported from @repo/core)
+ * These are standalone definitions (not re-exported from the core package)
  * to avoid pulling in the entire execution engine dependency tree (~3.5MB).
- * Values are identical to their @repo/core counterparts.
+ * Values are identical to their core package counterparts.
  */
 /** Step connection type for multi-step workflows */
 declare enum StepType {

package/dist/index.js

@@ -43,6 +43,7 @@ var ToolingError = class extends ExecutionError {
 var DOMAINS = {
   // Business domains
   ACQUISITION: "acquisition",
+  LEADS: "leads",
   SUPPORT: "support",
   DELIVERY: "delivery",
   OPERATIONS: "operations",
@@ -61,6 +62,12 @@ var ACQUISITION_DOMAIN = {
   description: "Client acquisition pipeline and lead database management",
   color: "blue"
 };
+var LEADS_DOMAIN = {
+  id: DOMAINS.LEADS,
+  name: "Lead Database",
+  description: "Lead import, enrichment, qualification, and personalization",
+  color: "cyan"
+};
 var SUPPORT_DOMAIN = {
   id: DOMAINS.SUPPORT,
   name: "Customer Support",
@@ -123,6 +130,7 @@ var DIAGNOSTIC_DOMAIN = {
 };
 var DOMAIN_MAP = {
   [DOMAINS.ACQUISITION]: ACQUISITION_DOMAIN,
+  [DOMAINS.LEADS]: LEADS_DOMAIN,
   [DOMAINS.SUPPORT]: SUPPORT_DOMAIN,
   [DOMAINS.DELIVERY]: DELIVERY_DOMAIN,
   [DOMAINS.OPERATIONS]: OPERATIONS_DOMAIN,
@@ -3234,7 +3242,8 @@ var ResourceRegistry = class {
       description: def.config.description,
       version: def.config.version,
       type: def.config.type,
-      status: def.config.status
+      status: def.config.status,
+      origin: this.remoteResources.has(`${organizationName}/${def.config.resourceId}`) ? "remote" : "local"
     })).filter((resource) => {
       if (environment) {
         return resource.status === environment;
@@ -3248,7 +3257,8 @@ var ResourceRegistry = class {
       version: def.config.version,
       type: def.config.type,
       status: def.config.status,
-      sessionCapable: def.config.sessionCapable ?? false
+      sessionCapable: def.config.sessionCapable ?? false,
+      origin: this.remoteResources.has(`${organizationName}/${def.config.resourceId}`) ? "remote" : "local"
     })).filter((resource) => {
       if (environment) {
         return resource.status === environment;

package/dist/types/worker/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * SDK Worker Runtime
+ *
+ * Runs inside a worker_threads Worker, replacing the HTTP-based server runtime.
+ * Communicates with the parent (API process) via postMessage().
+ *
+ * Message protocol:
+ *   Parent -> Worker:  { type: 'manifest' }
+ *   Worker -> Parent:  { type: 'manifest', workflows: [...], agents: [...] }
+ *
+ *   Parent -> Worker:  { type: 'execute', resourceId, executionId, input, organizationId?, organizationName? }
+ *   Worker -> Parent:  { type: 'result', status, output?, error?, logs }
+ *
+ *   Worker -> Parent:  { type: 'tool-call', id, tool, method, params, credential? }
+ *   Parent -> Worker:  { type: 'tool-result', id, result?, error?, code? }
+ */
+import type { OrganizationResources } from '../index.js';
+export { platform, PlatformToolError } from './platform.js';
+export declare function startWorker(org: OrganizationResources): void;

package/dist/types/worker/platform.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Platform Tool Proxy (Worker Side)
+ *
+ * Provides platform.call() for external developers to invoke platform tools
+ * from within worker threads. Communicates with the parent process via
+ * postMessage() -- the parent dispatches to the real service layer.
+ */
+/** Inbound tool-result from parent */
+interface ToolResultMessage {
+    type: 'tool-result';
+    id: string;
+    result?: unknown;
+    error?: string;
+    code?: string;
+}
+export declare class PlatformToolError extends Error {
+    /** ToolingErrorType code from the platform */
+    readonly code: string;
+    /** Whether the error is retryable */
+    readonly retryable: boolean;
+    constructor(message: string, 
+    /** ToolingErrorType code from the platform */
+    code: string, 
+    /** Whether the error is retryable */
+    retryable: boolean);
+}
+/**
+ * Handle a tool-result message from the parent process.
+ * Called from the parentPort.on('message') handler in index.ts.
+ */
+export declare function handleToolResult(msg: ToolResultMessage): void;
+export declare const platform: {
+    /**
+     * Call a platform tool from the worker thread.
+     *
+     * @param options.tool - Tool name (e.g., 'gmail', 'storage', 'attio')
+     * @param options.method - Method name (e.g., 'sendEmail', 'upload')
+     * @param options.params - Method parameters
+     * @param options.credential - Credential name (required for integration tools)
+     * @returns Promise resolving to the tool result
+     * @throws PlatformToolError on failure (with code and retryable fields)
+     */
+    call(options: {
+        tool: string;
+        method: string;
+        params?: unknown;
+        credential?: string;
+    }): Promise<unknown>;
+};
+export {};

package/dist/worker/index.js

@@ -1,5 +1,87 @@
 import { parentPort } from 'worker_threads';
 
+// src/worker/index.ts
+var RETRYABLE_CODES = /* @__PURE__ */ new Set([
+  "rate_limit_exceeded",
+  "network_error",
+  "timeout_error",
+  "api_error",
+  "service_unavailable",
+  "server_unavailable"
+]);
+var PlatformToolError = class extends Error {
+  constructor(message, code, retryable) {
+    super(message);
+    this.code = code;
+    this.retryable = retryable;
+    this.name = "PlatformToolError";
+  }
+};
+var pendingCalls = /* @__PURE__ */ new Map();
+var callCounter = 0;
+function handleToolResult(msg) {
+  const pending = pendingCalls.get(msg.id);
+  if (!pending) return;
+  pendingCalls.delete(msg.id);
+  if (msg.error) {
+    const code = msg.code ?? "unknown_error";
+    pending.reject(new PlatformToolError(msg.error, code, RETRYABLE_CODES.has(code)));
+  } else {
+    pending.resolve(msg.result);
+  }
+}
+var platform = {
+  /**
+   * Call a platform tool from the worker thread.
+   *
+   * @param options.tool - Tool name (e.g., 'gmail', 'storage', 'attio')
+   * @param options.method - Method name (e.g., 'sendEmail', 'upload')
+   * @param options.params - Method parameters
+   * @param options.credential - Credential name (required for integration tools)
+   * @returns Promise resolving to the tool result
+   * @throws PlatformToolError on failure (with code and retryable fields)
+   */
+  async call(options) {
+    if (!parentPort) {
+      throw new PlatformToolError(
+        "platform.call() can only be used inside a worker thread",
+        "service_unavailable",
+        false
+      );
+    }
+    const id = `tc_${++callCounter}_${Date.now()}`;
+    const message = {
+      type: "tool-call",
+      id,
+      tool: options.tool,
+      method: options.method,
+      params: options.params ?? {},
+      credential: options.credential
+    };
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        pendingCalls.delete(id);
+        reject(new PlatformToolError(
+          `Platform tool call timed out after 60s: ${options.tool}.${options.method}`,
+          "timeout_error",
+          true
+        ));
+      }, 6e4);
+      pendingCalls.set(id, {
+        resolve: (value) => {
+          clearTimeout(timer);
+          resolve(value);
+        },
+        reject: (error) => {
+          clearTimeout(timer);
+          reject(error);
+        }
+      });
+      parentPort.postMessage(message);
+    });
+  }
+};
+
 // src/worker/index.ts
 function resolveNext(next, data) {
   if (next === null) return null;
@@ -9,7 +91,7 @@ function resolveNext(next, data) {
   }
   return next.default;
 }
-async function executeWorkflow(workflow, input) {
+async function executeWorkflow(workflow, input, context) {
   const logs = [];
   const origLog = console.log;
   const origWarn = console.warn;
@@ -31,9 +113,9 @@ async function executeWorkflow(workflow, input) {
       }
       const stepInput = step.inputSchema.parse(currentData);
       const rawOutput = await step.handler(stepInput, {
-        executionId: "",
-        organizationId: "",
-        organizationName: "",
+        executionId: context.executionId,
+        organizationId: context.organizationId,
+        organizationName: context.organizationName,
         resourceId: workflow.config.resourceId,
         executionDepth: 0,
         store: /* @__PURE__ */ new Map(),
@@ -91,15 +173,23 @@ function startWorker(org) {
       });
       return;
     }
+    if (msg.type === "tool-result") {
+      handleToolResult(msg);
+      return;
+    }
     if (msg.type === "execute") {
-      const { resourceId, executionId, input } = msg;
+      const { resourceId, executionId, input, organizationId, organizationName } = msg;
       console.log(`[SDK-WORKER] Execute request: resourceId=${resourceId}, executionId=${executionId}`);
       const workflow = workflows.get(resourceId);
       if (workflow) {
         try {
           console.log(`[SDK-WORKER] Running workflow '${resourceId}' (${Object.keys(workflow.steps).length} steps)`);
           const startTime = Date.now();
-          const { output, logs } = await executeWorkflow(workflow, input);
+          const { output, logs } = await executeWorkflow(workflow, input, {
+            executionId,
+            organizationId: organizationId ?? "",
+            organizationName: organizationName ?? ""
+          });
           console.log(`[SDK-WORKER] Workflow '${resourceId}' completed (${Date.now() - startTime}ms)`);
           parentPort.postMessage({ type: "result", status: "completed", output, logs });
         } catch (err) {
@@ -129,4 +219,4 @@ function startWorker(org) {
   });
 }
 
-export { startWorker };
+export { PlatformToolError, platform, startWorker };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "SDK for building Elevasis organization resources",
   "comment:bin": "IMPORTANT: This package shares the 'elevasis' binary name with @repo/cli. They never conflict because @elevasis/sdk must NEVER be added as a dependency of any workspace package (apps/*, packages/*, organizations/*). Workspace projects use @repo/cli for the 'elevasis' binary. External developers (outside the workspace) get this SDK's binary via npm install.",
   "type": "module",
@@ -14,6 +14,7 @@
       "import": "./dist/index.js"
     },
     "./worker": {
+      "types": "./dist/types/worker/index.d.ts",
       "import": "./dist/worker/index.js"
     }
   },
@@ -21,12 +22,10 @@
     "dist/index.js",
     "dist/index.d.ts",
     "dist/worker/index.js",
+    "dist/types/worker/index.d.ts",
+    "dist/types/worker/platform.d.ts",
     "dist/cli.cjs"
   ],
-  "scripts": {
-    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.core-dts.json && tsc -p tsconfig.build.json && tsup && rollup -c rollup.dts.config.mjs && esbuild src/cli/index.ts --bundle --platform=node --outfile=dist/cli.cjs --format=cjs --external:esbuild --external:jiti --banner:js=\"#!/usr/bin/env node\"",
-    "check-types": "tsc --noEmit"
-  },
   "dependencies": {
     "esbuild": "^0.25.0",
     "jiti": "^2.0.0"
@@ -35,17 +34,23 @@
     "zod": "^4.1.0"
   },
   "devDependencies": {
-    "@repo/core": "workspace:*",
-    "@repo/typescript-config": "workspace:*",
     "@types/node": "^22.0.0",
     "chalk": "^5.3.0",
     "commander": "^11.0.0",
     "dotenv": "^16.0.0",
+    "gray-matter": "^4.0.3",
     "ora": "^7.0.1",
     "rollup": "^4.59.0",
     "rollup-plugin-dts": "^6.3.0",
     "tsup": "^8.0.0",
     "typescript": "5.9.2",
-    "zod": "^4.1.0"
+    "zod": "^4.1.0",
+    "@repo/core": "0.0.0",
+    "@repo/typescript-config": "0.0.0"
+  },
+  "scripts": {
+    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.core-dts.json && tsc -p tsconfig.build.json && tsup && rollup -c rollup.dts.config.mjs && esbuild src/cli/index.ts --bundle --platform=node --outfile=dist/cli.cjs --format=cjs --external:esbuild --external:jiti --banner:js=\"#!/usr/bin/env node\"",
+    "check-types": "tsc --noEmit",
+    "test:bundle": "pnpm build && vitest run --config vitest.bundle.config.ts"
   }
-}
+}