@convilyn/sdk-author 0.7.0 → 0.9.0

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { VERSION, allChecksPassed, serve, runComplianceChecks, ConvilynClient, ConvilynApiError, WorkflowSpec } from './chunk-ZNZXT5ZP.js';
+import { VERSION, allChecksPassed, serve, runComplianceChecks, ConvilynClient, ConvilynApiError, WorkflowSpec } from './chunk-3TXBARBR.js';
 import { Command } from 'commander';
 import { mkdir, writeFile, stat, readdir } from 'fs/promises';
 import { resolve, join, extname } from 'path';

package/dist/index.cjs

@@ -6,16 +6,22 @@ var zodToJsonSchema = require('zod-to-json-schema');
 var http = require('http');
 
 // src/version.ts
-var VERSION = "0.7.0";
+var VERSION = "0.9.0";
 var MANIFEST_SDK_VERSION = "1.0.0";
 
 // src/errors.ts
+var CONVILYN_AUTHOR_ERROR_BRAND = /* @__PURE__ */ Symbol.for("@convilyn/sdk-author.ConvilynAuthorError");
 var ConvilynAuthorError = class extends Error {
+  /** @internal brand marker — see {@link isConvilynAuthorError} */
+  [CONVILYN_AUTHOR_ERROR_BRAND] = true;
   constructor(message) {
     super(message);
     this.name = "ConvilynAuthorError";
   }
 };
+function isConvilynAuthorError(err) {
+  return typeof err === "object" && err !== null && err[CONVILYN_AUTHOR_ERROR_BRAND] === true;
+}
 var InvalidSignatureError = class extends ConvilynAuthorError {
   reason;
   constructor(reason, message) {
@@ -731,8 +737,22 @@ function compileInputSchema(schema) {
   if (json.type === "object") {
     json.additionalProperties = false;
   }
+  assertSchemaNotSilentlyEmpty(schema, json);
   return json;
 }
+function assertSchemaNotSilentlyEmpty(schema, json) {
+  const shape = schema.shape;
+  const declaredFieldCount = isRecord2(shape) ? Object.keys(shape).length : 0;
+  if (declaredFieldCount === 0) {
+    return;
+  }
+  const compiledFieldCount = isRecord2(json.properties) ? Object.keys(json.properties).length : 0;
+  if (compiledFieldCount === 0) {
+    throw new Error(
+      `defineTool: the input schema declares ${declaredFieldCount} field(s) but zod-to-json-schema produced an empty input_schema. This usually means two separate 'zod' module instances are loaded (zod is a peerDependency \u2014 check for a nested/duplicate zod install), or the server was built with a raw 'tsc' compile instead of the documented 'tsup' build.`
+    );
+  }
+}
 function defineTool(def) {
   if (!def.name) {
     throw new Error("defineTool: name is required");
@@ -1438,14 +1458,30 @@ var ConvilynClient = class {
    * key. No auth required. The returned key is captured on this client for
    * subsequent calls (and returned so the caller can persist it — it is shown
    * only once).
+   *
+   * A 503 with code `REGISTRATION_STORE_UNAVAILABLE` means the platform's
+   * registration store is temporarily unreachable — it is NOT a problem with
+   * your request; retry in a few minutes. The error message spells this out.
    */
   async register(request) {
-    const result = await this.#request(
-      "POST",
-      "/developers/register",
-      request,
-      false
-    );
+    let result;
+    try {
+      result = await this.#request(
+        "POST",
+        "/developers/register",
+        request,
+        false
+      );
+    } catch (error) {
+      if (error instanceof ConvilynApiError && error.status === 503 && extractErrorCode(error.body) === "REGISTRATION_STORE_UNAVAILABLE") {
+        throw new ConvilynApiError(
+          503,
+          "Developer registration is temporarily unavailable (registration store unreachable). This is not a problem with your request \u2014 retry in a few minutes. [REGISTRATION_STORE_UNAVAILABLE]",
+          error.body
+        );
+      }
+      throw error;
+    }
     if (result.api_key && !this.#apiKey) {
       this.#apiKey = result.api_key;
     }
@@ -1480,9 +1516,17 @@ var ConvilynClient = class {
     await this.#request("DELETE", `/developers/servers/${encodeURIComponent(serverId)}`);
   }
   // ── Workflow operations ─────────────────────────────────────────
-  /** `POST /developers/workflows` — submit a compiled workflow spec + its server ids. */
+  /**
+   * `POST /developers/workflows` — submit a compiled workflow spec + its
+   * server ids. `server_ids` may be omitted for a server-less spec that uses
+   * only platform built-in tools; the wire always carries an explicit array
+   * (parity with the Python SDK's `list(server_ids)`).
+   */
   async submitWorkflow(request) {
-    return this.#request("POST", "/developers/workflows", request);
+    return this.#request("POST", "/developers/workflows", {
+      workflow_spec: request.workflow_spec,
+      server_ids: request.server_ids ?? []
+    });
   }
   /** `GET /developers/workflows` — list this developer's workflows. */
   async listWorkflows() {
@@ -1559,6 +1603,23 @@ var ConvilynClient = class {
     return [];
   }
 };
+function extractErrorCode(body) {
+  if (typeof body !== "object" || body === null) {
+    return null;
+  }
+  const record = body;
+  if (typeof record.code === "string") {
+    return record.code;
+  }
+  const detail = record.detail;
+  if (typeof detail === "object" && detail !== null) {
+    const code = detail.code;
+    if (typeof code === "string") {
+      return code;
+    }
+  }
+  return null;
+}
 
 // src/harness.ts
 async function invokeTool(server, toolName, args = {}, options = {}) {
@@ -1616,6 +1677,7 @@ exports.devInsecureRequested = devInsecureRequested;
 exports.failedChecks = failedChecks;
 exports.generateRefId = generateRefId;
 exports.invokeTool = invokeTool;
+exports.isConvilynAuthorError = isConvilynAuthorError;
 exports.mintConfirmationToken = mintConfirmationToken;
 exports.normalizeForDigest = normalizeForDigest;
 exports.runComplianceChecks = runComplianceChecks;