@xyne/workflow-sdk 3.2.33 → 3.2.35

package/dist/agents/provider.d.ts

@@ -0,0 +1,227 @@
+/**
+ * Agent provider port — the seam between a workflow's agent step and whoever
+ * actually runs the agent.
+ *
+ * The SDK ships one agent implementation ({@link AgentStep}, which drives an
+ * LLM directly through a pi-mono runtime). That works when the SDK owns the
+ * agent: the step config carries the system prompt, the tool list and the turn
+ * budget, and the SDK drives the loop.
+ *
+ * It does not work when the *host* already owns agent lifecycle. In xyne-spaces
+ * agents live in claw; in xyne-search they live in an `agents` table. In both
+ * cases the prompt, tools, MCP connections and model are the host's to resolve
+ * — a workflow step should name an agent and hand it a task, not re-specify it.
+ *
+ * A provider is that: the host's agent platform, behind a port. It resolves
+ * config into a run and reports back; the step keeps the workflow contract
+ * (output shape, JSON repair, citations, artifacts). See ./host-agent-step.ts.
+ *
+ * Two transports, because hosts genuinely have both:
+ *
+ *  - {@link SyncAgentCapability} streams the run. The step holds a worker slot
+ *    for its duration and forwards progress to the execution viewer. Right for
+ *    a workflow someone is watching.
+ *  - {@link AsyncAgentCapability} dispatches the run and parks the step. The
+ *    worker slot is released and the execution resumes on callback. Right for
+ *    headless automations, and for agents that run for a long time.
+ *
+ * A provider may implement either or both. Where it implements both, the choice
+ * is per-invocation — the same agent, watched or not — so it belongs in step
+ * config, not in the provider's identity.
+ *
+ * Deliberately free of pi-mono imports.
+ */
+import type { z } from 'zod';
+import type { Attachment } from '../common/attachment.js';
+import type { StepExecutionContext } from '../steps/base-step.js';
+import type { ResumePayload } from '../common/resume-payload.js';
+import type { ResponseDefect, ToolCallRecord } from './contract.js';
+/**
+ * One selectable agent, as shown in the step's agent picker.
+ *
+ * Returned by {@link BaseAgentProvider.listAgents} and served over the host's
+ * agents route — never baked into the config JSON Schema, which is generated
+ * once per process and has no tenant context.
+ */
+export interface AgentDescriptor {
+    id: string;
+    name: string;
+    description?: string;
+    avatarUrl?: string;
+}
+/** What the step hands a provider for one invocation. */
+export interface AgentRunInput {
+    /** The instruction for this run, with workflow refs already resolved. */
+    task: string;
+    /** Input documents the agent should have access to. */
+    attachments: Attachment[];
+    /** True when the step expects a JSON object back rather than free text. */
+    expectJson: boolean;
+    /** The JSON Schema the response should match. Present only when `expectJson`. */
+    outputSchema?: Record<string, unknown>;
+    /** True when every data point in the response must carry a source citation. */
+    cite: boolean;
+    /** Aborted when the step's wall-clock budget expires or the execution is cancelled. */
+    signal: AbortSignal;
+    /**
+     * Set when re-prompting after an unusable response. Providers should feed
+     * the defect back to the agent rather than starting a fresh conversation.
+     */
+    repair?: {
+        attempt: number;
+    } & ResponseDefect;
+}
+/**
+ * What a streaming run reports back.
+ *
+ * A provider translates its own transport (SSE frames, a websocket, an
+ * in-process iterator) into these. Failures are thrown, not yielded — a
+ * provider that ends without a `done` event is treated as a failed run.
+ */
+export type AgentRunEvent = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'thinking';
+    text?: string;
+} | {
+    type: 'tool_start';
+    toolCallId: string;
+    tool: string;
+    args: Record<string, unknown>;
+} | {
+    type: 'tool_end';
+    toolCallId: string;
+    tool: string;
+    result: unknown;
+}
+/** A file the agent produced. The step stores it; the provider only yields bytes. */
+ | {
+    type: 'artifact';
+    name: string;
+    mimeType: string;
+    bytes: Uint8Array;
+} | {
+    type: 'done';
+    result: AgentRunResult;
+};
+/**
+ * The outcome of one agent invocation.
+ *
+ * Note there are no attachments here: artifacts arrive as events and are
+ * persisted by the step through `ctx.storage`, so storage policy stays in the
+ * SDK rather than being re-implemented by every provider.
+ */
+export interface AgentRunResult {
+    /** The agent's response text, unparsed — the step shapes it per `outputType`. */
+    text: string;
+    toolCalls: ToolCallRecord[];
+    turnCount: number;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    /**
+     * Artifacts the provider resolved itself.
+     *
+     * Streaming providers should leave this unset and yield `artifact` events
+     * instead, so the step persists the bytes through `ctx.storage` and storage
+     * policy stays in one place. Dispatching providers have no byte stream to
+     * intercept — their artifacts arrive as references in the callback payload —
+     * so they map them to {@link Attachment} themselves.
+     */
+    attachments?: Attachment[];
+}
+/**
+ * What a parked step remembers about its dispatched run, written under
+ * `data.agent` on the step record and handed back to {@link
+ * AsyncAgentCapability.collect}.
+ *
+ * `provider` is stamped so a provider swap between dispatch and callback is
+ * caught rather than silently mis-resolved. `externalRef` is the correlation
+ * key: the SDK does not persist the one passed to `ctx.pause`, so this is the
+ * durable copy a host's callback route matches against. `attempt` carries the
+ * repair budget across the pause boundary, since the async repair loop is
+ * re-entry rather than iteration.
+ */
+export interface AgentDispatchRecord {
+    provider: string;
+    attempt: number;
+    externalRef: string;
+}
+/**
+ * A host's agent platform, behind a port.
+ *
+ * `TConfig` is the provider's own slice of step config — typically just the
+ * agent reference, since everything else about the agent is the host's to
+ * resolve. The step merges it with the shared contract fields.
+ *
+ * `TCtx` is the host's authorization context, used only by {@link listAgents},
+ * which is called from a request route rather than from step execution.
+ */
+export declare abstract class BaseAgentProvider<TConfig extends z.ZodTypeAny = z.ZodTypeAny, TCtx = unknown> {
+    /** Human-readable provider name. Also stamped on paused step records so a
+     *  provider swap mid-flight is caught rather than silently mis-resolved. */
+    abstract readonly name: string;
+    /** The provider's config fields, merged into the step's config schema. */
+    abstract readonly configSchema: TConfig;
+    /**
+     * List the agents this caller may run. Backs the step's agent picker.
+     *
+     * Omit when the provider's config names an agent some other way (a free-text
+     * id, a fixed single agent); the picker then falls back to a plain field.
+     */
+    listAgents?(ctx: TCtx): Promise<AgentDescriptor[]>;
+    /**
+     * Customize the JSON Schema generated from {@link configSchema} — the same
+     * hook steps have, scoped to the provider's own fields.
+     *
+     * Note this runs once per process with no tenant context, so it can inject
+     * static metadata (formats, enums over process-global lists) but never a
+     * per-workspace list. That is what {@link listAgents} is for.
+     */
+    decorateConfigSchema?(jsonSchema: Record<string, unknown>): Record<string, unknown>;
+}
+/**
+ * Stream the run and report progress as it happens.
+ *
+ * The step consumes the iterable to completion, so a provider holding an open
+ * connection must release it from the generator's `finally` — the step may stop
+ * consuming early (timeout, abort, workflow cancellation).
+ */
+export interface SyncAgentCapability<TConfig extends z.ZodTypeAny = z.ZodTypeAny> {
+    run(config: z.infer<TConfig>, input: AgentRunInput, ctx: StepExecutionContext): AsyncIterable<AgentRunEvent>;
+}
+/**
+ * Dispatch the run and let the step park until the host calls back.
+ *
+ * `dispatch` returns a correlation reference the host's callback route carries;
+ * the step persists it and pauses. `collect` runs on resume and turns the
+ * parked record plus the callback payload into a result.
+ */
+export interface AsyncAgentCapability<TConfig extends z.ZodTypeAny = z.ZodTypeAny> {
+    dispatch(config: z.infer<TConfig>, input: AgentRunInput, ctx: StepExecutionContext): Promise<{
+        externalRef: string;
+    }>;
+    /**
+     * Turn the host's callback into a result.
+     *
+     * `payload` is what the host passed to `runtime.resume()` — a dispatching
+     * provider typically reads its own envelope out of `payload.data`. `record`
+     * is what this provider stored when it dispatched, so a provider that needs
+     * its own correlation reference has it without going near the step row.
+     */
+    collect(payload: ResumePayload, record: AgentDispatchRecord, config: z.infer<TConfig>, ctx: StepExecutionContext): Promise<AgentRunResult>;
+}
+/**
+ * Resolve which transport an invocation should take.
+ *
+ * A provider implementing exactly one capability decides it; one implementing
+ * both defers to step config, where the author chose per invocation.
+ */
+export declare function resolveAgentMode<TConfig extends z.ZodTypeAny, TCtx>(provider: BaseAgentProvider<TConfig, TCtx>, mode: unknown): 'sync' | 'async';
+/** A provider paired with at least one transport. */
+export type AgentProvider<TConfig extends z.ZodTypeAny = z.ZodTypeAny, TCtx = unknown> = BaseAgentProvider<TConfig, TCtx> & (SyncAgentCapability<TConfig> | AsyncAgentCapability<TConfig>);
+export declare function supportsSync<TConfig extends z.ZodTypeAny, TCtx>(provider: BaseAgentProvider<TConfig, TCtx>): provider is BaseAgentProvider<TConfig, TCtx> & SyncAgentCapability<TConfig>;
+export declare function supportsAsync<TConfig extends z.ZodTypeAny, TCtx>(provider: BaseAgentProvider<TConfig, TCtx>): provider is BaseAgentProvider<TConfig, TCtx> & AsyncAgentCapability<TConfig>;
+//# sourceMappingURL=provider.d.ts.map

