@lumenflow/cli 3.9.5 → 3.9.7

package/dist/wu-claim-branch.js

@@ -11,13 +11,43 @@ import { readFile } from 'node:fs/promises';
 import { parseYAML } from '@lumenflow/core/wu-yaml';
 import { getGitForCwd } from '@lumenflow/core/git-adapter';
 import { die, getErrorMessage } from '@lumenflow/core/error-handler';
-import { BRANCHES, REMOTES, LOG_PREFIX, COMMIT_FORMATS, FILE_SYSTEM, } from '@lumenflow/core/wu-constants';
+import { BRANCHES, REMOTES, LOG_PREFIX, COMMIT_FORMATS, CLAIMED_MODES, FILE_SYSTEM, } from '@lumenflow/core/wu-constants';
 import { shouldSkipRemoteOperations } from '@lumenflow/core/micro-worktree';
 import { emitMandatoryAgentAdvisory } from '@lumenflow/core/orchestration-advisory-loader';
 import { updateWUYaml, addOrReplaceInProgressStatus, removeFromReadyAndAddToInProgressBacklog, maybeProgressInitiativeStatus, ensureCleanOrClaimOnlyWhenNoAuto, } from './wu-claim-state.js';
 import { shouldPersistClaimMetadataOnBranch } from './wu-claim-state.js';
 import { surfaceUnreadSignalsForDisplay, printLifecycleNudge } from './wu-claim-output.js';
 const PREFIX = LOG_PREFIX.CLAIM;
+/**
+ * WU-2306: Branch claim mode label for operator-facing output.
+ */
+export function getBranchModeDisplayLabel(claimedMode) {
+    return claimedMode === CLAIMED_MODES.BRANCH_PR
+        ? 'Branch-PR (no worktree)'
+        : 'Branch-Only (no worktree)';
+}
+/**
+ * WU-2306: Mode-aware next-step guidance for branch claim flows.
+ *
+ * Branch-PR follows wu:prep -> wu:done in the active branch.
+ * Branch-Only keeps legacy gates -> wu:done guidance.
+ */
+export function getBranchClaimNextSteps(id, claimedMode) {
+    if (claimedMode === CLAIMED_MODES.BRANCH_PR) {
+        return [
+            '  1. Work on this branch in the main checkout',
+            '  2. Implement changes per acceptance criteria',
+            `  3. Run: pnpm wu:prep --id ${id}`,
+            `  4. Run: pnpm wu:done --id ${id}  (creates PR in branch-pr mode)`,
+        ];
+    }
+    return [
+        '  1. Work on this branch in the main checkout',
+        '  2. Implement changes per acceptance criteria',
+        '  3. Run: pnpm gates',
+        `  4. pnpm wu:done --id ${id}`,
+    ];
+}
 /**
  * Execute branch-only mode claim workflow
  */
