novyx 3.1.0 → 3.2.0

package/dist/index.d.mts

@@ -715,7 +715,32 @@ declare class Novyx {
     memoryHealth(): Promise<Record<string, any>>;
     private _controlRequest;
     /** Submit an action to Novyx Control for governed execution. */
+    /**
+     * Submit a governed action envelope to a separate Novyx Control instance.
+     * Legacy path. For the main Novyx Cloud governance flow, use `submitAction()`.
+     */
     actionSubmit(connector: string, operation: string, payload: Record<string, any>): Promise<any>;
+    /**
+     * Submit an action to the main Novyx Cloud governance flow.
+     *
+     * Evaluates against built-in + custom YAML policies (tenant-wide and
+     * optionally agent-scoped) via `POST /v1/actions` on the main API.
+     * Returns one of three statuses:
+     * - `"allowed"` — passed all policies
+     * - `"blocked"` — critical violation, action stopped
+     * - `"pending_review"` — high-severity violation routed to approval queue
+     *
+     * @example
+     * const result = await nx.submitAction("send_invoice", { amount: 50000 }, {
+     *   agent_id: "billing-bot",
+     * });
+     * if (result.status === "pending_review") {
+     *   console.log(`Awaiting approval: ${result.policy_result.action_id}`);
+     * }
+     */
+    submitAction(action: string, params?: Record<string, any>, opts?: {
+        agent_id?: string;
+    }): Promise<Record<string, any>>;
     /** Get the status of a Control action. */
     actionStatus(actionId: string): Promise<any>;
     /** List recent Control actions. */

package/dist/index.d.ts

@@ -715,7 +715,32 @@ declare class Novyx {
     memoryHealth(): Promise<Record<string, any>>;
     private _controlRequest;
     /** Submit an action to Novyx Control for governed execution. */
+    /**
+     * Submit a governed action envelope to a separate Novyx Control instance.
+     * Legacy path. For the main Novyx Cloud governance flow, use `submitAction()`.
+     */
     actionSubmit(connector: string, operation: string, payload: Record<string, any>): Promise<any>;
+    /**
+     * Submit an action to the main Novyx Cloud governance flow.
+     *
+     * Evaluates against built-in + custom YAML policies (tenant-wide and
+     * optionally agent-scoped) via `POST /v1/actions` on the main API.
+     * Returns one of three statuses:
+     * - `"allowed"` — passed all policies
+     * - `"blocked"` — critical violation, action stopped
+     * - `"pending_review"` — high-severity violation routed to approval queue
+     *
+     * @example
+     * const result = await nx.submitAction("send_invoice", { amount: 50000 }, {
+     *   agent_id: "billing-bot",
+     * });
+     * if (result.status === "pending_review") {
+     *   console.log(`Awaiting approval: ${result.policy_result.action_id}`);
+     * }
+     */
+    submitAction(action: string, params?: Record<string, any>, opts?: {
+        agent_id?: string;
+    }): Promise<Record<string, any>>;
     /** Get the status of a Control action. */
     actionStatus(actionId: string): Promise<any>;
     /** List recent Control actions. */

package/dist/index.js

@@ -851,9 +851,36 @@ var Novyx = class {
     }
   }
   /** Submit an action to Novyx Control for governed execution. */
+  /**
+   * Submit a governed action envelope to a separate Novyx Control instance.
+   * Legacy path. For the main Novyx Cloud governance flow, use `submitAction()`.
+   */
   async actionSubmit(connector, operation, payload) {
     return this._controlRequest("POST", `/v1/actions/${connector}/${operation}`, { body: payload });
   }
+  /**
+   * Submit an action to the main Novyx Cloud governance flow.
+   *
+   * Evaluates against built-in + custom YAML policies (tenant-wide and
+   * optionally agent-scoped) via `POST /v1/actions` on the main API.
+   * Returns one of three statuses:
+   * - `"allowed"` — passed all policies
+   * - `"blocked"` — critical violation, action stopped
+   * - `"pending_review"` — high-severity violation routed to approval queue
+   *
+   * @example
+   * const result = await nx.submitAction("send_invoice", { amount: 50000 }, {
+   *   agent_id: "billing-bot",
+   * });
+   * if (result.status === "pending_review") {
+   *   console.log(`Awaiting approval: ${result.policy_result.action_id}`);
+   * }
+   */
+  async submitAction(action, params = {}, opts) {
+    const body = { action, params };
+    if (opts?.agent_id !== void 0) body.agent_id = opts.agent_id;
+    return this._request("POST", "/v1/actions", { body });
+  }
   /** Get the status of a Control action. */
   async actionStatus(actionId) {
     return this._controlRequest("GET", `/v1/actions/${actionId}`);

package/dist/index.mjs

@@ -818,9 +818,36 @@ var Novyx = class {
     }
   }
   /** Submit an action to Novyx Control for governed execution. */
+  /**
+   * Submit a governed action envelope to a separate Novyx Control instance.
+   * Legacy path. For the main Novyx Cloud governance flow, use `submitAction()`.
+   */
   async actionSubmit(connector, operation, payload) {
     return this._controlRequest("POST", `/v1/actions/${connector}/${operation}`, { body: payload });
   }
+  /**
+   * Submit an action to the main Novyx Cloud governance flow.
+   *
+   * Evaluates against built-in + custom YAML policies (tenant-wide and
+   * optionally agent-scoped) via `POST /v1/actions` on the main API.
+   * Returns one of three statuses:
+   * - `"allowed"` — passed all policies
+   * - `"blocked"` — critical violation, action stopped
+   * - `"pending_review"` — high-severity violation routed to approval queue
+   *
+   * @example
+   * const result = await nx.submitAction("send_invoice", { amount: 50000 }, {
+   *   agent_id: "billing-bot",
+   * });
+   * if (result.status === "pending_review") {
+   *   console.log(`Awaiting approval: ${result.policy_result.action_id}`);
+   * }
+   */
+  async submitAction(action, params = {}, opts) {
+    const body = { action, params };
+    if (opts?.agent_id !== void 0) body.agent_id = opts.agent_id;
+    return this._request("POST", "/v1/actions", { body });
+  }
   /** Get the status of a Control action. */
   async actionStatus(actionId) {
     return this._controlRequest("GET", `/v1/actions/${actionId}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "novyx",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "Novyx SDK - Persistent memory, rollback, and audit trail for AI agents",
   "main": "dist/index.js",
   "module": "dist/index.mjs",