package/dist/agents/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/agents/provider.ts"],"names":[],"mappings":"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"}

package/dist/agents/provider.js

@@ -0,0 +1,72 @@
+/**
+ * Agent provider port — the seam between a workflow's agent step and whoever
+ * actually runs the agent.
+ *
+ * The SDK ships one agent implementation ({@link AgentStep}, which drives an
+ * LLM directly through a pi-mono runtime). That works when the SDK owns the
+ * agent: the step config carries the system prompt, the tool list and the turn
+ * budget, and the SDK drives the loop.
+ *
+ * It does not work when the *host* already owns agent lifecycle. In xyne-spaces
+ * agents live in claw; in xyne-search they live in an `agents` table. In both
+ * cases the prompt, tools, MCP connections and model are the host's to resolve
+ * — a workflow step should name an agent and hand it a task, not re-specify it.
+ *
+ * A provider is that: the host's agent platform, behind a port. It resolves
+ * config into a run and reports back; the step keeps the workflow contract
+ * (output shape, JSON repair, citations, artifacts). See ./host-agent-step.ts.
+ *
+ * Two transports, because hosts genuinely have both:
+ *
+ *  - {@link SyncAgentCapability} streams the run. The step holds a worker slot
+ *    for its duration and forwards progress to the execution viewer. Right for
+ *    a workflow someone is watching.
+ *  - {@link AsyncAgentCapability} dispatches the run and parks the step. The
+ *    worker slot is released and the execution resumes on callback. Right for
+ *    headless automations, and for agents that run for a long time.
+ *
+ * A provider may implement either or both. Where it implements both, the choice
+ * is per-invocation — the same agent, watched or not — so it belongs in step
+ * config, not in the provider's identity.
+ *
+ * Deliberately free of pi-mono imports.
+ */
+// ─── Provider ───
+/**
+ * A host's agent platform, behind a port.
+ *
+ * `TConfig` is the provider's own slice of step config — typically just the
+ * agent reference, since everything else about the agent is the host's to
+ * resolve. The step merges it with the shared contract fields.
+ *
+ * `TCtx` is the host's authorization context, used only by {@link listAgents},
+ * which is called from a request route rather than from step execution.
+ */
+export class BaseAgentProvider {
+}
+/**
+ * Resolve which transport an invocation should take.
+ *
+ * A provider implementing exactly one capability decides it; one implementing
+ * both defers to step config, where the author chose per invocation.
+ */
+export function resolveAgentMode(provider, mode) {
+    const sync = supportsSync(provider);
+    const async = supportsAsync(provider);
+    if (sync && async)
+        return mode === 'async' ? 'async' : 'sync';
+    if (async)
+        return 'async';
+    if (sync)
+        return 'sync';
+    throw new Error(`Agent provider "${provider.name}" implements neither SyncAgentCapability nor AsyncAgentCapability`);
+}
+// ─── Capability Detection ───
+export function supportsSync(provider) {
+    return typeof provider.run === 'function';
+}
+export function supportsAsync(provider) {
+    return typeof provider.dispatch === 'function'
+        && typeof provider.collect === 'function';
+}
+//# sourceMappingURL=provider.js.map

