@agentic-surfaces/core 0.1.27 → 0.1.29

package/dist/executor.js

@@ -1,4 +1,10 @@
 import { withRetry } from "./policy.js";
+// Process-global, monotonic run-id counter. Each runWorkflow() call (top-level or a foreach
+// sub-run) gets a distinct id so the dashboard can attribute every event to its own run.
+let runSeq = 0;
+function newRunId() {
+    return `run_${(++runSeq).toString(16).padStart(6, "0")}`;
+}
 export async function runWorkflow(opts) {
     const { workflow, triggerNodeId, registry, services, payload, observer } = opts;
     const byId = new Map(workflow.nodes.map(n => [n.id, n]));
@@ -10,9 +16,11 @@ export async function runWorkflow(opts) {
         services,
         observer,
     };
+    const runId = newRunId();
+    ctx.runId = runId; // so handlers (agent.run) can tag their activity with this run
     const queue = [triggerNodeId];
     const visited = new Set();
-    observer?.onRunStart?.(workflow.name, ctx.triggerPayload);
+    observer?.onRunStart?.(workflow.name, ctx.triggerPayload, runId);
     while (queue.length > 0) {
         const id = queue.shift();
         if (visited.has(id))
@@ -22,7 +30,7 @@ export async function runWorkflow(opts) {
         if (!node)
             throw new Error(`workflow references missing node: ${id}`);
         const handler = registry.get(node.type);
-        observer?.onNodeStart?.(id);
+        observer?.onNodeStart?.(id, runId);
         let result;
         let nodeErrored = false;
         try {
@@ -32,12 +40,12 @@ export async function runWorkflow(opts) {
             nodeErrored = true;
             const message = err instanceof Error ? err.message : String(err);
             services.logger?.error?.(`node ${node.id} failed`, { workflow: workflow.name, error: message });
-            observer?.onNodeFinish?.(id, "failed", { error: message });
+            observer?.onNodeFinish?.(id, "failed", { error: message }, runId);
             if (node.onError === "continue") {
                 result = { output: { error: message } };
             }
             else {
-                observer?.onRunFinish?.(workflow.name, "failed");
+                observer?.onRunFinish?.(workflow.name, "failed", runId);
                 throw err;
             }
         }
@@ -45,7 +53,7 @@ export async function runWorkflow(opts) {
         // Surface the node's output so observers (e.g. the live UI) can show what each
         // node produced/fetched — the data is what you need when debugging a run.
         if (!nodeErrored)
-            observer?.onNodeFinish?.(id, "success", { output: result.output });
+            observer?.onNodeFinish?.(id, "success", { output: result.output }, runId);
         const branches = result.branches;
         for (const edge of workflow.edges) {
             if (edge.from !== id)
@@ -55,6 +63,6 @@ export async function runWorkflow(opts) {
             }
         }
     }
-    observer?.onRunFinish?.(workflow.name, "success");
+    observer?.onRunFinish?.(workflow.name, "success", runId);
     return ctx.outputs;
 }

package/dist/handlers/agent.js

@@ -64,8 +64,8 @@ export const agentHandler = {
             cwd: ctx.services.projectDir,
             dryRun: ctx.services.dryRun,
             log: (m) => ctx.services.logger?.info?.(m),
-            // Stream the agent's reasoning + tool/MCP calls to the run observer, tagged with this node.
-            onActivity: (a) => ctx.observer?.onNodeActivity?.(node.id, a),
+            // Stream the agent's reasoning + tool/MCP calls to the run observer, tagged with node + run.
+            onActivity: (a) => ctx.observer?.onNodeActivity?.(node.id, a, ctx.runId),
         });
         // Decision agent: guarantee the chosen command is on the allowlist (else use
         // the fallback), and surface it at the top level so task.branch can route.

package/dist/project-config.d.ts

@@ -32,6 +32,7 @@ declare const ProjectConfigSchema: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     workflows: z.ZodOptional<z.ZodString>;
+    atlassianSite: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type ProjectConfig = z.infer<typeof ProjectConfigSchema>;
 /**

package/dist/project-config.js

@@ -28,6 +28,9 @@ const ProjectConfigSchema = z.object({
     })
         .default({ runner: "claude", model: "claude-opus-4-8" }),
     workflows: z.string().optional(), // relative subdir; omitted = use dir itself
+    // Atlassian site host (e.g. "sojournii.atlassian.net") — lets the dashboard build browse/wiki
+    // links to the issues/pages a run touched. Optional; links also come from MCP tool results.
+    atlassianSite: z.string().optional(),
 });
 const CONFIG_FILENAME = "agentic-surfaces.config.yaml";
 /**

package/dist/types.d.ts

@@ -1,6 +1,6 @@
-import type { AgentRunner, McpServerRef, AgentActivity, Capabilities } from "@agentic-surfaces/agent";
+import type { AgentRunner, McpServerRef, AgentActivity, Capabilities, PlanUsage, PlanWindow } from "@agentic-surfaces/agent";
 import type { AgentDefinition } from "./agents.js";
-export type { AgentRunner, McpServerRef, AgentActivity, Capabilities };
+export type { AgentRunner, McpServerRef, AgentActivity, Capabilities, PlanUsage, PlanWindow };
 export type NodeType = "trigger.cron" | "trigger.webhook" | "trigger.command" | "task.http" | "task.transform" | "task.branch" | "task.run-workflow" | "task.foreach" | "task.cache-unseen" | "task.cache-mark" | "agent.run";
 export interface RetryPolicy {
     maxAttempts: number;
@@ -72,6 +72,8 @@ export interface Services {
 }
 export interface RunContext {
     workflow: Workflow;
+    /** Unique id for this run, set by the executor — handlers tag their observer activity with it. */
+    runId?: string;
     outputs: Map<string, unknown>;
     triggerNodeId: string;
     triggerPayload?: unknown;
@@ -88,10 +90,10 @@ export interface NodeHandler {
     execute(node: WorkflowNode, ctx: RunContext): Promise<NodeResult>;
 }
 export interface RunObserver {
-    onRunStart?(workflow: string, payload?: unknown): void;
-    onNodeStart?(nodeId: string): void;
-    onNodeFinish?(nodeId: string, status: "success" | "failed", meta?: unknown): void;
+    onRunStart?(workflow: string, payload?: unknown, runId?: string): void;
+    onNodeStart?(nodeId: string, runId?: string): void;
+    onNodeFinish?(nodeId: string, status: "success" | "failed", meta?: unknown, runId?: string): void;
     /** A live step of an agent node's work (reasoning, a tool/MCP call, or a result). */
-    onNodeActivity?(nodeId: string, activity: AgentActivity): void;
-    onRunFinish?(workflow: string, status: "success" | "failed"): void;
+    onNodeActivity?(nodeId: string, activity: AgentActivity, runId?: string): void;
+    onRunFinish?(workflow: string, status: "success" | "failed", runId?: string): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentic-surfaces/core",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "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.27"
+    "@agentic-surfaces/agent": "0.1.29"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",