experimental-ash 0.18.1 → 0.18.2

package/dist/src/evals/cli/eval.js

@@ -1 +1 @@
-import{n as e}from"../../chunks/paths-AVYgVLR3.js";import{loadDevelopmentEnvironmentFiles as t}from"../../cli/dev/environment.js";import{a as n,n as r,t as i}from"../../chunks/client-CKsU8Li3.js";import{n as a}from"../../chunks/host-Dor4C8jo.js";import{discoverAndImportSuites as o,discoverSuiteFiles as s,importSuiteFile as c}from"../runner/discover.js";import{executeSuite as l}from"../runner/execute-suite.js";import{ConsoleReporter as u}from"../runner/reporters/console.js";var d=n();function f(e,t){e.command(`eval`).description(`Run eval suites against an Ash agent.`).option(`--suite <id...>`,`Suite IDs to run (repeatable)`).option(`--all`,`Run all discovered suites`).option(`--url <url>`,`Remote agent URL (skip local host startup)`).option(`--timeout <ms>`,`Per-case timeout in milliseconds`).option(`--max-concurrency <n>`,`Max concurrent case executions per suite`).option(`--json`,`Output results as JSON`).option(`--list-suites`,`List discovered suites and exit`).option(`--skip-report`,`Skip suite-defined reporters (e.g. Braintrust)`).action(async e=>{await p(e,t)})}async function p(n,r){let i=e();if(t(i),n.listSuites){await y(i,r);return}let s=n.suite,c=await o(i,s);if(c.length===0){s&&s.length>0?r.error(`No suites found matching: ${s.join(`, `)}`):r.error(`No eval suites found. Create suite files under evals/ with the *.eval.ts extension.`),process.exitCode=1;return}let u,d;n.url?d={kind:`remote`,url:n.url}:(u=await a(i,{host:`127.0.0.1`,port:0}),d={kind:`local`,url:u.url});let f=m(d);try{let e=[];for(let t of c){let r=_(t,n),a=v(r,{json:n.json===!0,skipReport:n.skipReport===!0}),o=await l({suite:r,target:d,reporters:a,appRoot:i,client:f});e.push(o)}n.json&&r.log(JSON.stringify(e,null,2)),e.some(e=>e.errored>0)&&(process.exitCode=1)}finally{u&&await u.close()}process.exit(process.exitCode??0)}function m(e){if(e.kind===`local`)return new i({host:e.url});let t={},n=process.env.VERCEL_AUTOMATION_BYPASS_SECRET?.trim();return n&&(t[r]=n),new i({auth:h(),headers:Object.keys(t).length>0?t:void 0,host:e.url})}function h(){let e=process.env.ASH_EVAL_AUTH_TOKEN?.trim();return e?{bearer:e}:{bearer:g}}async function g(){try{let e=(await(0,d.getVercelOidcToken)()).trim();if(e.length>0)return e}catch{}return process.env.VERCEL_OIDC_TOKEN?.trim()??``}function _(e,t){let n=t.maxConcurrency?Number.parseInt(t.maxConcurrency,10):void 0,r=t.timeout?Number.parseInt(t.timeout,10):void 0;if(n===void 0&&r===void 0)return e;let i={...e};return n!==void 0&&(i.maxConcurrency=n),r!==void 0&&(i.timeoutMs=r),i}function v(e,t){let n=t.json?[]:[new u];return!t.skipReport&&e.reporters&&n.push(...e.reporters),n}async function y(e,t){let n=await s(e);if(n.length===0){t.log(`No eval suites found.`);return}t.log(`Found ${n.length} eval suite file(s):\n`);for(let r of n){let n=await c(e,r);t.log(`  ${n.id}${n.description?`  - ${n.description}`:``}`)}}export{f as registerEvalCommand,p as runEvalCommand};
+import{n as e}from"../../chunks/paths-Dwv0Eash.js";import{loadDevelopmentEnvironmentFiles as t}from"../../cli/dev/environment.js";import{a as n,n as r,t as i}from"../../chunks/client-CKsU8Li3.js";import{n as a}from"../../chunks/host-DkTSR6YJ.js";import{discoverAndImportSuites as o,discoverSuiteFiles as s,importSuiteFile as c}from"../runner/discover.js";import{executeSuite as l}from"../runner/execute-suite.js";import{ConsoleReporter as u}from"../runner/reporters/console.js";var d=n();function f(e,t){e.command(`eval`).description(`Run eval suites against an Ash agent.`).option(`--suite <id...>`,`Suite IDs to run (repeatable)`).option(`--all`,`Run all discovered suites`).option(`--url <url>`,`Remote agent URL (skip local host startup)`).option(`--timeout <ms>`,`Per-case timeout in milliseconds`).option(`--max-concurrency <n>`,`Max concurrent case executions per suite`).option(`--json`,`Output results as JSON`).option(`--list-suites`,`List discovered suites and exit`).option(`--skip-report`,`Skip suite-defined reporters (e.g. Braintrust)`).action(async e=>{await p(e,t)})}async function p(n,r){let i=e();if(t(i),n.listSuites){await y(i,r);return}let s=n.suite,c=await o(i,s);if(c.length===0){s&&s.length>0?r.error(`No suites found matching: ${s.join(`, `)}`):r.error(`No eval suites found. Create suite files under evals/ with the *.eval.ts extension.`),process.exitCode=1;return}let u,d;n.url?d={kind:`remote`,url:n.url}:(u=await a(i,{host:`127.0.0.1`,port:0}),d={kind:`local`,url:u.url});let f=m(d);try{let e=[];for(let t of c){let r=_(t,n),a=v(r,{json:n.json===!0,skipReport:n.skipReport===!0}),o=await l({suite:r,target:d,reporters:a,appRoot:i,client:f});e.push(o)}n.json&&r.log(JSON.stringify(e,null,2)),e.some(e=>e.errored>0)&&(process.exitCode=1)}finally{u&&await u.close()}process.exit(process.exitCode??0)}function m(e){if(e.kind===`local`)return new i({host:e.url});let t={},n=process.env.VERCEL_AUTOMATION_BYPASS_SECRET?.trim();return n&&(t[r]=n),new i({auth:h(),headers:Object.keys(t).length>0?t:void 0,host:e.url})}function h(){let e=process.env.ASH_EVAL_AUTH_TOKEN?.trim();return e?{bearer:e}:{bearer:g}}async function g(){try{let e=(await(0,d.getVercelOidcToken)()).trim();if(e.length>0)return e}catch{}return process.env.VERCEL_OIDC_TOKEN?.trim()??``}function _(e,t){let n=t.maxConcurrency?Number.parseInt(t.maxConcurrency,10):void 0,r=t.timeout?Number.parseInt(t.timeout,10):void 0;if(n===void 0&&r===void 0)return e;let i={...e};return n!==void 0&&(i.maxConcurrency=n),r!==void 0&&(i.timeoutMs=r),i}function v(e,t){let n=t.json?[]:[new u];return!t.skipReport&&e.reporters&&n.push(...e.reporters),n}async function y(e,t){let n=await s(e);if(n.length===0){t.log(`No eval suites found.`);return}t.log(`Found ${n.length} eval suite file(s):\n`);for(let r of n){let n=await c(e,r);t.log(`  ${n.id}${n.description?`  - ${n.description}`:``}`)}}export{f as registerEvalCommand,p as runEvalCommand};

