@elevasis/sdk 0.3.3 → 0.4.0

package/dist/cli.cjs

@@ -39746,9 +39746,15 @@ var ResourceRegistry = class {
   }
   /**
    * Pre-serialized organization data cache
-   * Computed once at construction, never invalidated (static registry)
+   * Computed once at construction for static orgs, updated incrementally for runtime orgs
    */
   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.
+   */
+  runtimeOrgs = /* @__PURE__ */ new Map();
   /**
    * Validates registry on construction
    * - Checks for duplicate resourceIds within organizations
@@ -39848,6 +39854,72 @@ var ResourceRegistry = class {
     return this.registry;
   }
   // ============================================================================
+  // Runtime Organization Registration (External Deployments)
+  // ============================================================================
+  /**
+   * Register an external organization 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.
+   *
+   * - If orgName conflicts with a static (startup) org, throws an error
+   * - If orgName is already runtime-registered (redeploy), unregisters 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
+   */
+  registerOrganization(orgName, org, remote) {
+    if (this.registry[orgName] && !this.runtimeOrgs.has(orgName)) {
+      throw new Error(`Organization '${orgName}' conflicts with a static organization`);
+    }
+    if (this.runtimeOrgs.has(orgName)) {
+      this.unregisterOrganization(orgName);
+    }
+    this.registry[orgName] = org;
+    this.runtimeOrgs.set(orgName, remote);
+    this.serializedCache.set(orgName, serializeOrganization(org));
+  }
+  /**
+   * Unregister a runtime-registered 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.
+   *
+   * @param orgName - Organization name to unregister
+   */
+  unregisterOrganization(orgName) {
+    if (!this.runtimeOrgs.has(orgName)) return;
+    delete this.registry[orgName];
+    this.runtimeOrgs.delete(orgName);
+    this.serializedCache.delete(orgName);
+  }
+  /**
+   * Get remote configuration for an organization
+   *
+   * Returns the RemoteOrgConfig if the org was registered at runtime,
+   * or null if it's a static org or doesn't exist.
+   * Used by the execution coordinator to branch between local and worker execution.
+   *
+   * @param orgName - Organization name
+   * @returns Remote config or null
+   */
+  getRemoteConfig(orgName) {
+    return this.runtimeOrgs.get(orgName) ?? null;
+  }
+  /**
+   * Check if an organization is a remote (externally deployed) organization
+   *
+   * @param orgName - Organization name
+   * @returns true if the org was registered at runtime
+   */
+  isRemote(orgName) {
+    return this.runtimeOrgs.has(orgName);
+  }
+  // ============================================================================
   // Resource Manifest Accessors
   // ============================================================================
   /**
@@ -40233,13 +40305,13 @@ function registerDeployCommand(program3) {
       console.log("");
     }
     const bundleSpinner = ora("Bundling...").start();
-    const wrapperPath = (0, import_path2.resolve)("__elevasis_serve.ts");
+    const wrapperPath = (0, import_path2.resolve)("__elevasis_worker.ts");
     const bundleOutfile = (0, import_path2.resolve)("dist/bundle.js");
     try {
       const entryImport = entryPath.replace(/\.ts$/, ".js");
       const wrapperContent = `import org from ${JSON.stringify(entryImport)}
-import { startServer } from '@elevasis/sdk/server'
-startServer(org)
+import { startWorker } from '@elevasis/sdk/worker'
+startWorker(org)
 `;
       await (0, import_promises.writeFile)(wrapperPath, wrapperContent, "utf-8");
       await (0, import_promises.mkdir)((0, import_path2.resolve)("dist"), { recursive: true });
@@ -40703,7 +40775,7 @@ var import_path3 = require("path");
 var import_promises2 = require("fs/promises");
 
 // src/cli/version.ts
-var SDK_VERSION = "0.3.3";
+var SDK_VERSION = "0.4.0";
 
 // src/cli/commands/init.ts
 var SCAFFOLD_FILES = [

package/dist/index.d.ts

@@ -1054,6 +1054,22 @@ interface IterationContext {
  * - Command View data generation
  */
 
