@elevasis/sdk 0.9.7 → 1.0.1

package/dist/cli.cjs

@@ -40455,7 +40455,7 @@ var RegistryValidationError = class extends Error {
     this.name = "RegistryValidationError";
   }
 };
-function validateOrganizationResources(orgName, resources) {
+function validateDeploymentSpec(orgName, resources) {
   const seenIds = /* @__PURE__ */ new Set();
   resources.workflows?.forEach((workflow) => {
     const id = workflow.config.resourceId;
@@ -40587,7 +40587,8 @@ function isZodOptional(schema) {
   return schema.isOptional();
 }
 function validateRelationships(orgName, resources) {
-  if (!resources.relationships && !resources.triggers && !resources.externalResources && !resources.humanCheckpoints) return;
+  if (!resources.relationships && !resources.triggers && !resources.externalResources && !resources.humanCheckpoints)
+    return;
   const validAgentIds = new Set(resources.agents?.map((a) => a.config.resourceId) ?? []);
   const validWorkflowIds = new Set(resources.workflows?.map((w) => w.config.resourceId) ?? []);
   const validIntegrationIds = new Set(resources.integrations?.map((i) => i.resourceId) ?? []);
@@ -43100,6 +43101,7 @@ function serializeOrganization(resources) {
   const humanCheckpoints = resources.humanCheckpoints ?? [];
   const domainDefinitions = deriveDomainDefinitions(resources);
   return {
+    version: resources.version,
     resources: {
       workflows: workflowResources,
       agents: agentResources,
@@ -43258,7 +43260,7 @@ var ResourceRegistry = class {
    */
   validateRegistry() {
     for (const [orgName, resources] of Object.entries(this.registry)) {
-      validateOrganizationResources(orgName, resources);
+      validateDeploymentSpec(orgName, resources);
     }
   }
   /**
@@ -43891,7 +43893,7 @@ function wrapAction(commandName, fn) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "0.9.7",
+  version: "1.0.1",
   description: "SDK for building Elevasis organization resources",
   type: "module",
   bin: {
@@ -44008,6 +44010,17 @@ function extractResourceMetadata(resource, schemaWarnings) {
   }
   return meta;
 }
+function bumpVersion(current, type) {
+  const [major, minor, patch] = current.split(".").map(Number);
+  switch (type) {
+    case "major":
+      return `${major + 1}.0.0`;
+    case "minor":
+      return `${major}.${minor + 1}.0`;
+    case "patch":
+      return `${major}.${minor}.${patch + 1}`;
+  }
+}
 var IGNORED_DOC_DIRS = /* @__PURE__ */ new Set([".archive"]);
 async function scanDocumentation() {
   const docsDir = (0, import_path.resolve)("docs");
@@ -44486,218 +44499,234 @@ async function generateNavigationMap(docs) {
 function registerDeployCommand(program3) {
   program3.command("deploy").description(
     "Validate, bundle, upload, and deploy project resources\n  Example: elevasis-sdk deploy --api-url http://localhost:5170"
-  ).option("--api-url <url>", "API URL").option("--entry <path>", "Path to entry file (default: ./src/index.ts)").option("--prod", "Deploy to production (overrides NODE_ENV=development)").action(
-    wrapAction("deploy", async (options2) => {
-      const startTime = Date.now();
-      const apiUrl = resolveApiUrl(options2.apiUrl, options2.prod);
-      const env2 = resolveEnvironment(options2.prod);
-      const entryPath = options2.entry ?? "./src/index.ts";
-      const authSpinner = ora("Authenticating...").start();
-      let orgName;
-      try {
-        const me = await apiGet("/api/external/me", apiUrl);
-        orgName = me.organizationName;
-        authSpinner.succeed(
-          source_default.green("Authenticating...") + source_default.white("          done") + source_default.gray(` (${orgName})`)
-        );
-      } catch (error46) {
-        authSpinner.fail(source_default.red("Authentication failed"));
-        const errMsg = error46 instanceof Error ? error46.message : String(error46);
-        if (errMsg.includes("401") || errMsg.toLowerCase().includes("unauthorized")) {
-          const keyVar = !options2.prod && process.env.NODE_ENV === "development" && process.env.ELEVASIS_PLATFORM_KEY_DEV ? "ELEVASIS_PLATFORM_KEY_DEV" : "ELEVASIS_PLATFORM_KEY";
-          console.error(source_default.red("  Invalid API key."));
-          console.error(source_default.gray(`  Your ${keyVar} was rejected by the server.`));
-          console.error(source_default.gray("  Check your .env file and verify the key in the Elevasis dashboard."));
-        } else {
-          console.error(source_default.gray("  Check your API key and API URL."));
+  ).option("--api-url <url>", "API URL").option("--entry <path>", "Path to entry file (default: ./src/index.ts)").option("--prod", "Deploy to production (overrides NODE_ENV=development)").option("--major", "Bump major version before deploying (1.0.0 \u2192 2.0.0)").option("--minor", "Bump minor version before deploying (1.0.0 \u2192 1.1.0)").option("--patch", "Bump patch version before deploying (1.0.0 \u2192 1.0.1)").action(
+    wrapAction(
+      "deploy",
+      async (options2) => {
+        const startTime = Date.now();
+        const apiUrl = resolveApiUrl(options2.apiUrl, options2.prod);
+        const env2 = resolveEnvironment(options2.prod);
+        const entryPath = options2.entry ?? "./src/index.ts";
+        const authSpinner = ora("Authenticating...").start();
+        let orgName;
+        try {
+          const me = await apiGet("/api/external/me", apiUrl);
+          orgName = me.organizationName;
+          authSpinner.succeed(
+            source_default.green("Authenticating...") + source_default.white("          done") + source_default.gray(` (${orgName})`)
+          );
+        } catch (error46) {
+          authSpinner.fail(source_default.red("Authentication failed"));
+          const errMsg = error46 instanceof Error ? error46.message : String(error46);
+          if (errMsg.includes("401") || errMsg.toLowerCase().includes("unauthorized")) {
+            const keyVar = !options2.prod && process.env.NODE_ENV === "development" && process.env.ELEVASIS_PLATFORM_KEY_DEV ? "ELEVASIS_PLATFORM_KEY_DEV" : "ELEVASIS_PLATFORM_KEY";
+            console.error(source_default.red("  Invalid API key."));
+            console.error(source_default.gray(`  Your ${keyVar} was rejected by the server.`));
+            console.error(source_default.gray("  Check your .env file and verify the key in the Elevasis dashboard."));
+          } else {
+            console.error(source_default.gray("  Check your API key and API URL."));
+          }
+          throw error46;
         }
-        throw error46;
-      }
-      const validateSpinner = ora("Validating...").start();
-      let org;
-      let activeWorkflows = [];
-      let activeAgents = [];
-      try {
-        const entryModule = await loadTsModule(entryPath);
-        org = entryModule.default;
-        if (!org) {
-          validateSpinner.fail("Invalid entry: no default export found");
-          console.error(source_default.gray(`  Entry file: ${(0, import_path.resolve)(entryPath)}`));
-          throw new Error("Invalid entry: no default export found");
-        }
-        new ResourceRegistry({ [orgName]: org });
-        activeWorkflows = (org.workflows ?? []).filter((w) => !w.config.archived);
-        activeAgents = (org.agents ?? []).filter((a) => !a.config.archived);
-        const archivedCount = (org.workflows?.length ?? 0) + (org.agents?.length ?? 0) - activeWorkflows.length - activeAgents.length;
-        const totalCount = activeWorkflows.length + activeAgents.length;
-        validateSpinner.succeed(
-          source_default.green("Validating...") + source_default.white("              done") + source_default.gray(` (${totalCount} resource${totalCount !== 1 ? "s" : ""}, 0 errors)`)
-        );
-        if (archivedCount > 0) {
-          console.log(source_default.gray(`  Skipping ${archivedCount} archived resource${archivedCount !== 1 ? "s" : ""}`));
+        const validateSpinner = ora("Validating...").start();
+        let org;
+        let activeWorkflows = [];
+        let activeAgents = [];
+        try {
+          const entryModule = await loadTsModule(entryPath);
+          org = entryModule.default;
+          if (!org) {
+            validateSpinner.fail("Invalid entry: no default export found");
+            console.error(source_default.gray(`  Entry file: ${(0, import_path.resolve)(entryPath)}`));
+            throw new Error("Invalid entry: no default export found");
+          }
+          new ResourceRegistry({ [orgName]: org });
+          activeWorkflows = (org.workflows ?? []).filter((w) => !w.config.archived);
+          activeAgents = (org.agents ?? []).filter((a) => !a.config.archived);
+          const archivedCount = (org.workflows?.length ?? 0) + (org.agents?.length ?? 0) - activeWorkflows.length - activeAgents.length;
+          const totalCount = activeWorkflows.length + activeAgents.length;
+          validateSpinner.succeed(
+            source_default.green("Validating...") + source_default.white("              done") + source_default.gray(` (${totalCount} resource${totalCount !== 1 ? "s" : ""}, 0 errors)`)
+          );
+          if (archivedCount > 0) {
+            console.log(source_default.gray(`  Skipping ${archivedCount} archived resource${archivedCount !== 1 ? "s" : ""}`));
+          }
+          const bumpType = options2.major ? "major" : options2.minor ? "minor" : "patch";
+          const currentVersion = org.version;
+          const newVersion = bumpVersion(currentVersion, bumpType);
+          const absEntryPath = (0, import_path.resolve)(entryPath);
+          const entryContent = await (0, import_promises.readFile)(absEntryPath, "utf-8");
+          const updatedContent = entryContent.replace(
+            /version:\s*['"][\d]+\.[\d]+\.[\d]+['"]/,
+            `version: '${newVersion}'`
+          );
+          await (0, import_promises.writeFile)(absEntryPath, updatedContent, "utf-8");
+          org.version = newVersion;
+          console.log("");
+          console.log(source_default.gray(`  Org:    ${orgName}`));
+          console.log(source_default.gray(`  Target: ${apiUrl} (${env2})`));
+          console.log(source_default.gray(`  Version: ${currentVersion} \u2192 ${source_default.white(newVersion)} (${bumpType})`));
+          console.log("");
+          for (const w of activeWorkflows) {
+            console.log(source_default.gray(`  workflow  ${source_default.white(w.config.resourceId)}  v${w.config.version}`));
+          }
+          for (const a of activeAgents) {
+            console.log(source_default.gray(`  agent     ${source_default.white(a.config.resourceId)}  v${a.config.version}`));
+          }
+          console.log("");
+        } catch (error46) {
+          if (error46 instanceof RegistryValidationError) {
+            validateSpinner.fail(source_default.red("Validation failed"));
+            console.error("");
+            console.error(source_default.red(`  ERROR  ${error46.message}`));
+            if (error46.resourceId) {
+              console.error(source_default.gray(`  Resource: ${error46.resourceId}`));
+            }
+            console.error("");
+            console.error(source_default.gray("  Deploy aborted."));
+          }
+          throw error46;
         }
-        console.log("");
-        console.log(source_default.gray(`  Org:    ${orgName}`));
-        console.log(source_default.gray(`  Target: ${apiUrl} (${env2})`));
-        console.log("");
-        for (const w of activeWorkflows) {
-          console.log(source_default.gray(`  workflow  ${source_default.white(w.config.resourceId)}  v${w.config.version}`));
+        await generateResourceMap(org);
+        await generateProjectMap(org);
+        let documentation = await scanDocumentation();
+        if (documentation) {
+          await generateNavigationMap(documentation);
+          documentation = await scanDocumentation();
+          console.log(
+            source_default.gray(
+              `  docs    ${source_default.white(String(documentation.length))} file${documentation.length !== 1 ? "s" : ""}`
+            )
+          );
         }
-        for (const a of activeAgents) {
-          console.log(source_default.gray(`  agent     ${source_default.white(a.config.resourceId)}  v${a.config.version}`));
+        const triggerCount = org.triggers?.length ?? 0;
+        const integrationCount = org.integrations?.length ?? 0;
+        const checkpointCount = org.humanCheckpoints?.length ?? 0;
+        if (triggerCount > 0) console.log(source_default.gray(`  triggers  ${source_default.white(String(triggerCount))}`));
+        if (integrationCount > 0) console.log(source_default.gray(`  integrations  ${source_default.white(String(integrationCount))}`));
+        if (checkpointCount > 0) console.log(source_default.gray(`  checkpoints  ${source_default.white(String(checkpointCount))}`));
+        const relationshipCount = org.relationships ? Object.keys(org.relationships).length : 0;
+        if (relationshipCount > 0) {
+          console.log(
+            source_default.gray(
+              `  rels    ${source_default.white(String(relationshipCount))} resource${relationshipCount !== 1 ? "s" : ""}`
+            )
+          );
         }
-        console.log("");
-      } catch (error46) {
-        if (error46 instanceof RegistryValidationError) {
-          validateSpinner.fail(source_default.red("Validation failed"));
-          console.error("");
-          console.error(source_default.red(`  ERROR  ${error46.message}`));
-          if (error46.resourceId) {
-            console.error(source_default.gray(`  Resource: ${error46.resourceId}`));
+        const schemaWarnings = [];
+        const workflows = activeWorkflows.map((w) => extractResourceMetadata(w, schemaWarnings));
+        const agents = activeAgents.map((a) => extractResourceMetadata(a, schemaWarnings));
+        if (schemaWarnings.length > 0) {
+          for (const warning of schemaWarnings) {
+            console.log(source_default.yellow(`  warn  ${warning}`));
           }
-          console.error("");
-          console.error(source_default.gray("  Deploy aborted."));
-        }
-        throw error46;
-      }
-      await generateResourceMap(org);
-      await generateProjectMap(org);
-      let documentation = await scanDocumentation();
-      if (documentation) {
-        await generateNavigationMap(documentation);
-        documentation = await scanDocumentation();
-        console.log(
-          source_default.gray(
-            `  docs    ${source_default.white(String(documentation.length))} file${documentation.length !== 1 ? "s" : ""}`
-          )
-        );
-      }
-      const triggerCount = org.triggers?.length ?? 0;
-      const integrationCount = org.integrations?.length ?? 0;
-      const checkpointCount = org.humanCheckpoints?.length ?? 0;
-      if (triggerCount > 0) console.log(source_default.gray(`  triggers  ${source_default.white(String(triggerCount))}`));
-      if (integrationCount > 0) console.log(source_default.gray(`  integrations  ${source_default.white(String(integrationCount))}`));
-      if (checkpointCount > 0) console.log(source_default.gray(`  checkpoints  ${source_default.white(String(checkpointCount))}`));
-      const relationshipCount = org.relationships ? Object.keys(org.relationships).length : 0;
-      if (relationshipCount > 0) {
-        console.log(
-          source_default.gray(
-            `  rels    ${source_default.white(String(relationshipCount))} resource${relationshipCount !== 1 ? "s" : ""}`
-          )
-        );
-      }
-      const schemaWarnings = [];
-      const workflows = activeWorkflows.map((w) => extractResourceMetadata(w, schemaWarnings));
-      const agents = activeAgents.map((a) => extractResourceMetadata(a, schemaWarnings));
-      if (schemaWarnings.length > 0) {
-        for (const warning of schemaWarnings) {
-          console.log(source_default.yellow(`  warn  ${warning}`));
+          console.log(source_default.gray("  Schemas will be unavailable on the platform for these resources."));
+          console.log("");
         }
-        console.log(source_default.gray("  Schemas will be unavailable on the platform for these resources."));
-        console.log("");
-      }
-      const bundleSpinner = ora("Bundling...").start();
-      const wrapperPath = (0, import_path.resolve)("__elevasis_worker.ts");
-      const bundleOutfile = (0, import_path.resolve)("dist/bundle.js");
-      try {
-        const entryImport = entryPath.replace(/\.ts$/, ".js");
-        const wrapperContent = `import org from ${JSON.stringify(entryImport)}
+        const bundleSpinner = ora("Bundling...").start();
+        const wrapperPath = (0, import_path.resolve)("__elevasis_worker.ts");
+        const bundleOutfile = (0, import_path.resolve)("dist/bundle.js");
+        try {
+          const entryImport = entryPath.replace(/\.ts$/, ".js");
+          const wrapperContent = `import org from ${JSON.stringify(entryImport)}
 import { startWorker } from '@elevasis/sdk/worker'
 startWorker(org)
 `;
-        await (0, import_promises.writeFile)(wrapperPath, wrapperContent, "utf-8");
-        await (0, import_promises.mkdir)((0, import_path.resolve)("dist"), { recursive: true });
-        const esbuild = getEsbuild();
-        await esbuild.build({
-          entryPoints: [wrapperPath],
-          bundle: true,
-          platform: "node",
-          format: "cjs",
-          outfile: bundleOutfile
-        });
-        await (0, import_promises.unlink)(wrapperPath);
-        const bundleBuffer = await (0, import_promises.readFile)(bundleOutfile);
-        const bundleSizeKB = Math.round(bundleBuffer.length / 1024);
-        bundleSpinner.succeed(
-          source_default.green("Bundling...") + source_default.white("                done") + source_default.gray(` (${bundleSizeKB} KB)`)
-        );
-      } catch (error46) {
-        try {
+          await (0, import_promises.writeFile)(wrapperPath, wrapperContent, "utf-8");
+          await (0, import_promises.mkdir)((0, import_path.resolve)("dist"), { recursive: true });
+          const esbuild = getEsbuild();
+          await esbuild.build({
+            entryPoints: [wrapperPath],
+            bundle: true,
+            platform: "node",
+            format: "cjs",
+            outfile: bundleOutfile
+          });
           await (0, import_promises.unlink)(wrapperPath);
-        } catch {
-        }
-        bundleSpinner.fail(source_default.red("Bundling failed"));
-        throw error46;
-      }
-      const uploadSpinner = ora("Uploading...").start();
-      try {
-        const bundleBuffer = await (0, import_promises.readFile)(bundleOutfile);
-        const apiKey = resolveApiKey(options2.prod);
-        if (!apiKey) {
-          uploadSpinner.fail(source_default.red("Missing API key environment variable"));
-          console.error(source_default.gray("  Set it in your .env file or shell environment:"));
-          if (!options2.prod && process.env.NODE_ENV === "development") {
-            console.error(source_default.gray("    ELEVASIS_PLATFORM_KEY_DEV=sk_...  (or ELEVASIS_PLATFORM_KEY as fallback)"));
-          } else {
-            console.error(source_default.gray("    ELEVASIS_PLATFORM_KEY=sk_..."));
+          const bundleBuffer = await (0, import_promises.readFile)(bundleOutfile);
+          const bundleSizeKB = Math.round(bundleBuffer.length / 1024);
+          bundleSpinner.succeed(
+            source_default.green("Bundling...") + source_default.white("                done") + source_default.gray(` (${bundleSizeKB} KB)`)
+          );
+        } catch (error46) {
+          try {
+            await (0, import_promises.unlink)(wrapperPath);
+          } catch {
           }
-          throw new Error("Missing API key environment variable");
+          bundleSpinner.fail(source_default.red("Bundling failed"));
+          throw error46;
         }
-        const metadata = {
-          sdkVersion: SDK_VERSION,
-          mode: env2,
-          resources: { workflows, agents },
-          ...documentation ? { documentation } : {},
-          ...org.relationships ? { relationships: org.relationships } : {}
-        };
-        const form = new FormData();
-        form.append("bundle", new Blob([bundleBuffer]), "bundle.js");
-        form.append("metadata", JSON.stringify(metadata));
-        const response = await fetch(`${apiUrl}/api/external/deploy`, {
-          method: "POST",
-          headers: { Authorization: `Bearer ${apiKey}` },
-          body: form
-        });
-        if (!response.ok) {
-          const errorText = await response.text();
-          uploadSpinner.fail(source_default.red("Upload failed"));
-          console.error(source_default.red(`  ${response.status}: ${errorText}`));
-          throw new Error(`Deploy upload failed (${response.status}): ${errorText}`);
-        }
-        const result = await response.json();
-        uploadSpinner.succeed(source_default.green("Uploading...") + source_default.white("               done"));
-        const totalResources = activeWorkflows.length + activeAgents.length;
-        const elapsed = ((Date.now() - startTime) / 1e3).toFixed(1);
-        if (result.status === "active") {
-          console.log("");
-          console.log(
-            source_default.green.bold(`  Deployed! ${totalResources} resource${totalResources !== 1 ? "s" : ""} live.`)
-          );
-          if (result.deployId) {
-            console.log(source_default.gray(`  Version:  ${result.deployId}`));
+        const uploadSpinner = ora("Uploading...").start();
+        try {
+          const bundleBuffer = await (0, import_promises.readFile)(bundleOutfile);
+          const apiKey = resolveApiKey(options2.prod);
+          if (!apiKey) {
+            uploadSpinner.fail(source_default.red("Missing API key environment variable"));
+            console.error(source_default.gray("  Set it in your .env file or shell environment:"));
+            if (!options2.prod && process.env.NODE_ENV === "development") {
+              console.error(
+                source_default.gray("    ELEVASIS_PLATFORM_KEY_DEV=sk_...  (or ELEVASIS_PLATFORM_KEY as fallback)")
+              );
+            } else {
+              console.error(source_default.gray("    ELEVASIS_PLATFORM_KEY=sk_..."));
+            }
+            throw new Error("Missing API key environment variable");
           }
-          console.log(source_default.gray(`  Duration: ${elapsed}s`));
-        } else if (result.status === "failed") {
-          console.log("");
-          console.log(source_default.red.bold("  Deploy failed."));
-          if (result.error) {
-            console.error(source_default.red(`  ${result.error}`));
+          const metadata = {
+            sdkVersion: SDK_VERSION,
+            deploymentVersion: org.version,
+            mode: env2,
+            resources: { workflows, agents },
+            ...documentation ? { documentation } : {},
+            ...org.relationships ? { relationships: org.relationships } : {}
+          };
+          const form = new FormData();
+          form.append("bundle", new Blob([bundleBuffer]), "bundle.js");
+          form.append("metadata", JSON.stringify(metadata));
+          const response = await fetch(`${apiUrl}/api/external/deploy`, {
+            method: "POST",
+            headers: { Authorization: `Bearer ${apiKey}` },
+            body: form
+          });
+          if (!response.ok) {
+            const errorText = await response.text();
+            uploadSpinner.fail(source_default.red("Upload failed"));
+            console.error(source_default.red(`  ${response.status}: ${errorText}`));
+            throw new Error(`Deploy upload failed (${response.status}): ${errorText}`);
+          }
+          const result = await response.json();
+          uploadSpinner.succeed(source_default.green("Uploading...") + source_default.white("               done"));
+          const totalResources = activeWorkflows.length + activeAgents.length;
+          const elapsed = ((Date.now() - startTime) / 1e3).toFixed(1);
+          if (result.status === "active") {
+            console.log("");
+            console.log(
+              source_default.green.bold(`  Deployed! ${totalResources} resource${totalResources !== 1 ? "s" : ""} live.`)
+            );
+            console.log(source_default.gray(`  Version:  ${source_default.white(`v${org.version}`)}`));
+            console.log(source_default.gray(`  Duration: ${elapsed}s`));
+          } else if (result.status === "failed") {
+            console.log("");
+            console.log(source_default.red.bold("  Deploy failed."));
+            if (result.error) {
+              console.error(source_default.red(`  ${result.error}`));
+            }
+            throw new Error(`Deploy failed: ${result.error ?? "unknown error"}`);
+          } else {
+            console.log("");
+            console.log(source_default.yellow(`  Deploy status: ${result.status ?? "unknown"}`));
+            if (result.deployId) {
+              console.log(source_default.gray(`  Version: ${result.deployId}`));
+            }
           }
-          throw new Error(`Deploy failed: ${result.error ?? "unknown error"}`);
-        } else {
-          console.log("");
-          console.log(source_default.yellow(`  Deploy status: ${result.status ?? "unknown"}`));
-          if (result.deployId) {
-            console.log(source_default.gray(`  Version: ${result.deployId}`));
+        } catch (error46) {
+          if (uploadSpinner.isSpinning) {
+            uploadSpinner.fail(source_default.red("Deploy failed"));
           }
+          throw error46;
         }
-      } catch (error46) {
-        if (uploadSpinner.isSpinning) {
-          uploadSpinner.fail(source_default.red("Deploy failed"));
-        }
-        throw error46;
       }
-    })
+    )
   );
 }
 

package/dist/index.d.ts

@@ -2310,6 +2310,7 @@ type Database = {
                 Row: {
                     compiled_docs: Json | null;
                     created_at: string;
+                    deployment_version: string | null;
                     documentation: Json | null;
                     error_message: string | null;
                     id: string;
@@ -2324,6 +2325,7 @@ type Database = {
                 Insert: {
                     compiled_docs?: Json | null;
                     created_at?: string;
+                    deployment_version?: string | null;
                     documentation?: Json | null;
                     error_message?: string | null;
                     id?: string;
@@ -2338,6 +2340,7 @@ type Database = {
                 Update: {
                     compiled_docs?: Json | null;
                     created_at?: string;
+                    deployment_version?: string | null;
                     documentation?: Json | null;
                     error_message?: string | null;
                     id?: string;
@@ -3475,6 +3478,8 @@ interface RemoteOrgConfig {
     toolCredentials?: Record<string, string>;
     /** SDK version used to deploy this bundle */
     sdkVersion?: string;
+    /** Deployment version (semver) of the deployed bundle */
+    deploymentVersion?: string;
 }
 /**
  * Organization-specific resource collection
@@ -3482,7 +3487,9 @@ interface RemoteOrgConfig {
  * Complete manifest of all automation resources for an organization.
  * Used by ResourceRegistry for discovery and Command View for visualization.
  */
-interface OrganizationResources {
+interface DeploymentSpec {
+    /** Deployment version (semver) */
+    version: string;
     /** Workflow definitions */
     workflows?: WorkflowDefinition[];
     /** Agent definitions */
@@ -3498,10 +3505,12 @@ interface OrganizationResources {
     /** Human checkpoint definitions - human decision points in automation */
     humanCheckpoints?: HumanCheckpointDefinition[];
 }
+/** @deprecated Use DeploymentSpec instead */
+type OrganizationResources = DeploymentSpec;
 /**
  * Organization Registry type
  */
-type OrganizationRegistry = Record<string, OrganizationResources>;
+type OrganizationRegistry = Record<string, DeploymentSpec>;
 declare class ResourceRegistry {
     private registry;
     /**
@@ -3568,7 +3577,7 @@ declare class ResourceRegistry {
      * @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;
+    registerOrganization(orgName: string, org: DeploymentSpec, remote: RemoteOrgConfig): void;
     /**
      * Patch serialized cache with pre-serialized schemas from an external manifest.
      *
@@ -3603,7 +3612,7 @@ declare class ResourceRegistry {
      * @param orgName - Organization name
      * @param org - Resource definitions with real handlers (not stubs)
      */
-    registerStaticResources(orgName: string, org: OrganizationResources): void;
+    registerStaticResources(orgName: string, org: DeploymentSpec): void;
     /**
      * Unregister runtime-registered resources for an organization
      *
@@ -7398,4 +7407,4 @@ declare class ToolingError extends ExecutionError {
 }
 
 export { ExecutionError, RegistryValidationError, ResourceRegistry, StepType, ToolingError };
-export type { AbsoluteScheduleConfig, AcqCompany, AcqContact, AcqDeal, AcqList, AddToCampaignLead, AddToCampaignParams, AddToCampaignResult, AgentConfig, AgentConstraints, AgentDefinition, AgentMemory, FindCompanyEmailParams as AnymailfinderFindCompanyEmailParams, FindCompanyEmailResult as AnymailfinderFindCompanyEmailResult, FindDecisionMakerEmailParams as AnymailfinderFindDecisionMakerEmailParams, FindDecisionMakerEmailResult as AnymailfinderFindDecisionMakerEmailResult, FindPersonEmailParams as AnymailfinderFindPersonEmailParams, FindPersonEmailResult as AnymailfinderFindPersonEmailResult, AnymailfinderToolMap, VerifyEmailParams as AnymailfinderVerifyEmailParams, VerifyEmailResult as AnymailfinderVerifyEmailResult, ApifyToolMap, ApifyWebhookConfig, AppendRowsParams, AppendRowsResult, ApprovalToolMap, AttioToolMap, BatchUpdateParams, BatchUpdateResult, BulkDeleteLeadsParams, BulkDeleteLeadsResult, BulkImportParams, BulkImportResult, CancelHitlByDealIdParams, CancelSchedulesAndHitlByEmailParams, ClearDealFieldsParams, ClearRangeParams, ClearRangeResult, CompanyFilters, ConditionalNext, ContactFilters, Contract, CreateAttributeParams, CreateAttributeResult, CreateAutoPaymentLinkParams, CreateAutoPaymentLinkResult, CreateCheckoutSessionParams, CreateCheckoutSessionResult, CreateCompanyParams, CreateContactParams, CreateEnvelopeParams, CreateEnvelopeResult, CreateFolderParams, CreateFolderResult, CreateListParams, CreateNoteParams, CreateNoteResult, CreatePaymentLinkParams, CreatePaymentLinkResult, CreateRecordParams, CreateRecordResult, CreateScheduleInput, DeleteDealParams, DeleteNoteParams, DeleteNoteResult, DeleteRecordParams, DeleteRecordResult, DeleteRowByValueParams, DeleteRowByValueResult, DomainDefinition, DownloadDocumentParams, DownloadDocumentResult, DropboxToolMap, ElevasConfig, EmailToolMap, EnvelopeDocument, EventTriggerConfig, ExecutionContext, ExecutionInterface, ExecutionMetadata, ExecutionToolMap, FilterExpression, FilterRowsParams, FilterRowsResult, FormField, FormFieldType, FormSchema, GetDailyCampaignAnalyticsParams, GetDailyCampaignAnalyticsResult, GetEmailsParams, GetEmailsResult, GetEnvelopeParams, GetEnvelopeResult, GetHeadersParams, GetHeadersResult, GetLastRowParams, GetLastRowResult, GetPaymentLinkParams, GetPaymentLinkResult, GetRecordParams, GetRecordResult, GetRowByValueParams, GetRowByValueResult, GetSpreadsheetMetadataParams, GetSpreadsheetMetadataResult, GmailSendEmailParams, GmailSendEmailResult, GmailToolMap, GoogleSheetsToolMap, HumanCheckpointDefinition, InstantlyToolMap, IntegrationDefinition, LLMAdapterFactory, LLMGenerateRequest, LLMGenerateResponse, LLMMessage, LLMModel, LeadToolMap, LinearNext, ListAttributesParams, ListAttributesResult, ListLeadsParams, ListLeadsResult, ListNotesParams, ListNotesResult, ListObjectsResult, ListPaymentLinksParams, ListPaymentLinksResult, MarkProposalReviewedParams, MarkProposalSentParams, MethodEntry, MillionVerifierToolMap, ModelConfig, NextConfig, NotificationSDKInput, NotificationToolMap, OrganizationResources, PaginatedResult, PaginationParams, PdfToolMap, QueryRecordsParams, QueryRecordsResult, ReadSheetParams, ReadSheetResult, Recipient, RecurringScheduleConfig, RelationshipDeclaration, RelativeScheduleConfig, RemoveFromSubsequenceParams, RemoveFromSubsequenceResult, ResendGetEmailParams, ResendGetEmailResult, ResendSendEmailParams, ResendSendEmailResult, ResendToolMap, ResourceDefinition, ResourceDomain, ResourceMetricsConfig, ResourceRelationships, ResourceStatus$1 as ResourceStatus, ResourceType, RunActorParams, RunActorResult, SDKLLMGenerateParams, ScheduleOriginTracking, ScheduleTarget, ScheduleTriggerConfig, SchedulerToolMap, SendReplyParams, SendReplyResult, SetContactNurtureParams, SheetInfo, SignatureApiFieldType, SignatureApiToolMap, SigningPlace, SortCriteria, StartActorParams, StartActorResult, StepHandler, StorageDeleteInput, StorageDeleteOutput, StorageDownloadInput, StorageDownloadOutput, StorageListInput, StorageListOutput, StorageSignedUrlInput, StorageSignedUrlOutput, StorageToolMap, StorageUploadInput, StorageUploadOutput, StripeToolMap, SyncDealStageParams, TaskSchedule, TaskScheduleConfig, TombaToolMap, Tool, ToolExecutionOptions, ToolMethodMap, ToolingErrorType, TriggerConfig, TriggerDefinition, UpdateAttributeParams, UpdateAttributeResult, UpdateCloseLostReasonParams, UpdateCompanyParams, UpdateContactParams, UpdateDiscoveryDataParams, UpdateFeesParams, UpdateInterestStatusParams, UpdateInterestStatusResult, UpdateListParams, UpdatePaymentLinkParams, UpdatePaymentLinkResult, UpdateProposalDataParams, UpdateRecordParams, UpdateRecordResult, UpdateRowByValueParams, UpdateRowByValueResult, UploadFileParams, UploadFileResult, UpsertCompanyParams, UpsertContactParams, UpsertDealParams, UpsertRowParams, UpsertRowResult, VoidEnvelopeParams, VoidEnvelopeResult, WebhookProviderType, WebhookTriggerConfig, WorkflowConfig, WorkflowDefinition, WorkflowStep, WriteSheetParams, WriteSheetResult };
+export type { AbsoluteScheduleConfig, AcqCompany, AcqContact, AcqDeal, AcqList, AddToCampaignLead, AddToCampaignParams, AddToCampaignResult, AgentConfig, AgentConstraints, AgentDefinition, AgentMemory, FindCompanyEmailParams as AnymailfinderFindCompanyEmailParams, FindCompanyEmailResult as AnymailfinderFindCompanyEmailResult, FindDecisionMakerEmailParams as AnymailfinderFindDecisionMakerEmailParams, FindDecisionMakerEmailResult as AnymailfinderFindDecisionMakerEmailResult, FindPersonEmailParams as AnymailfinderFindPersonEmailParams, FindPersonEmailResult as AnymailfinderFindPersonEmailResult, AnymailfinderToolMap, VerifyEmailParams as AnymailfinderVerifyEmailParams, VerifyEmailResult as AnymailfinderVerifyEmailResult, ApifyToolMap, ApifyWebhookConfig, AppendRowsParams, AppendRowsResult, ApprovalToolMap, AttioToolMap, BatchUpdateParams, BatchUpdateResult, BulkDeleteLeadsParams, BulkDeleteLeadsResult, BulkImportParams, BulkImportResult, CancelHitlByDealIdParams, CancelSchedulesAndHitlByEmailParams, ClearDealFieldsParams, ClearRangeParams, ClearRangeResult, CompanyFilters, ConditionalNext, ContactFilters, Contract, CreateAttributeParams, CreateAttributeResult, CreateAutoPaymentLinkParams, CreateAutoPaymentLinkResult, CreateCheckoutSessionParams, CreateCheckoutSessionResult, CreateCompanyParams, CreateContactParams, CreateEnvelopeParams, CreateEnvelopeResult, CreateFolderParams, CreateFolderResult, CreateListParams, CreateNoteParams, CreateNoteResult, CreatePaymentLinkParams, CreatePaymentLinkResult, CreateRecordParams, CreateRecordResult, CreateScheduleInput, DeleteDealParams, DeleteNoteParams, DeleteNoteResult, DeleteRecordParams, DeleteRecordResult, DeleteRowByValueParams, DeleteRowByValueResult, DeploymentSpec, DomainDefinition, DownloadDocumentParams, DownloadDocumentResult, DropboxToolMap, ElevasConfig, EmailToolMap, EnvelopeDocument, EventTriggerConfig, ExecutionContext, ExecutionInterface, ExecutionMetadata, ExecutionToolMap, FilterExpression, FilterRowsParams, FilterRowsResult, FormField, FormFieldType, FormSchema, GetDailyCampaignAnalyticsParams, GetDailyCampaignAnalyticsResult, GetEmailsParams, GetEmailsResult, GetEnvelopeParams, GetEnvelopeResult, GetHeadersParams, GetHeadersResult, GetLastRowParams, GetLastRowResult, GetPaymentLinkParams, GetPaymentLinkResult, GetRecordParams, GetRecordResult, GetRowByValueParams, GetRowByValueResult, GetSpreadsheetMetadataParams, GetSpreadsheetMetadataResult, GmailSendEmailParams, GmailSendEmailResult, GmailToolMap, GoogleSheetsToolMap, HumanCheckpointDefinition, InstantlyToolMap, IntegrationDefinition, LLMAdapterFactory, LLMGenerateRequest, LLMGenerateResponse, LLMMessage, LLMModel, LeadToolMap, LinearNext, ListAttributesParams, ListAttributesResult, ListLeadsParams, ListLeadsResult, ListNotesParams, ListNotesResult, ListObjectsResult, ListPaymentLinksParams, ListPaymentLinksResult, MarkProposalReviewedParams, MarkProposalSentParams, MethodEntry, MillionVerifierToolMap, ModelConfig, NextConfig, NotificationSDKInput, NotificationToolMap, OrganizationResources, PaginatedResult, PaginationParams, PdfToolMap, QueryRecordsParams, QueryRecordsResult, ReadSheetParams, ReadSheetResult, Recipient, RecurringScheduleConfig, RelationshipDeclaration, RelativeScheduleConfig, RemoveFromSubsequenceParams, RemoveFromSubsequenceResult, ResendGetEmailParams, ResendGetEmailResult, ResendSendEmailParams, ResendSendEmailResult, ResendToolMap, ResourceDefinition, ResourceDomain, ResourceMetricsConfig, ResourceRelationships, ResourceStatus$1 as ResourceStatus, ResourceType, RunActorParams, RunActorResult, SDKLLMGenerateParams, ScheduleOriginTracking, ScheduleTarget, ScheduleTriggerConfig, SchedulerToolMap, SendReplyParams, SendReplyResult, SetContactNurtureParams, SheetInfo, SignatureApiFieldType, SignatureApiToolMap, SigningPlace, SortCriteria, StartActorParams, StartActorResult, StepHandler, StorageDeleteInput, StorageDeleteOutput, StorageDownloadInput, StorageDownloadOutput, StorageListInput, StorageListOutput, StorageSignedUrlInput, StorageSignedUrlOutput, StorageToolMap, StorageUploadInput, StorageUploadOutput, StripeToolMap, SyncDealStageParams, TaskSchedule, TaskScheduleConfig, TombaToolMap, Tool, ToolExecutionOptions, ToolMethodMap, ToolingErrorType, TriggerConfig, TriggerDefinition, UpdateAttributeParams, UpdateAttributeResult, UpdateCloseLostReasonParams, UpdateCompanyParams, UpdateContactParams, UpdateDiscoveryDataParams, UpdateFeesParams, UpdateInterestStatusParams, UpdateInterestStatusResult, UpdateListParams, UpdatePaymentLinkParams, UpdatePaymentLinkResult, UpdateProposalDataParams, UpdateRecordParams, UpdateRecordResult, UpdateRowByValueParams, UpdateRowByValueResult, UploadFileParams, UploadFileResult, UpsertCompanyParams, UpsertContactParams, UpsertDealParams, UpsertRowParams, UpsertRowResult, VoidEnvelopeParams, VoidEnvelopeResult, WebhookProviderType, WebhookTriggerConfig, WorkflowConfig, WorkflowDefinition, WorkflowStep, WriteSheetParams, WriteSheetResult };

package/dist/index.js

@@ -426,7 +426,7 @@ var RegistryValidationError = class extends Error {
     this.name = "RegistryValidationError";
   }
 };
-function validateOrganizationResources(orgName, resources) {
+function validateDeploymentSpec(orgName, resources) {
   const seenIds = /* @__PURE__ */ new Set();
   resources.workflows?.forEach((workflow) => {
     const id = workflow.config.resourceId;
@@ -558,7 +558,8 @@ function isZodOptional(schema) {
   return schema.isOptional();
 }
 function validateRelationships(orgName, resources) {
-  if (!resources.relationships && !resources.triggers && !resources.externalResources && !resources.humanCheckpoints) return;
+  if (!resources.relationships && !resources.triggers && !resources.externalResources && !resources.humanCheckpoints)
+    return;
   const validAgentIds = new Set(resources.agents?.map((a) => a.config.resourceId) ?? []);
   const validWorkflowIds = new Set(resources.workflows?.map((w) => w.config.resourceId) ?? []);
   const validIntegrationIds = new Set(resources.integrations?.map((i) => i.resourceId) ?? []);
@@ -3027,6 +3028,7 @@ function serializeOrganization(resources) {
   const humanCheckpoints = resources.humanCheckpoints ?? [];
   const domainDefinitions = deriveDomainDefinitions(resources);
   return {
+    version: resources.version,
     resources: {
       workflows: workflowResources,
       agents: agentResources,
@@ -3185,7 +3187,7 @@ var ResourceRegistry = class {
    */
   validateRegistry() {
     for (const [orgName, resources] of Object.entries(this.registry)) {
-      validateOrganizationResources(orgName, resources);
+      validateDeploymentSpec(orgName, resources);
     }
   }
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "0.9.7",
+  "version": "1.0.1",
   "description": "SDK for building Elevasis organization resources",
   "type": "module",
   "bin": {
@@ -50,8 +50,8 @@
     "tsup": "^8.0.0",
     "typescript": "5.9.2",
     "zod": "^4.1.0",
-    "@repo/core": "0.0.0",
-    "@repo/typescript-config": "0.0.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 --banner:js=\"#!/usr/bin/env node\" && node scripts/copy-reference-docs.mjs && node scripts/generate-navigation.mjs",