package/dist/src/execution/sandbox/bindings/vercel.d.ts

@@ -1,7 +1,7 @@
 import type * as VercelSandboxSdk from "#compiled/@vercel/sandbox/index.js";
 import type { Sandbox as SdkSandbox } from "#compiled/@vercel/sandbox/index.js";
 import type { SandboxBackend } from "#public/definitions/sandbox-backend.js";
-import type { VercelSandbox, VercelSandboxBootstrapUseOptions, VercelSandboxSessionUseOptions } from "#public/sandbox/vercel-sandbox.js";
+import type { VercelSandboxBootstrapUseOptions, VercelSandboxSessionUseOptions } from "#public/sandbox/vercel-sandbox.js";
 type VercelSandboxModule = typeof VercelSandboxSdk;
 /**
  * User-controllable subset of `Sandbox.create` parameters.
@@ -18,5 +18,5 @@ export interface CreateVercelSandboxBackendInput {
 /**
  * Creates the Vercel-backed sandbox backend.
  */
-export declare function createVercelSandboxBackend(input?: CreateVercelSandboxBackendInput): SandboxBackend<VercelSandbox, VercelSandboxBootstrapUseOptions, VercelSandboxSessionUseOptions>;
+export declare function createVercelSandboxBackend(input?: CreateVercelSandboxBackendInput): SandboxBackend<VercelSandboxBootstrapUseOptions, VercelSandboxSessionUseOptions>;
 export {};

package/dist/src/execution/sandbox/bindings/vercel.js