+/**
+ * Configuration for a remotely-deployed organization
+ *
+ * Stored alongside runtime-registered organizations to support
+ * worker thread execution branching and credential management.
+ */
+interface RemoteOrgConfig {
+    /** Path to the esbuild bundle on disk */
+    bundlePath: string;
+    /** Deployment record ID */
+    deploymentId: string;
+    /** Developer-provided environment variables injected into the worker */
+    envVars?: Record<string, string>;
+    /** Platform tool name -> credential name mapping */
+    toolCredentials?: Record<string, string>;
+}
 /**
  * Organization-specific resource collection
  *
@@ -1084,9 +1100,15 @@ declare class ResourceRegistry {
     private registry;
     /**
      * Pre-serialized organization data cache
-     * Computed once at construction, never invalidated (static registry)
+     * Computed once at construction for static orgs, updated incrementally for runtime orgs
      */
     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.
+     */
+    private runtimeOrgs;
     constructor(registry: OrganizationRegistry);
     /**
      * Validates registry on construction
@@ -1122,6 +1144,50 @@ declare class ResourceRegistry {
      * NOTE: For debugging only - returns raw registry data
      */
     listAllResources(): OrganizationRegistry;
+    /**
+     * Register an external organization 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.
+     *
+     * - If orgName conflicts with a static (startup) org, throws an error
+     * - If orgName is already runtime-registered (redeploy), unregisters 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
+     */
+    registerOrganization(orgName: string, org: OrganizationResources, remote: RemoteOrgConfig): void;
+    /**
+     * Unregister a runtime-registered 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.
+     *
+     * @param orgName - Organization name to unregister
+     */
+    unregisterOrganization(orgName: string): void;
+    /**
+     * Get remote configuration for an organization
+     *
+     * Returns the RemoteOrgConfig if the org was registered at runtime,
+     * or null if it's a static org or doesn't exist.
+     * Used by the execution coordinator to branch between local and worker execution.
+     *
+     * @param orgName - Organization name
+     * @returns Remote config or null
+     */
+    getRemoteConfig(orgName: string): RemoteOrgConfig | null;
+    /**
+     * Check if an organization is a remote (externally deployed) organization
+     *
+     * @param orgName - Organization name
+     * @returns true if the org was registered at runtime
+     */
+    isRemote(orgName: string): boolean;
     /**
      * Get triggers for an organization
      * @param organizationName - Organization name

package/dist/index.js

@@ -3162,9 +3162,15 @@ var ResourceRegistry = class {
   }
   /**
    * Pre-serialized organization data cache
-   * Computed once at construction, never invalidated (static registry)
+   * Computed once at construction for static orgs, updated incrementally for runtime orgs
    */
   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.
