@elevasis/sdk 0.4.0 → 0.4.2

package/dist/index.d.ts

@@ -1104,11 +1104,12 @@ declare class ResourceRegistry {
      */
     private serializedCache;
     /**
-     * Runtime-registered organizations (external deployments)
-     * Tracks which orgs were added at runtime vs. static startup.
-     * Used to guard against unregistering static orgs and to store remote config.
+     * Per-resource remote configuration (external deployments)
+     * Key: "orgName/resourceId", Value: RemoteOrgConfig for that resource.
+     * Tracks which individual resources were added at runtime via deploy pipeline.
+     * Static and remote resources coexist in the same org.
      */
-    private runtimeOrgs;
+    private remoteResources;
     constructor(registry: OrganizationRegistry);
     /**
      * Validates registry on construction
@@ -1145,47 +1146,53 @@ declare class ResourceRegistry {
      */
     listAllResources(): OrganizationRegistry;
     /**
-     * Register an external organization at runtime
+     * Register external resources at runtime
      *
      * Called during deploy pipeline when an external developer deploys their bundle.
-     * Adds the org's stub definitions to the registry and stores remote config
-     * for worker thread execution branching.
+     * Merges the incoming stub definitions into the org's registry and stores
+     * per-resource remote config for worker thread execution branching.
      *
-     * - If orgName conflicts with a static (startup) org, throws an error
-     * - If orgName is already runtime-registered (redeploy), unregisters first
+     * Static and remote resources coexist in the same org. If the org already
+     * has static resources, the incoming remote resources are merged alongside them.
+     * If redeploying (some resources already registered as remote for this org),
+     * the previous remote resources are unregistered first.
      *
      * @param orgName - Organization name (used as registry key)
      * @param org - Stub resource definitions (workflows/agents with placeholder handlers)
      * @param remote - Remote configuration (bundle path, deployment ID, env vars)
-     * @throws Error if orgName conflicts with a static organization
+     * @throws Error if incoming resourceId conflicts with a static resource
+     * @throws Error if incoming deployment contains duplicate resourceIds
      */
     registerOrganization(orgName: string, org: OrganizationResources, remote: RemoteOrgConfig): void;
     /**
-     * Unregister a runtime-registered organization
+     * Unregister runtime-registered resources for an organization
      *
-     * Only removes organizations that were registered at runtime (via registerOrganization).
-     * Static organizations loaded at startup are protected and cannot be unregistered.
-     * No-op if the org is not runtime-registered.
+     * Removes only resources that were registered at runtime (via registerOrganization).
+     * Static resources loaded at startup are preserved. If the org still has static
+     * resources after removal, the serialization cache is rebuilt. If no resources
+     * remain, the org is fully removed from the registry.
+     * No-op if the org has no remote resources.
      *
-     * @param orgName - Organization name to unregister
+     * @param orgName - Organization name to unregister remote resources from
      */
     unregisterOrganization(orgName: string): void;
     /**
-     * Get remote configuration for an organization
+     * Get remote configuration for a specific resource
      *
-     * Returns the RemoteOrgConfig if the org was registered at runtime,
-     * or null if it's a static org or doesn't exist.
+     * Returns the RemoteOrgConfig if the resource was registered at runtime,
+     * or null if it's a static resource or doesn't exist.
      * Used by the execution coordinator to branch between local and worker execution.
      *
      * @param orgName - Organization name
+     * @param resourceId - Resource ID
      * @returns Remote config or null
      */
-    getRemoteConfig(orgName: string): RemoteOrgConfig | null;
+    getRemoteConfig(orgName: string, resourceId: string): RemoteOrgConfig | null;
     /**
-     * Check if an organization is a remote (externally deployed) organization
+     * Check if an organization has any remote (externally deployed) resources
      *
      * @param orgName - Organization name
-     * @returns true if the org was registered at runtime
+     * @returns true if the org has at least one runtime-registered resource
      */
     isRemote(orgName: string): boolean;
     /**
@@ -1577,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
@@ -1870,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";
@@ -1903,10 +1913,10 @@ declare class RegistryValidationError extends Error {
 
 /**
  * Project configuration for an external developer project.
- * Defined in elevas.config.ts at the project root.
+ * Defined in elevasis.config.ts at the project root.
+ * Organization is derived from the ELEVASIS_API_KEY -- not configured here.
  */
 interface ElevasConfig {
-    organization: string;
     defaultStatus?: ResourceStatus;
     dev?: {
         port?: number;

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,
@@ -3166,11 +3174,12 @@ var ResourceRegistry = class {
    */
   serializedCache;
   /**
-   * Runtime-registered organizations (external deployments)
-   * Tracks which orgs were added at runtime vs. static startup.
-   * Used to guard against unregistering static orgs and to store remote config.
+   * Per-resource remote configuration (external deployments)
+   * Key: "orgName/resourceId", Value: RemoteOrgConfig for that resource.
+   * Tracks which individual resources were added at runtime via deploy pipeline.
+   * Static and remote resources coexist in the same org.
    */
-  runtimeOrgs = /* @__PURE__ */ new Map();
+  remoteResources = /* @__PURE__ */ new Map();
   /**
    * Validates registry on construction
    * - Checks for duplicate resourceIds within organizations
@@ -3233,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;
@@ -3247,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;
@@ -3273,67 +3284,125 @@ var ResourceRegistry = class {
   // Runtime Organization Registration (External Deployments)
   // ============================================================================
   /**
-   * Register an external organization at runtime
+   * Register external resources at runtime
    *
    * Called during deploy pipeline when an external developer deploys their bundle.
-   * Adds the org's stub definitions to the registry and stores remote config
-   * for worker thread execution branching.
+   * Merges the incoming stub definitions into the org's registry and stores
+   * per-resource remote config for worker thread execution branching.
    *
-   * - If orgName conflicts with a static (startup) org, throws an error
-   * - If orgName is already runtime-registered (redeploy), unregisters first
+   * Static and remote resources coexist in the same org. If the org already
+   * has static resources, the incoming remote resources are merged alongside them.
+   * If redeploying (some resources already registered as remote for this org),
+   * the previous remote resources are unregistered first.
    *
    * @param orgName - Organization name (used as registry key)
    * @param org - Stub resource definitions (workflows/agents with placeholder handlers)
    * @param remote - Remote configuration (bundle path, deployment ID, env vars)
-   * @throws Error if orgName conflicts with a static organization
+   * @throws Error if incoming resourceId conflicts with a static resource
+   * @throws Error if incoming deployment contains duplicate resourceIds
    */
   registerOrganization(orgName, org, remote) {
-    if (this.registry[orgName] && !this.runtimeOrgs.has(orgName)) {
-      throw new Error(`Organization '${orgName}' conflicts with a static organization`);
+    const incomingWorkflowIds = (org.workflows ?? []).map((w) => w.config.resourceId);
+    const incomingAgentIds = (org.agents ?? []).map((a) => a.config.resourceId);
+    const incomingIds = [...incomingWorkflowIds, ...incomingAgentIds];
+    const seen = /* @__PURE__ */ new Set();
+    for (const id of incomingIds) {
+      if (seen.has(id)) {
+        throw new Error(
+          `Duplicate resource ID '${id}' in deployment. Each resource must have a unique ID.`
+        );
+      }
+      seen.add(id);
     }
-    if (this.runtimeOrgs.has(orgName)) {
+    if (this.isRemote(orgName)) {
       this.unregisterOrganization(orgName);
     }
-    this.registry[orgName] = org;
-    this.runtimeOrgs.set(orgName, remote);
-    this.serializedCache.set(orgName, serializeOrganization(org));
+    const existingOrg = this.registry[orgName];
+    if (existingOrg) {
+      const staticWorkflowIds = new Set((existingOrg.workflows ?? []).map((w) => w.config.resourceId));
+      const staticAgentIds = new Set((existingOrg.agents ?? []).map((a) => a.config.resourceId));
+      for (const id of incomingIds) {
+        if (staticWorkflowIds.has(id) || staticAgentIds.has(id)) {
+          throw new Error(
+            `Resource '${id}' already exists in '${orgName}' as an internal resource. External deployments cannot override internal resources.`
+          );
+        }
+      }
+    }
+    if (existingOrg) {
+      existingOrg.workflows = [...existingOrg.workflows ?? [], ...org.workflows ?? []];
+      existingOrg.agents = [...existingOrg.agents ?? [], ...org.agents ?? []];
+    } else {
+      this.registry[orgName] = org;
+    }
+    for (const id of incomingIds) {
+      this.remoteResources.set(`${orgName}/${id}`, remote);
+    }
+    this.serializedCache.set(orgName, serializeOrganization(this.registry[orgName]));
   }
   /**
-   * Unregister a runtime-registered organization
+   * Unregister runtime-registered resources for an organization
    *
-   * Only removes organizations that were registered at runtime (via registerOrganization).
-   * Static organizations loaded at startup are protected and cannot be unregistered.
-   * No-op if the org is not runtime-registered.
+   * Removes only resources that were registered at runtime (via registerOrganization).
+   * Static resources loaded at startup are preserved. If the org still has static
+   * resources after removal, the serialization cache is rebuilt. If no resources
+   * remain, the org is fully removed from the registry.
+   * No-op if the org has no remote resources.
    *
-   * @param orgName - Organization name to unregister
+   * @param orgName - Organization name to unregister remote resources from
    */
   unregisterOrganization(orgName) {
-    if (!this.runtimeOrgs.has(orgName)) return;
-    delete this.registry[orgName];
-    this.runtimeOrgs.delete(orgName);
-    this.serializedCache.delete(orgName);
+    const prefix = `${orgName}/`;
+    const remoteIds = /* @__PURE__ */ new Set();
+    for (const key of this.remoteResources.keys()) {
+      if (key.startsWith(prefix)) {
+        remoteIds.add(key.slice(prefix.length));
+        this.remoteResources.delete(key);
+      }
+    }
+    if (remoteIds.size === 0) return;
+    const orgResources = this.registry[orgName];
+    if (!orgResources) return;
+    orgResources.workflows = (orgResources.workflows ?? []).filter(
+      (w) => !remoteIds.has(w.config.resourceId)
+    );
+    orgResources.agents = (orgResources.agents ?? []).filter(
+      (a) => !remoteIds.has(a.config.resourceId)
+    );
+    const remaining = (orgResources.workflows?.length ?? 0) + (orgResources.agents?.length ?? 0) + (orgResources.triggers?.length ?? 0) + (orgResources.integrations?.length ?? 0) + (orgResources.externalResources?.length ?? 0) + (orgResources.humanCheckpoints?.length ?? 0);
+    if (remaining > 0) {
+      this.serializedCache.set(orgName, serializeOrganization(orgResources));
+    } else {
+      delete this.registry[orgName];
+      this.serializedCache.delete(orgName);
+    }
   }
   /**
-   * Get remote configuration for an organization
+   * Get remote configuration for a specific resource
    *
-   * Returns the RemoteOrgConfig if the org was registered at runtime,
-   * or null if it's a static org or doesn't exist.
+   * Returns the RemoteOrgConfig if the resource was registered at runtime,
+   * or null if it's a static resource or doesn't exist.
    * Used by the execution coordinator to branch between local and worker execution.
    *
    * @param orgName - Organization name
+   * @param resourceId - Resource ID
    * @returns Remote config or null
    */
-  getRemoteConfig(orgName) {
-    return this.runtimeOrgs.get(orgName) ?? null;
+  getRemoteConfig(orgName, resourceId) {
+    return this.remoteResources.get(`${orgName}/${resourceId}`) ?? null;
   }
   /**
-   * Check if an organization is a remote (externally deployed) organization
+   * Check if an organization has any remote (externally deployed) resources
    *
    * @param orgName - Organization name
-   * @returns true if the org was registered at runtime
+   * @returns true if the org has at least one runtime-registered resource
    */
   isRemote(orgName) {
-    return this.runtimeOrgs.has(orgName);
+    const prefix = `${orgName}/`;
+    for (const key of this.remoteResources.keys()) {
+      if (key.startsWith(prefix)) return true;
+    }
+    return false;
   }
   // ============================================================================
   // Resource Manifest Accessors

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(),
@@ -64,8 +146,12 @@ function startWorker(org) {
   const agents = new Map(
     (org.agents ?? []).map((a) => [a.config.resourceId, a])
   );
+  console.log(`[SDK-WORKER] Worker started with ${workflows.size} workflow(s), ${agents.size} agent(s)`);
   parentPort.on("message", async (msg) => {
     if (msg.type === "manifest") {
+      const workflowList = (org.workflows ?? []).map((w) => w.config.resourceId);
+      const agentList = (org.agents ?? []).map((a) => a.config.resourceId);
+      console.log(`[SDK-WORKER] Manifest requested: workflows=[${workflowList.join(", ")}], agents=[${agentList.join(", ")}]`);
       parentPort.postMessage({
         type: "manifest",
         workflows: (org.workflows ?? []).map((w) => ({
@@ -87,19 +173,33 @@ function startWorker(org) {
       });
       return;
     }
+    if (msg.type === "tool-result") {
+      handleToolResult(msg);
+      return;
+    }
     if (msg.type === "execute") {
-      const { resourceId, 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 {
-          const { output, logs } = await executeWorkflow(workflow, input);
+          console.log(`[SDK-WORKER] Running workflow '${resourceId}' (${Object.keys(workflow.steps).length} steps)`);
+          const startTime = Date.now();
+          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) {
+          console.error(`[SDK-WORKER] Workflow '${resourceId}' failed: ${String(err)}`);
           parentPort.postMessage({ type: "result", status: "failed", error: String(err), logs: [] });
         }
         return;
       }
       if (agents.has(resourceId)) {
+        console.error(`[SDK-WORKER] Agent execution not supported: ${resourceId}`);
         parentPort.postMessage({
           type: "result",
           status: "failed",
@@ -108,6 +208,7 @@ function startWorker(org) {
         });
         return;
       }
+      console.error(`[SDK-WORKER] Resource not found: ${resourceId}`);
       parentPort.postMessage({
         type: "result",
         status: "failed",
@@ -118,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.0",
+  "version": "0.4.2",
   "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",
@@ -23,10 +23,6 @@
     "dist/worker/index.js",
     "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 +31,22 @@
     "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/typescript-config": "0.0.0",
+    "@repo/core": "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"
   }
-}
+}