@@ -168,7 +168,7 @@ function createHandle(sandbox, sessionKey) {
             if (options !== undefined) {
                 await sandbox.update(options);
             }
-            return buildVercelSandbox(sandbox, sessionKey);
+            return buildSandboxSession(createVercelInternalSandboxSession(sandbox, sessionKey));
         },
         async captureState() {
             return {
@@ -180,39 +180,6 @@ function createHandle(sandbox, sessionKey) {
         async dispose() { },
     };
 }
-function buildVercelSandbox(sandbox, id) {
-    const session = buildSandboxSession(createVercelInternalSandboxSession(sandbox, id));
-    return {
-        ...session,
-        get name() {
-            return sandbox.name;
-        },
-        get persistent() {
-            return sandbox.persistent;
-        },
-        get status() {
-            return sandbox.status;
-        },
-        get networkPolicy() {
-            return sandbox.networkPolicy;
-        },
-        get tags() {
-            return sandbox.tags;
-        },
-        async update(params) {
-            await sandbox.update(params);
-        },
-        async stop(opts) {
-            await sandbox.stop(opts);
-        },
-        async snapshot(opts) {
-            return await sandbox.snapshot(opts);
-        },
-        domain(port) {
-            return sandbox.domain(port);
-        },
-    };
-}
 function createVercelInternalSandboxSession(sandbox, id) {
     return {
         id,

package/dist/src/execution/workflow-entry.js

@@ -108,16 +108,21 @@ async function runWorkflowLoop(input) {
         });
         return { output: currentResult.output ?? "" };
     }
-    const parkToken = currentSession.continuationToken || deriveAdapterContinuationToken(currentSerializedContext);
-    if (!parkToken) {
-        throw new Error("Cannot park: no continuation token available. The adapter must " +
-            "provide a token via getContinuationToken() (e.g., by posting the " +
-            "first message to the platform during the initial turn).");
+    // The first turn may have re-keyed the session via
+    // `ctx.session.setContinuationToken(...)` (e.g. Slack auto-anchor on
+    // first post). `currentSession.continuationToken` already reflects
+    // the latest token thanks to `reconcileSessionContinuationToken`
+    // inside `durableRunStep`, so creating the park hook here lands at
+    // the right token from the start.
+    if (!currentSession.continuationToken) {
+        throw new Error("Cannot park: no continuation token available. The channel must " +
+            "post the first message during the initial turn (anchoring the " +
+            "session) or `send()` must be called with an explicit " +
+            "continuationToken.");
     }
-    const hook = createHook({
-        token: parkToken,
-    });
-    const iterator = hook[Symbol.asyncIterator]();
+    let parkToken = currentSession.continuationToken;
+    let hook = createHook({ token: parkToken });
+    let iterator = hook[Symbol.asyncIterator]();
     let pendingNext = null;
     const getNextPromise = () => {
         pendingNext ??= iterator.next();
@@ -126,6 +131,24 @@ async function runWorkflowLoop(input) {
     const consumeNext = () => {
         pendingNext = null;
     };
+    /**
+     * Disposes the current park hook and creates a new one at
+     * {@link nextToken}. Called after a turn whose handlers
+     * re-keyed the session via `setContinuationToken(...)`. In-flight
+     * deliveries to the old token after this returns are silently
+     * dropped — channels that re-key mid-session must coordinate with
+     * their senders so follow-up traffic uses the new token.
+     */
+    const rekeyHook = async (nextToken) => {
+        if (nextToken === parkToken || !nextToken)
+            return;
+        await closeHookIterator(iterator);
+        await disposeHook(hook);
+        parkToken = nextToken;
+        hook = createHook({ token: parkToken });
+        iterator = hook[Symbol.asyncIterator]();
+        pendingNext = null;
+    };
     try {
         while (true) {
             if (hasPendingRuntimeActionBatch(currentSession)) {
@@ -137,6 +160,7 @@ async function runWorkflowLoop(input) {
                     bufferedDeliveries,
                     getNextPromise,
                     consumeNext,
+                    rekeyHook,
                     serializedContext: currentSerializedContext,
                     session: currentSession,
                 });
@@ -184,6 +208,7 @@ async function runWorkflowLoop(input) {
                 });
                 return { output: currentResult.output ?? "" };
             }
+            await rekeyHook(currentSession.continuationToken);
         }
     }
     finally {
@@ -292,6 +317,7 @@ async function waitForPendingRuntimeActionResults(input) {
                 });
                 currentSession = proxyResult.session;
                 currentSerializedContext = proxyResult.serializedContext;
+                await input.rekeyHook(currentSession.continuationToken);
             }
         },
         session: currentSession,
