@agent-native/core 0.136.3 → 0.136.4

package/dist/triggers/actions.js

@@ -5,12 +5,13 @@
  * available in every template. The agent uses them to create, list, and
  * manage automations from chat.
  *
- * All six operations are consolidated into a single `manage-automations` tool
+ * All seven operations are consolidated into a single `manage-automations` tool
  * with an `action` discriminator to keep the tool registry compact.
  */
 import { defineAutomation, deleteAutomation, listAutomationDefinitions, updateAutomation, } from "../automations/service.js";
 import { listEvents } from "../event-bus/index.js";
 import { describeCron, effectiveTimezone } from "../jobs/cron.js";
+import { queueAutomationRunNow } from "../jobs/run-now.js";
 import { getIntegrationRequestContext, getRequestOrgId, } from "../server/request-context.js";
 import { refreshEventSubscriptions } from "./dispatcher.js";
 /* ------------------------------------------------------------------ */
@@ -235,6 +236,23 @@ async function handleFireTest(args, getCurrentUser) {
     emit("test.event.fired", { data }, { owner });
     return `Test event fired with payload: ${JSON.stringify({ data })}. Any automations subscribed to "test.event.fired" will be evaluated.`;
 }
+async function handleRunNow(args, getCurrentUser, context) {
+    if (context?.caller === "automation") {
+        return "Error: an automation cannot run another automation.";
+    }
+    try {
+        const result = await queueAutomationRunNow({
+            userEmail: getCurrentUser(),
+            orgId: getRequestOrgId(),
+            scope: automationScope(args.scope),
+            name: typeof args.name === "string" ? args.name : "",
+        });
+        return JSON.stringify(result);
+    }
+    catch (error) {
+        return `Error: ${error.message}`;
+    }
+}
 /* ------------------------------------------------------------------ */
 /*  Consolidated tool entry                                           */
 /* ------------------------------------------------------------------ */
@@ -245,6 +263,7 @@ const VALID_ACTIONS = [
     "update",
     "delete",
     "fire-test",
+    "run-now",
 ];
 export function createAutomationToolEntries(getCurrentUser) {
     return {
@@ -257,18 +276,19 @@ export function createAutomationToolEntries(getCurrentUser) {
 - **define**: Create a new automation. IMPORTANT: Always confirm with the user before calling — show them a summary of what will be created. Required params: name, trigger_type, body. Optional: scope, event, schedule, timezone, condition, mode, domain, delegated_policy_id, model, mcpTools.
 - **update**: Update an existing automation's settings without changing its creator (enabled, schedule, timezone, condition, body, policy, model, MCP allowlist). Required param: name. Use the same scope it was created in.
 - **delete**: Delete an automation. Always confirm with the user first. Required param: name.
-- **fire-test**: Fire a test event to validate automations. Emits a test.event.fired event. Optional param: data (JSON string).`,
+- **fire-test**: Fire a test event to validate automations. Emits a test.event.fired event. Optional param: data (JSON string).
+- **run-now**: Run one automation immediately using its real actions and side effects. This is an explicit user-authorized run and returns a durable run id; it does not change the automation's next scheduled run. Required params: name; optional scope.`,
                 parameters: {
                     type: "object",
                     properties: {
                         action: {
                             type: "string",
-                            description: "The operation to perform: list-events, list, define, update, delete, or fire-test.",
+                            description: "The operation to perform: list-events, list, define, update, delete, fire-test, or run-now.",
                             enum: [...VALID_ACTIONS],
                         },
                         name: {
                             type: "string",
-                            description: "Slug name for the automation (lowercase, hyphens). Used by define, update, and delete.",
+                            description: "Slug name for the automation (lowercase, hyphens). Used by define, update, delete, and run-now.",
                         },
                         scope: {
                             type: "string",
@@ -345,7 +365,7 @@ export function createAutomationToolEntries(getCurrentUser) {
                 allowedValues: { action: ["list-events", "list"] },
                 description: "Plan mode allows listing automations and event types.",
             },
-            run: async (args) => {
+            run: async (args, context) => {
                 const action = args.action;
                 switch (action) {
                     case "list-events":
@@ -360,6 +380,8 @@ export function createAutomationToolEntries(getCurrentUser) {
                         return handleDelete(args, getCurrentUser);
                     case "fire-test":
                         return handleFireTest(args, getCurrentUser);
+                    case "run-now":
+                        return handleRunNow(args, getCurrentUser, context);
                     default:
                         return `Error: unknown action "${action}". Valid actions: ${VALID_ACTIONS.join(", ")}.`;
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.136.3",
+  "version": "0.136.4",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {

package/src/templates/workspace-core/.agents/skills/automations/SKILL.md

@@ -103,6 +103,7 @@ All automation operations are accessed through a single `manage-automations` too
 | `update`      | Update an existing automation (enabled, condition, body)             |
 | `delete`      | Delete an automation (always confirm with user first)                |
 | `fire-test`   | Emit a `test.event.fired` event to validate automations              |
+| `run-now`     | Run one automation immediately with its real actions and side effects |
 
 Additional tool: `web-request` — outbound HTTP with `${keys.NAME}` substitution.