package/dist/agents/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/agents/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AA8GH,mBAAmB;AAEnB;;;;;;;;;GASG;AACH,MAAM,OAAgB,iBAAiB;CA4BtC;AAiDD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAA0C,EAC1C,IAAa;IAEb,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,IAAI,IAAI,KAAK;QAAE,OAAO,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9D,IAAI,KAAK;QAAE,OAAO,OAAO,CAAC;IAC1B,IAAI,IAAI;QAAE,OAAO,MAAM,CAAC;IACxB,MAAM,IAAI,KAAK,CACb,mBAAmB,QAAQ,CAAC,IAAI,mEAAmE,CACpG,CAAC;AACJ,CAAC;AASD,+BAA+B;AAE/B,MAAM,UAAU,YAAY,CAC1B,QAA0C;IAE1C,OAAO,OAAQ,QAA8B,CAAC,GAAG,KAAK,UAAU,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,QAA0C;IAE1C,OAAO,OAAQ,QAAmC,CAAC,QAAQ,KAAK,UAAU;WACrE,OAAQ,QAAkC,CAAC,OAAO,KAAK,UAAU,CAAC;AACzE,CAAC"}

package/dist/agents/types.d.ts

@@ -8,7 +8,7 @@
  *
  * Only usable when pi-mono peer dependencies are installed.
  */