@@ -456,25 +482,3 @@ async function disposeHook(hook) {
     }
     await symbolDispose.call(hook);
 }
-/**
- * Derives the continuation token from the serialized adapter state.
- *
- * Used when no explicit continuation token was provided on RunInput
- * (schedule-initiated sessions). The token is derived from the
- * adapter's serialized resume identity — for Slack, this is the
- * continuation token `slack:{channelId}:{threadTs}` when threadTs is populated.
- */
-function deriveAdapterContinuationToken(serializedContext) {
-    const channel = serializedContext["ash.channel"];
-    if (!channel?.state)
-        return undefined;
-    const serializedThread = channel.state.serializedThread;
-    if (!serializedThread?.id)
-        return undefined;
-    const id = serializedThread.id;
-    const lastColon = id.lastIndexOf(":");
-    if (lastColon === -1)
-        return undefined;
-    const threadTs = id.slice(lastColon + 1);
-    return threadTs.length > 0 ? id : undefined;
-}

package/dist/src/execution/workflow-steps.d.ts

@@ -1,4 +1,5 @@
 import type { DeliverPayload, HookPayload, SessionAuthContext, SubagentInputRequestHookPayload } from "#channel/types.js";
+import { deserializeContext } from "#context/serialize.js";
 import type { HarnessSession } from "#harness/types.js";
 import type { RuntimeCompiledArtifactsSource } from "#runtime/compiled-artifacts-source.js";
 import type { DurableStepResult } from "#execution/types.js";
@@ -6,6 +7,21 @@ import type { DurableStepResult } from "#execution/types.js";
  * Runs one atomic harness step inside a durable `"use step"` boundary.
  */
 export declare function durableRunStep(serializedContext: Record<string, unknown>, session: HarnessSession, input: HookPayload | undefined): Promise<DurableStepResult>;
