experimental-ash 0.15.0 → 0.16.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # experimental-ash
 
+## 0.16.0
+
+### Minor Changes
+
+- 4d7af3a: Remove `SlackThread.threadId` from the public Slack channel API and clarify Slack continuation-token encoding. Slack callers should use `ctx.slack.channelId` and `ctx.slack.threadTs` for real Slack API identifiers, while Ash keeps continuation tokens as channel-local values before runtime namespacing.
+
+### Patch Changes
+
+- 8e4067a: Remove Ash-owned AI Gateway reporting tags from harness model calls. Authored `providerOptions.gateway.tags` and `mergeGatewayAutoCaching` behavior are unchanged.
+
 ## 0.15.0
 
 ### Minor Changes
@@ -88,7 +98,7 @@
 
   The resulting `ctx` exposes two handles so call sites read naturally:
 
-  - `ctx.thread` (`SlackThread`) — `post`, `postEphemeral`, `startTyping`, `refresh`, `recentMessages`, `threadId`, `mentionUser`. Reads as "post a reply to this thread".
+  - `ctx.thread` (`SlackThread`) — `post`, `postEphemeral`, `startTyping`, `refresh`, `recentMessages`, `mentionUser`. Reads as "post a reply to this thread".
   - `ctx.slack` (`SlackHandle`) — `channelId`, `threadTs`, `teamId`, `request(op, body)`, `uploadFiles(...)`. Reads as "raw Slack API, possibly not the bound thread".
 
   `ctx.thread.post(...)` accepts ergonomic bare forms (`string` → `{ markdown }`, `CardElement` → `{ card }`) in addition to the explicit `SlackPostInput` variants:

package/dist/docs/public/typescript-api.md

@@ -75,7 +75,7 @@ Channel and Slack types exported from `experimental-ash/channels/slack`:
 - `SlackHandle` - Slack identity handle with `channelId`, `threadTs`, `teamId`, `request()`,
   `uploadFiles()`
 - `SlackThread` - thread-scoped operations: `post`, `postEphemeral`, `startTyping`, `refresh`,
-  `recentMessages`, `mentionUser`, `threadId`
+  `recentMessages`, `mentionUser`
 - `SlackMessage` - parsed inbound mention or DM payload (`text`, `markdown`, `author`,
   `attachments`, `threadTs`, `channelId`, ...)
 - `SlackInteractionAction` - action type for `onInteraction`

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