-import type { Attachment } from '../common/attachment.js';
+import type { ToolCallRecord } from './contract.js';
 export type { AgentEvent, AgentTool, AgentToolResult, AgentToolUpdateCallback, AgentContext, AgentMessage, AgentLoopConfig, BeforeToolCallResult, AfterToolCallResult, BeforeToolCallContext, AfterToolCallContext, ThinkingLevel, } from '@earendil-works/pi-agent-core';
 export type { AgentSessionEvent } from '@earendil-works/pi-coding-agent';
 export type { Message, UserMessage, AssistantMessage, ToolResultMessage, TextContent, ThinkingContent, ImageContent, ToolCall, Tool, Usage, Model, Context, StopReason, } from '@earendil-works/pi-ai';
@@ -73,24 +73,5 @@ export interface AgentPauseState {
         outputTokens: number;
     };
 }
-/** Record of a completed tool call with timing — written to workflow context. */
-export interface ToolCallRecord {
-    name: string;
-    args: Record<string, unknown>;
-    result: unknown;
-    durationMs: number;
-}
-/** Final output written to workflow context after agent execution. */
-export interface AgentResult extends Record<string, unknown> {
-    /** Free text (outputType 'string') or a parsed JSON object (outputType 'json'). */
-    response: string | Record<string, unknown>;
-    toolCalls: ToolCallRecord[];
-    turnCount: number;
-    usage: {
-        inputTokens: number;
-        outputTokens: number;
-    };
-    /** Files the agent generated in the sandbox, persisted as artifacts. */
-    attachments: Attachment[];
-}
+export type { ToolCallRecord, AgentResult } from './contract.js';
 //# sourceMappingURL=types.d.ts.map

package/dist/agents/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"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"}

package/dist/engine/workflow-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-executor.d.ts","sourceRoot":"","sources":["../../src/engine/workflow-executor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workflow-executor.d.ts","sourceRoot":"","sources":["../../src/engine/workflow-executor.ts"],"names":[],"mappings":"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"}

package/dist/engine/workflow-executor.js