+/**
+ * Reconciles `session.continuationToken` with the live
+ * `ContinuationTokenKey` value in context.
+ *
+ * Channels mutate the token by calling
+ * `ctx.session.setContinuationToken(...)`, which writes through to
+ * `ContinuationTokenKey`. The serialized context picks the new value
+ * up automatically, but the in-memory {@link HarnessSession} the
+ * workflow body carries needs to be re-stamped so its `parkToken`
+ * read after the step reflects the re-key.
+ *
+ * Exported for unit testing; the workflow runtime is the only
+ * production caller.
+ */
+export declare function reconcileSessionContinuationToken(ctx: Awaited<ReturnType<typeof deserializeContext>>, session: HarnessSession): HarnessSession;
 /**
  * Starts every pending runtime action for the parked parent session.
  *

package/dist/src/execution/workflow-steps.js

@@ -3,7 +3,7 @@ import { buildAdapterContext } from "#channel/adapter-context.js";
 import { callAdapterEventHandler, defaultDeliverResult } from "#channel/adapter.js";
 import { toContextAccessor } from "#context/container.js";
 import { dispatchStreamEventHooks, runHookLifecycleStep } from "#context/hook-lifecycle.js";
-import { AuthKey, BundleKey, CapabilitiesKey, ChannelKey, InitiatorAuthKey, ModeKey, } from "#context/keys.js";
+import { AuthKey, BundleKey, CapabilitiesKey, ChannelKey, ContinuationTokenKey, InitiatorAuthKey, ModeKey, } from "#context/keys.js";
 import { runStep } from "#context/run-step.js";
 import { deserializeContext, serializeContext } from "#context/serialize.js";
 import { getHarnessEmissionState, isHarnessBetweenTurns } from "#harness/emission.js";
@@ -65,6 +65,7 @@ export async function durableRunStep(serializedContext, session, input) {
     // only edits a message). Persist any context mutations and re-park
     // without running a model turn.
     if (input?.kind === "deliver" && resolved === undefined) {
+        const rekeyed = reconcileSessionContinuationToken(ctx, session);
         const nextSerializedContext = serializeContext(ctx);
         const writable = getWritable();
         const writer = writable.getWriter();
@@ -72,7 +73,7 @@ export async function durableRunStep(serializedContext, session, input) {
         return {
             action: "park",
             serializedContext: nextSerializedContext,
-            session,
+            session: rekeyed,
         };
     }
     const writable = getWritable();
@@ -84,7 +85,7 @@ export async function durableRunStep(serializedContext, session, input) {
         await writer.write(encodeMessageStreamEvent(timestampHandleMessageStreamEvent(toEmit)));
         await dispatchStreamEventHooks({ ctx, registry: hookRegistry, event: toEmit });
     };
-    const stepResult = await runStep(ctx, session, async (enrichedSession) => {
+    let stepResult = await runStep(ctx, session, async (enrichedSession) => {
         const bundle = ctx.require(BundleKey);
         const capabilities = ctx.get(CapabilitiesKey);
         const mode = ctx.require(ModeKey);
@@ -129,7 +130,13 @@ export async function durableRunStep(serializedContext, session, input) {
         }
         return runHarnessStep(enrichedSession, resolved);
     });
+    // Reconcile the session's continuation token with `ContinuationTokenKey`
+    // in case a handler called `session.setContinuationToken(...)` during
+    // the turn (e.g. Slack's auto-anchor on first post). Idempotent when
+    // the token is unchanged.
+    const rekeyed = reconcileSessionContinuationToken(ctx, stepResult.session);
     const nextSerializedContext = serializeContext(ctx);
+    stepResult = { ...stepResult, session: rekeyed };
     // Interactive OAuth. When the step left one or more pending
     // connection tool calls (placeholders written to history) and at
     // least one matching pending authorization, the workflow body owns
@@ -177,6 +184,26 @@ export async function durableRunStep(serializedContext, session, input) {
         session: stepResult.session,
     };
 }
+/**
+ * Reconciles `session.continuationToken` with the live
+ * `ContinuationTokenKey` value in context.
+ *
+ * Channels mutate the token by calling
+ * `ctx.session.setContinuationToken(...)`, which writes through to
+ * `ContinuationTokenKey`. The serialized context picks the new value
+ * up automatically, but the in-memory {@link HarnessSession} the
+ * workflow body carries needs to be re-stamped so its `parkToken`
+ * read after the step reflects the re-key.
+ *
+ * Exported for unit testing; the workflow runtime is the only
+ * production caller.
+ */
+export function reconcileSessionContinuationToken(ctx, session) {
+    const next = ctx.get(ContinuationTokenKey);
+    if (next === undefined || next === session.continuationToken)
+        return session;
+    return { ...session, continuationToken: next };
+}
 /**
  * Starts every pending runtime action for the parked parent session.
  *
@@ -333,11 +360,12 @@ export async function runProxyInputRequestStep(input) {
     // adapter and later text-reply deliveries miss the cached batch.
     ctx.set(ChannelKey, { ...adapter, state: { ...adapterCtx.state } });
     const nextSerializedContext = serializeContext(ctx);
-    const nextSession = upsertProxyInputRequests({
+    const sessionWithProxyEntries = upsertProxyInputRequests({
         entries: proxyResult.entries,
         forChildContinuationToken: input.hookPayload.childContinuationToken,
         session: proxyResult.session,
     });
+    const nextSession = reconcileSessionContinuationToken(ctx, sessionWithProxyEntries);
     return {
         serializedContext: nextSerializedContext,
         session: nextSession,

package/dist/src/harness/attachment-staging.js

@@ -2,6 +2,7 @@ import { createHash } from "node:crypto";
 import { basename } from "node:path";
 import { buildAdapterContext } from "#channel/adapter-context.js";
 import { getAdapterKind } from "#channel/adapter.js";
+import { buildSessionHandle } from "#channel/session.js";
 import { loadContext } from "#context/container.js";
 import { ChannelKey, SandboxKey } from "#context/keys.js";
 import { fileDataToBytes } from "#internal/attachments/data.js";
@@ -83,7 +84,7 @@ export async function stageAttachmentsToSandbox(message) {
     const adapter = container.get(ChannelKey);
     const adapterCtx = adapter
         ? buildAdapterContext(adapter, container)
-        : { ctx: container, state: {} };
+        : { ctx: container, state: {}, session: buildSessionHandle(container) };
     return stageAttachmentsForAdapter(message, sandbox, adapterCtx);
 }
 /**

package/dist/src/internal/application/package.js

@@ -6,7 +6,7 @@ import { ASH_PACKAGE_NAME } from "#package-name.js";
 let cachedPackageInfo;
 // The package build stamps the published version into `dist` so bundled
 // deployments can still report package metadata without resolving package.json.
-const BUNDLED_FALLBACK_PACKAGE_VERSION = "0.18.1";
+const BUNDLED_FALLBACK_PACKAGE_VERSION = "0.18.2";
 const BUNDLED_FALLBACK_PACKAGE_VERSION_PLACEHOLDER = "__ASH_PACKAGE_VERSION_PLACEHOLDER__";
 const WORKFLOW_MODULE_ALIASES = {
     "workflow/api": "src/compiled/@workflow/core/runtime.js",

package/dist/src/public/channels/slack/api.d.ts

@@ -22,12 +22,13 @@ import { type CardElement, type FileUpload } from "#compiled/chat/index.js";
  */
 export type SlackBotToken = string | (() => string | Promise<string>);
 /**
- * Builds the Slack channel-local continuation token (`<channelId>:<threadTs>`).
- * Route `send()` namespaces this with the channel name before handing it to the
- * runtime (`slack:<channelId>:<threadTs>`), so Slack routes should pass the raw
- * channel-local form here.
+ * Builds the Slack channel-local continuation token
+ * (`<channelId>:<threadTs>`). Route `send()` namespaces this with the
+ * channel name before handing it to the runtime
+ * (`slack:<channelId>:<threadTs>`). `threadTs` may be empty for
+ * threadless sessions; the channel auto-anchors on its first post.
  */