@@ -461,8 +461,8 @@ async function disposeHook(hook) {
  *
  * Used when no explicit continuation token was provided on RunInput
  * (schedule-initiated sessions). The token is derived from the
- * adapter's serialized thread identity — for Slack, this is the
- * thread id `slack:{channelId}:{threadTs}` when threadTs is populated.
+ * 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"];

package/dist/src/harness/prompt-cache.d.ts

@@ -47,12 +47,6 @@ export declare function getAnthropicCacheMarker(): AnthropicCacheMarker;
  * another value.
  */
 export declare function mergeGatewayAutoCaching(base: Readonly<Record<string, unknown>> | undefined): Record<string, unknown>;
-/**
- * Returns a new `providerOptions` object with `gateway.tags` merged into the
- * existing `gateway` sub-object. Preserves authored tags and de-dupes repeated
- * framework tags across retry and compaction paths.
- */
-export declare function mergeGatewayTags(base: Readonly<Record<string, unknown>> | undefined, tags: readonly string[]): Record<string, unknown>;
 /**
  * Returns a new ToolSet where the last tool entry carries the Anthropic
  * cache marker on `providerOptions`. Used on the `anthropic-direct` path

package/dist/src/harness/prompt-cache.js

@@ -1,4 +1,3 @@
-import { createLogger } from "#internal/logging.js";
 /**
  * Shared frozen marker. All direct-Anthropic breakpoints in the harness share
  * this instance to avoid allocating per-message.
@@ -53,75 +52,6 @@ export function mergeGatewayAutoCaching(base) {
         gateway: mergedGateway,
     };
 }
-const MAX_GATEWAY_TAGS = 10;
-const MAX_GATEWAY_TAG_LENGTH = 64;
-const log = createLogger("harness.prompt-cache");
-function normalizeGatewayTag(tag) {
-    const trimmed = tag.trim();
-    if (!trimmed) {
-        return undefined;
-    }
-    return trimmed
-        .replace(/[^a-zA-Z0-9:_./-]+/g, "_")
-        .replace(/_+/g, "_")
-        .slice(0, MAX_GATEWAY_TAG_LENGTH);
-}
-function gatewayTagKey(tag) {
-    const separatorIndex = tag.indexOf(":");
-    return separatorIndex === -1 ? tag : tag.slice(0, separatorIndex);
-}
-/**
- * Returns a new `providerOptions` object with `gateway.tags` merged into the
- * existing `gateway` sub-object. Preserves authored tags and de-dupes repeated
- * framework tags across retry and compaction paths.
- */
-export function mergeGatewayTags(base, tags) {
-    if (tags.length === 0) {
-        return { ...base };
-    }
-    const baseGateway = base?.gateway !== undefined && typeof base.gateway === "object" && base.gateway !== null
-        ? base.gateway
-        : undefined;
-    const authoredTags = Array.isArray(baseGateway?.tags)
-        ? baseGateway.tags.filter((tag) => typeof tag === "string")
-        : [];
-    const mergedTags = [];
-    for (const tag of authoredTags) {
-        const normalized = normalizeGatewayTag(tag);
-        if (!normalized || mergedTags.includes(normalized)) {
-            continue;
-        }
-        mergedTags.push(normalized);
-        if (mergedTags.length === MAX_GATEWAY_TAGS) {
-            break;
-        }
-    }
-    const droppedTags = [];
-    for (const tag of tags) {
-        const normalized = normalizeGatewayTag(tag);
-        if (!normalized || mergedTags.includes(normalized)) {
-            continue;
-        }
-        if (mergedTags.length === MAX_GATEWAY_TAGS) {
-            droppedTags.push(normalized);
-            continue;
-        }
-        mergedTags.push(normalized);
-    }
-    if (droppedTags.length > 0) {
-        log.warn("dropped Ash AI Gateway reporting tags because Gateway tag limit was reached", {
-            droppedTagKeys: [...new Set(droppedTags.map(gatewayTagKey))],
-            limit: MAX_GATEWAY_TAGS,
-        });
-    }
-    return {
-        ...base,
-        gateway: {
-            ...baseGateway,
-            tags: mergedTags,
-        },
-    };
-}
 /**
  * Returns a new ToolSet where the last tool entry carries the Anthropic
  * cache marker on `providerOptions`. Used on the `anthropic-direct` path

package/dist/src/harness/step-hooks.d.ts

@@ -16,7 +16,6 @@ export interface StepHooksInput {
     readonly cachePath: PromptCachePath;
     readonly emit?: HarnessEmitFn;
     readonly emissionState: HarnessEmissionState;
-    readonly gatewayTags?: readonly string[];
     readonly marker: AnthropicCacheMarker | undefined;
     readonly session: HarnessSession;
 }

package/dist/src/harness/step-hooks.js

@@ -2,7 +2,7 @@ import { createActionResultEvent, createActionsRequestedEvent, createStepComplet
 import { createRuntimeToolResultFromMessagePart, createRuntimeToolResultFromStepResult, } from "#harness/action-result-helpers.js";
 import { emitStepStarted, normalizeAssistantStepFinishReason } from "#harness/emission.js";
 import { extractToolApprovalInputRequests } from "#harness/input-extraction.js";
-import { applyConversationCacheControl, mergeGatewayAutoCaching, mergeGatewayTags, } from "#harness/prompt-cache.js";
+import { applyConversationCacheControl, mergeGatewayAutoCaching, } from "#harness/prompt-cache.js";
 import { createRuntimeActionRequestFromToolCall } from "#harness/runtime-actions.js";
 // ---------------------------------------------------------------------------
 // Builder
@@ -41,9 +41,7 @@ export function buildStepHooks(input) {
             messages: processed,
         };
         if (input.cachePath.kind === "gateway-auto") {
-            let providerOptions = mergeGatewayAutoCaching(session.agent.modelReference.providerOptions);
-            providerOptions = mergeGatewayTags(providerOptions, input.gatewayTags ?? []);
-            stepResult.providerOptions = providerOptions;
+            stepResult.providerOptions = mergeGatewayAutoCaching(session.agent.modelReference.providerOptions);
         }
         return stepResult;
     };

package/dist/src/harness/tool-loop.js

@@ -18,7 +18,7 @@ import { getInstrumentationConfig } from "#harness/instrumentation-config.js";
 import { resolveAssistantStepText } from "#harness/messages.js";
 import { classifyModelCallError, summarizeKnownModelCallConfigError, } from "#harness/model-call-error.js";
 import { ensureOtelIntegration } from "#harness/otel-integration.js";
-import { applyLastToolCacheBreakpoint, detectPromptCachePath, getAnthropicCacheMarker, mergeGatewayTags, } from "#harness/prompt-cache.js";
+import { applyLastToolCacheBreakpoint, detectPromptCachePath, getAnthropicCacheMarker, } from "#harness/prompt-cache.js";
 import { createRuntimeActionRequestFromToolCall, resolvePendingRuntimeActions, setPendingRuntimeActionBatch, } from "#harness/runtime-actions.js";
 import { buildStepHooks, emitStepActions, isInvalidToolCall, } from "#harness/step-hooks.js";
 import { pruneToolResults } from "#harness/tool-result-pruning.js";
@@ -105,20 +105,6 @@ function buildGatewayAttributionHeaders(model, runtimeIdentity) {
         headers["http-referer"] = referer;
     return headers;
 }
-function buildGatewayReportingTags({ runtimeIdentity, session, turnId, }) {
-    const tags = ["framework:ash"];
-    if (session.sessionId.startsWith("wrun_")) {
-        tags.push(`workflowRunId:${session.sessionId}`);
-    }
-    tags.push(`sessionId:${session.sessionId}`);
-    if (turnId) {
-        tags.push(`turnId:${turnId}`);
-    }
-    if (runtimeIdentity?.agentId) {
-        tags.push(`agent:${runtimeIdentity.agentId}`);
-    }
-    return tags;
-}
 // ---------------------------------------------------------------------------
 // Turn trace state — survives step boundaries via session.state
 // ---------------------------------------------------------------------------
@@ -262,15 +248,9 @@ export function createToolLoopHarness(config) {
         // Runs before `agent.stream()` so the compacted messages flow through
         // `messages` (which the harness uses to rebuild session history).
         const attributionHeaders = buildGatewayAttributionHeaders(model, config.runtimeIdentity);
-        const gatewayTags = buildGatewayReportingTags({
-            runtimeIdentity: config.runtimeIdentity,
-            session,
-            turnId: emissionState.turnId,
-        });
         ({ messages, session } = await maybeCompact({
             emit,
             emissionState,
-            gatewayTags,
             headers: attributionHeaders,
             messages,
             model,
@@ -304,7 +284,6 @@ export function createToolLoopHarness(config) {
             cachePath,
             emit,
             emissionState,
-            gatewayTags,
             marker,
             session,
         });
@@ -627,13 +606,7 @@ async function maybeCompact(input) {
             usageInputTokens: getInputTokenCount(messages, session.compaction),
         }));
     }
-    const compactionProviderOptions = typeof compaction.model === "string"
-        ? mergeGatewayTags(compaction.providerOptions, [
-            "operation:compaction",
-            ...(input.gatewayTags ?? []),
-        ])
-        : compaction.providerOptions;
-    messages = await compactMessages(messages, compaction.model, session.compaction, compactionProviderOptions, input.telemetry, input.headers);
+    messages = await compactMessages(messages, compaction.model, session.compaction, compaction.providerOptions, input.telemetry, input.headers);
     if (input.onCompaction) {
         const compacted = await input.onCompaction(session);
         session = compacted.session;

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.15.0";
+const BUNDLED_FALLBACK_PACKAGE_VERSION = "0.16.0";
 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,22 +22,12 @@ import { type CardElement, type FileUpload } from "#compiled/chat/index.js";
  */
 export type SlackBotToken = string | (() => string | Promise<string>);
 /**
- * Decodes a Slack thread id of the form `slack:<channelId>:<threadTs>`
- * back into its parts. Returns empty-string fields when the input does
- * not match — used by the channel's fallback paths where the channel
- * id has not yet been observed.
+ * 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.
  */
-export declare function decodeThreadId(id: string): {
-    channelId: string;
-    threadTs: string;
-};
-/**
- * Builds the Ash thread id (`slack:<channelId>:<threadTs>`) used as the
- * channel's continuation token. Keeps the encoding in one place so the
- * inbound route, the interaction handler, and the context rebuild path
- * cannot drift on the format.
- */
-export declare function encodeThreadId(channelId: string, threadTs: string): string;
+export declare function encodeSlackContinuationToken(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.
@@ -176,8 +166,6 @@ export interface SlackThreadMessage {
  * use {@link SlackHandle.request} on `ctx.slack` instead.
  */
 export interface SlackThread {
-    /** Ash continuation-token thread id — `slack:<channelId>:<threadTs>`. */
-    readonly threadId: string;
     /** Recently fetched thread messages. Populated by {@link refresh}. */
     readonly recentMessages: readonly SlackThreadMessage[];
     /**

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

@@ -20,23 +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");
 /**
- * Decodes a Slack thread id of the form `slack:<channelId>:<threadTs>`
- * back into its parts. Returns empty-string fields when the input does
- * not match — used by the channel's fallback paths where the channel
- * id has not yet been observed.
+ * 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.
  */
-export function decodeThreadId(id) {
-    const parts = id.replace(/^slack:/u, "").split(":");
-    return { channelId: parts[0] ?? "", threadTs: parts[1] ?? "" };
-}
-/**
- * Builds the Ash thread id (`slack:<channelId>:<threadTs>`) used as the
- * channel's continuation token. Keeps the encoding in one place so the
- * inbound route, the interaction handler, and the context rebuild path
- * cannot drift on the format.
- */
-export function encodeThreadId(channelId, threadTs) {
-    return `slack:${channelId}:${threadTs}`;
+export function encodeSlackContinuationToken(channelId, threadTs) {
+    return `${channelId}:${threadTs}`;
 }
 /**
  * Materializes a {@link SlackBotToken} to a concrete string. Falls
@@ -142,7 +132,6 @@ export function buildSlackBinding(input) {
         return { fileIds, raw: complete };
     }
     const thread = {
-        threadId: encodeThreadId(input.channelId, input.threadTs),
         recentMessages: messages,
         async post(rawMessage) {
             const message = normalizePostInput(rawMessage);

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, encodeThreadId, resolveSlackBotToken, } from "#public/channels/slack/api.js";
+import { buildSlackBinding, encodeSlackContinuationToken, resolveSlackBotToken, } 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");
 /**
@@ -117,7 +117,7 @@ export async function handleInteractionPost(rawBody, ctx, deps) {
         await openFreeformModal({ payload, interaction, freeformAction, deps });
         return ack;
     }
-    const continuationToken = encodeThreadId(interaction.channelId, interaction.threadTs);
+    const continuationToken = encodeSlackContinuationToken(interaction.channelId, interaction.threadTs);
     const inputResponses = interaction.actions
         .map(deriveHitlResponse)
         .filter((r) => r !== null);
@@ -177,7 +177,7 @@ async function openFreeformModal(input) {
         return;
     }
     const metadata = {
-        continuationToken: encodeThreadId(input.interaction.channelId, input.interaction.threadTs),
+        continuationToken: encodeSlackContinuationToken(input.interaction.channelId, input.interaction.threadTs),
         channelId: input.interaction.channelId,
         threadTs: input.interaction.threadTs,
         messageTs,

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

@@ -18,7 +18,7 @@ type EventData<T extends HandleMessageStreamEvent["type"]> = Extract<HandleMessa
  *
  * - {@link thread} owns thread-scoped operations (`post`,
  *   `postEphemeral`, `startTyping`, `refresh`, `recentMessages`,
- *   `threadId`, `mentionUser`). Reads as "post a reply to this thread".
+ *   `mentionUser`). Reads as "post a reply to this thread".
  * - {@link slack} owns Slack identity (`channelId`, `threadTs`,
  *   `teamId`) plus the raw-API escape hatch (`request`, `uploadFiles`).
  */

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

@@ -1,5 +1,5 @@
 import { createLogger } from "#internal/logging.js";
-import { buildSlackBinding, encodeThreadId, } from "#public/channels/slack/api.js";
+import { buildSlackBinding, encodeSlackContinuationToken, } from "#public/channels/slack/api.js";
 import { buildSlackTurnMessage, collectInboundFileParts, createSlackFetchFile, } from "#public/channels/slack/attachments.js";
 import { defaultEvents, defaultInputRequestedHandler, defaultOnAppMention, defaultOnDirectMessage, } from "#public/channels/slack/defaults.js";
 import { parseAppMentionEvent, parseDirectMessageEvent, prependSlackContext, } from "#public/channels/slack/inbound.js";
@@ -79,7 +79,7 @@ export function slackChannel(config = {}) {
             const threadTs = typeof input.args.threadTs === "string" ? input.args.threadTs : "";
             return send(input.message, {
                 auth: input.auth,
-                continuationToken: encodeThreadId(channelId, threadTs),
+                continuationToken: encodeSlackContinuationToken(channelId, threadTs),
                 state: {
                     channelId,
                     threadTs: threadTs || null,
@@ -184,7 +184,7 @@ async function dispatchInboundMessage(input) {
     }
     if (result === null || result === undefined)
         return;
-    const continuationToken = encodeThreadId(message.channelId, message.threadTs);
+    const continuationToken = encodeSlackContinuationToken(message.channelId, message.threadTs);
     const fileParts = await collectInboundFileParts({
         mention: message,
         thread,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "experimental-ash",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "bin": {
     "ash": "./bin/ash.js",
     "experimental-ash": "./bin/ash.js"