@codemation/core-nodes 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # @codemation/core-nodes
 
+## 0.9.0
+
+### Minor Changes
+
+- [#167](https://github.com/MadeRelevant/codemation/pull/167) [`3044474`](https://github.com/MadeRelevant/codemation/commit/3044474495525490735510ff74500b53761284b6) Thanks [@cblokland90](https://github.com/cblokland90)! - feat(hitl): Human-in-the-Loop — engine suspend/resume, inbox approval node + channels (local + control-plane), agent-as-tool, decision/timeout handling, inbox decision UX (toast + node status icons + "waiting for approval"), plus the consolidated dev/canvas/host fixes shipped alongside.
+
+### Patch Changes
+
+- Updated dependencies [[`3044474`](https://github.com/MadeRelevant/codemation/commit/3044474495525490735510ff74500b53761284b6)]:
+  - @codemation/core@0.12.0
+
+## 0.8.1
+
+### Patch Changes
+
+- [#157](https://github.com/MadeRelevant/codemation/pull/157) [`3025b86`](https://github.com/MadeRelevant/codemation/commit/3025b8685b0d7ad60c506b5a0f21967e681a25ea) Thanks [@cblokland90](https://github.com/cblokland90)! - Shrink workspace-host Docker image by decoupling CLI from next-host at runtime.
+
+  `@codemation/cli`: demote `@codemation/next-host` from `dependencies` to `devDependencies`. The CLI's
+  non-headless serve path resolves the next-host package at runtime via `require.resolve()`; the
+  headless path (used by workspace-host pods) never touches it. Consumers that install `@codemation/cli`
+  from the registry and need the UI shell must add `@codemation/next-host` as a direct dependency.
+
+  `@codemation/core-nodes`: demote `lucide-react` from `dependencies` to `devDependencies`. The package
+  only references lucide icon names as strings (e.g. `"lucide:bot"`); it never imports the react library
+  at runtime. This removes ~46 MB from runtime installs of `@codemation/core-nodes`.
+
+  `@codemation/host`: promote `execa` and `dotenv` from `devDependencies` to `dependencies`. Both are
+  required at Dockerfile build time by `scripts/generate-prisma-clients.mjs` (imports `execaSync` from
+  `execa`) and `prisma.config.ts` (imports `dotenv/config`). These files run during `prisma:generate`
+  which executes in the production builder stage with `--prod` install (no devDeps available).
+
+- Updated dependencies [[`e0933eb`](https://github.com/MadeRelevant/codemation/commit/e0933ebc51806a9593f94758860c591b8346a7a5)]:
+  - @codemation/core@0.11.1
+
 ## 0.8.0
 
 ### Minor Changes

package/LICENSE

@@ -1 +1,37 @@
-../../LICENSE
+Codemation Pre-Stable License
+
+Copyright (c) Made Relevant B.V. All rights reserved.
+
+1. Definitions
+
+   "Software" means the Codemation source code, documentation, and artifacts in this repository and any published npm packages in the Codemation monorepo.
+
+   "Stable Version" means the first published release of the package `@codemation/core` on the public npm registry with version 1.0.0 or higher.
+
+2. Permitted use (before Stable Version)
+
+   Until a Stable Version exists, you may use, copy, modify, and distribute the Software only for non-commercial purposes, including personal learning, research, evaluation, and internal use within your organization that does not charge third parties for access to the Software or a product or service whose primary value is the Software.
+
+3. Restrictions (before Stable Version)
+
+   Until a Stable Version exists, you must not:
+
+   a) Sell, rent, lease, or sublicense the Software or a derivative work for a fee;
+
+   b) Offer the Software or a derivative work as part of a paid product or service (including hosting, support, or consulting) where the Software is a material part of the offering;
+
+   c) Use the Software or a derivative work primarily to generate revenue or commercial advantage for you or others.
+
+   These restrictions apply to all versions published before a Stable Version, even if a later Stable Version is released under different terms.
+
+4. After Stable Version
+
+   The maintainers may publish a Stable Version under different license terms. If they do, those terms apply only to that Stable Version and subsequent releases they designate; they do not automatically apply to earlier pre-stable versions.
+
+5. No warranty
+
+   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+6. Third-party components
+
+   The Software may include third-party components under their own licenses. Those licenses govern those components.

package/dist/index.cjs

@@ -1309,6 +1309,7 @@ const string$1 = (params) => {
 };
 const integer = /^-?\d+$/;
 const number$1 = /^-?\d+(?:\.\d+)?$/;
+const boolean$1 = /^(?:true|false)$/i;
 const lowercase = /^[^A-Z]*$/;
 const uppercase = /^[^a-z]*$/;
 
@@ -2087,6 +2088,24 @@ const $ZodNumberFormat = /* @__PURE__ */ $constructor("$ZodNumberFormat", (inst,
 	$ZodCheckNumberFormat.init(inst, def);
 	$ZodNumber.init(inst, def);
 });
+const $ZodBoolean = /* @__PURE__ */ $constructor("$ZodBoolean", (inst, def) => {
+	$ZodType.init(inst, def);
+	inst._zod.pattern = boolean$1;
+	inst._zod.parse = (payload, _ctx) => {
+		if (def.coerce) try {
+			payload.value = Boolean(payload.value);
+		} catch (_) {}
+		const input = payload.value;
+		if (typeof input === "boolean") return payload;
+		payload.issues.push({
+			expected: "boolean",
+			code: "invalid_type",
+			input,
+			inst
+		});
+		return payload;
+	};
+});
 const $ZodUnknown = /* @__PURE__ */ $constructor("$ZodUnknown", (inst, def) => {
 	$ZodType.init(inst, def);
 	inst._zod.parse = (payload) => payload;
@@ -3163,6 +3182,13 @@ function _int(Class, params) {
 	});
 }
 /* @__NO_SIDE_EFFECTS__ */
+function _boolean(Class, params) {
+	return new Class({
+		type: "boolean",
+		...normalizeParams(params)
+	});
+}
+/* @__NO_SIDE_EFFECTS__ */
 function _unknown(Class) {
 	return new Class({ type: "unknown" });
 }
@@ -3329,6 +3355,17 @@ function _array(Class, element, params) {
 	});
 }
 /* @__NO_SIDE_EFFECTS__ */
+function _custom(Class, fn, _params) {
+	const norm = normalizeParams(_params);
+	norm.abort ?? (norm.abort = true);
+	return new Class({
+		type: "custom",
+		check: "custom",
+		fn,
+		...norm
+	});
+}
+/* @__NO_SIDE_EFFECTS__ */
 function _refine(Class, fn, _params) {
 	return new Class({
 		type: "custom",
@@ -4925,6 +4962,14 @@ const ZodNumberFormat = /* @__PURE__ */ $constructor("ZodNumberFormat", (inst, d
 function int(params) {
 	return _int(ZodNumberFormat, params);
 }
+const ZodBoolean = /* @__PURE__ */ $constructor("ZodBoolean", (inst, def) => {
+	$ZodBoolean.init(inst, def);
+	ZodType.init(inst, def);
+	inst._zod.processJSONSchema = (ctx, json, params) => booleanProcessor(inst, ctx, json, params);
+});
+function boolean(params) {
+	return _boolean(ZodBoolean, params);
+}
 const ZodUnknown = /* @__PURE__ */ $constructor("ZodUnknown", (inst, def) => {
 	$ZodUnknown.init(inst, def);
 	ZodType.init(inst, def);
@@ -5236,6 +5281,9 @@ const ZodCustom = /* @__PURE__ */ $constructor("ZodCustom", (inst, def) => {
 	ZodType.init(inst, def);
 	inst._zod.processJSONSchema = (ctx, json, params) => customProcessor(inst, ctx, json, params);
 });
+function custom(fn, _params) {
+	return _custom(ZodCustom, fn ?? (() => true), _params);
+}
 function refine(fn, _params = {}) {
 	return _refine(ZodCustom, fn, _params);
 }
@@ -5485,12 +5533,22 @@ let AgentToolExecutionCoordinator = class AgentToolExecutionCoordinator$1 {
 		this.repairPolicy = repairPolicy;
 	}
 	async execute(args) {
+		if (args.plannedToolCalls.filter((c) => c.binding.humanApproval !== void 0).length > 0 && args.plannedToolCalls.length > 1) return args.plannedToolCalls.map((c) => ({
+			toolName: c.binding.config.name,
+			toolCallId: c.toolCall.id ?? c.binding.config.name,
+			result: { error: c.binding.humanApproval !== void 0 ? `HITL tool '${c.binding.config.name}' cannot be called alongside other tools in the same turn; call it alone.` : `deferred: a HITL tool in the same turn blocked execution. Retry this tool alone in the next turn.` },
+			serialized: JSON.stringify({ error: c.binding.humanApproval !== void 0 ? `HITL tool '${c.binding.config.name}' cannot be called alongside other tools in the same turn; call it alone.` : `deferred: a HITL tool in the same turn blocked execution. Retry this tool alone in the next turn.` })
+		}));
 		const results = await Promise.allSettled(args.plannedToolCalls.map(async (plannedToolCall) => await this.executePlannedToolCall({
 			...args,
 			plannedToolCall
 		})));
 		const rejected = results.find((result) => result.status === "rejected");
-		if (rejected?.status === "rejected") throw rejected.reason instanceof Error ? rejected.reason : new Error(String(rejected.reason));
+		if (rejected?.status === "rejected") {
+			const reason = rejected.reason;
+			if (reason instanceof __codemation_core.SuspensionRequest) throw reason;
+			throw reason instanceof Error ? reason : new Error(String(reason));
+		}
 		return results.filter((result) => result.status === "fulfilled").map((result) => result.value);
 	}
 	async executePlannedToolCall(args) {
@@ -5575,6 +5633,34 @@ let AgentToolExecutionCoordinator = class AgentToolExecutionCoordinator$1 {
 				result
 			};
 		} catch (error) {
+			if (error instanceof __codemation_core.SuspensionRequest) {
+				const pendingToolCallId = plannedToolCall.toolCall.id ?? plannedToolCall.binding.config.name;
+				const checkpoint = {
+					conversation: args.conversationSnapshot ? [...args.conversationSnapshot] : [],
+					turnCount: args.turnCount ?? 0,
+					toolCallCount: args.toolCallCount ?? 0,
+					pendingToolCallId,
+					agentName: args.agentName,
+					modelId: args.modelId ?? ""
+				};
+				const agentReasoning = this.extractLastAssistantText(args.conversationSnapshot ?? []);
+				const augmented = new __codemation_core.SuspensionRequest({
+					...error.request,
+					metadata: {
+						...error.request.metadata,
+						agentCheckpoint: checkpoint,
+						pendingToolCallId,
+						agentReasoning,
+						onRejected: plannedToolCall.binding.humanApproval?.onRejected ?? "return"
+					}
+				});
+				await span.end({
+					status: "error",
+					statusMessage: "suspended",
+					endedAt: /* @__PURE__ */ new Date()
+				});
+				throw augmented;
+			}
 			const classification = this.errorClassifier.classify({
 				error,
 				toolName: plannedToolCall.binding.config.name,
@@ -5750,6 +5836,24 @@ let AgentToolExecutionCoordinator = class AgentToolExecutionCoordinator$1 {
 	extractErrorDetails(error) {
 		return error.details;
 	}
+	/**
+	* Extracts the text content from the last assistant message in the conversation snapshot.
+	* Used to populate `agentReasoning` in the HITL suspension metadata.
+	*/
+	extractLastAssistantText(conversation) {
+		for (let i = conversation.length - 1; i >= 0; i--) {
+			const msg = conversation[i];
+			if (msg?.role !== "assistant") continue;
+			const content = msg.content;
+			if (typeof content === "string") return content;
+			if (Array.isArray(content)) {
+				const textParts = content.filter((part) => typeof part === "object" && part.type === "text").map((part) => part.text);
+				if (textParts.length > 0) return textParts.join("");
+			}
+			break;
+		}
+		return "";
+	}
 	serializeIssue(issue$1) {
 		const result = {
 			path: [...issue$1.path],
@@ -6103,6 +6207,7 @@ var AgentItemPortMap = class {
 //#endregion
 //#region src/nodes/AIAgentNode.ts
 var _ref, _ref2, _ref3, _ref4, _ref5;
+const HITL_SOLO_CONSTRAINT_SENTENCE = "This tool requires human approval and may take time. Call it alone — do not invoke other tools in the same turn. Your turn will be paused until a decision is made.";
 let AIAgentNode = class AIAgentNode$1 {
 	kind = "node";
 	outputPorts = ["main"];
@@ -6120,13 +6225,90 @@ let AIAgentNode = class AIAgentNode$1 {
 		this.connectionCredentialExecutionContextFactory = this.executionHelpers.createConnectionCredentialExecutionContextFactory(credentialSessions);
 	}
 	async execute(args) {
-		const prepared = await this.getOrPrepareExecution(args.ctx);
+		const { ctx } = args;
+		if (ctx.resumeContext) return this.executeResumed(args, ctx.resumeContext);
+		const prepared = await this.getOrPrepareExecution(ctx);
 		const itemWithMappedJson = {
 			...args.item,
 			json: args.input
 		};
 		return (await this.runAgentForItem(prepared, itemWithMappedJson, args.itemIndex, args.items)).json;
 	}
+	/**
+	* Resume path: re-enters the agent loop after a HITL suspension.
+	* Reconstructs the conversation from the checkpoint, injects the human decision
+	* as a tool_result, and continues the loop from where it suspended.
+	*/
+	async executeResumed(args, resumeContext) {
+		const { ctx } = args;
+		const taskMetadata = resumeContext.task.metadata ?? {};
+		const checkpoint = taskMetadata["agentCheckpoint"];
+		const onRejected = taskMetadata["onRejected"] ?? "return";
+		if (!checkpoint) {
+			const prepared$1 = await this.getOrPrepareExecution(ctx);
+			const itemWithMappedJson = {
+				...args.item,
+				json: args.input
+			};
+			return (await this.runAgentForItem(prepared$1, itemWithMappedJson, args.itemIndex, args.items)).json;
+		}
+		if (resumeContext.decision.kind === "decided" && resumeContext.decision.value === null && onRejected === "halt") return;
+		const decision = this.normalizeDecision(resumeContext);
+		if (decision.status === "rejected" && onRejected === "halt") return;
+		const prepared = await this.getOrPrepareExecution(ctx);
+		const item = args.item;
+		const itemInputsByPort = AgentItemPortMap.fromItem(item);
+		const itemScopedTools = this.createItemScopedTools(prepared.resolvedTools, ctx, item, args.itemIndex, args.items);
+		const toolResultEntry = {
+			toolName: checkpoint.pendingToolCallId,
+			toolCallId: checkpoint.pendingToolCallId,
+			result: decision,
+			serialized: JSON.stringify(decision)
+		};
+		const conversation = [...checkpoint.conversation, AgentMessageFactory.createToolResultsMessage([toolResultEntry])];
+		const loopResult = await this.runTurnLoopUntilFinalAnswer({
+			prepared,
+			itemInputsByPort,
+			itemScopedTools,
+			conversation,
+			resumedTurnCount: checkpoint.turnCount,
+			resumedToolCallCount: checkpoint.toolCallCount
+		});
+		await ctx.telemetry.recordMetric({
+			name: __codemation_core.CodemationTelemetryMetricNames.agentTurns,
+			value: loopResult.turnCount
+		});
+		await ctx.telemetry.recordMetric({
+			name: __codemation_core.CodemationTelemetryMetricNames.agentToolCalls,
+			value: loopResult.toolCallCount
+		});
+		const outputJson = await this.resolveFinalOutputJson(prepared, itemInputsByPort, conversation, loopResult.finalText, itemScopedTools.length > 0);
+		return this.buildOutputItem(item, outputJson).json;
+	}
+	/**
+	* Normalizes a {@link ResumeContext} decision into a flat JSON-serializable shape
+	* suitable for injection as a tool_result content.
+	*/
+	normalizeDecision(resumeContext) {
+		const { decision } = resumeContext;
+		if (decision.kind === "decided") {
+			const value = decision.value;
+			return {
+				status: (typeof value === "object" && value !== null && "approved" in value ? Boolean(value["approved"]) : true) ? "approved" : "rejected",
+				value: decision.value,
+				actor: decision.actor,
+				decidedAt: decision.decidedAt.toISOString()
+			};
+		}
+		if (decision.kind === "timed_out") return {
+			status: "timed_out",
+			at: decision.at.toISOString()
+		};
+		return {
+			status: "auto_accepted",
+			at: decision.at.toISOString()
+		};
+	}
 	async getOrPrepareExecution(ctx) {
 		let pending = this.preparedByExecutionContext.get(ctx);
 		if (!pending) {
@@ -6247,7 +6429,7 @@ let AIAgentNode = class AIAgentNode$1 {
 		const { prepared, itemInputsByPort, itemScopedTools, conversation } = args;
 		const { ctx, guardrails, toolLoadingStrategy } = prepared;
 		let finalText = "";
-		let toolCallCount = 0;
+		let toolCallCount = args.resumedToolCallCount ?? 0;
 		let turnCount = 0;
 		const repairAttemptsByToolName = /* @__PURE__ */ new Map();
 		/** Tool IDs surfaced by find_tools across all prior turns in this item run. */
@@ -6288,11 +6470,17 @@ let AIAgentNode = class AIAgentNode$1 {
 				const plannedToolCalls = this.planToolCalls(itemScopedTools, coordinatorCalls, ctx.nodeId);
 				toolCallCount += plannedToolCalls.length;
 				await this.markQueuedTools(plannedToolCalls, ctx);
+				const assistantMsg = result.assistantMessage ?? AgentMessageFactory.createAssistantWithToolCalls(result.text, result.toolCalls);
+				const conversationWithAssistant = [...conversation, assistantMsg];
 				const executed = await this.toolExecutionCoordinator.execute({
 					plannedToolCalls,
 					ctx,
 					agentName: this.getAgentDisplayName(ctx),
-					repairAttemptsByToolName
+					repairAttemptsByToolName,
+					conversationSnapshot: conversationWithAssistant,
+					turnCount,
+					toolCallCount,
+					modelId: this.resolveChatModelName(ctx.config.chatModel)
 				});
 				coordinatorExecutedCalls.push(...executed);
 			}
@@ -6354,6 +6542,7 @@ let AIAgentNode = class AIAgentNode$1 {
 				connectionNodeId: __codemation_core.ConnectionNodeIdFactory.toolConnectionNodeId(ctx.nodeId, entry.config.name),
 				getCredentialRequirements: () => entry.config.getCredentialRequirements?.() ?? []
 			});
+			const hitlBehavior = this.resolveHumanApprovalBehavior(entry.config);
 			return {
 				config: entry.config,
 				inputSchema: entry.runtime.inputSchema,
@@ -6368,11 +6557,22 @@ let AIAgentNode = class AIAgentNode$1 {
 						items,
 						hooks
 					});
-				}
+				},
+				...hitlBehavior !== void 0 ? { humanApproval: hitlBehavior } : {}
 			};
 		});
 	}
 	/**
+	* Detects whether a tool config is backed by a `defineHumanApprovalNode` marker
+	* and returns the HITL behavior config, or `undefined` when not a HITL tool.
+	*/
+	resolveHumanApprovalBehavior(config$1) {
+		if (!this.isNodeBackedToolConfig(config$1)) return void 0;
+		const marker = config$1.node.humanApprovalToolBehavior;
+		if (marker === void 0) return void 0;
+		return { onRejected: marker.onRejected ?? "return" };
+	}
+	/**
 	* Invoke a text turn using the merged tool set from item-scoped tools (coordinator-managed)
 	* and strategy tools (find_tools + discovered MCP tools).
 	* Strategy tools take precedence for names that overlap.
@@ -6402,6 +6602,8 @@ let AIAgentNode = class AIAgentNode$1 {
 	/**
 	* Builds a ToolSet from resolved tools for strategy initialization.
 	* The strategy uses this for its "always-included" node-backed tool descriptions.
+	* HITL tools (detected via the `humanApprovalToolBehavior` field set by `defineHumanApprovalNode`) get the solo-constraint sentence
+	* appended to their description.
 	*/
 	buildToolSetFromResolved(resolvedTools) {
 		if (resolvedTools.length === 0) return {};
@@ -6411,8 +6613,10 @@ let AIAgentNode = class AIAgentNode$1 {
 				schemaName: entry.config.name,
 				requireObjectRoot: true
 			});
+			const baseDescription = entry.config.description ?? entry.runtime.defaultDescription;
+			const description = this.resolveHumanApprovalBehavior(entry.config) !== void 0 ? `${baseDescription} ${HITL_SOLO_CONSTRAINT_SENTENCE}` : baseDescription;
 			toolSet[entry.config.name] = {
-				description: entry.config.description ?? entry.runtime.defaultDescription,
+				description,
 				inputSchema: (0, ai.jsonSchema)(schemaRecord)
 			};
 		}
@@ -6440,8 +6644,10 @@ let AIAgentNode = class AIAgentNode$1 {
 				schemaName: entry.config.name,
 				requireObjectRoot: true
 			});
+			const baseDescription = entry.config.description;
+			const description = entry.humanApproval !== void 0 && baseDescription !== void 0 ? `${baseDescription} ${HITL_SOLO_CONSTRAINT_SENTENCE}` : entry.humanApproval !== void 0 ? HITL_SOLO_CONSTRAINT_SENTENCE : baseDescription;
 			toolSet[entry.config.name] = {
-				description: entry.config.description,
+				description,
 				inputSchema: (0, ai.jsonSchema)(schemaRecord)
 			};
 		}
@@ -8758,6 +8964,93 @@ const collectionDeleteNode = (0, __codemation_core.defineNode)({
 	}
 });
 
+//#endregion
+//#region src/nodes/InboxApprovalNode.types.ts
+function resolveSubjectField(field, item) {
+	return typeof field === "function" ? field({ item }) : field;
+}
+/**
+* Auto-detecting inbox approval node.
+*
+* Uses `ctx.resolve(InboxChannelResolverToken)` to pick the right inbox channel
+* at runtime:
+* - In managed mode (PairingConfig present): routes to the control-plane inbox.
+* - Otherwise: routes to the local inbox.
+*
+* Authors use this node directly; no extra wiring needed per deployment mode.
+*/
+const inboxApproval = (0, __codemation_core.defineHumanApprovalNode)({
+	key: "inbox.approval",
+	title: "Inbox Approval",
+	description: "Suspend and wait for a human reviewer to approve or reject.",
+	icon: "lucide:inbox",
+	channel: "inbox",
+	configSchema: object({
+		title: custom((v) => typeof v === "string" || typeof v === "function"),
+		body: custom((v) => typeof v === "string" || typeof v === "function"),
+		priority: _enum([
+			"low",
+			"normal",
+			"high"
+		]).default("normal"),
+		timeout: string().default("24h"),
+		onTimeout: _enum(["halt", "auto-accept"]).default("halt")
+	}),
+	decisionSchema: object({
+		approved: boolean(),
+		note: string().optional()
+	}),
+	defaultTimeout: "24h",
+	defaultOnTimeout: "halt",
+	async deliver({ task, config: config$1, item }, ctx) {
+		const resolver = ctx.resolve(__codemation_core.InboxChannelResolverToken);
+		if (!resolver) throw new Error("inboxApproval: no InboxChannelResolver registered. Ensure the host DI container is wired.");
+		const { channel, workspaceId } = resolver.resolve();
+		const subject = {
+			title: resolveSubjectField(config$1.title, item),
+			summary: resolveSubjectField(config$1.body, item),
+			attributes: {
+				workflowId: ctx.workflowId,
+				item: item.json
+			}
+		};
+		const delivery = await channel.deliver({
+			task,
+			subject,
+			priority: config$1.priority,
+			item,
+			workspaceId
+		});
+		ctx.telemetry.addSpanEvent({
+			name: "hitl.task.delivered",
+			attributes: {
+				taskId: task.taskId,
+				channel: channel.kind
+			}
+		});
+		return delivery;
+	},
+	async onDecision({ decision, actor, delivery }, ctx) {
+		const resolver = ctx.resolve(__codemation_core.InboxChannelResolverToken);
+		if (!resolver) return;
+		const { channel } = resolver.resolve();
+		await channel.updateOnDecision?.({
+			delivery,
+			decision,
+			actor
+		});
+	},
+	async onTimeout({ delivery, policy }, ctx) {
+		const resolver = ctx.resolve(__codemation_core.InboxChannelResolverToken);
+		if (!resolver) return;
+		const { channel } = resolver.resolve();
+		await channel.updateOnTimeout?.({
+			delivery,
+			policy
+		});
+	}
+});
+
 //#endregion
 exports.AIAgent = AIAgent;
 exports.AIAgentConnectionWorkflowExpander = AIAgentConnectionWorkflowExpander;
@@ -8994,6 +9287,7 @@ exports.collectionListNode = collectionListNode;
 exports.collectionUpdateNode = collectionUpdateNode;
 exports.createWorkflowBuilder = createWorkflowBuilder;
 exports.defineRestNode = defineRestNode;
+exports.inboxApproval = inboxApproval;
 exports.oauth2ClientCredentialsType = oauth2ClientCredentialsType;
 exports.openAiChatModelPresets = openAiChatModelPresets;
 exports.registerCoreNodes = registerCoreNodes;