-export declare function encodeSlackContinuationToken(channelId: string, threadTs: string): string;
+export declare function slackContinuationToken(channelId: string, threadTs: string): string;
 /**
  * Materializes a {@link SlackBotToken} to a concrete string. Falls
  * back to `process.env.SLACK_BOT_TOKEN` when no value was passed.
@@ -267,15 +268,19 @@ export interface SlackBinding {
     readonly slack: SlackHandle;
 }
 /**
- * Internal-only constructor for the `{ thread, slack }` pair. Returns
- * two objects that share one bot-token resolver / `request()` closure
- * and one `recentMessages` array (mutated by `refresh`).
+ * Internal constructor for the `{ thread, slack }` pair.
+ *
+ * Auto-anchor: when the binding starts without a `threadTs`, the first
+ * `chat.postMessage` adopts its own `ts` as the thread root; the live
+ * `threadTs` is updated and `onAnchor` fires so the caller can persist
+ * the anchor. Ephemerals and files-only posts do not anchor.
  */
 export declare function buildSlackBinding(input: {
     readonly botToken: SlackBotToken | undefined;
     readonly channelId: string;
     readonly threadTs: string;
     readonly teamId: string | undefined;
+    readonly onAnchor?: (ts: string) => void;
 }): SlackBinding;
 /**
  * Best-effort GFM → Slack mrkdwn converter used only in contexts that

package/dist/src/public/channels/slack/api.js

@@ -20,12 +20,13 @@ import { encodeSlackApiBody } from "#public/channels/slack/api-encoding.js";
 import { cardToBlocks, cardToFallbackText } from "#public/channels/slack/blocks.js";
 const log = createLogger("slack.api");
 /**
- * Builds the Slack channel-local continuation token (`<channelId>:<threadTs>`).
- * Route `send()` namespaces this with the channel name before handing it to the
- * runtime (`slack:<channelId>:<threadTs>`), so Slack routes should pass the raw
- * channel-local form here.
+ * Builds the Slack channel-local continuation token
+ * (`<channelId>:<threadTs>`). Route `send()` namespaces this with the
+ * channel name before handing it to the runtime
+ * (`slack:<channelId>:<threadTs>`). `threadTs` may be empty for
+ * threadless sessions; the channel auto-anchors on its first post.
  */