@@ -152,6 +152,7 @@ export class WorkflowExecutor {
                 await this.persistence.updateExecutionStatus(executionId, 'SKIPPED');
                 await this.persistence.persistState(executionId, {
                     context: JSON.stringify(context),
+                    attributes: context.workflow.attributes,
                 });
                 this.log.info(`runExecution: filter mismatch for ${executionId} — SKIPPED`);
                 return;
@@ -188,6 +189,7 @@ export class WorkflowExecutor {
                     status: gateRows[0].status,
                     executorType: gateRows[0].executorType,
                     data: JSON.stringify(data),
+                    attributes: context.workflow.attributes,
                 });
             }
         }
@@ -203,6 +205,7 @@ export class WorkflowExecutor {
         await this.persistence.updateExecutionStatus(executionId, 'RUNNING');
         await this.persistence.persistState(executionId, {
             context: JSON.stringify(context),
+            attributes: context.workflow.attributes,
         });
         this.log.info(`run ${isResume ? 'RESUMED' : 'STARTED'} execId=${executionId} workflow=${workflow.id}`);
         await this.runWorkflow(executionId, context, config.steps, {
@@ -224,6 +227,7 @@ export class WorkflowExecutor {
             workflowId,
             status: 'PENDING',
             context: JSON.stringify(context),
+            attributes: context.workflow.attributes,
         });
         await this.runExecution(executionId);
         return executionId;
@@ -319,6 +323,7 @@ export class WorkflowExecutor {
             status: 'PENDING',
             context: JSON.stringify(newContext),
             sourceExecutionId,
+            attributes: newContext.workflow.attributes,
         });
         // Persist prior steps as COMPLETED on the new execution so the memoized
         // walk skips them (records are the cursor — there is no positional skip).
@@ -333,6 +338,7 @@ export class WorkflowExecutor {
                     ? 'conditional'
                     : 'deterministic',
                 data: JSON.stringify(entry),
+                attributes: newContext.workflow.attributes,
             });
         }
         this.log.info(`rerun created exec=${newExecutionId} from=${sourceExecutionId} step=${fromStepId}`);