+   */
+  runtimeOrgs = /* @__PURE__ */ new Map();
   /**
    * Validates registry on construction
    * - Checks for duplicate resourceIds within organizations
@@ -3264,6 +3270,72 @@ var ResourceRegistry = class {
     return this.registry;
   }
   // ============================================================================
+  // Runtime Organization Registration (External Deployments)
+  // ============================================================================
+  /**
+   * Register an external organization 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.
+   *
+   * - If orgName conflicts with a static (startup) org, throws an error
+   * - If orgName is already runtime-registered (redeploy), unregisters 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
+   */
+  registerOrganization(orgName, org, remote) {
+    if (this.registry[orgName] && !this.runtimeOrgs.has(orgName)) {
+      throw new Error(`Organization '${orgName}' conflicts with a static organization`);
+    }
+    if (this.runtimeOrgs.has(orgName)) {
+      this.unregisterOrganization(orgName);
+    }
+    this.registry[orgName] = org;
+    this.runtimeOrgs.set(orgName, remote);
+    this.serializedCache.set(orgName, serializeOrganization(org));
+  }
+  /**
+   * Unregister a runtime-registered 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.
+   *
+   * @param orgName - Organization name to unregister
+   */
+  unregisterOrganization(orgName) {
+    if (!this.runtimeOrgs.has(orgName)) return;
+    delete this.registry[orgName];
+    this.runtimeOrgs.delete(orgName);
+    this.serializedCache.delete(orgName);
+  }
+  /**
+   * Get remote configuration for an organization
+   *
+   * Returns the RemoteOrgConfig if the org was registered at runtime,
+   * or null if it's a static org or doesn't exist.
+   * Used by the execution coordinator to branch between local and worker execution.
+   *
+   * @param orgName - Organization name
+   * @returns Remote config or null
+   */
+  getRemoteConfig(orgName) {
+    return this.runtimeOrgs.get(orgName) ?? null;
+  }
+  /**
+   * Check if an organization is a remote (externally deployed) organization
+   *
+   * @param orgName - Organization name
+   * @returns true if the org was registered at runtime
+   */
+  isRemote(orgName) {
+    return this.runtimeOrgs.has(orgName);
+  }
+  // ============================================================================
   // Resource Manifest Accessors
   // ============================================================================
   /**

package/dist/worker/index.js

@@ -0,0 +1,121 @@
+import { parentPort } from 'worker_threads';
+
+// src/worker/index.ts
+function resolveNext(next, data) {
+  if (next === null) return null;
+  if (next.type === "linear") return next.target;
+  for (const route of next.routes) {
+    if (route.condition(data)) return route.target;
+  }
+  return next.default;
+}
+async function executeWorkflow(workflow, input) {
+  const logs = [];
+  const origLog = console.log;
+  const origWarn = console.warn;
+  const origError = console.error;
+  const capture = (level, orig) => (...args) => {
+    logs.push({ level, message: args.map(String).join(" ") });
+    orig(...args);
+  };
+  console.log = capture("info", origLog);
+  console.warn = capture("warn", origWarn);
+  console.error = capture("error", origError);
+  try {
+    let currentData = workflow.contract.inputSchema ? workflow.contract.inputSchema.parse(input) : input;
+    let stepId = workflow.entryPoint;
+    while (stepId !== null) {
+      const step = workflow.steps[stepId];
+      if (!step) {
+        throw new Error(`Step '${stepId}' not found in workflow '${workflow.config.resourceId}'`);
+      }
+      const stepInput = step.inputSchema.parse(currentData);
+      const rawOutput = await step.handler(stepInput, {
+        executionId: "",
+        organizationId: "",
+        organizationName: "",
+        resourceId: workflow.config.resourceId,
+        executionDepth: 0,
+        store: /* @__PURE__ */ new Map(),
+        logger: {
+          debug: (msg) => console.log(`[debug] ${msg}`),
+          info: (msg) => console.log(`[info] ${msg}`),
+          warn: (msg) => console.warn(`[warn] ${msg}`),
+          error: (msg) => console.error(`[error] ${msg}`)
+        }
+      });
+      currentData = step.outputSchema.parse(rawOutput);
+      stepId = resolveNext(step.next, currentData);
+    }
+    if (workflow.contract.outputSchema) {
+      currentData = workflow.contract.outputSchema.parse(currentData);
+    }
+    return { output: currentData, logs };
+  } finally {
+    console.log = origLog;
+    console.warn = origWarn;
+    console.error = origError;
+  }
+}
+function startWorker(org) {
+  const workflows = new Map(
+    (org.workflows ?? []).map((w) => [w.config.resourceId, w])
+  );
+  const agents = new Map(
+    (org.agents ?? []).map((a) => [a.config.resourceId, a])
+  );
+  parentPort.on("message", async (msg) => {
+    if (msg.type === "manifest") {
+      parentPort.postMessage({
+        type: "manifest",
+        workflows: (org.workflows ?? []).map((w) => ({
+          resourceId: w.config.resourceId,
+          name: w.config.name,
+          type: w.config.type,
+          status: w.config.status,
+          description: w.config.description,
+          version: w.config.version
+        })),
+        agents: (org.agents ?? []).map((a) => ({
+          resourceId: a.config.resourceId,
+          name: a.config.name,
+          type: a.config.type,
+          status: a.config.status,
+          description: a.config.description,
+          version: a.config.version
+        }))
+      });
+      return;
+    }
+    if (msg.type === "execute") {
+      const { resourceId, input } = msg;
+      const workflow = workflows.get(resourceId);
+      if (workflow) {
+        try {
+          const { output, logs } = await executeWorkflow(workflow, input);
+          parentPort.postMessage({ type: "result", status: "completed", output, logs });
+        } catch (err) {
+          parentPort.postMessage({ type: "result", status: "failed", error: String(err), logs: [] });
+        }
+        return;
+      }
+      if (agents.has(resourceId)) {
+        parentPort.postMessage({
+          type: "result",
+          status: "failed",
+          error: "Agent execution not yet supported in worker runtime",
+          logs: []
+        });
+        return;
+      }
+      parentPort.postMessage({
+        type: "result",
+        status: "failed",
+        error: `Resource not found: ${resourceId}`,
+        logs: []
+      });
+    }
+  });
+}
+
+export { startWorker };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "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",
@@ -13,14 +13,14 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
-    "./server": {
-      "import": "./dist/server/index.js"
+    "./worker": {
+      "import": "./dist/worker/index.js"
     }
   },
   "files": [
     "dist/index.js",
     "dist/index.d.ts",
-    "dist/server/index.js",
+    "dist/worker/index.js",
     "dist/cli.cjs"
   ],
   "scripts": {

package/dist/server/index.js

@@ -1,174 +0,0 @@
-import { createServer } from 'http';
-
-// src/server/index.ts
-function readBody(req) {
-  return new Promise((resolve, reject) => {
-    const chunks = [];
-    req.on("data", (chunk) => chunks.push(chunk));
-    req.on("end", () => resolve(Buffer.concat(chunks).toString()));
-    req.on("error", reject);
-  });
-}
-function json(res, status, data) {
-  res.writeHead(status, { "Content-Type": "application/json" });
-  res.end(JSON.stringify(data));
-}
-function resolveNext(next, data) {
-  if (next === null) return null;
-  if (next.type === "linear") return next.target;
-  for (const route of next.routes) {
-    if (route.condition(data)) return route.target;
-  }
-  return next.default;
-}
-async function executeWorkflow(workflow, input, context) {
-  let currentData = workflow.contract.inputSchema.parse(input);
-  let stepId = workflow.entryPoint;
-  while (stepId !== null) {
-    if (context.signal?.aborted) {
-      throw new Error("Execution cancelled");
-    }
-    const step = workflow.steps[stepId];
-    if (!step) {
-      throw new Error(`Step '${stepId}' not found in workflow '${workflow.config.resourceId}'`);
-    }
-    const stepInput = step.inputSchema.parse(currentData);
-    const rawOutput = await step.handler(stepInput, context);
-    currentData = step.outputSchema.parse(rawOutput);
-    stepId = resolveNext(step.next, currentData);
-  }
-  if (workflow.contract.outputSchema) {
-    currentData = workflow.contract.outputSchema.parse(currentData);
-  }
-  return currentData;
-}
-function withLogCapture(fn) {
-  const logs = [];
-  const orig = { log: console.log, warn: console.warn, error: console.error };
-  const capture = (level, origFn) => (...args) => {
-    logs.push({ level, message: args.map(String).join(" "), timestamp: Date.now() });
-    origFn(...args);
-  };
-  console.log = capture("info", orig.log);
-  console.warn = capture("warn", orig.warn);
-  console.error = capture("error", orig.error);
-  return fn().then((result) => ({ result, logs })).finally(() => {
-    console.log = orig.log;
-    console.warn = orig.warn;
-    console.error = orig.error;
-  });
-}
-function startServer(org) {
-  const port = parseInt(process.env.PORT || "3000");
-  const workflows = new Map(
-    (org.workflows ?? []).map((w) => [w.config.resourceId, w])
-  );
-  const agents = new Map(
-    (org.agents ?? []).map((a) => [a.config.resourceId, a])
-  );
-  const controllers = /* @__PURE__ */ new Map();
-  const server = createServer(async (req, res) => {
-    try {
-      if (req.url === "/health" && req.method === "GET") {
-        res.writeHead(200).end("ok");
-        return;
-      }
-      if (req.url === "/manifest" && req.method === "GET") {
-        json(res, 200, {
-          workflows: (org.workflows ?? []).map((w) => ({
-            resourceId: w.config.resourceId,
-            name: w.config.name,
-            type: w.config.type,
-            status: w.config.status,
-            description: w.config.description,
-            version: w.config.version
-          })),
-          agents: (org.agents ?? []).map((a) => ({
-            resourceId: a.config.resourceId,
-            name: a.config.name,
-            type: a.config.type,
-            status: a.config.status,
-            description: a.config.description,
-            version: a.config.version
-          }))
-        });
-        return;
-      }
-      if (req.url === "/execute" && req.method === "POST") {
-        const body = JSON.parse(await readBody(req));
-        const { resourceId, executionId, input } = body;
-        const workflow = workflows.get(resourceId);
-        if (workflow) {
-          const controller = new AbortController();
-          controllers.set(executionId, controller);
-          const deadline = req.headers["x-elevasis-deadline"];
-          const timer = deadline ? setTimeout(() => controller.abort(), Number(deadline) - Date.now()) : void 0;
-          const context = {
-            executionId,
-            organizationId: "",
-            organizationName: "",
-            resourceId,
-            executionDepth: 0,
-            store: /* @__PURE__ */ new Map(),
-            signal: controller.signal,
-            logger: {
-              debug: (msg) => console.log(`[debug] ${msg}`),
-              info: (msg) => console.log(`[info] ${msg}`),
-              warn: (msg) => console.warn(`[warn] ${msg}`),
-              error: (msg) => console.error(`[error] ${msg}`)
-            }
-          };
-          try {
-            const { result: output, logs } = await withLogCapture(
-              () => executeWorkflow(workflow, input, context)
-            );
-            json(res, 200, { status: "completed", output, logs });
-          } catch (err) {
-            const { logs } = await withLogCapture(async () => {
-            });
-            json(res, 500, { status: "failed", error: String(err), logs });
-          } finally {
-            controllers.delete(executionId);
-            if (timer) clearTimeout(timer);
-          }
-          return;
-        }
-        const agent = agents.get(resourceId);
-        if (agent) {
-          json(res, 501, {
-            status: "failed",
-            error: `Agent execution is not supported in SDK server v0.3.0. Resource '${resourceId}' is an agent.`,
-            logs: []
-          });
-          return;
-        }
-        json(res, 404, { error: `Resource not found: ${resourceId}` });
-        return;
-      }
-      if (req.url === "/cancel" && req.method === "POST") {
-        const body = JSON.parse(await readBody(req));
-        const { executionId } = body;
-        const controller = controllers.get(executionId);
-        if (controller) {
-          controller.abort();
-          controllers.delete(executionId);
-          json(res, 200, { cancelled: true });
-        } else {
-          json(res, 404, { error: `No running execution: ${executionId}` });
-        }
-        return;
-      }
-      res.writeHead(404).end();
-    } catch (err) {
-      console.error("Unhandled server error:", err);
-      if (!res.headersSent) {
-        json(res, 500, { error: "Internal server error" });
-      }
-    }
-  });
-  server.listen(port, () => {
-    console.log(`Elevasis SDK server listening on port ${port}`);
-  });
-}
-
-export { startServer };