-export function encodeSlackContinuationToken(channelId, threadTs) {
+export function slackContinuationToken(channelId, threadTs) {
     return `${channelId}:${threadTs}`;
 }
 /**
@@ -67,19 +68,29 @@ export function createSlackRequester(botToken) {
     return (operation, body) => callSlackApi({ botToken, operation, body });
 }
 /**
- * Internal-only constructor for the `{ thread, slack }` pair. Returns
- * two objects that share one bot-token resolver / `request()` closure
- * and one `recentMessages` array (mutated by `refresh`).
+ * Internal constructor for the `{ thread, slack }` pair.
+ *
+ * Auto-anchor: when the binding starts without a `threadTs`, the first
+ * `chat.postMessage` adopts its own `ts` as the thread root; the live
+ * `threadTs` is updated and `onAnchor` fires so the caller can persist
+ * the anchor. Ephemerals and files-only posts do not anchor.
  */
 export function buildSlackBinding(input) {
     const request = createSlackRequester(input.botToken);
     const messages = [];
+    let currentThreadTs = input.threadTs;
+    function anchorIfUnset(ts) {
+        if (currentThreadTs.length > 0 || ts.length === 0)
+            return;
+        currentThreadTs = ts;
+        input.onAnchor?.(ts);
+    }
     async function uploadFiles(files, options) {
         if (files.length === 0) {
             return { fileIds: [], raw: { ok: true } };
         }
         const channelId = options?.channelId ?? input.channelId;
-        const threadTs = options?.threadTs ?? input.threadTs;
+        const threadTs = options?.threadTs ?? currentThreadTs;
         const token = await resolveSlackBotToken(input.botToken);
         const fileIds = [];
         for (const file of files) {
@@ -151,12 +162,13 @@ export function buildSlackBinding(input) {
                     : "";
                 return { id, raw: result.raw };
             }
-            const body = buildPostMessageBody(message, input.channelId, input.threadTs);
+            const body = buildPostMessageBody(message, input.channelId, currentThreadTs);
             const response = await request("chat.postMessage", body);
             if (response.ok !== true) {
                 throw new Error(`Slack chat.postMessage failed: ${response.error ?? "unknown_error"}`);
             }
             const id = typeof response.ts === "string" ? response.ts : "";
+            anchorIfUnset(id);
             // blocks / card + files: structured message lands first, then upload
             // files as a follow-up post in the same thread.
             if (files.length > 0 && hasStructured) {
@@ -171,7 +183,7 @@ export function buildSlackBinding(input) {
         },
         async postEphemeral(userId, rawMessage) {
             const message = normalizePostInput(rawMessage);
-            const body = buildPostMessageBody(message, input.channelId, input.threadTs);
+            const body = buildPostMessageBody(message, input.channelId, currentThreadTs);
             body.user = userId;
             const response = await request("chat.postEphemeral", body);
             if (response.ok !== true) {
@@ -181,12 +193,12 @@ export function buildSlackBinding(input) {
             return { id, raw: response };
         },
         async startTyping(status) {
-            if (!input.channelId || !input.threadTs)
+            if (!input.channelId || !currentThreadTs)
                 return;
             try {
                 const body = {
                     channel_id: input.channelId,
-                    thread_ts: input.threadTs,
+                    thread_ts: currentThreadTs,
                     status: status ?? "",
                 };
                 if (status !== undefined && status.length > 0) {
@@ -205,12 +217,12 @@ export function buildSlackBinding(input) {
         },
         async refresh() {
             messages.length = 0;
-            if (!input.channelId || !input.threadTs)
+            if (!input.channelId || !currentThreadTs)
                 return;
             try {
                 const response = await request("conversations.replies", {
                     channel: input.channelId,
-                    ts: input.threadTs,
+                    ts: currentThreadTs,
                     limit: 50,
                 });
                 if (response.ok !== true || !Array.isArray(response.messages)) {
@@ -218,7 +230,7 @@ export function buildSlackBinding(input) {
                     return;
                 }
                 for (const raw of response.messages) {
-                    messages.push(parseThreadMessage(raw, input.threadTs));
+                    messages.push(parseThreadMessage(raw, currentThreadTs));
                 }
             }
             catch (error) {
@@ -231,7 +243,9 @@ export function buildSlackBinding(input) {
     };
     const slack = {
         channelId: input.channelId,
-        threadTs: input.threadTs,
+        get threadTs() {
+            return currentThreadTs;
+        },
         teamId: input.teamId,
         request,
         uploadFiles,

package/dist/src/public/channels/slack/index.d.ts

@@ -1,6 +1,6 @@
-export { slackChannel, type SlackApiResponse, type SlackBotToken, type SlackChannel, type SlackChannelConfig, type SlackChannelCredentials, type SlackChannelEvents, type SlackChannelState, type SlackContext, type SlackEventContext, type SlackHandle, type SlackInboundResult, type SlackInboundResultOrPromise, type SlackInitialPost, type SlackInteractionAction, type SlackMentionResult, type SlackMentionResultOrPromise, type SlackReceiveArgs, type SlackThread, type SlackWebhookVerifier, } from "#public/channels/slack/slackChannel.js";
+export { slackChannel, type SlackApiResponse, type SlackBotToken, type SlackChannel, type SlackChannelConfig, type SlackChannelCredentials, type SlackChannelEvents, type SlackChannelState, type SlackContext, type SlackEventContext, type SlackHandle, type SlackInboundResult, type SlackInboundResultOrPromise, type SlackInitialMessage, type SlackInteractionAction, type SlackMentionResult, type SlackMentionResultOrPromise, type SlackReceiveArgs, type SlackThread, type SlackWebhookVerifier, } from "#public/channels/slack/slackChannel.js";
 export type { SlackAttachment, SlackAuthor, SlackInboundContext, SlackMessage, } from "#public/channels/slack/inbound.js";
-export type { SlackPostInput, SlackPostedMessage, SlackThreadMessage, SlackUploadFilesOptions, SlackUploadFilesResult, } from "#public/channels/slack/api.js";
+export { slackContinuationToken, type SlackPostInput, type SlackPostedMessage, type SlackThreadMessage, type SlackUploadFilesOptions, type SlackUploadFilesResult, } from "#public/channels/slack/api.js";
 export { cardToBlocks, cardToFallbackText, type BlockKitBlock, } from "#public/channels/slack/blocks.js";
 /**
  * Card builders and element types re-exported from the vendored chat

package/dist/src/public/channels/slack/index.js

@@ -1,4 +1,5 @@
 export { slackChannel, } from "#public/channels/slack/slackChannel.js";
+export { slackContinuationToken, } from "#public/channels/slack/api.js";
 export { cardToBlocks, cardToFallbackText, } from "#public/channels/slack/blocks.js";
 /**
  * Card builders and element types re-exported from the vendored chat

package/dist/src/public/channels/slack/interactions.js

@@ -17,7 +17,7 @@
  * work runs under `waitUntil` so the webhook ACK is immediate.
  */
 import { createLogger } from "#internal/logging.js";
-import { buildSlackBinding, encodeSlackContinuationToken, resolveSlackBotToken, } from "#public/channels/slack/api.js";
+import { buildSlackBinding, resolveSlackBotToken, slackContinuationToken, } from "#public/channels/slack/api.js";
 import { buildAnsweredBlocks, buildFreeformModalView, deriveHitlResponse, freeformRequestIdFromActionId, HITL_FREEFORM_MODAL_ACTION_ID, HITL_FREEFORM_MODAL_BLOCK_ID, HITL_FREEFORM_MODAL_CALLBACK_ID, isFreeformAction, isHitlAction, } from "#public/channels/slack/hitl.js";
 const log = createLogger("slack.interactions");
 /**
@@ -124,7 +124,7 @@ export async function handleInteractionPost(rawBody, ctx, deps) {
         await openFreeformModal({ payload, interaction, freeformAction, deps });
         return ack;
     }
-    const continuationToken = encodeSlackContinuationToken(interaction.channelId, interaction.threadTs);
+    const continuationToken = slackContinuationToken(interaction.channelId, interaction.threadTs);
     const inputResponses = interaction.actions
         .map(deriveHitlResponse)
         .filter((r) => r !== null);
@@ -184,7 +184,7 @@ async function openFreeformModal(input) {
         return;
     }
     const metadata = {
-        continuationToken: encodeSlackContinuationToken(input.interaction.channelId, input.interaction.threadTs),
+        continuationToken: slackContinuationToken(input.interaction.channelId, input.interaction.threadTs),
         channelId: input.interaction.channelId,
         threadTs: input.interaction.threadTs,
         messageTs,

package/dist/src/public/channels/slack/slackChannel.d.ts

@@ -1,4 +1,5 @@
 import type { TypedReceiveRoute } from "#channel/receive-args.js";
+import type { SessionHandle } from "#channel/session.js";
 import type { SessionAuthContext } from "#channel/types.js";
 import type { CardElement } from "#compiled/chat/index.js";
 import type { HandleMessageStreamEvent } from "#protocol/message.js";
@@ -35,6 +36,7 @@ export interface SlackContext {
  * boundaries.
  */
 export interface SlackEventContext extends SlackContext {
+    readonly session: SessionHandle;
     state: SlackChannelState;
 }
 export type { SlackApiResponse, SlackBotToken, SlackHandle, SlackThread, } from "#public/channels/slack/api.js";
@@ -103,14 +105,14 @@ export interface SlackReceiveArgs {
      * the caller wants a visible "this is why we're here" anchor before
      * the model speaks. Mutually exclusive with {@link threadTs}.
      */
-    readonly initialPost?: SlackInitialPost;
+    readonly initialMessage?: SlackInitialMessage;
 }
 /**
  * Pre-agent post issued by `slackChannel().receive` when the caller
- * provides `args.initialPost`. The shape mirrors `ctx.thread.post`'s
+ * provides `args.initialMessage`. The shape mirrors `ctx.thread.post`'s
  * card variant so the same `Card({...})` construction can be reused.
  */
-export interface SlackInitialPost {
+export interface SlackInitialMessage {
     readonly card: CardElement;
     readonly fallbackText?: string;
 }