@agentic-surfaces/core 0.1.26 → 0.1.27

package/dist/handlers/agent.js

@@ -79,11 +79,11 @@ export const agentHandler = {
                 else
                     throw new Error(`agent ${cfg.agent} returned an off-allowlist command: ${String(raw)}`);
             }
-            return { output: { command, text: result.text, skillsUsed: result.skillsUsed, toolsUsed: result.toolsUsed } };
+            return { output: { command, text: result.text, skillsUsed: result.skillsUsed, toolsUsed: result.toolsUsed, usage: result.usage } };
         }
         // Inline decision schema: surface its fields at the top level (0.1.7 behaviour).
         if (cfg.decision && result.data && typeof result.data === "object" && !Array.isArray(result.data)) {
-            return { output: { ...result.data, text: result.text, skillsUsed: result.skillsUsed, toolsUsed: result.toolsUsed } };
+            return { output: { ...result.data, text: result.text, skillsUsed: result.skillsUsed, toolsUsed: result.toolsUsed, usage: result.usage } };
         }
         return { output: result };
     },

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export * from "./cache.js";
 export * from "./observer.js";
 export * from "./secrets.js";
 export * from "./project-config.js";
+export * from "./pause.js";
 export * from "./agents.js";
 export * from "./handlers/foreach.js";
 export * from "./handlers/run-workflow.js";

package/dist/index.js

@@ -7,6 +7,7 @@ export * from "./cache.js";
 export * from "./observer.js";
 export * from "./secrets.js";
 export * from "./project-config.js";
+export * from "./pause.js";
 export * from "./agents.js";
 export * from "./handlers/foreach.js";
 export * from "./handlers/run-workflow.js";

package/dist/pause.d.ts

@@ -0,0 +1,21 @@
+/**
+ * A platform-wide play/pause switch. When paused, the scheduler stops firing cron workflows
+ * (in-flight runs finish; new scheduled fires are skipped). It's a master switch for the
+ * autonomous loop — manual dashboard runs still work.
+ */
+export interface PauseState {
+    isPaused(): boolean;
+    pause(): void;
+    resume(): void;
+}
+/**
+ * File-backed pause state: the presence of a sentinel file (default `.flow-paused`) means paused.
+ * A file (not in-memory) so the state survives a `start --watch` restart and is inspectable.
+ */
+export declare class FilePauseState implements PauseState {
+    private readonly path;
+    constructor(path?: string);
+    isPaused(): boolean;
+    pause(): void;
+    resume(): void;
+}

package/dist/pause.js

@@ -0,0 +1,26 @@
+import { existsSync, writeFileSync, rmSync } from "node:fs";
+/**
+ * File-backed pause state: the presence of a sentinel file (default `.flow-paused`) means paused.
+ * A file (not in-memory) so the state survives a `start --watch` restart and is inspectable.
+ */
+export class FilePauseState {
+    path;
+    constructor(path = ".flow-paused") {
+        this.path = path;
+    }
+    isPaused() {
+        return existsSync(this.path);
+    }
+    pause() {
+        if (!this.isPaused())
+            writeFileSync(this.path, `paused ${new Date().toISOString()}\n`);
+    }
+    resume() {
+        try {
+            rmSync(this.path);
+        }
+        catch {
+            /* already gone — nothing to do */
+        }
+    }
+}

package/dist/scheduler.d.ts

@@ -1,4 +1,5 @@
 import { HandlerRegistry } from "./registry.js";
+import type { PauseState } from "./pause.js";
 import type { RunObserver, Services, Workflow } from "./types.js";
 export declare function defaultRegistry(): HandlerRegistry;
 export declare function runWorkflowOnce(workflow: Workflow, opts: {
@@ -19,11 +20,15 @@ export declare class Scheduler {
     private services;
     private registry;
     private observer;
+    /** When set + paused, scheduled cron fires are skipped (the platform-wide play/pause switch). */
+    private pause?;
     private crons;
     private active;
     private pending;
     private workflows;
-    constructor(services: Services, registry?: HandlerRegistry, observer?: RunObserver);
+    constructor(services: Services, registry?: HandlerRegistry, observer?: RunObserver, 
+    /** When set + paused, scheduled cron fires are skipped (the platform-wide play/pause switch). */
+    pause?: PauseState | undefined);
     add(workflow: Workflow): void;
     start(): void;
     private enqueue;

package/dist/scheduler.js

@@ -58,14 +58,18 @@ export class Scheduler {
     services;
     registry;
     observer;
+    pause;
     crons = [];
     active = 0;
     pending = [];
     workflows = [];
-    constructor(services, registry = defaultRegistry(), observer = new ConsoleObserver()) {
+    constructor(services, registry = defaultRegistry(), observer = new ConsoleObserver(), 
+    /** When set + paused, scheduled cron fires are skipped (the platform-wide play/pause switch). */
+    pause) {
         this.services = services;
         this.registry = registry;
         this.observer = observer;
+        this.pause = pause;
     }
     add(workflow) { this.workflows.push(workflow); }
     start() {
@@ -74,14 +78,21 @@ export class Scheduler {
                 if (node.type !== "trigger.cron")
                     continue;
                 const pattern = String(node.config.cron);
-                this.crons.push(new Cron(pattern, () => this.enqueue(() => runWorkflowOnce(wf, { registry: this.registry, services: this.services, triggerNodeId: node.id, observer: this.observer })
-                    .then(() => { })
-                    // A failed scheduled run must not crash the scheduler (unhandled
-                    // rejection). The failure is already reported to the observer; log
-                    // and carry on so the next trigger still fires.
-                    .catch((err) => this.services.logger?.error?.("scheduled run failed", {
-                    workflow: wf.name, error: err instanceof Error ? err.message : String(err),
-                })))));
+                this.crons.push(new Cron(pattern, () => {
+                    // Platform-wide pause: skip this scheduled fire (in-flight runs are unaffected).
+                    if (this.pause?.isPaused()) {
+                        this.services.logger?.info?.(`paused — skipping scheduled run of ${wf.name}`);
+                        return;
+                    }
+                    this.enqueue(() => runWorkflowOnce(wf, { registry: this.registry, services: this.services, triggerNodeId: node.id, observer: this.observer })
+                        .then(() => { })
+                        // A failed scheduled run must not crash the scheduler (unhandled
+                        // rejection). The failure is already reported to the observer; log
+                        // and carry on so the next trigger still fires.
+                        .catch((err) => this.services.logger?.error?.("scheduled run failed", {
+                        workflow: wf.name, error: err instanceof Error ? err.message : String(err),
+                    })));
+                }));
             }
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentic-surfaces/core",
-  "version": "0.1.26",
+  "version": "0.1.27",
   "type": "module",
   "license": "MIT",
   "publishConfig": {
@@ -24,7 +24,7 @@
     "jsonata": "^2.2.1",
     "yaml": "^2.9.0",
     "zod": "^4.4.3",
-    "@agentic-surfaces/agent": "0.1.26"
+    "@agentic-surfaces/agent": "0.1.27"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",