@@ -347,6 +353,7 @@ export class WorkflowExecutor {
             await this.persistence.persistState(executionId, {
                 context: JSON.stringify(context),
                 currentStepIndex: steps.length,
+                attributes: context.workflow.attributes,
             });
             this.emitEvent(executionId, { event: 'execution_completed', data: { status: 'COMPLETED' } });
             this.log.info(`run ${executionId} COMPLETED`);
@@ -366,6 +373,7 @@ export class WorkflowExecutor {
                 await this.persistence.persistState(executionId, {
                     context: JSON.stringify(context),
                     ...(pauseCategory === 'review' ? { pauseType: 'review' } : { pauseType: 'step' }),
+                    attributes: context.workflow.attributes,
                 });
                 await this.persistence.updateExecutionStatus(executionId, 'EXTERNAL_WAIT');
                 this.log.info(`run ${executionId} PAUSED`);
@@ -376,6 +384,7 @@ export class WorkflowExecutor {
             context.__meta = { ...context.__meta, error: errMsg };
             await this.persistence.persistState(executionId, {
                 context: JSON.stringify(context),
+                attributes: context.workflow.attributes,
             });
             this.emitEvent(executionId, { event: 'execution_failed', data: { error: errMsg } });
             this.log.error(`run ${executionId} FAILED: ${errMsg}`);
@@ -430,7 +439,7 @@ export class WorkflowExecutor {
                     // approve → restore output, mark COMPLETED, advance.
                     if (rec.data)
                         context.steps[step.id] = entryFromData(rec.data, step.type);
-                    await this.persistStep(executionId, key, 'COMPLETED', executorType, context.steps[step.id], memo);
+                    await this.persistStep(executionId, key, 'COMPLETED', executorType, context.steps[step.id], memo, context.workflow.attributes);
                     this.emitEvent(executionId, {
                         event: 'step_completed',
                         data: { stepName: step.id, nodePath: key, output: (context.steps[step.id]?.output ?? {}) },
@@ -479,7 +488,11 @@ export class WorkflowExecutor {
             //  re-entering its branches; completed branch steps memo-skip.)
             const resuming = resumeData !== undefined;
             if (!resuming) {
-                await this.persistence.upsertStep(executionId, key, { status: 'RUNNING', executorType });
+                await this.persistence.upsertStep(executionId, key, {
+                    status: 'RUNNING',
+                    executorType,
+                    attributes: context.workflow.attributes,
+                });
                 this.emitEvent(executionId, {
                     event: 'step_started',
                     data: { stepName: step.id, stepType: step.type, nodePath: key },
@@ -502,7 +515,7 @@ export class WorkflowExecutor {
                         ? { ...ctxEntry }
                         : { type: step.type, output: {} };
                     const merged = pe.statePatch ? { ...base, ...pe.statePatch } : base;
-                    await this.persistStep(executionId, key, 'EXTERNAL_WAIT', executorType, merged, memo);
+                    await this.persistStep(executionId, key, 'EXTERNAL_WAIT', executorType, merged, memo, context.workflow.attributes);
                     this.emitEvent(executionId, {
                         event: 'execution_paused',
                         data: {
@@ -527,6 +540,7 @@ export class WorkflowExecutor {
                         status: 'FAILED',
                         executorType,
                         data: JSON.stringify({ ...(ctxEntry ?? {}), error: errMsg }),
+                        attributes: context.workflow.attributes,
                     });
                     memo.set(key, { status: 'FAILED', data: { ...(ctxEntry ?? {}), error: errMsg } });
                     this.emitEvent(executionId, { event: 'step_failed', data: { stepName: step.id, nodePath: key, error: errMsg } });
@@ -537,6 +551,7 @@ export class WorkflowExecutor {
                     status: 'FAILED',
                     executorType,
                     data: JSON.stringify({ ...(ctxEntry ?? {}), error: errMsg }),
+                    attributes: context.workflow.attributes,
                 });
                 this.emitEvent(executionId, { event: 'step_failed', data: { stepName: step.id, nodePath: key, error: errMsg } });
                 throw err;
@@ -547,14 +562,14 @@ export class WorkflowExecutor {
             if (!resuming && step.onComplete === 'review') {
                 const reviewPauseState = buildReviewPauseState(step.id, ctxEntry);
                 const data = { ...(ctxEntry ?? { type: step.type, output: {} }), pauseState: reviewPauseState };
-                await this.persistStep(executionId, key, 'REVIEW_WAIT', executorType, data, memo);
+                await this.persistStep(executionId, key, 'REVIEW_WAIT', executorType, data, memo, context.workflow.attributes);
                 this.emitEvent(executionId, {
                     event: 'execution_paused',
                     data: { stepName: step.id, nodePath: key, pauseState: reviewPauseState },
                 });
                 throw reviewPause(step.id);
             }
-            await this.persistStep(executionId, key, 'COMPLETED', executorType, ctxEntry, memo);
+            await this.persistStep(executionId, key, 'COMPLETED', executorType, ctxEntry, memo, context.workflow.attributes);
             this.emitEvent(executionId, {
                 event: 'step_completed',
                 data: { stepName: step.id, nodePath: key, output: (ctxEntry?.output ?? {}) },
@@ -562,12 +577,15 @@ export class WorkflowExecutor {
         }
     }
     /** Persist a step record + mirror it into the in-memory memo for this run. */
-    async persistStep(executionId, key, status, executorType, entry, memo) {
+    async persistStep(executionId, key, status, executorType, entry, memo, 
+    /** The tenant this run acts as — see PersistenceAdapter.createExecution. */
+    attributes) {
         const data = entry ? { ...entry } : { output: null };
         await this.persistence.upsertStep(executionId, key, {
             status,
             executorType,
             data: JSON.stringify(data),
+            attributes,
         });
         memo.set(key, { status, data });
     }
@@ -740,7 +758,7 @@ export class WorkflowExecutor {
                 // state and the activity timeline use — so historical + live align with
                 // no client-side remapping.
                 this.persistence
-                    .appendStepEvent(callCtx.executionId, callCtx.stepId, normalized)
+                    .appendStepEvent(callCtx.executionId, callCtx.stepId, normalized, context.workflow.attributes)
                     .catch((err) => {
                     this.log.warn(`Failed to persist step event: ${err instanceof Error ? err.message : String(err)}`);
                 });