@@ -92,17 +122,18 @@ export async function claimBranchOnlyMode(ctx) {
     const wuDisplay = finalTitle ? `- WU: ${id} — ${finalTitle}` : `- WU: ${id}`;
     console.log(wuDisplay);
     console.log(`- Lane: ${args.lane}`);
-    console.log(`- Mode: Branch-Only (no worktree)`);
+    console.log(`- Mode: ${getBranchModeDisplayLabel(claimedMode)}`);
     const refDisplay = args.noPush ? `- Commit: ${msg}` : `- Branch: ${branch}`;
     console.log(refDisplay);
-    console.log('\n⚠️  LIMITATION: Branch-Only mode does not support parallel WUs (WIP=1 across ALL lanes)');
+    if (claimedMode === CLAIMED_MODES.BRANCH_ONLY) {
+        console.log('\n⚠️  LIMITATION: Branch-Only mode does not support parallel WUs (WIP=1 across ALL lanes)');
+    }
     console.log('Next: work on this branch in the main checkout.');
     // WU-1360: Print next-steps checklist to prevent common mistakes
     console.log(`\n${PREFIX} Next steps:`);
-    console.log(`  1. Work on this branch in the main checkout`);
-    console.log(`  2. Implement changes per acceptance criteria`);
-    console.log(`  3. Run: pnpm gates`);
-    console.log(`  4. pnpm wu:done --id ${id}`);
+    for (const step of getBranchClaimNextSteps(id, claimedMode)) {
+        console.log(step);
+    }
     console.log(`\n${PREFIX} Common mistakes to avoid:`);
     console.log(`  - Don't manually edit WU YAML status fields`);
     console.log(`  - Don't create PRs (trunk-based development)`);

package/dist/wu-claim-branch.js.map

@@ -1 +1 @@
-{"version":3,"file":"wu-claim-branch.js","sourceRoot":"","sources":["../src/wu-claim-branch.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EACL,QAAQ,EACR,OAAO,EACP,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAC3F,OAAO,EACL,YAAY,EACZ,4BAA4B,EAC5B,wCAAwC,EACxC,6BAA6B,EAC7B,gCAAgC,GACjC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kCAAkC,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,8BAA8B,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAG3F,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC;AAEhC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAiB;IACzD,MAAM,EACJ,IAAI,EACJ,EAAE,EACF,KAAK,EACL,KAAK,EACL,MAAM,EACN,OAAO,EACP,WAAW,EACX,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,SAAS,EACT,YAAY,EACZ,qBAAqB,EAAE,yCAAyC;MACjE,GAAG,GAAG,CAAC;IACR,MAAM,UAAU,GAAG,0BAA0B,EAAE,CAAC;IAEhD,IAAI,kBAAkB,EAAE,CAAC;QACvB,+EAA+E;QAC/E,IAAI,CAAC;YACH,MAAM,gBAAgB,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC3F,MAAM,YAAY,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CACD,uEAAuE;gBACrE,UAAU,eAAe,CAAC,KAAK,CAAC,MAAM;gBACtC,aAAa;gBACb,uBAAuB,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,IAAI;gBAC1D,kCAAkC,EAAE,YAAY,IAAI,CAAC,IAAI,KAAK;gBAC9D,sDAAsD,MAAM,EAAE,CACjE,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,IAAI,aAAa,KAAK,MAAM,EAAE,CAAC;QACpC,GAAG,CACD,0DAA0D;YACxD,mBAAmB,aAAa,IAAI;YACpC,oBAAoB,MAAM,MAAM;YAChC,aAAa,MAAM,iDAAiD,CACvE,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,GAAG,YAAY,IAAI,KAAK,CAAC;IACvC,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC;IAC1D,MAAM,0BAA0B,GAAG,kCAAkC,CAAC;QACpE,WAAW;QACX,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;QAC5B,UAAU;KACX,CAAC,CAAC;IAEH,IAAI,0BAA0B,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,gCAAgC,EAAE,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,wDAAwD;YACxD,yDAAyD;YACzD,MAAM,YAAY,GAAG,MAAM,YAAY,CACrC,OAAO,EACP,EAAE,EACF,IAAI,CAAC,IAAI,EACT,WAAW,EACX,IAAI,EACJ,SAAS,EACT,IAAI,EACJ,qBAAqB,IAAI,IAAI,CAC9B,CAAC;YACF,UAAU,GAAG,YAAY,CAAC,KAAK,IAAI,UAAU,CAAC;YAC9C,MAAM,4BAA4B,CAAC,WAAW,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;YAChE,MAAM,wCAAwC,CAC5C,YAAY,EACZ,WAAW,EACX,EAAE,EACF,UAAU,EACV,IAAI,CAAC,IAAI,CACV,CAAC;YACF,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;YACxD,gDAAgD;YAChD,IAAI,YAAY,CAAC,UAAU,EAAE,CAAC;gBAC5B,MAAM,YAAY,GAAG,MAAM,6BAA6B,CACtD,OAAO,CAAC,GAAG,EAAE,EACb,YAAY,CAAC,UAAU,EACvB,EAAE,CACH,CAAC;gBACF,IAAI,YAAY,CAAC,QAAQ,EAAE,CAAC;oBAC1B,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC;YACD,MAAM,YAAY,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,YAAY,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,UAAU,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CACV,GAAG,MAAM,wFAAwF,CAClG,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CACV,GAAG,MAAM,mFAAmF,CAC7F,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,YAAY,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,UAAU;IACV,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,sCAAsC,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC;IAC7E,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACvB,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,GAAG,EAAE,CAAC,CAAC,CAAC,aAAa,MAAM,EAAE,CAAC;IAC5E,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACxB,OAAO,CAAC,GAAG,CACT,2FAA2F,CAC5F,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;IAE/D,iEAAiE;IACjE,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,cAAc,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,4BAA4B,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;IAE9D,gDAAgD;IAChD,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,2BAA2B,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,mCAAmC,CAAC,CAAC;IAEnE,8DAA8D;IAE9D,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,WAAW,CAAC,IAAsB,EAAE,CAAC,CAAC;IAC5F,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC;IACzC,0BAA0B,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAE1C,6DAA6D;IAC7D,mBAAmB,CAAC,EAAE,CAAC,CAAC;IAExB,8EAA8E;IAC9E,+CAA+C;IAC/C,MAAM,8BAA8B,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACtD,CAAC"}
+{"version":3,"file":"wu-claim-branch.js","sourceRoot":"","sources":["../src/wu-claim-branch.ts"],"names":[],"mappings":"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"}

package/dist/wu-claim-worktree.js

@@ -26,6 +26,21 @@ const PNPM_BINARY_NAME = 'pnpm';
 const PNPM_FROZEN_LOCKFILE_ARGS = ['install', '--frozen-lockfile'];
 const WORKTREE_INSTALL_TIMEOUT_MS = 300000;
 const WORKTREE_SETUP_WARNING_PREVIEW_COUNT = 3;
+/**
+ * WU-2306: Canonical next-step guidance for worktree claims.
+ *
+ * Two-step completion is mandatory:
+ * 1) wu:prep from worktree
+ * 2) wu:done from main (using wu:prep output)
+ */
+export function getWorktreeClaimNextSteps(worktree, originalCwd, id) {
+    return [
+        `  1. cd ${worktree}  (IMPORTANT: work here, not main)`,
+        '  2. Implement changes per acceptance criteria',
+        `  3. Run: pnpm wu:prep --id ${id}`,
+        `  4. Copy and run the wu:done command printed by wu:prep (from main): cd ${originalCwd} && pnpm wu:done --id ${id}`,
+    ];
+}
 /**
  * WU-1213: Handle local-only claim metadata update (noPush mode).
  * Extracted to reduce cognitive complexity of claimWorktreeMode.
@@ -206,10 +221,9 @@ export async function claimWorktreeMode(ctx) {
     console.log(`Next: cd ${worktree} and begin work.`);
     // WU-1360: Print next-steps checklist to prevent common mistakes
     console.log(`\n${PREFIX} Next steps:`);
-    console.log(`  1. cd ${worktree}  (IMPORTANT: work here, not main)`);
-    console.log(`  2. Implement changes per acceptance criteria`);
-    console.log(`  3. Run: pnpm gates`);
-    console.log(`  4. cd ${originalCwd} && pnpm wu:done --id ${id}`);
+    for (const step of getWorktreeClaimNextSteps(worktree, originalCwd, id)) {
+        console.log(step);
+    }
     console.log(`\n${PREFIX} Common mistakes to avoid:`);
     console.log(`  - Don't edit files on main branch`);
     console.log(`  - Don't manually edit WU YAML status fields`);

package/dist/wu-claim-worktree.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/cli",
-  "version": "3.9.5",
+  "version": "3.9.7",
   "description": "Command-line interface for LumenFlow workflow framework",
   "keywords": [
     "lumenflow",
@@ -180,13 +180,13 @@
     "xstate": "^5.28.0",
     "yaml": "^2.8.2",
     "zod": "^4.3.6",
-    "@lumenflow/agent": "3.9.5",
-    "@lumenflow/initiatives": "3.9.5",
-    "@lumenflow/kernel": "3.9.5",
-    "@lumenflow/memory": "3.9.5",
-    "@lumenflow/control-plane-sdk": "3.9.5",
-    "@lumenflow/metrics": "3.9.5",
-    "@lumenflow/core": "3.9.5"
+    "@lumenflow/agent": "3.9.7",
+    "@lumenflow/initiatives": "3.9.7",
+    "@lumenflow/control-plane-sdk": "3.9.7",
+    "@lumenflow/core": "3.9.7",
+    "@lumenflow/kernel": "3.9.7",
+    "@lumenflow/memory": "3.9.7",
+    "@lumenflow/metrics": "3.9.7"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.18",

package/packs/sidekick/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @lumenflow/packs-sidekick@3.9.4 build /home/tom/source/hellmai/lumenflow-dev/packages/@lumenflow/packs/sidekick
+> @lumenflow/packs-sidekick@3.9.6 build /home/tom/source/hellmai/lumenflow-dev/packages/@lumenflow/packs/sidekick
 > tsc
 

package/packs/sidekick/manifest.ts

@@ -182,9 +182,11 @@ const TOOL_INPUT_SCHEMAS: Record<SidekickToolName, Record<string, unknown>> = {
   'channel:send': {
     type: 'object',
     properties: {
+      provider: { type: 'string' },
       channel: { type: 'string' },
       content: { type: 'string', minLength: 1 },
       sender: { type: 'string' },
+      metadata: { type: 'object', additionalProperties: true },
       dry_run: { type: 'boolean' },
     },
     required: ['content'],
@@ -193,9 +195,12 @@ const TOOL_INPUT_SCHEMAS: Record<SidekickToolName, Record<string, unknown>> = {
   'channel:receive': {
     type: 'object',
     properties: {
+      provider: { type: 'string' },
       channel: { type: 'string' },
+      cursor: { type: 'string' },
       limit: { type: 'integer', minimum: 1 },
       since: { type: 'string' },
+      metadata: { type: 'object', additionalProperties: true },
     },
     additionalProperties: false,
   },

package/packs/sidekick/manifest.yaml

@@ -235,6 +235,8 @@ tools:
     input_schema:
       type: object
       properties:
+        provider:
+          type: string
         channel:
           type: string
         content:
@@ -242,6 +244,9 @@ tools:
           minLength: 1
         sender:
           type: string
+        metadata:
+          type: object
+          additionalProperties: true
         dry_run:
           type: boolean
       required: [content]
@@ -259,13 +264,20 @@ tools:
     input_schema:
       type: object
       properties:
+        provider:
+          type: string
         channel:
           type: string
+        cursor:
+          type: string
         limit:
           type: integer
           minimum: 1
         since:
           type: string
+        metadata:
+          type: object
+          additionalProperties: true
       additionalProperties: false
     output_schema:
       type: object

package/packs/sidekick/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/packs-sidekick",
-  "version": "3.9.5",
+  "version": "3.9.7",
   "description": "Sidekick personal assistant pack for LumenFlow — 16 tools for task management, typed memory, channels, routines, and audit",
   "keywords": [
     "lumenflow",
@@ -27,6 +27,7 @@
     "./storage": "./dist/tool-impl/storage.js",
     "./tools": "./dist/tools/index.js",
     "./tool-impl": "./dist/tool-impl/index.js",
+    "./tool-impl/channel-transports": "./dist/tool-impl/channel-transports.js",
     "./tool-impl/channel-tools": "./dist/tool-impl/channel-tools.js",
     "./tool-impl/memory-tools": "./dist/tool-impl/memory-tools.js",
     "./tool-impl/routine-tools": "./dist/tool-impl/routine-tools.js",

package/packs/sidekick/tool-impl/channel-tools.ts

@@ -1,6 +1,7 @@
 // Copyright (c) 2026 Hellmai Ltd
 // SPDX-License-Identifier: AGPL-3.0-only
 
+import { getChannelTransport } from './channel-transports.js';
 import { getStoragePort, type ChannelMessageRecord, type ChannelRecord } from './storage.js';
 import {
   asInteger,
@@ -29,6 +30,26 @@ const TOOL_NAMES = {
 const OUTBOX_CAP = 100;
 const DEFAULT_CHANNEL_NAME = 'default';
 
+function asOptionalRecord(value: unknown): Record<string, unknown> | undefined {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) {
+    return undefined;
+  }
+  return value as Record<string, unknown>;
+}
+
+function withTransportMetadata<T extends Record<string, unknown>>(
+  data: T,
+  metadata: Record<string, unknown> | undefined,
+): T & Record<string, unknown> {
+  if (!metadata) {
+    return data;
+  }
+  return {
+    ...data,
+    metadata,
+  };
+}
+
 // ---------------------------------------------------------------------------
 // channel:configure
 // ---------------------------------------------------------------------------
@@ -99,6 +120,77 @@ async function channelConfigureTool(
 // channel:send
 // ---------------------------------------------------------------------------
 
+async function channelSendViaTransport(
+  input: Record<string, unknown>,
+  context: ToolContextLike | undefined,
+  provider: string,
+  channel: string,
+  content: string,
+): Promise<ToolOutput> {
+  const workspaceId = asNonEmptyString(context?.workspace_id);
+  if (!workspaceId) {
+    return failure(
+      'WORKSPACE_CONTEXT_REQUIRED',
+      'workspace_id is required when provider is specified.',
+    );
+  }
+
+  const transport = getChannelTransport(provider);
+  if (!transport) {
+    return failure(
+      'INTEGRATION_PROVIDER_NOT_REGISTERED',
+      `No channel transport registered for provider: ${provider}`,
+    );
+  }
+
+  if (isDryRun(input)) {
+    return success({
+      dry_run: true,
+      provider,
+      capability: 'send',
+      channel,
+      content,
+    });
+  }
+
+  const transportResult = await transport.send({
+    workspaceId,
+    provider,
+    channel,
+    content,
+    metadata: asOptionalRecord(input.metadata),
+  });
+
+  const outputData = withTransportMetadata(
+    {
+      provider,
+      capability: 'send',
+      channel,
+      ...(transportResult.externalMessageId !== undefined
+        ? { externalMessageId: transportResult.externalMessageId }
+        : {}),
+      ...(transportResult.failureClass ? { failureClass: transportResult.failureClass } : {}),
+      ...(transportResult.retryAfterSeconds !== undefined
+        ? { retryAfterSeconds: transportResult.retryAfterSeconds }
+        : {}),
+    },
+    transportResult.metadata,
+  );
+
+  if (!transportResult.success) {
+    return {
+      success: false,
+      error: {
+        code: 'INTEGRATION_PROVIDER_SEND_FAILED',
+        message: transportResult.error ?? `Provider send failed for provider: ${provider}`,
+      },
+      data: outputData,
+    };
+  }
+
+  return success(outputData);
+}
+
 async function channelSendTool(input: unknown, context?: ToolContextLike): Promise<ToolOutput> {
   const parsed = toRecord(input);
   const content = asNonEmptyString(parsed.content);
@@ -108,6 +200,12 @@ async function channelSendTool(input: unknown, context?: ToolContextLike): Promi
   }
 
   const channelName = asNonEmptyString(parsed.channel) ?? DEFAULT_CHANNEL_NAME;
+  const provider = asNonEmptyString(parsed.provider);
+
+  if (provider) {
+    return channelSendViaTransport(parsed, context, provider, channelName, content);
+  }
+
   const sender = asNonEmptyString(parsed.sender) ?? 'assistant';
   const now = nowIso();
 
@@ -175,10 +273,86 @@ async function channelSendTool(input: unknown, context?: ToolContextLike): Promi
 // channel:receive
 // ---------------------------------------------------------------------------
 
+async function channelReceiveViaTransport(
+  input: Record<string, unknown>,
+  context: ToolContextLike | undefined,
+  provider: string,
+  channel: string,
+  limit: number | null,
+): Promise<ToolOutput> {
+  const workspaceId = asNonEmptyString(context?.workspace_id);
+  if (!workspaceId) {
+    return failure(
+      'WORKSPACE_CONTEXT_REQUIRED',
+      'workspace_id is required when provider is specified.',
+    );
+  }
+
+  const transport = getChannelTransport(provider);
+  if (!transport) {
+    return failure(
+      'INTEGRATION_PROVIDER_NOT_REGISTERED',
+      `No channel transport registered for provider: ${provider}`,
+    );
+  }
+
+  const cursor = asNonEmptyString(input.cursor) ?? undefined;
+
+  const transportResult = await transport.receive({
+    workspaceId,
+    provider,
+    channel,
+    cursor,
+    limit: limit && limit > 0 ? limit : undefined,
+    metadata: asOptionalRecord(input.metadata),
+  });
+
+  const outputData = withTransportMetadata(
+    {
+      provider,
+      capability: 'read',
+      channel,
+      ...(transportResult.records !== undefined ? { records: transportResult.records } : {}),
+      ...(transportResult.nextCursor !== undefined
+        ? { nextCursor: transportResult.nextCursor }
+        : {}),
+      ...(transportResult.failureClass ? { failureClass: transportResult.failureClass } : {}),
+      ...(transportResult.retryAfterSeconds !== undefined
+        ? { retryAfterSeconds: transportResult.retryAfterSeconds }
+        : {}),
+    },
+    transportResult.metadata,
+  );
+
+  if (!transportResult.success) {
+    return {
+      success: false,
+      error: {
+        code: 'INTEGRATION_PROVIDER_RECEIVE_FAILED',
+        message: transportResult.error ?? `Provider receive failed for provider: ${provider}`,
+      },
+      data: outputData,
+    };
+  }
+
+  return success(outputData);
+}
+
 async function channelReceiveTool(input: unknown, _context?: ToolContextLike): Promise<ToolOutput> {
   const parsed = toRecord(input);
   const channelName = asNonEmptyString(parsed.channel);
   const limit = asInteger(parsed.limit);
+  const provider = asNonEmptyString(parsed.provider);
+
+  if (provider) {
+    return channelReceiveViaTransport(
+      parsed,
+      _context,
+      provider,
+      channelName ?? DEFAULT_CHANNEL_NAME,
+      limit,
+    );
+  }
 
   const storage = getStoragePort();
   const messages = await storage.readStore('messages');

package/packs/sidekick/tool-impl/channel-transports.ts

@@ -0,0 +1,75 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+
+import { getSidekickRuntimeContext } from './runtime-context.js';
+
+export interface ChannelTransport {
+  provider: string;
+  send(req: {
+    workspaceId: string;
+    provider: string;
+    channel: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+  }): Promise<{
+    success: boolean;
+    error?: string;
+    externalMessageId?: string;
+    failureClass?: 'retryable' | 'terminal';
+    retryAfterSeconds?: number;
+    metadata?: Record<string, unknown>;
+  }>;
+  receive(req: {
+    workspaceId: string;
+    provider: string;
+    channel: string;
+    cursor?: string;
+    limit?: number;
+    metadata?: Record<string, unknown>;
+  }): Promise<{
+    success: boolean;
+    error?: string;
+    records?: unknown[];
+    nextCursor?: string;
+    failureClass?: 'retryable' | 'terminal';
+    retryAfterSeconds?: number;
+    metadata?: Record<string, unknown>;
+  }>;
+}
+
+function normalizeProvider(provider: string): string {
+  return provider.trim().toLowerCase();
+}
+
+function getRegistry(): Map<string, ChannelTransport> | undefined {
+  return getSidekickRuntimeContext()?.channelTransports;
+}
+
+export function registerChannelTransport(transport: ChannelTransport): void {
+  const provider = normalizeProvider(transport.provider);
+  if (provider.length === 0) {
+    throw new Error('channel transport provider must be a non-empty string.');
+  }
+  const registry = getRegistry();
+  if (!registry) {
+    throw new Error('channel transport registry is unavailable outside sidekick runtime context.');
+  }
+  registry.set(provider, transport);
+}
+
+export function getChannelTransport(provider: string): ChannelTransport | undefined {
+  const normalized = normalizeProvider(provider);
+  if (normalized.length === 0) {
+    return undefined;
+  }
+  const registry = getRegistry();
+  return registry?.get(normalized);
+}
+
+export function clearChannelTransports(): void {
+  const registry = getRegistry();
+  if (!registry) {
+    return;
+  }
+  registry.clear();
+}

package/packs/sidekick/tool-impl/index.ts

@@ -20,3 +20,10 @@ export {
   runWithStoragePort,
   setDefaultStoragePort,
 } from './storage.js';
+
+export {
+  type ChannelTransport,
+  clearChannelTransports,
+  getChannelTransport,
+  registerChannelTransport,
+} from './channel-transports.js';

package/packs/sidekick/tool-impl/routine-tools.ts

@@ -30,21 +30,45 @@ const TOOL_NAMES = {
 // Helpers
 // ---------------------------------------------------------------------------
 
-function normalizeSteps(value: unknown): RoutineStepRecord[] {
+interface NormalizeStepsResult {
+  steps: RoutineStepRecord[];
+  warnings: string[];
+}
+
+function normalizeSteps(value: unknown): NormalizeStepsResult {
   if (!Array.isArray(value)) {
-    return [];
+    return { steps: [], warnings: [] };
   }
 
   const steps: RoutineStepRecord[] = [];
-  for (const candidate of value) {
+  const warnings: string[] = [];
+
+  for (let i = 0; i < value.length; i++) {
+    const candidate = value[i];
+
+    // String shorthand: coerce "tool:name" → { tool: "tool:name", input: {} }
+    if (typeof candidate === 'string') {
+      const tool = asNonEmptyString(candidate);
+      if (tool) {
+        steps.push({ tool, input: {} });
+      } else {
+        warnings.push(`steps[${i}] invalid: expected non-empty string or object with "tool".`);
+      }
+      continue;
+    }
+
     if (!candidate || typeof candidate !== 'object' || Array.isArray(candidate)) {
+      warnings.push(`steps[${i}] invalid: expected object with "tool" or a tool name string.`);
       continue;
     }
+
     const record = candidate as Record<string, unknown>;
     const tool = asNonEmptyString(record.tool);
     if (!tool) {
+      warnings.push(`steps[${i}] invalid: missing or empty "tool" property.`);
       continue;
     }
+
     const input =
       record.input && typeof record.input === 'object' && !Array.isArray(record.input)
         ? (record.input as Record<string, unknown>)
@@ -53,7 +77,7 @@ function normalizeSteps(value: unknown): RoutineStepRecord[] {
     steps.push({ tool, input });
   }
 
-  return steps;
+  return { steps, warnings };
 }
 
 // ---------------------------------------------------------------------------
@@ -63,13 +87,17 @@ function normalizeSteps(value: unknown): RoutineStepRecord[] {
 async function routineCreateTool(input: unknown, context?: ToolContextLike): Promise<ToolOutput> {
   const parsed = toRecord(input);
   const name = asNonEmptyString(parsed.name);
-  const steps = normalizeSteps(parsed.steps);
+  const { steps, warnings } = normalizeSteps(parsed.steps);
 
   if (!name) {
     return failure('INVALID_INPUT', 'name is required.');
   }
   if (steps.length === 0) {
-    return failure('INVALID_INPUT', 'steps must include at least one tool step.');
+    const detail =
+      warnings.length > 0
+        ? `steps must include at least one tool step. Issues: ${warnings.join('; ')}`
+        : 'steps must include at least one tool step.';
+    return failure('INVALID_INPUT', detail);
   }
 
   const now = nowIso();
@@ -85,6 +113,7 @@ async function routineCreateTool(input: unknown, context?: ToolContextLike): Pro
     return success({
       dry_run: true,
       routine: routine as unknown as Record<string, unknown>,
+      ...(warnings.length > 0 ? { warnings } : {}),
     });
   }
 
@@ -103,7 +132,10 @@ async function routineCreateTool(input: unknown, context?: ToolContextLike): Pro
     );
   });
 
-  return success({ routine: routine as unknown as Record<string, unknown> });
+  return success({
+    routine: routine as unknown as Record<string, unknown>,
+    ...(warnings.length > 0 ? { warnings } : {}),
+  });
 }
 
 // ---------------------------------------------------------------------------

package/packs/sidekick/tool-impl/runtime-context.ts

@@ -0,0 +1,24 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+
+import { AsyncLocalStorage } from 'node:async_hooks';
+import type { ChannelTransport } from './channel-transports.js';
+import type { StoragePort } from './storage.js';
+
+export interface SidekickRuntimeContext {
+  storagePort: StoragePort;
+  channelTransports: Map<string, ChannelTransport>;
+}
+
+const runtimeContext = new AsyncLocalStorage<SidekickRuntimeContext>();
+
+export function getSidekickRuntimeContext(): SidekickRuntimeContext | undefined {
+  return runtimeContext.getStore();
+}
+
+export async function runWithSidekickRuntimeContext<T>(
+  context: SidekickRuntimeContext,
+  fn: () => Promise<T>,
+): Promise<T> {
+  return runtimeContext.run(context, fn);
+}

package/packs/sidekick/tool-impl/shared.ts

@@ -7,6 +7,7 @@ import type { AuditEvent } from './storage.js';
 export interface ToolContextLike {
   tool_name?: string;
   receipt_id?: string;
+  workspace_id?: string;
 }
 
 export interface ToolOutput {

package/packs/sidekick/tool-impl/storage.ts

@@ -1,10 +1,10 @@
 // Copyright (c) 2026 Hellmai Ltd
 // SPDX-License-Identifier: AGPL-3.0-only
 
-import { AsyncLocalStorage } from 'node:async_hooks';
 import { randomBytes } from 'node:crypto';
 import { appendFile, mkdir, open, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';
 import path from 'node:path';
+import { getSidekickRuntimeContext, runWithSidekickRuntimeContext } from './runtime-context.js';
 
 // ---------------------------------------------------------------------------
 // Constants
@@ -299,7 +299,6 @@ export class FsStoragePort implements StoragePort {
 // Injection helpers (AsyncLocalStorage-based)
 // ---------------------------------------------------------------------------
 
-const storageContext = new AsyncLocalStorage<StoragePort>();
 let defaultStoragePort: StoragePort = new FsStoragePort();
 
 export function setDefaultStoragePort(port: StoragePort): void {
@@ -307,9 +306,16 @@ export function setDefaultStoragePort(port: StoragePort): void {
 }
 
 export function getStoragePort(): StoragePort {
-  return storageContext.getStore() ?? defaultStoragePort;
+  return getSidekickRuntimeContext()?.storagePort ?? defaultStoragePort;
 }
 
 export async function runWithStoragePort<T>(port: StoragePort, fn: () => Promise<T>): Promise<T> {
-  return storageContext.run(port, fn);
+  const existingContext = getSidekickRuntimeContext();
+  return runWithSidekickRuntimeContext(
+    {
+      storagePort: port,
+      channelTransports: existingContext?.channelTransports ?? new Map(),
+    },
+    fn,
+  );
 }

package/packs/software-delivery/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @lumenflow/packs-software-delivery@3.9.4 build /home/tom/source/hellmai/lumenflow-dev/packages/@lumenflow/packs/software-delivery
+> @lumenflow/packs-software-delivery@3.9.6 build /home/tom/source/hellmai/lumenflow-dev/packages/@lumenflow/packs/software-delivery
 > tsc
 

package/packs/software-delivery/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/packs-software-delivery",
-  "version": "3.9.5",
+  "version": "3.9.7",
   "description": "Software delivery pack for LumenFlow — work units, gates, lanes, initiatives, and agent coordination",
   "keywords": [
     "lumenflow",