zeitlich 0.2.37 → 0.2.38

package/dist/adapters/thread/langchain/index.cjs

@@ -85,6 +85,20 @@ function createThreadManager(config) {
     },
     async delete() {
       await redis.del(redisKey, metaKey);
+    },
+    async length() {
+      await assertThreadExists();
+      return redis.llen(redisKey);
+    },
+    async truncate(length) {
+      await assertThreadExists();
+      if (length <= 0) {
+        await redis.del(redisKey);
+        await redis.expire(metaKey, THREAD_TTL_SECONDS);
+      } else {
+        await redis.ltrim(redisKey, 0, length - 1);
+        await redis.expire(redisKey, THREAD_TTL_SECONDS);
+      }
     }
   };
 }
@@ -142,7 +156,8 @@ function createLangChainThreadManager(config) {
       const mapped = onPrepareMessage ? stored.map((msg, i) => onPrepareMessage(msg, i, stored)) : stored;
       const messages$1 = messages.mapStoredMessagesToChatMessages(mapped);
       return {
-        messages: onPreparedMessage ? messages$1.map((msg, i) => onPreparedMessage(msg, i, messages$1)) : messages$1
+        messages: onPreparedMessage ? messages$1.map((msg, i) => onPreparedMessage(msg, i, messages$1)) : messages$1,
+        storedLength: stored.length
       };
     }
   };
@@ -214,7 +229,7 @@ function createLangChainModelInvoker({ redis, model, hooks }) {
       hooks
     });
     const runId = v4_default();
-    const { messages } = await thread.prepareForInvocation();
+    const { messages, storedLength } = await thread.prepareForInvocation();
     const heartbeatInterval = heartbeat ? setInterval(() => heartbeat(), 3e4) : void 0;
     try {
       const response = await model.invoke(messages, {
@@ -239,7 +254,8 @@ function createLangChainModelInvoker({ redis, model, hooks }) {
           reasonTokens: response.usage_metadata?.output_token_details?.reasoning,
           cachedWriteTokens: response.usage_metadata?.input_token_details?.cache_creation || providerUsage.cacheWriteInputTokens,
           cachedReadTokens: response.usage_metadata?.input_token_details?.cache_read || providerUsage.cacheReadInputTokens
-        }
+        },
+        threadLengthAtCall: storedLength
       };
     } finally {
       if (heartbeatInterval) clearInterval(heartbeatInterval);
@@ -310,6 +326,10 @@ function createLangChainAdapter(config) {
         key: threadKey
       });
       await thread.fork(targetThreadId);
+    },
+    async truncateThread(threadId, length, threadKey) {
+      const thread = createLangChainThreadManager({ redis, threadId, key: threadKey });
+      await thread.truncate(length);
     }
   };
   function createActivities(scope) {

package/dist/adapters/thread/langchain/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/thread/manager.ts","../../../../src/adapters/thread/langchain/thread-manager.ts","../../../../node_modules/uuid/dist/esm/stringify.js","../../../../node_modules/uuid/dist/esm/rng.js","../../../../node_modules/uuid/dist/esm/native.js","../../../../node_modules/uuid/dist/esm/v4.js","../../../../src/lib/activity.ts","../../../../src/adapters/thread/langchain/model-invoker.ts","../../../../src/adapters/thread/langchain/activities.ts","../../../../src/adapters/thread/langchain/hooks.ts"],"names":["HumanMessage","SystemMessage","AIMessage","ToolMessage","messages","mapStoredMessagesToChatMessages","randomFillSync","randomUUID","Context","invokeLangChainModel","content"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { ThreadManagerConfig, BaseThreadManager } from \"./types\";\n\nconst THREAD_TTL_SECONDS = 60 * 60 * 24 * 90; // 90 days\n\n/**\n * Lua script for atomic idempotent append.\n * Checks a dedup key; if it exists the message was already appended and we\n * return 0. Otherwise appends all messages to the list, sets TTL on both\n * the list and the dedup key, and returns 1.\n *\n * KEYS[1] = dedup key, KEYS[2] = list key\n * ARGV[1] = TTL seconds, ARGV[2..N] = serialised messages\n */\nconst APPEND_IDEMPOTENT_SCRIPT = `\nif redis.call('EXISTS', KEYS[1]) == 1 then\n  return 0\nend\nfor i = 2, #ARGV do\n  redis.call('RPUSH', KEYS[2], ARGV[i])\nend\nredis.call('EXPIRE', KEYS[2], tonumber(ARGV[1]))\nredis.call('SET', KEYS[1], '1', 'EX', tonumber(ARGV[1]))\nreturn 1\n`;\n\nfunction getThreadKey(threadId: string, key: string): string {\n  return `${key}:thread:${threadId}`;\n}\n\n/**\n * Creates a generic thread manager for handling conversation state in Redis.\n * Framework-agnostic — works with any serializable message type.\n */\nexport function createThreadManager<T>(\n  config: ThreadManagerConfig<T>\n): BaseThreadManager<T> {\n  const {\n    redis,\n    threadId,\n    key = \"messages\",\n    serialize = (m: T): string => JSON.stringify(m),\n    deserialize = (raw: string): T => JSON.parse(raw) as T,\n    idOf,\n  } = config;\n  const redisKey = getThreadKey(threadId, key);\n  const metaKey = getThreadKey(threadId, `${key}:meta`);\n\n  async function assertThreadExists(): Promise<void> {\n    const exists = await redis.exists(metaKey);\n    if (!exists) {\n      throw new Error(`Thread \"${threadId}\" (key: ${key}) does not exist`);\n    }\n  }\n\n  return {\n    async initialize(): Promise<void> {\n      await redis.del(redisKey);\n      await redis.set(metaKey, \"1\", \"EX\", THREAD_TTL_SECONDS);\n    },\n\n    async load(): Promise<T[]> {\n      await assertThreadExists();\n      const data = await redis.lrange(redisKey, 0, -1);\n      return data.map(deserialize);\n    },\n\n    async append(messages: T[]): Promise<void> {\n      if (messages.length === 0) return;\n      await assertThreadExists();\n\n      if (idOf) {\n        const dedupId = messages.map(idOf).join(\":\");\n        const dedupKey = getThreadKey(threadId, `dedup:${dedupId}`);\n        await redis.eval(\n          APPEND_IDEMPOTENT_SCRIPT,\n          2,\n          dedupKey,\n          redisKey,\n          String(THREAD_TTL_SECONDS),\n          ...messages.map(serialize)\n        );\n      } else {\n        await redis.rpush(redisKey, ...messages.map(serialize));\n        await redis.expire(redisKey, THREAD_TTL_SECONDS);\n      }\n    },\n\n    async fork(newThreadId: string): Promise<BaseThreadManager<T>> {\n      await assertThreadExists();\n      const data = await redis.lrange(redisKey, 0, -1);\n      const forked = createThreadManager({\n        ...config,\n        threadId: newThreadId,\n      });\n      await forked.initialize();\n      if (data.length > 0) {\n        const newKey = getThreadKey(newThreadId, key);\n        await redis.rpush(newKey, ...data);\n        await redis.expire(newKey, THREAD_TTL_SECONDS);\n      }\n      return forked;\n    },\n\n    async delete(): Promise<void> {\n      await redis.del(redisKey, metaKey);\n    },\n  };\n}\n","import type Redis from \"ioredis\";\nimport type { JsonValue } from \"../../../lib/state/types\";\nimport {\n  AIMessage,\n  type BaseMessage,\n  HumanMessage,\n  type MessageContent,\n  type StoredMessage,\n  SystemMessage,\n  ToolMessage,\n  mapStoredMessagesToChatMessages,\n} from \"@langchain/core/messages\";\nimport { createThreadManager } from \"../../../lib/thread/manager\";\nimport type {\n  ProviderThreadManager,\n  ThreadManagerConfig,\n  ThreadManagerHooks,\n} from \"../../../lib/thread/types\";\n\n/** SDK-native content type for LangChain human messages */\nexport type LangChainContent = string | MessageContent;\n\n/** SDK-native content type for LangChain system messages */\nexport type LangChainSystemContent = string | MessageContent;\n\nexport type LangChainThreadManagerHooks = ThreadManagerHooks<\n  StoredMessage,\n  BaseMessage\n>;\n\nexport interface LangChainThreadManagerConfig {\n  redis: Redis;\n  threadId: string;\n  /** Thread key, defaults to 'messages' */\n  key?: string;\n  hooks?: LangChainThreadManagerHooks;\n}\n\n/** Prepared payload ready to send to a LangChain chat model */\nexport interface LangChainInvocationPayload {\n  messages: BaseMessage[];\n}\n\n/** Thread manager with LangChain StoredMessage convenience helpers */\nexport interface LangChainThreadManager extends ProviderThreadManager<\n  StoredMessage,\n  LangChainContent,\n  JsonValue,\n  LangChainSystemContent\n> {\n  appendAIMessage(id: string, content: string | MessageContent): Promise<void>;\n  prepareForInvocation(): Promise<LangChainInvocationPayload>;\n}\n\nfunction storedMessageId(msg: StoredMessage): string {\n  if (msg.type === \"tool\" && msg.data.tool_call_id) {\n    return msg.data.tool_call_id;\n  }\n\n  if (msg.data.id) {\n    return msg.data.id;\n  }\n\n  throw new Error(\"No id found for message\");\n}\n\n/**\n * Creates a LangChain-specific thread manager that stores StoredMessage\n * instances in Redis and provides convenience helpers for creating and\n * appending typed LangChain messages.\n */\nexport function createLangChainThreadManager(\n  config: LangChainThreadManagerConfig\n): LangChainThreadManager {\n  const baseConfig: ThreadManagerConfig<StoredMessage> = {\n    redis: config.redis,\n    threadId: config.threadId,\n    key: config.key,\n    idOf: storedMessageId,\n  };\n\n  const base = createThreadManager(baseConfig);\n\n  const helpers: Omit<LangChainThreadManager, keyof typeof base> = {\n    async appendUserMessage(\n      id: string,\n      content: LangChainContent\n    ): Promise<void> {\n      await base.append([\n        new HumanMessage({ id, content: content as MessageContent }).toDict(),\n      ]);\n    },\n\n    async appendSystemMessage(\n      id: string,\n      content: LangChainSystemContent\n    ): Promise<void> {\n      await base.initialize();\n      await base.append([\n        new SystemMessage({\n          id,\n          content: content as MessageContent,\n        }).toDict(),\n      ]);\n    },\n\n    async appendAIMessage(\n      id: string,\n      content: string | MessageContent\n    ): Promise<void> {\n      await base.append([\n        new AIMessage({ id, content: content as MessageContent }).toDict(),\n      ]);\n    },\n\n    async appendToolResult(\n      id: string,\n      _toolCallId: string,\n      _toolName: string,\n      content: JsonValue\n    ): Promise<void> {\n      await base.append([\n        new ToolMessage({\n          id,\n          content: content as MessageContent,\n          tool_call_id: _toolCallId,\n        }).toDict(),\n      ]);\n    },\n\n    async prepareForInvocation(): Promise<LangChainInvocationPayload> {\n      const stored = await base.load();\n      const { onPrepareMessage, onPreparedMessage } = config.hooks ?? {};\n      const mapped = onPrepareMessage\n        ? stored.map((msg, i) => onPrepareMessage(msg, i, stored))\n        : stored;\n      const messages = mapStoredMessagesToChatMessages(mapped);\n      return {\n        messages: onPreparedMessage\n          ? messages.map((msg, i) => onPreparedMessage(msg, i, messages))\n          : messages,\n      };\n    },\n  };\n\n  return Object.assign(base, helpers);\n}\n","import validate from './validate.js';\nconst byteToHex = [];\nfor (let i = 0; i < 256; ++i) {\n    byteToHex.push((i + 0x100).toString(16).slice(1));\n}\nexport function unsafeStringify(arr, offset = 0) {\n    return (byteToHex[arr[offset + 0]] +\n        byteToHex[arr[offset + 1]] +\n        byteToHex[arr[offset + 2]] +\n        byteToHex[arr[offset + 3]] +\n        '-' +\n        byteToHex[arr[offset + 4]] +\n        byteToHex[arr[offset + 5]] +\n        '-' +\n        byteToHex[arr[offset + 6]] +\n        byteToHex[arr[offset + 7]] +\n        '-' +\n        byteToHex[arr[offset + 8]] +\n        byteToHex[arr[offset + 9]] +\n        '-' +\n        byteToHex[arr[offset + 10]] +\n        byteToHex[arr[offset + 11]] +\n        byteToHex[arr[offset + 12]] +\n        byteToHex[arr[offset + 13]] +\n        byteToHex[arr[offset + 14]] +\n        byteToHex[arr[offset + 15]]).toLowerCase();\n}\nfunction stringify(arr, offset = 0) {\n    const uuid = unsafeStringify(arr, offset);\n    if (!validate(uuid)) {\n        throw TypeError('Stringified UUID is invalid');\n    }\n    return uuid;\n}\nexport default stringify;\n","import { randomFillSync } from 'crypto';\nconst rnds8Pool = new Uint8Array(256);\nlet poolPtr = rnds8Pool.length;\nexport default function rng() {\n    if (poolPtr > rnds8Pool.length - 16) {\n        randomFillSync(rnds8Pool);\n        poolPtr = 0;\n    }\n    return rnds8Pool.slice(poolPtr, (poolPtr += 16));\n}\n","import { randomUUID } from 'crypto';\nexport default { randomUUID };\n","import native from './native.js';\nimport rng from './rng.js';\nimport { unsafeStringify } from './stringify.js';\nfunction v4(options, buf, offset) {\n    if (native.randomUUID && !buf && !options) {\n        return native.randomUUID();\n    }\n    options = options || {};\n    const rnds = options.random ?? options.rng?.() ?? rng();\n    if (rnds.length < 16) {\n        throw new Error('Random bytes length must be >= 16');\n    }\n    rnds[6] = (rnds[6] & 0x0f) | 0x40;\n    rnds[8] = (rnds[8] & 0x3f) | 0x80;\n    if (buf) {\n        offset = offset || 0;\n        if (offset < 0 || offset + 16 > buf.length) {\n            throw new RangeError(`UUID byte range ${offset}:${offset + 15} is out of buffer bounds`);\n        }\n        for (let i = 0; i < 16; ++i) {\n            buf[offset + i] = rnds[i];\n        }\n        return buf;\n    }\n    return unsafeStringify(rnds);\n}\nexport default v4;\n","import { Context } from \"@temporalio/activity\";\nimport type { WorkflowClient } from \"@temporalio/client\";\nimport type { BaseAgentState, RunAgentConfig } from \"./types\";\nimport type { JsonValue } from \"./state/types\";\nimport type {\n  ActivityToolHandler,\n  RouterContext,\n  ToolHandlerResponse,\n} from \"./tool-router/types\";\n\n/**\n * Safely retrieve Temporal activity heartbeat and cancellation signal.\n * Returns empty object when called outside a Temporal activity (e.g. tests).\n */\nexport function getActivityContext(): {\n  heartbeat?: () => void;\n  signal?: AbortSignal;\n} {\n  try {\n    const ctx = Context.current();\n    return { heartbeat: () => ctx.heartbeat(), signal: ctx.cancellationSignal };\n  } catch {\n    return {};\n  }\n}\n\n/**\n * Query the parent workflow's state from within an activity.\n * Resolves the workflow handle from the current activity context.\n */\nexport async function queryParentWorkflowState<T>(\n  client: WorkflowClient\n): Promise<T> {\n  const { workflowExecution } = Context.current().info;\n  const handle = client.getHandle(\n    workflowExecution.workflowId,\n    workflowExecution.runId\n  );\n  return handle.query<T>(\"getAgentState\");\n}\n\n/**\n * Wraps a handler into a scope-prefixed `RunAgentActivity` by auto-fetching\n * the parent workflow's agent state before each invocation.\n *\n * Returns a `Record` with a single key `run<Scope>` so it can be spread\n * into the activities object alongside adapter activities.\n *\n * @param scope - Workflow scope used to derive the activity name.\n *   `\"myAgentWorkflow\"` produces `{ runMyAgentWorkflow: fn }`.\n *\n * @example\n * ```typescript\n * import { createRunAgentActivity } from 'zeitlich';\n *\n * return {\n *   ...adapter.createActivities(\"myAgentWorkflow\"),\n *   ...createRunAgentActivity(client, adapter.invoker, \"myAgentWorkflow\"),\n * };\n * ```\n */\nexport function createRunAgentActivity<\n  R,\n  S extends BaseAgentState = BaseAgentState,\n>(\n  client: WorkflowClient,\n  handler: (config: RunAgentConfig & { state: S }) => Promise<R>,\n  scope: string\n): Record<string, (config: RunAgentConfig) => Promise<R>> {\n  const name = `run${scope.charAt(0).toUpperCase()}${scope.slice(1)}`;\n  return {\n    [name]: async (config: RunAgentConfig) => {\n      const state = await queryParentWorkflowState<S>(client);\n      return handler({ ...config, state });\n    },\n  };\n}\n\n/**\n * Context injected into tool handlers created via {@link withParentWorkflowState}.\n */\nexport interface AgentStateContext<\n  S extends BaseAgentState = BaseAgentState,\n> extends RouterContext {\n  state: S;\n}\n\n/**\n * Wraps a tool handler into an `ActivityToolHandler` by auto-fetching the\n * parent workflow's agent state before each invocation.\n *\n * @typeParam S - Custom agent state type (defaults to `BaseAgentState`)\n *\n * @example\n * ```typescript\n * import { withParentWorkflowState, type AgentStateContext } from 'zeitlich';\n *\n * // With custom state:\n * interface MyState extends BaseAgentState { customField: string }\n * const myHandler = withParentWorkflowState<MyArgs, MyResult, MyState>(\n *   client,\n *   async (args, ctx) => {\n *     console.log(ctx.state.customField);\n *     return { toolResponse: 'done', data: null };\n *   },\n * );\n * ```\n */\nexport function withParentWorkflowState<\n  TArgs,\n  TResult,\n  S extends BaseAgentState = BaseAgentState,\n  TToolResponse = JsonValue,\n>(\n  client: WorkflowClient,\n  handler: (\n    args: TArgs,\n    context: AgentStateContext<S>\n  ) => Promise<ToolHandlerResponse<TResult, TToolResponse>>\n): ActivityToolHandler<TArgs, TResult, RouterContext, TToolResponse> {\n  return async (args, context) => {\n    const state = await queryParentWorkflowState<S>(client);\n    return handler(args, { ...context, state });\n  };\n}\n","import type Redis from \"ioredis\";\nimport type { AgentResponse, ModelInvokerConfig } from \"../../../lib/model\";\nimport type { StoredMessage } from \"@langchain/core/messages\";\nimport { v4 as uuidv4 } from \"uuid\";\nimport type { BaseChatModel } from \"@langchain/core/language_models/chat_models\";\nimport {\n  createLangChainThreadManager,\n  type LangChainThreadManagerHooks,\n} from \"./thread-manager\";\nimport { getActivityContext } from \"../../../lib/activity\";\n\n \nexport interface LangChainModelInvokerConfig<\n  TModel extends BaseChatModel<any> = BaseChatModel<any>,\n> {\n  redis: Redis;\n  model: TModel;\n  hooks?: LangChainThreadManagerHooks;\n}\n\n/**\n * Creates a LangChain-based model invoker that satisfies the generic\n * `ModelInvoker<StoredMessage>` contract.\n *\n * Uses interval-based Temporal heartbeats during model.invoke() to keep\n * long-running LLM calls visible to the scheduler. LangChain's streaming\n * chunk accumulation is unreliable across providers (e.g. reasoning_content\n * blocks don't merge correctly), so we use invoke() for correctness.\n * The caller is responsible for appending the response to the thread.\n *\n * @example\n * ```typescript\n * import { createLangChainModelInvoker } from 'zeitlich/adapters/thread/langchain';\n * import { createRunAgentActivity } from 'zeitlich';\n * import { ChatAnthropic } from '@langchain/anthropic';\n *\n * const model = new ChatAnthropic({ model: \"claude-sonnet-4-6\" });\n * const invoker = createLangChainModelInvoker({ redis, model });\n *\n * return { ...createRunAgentActivity(client, invoker, \"myAgent\") };\n * ```\n */\n \nexport function createLangChainModelInvoker<\n  TModel extends BaseChatModel<any> = BaseChatModel<any>,\n>({ redis, model, hooks }: LangChainModelInvokerConfig<TModel>) {\n  return async function invokeLangChainModel(\n    config: ModelInvokerConfig\n  ): Promise<AgentResponse<StoredMessage>> {\n    const { threadId, threadKey, agentName, state, metadata } = config;\n    const { heartbeat, signal } = getActivityContext();\n\n    const thread = createLangChainThreadManager({\n      redis,\n      threadId,\n      key: threadKey,\n      hooks,\n    });\n    const runId = uuidv4();\n\n    const { messages } = await thread.prepareForInvocation();\n\n    const heartbeatInterval = heartbeat\n      ? setInterval(() => heartbeat(), 30_000)\n      : undefined;\n\n    try {\n      const response = await model.invoke(messages, {\n        runName: agentName,\n        runId,\n        metadata: { thread_id: `${agentName}-${threadId}`, ...metadata },\n        tools: state.tools,\n        signal,\n      });\n\n      const toolCalls = response.tool_calls ?? [];\n\n      const providerUsage =\n        (response.response_metadata?.usage as Record<string, unknown>) ?? {};\n\n      return {\n        message: response.toDict(),\n        rawToolCalls: toolCalls.map((tc) => ({\n          id: tc.id,\n          name: tc.name,\n          args: tc.args,\n        })),\n        usage: {\n          inputTokens: response.usage_metadata?.input_tokens,\n          outputTokens: response.usage_metadata?.output_tokens,\n          reasonTokens:\n            response.usage_metadata?.output_token_details?.reasoning,\n          cachedWriteTokens:\n            response.usage_metadata?.input_token_details?.cache_creation ||\n            (providerUsage.cacheWriteInputTokens as number | undefined),\n          cachedReadTokens:\n            response.usage_metadata?.input_token_details?.cache_read ||\n            (providerUsage.cacheReadInputTokens as number | undefined),\n        },\n      };\n    } finally {\n      if (heartbeatInterval) clearInterval(heartbeatInterval);\n    }\n  };\n}\n\n/**\n * Standalone function for one-shot LangChain model invocation.\n * Convenience wrapper around createLangChainModelInvoker for cases where\n * you don't need to reuse the invoker.\n */\n \nexport async function invokeLangChainModel<\n  TModel extends BaseChatModel<any> = BaseChatModel<any>,\n>({\n  redis,\n  model,\n  hooks,\n  config,\n}: {\n  redis: Redis;\n  config: ModelInvokerConfig;\n  model: TModel;\n  hooks?: LangChainThreadManagerHooks;\n}): Promise<AgentResponse<StoredMessage>> {\n  const invoker = createLangChainModelInvoker({ redis, model, hooks });\n  return invoker(config);\n}\n","import type Redis from \"ioredis\";\nimport type { ToolResultConfig } from \"../../../lib/types\";\nimport type { MessageContent } from \"@langchain/core/messages\";\nimport type {\n  ActivityToolHandler,\n  RouterContext,\n  ToolHandlerResponse,\n} from \"../../../lib/tool-router/types\";\nimport type {\n  ThreadOps,\n  PrefixedThreadOps,\n  ScopedPrefix,\n} from \"../../../lib/session/types\";\nimport type { ModelInvoker } from \"../../../lib/model\";\nimport type { StoredMessage } from \"@langchain/core/messages\";\nimport type { BaseChatModel } from \"@langchain/core/language_models/chat_models\";\nimport {\n  createLangChainThreadManager,\n  type LangChainContent,\n  type LangChainSystemContent,\n  type LangChainThreadManagerHooks,\n} from \"./thread-manager\";\nimport { createLangChainModelInvoker } from \"./model-invoker\";\n\nconst ADAPTER_PREFIX = \"langChain\" as const;\n\nexport type LangChainThreadOps<TScope extends string = \"\"> = PrefixedThreadOps<\n  ScopedPrefix<TScope, typeof ADAPTER_PREFIX>,\n  LangChainContent\n>;\n\nexport interface LangChainAdapterConfig {\n  redis: Redis;\n  /** Optional default model — if omitted, use `createModelInvoker()` to create invokers later */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  model?: BaseChatModel<any>;\n  hooks?: LangChainThreadManagerHooks;\n}\n\n/**\n * Tool response type accepted by the LangChain adapter.\n *\n * Content is passed directly to `ToolMessage` as `MessageContent`.\n * Handlers can return a string or an array of content blocks\n * (e.g. `{ type: \"text\", text: \"...\" }`, `{ type: \"image_url\", image_url: { ... } }`).\n */\nexport type LangChainToolResponse = MessageContent;\n\nexport interface LangChainAdapter {\n  /** Model invoker using the default model (only available when `model` was provided) */\n  invoker: ModelInvoker<StoredMessage>;\n  /** Create an invoker for a specific model (for multi-model setups) */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  createModelInvoker(model: BaseChatModel<any>): ModelInvoker<StoredMessage>;\n  /**\n   * Create prefixed thread activities for registration on the worker.\n   *\n   * @param scope - Workflow name appended to the adapter prefix.\n   *\n   * @example\n   * ```typescript\n   * adapter.createActivities(\"codingAgent\")\n   * // → { langChainCodingAgentInitializeThread, langChainCodingAgentAppendHumanMessage, … }\n   * ```\n   */\n  createActivities<S extends string = \"\">(scope?: S): LangChainThreadOps<S>;\n\n  /**\n   * Identity wrapper that types a tool handler for this adapter.\n   * Constrains `toolResponse` to {@link LangChainToolResponse}.\n   */\n  wrapHandler<TArgs, TResult, TContext extends RouterContext = RouterContext>(\n    handler: (\n      args: TArgs,\n      context: TContext\n    ) => Promise<ToolHandlerResponse<TResult, LangChainToolResponse>>\n  ): ActivityToolHandler<TArgs, TResult, TContext, LangChainToolResponse>;\n}\n\n/**\n * Creates a LangChain adapter that bundles thread operations and model\n * invocation using a consistent message format (StoredMessage).\n *\n * Use `createActivities(scope)` to register scoped thread operations as\n * Temporal activities on the worker. The `invoker` (or invokers created via\n * `createModelInvoker`) should be wrapped with `createRunAgentActivity`.\n *\n * @example\n * ```typescript\n * import { createLangChainAdapter } from 'zeitlich/adapters/thread/langchain';\n * import { createRunAgentActivity } from 'zeitlich';\n *\n * const adapter = createLangChainAdapter({ redis, model });\n *\n * export function createActivities(client: WorkflowClient) {\n *   return {\n *     ...adapter.createActivities(\"codingAgent\"),\n *     ...createRunAgentActivity(client, adapter.invoker, \"codingAgent\"),\n *   };\n * }\n * ```\n *\n * @example Multi-agent worker\n * ```typescript\n * export function createActivities(client: WorkflowClient) {\n *   return {\n *     ...adapter.createActivities(\"codingAgent\"),\n *     ...adapter.createActivities(\"researchAgent\"),\n *     ...createRunAgentActivity(client, adapter.invoker, \"codingAgent\"),\n *     ...createRunAgentActivity(client, adapter.createModelInvoker(claude), \"researchAgent\"),\n *   };\n * }\n * ```\n */\nexport function createLangChainAdapter(\n  config: LangChainAdapterConfig\n): LangChainAdapter {\n  const { redis } = config;\n\n  const threadOps: ThreadOps<LangChainContent> = {\n    async initializeThread(\n      threadId: string,\n      threadKey?: string\n    ): Promise<void> {\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId,\n        key: threadKey,\n      });\n      await thread.initialize();\n    },\n\n    async appendHumanMessage(\n      threadId: string,\n      id: string,\n      content: LangChainContent,\n      threadKey?: string\n    ): Promise<void> {\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId,\n        key: threadKey,\n      });\n      await thread.appendUserMessage(id, content);\n    },\n\n    async appendSystemMessage(\n      threadId: string,\n      id: string,\n      content: LangChainSystemContent,\n      threadKey?: string\n    ): Promise<void> {\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId,\n        key: threadKey,\n      });\n      await thread.appendSystemMessage(id, content);\n    },\n\n    async appendToolResult(id: string, cfg: ToolResultConfig): Promise<void> {\n      const { threadId, threadKey, toolCallId, content } = cfg;\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId,\n        key: threadKey,\n      });\n      await thread.appendToolResult(id, toolCallId, \"\", content);\n    },\n\n    async appendAgentMessage(\n      threadId: string,\n      id: string,\n      message: StoredMessage,\n      threadKey?: string\n    ): Promise<void> {\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId,\n        key: threadKey,\n      });\n      const patched = { ...message, data: { ...message.data, id } };\n      await thread.append([patched]);\n    },\n\n    async forkThread(\n      sourceThreadId: string,\n      targetThreadId: string,\n      threadKey?: string\n    ): Promise<void> {\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId: sourceThreadId,\n        key: threadKey,\n      });\n      await thread.fork(targetThreadId);\n    },\n  };\n\n  function createActivities<S extends string = \"\">(\n    scope?: S\n  ): LangChainThreadOps<S> {\n    const prefix = scope\n      ? `${ADAPTER_PREFIX}${scope.charAt(0).toUpperCase()}${scope.slice(1)}`\n      : ADAPTER_PREFIX;\n    const cap = (s: string): string => s.charAt(0).toUpperCase() + s.slice(1);\n    return Object.fromEntries(\n      Object.entries(threadOps).map(([k, v]) => [`${prefix}${cap(k)}`, v])\n    ) as LangChainThreadOps<S>;\n  }\n\n  const makeInvoker = (\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    model: BaseChatModel<any>\n  ): ModelInvoker<StoredMessage> =>\n    createLangChainModelInvoker({ redis, model, hooks: config.hooks });\n\n  const invoker: ModelInvoker<StoredMessage> = config.model\n    ? makeInvoker(config.model)\n    : () => {\n        throw new Error(\n          \"No default model provided to createLangChainAdapter. \" +\n            \"Either pass `model` in the config or use `createModelInvoker(model)` instead.\"\n        );\n      };\n\n  return {\n    createActivities,\n    invoker,\n    createModelInvoker: makeInvoker,\n    wrapHandler: (handler) => handler,\n  };\n}\n","import type { BaseMessage, MessageContent } from \"@langchain/core/messages\";\n\ntype ContentBlock = MessageContent extends (infer U)[] | string ? U : never;\n\n/**\n * Creates an `onPreparedMessage` hook that appends a cache-point content\n * block to the last message in the thread, and strips excess cache-point\n * blocks from earlier messages so the total never exceeds `maxBlocks`.\n *\n * Older cache-point blocks are removed first, keeping the most recent\n * `maxBlocks - 1` positions plus the last message's block.\n */\nexport function appendCachePoint(\n  block: ContentBlock,\n  { maxBlocks = 4 }: { maxBlocks?: number } = {}\n): (\n  message: BaseMessage,\n  index: number,\n  messages: readonly BaseMessage[]\n) => BaseMessage {\n  return (message, index, messages) => {\n    const isLast = index === messages.length - 1;\n\n    if (isLast) {\n      const { content } = message;\n      if (Array.isArray(content)) {\n        if (content.some((b) => b.type === block.type)) return message;\n        message.content = [...content, block];\n      } else if (typeof content === \"string\") {\n        message.content = [\n          { type: \"text\", text: content },\n          block,\n        ] satisfies MessageContent;\n      }\n      return message;\n    }\n\n    const { content } = message;\n    if (\n      !Array.isArray(content) ||\n      !content.some((b) => b.type === block.type)\n    ) {\n      return message;\n    }\n\n    // Count cache blocks in messages after this one (excluding the last,\n    // which always gets one) plus 1 for the last message itself.\n    let cacheBlocksAfter = 1;\n    for (let i = index + 1; i < messages.length - 1; i++) {\n      const msg = messages[i];\n      if (!msg) continue;\n      const c = msg.content;\n      if (\n        Array.isArray(c) &&\n        c.some((b: ContentBlock) => b.type === block.type)\n      ) {\n        cacheBlocksAfter++;\n      }\n    }\n\n    if (cacheBlocksAfter >= maxBlocks) {\n      message.content = content.filter((b) => b.type !== block.type);\n    }\n\n    return message;\n  };\n}\n"]}
+{"version":3,"sources":["../../../../src/lib/thread/manager.ts","../../../../src/adapters/thread/langchain/thread-manager.ts","../../../../node_modules/uuid/dist/esm/stringify.js","../../../../node_modules/uuid/dist/esm/rng.js","../../../../node_modules/uuid/dist/esm/native.js","../../../../node_modules/uuid/dist/esm/v4.js","../../../../src/lib/activity.ts","../../../../src/adapters/thread/langchain/model-invoker.ts","../../../../src/adapters/thread/langchain/activities.ts","../../../../src/adapters/thread/langchain/hooks.ts"],"names":["HumanMessage","SystemMessage","AIMessage","ToolMessage","messages","mapStoredMessagesToChatMessages","randomFillSync","randomUUID","Context","invokeLangChainModel","content"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { ThreadManagerConfig, BaseThreadManager } from \"./types\";\n\nconst THREAD_TTL_SECONDS = 60 * 60 * 24 * 90; // 90 days\n\n/**\n * Lua script for atomic idempotent append.\n * Checks a dedup key; if it exists the message was already appended and we\n * return 0. Otherwise appends all messages to the list, sets TTL on both\n * the list and the dedup key, and returns 1.\n *\n * KEYS[1] = dedup key, KEYS[2] = list key\n * ARGV[1] = TTL seconds, ARGV[2..N] = serialised messages\n */\nconst APPEND_IDEMPOTENT_SCRIPT = `\nif redis.call('EXISTS', KEYS[1]) == 1 then\n  return 0\nend\nfor i = 2, #ARGV do\n  redis.call('RPUSH', KEYS[2], ARGV[i])\nend\nredis.call('EXPIRE', KEYS[2], tonumber(ARGV[1]))\nredis.call('SET', KEYS[1], '1', 'EX', tonumber(ARGV[1]))\nreturn 1\n`;\n\nfunction getThreadKey(threadId: string, key: string): string {\n  return `${key}:thread:${threadId}`;\n}\n\n/**\n * Creates a generic thread manager for handling conversation state in Redis.\n * Framework-agnostic — works with any serializable message type.\n */\nexport function createThreadManager<T>(\n  config: ThreadManagerConfig<T>\n): BaseThreadManager<T> {\n  const {\n    redis,\n    threadId,\n    key = \"messages\",\n    serialize = (m: T): string => JSON.stringify(m),\n    deserialize = (raw: string): T => JSON.parse(raw) as T,\n    idOf,\n  } = config;\n  const redisKey = getThreadKey(threadId, key);\n  const metaKey = getThreadKey(threadId, `${key}:meta`);\n\n  async function assertThreadExists(): Promise<void> {\n    const exists = await redis.exists(metaKey);\n    if (!exists) {\n      throw new Error(`Thread \"${threadId}\" (key: ${key}) does not exist`);\n    }\n  }\n\n  return {\n    async initialize(): Promise<void> {\n      await redis.del(redisKey);\n      await redis.set(metaKey, \"1\", \"EX\", THREAD_TTL_SECONDS);\n    },\n\n    async load(): Promise<T[]> {\n      await assertThreadExists();\n      const data = await redis.lrange(redisKey, 0, -1);\n      return data.map(deserialize);\n    },\n\n    async append(messages: T[]): Promise<void> {\n      if (messages.length === 0) return;\n      await assertThreadExists();\n\n      if (idOf) {\n        const dedupId = messages.map(idOf).join(\":\");\n        const dedupKey = getThreadKey(threadId, `dedup:${dedupId}`);\n        await redis.eval(\n          APPEND_IDEMPOTENT_SCRIPT,\n          2,\n          dedupKey,\n          redisKey,\n          String(THREAD_TTL_SECONDS),\n          ...messages.map(serialize)\n        );\n      } else {\n        await redis.rpush(redisKey, ...messages.map(serialize));\n        await redis.expire(redisKey, THREAD_TTL_SECONDS);\n      }\n    },\n\n    async fork(newThreadId: string): Promise<BaseThreadManager<T>> {\n      await assertThreadExists();\n      const data = await redis.lrange(redisKey, 0, -1);\n      const forked = createThreadManager({\n        ...config,\n        threadId: newThreadId,\n      });\n      await forked.initialize();\n      if (data.length > 0) {\n        const newKey = getThreadKey(newThreadId, key);\n        await redis.rpush(newKey, ...data);\n        await redis.expire(newKey, THREAD_TTL_SECONDS);\n      }\n      return forked;\n    },\n\n    async delete(): Promise<void> {\n      await redis.del(redisKey, metaKey);\n    },\n\n    async length(): Promise<number> {\n      await assertThreadExists();\n      return redis.llen(redisKey);\n    },\n\n    async truncate(length: number): Promise<void> {\n      await assertThreadExists();\n      if (length <= 0) {\n        await redis.del(redisKey);\n        await redis.expire(metaKey, THREAD_TTL_SECONDS);\n      } else {\n        await redis.ltrim(redisKey, 0, length - 1);\n        await redis.expire(redisKey, THREAD_TTL_SECONDS);\n      }\n      // Dedup keys for removed messages are left to expire via their TTL.\n      // Post-truncate appends use fresh ids so collisions do not occur in practice.\n    },\n  };\n}\n","import type Redis from \"ioredis\";\nimport type { JsonValue } from \"../../../lib/state/types\";\nimport {\n  AIMessage,\n  type BaseMessage,\n  HumanMessage,\n  type MessageContent,\n  type StoredMessage,\n  SystemMessage,\n  ToolMessage,\n  mapStoredMessagesToChatMessages,\n} from \"@langchain/core/messages\";\nimport { createThreadManager } from \"../../../lib/thread/manager\";\nimport type {\n  ProviderThreadManager,\n  ThreadManagerConfig,\n  ThreadManagerHooks,\n} from \"../../../lib/thread/types\";\n\n/** SDK-native content type for LangChain human messages */\nexport type LangChainContent = string | MessageContent;\n\n/** SDK-native content type for LangChain system messages */\nexport type LangChainSystemContent = string | MessageContent;\n\nexport type LangChainThreadManagerHooks = ThreadManagerHooks<\n  StoredMessage,\n  BaseMessage\n>;\n\nexport interface LangChainThreadManagerConfig {\n  redis: Redis;\n  threadId: string;\n  /** Thread key, defaults to 'messages' */\n  key?: string;\n  hooks?: LangChainThreadManagerHooks;\n}\n\n/** Prepared payload ready to send to a LangChain chat model */\nexport interface LangChainInvocationPayload {\n  messages: BaseMessage[];\n  /** Number of stored messages loaded from Redis before preparation. */\n  storedLength: number;\n}\n\n/** Thread manager with LangChain StoredMessage convenience helpers */\nexport interface LangChainThreadManager extends ProviderThreadManager<\n  StoredMessage,\n  LangChainContent,\n  JsonValue,\n  LangChainSystemContent\n> {\n  appendAIMessage(id: string, content: string | MessageContent): Promise<void>;\n  prepareForInvocation(): Promise<LangChainInvocationPayload>;\n}\n\nfunction storedMessageId(msg: StoredMessage): string {\n  if (msg.type === \"tool\" && msg.data.tool_call_id) {\n    return msg.data.tool_call_id;\n  }\n\n  if (msg.data.id) {\n    return msg.data.id;\n  }\n\n  throw new Error(\"No id found for message\");\n}\n\n/**\n * Creates a LangChain-specific thread manager that stores StoredMessage\n * instances in Redis and provides convenience helpers for creating and\n * appending typed LangChain messages.\n */\nexport function createLangChainThreadManager(\n  config: LangChainThreadManagerConfig\n): LangChainThreadManager {\n  const baseConfig: ThreadManagerConfig<StoredMessage> = {\n    redis: config.redis,\n    threadId: config.threadId,\n    key: config.key,\n    idOf: storedMessageId,\n  };\n\n  const base = createThreadManager(baseConfig);\n\n  const helpers: Omit<LangChainThreadManager, keyof typeof base> = {\n    async appendUserMessage(\n      id: string,\n      content: LangChainContent\n    ): Promise<void> {\n      await base.append([\n        new HumanMessage({ id, content: content as MessageContent }).toDict(),\n      ]);\n    },\n\n    async appendSystemMessage(\n      id: string,\n      content: LangChainSystemContent\n    ): Promise<void> {\n      await base.initialize();\n      await base.append([\n        new SystemMessage({\n          id,\n          content: content as MessageContent,\n        }).toDict(),\n      ]);\n    },\n\n    async appendAIMessage(\n      id: string,\n      content: string | MessageContent\n    ): Promise<void> {\n      await base.append([\n        new AIMessage({ id, content: content as MessageContent }).toDict(),\n      ]);\n    },\n\n    async appendToolResult(\n      id: string,\n      _toolCallId: string,\n      _toolName: string,\n      content: JsonValue\n    ): Promise<void> {\n      await base.append([\n        new ToolMessage({\n          id,\n          content: content as MessageContent,\n          tool_call_id: _toolCallId,\n        }).toDict(),\n      ]);\n    },\n\n    async prepareForInvocation(): Promise<LangChainInvocationPayload> {\n      const stored = await base.load();\n      const { onPrepareMessage, onPreparedMessage } = config.hooks ?? {};\n      const mapped = onPrepareMessage\n        ? stored.map((msg, i) => onPrepareMessage(msg, i, stored))\n        : stored;\n      const messages = mapStoredMessagesToChatMessages(mapped);\n      return {\n        messages: onPreparedMessage\n          ? messages.map((msg, i) => onPreparedMessage(msg, i, messages))\n          : messages,\n        storedLength: stored.length,\n      };\n    },\n  };\n\n  return Object.assign(base, helpers);\n}\n","import validate from './validate.js';\nconst byteToHex = [];\nfor (let i = 0; i < 256; ++i) {\n    byteToHex.push((i + 0x100).toString(16).slice(1));\n}\nexport function unsafeStringify(arr, offset = 0) {\n    return (byteToHex[arr[offset + 0]] +\n        byteToHex[arr[offset + 1]] +\n        byteToHex[arr[offset + 2]] +\n        byteToHex[arr[offset + 3]] +\n        '-' +\n        byteToHex[arr[offset + 4]] +\n        byteToHex[arr[offset + 5]] +\n        '-' +\n        byteToHex[arr[offset + 6]] +\n        byteToHex[arr[offset + 7]] +\n        '-' +\n        byteToHex[arr[offset + 8]] +\n        byteToHex[arr[offset + 9]] +\n        '-' +\n        byteToHex[arr[offset + 10]] +\n        byteToHex[arr[offset + 11]] +\n        byteToHex[arr[offset + 12]] +\n        byteToHex[arr[offset + 13]] +\n        byteToHex[arr[offset + 14]] +\n        byteToHex[arr[offset + 15]]).toLowerCase();\n}\nfunction stringify(arr, offset = 0) {\n    const uuid = unsafeStringify(arr, offset);\n    if (!validate(uuid)) {\n        throw TypeError('Stringified UUID is invalid');\n    }\n    return uuid;\n}\nexport default stringify;\n","import { randomFillSync } from 'crypto';\nconst rnds8Pool = new Uint8Array(256);\nlet poolPtr = rnds8Pool.length;\nexport default function rng() {\n    if (poolPtr > rnds8Pool.length - 16) {\n        randomFillSync(rnds8Pool);\n        poolPtr = 0;\n    }\n    return rnds8Pool.slice(poolPtr, (poolPtr += 16));\n}\n","import { randomUUID } from 'crypto';\nexport default { randomUUID };\n","import native from './native.js';\nimport rng from './rng.js';\nimport { unsafeStringify } from './stringify.js';\nfunction v4(options, buf, offset) {\n    if (native.randomUUID && !buf && !options) {\n        return native.randomUUID();\n    }\n    options = options || {};\n    const rnds = options.random ?? options.rng?.() ?? rng();\n    if (rnds.length < 16) {\n        throw new Error('Random bytes length must be >= 16');\n    }\n    rnds[6] = (rnds[6] & 0x0f) | 0x40;\n    rnds[8] = (rnds[8] & 0x3f) | 0x80;\n    if (buf) {\n        offset = offset || 0;\n        if (offset < 0 || offset + 16 > buf.length) {\n            throw new RangeError(`UUID byte range ${offset}:${offset + 15} is out of buffer bounds`);\n        }\n        for (let i = 0; i < 16; ++i) {\n            buf[offset + i] = rnds[i];\n        }\n        return buf;\n    }\n    return unsafeStringify(rnds);\n}\nexport default v4;\n","import { Context } from \"@temporalio/activity\";\nimport type { WorkflowClient } from \"@temporalio/client\";\nimport type { BaseAgentState, RunAgentConfig } from \"./types\";\nimport type { JsonValue } from \"./state/types\";\nimport type {\n  ActivityToolHandler,\n  RouterContext,\n  ToolHandlerResponse,\n} from \"./tool-router/types\";\n\n/**\n * Safely retrieve Temporal activity heartbeat and cancellation signal.\n * Returns empty object when called outside a Temporal activity (e.g. tests).\n */\nexport function getActivityContext(): {\n  heartbeat?: () => void;\n  signal?: AbortSignal;\n} {\n  try {\n    const ctx = Context.current();\n    return { heartbeat: () => ctx.heartbeat(), signal: ctx.cancellationSignal };\n  } catch {\n    return {};\n  }\n}\n\n/**\n * Query the parent workflow's state from within an activity.\n * Resolves the workflow handle from the current activity context.\n */\nexport async function queryParentWorkflowState<T>(\n  client: WorkflowClient\n): Promise<T> {\n  const { workflowExecution } = Context.current().info;\n  const handle = client.getHandle(\n    workflowExecution.workflowId,\n    workflowExecution.runId\n  );\n  return handle.query<T>(\"getAgentState\");\n}\n\n/**\n * Wraps a handler into a scope-prefixed `RunAgentActivity` by auto-fetching\n * the parent workflow's agent state before each invocation.\n *\n * Returns a `Record` with a single key `run<Scope>` so it can be spread\n * into the activities object alongside adapter activities.\n *\n * @param scope - Workflow scope used to derive the activity name.\n *   `\"myAgentWorkflow\"` produces `{ runMyAgentWorkflow: fn }`.\n *\n * @example\n * ```typescript\n * import { createRunAgentActivity } from 'zeitlich';\n *\n * return {\n *   ...adapter.createActivities(\"myAgentWorkflow\"),\n *   ...createRunAgentActivity(client, adapter.invoker, \"myAgentWorkflow\"),\n * };\n * ```\n */\nexport function createRunAgentActivity<\n  R,\n  S extends BaseAgentState = BaseAgentState,\n>(\n  client: WorkflowClient,\n  handler: (config: RunAgentConfig & { state: S }) => Promise<R>,\n  scope: string\n): Record<string, (config: RunAgentConfig) => Promise<R>> {\n  const name = `run${scope.charAt(0).toUpperCase()}${scope.slice(1)}`;\n  return {\n    [name]: async (config: RunAgentConfig) => {\n      const state = await queryParentWorkflowState<S>(client);\n      return handler({ ...config, state });\n    },\n  };\n}\n\n/**\n * Context injected into tool handlers created via {@link withParentWorkflowState}.\n */\nexport interface AgentStateContext<\n  S extends BaseAgentState = BaseAgentState,\n> extends RouterContext {\n  state: S;\n}\n\n/**\n * Wraps a tool handler into an `ActivityToolHandler` by auto-fetching the\n * parent workflow's agent state before each invocation.\n *\n * @typeParam S - Custom agent state type (defaults to `BaseAgentState`)\n *\n * @example\n * ```typescript\n * import { withParentWorkflowState, type AgentStateContext } from 'zeitlich';\n *\n * // With custom state:\n * interface MyState extends BaseAgentState { customField: string }\n * const myHandler = withParentWorkflowState<MyArgs, MyResult, MyState>(\n *   client,\n *   async (args, ctx) => {\n *     console.log(ctx.state.customField);\n *     return { toolResponse: 'done', data: null };\n *   },\n * );\n * ```\n */\nexport function withParentWorkflowState<\n  TArgs,\n  TResult,\n  S extends BaseAgentState = BaseAgentState,\n  TToolResponse = JsonValue,\n>(\n  client: WorkflowClient,\n  handler: (\n    args: TArgs,\n    context: AgentStateContext<S>\n  ) => Promise<ToolHandlerResponse<TResult, TToolResponse>>\n): ActivityToolHandler<TArgs, TResult, RouterContext, TToolResponse> {\n  return async (args, context) => {\n    const state = await queryParentWorkflowState<S>(client);\n    return handler(args, { ...context, state });\n  };\n}\n","import type Redis from \"ioredis\";\nimport type { AgentResponse, ModelInvokerConfig } from \"../../../lib/model\";\nimport type { StoredMessage } from \"@langchain/core/messages\";\nimport { v4 as uuidv4 } from \"uuid\";\nimport type { BaseChatModel } from \"@langchain/core/language_models/chat_models\";\nimport {\n  createLangChainThreadManager,\n  type LangChainThreadManagerHooks,\n} from \"./thread-manager\";\nimport { getActivityContext } from \"../../../lib/activity\";\n\n \nexport interface LangChainModelInvokerConfig<\n  TModel extends BaseChatModel<any> = BaseChatModel<any>,\n> {\n  redis: Redis;\n  model: TModel;\n  hooks?: LangChainThreadManagerHooks;\n}\n\n/**\n * Creates a LangChain-based model invoker that satisfies the generic\n * `ModelInvoker<StoredMessage>` contract.\n *\n * Uses interval-based Temporal heartbeats during model.invoke() to keep\n * long-running LLM calls visible to the scheduler. LangChain's streaming\n * chunk accumulation is unreliable across providers (e.g. reasoning_content\n * blocks don't merge correctly), so we use invoke() for correctness.\n * The caller is responsible for appending the response to the thread.\n *\n * @example\n * ```typescript\n * import { createLangChainModelInvoker } from 'zeitlich/adapters/thread/langchain';\n * import { createRunAgentActivity } from 'zeitlich';\n * import { ChatAnthropic } from '@langchain/anthropic';\n *\n * const model = new ChatAnthropic({ model: \"claude-sonnet-4-6\" });\n * const invoker = createLangChainModelInvoker({ redis, model });\n *\n * return { ...createRunAgentActivity(client, invoker, \"myAgent\") };\n * ```\n */\n \nexport function createLangChainModelInvoker<\n  TModel extends BaseChatModel<any> = BaseChatModel<any>,\n>({ redis, model, hooks }: LangChainModelInvokerConfig<TModel>) {\n  return async function invokeLangChainModel(\n    config: ModelInvokerConfig\n  ): Promise<AgentResponse<StoredMessage>> {\n    const { threadId, threadKey, agentName, state, metadata } = config;\n    const { heartbeat, signal } = getActivityContext();\n\n    const thread = createLangChainThreadManager({\n      redis,\n      threadId,\n      key: threadKey,\n      hooks,\n    });\n    const runId = uuidv4();\n\n    const { messages, storedLength } = await thread.prepareForInvocation();\n\n    const heartbeatInterval = heartbeat\n      ? setInterval(() => heartbeat(), 30_000)\n      : undefined;\n\n    try {\n      const response = await model.invoke(messages, {\n        runName: agentName,\n        runId,\n        metadata: { thread_id: `${agentName}-${threadId}`, ...metadata },\n        tools: state.tools,\n        signal,\n      });\n\n      const toolCalls = response.tool_calls ?? [];\n\n      const providerUsage =\n        (response.response_metadata?.usage as Record<string, unknown>) ?? {};\n\n      return {\n        message: response.toDict(),\n        rawToolCalls: toolCalls.map((tc) => ({\n          id: tc.id,\n          name: tc.name,\n          args: tc.args,\n        })),\n        usage: {\n          inputTokens: response.usage_metadata?.input_tokens,\n          outputTokens: response.usage_metadata?.output_tokens,\n          reasonTokens:\n            response.usage_metadata?.output_token_details?.reasoning,\n          cachedWriteTokens:\n            response.usage_metadata?.input_token_details?.cache_creation ||\n            (providerUsage.cacheWriteInputTokens as number | undefined),\n          cachedReadTokens:\n            response.usage_metadata?.input_token_details?.cache_read ||\n            (providerUsage.cacheReadInputTokens as number | undefined),\n        },\n        threadLengthAtCall: storedLength,\n      };\n    } finally {\n      if (heartbeatInterval) clearInterval(heartbeatInterval);\n    }\n  };\n}\n\n/**\n * Standalone function for one-shot LangChain model invocation.\n * Convenience wrapper around createLangChainModelInvoker for cases where\n * you don't need to reuse the invoker.\n */\n \nexport async function invokeLangChainModel<\n  TModel extends BaseChatModel<any> = BaseChatModel<any>,\n>({\n  redis,\n  model,\n  hooks,\n  config,\n}: {\n  redis: Redis;\n  config: ModelInvokerConfig;\n  model: TModel;\n  hooks?: LangChainThreadManagerHooks;\n}): Promise<AgentResponse<StoredMessage>> {\n  const invoker = createLangChainModelInvoker({ redis, model, hooks });\n  return invoker(config);\n}\n","import type Redis from \"ioredis\";\nimport type { ToolResultConfig } from \"../../../lib/types\";\nimport type { MessageContent } from \"@langchain/core/messages\";\nimport type {\n  ActivityToolHandler,\n  RouterContext,\n  ToolHandlerResponse,\n} from \"../../../lib/tool-router/types\";\nimport type {\n  ThreadOps,\n  PrefixedThreadOps,\n  ScopedPrefix,\n} from \"../../../lib/session/types\";\nimport type { ModelInvoker } from \"../../../lib/model\";\nimport type { StoredMessage } from \"@langchain/core/messages\";\nimport type { BaseChatModel } from \"@langchain/core/language_models/chat_models\";\nimport {\n  createLangChainThreadManager,\n  type LangChainContent,\n  type LangChainSystemContent,\n  type LangChainThreadManagerHooks,\n} from \"./thread-manager\";\nimport { createLangChainModelInvoker } from \"./model-invoker\";\n\nconst ADAPTER_PREFIX = \"langChain\" as const;\n\nexport type LangChainThreadOps<TScope extends string = \"\"> = PrefixedThreadOps<\n  ScopedPrefix<TScope, typeof ADAPTER_PREFIX>,\n  LangChainContent\n>;\n\nexport interface LangChainAdapterConfig {\n  redis: Redis;\n  /** Optional default model — if omitted, use `createModelInvoker()` to create invokers later */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  model?: BaseChatModel<any>;\n  hooks?: LangChainThreadManagerHooks;\n}\n\n/**\n * Tool response type accepted by the LangChain adapter.\n *\n * Content is passed directly to `ToolMessage` as `MessageContent`.\n * Handlers can return a string or an array of content blocks\n * (e.g. `{ type: \"text\", text: \"...\" }`, `{ type: \"image_url\", image_url: { ... } }`).\n */\nexport type LangChainToolResponse = MessageContent;\n\nexport interface LangChainAdapter {\n  /** Model invoker using the default model (only available when `model` was provided) */\n  invoker: ModelInvoker<StoredMessage>;\n  /** Create an invoker for a specific model (for multi-model setups) */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  createModelInvoker(model: BaseChatModel<any>): ModelInvoker<StoredMessage>;\n  /**\n   * Create prefixed thread activities for registration on the worker.\n   *\n   * @param scope - Workflow name appended to the adapter prefix.\n   *\n   * @example\n   * ```typescript\n   * adapter.createActivities(\"codingAgent\")\n   * // → { langChainCodingAgentInitializeThread, langChainCodingAgentAppendHumanMessage, … }\n   * ```\n   */\n  createActivities<S extends string = \"\">(scope?: S): LangChainThreadOps<S>;\n\n  /**\n   * Identity wrapper that types a tool handler for this adapter.\n   * Constrains `toolResponse` to {@link LangChainToolResponse}.\n   */\n  wrapHandler<TArgs, TResult, TContext extends RouterContext = RouterContext>(\n    handler: (\n      args: TArgs,\n      context: TContext\n    ) => Promise<ToolHandlerResponse<TResult, LangChainToolResponse>>\n  ): ActivityToolHandler<TArgs, TResult, TContext, LangChainToolResponse>;\n}\n\n/**\n * Creates a LangChain adapter that bundles thread operations and model\n * invocation using a consistent message format (StoredMessage).\n *\n * Use `createActivities(scope)` to register scoped thread operations as\n * Temporal activities on the worker. The `invoker` (or invokers created via\n * `createModelInvoker`) should be wrapped with `createRunAgentActivity`.\n *\n * @example\n * ```typescript\n * import { createLangChainAdapter } from 'zeitlich/adapters/thread/langchain';\n * import { createRunAgentActivity } from 'zeitlich';\n *\n * const adapter = createLangChainAdapter({ redis, model });\n *\n * export function createActivities(client: WorkflowClient) {\n *   return {\n *     ...adapter.createActivities(\"codingAgent\"),\n *     ...createRunAgentActivity(client, adapter.invoker, \"codingAgent\"),\n *   };\n * }\n * ```\n *\n * @example Multi-agent worker\n * ```typescript\n * export function createActivities(client: WorkflowClient) {\n *   return {\n *     ...adapter.createActivities(\"codingAgent\"),\n *     ...adapter.createActivities(\"researchAgent\"),\n *     ...createRunAgentActivity(client, adapter.invoker, \"codingAgent\"),\n *     ...createRunAgentActivity(client, adapter.createModelInvoker(claude), \"researchAgent\"),\n *   };\n * }\n * ```\n */\nexport function createLangChainAdapter(\n  config: LangChainAdapterConfig\n): LangChainAdapter {\n  const { redis } = config;\n\n  const threadOps: ThreadOps<LangChainContent> = {\n    async initializeThread(\n      threadId: string,\n      threadKey?: string\n    ): Promise<void> {\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId,\n        key: threadKey,\n      });\n      await thread.initialize();\n    },\n\n    async appendHumanMessage(\n      threadId: string,\n      id: string,\n      content: LangChainContent,\n      threadKey?: string\n    ): Promise<void> {\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId,\n        key: threadKey,\n      });\n      await thread.appendUserMessage(id, content);\n    },\n\n    async appendSystemMessage(\n      threadId: string,\n      id: string,\n      content: LangChainSystemContent,\n      threadKey?: string\n    ): Promise<void> {\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId,\n        key: threadKey,\n      });\n      await thread.appendSystemMessage(id, content);\n    },\n\n    async appendToolResult(id: string, cfg: ToolResultConfig): Promise<void> {\n      const { threadId, threadKey, toolCallId, content } = cfg;\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId,\n        key: threadKey,\n      });\n      await thread.appendToolResult(id, toolCallId, \"\", content);\n    },\n\n    async appendAgentMessage(\n      threadId: string,\n      id: string,\n      message: StoredMessage,\n      threadKey?: string\n    ): Promise<void> {\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId,\n        key: threadKey,\n      });\n      const patched = { ...message, data: { ...message.data, id } };\n      await thread.append([patched]);\n    },\n\n    async forkThread(\n      sourceThreadId: string,\n      targetThreadId: string,\n      threadKey?: string\n    ): Promise<void> {\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId: sourceThreadId,\n        key: threadKey,\n      });\n      await thread.fork(targetThreadId);\n    },\n\n    async truncateThread(\n      threadId: string,\n      length: number,\n      threadKey?: string,\n    ): Promise<void> {\n      const thread = createLangChainThreadManager({ redis, threadId, key: threadKey });\n      await thread.truncate(length);\n    },\n  };\n\n  function createActivities<S extends string = \"\">(\n    scope?: S\n  ): LangChainThreadOps<S> {\n    const prefix = scope\n      ? `${ADAPTER_PREFIX}${scope.charAt(0).toUpperCase()}${scope.slice(1)}`\n      : ADAPTER_PREFIX;\n    const cap = (s: string): string => s.charAt(0).toUpperCase() + s.slice(1);\n    return Object.fromEntries(\n      Object.entries(threadOps).map(([k, v]) => [`${prefix}${cap(k)}`, v])\n    ) as LangChainThreadOps<S>;\n  }\n\n  const makeInvoker = (\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    model: BaseChatModel<any>\n  ): ModelInvoker<StoredMessage> =>\n    createLangChainModelInvoker({ redis, model, hooks: config.hooks });\n\n  const invoker: ModelInvoker<StoredMessage> = config.model\n    ? makeInvoker(config.model)\n    : () => {\n        throw new Error(\n          \"No default model provided to createLangChainAdapter. \" +\n            \"Either pass `model` in the config or use `createModelInvoker(model)` instead.\"\n        );\n      };\n\n  return {\n    createActivities,\n    invoker,\n    createModelInvoker: makeInvoker,\n    wrapHandler: (handler) => handler,\n  };\n}\n","import type { BaseMessage, MessageContent } from \"@langchain/core/messages\";\n\ntype ContentBlock = MessageContent extends (infer U)[] | string ? U : never;\n\n/**\n * Creates an `onPreparedMessage` hook that appends a cache-point content\n * block to the last message in the thread, and strips excess cache-point\n * blocks from earlier messages so the total never exceeds `maxBlocks`.\n *\n * Older cache-point blocks are removed first, keeping the most recent\n * `maxBlocks - 1` positions plus the last message's block.\n */\nexport function appendCachePoint(\n  block: ContentBlock,\n  { maxBlocks = 4 }: { maxBlocks?: number } = {}\n): (\n  message: BaseMessage,\n  index: number,\n  messages: readonly BaseMessage[]\n) => BaseMessage {\n  return (message, index, messages) => {\n    const isLast = index === messages.length - 1;\n\n    if (isLast) {\n      const { content } = message;\n      if (Array.isArray(content)) {\n        if (content.some((b) => b.type === block.type)) return message;\n        message.content = [...content, block];\n      } else if (typeof content === \"string\") {\n        message.content = [\n          { type: \"text\", text: content },\n          block,\n        ] satisfies MessageContent;\n      }\n      return message;\n    }\n\n    const { content } = message;\n    if (\n      !Array.isArray(content) ||\n      !content.some((b) => b.type === block.type)\n    ) {\n      return message;\n    }\n\n    // Count cache blocks in messages after this one (excluding the last,\n    // which always gets one) plus 1 for the last message itself.\n    let cacheBlocksAfter = 1;\n    for (let i = index + 1; i < messages.length - 1; i++) {\n      const msg = messages[i];\n      if (!msg) continue;\n      const c = msg.content;\n      if (\n        Array.isArray(c) &&\n        c.some((b: ContentBlock) => b.type === block.type)\n      ) {\n        cacheBlocksAfter++;\n      }\n    }\n\n    if (cacheBlocksAfter >= maxBlocks) {\n      message.content = content.filter((b) => b.type !== block.type);\n    }\n\n    return message;\n  };\n}\n"]}

package/dist/adapters/thread/langchain/index.d.cts

@@ -1,15 +1,15 @@
 import Redis from 'ioredis';
 import { StoredMessage, MessageContent, BaseMessage } from '@langchain/core/messages';
-import { a as ModelInvoker, P as PrefixedThreadOps, S as ScopedPrefix, R as RouterContext, b as ToolHandlerResponse, c as ActivityToolHandler, M as ModelInvokerConfig, A as AgentResponse } from '../../../types-BO7Yju20.cjs';
+import { a as ModelInvoker, P as PrefixedThreadOps, S as ScopedPrefix, R as RouterContext, b as ToolHandlerResponse, c as ActivityToolHandler, M as ModelInvokerConfig, A as AgentResponse } from '../../../types-C06FwR96.cjs';
 import { BaseChatModel } from '@langchain/core/language_models/chat_models';
-import { L as LangChainContent, a as LangChainThreadManagerHooks } from '../../../thread-manager-CzYln2OC.cjs';
-export { b as LangChainInvocationPayload, c as LangChainThreadManager, d as LangChainThreadManagerConfig, e as createLangChainThreadManager } from '../../../thread-manager-CzYln2OC.cjs';
+import { L as LangChainContent, a as LangChainThreadManagerHooks } from '../../../thread-manager-wGi-LqIP.cjs';
+export { b as LangChainInvocationPayload, c as LangChainThreadManager, d as LangChainThreadManagerConfig, e as createLangChainThreadManager } from '../../../thread-manager-wGi-LqIP.cjs';
 import '@temporalio/common';
 import '@temporalio/workflow';
 import '@temporalio/common/lib/interfaces';
 import 'zod';
-import '../../../types-tQL9njTu.cjs';
-import '../../../types-D08CXPh8.cjs';
+import '../../../types-yx0LzPGn.cjs';
+import '../../../types-BaOw4hKI.cjs';
 
 declare const ADAPTER_PREFIX: "langChain";
 type LangChainThreadOps<TScope extends string = ""> = PrefixedThreadOps<ScopedPrefix<TScope, typeof ADAPTER_PREFIX>, LangChainContent>;

package/dist/adapters/thread/langchain/index.d.ts

@@ -1,15 +1,15 @@
 import Redis from 'ioredis';
 import { StoredMessage, MessageContent, BaseMessage } from '@langchain/core/messages';
-import { a as ModelInvoker, P as PrefixedThreadOps, S as ScopedPrefix, R as RouterContext, b as ToolHandlerResponse, c as ActivityToolHandler, M as ModelInvokerConfig, A as AgentResponse } from '../../../types-CPKDl-y_.js';
+import { a as ModelInvoker, P as PrefixedThreadOps, S as ScopedPrefix, R as RouterContext, b as ToolHandlerResponse, c as ActivityToolHandler, M as ModelInvokerConfig, A as AgentResponse } from '../../../types-DNr31FzL.js';
 import { BaseChatModel } from '@langchain/core/language_models/chat_models';
-import { L as LangChainContent, a as LangChainThreadManagerHooks } from '../../../thread-manager-3fszQih4.js';
-export { b as LangChainInvocationPayload, c as LangChainThreadManager, d as LangChainThreadManagerConfig, e as createLangChainThreadManager } from '../../../thread-manager-3fszQih4.js';
+import { L as LangChainContent, a as LangChainThreadManagerHooks } from '../../../thread-manager-c1gPopAG.js';
+export { b as LangChainInvocationPayload, c as LangChainThreadManager, d as LangChainThreadManagerConfig, e as createLangChainThreadManager } from '../../../thread-manager-c1gPopAG.js';
 import '@temporalio/common';
 import '@temporalio/workflow';
 import '@temporalio/common/lib/interfaces';
 import 'zod';
-import '../../../types-tQL9njTu.js';
-import '../../../types-B37hKoWA.js';
+import '../../../types-yx0LzPGn.js';
+import '../../../types-BH_IRryz.js';
 
 declare const ADAPTER_PREFIX: "langChain";
 type LangChainThreadOps<TScope extends string = ""> = PrefixedThreadOps<ScopedPrefix<TScope, typeof ADAPTER_PREFIX>, LangChainContent>;

package/dist/adapters/thread/langchain/index.js

@@ -83,6 +83,20 @@ function createThreadManager(config) {
     },
     async delete() {
       await redis.del(redisKey, metaKey);
+    },
+    async length() {
+      await assertThreadExists();
+      return redis.llen(redisKey);
+    },
+    async truncate(length) {
+      await assertThreadExists();
+      if (length <= 0) {
+        await redis.del(redisKey);
+        await redis.expire(metaKey, THREAD_TTL_SECONDS);
+      } else {
+        await redis.ltrim(redisKey, 0, length - 1);
+        await redis.expire(redisKey, THREAD_TTL_SECONDS);
+      }
     }
   };
 }
@@ -140,7 +154,8 @@ function createLangChainThreadManager(config) {
       const mapped = onPrepareMessage ? stored.map((msg, i) => onPrepareMessage(msg, i, stored)) : stored;
       const messages = mapStoredMessagesToChatMessages(mapped);
       return {
-        messages: onPreparedMessage ? messages.map((msg, i) => onPreparedMessage(msg, i, messages)) : messages
+        messages: onPreparedMessage ? messages.map((msg, i) => onPreparedMessage(msg, i, messages)) : messages,
+        storedLength: stored.length
       };
     }
   };
@@ -212,7 +227,7 @@ function createLangChainModelInvoker({ redis, model, hooks }) {
       hooks
     });
     const runId = v4_default();
-    const { messages } = await thread.prepareForInvocation();
+    const { messages, storedLength } = await thread.prepareForInvocation();
     const heartbeatInterval = heartbeat ? setInterval(() => heartbeat(), 3e4) : void 0;
     try {
       const response = await model.invoke(messages, {
@@ -237,7 +252,8 @@ function createLangChainModelInvoker({ redis, model, hooks }) {
           reasonTokens: response.usage_metadata?.output_token_details?.reasoning,
           cachedWriteTokens: response.usage_metadata?.input_token_details?.cache_creation || providerUsage.cacheWriteInputTokens,
           cachedReadTokens: response.usage_metadata?.input_token_details?.cache_read || providerUsage.cacheReadInputTokens
-        }
+        },
+        threadLengthAtCall: storedLength
       };
     } finally {
       if (heartbeatInterval) clearInterval(heartbeatInterval);
@@ -308,6 +324,10 @@ function createLangChainAdapter(config) {
         key: threadKey
       });
       await thread.fork(targetThreadId);
+    },
+    async truncateThread(threadId, length, threadKey) {
+      const thread = createLangChainThreadManager({ redis, threadId, key: threadKey });
+      await thread.truncate(length);
     }
   };
   function createActivities(scope) {

package/dist/adapters/thread/langchain/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/thread/manager.ts","../../../../src/adapters/thread/langchain/thread-manager.ts","../../../../node_modules/uuid/dist/esm/stringify.js","../../../../node_modules/uuid/dist/esm/rng.js","../../../../node_modules/uuid/dist/esm/native.js","../../../../node_modules/uuid/dist/esm/v4.js","../../../../src/lib/activity.ts","../../../../src/adapters/thread/langchain/model-invoker.ts","../../../../src/adapters/thread/langchain/activities.ts","../../../../src/adapters/thread/langchain/hooks.ts"],"names":["invokeLangChainModel","content"],"mappings":"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","file":"index.js","sourcesContent":["import type { ThreadManagerConfig, BaseThreadManager } from \"./types\";\n\nconst THREAD_TTL_SECONDS = 60 * 60 * 24 * 90; // 90 days\n\n/**\n * Lua script for atomic idempotent append.\n * Checks a dedup key; if it exists the message was already appended and we\n * return 0. Otherwise appends all messages to the list, sets TTL on both\n * the list and the dedup key, and returns 1.\n *\n * KEYS[1] = dedup key, KEYS[2] = list key\n * ARGV[1] = TTL seconds, ARGV[2..N] = serialised messages\n */\nconst APPEND_IDEMPOTENT_SCRIPT = `\nif redis.call('EXISTS', KEYS[1]) == 1 then\n  return 0\nend\nfor i = 2, #ARGV do\n  redis.call('RPUSH', KEYS[2], ARGV[i])\nend\nredis.call('EXPIRE', KEYS[2], tonumber(ARGV[1]))\nredis.call('SET', KEYS[1], '1', 'EX', tonumber(ARGV[1]))\nreturn 1\n`;\n\nfunction getThreadKey(threadId: string, key: string): string {\n  return `${key}:thread:${threadId}`;\n}\n\n/**\n * Creates a generic thread manager for handling conversation state in Redis.\n * Framework-agnostic — works with any serializable message type.\n */\nexport function createThreadManager<T>(\n  config: ThreadManagerConfig<T>\n): BaseThreadManager<T> {\n  const {\n    redis,\n    threadId,\n    key = \"messages\",\n    serialize = (m: T): string => JSON.stringify(m),\n    deserialize = (raw: string): T => JSON.parse(raw) as T,\n    idOf,\n  } = config;\n  const redisKey = getThreadKey(threadId, key);\n  const metaKey = getThreadKey(threadId, `${key}:meta`);\n\n  async function assertThreadExists(): Promise<void> {\n    const exists = await redis.exists(metaKey);\n    if (!exists) {\n      throw new Error(`Thread \"${threadId}\" (key: ${key}) does not exist`);\n    }\n  }\n\n  return {\n    async initialize(): Promise<void> {\n      await redis.del(redisKey);\n      await redis.set(metaKey, \"1\", \"EX\", THREAD_TTL_SECONDS);\n    },\n\n    async load(): Promise<T[]> {\n      await assertThreadExists();\n      const data = await redis.lrange(redisKey, 0, -1);\n      return data.map(deserialize);\n    },\n\n    async append(messages: T[]): Promise<void> {\n      if (messages.length === 0) return;\n      await assertThreadExists();\n\n      if (idOf) {\n        const dedupId = messages.map(idOf).join(\":\");\n        const dedupKey = getThreadKey(threadId, `dedup:${dedupId}`);\n        await redis.eval(\n          APPEND_IDEMPOTENT_SCRIPT,\n          2,\n          dedupKey,\n          redisKey,\n          String(THREAD_TTL_SECONDS),\n          ...messages.map(serialize)\n        );\n      } else {\n        await redis.rpush(redisKey, ...messages.map(serialize));\n        await redis.expire(redisKey, THREAD_TTL_SECONDS);\n      }\n    },\n\n    async fork(newThreadId: string): Promise<BaseThreadManager<T>> {\n      await assertThreadExists();\n      const data = await redis.lrange(redisKey, 0, -1);\n      const forked = createThreadManager({\n        ...config,\n        threadId: newThreadId,\n      });\n      await forked.initialize();\n      if (data.length > 0) {\n        const newKey = getThreadKey(newThreadId, key);\n        await redis.rpush(newKey, ...data);\n        await redis.expire(newKey, THREAD_TTL_SECONDS);\n      }\n      return forked;\n    },\n\n    async delete(): Promise<void> {\n      await redis.del(redisKey, metaKey);\n    },\n  };\n}\n","import type Redis from \"ioredis\";\nimport type { JsonValue } from \"../../../lib/state/types\";\nimport {\n  AIMessage,\n  type BaseMessage,\n  HumanMessage,\n  type MessageContent,\n  type StoredMessage,\n  SystemMessage,\n  ToolMessage,\n  mapStoredMessagesToChatMessages,\n} from \"@langchain/core/messages\";\nimport { createThreadManager } from \"../../../lib/thread/manager\";\nimport type {\n  ProviderThreadManager,\n  ThreadManagerConfig,\n  ThreadManagerHooks,\n} from \"../../../lib/thread/types\";\n\n/** SDK-native content type for LangChain human messages */\nexport type LangChainContent = string | MessageContent;\n\n/** SDK-native content type for LangChain system messages */\nexport type LangChainSystemContent = string | MessageContent;\n\nexport type LangChainThreadManagerHooks = ThreadManagerHooks<\n  StoredMessage,\n  BaseMessage\n>;\n\nexport interface LangChainThreadManagerConfig {\n  redis: Redis;\n  threadId: string;\n  /** Thread key, defaults to 'messages' */\n  key?: string;\n  hooks?: LangChainThreadManagerHooks;\n}\n\n/** Prepared payload ready to send to a LangChain chat model */\nexport interface LangChainInvocationPayload {\n  messages: BaseMessage[];\n}\n\n/** Thread manager with LangChain StoredMessage convenience helpers */\nexport interface LangChainThreadManager extends ProviderThreadManager<\n  StoredMessage,\n  LangChainContent,\n  JsonValue,\n  LangChainSystemContent\n> {\n  appendAIMessage(id: string, content: string | MessageContent): Promise<void>;\n  prepareForInvocation(): Promise<LangChainInvocationPayload>;\n}\n\nfunction storedMessageId(msg: StoredMessage): string {\n  if (msg.type === \"tool\" && msg.data.tool_call_id) {\n    return msg.data.tool_call_id;\n  }\n\n  if (msg.data.id) {\n    return msg.data.id;\n  }\n\n  throw new Error(\"No id found for message\");\n}\n\n/**\n * Creates a LangChain-specific thread manager that stores StoredMessage\n * instances in Redis and provides convenience helpers for creating and\n * appending typed LangChain messages.\n */\nexport function createLangChainThreadManager(\n  config: LangChainThreadManagerConfig\n): LangChainThreadManager {\n  const baseConfig: ThreadManagerConfig<StoredMessage> = {\n    redis: config.redis,\n    threadId: config.threadId,\n    key: config.key,\n    idOf: storedMessageId,\n  };\n\n  const base = createThreadManager(baseConfig);\n\n  const helpers: Omit<LangChainThreadManager, keyof typeof base> = {\n    async appendUserMessage(\n      id: string,\n      content: LangChainContent\n    ): Promise<void> {\n      await base.append([\n        new HumanMessage({ id, content: content as MessageContent }).toDict(),\n      ]);\n    },\n\n    async appendSystemMessage(\n      id: string,\n      content: LangChainSystemContent\n    ): Promise<void> {\n      await base.initialize();\n      await base.append([\n        new SystemMessage({\n          id,\n          content: content as MessageContent,\n        }).toDict(),\n      ]);\n    },\n\n    async appendAIMessage(\n      id: string,\n      content: string | MessageContent\n    ): Promise<void> {\n      await base.append([\n        new AIMessage({ id, content: content as MessageContent }).toDict(),\n      ]);\n    },\n\n    async appendToolResult(\n      id: string,\n      _toolCallId: string,\n      _toolName: string,\n      content: JsonValue\n    ): Promise<void> {\n      await base.append([\n        new ToolMessage({\n          id,\n          content: content as MessageContent,\n          tool_call_id: _toolCallId,\n        }).toDict(),\n      ]);\n    },\n\n    async prepareForInvocation(): Promise<LangChainInvocationPayload> {\n      const stored = await base.load();\n      const { onPrepareMessage, onPreparedMessage } = config.hooks ?? {};\n      const mapped = onPrepareMessage\n        ? stored.map((msg, i) => onPrepareMessage(msg, i, stored))\n        : stored;\n      const messages = mapStoredMessagesToChatMessages(mapped);\n      return {\n        messages: onPreparedMessage\n          ? messages.map((msg, i) => onPreparedMessage(msg, i, messages))\n          : messages,\n      };\n    },\n  };\n\n  return Object.assign(base, helpers);\n}\n","import validate from './validate.js';\nconst byteToHex = [];\nfor (let i = 0; i < 256; ++i) {\n    byteToHex.push((i + 0x100).toString(16).slice(1));\n}\nexport function unsafeStringify(arr, offset = 0) {\n    return (byteToHex[arr[offset + 0]] +\n        byteToHex[arr[offset + 1]] +\n        byteToHex[arr[offset + 2]] +\n        byteToHex[arr[offset + 3]] +\n        '-' +\n        byteToHex[arr[offset + 4]] +\n        byteToHex[arr[offset + 5]] +\n        '-' +\n        byteToHex[arr[offset + 6]] +\n        byteToHex[arr[offset + 7]] +\n        '-' +\n        byteToHex[arr[offset + 8]] +\n        byteToHex[arr[offset + 9]] +\n        '-' +\n        byteToHex[arr[offset + 10]] +\n        byteToHex[arr[offset + 11]] +\n        byteToHex[arr[offset + 12]] +\n        byteToHex[arr[offset + 13]] +\n        byteToHex[arr[offset + 14]] +\n        byteToHex[arr[offset + 15]]).toLowerCase();\n}\nfunction stringify(arr, offset = 0) {\n    const uuid = unsafeStringify(arr, offset);\n    if (!validate(uuid)) {\n        throw TypeError('Stringified UUID is invalid');\n    }\n    return uuid;\n}\nexport default stringify;\n","import { randomFillSync } from 'crypto';\nconst rnds8Pool = new Uint8Array(256);\nlet poolPtr = rnds8Pool.length;\nexport default function rng() {\n    if (poolPtr > rnds8Pool.length - 16) {\n        randomFillSync(rnds8Pool);\n        poolPtr = 0;\n    }\n    return rnds8Pool.slice(poolPtr, (poolPtr += 16));\n}\n","import { randomUUID } from 'crypto';\nexport default { randomUUID };\n","import native from './native.js';\nimport rng from './rng.js';\nimport { unsafeStringify } from './stringify.js';\nfunction v4(options, buf, offset) {\n    if (native.randomUUID && !buf && !options) {\n        return native.randomUUID();\n    }\n    options = options || {};\n    const rnds = options.random ?? options.rng?.() ?? rng();\n    if (rnds.length < 16) {\n        throw new Error('Random bytes length must be >= 16');\n    }\n    rnds[6] = (rnds[6] & 0x0f) | 0x40;\n    rnds[8] = (rnds[8] & 0x3f) | 0x80;\n    if (buf) {\n        offset = offset || 0;\n        if (offset < 0 || offset + 16 > buf.length) {\n            throw new RangeError(`UUID byte range ${offset}:${offset + 15} is out of buffer bounds`);\n        }\n        for (let i = 0; i < 16; ++i) {\n            buf[offset + i] = rnds[i];\n        }\n        return buf;\n    }\n    return unsafeStringify(rnds);\n}\nexport default v4;\n","import { Context } from \"@temporalio/activity\";\nimport type { WorkflowClient } from \"@temporalio/client\";\nimport type { BaseAgentState, RunAgentConfig } from \"./types\";\nimport type { JsonValue } from \"./state/types\";\nimport type {\n  ActivityToolHandler,\n  RouterContext,\n  ToolHandlerResponse,\n} from \"./tool-router/types\";\n\n/**\n * Safely retrieve Temporal activity heartbeat and cancellation signal.\n * Returns empty object when called outside a Temporal activity (e.g. tests).\n */\nexport function getActivityContext(): {\n  heartbeat?: () => void;\n  signal?: AbortSignal;\n} {\n  try {\n    const ctx = Context.current();\n    return { heartbeat: () => ctx.heartbeat(), signal: ctx.cancellationSignal };\n  } catch {\n    return {};\n  }\n}\n\n/**\n * Query the parent workflow's state from within an activity.\n * Resolves the workflow handle from the current activity context.\n */\nexport async function queryParentWorkflowState<T>(\n  client: WorkflowClient\n): Promise<T> {\n  const { workflowExecution } = Context.current().info;\n  const handle = client.getHandle(\n    workflowExecution.workflowId,\n    workflowExecution.runId\n  );\n  return handle.query<T>(\"getAgentState\");\n}\n\n/**\n * Wraps a handler into a scope-prefixed `RunAgentActivity` by auto-fetching\n * the parent workflow's agent state before each invocation.\n *\n * Returns a `Record` with a single key `run<Scope>` so it can be spread\n * into the activities object alongside adapter activities.\n *\n * @param scope - Workflow scope used to derive the activity name.\n *   `\"myAgentWorkflow\"` produces `{ runMyAgentWorkflow: fn }`.\n *\n * @example\n * ```typescript\n * import { createRunAgentActivity } from 'zeitlich';\n *\n * return {\n *   ...adapter.createActivities(\"myAgentWorkflow\"),\n *   ...createRunAgentActivity(client, adapter.invoker, \"myAgentWorkflow\"),\n * };\n * ```\n */\nexport function createRunAgentActivity<\n  R,\n  S extends BaseAgentState = BaseAgentState,\n>(\n  client: WorkflowClient,\n  handler: (config: RunAgentConfig & { state: S }) => Promise<R>,\n  scope: string\n): Record<string, (config: RunAgentConfig) => Promise<R>> {\n  const name = `run${scope.charAt(0).toUpperCase()}${scope.slice(1)}`;\n  return {\n    [name]: async (config: RunAgentConfig) => {\n      const state = await queryParentWorkflowState<S>(client);\n      return handler({ ...config, state });\n    },\n  };\n}\n\n/**\n * Context injected into tool handlers created via {@link withParentWorkflowState}.\n */\nexport interface AgentStateContext<\n  S extends BaseAgentState = BaseAgentState,\n> extends RouterContext {\n  state: S;\n}\n\n/**\n * Wraps a tool handler into an `ActivityToolHandler` by auto-fetching the\n * parent workflow's agent state before each invocation.\n *\n * @typeParam S - Custom agent state type (defaults to `BaseAgentState`)\n *\n * @example\n * ```typescript\n * import { withParentWorkflowState, type AgentStateContext } from 'zeitlich';\n *\n * // With custom state:\n * interface MyState extends BaseAgentState { customField: string }\n * const myHandler = withParentWorkflowState<MyArgs, MyResult, MyState>(\n *   client,\n *   async (args, ctx) => {\n *     console.log(ctx.state.customField);\n *     return { toolResponse: 'done', data: null };\n *   },\n * );\n * ```\n */\nexport function withParentWorkflowState<\n  TArgs,\n  TResult,\n  S extends BaseAgentState = BaseAgentState,\n  TToolResponse = JsonValue,\n>(\n  client: WorkflowClient,\n  handler: (\n    args: TArgs,\n    context: AgentStateContext<S>\n  ) => Promise<ToolHandlerResponse<TResult, TToolResponse>>\n): ActivityToolHandler<TArgs, TResult, RouterContext, TToolResponse> {\n  return async (args, context) => {\n    const state = await queryParentWorkflowState<S>(client);\n    return handler(args, { ...context, state });\n  };\n}\n","import type Redis from \"ioredis\";\nimport type { AgentResponse, ModelInvokerConfig } from \"../../../lib/model\";\nimport type { StoredMessage } from \"@langchain/core/messages\";\nimport { v4 as uuidv4 } from \"uuid\";\nimport type { BaseChatModel } from \"@langchain/core/language_models/chat_models\";\nimport {\n  createLangChainThreadManager,\n  type LangChainThreadManagerHooks,\n} from \"./thread-manager\";\nimport { getActivityContext } from \"../../../lib/activity\";\n\n \nexport interface LangChainModelInvokerConfig<\n  TModel extends BaseChatModel<any> = BaseChatModel<any>,\n> {\n  redis: Redis;\n  model: TModel;\n  hooks?: LangChainThreadManagerHooks;\n}\n\n/**\n * Creates a LangChain-based model invoker that satisfies the generic\n * `ModelInvoker<StoredMessage>` contract.\n *\n * Uses interval-based Temporal heartbeats during model.invoke() to keep\n * long-running LLM calls visible to the scheduler. LangChain's streaming\n * chunk accumulation is unreliable across providers (e.g. reasoning_content\n * blocks don't merge correctly), so we use invoke() for correctness.\n * The caller is responsible for appending the response to the thread.\n *\n * @example\n * ```typescript\n * import { createLangChainModelInvoker } from 'zeitlich/adapters/thread/langchain';\n * import { createRunAgentActivity } from 'zeitlich';\n * import { ChatAnthropic } from '@langchain/anthropic';\n *\n * const model = new ChatAnthropic({ model: \"claude-sonnet-4-6\" });\n * const invoker = createLangChainModelInvoker({ redis, model });\n *\n * return { ...createRunAgentActivity(client, invoker, \"myAgent\") };\n * ```\n */\n \nexport function createLangChainModelInvoker<\n  TModel extends BaseChatModel<any> = BaseChatModel<any>,\n>({ redis, model, hooks }: LangChainModelInvokerConfig<TModel>) {\n  return async function invokeLangChainModel(\n    config: ModelInvokerConfig\n  ): Promise<AgentResponse<StoredMessage>> {\n    const { threadId, threadKey, agentName, state, metadata } = config;\n    const { heartbeat, signal } = getActivityContext();\n\n    const thread = createLangChainThreadManager({\n      redis,\n      threadId,\n      key: threadKey,\n      hooks,\n    });\n    const runId = uuidv4();\n\n    const { messages } = await thread.prepareForInvocation();\n\n    const heartbeatInterval = heartbeat\n      ? setInterval(() => heartbeat(), 30_000)\n      : undefined;\n\n    try {\n      const response = await model.invoke(messages, {\n        runName: agentName,\n        runId,\n        metadata: { thread_id: `${agentName}-${threadId}`, ...metadata },\n        tools: state.tools,\n        signal,\n      });\n\n      const toolCalls = response.tool_calls ?? [];\n\n      const providerUsage =\n        (response.response_metadata?.usage as Record<string, unknown>) ?? {};\n\n      return {\n        message: response.toDict(),\n        rawToolCalls: toolCalls.map((tc) => ({\n          id: tc.id,\n          name: tc.name,\n          args: tc.args,\n        })),\n        usage: {\n          inputTokens: response.usage_metadata?.input_tokens,\n          outputTokens: response.usage_metadata?.output_tokens,\n          reasonTokens:\n            response.usage_metadata?.output_token_details?.reasoning,\n          cachedWriteTokens:\n            response.usage_metadata?.input_token_details?.cache_creation ||\n            (providerUsage.cacheWriteInputTokens as number | undefined),\n          cachedReadTokens:\n            response.usage_metadata?.input_token_details?.cache_read ||\n            (providerUsage.cacheReadInputTokens as number | undefined),\n        },\n      };\n    } finally {\n      if (heartbeatInterval) clearInterval(heartbeatInterval);\n    }\n  };\n}\n\n/**\n * Standalone function for one-shot LangChain model invocation.\n * Convenience wrapper around createLangChainModelInvoker for cases where\n * you don't need to reuse the invoker.\n */\n \nexport async function invokeLangChainModel<\n  TModel extends BaseChatModel<any> = BaseChatModel<any>,\n>({\n  redis,\n  model,\n  hooks,\n  config,\n}: {\n  redis: Redis;\n  config: ModelInvokerConfig;\n  model: TModel;\n  hooks?: LangChainThreadManagerHooks;\n}): Promise<AgentResponse<StoredMessage>> {\n  const invoker = createLangChainModelInvoker({ redis, model, hooks });\n  return invoker(config);\n}\n","import type Redis from \"ioredis\";\nimport type { ToolResultConfig } from \"../../../lib/types\";\nimport type { MessageContent } from \"@langchain/core/messages\";\nimport type {\n  ActivityToolHandler,\n  RouterContext,\n  ToolHandlerResponse,\n} from \"../../../lib/tool-router/types\";\nimport type {\n  ThreadOps,\n  PrefixedThreadOps,\n  ScopedPrefix,\n} from \"../../../lib/session/types\";\nimport type { ModelInvoker } from \"../../../lib/model\";\nimport type { StoredMessage } from \"@langchain/core/messages\";\nimport type { BaseChatModel } from \"@langchain/core/language_models/chat_models\";\nimport {\n  createLangChainThreadManager,\n  type LangChainContent,\n  type LangChainSystemContent,\n  type LangChainThreadManagerHooks,\n} from \"./thread-manager\";\nimport { createLangChainModelInvoker } from \"./model-invoker\";\n\nconst ADAPTER_PREFIX = \"langChain\" as const;\n\nexport type LangChainThreadOps<TScope extends string = \"\"> = PrefixedThreadOps<\n  ScopedPrefix<TScope, typeof ADAPTER_PREFIX>,\n  LangChainContent\n>;\n\nexport interface LangChainAdapterConfig {\n  redis: Redis;\n  /** Optional default model — if omitted, use `createModelInvoker()` to create invokers later */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  model?: BaseChatModel<any>;\n  hooks?: LangChainThreadManagerHooks;\n}\n\n/**\n * Tool response type accepted by the LangChain adapter.\n *\n * Content is passed directly to `ToolMessage` as `MessageContent`.\n * Handlers can return a string or an array of content blocks\n * (e.g. `{ type: \"text\", text: \"...\" }`, `{ type: \"image_url\", image_url: { ... } }`).\n */\nexport type LangChainToolResponse = MessageContent;\n\nexport interface LangChainAdapter {\n  /** Model invoker using the default model (only available when `model` was provided) */\n  invoker: ModelInvoker<StoredMessage>;\n  /** Create an invoker for a specific model (for multi-model setups) */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  createModelInvoker(model: BaseChatModel<any>): ModelInvoker<StoredMessage>;\n  /**\n   * Create prefixed thread activities for registration on the worker.\n   *\n   * @param scope - Workflow name appended to the adapter prefix.\n   *\n   * @example\n   * ```typescript\n   * adapter.createActivities(\"codingAgent\")\n   * // → { langChainCodingAgentInitializeThread, langChainCodingAgentAppendHumanMessage, … }\n   * ```\n   */\n  createActivities<S extends string = \"\">(scope?: S): LangChainThreadOps<S>;\n\n  /**\n   * Identity wrapper that types a tool handler for this adapter.\n   * Constrains `toolResponse` to {@link LangChainToolResponse}.\n   */\n  wrapHandler<TArgs, TResult, TContext extends RouterContext = RouterContext>(\n    handler: (\n      args: TArgs,\n      context: TContext\n    ) => Promise<ToolHandlerResponse<TResult, LangChainToolResponse>>\n  ): ActivityToolHandler<TArgs, TResult, TContext, LangChainToolResponse>;\n}\n\n/**\n * Creates a LangChain adapter that bundles thread operations and model\n * invocation using a consistent message format (StoredMessage).\n *\n * Use `createActivities(scope)` to register scoped thread operations as\n * Temporal activities on the worker. The `invoker` (or invokers created via\n * `createModelInvoker`) should be wrapped with `createRunAgentActivity`.\n *\n * @example\n * ```typescript\n * import { createLangChainAdapter } from 'zeitlich/adapters/thread/langchain';\n * import { createRunAgentActivity } from 'zeitlich';\n *\n * const adapter = createLangChainAdapter({ redis, model });\n *\n * export function createActivities(client: WorkflowClient) {\n *   return {\n *     ...adapter.createActivities(\"codingAgent\"),\n *     ...createRunAgentActivity(client, adapter.invoker, \"codingAgent\"),\n *   };\n * }\n * ```\n *\n * @example Multi-agent worker\n * ```typescript\n * export function createActivities(client: WorkflowClient) {\n *   return {\n *     ...adapter.createActivities(\"codingAgent\"),\n *     ...adapter.createActivities(\"researchAgent\"),\n *     ...createRunAgentActivity(client, adapter.invoker, \"codingAgent\"),\n *     ...createRunAgentActivity(client, adapter.createModelInvoker(claude), \"researchAgent\"),\n *   };\n * }\n * ```\n */\nexport function createLangChainAdapter(\n  config: LangChainAdapterConfig\n): LangChainAdapter {\n  const { redis } = config;\n\n  const threadOps: ThreadOps<LangChainContent> = {\n    async initializeThread(\n      threadId: string,\n      threadKey?: string\n    ): Promise<void> {\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId,\n        key: threadKey,\n      });\n      await thread.initialize();\n    },\n\n    async appendHumanMessage(\n      threadId: string,\n      id: string,\n      content: LangChainContent,\n      threadKey?: string\n    ): Promise<void> {\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId,\n        key: threadKey,\n      });\n      await thread.appendUserMessage(id, content);\n    },\n\n    async appendSystemMessage(\n      threadId: string,\n      id: string,\n      content: LangChainSystemContent,\n      threadKey?: string\n    ): Promise<void> {\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId,\n        key: threadKey,\n      });\n      await thread.appendSystemMessage(id, content);\n    },\n\n    async appendToolResult(id: string, cfg: ToolResultConfig): Promise<void> {\n      const { threadId, threadKey, toolCallId, content } = cfg;\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId,\n        key: threadKey,\n      });\n      await thread.appendToolResult(id, toolCallId, \"\", content);\n    },\n\n    async appendAgentMessage(\n      threadId: string,\n      id: string,\n      message: StoredMessage,\n      threadKey?: string\n    ): Promise<void> {\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId,\n        key: threadKey,\n      });\n      const patched = { ...message, data: { ...message.data, id } };\n      await thread.append([patched]);\n    },\n\n    async forkThread(\n      sourceThreadId: string,\n      targetThreadId: string,\n      threadKey?: string\n    ): Promise<void> {\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId: sourceThreadId,\n        key: threadKey,\n      });\n      await thread.fork(targetThreadId);\n    },\n  };\n\n  function createActivities<S extends string = \"\">(\n    scope?: S\n  ): LangChainThreadOps<S> {\n    const prefix = scope\n      ? `${ADAPTER_PREFIX}${scope.charAt(0).toUpperCase()}${scope.slice(1)}`\n      : ADAPTER_PREFIX;\n    const cap = (s: string): string => s.charAt(0).toUpperCase() + s.slice(1);\n    return Object.fromEntries(\n      Object.entries(threadOps).map(([k, v]) => [`${prefix}${cap(k)}`, v])\n    ) as LangChainThreadOps<S>;\n  }\n\n  const makeInvoker = (\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    model: BaseChatModel<any>\n  ): ModelInvoker<StoredMessage> =>\n    createLangChainModelInvoker({ redis, model, hooks: config.hooks });\n\n  const invoker: ModelInvoker<StoredMessage> = config.model\n    ? makeInvoker(config.model)\n    : () => {\n        throw new Error(\n          \"No default model provided to createLangChainAdapter. \" +\n            \"Either pass `model` in the config or use `createModelInvoker(model)` instead.\"\n        );\n      };\n\n  return {\n    createActivities,\n    invoker,\n    createModelInvoker: makeInvoker,\n    wrapHandler: (handler) => handler,\n  };\n}\n","import type { BaseMessage, MessageContent } from \"@langchain/core/messages\";\n\ntype ContentBlock = MessageContent extends (infer U)[] | string ? U : never;\n\n/**\n * Creates an `onPreparedMessage` hook that appends a cache-point content\n * block to the last message in the thread, and strips excess cache-point\n * blocks from earlier messages so the total never exceeds `maxBlocks`.\n *\n * Older cache-point blocks are removed first, keeping the most recent\n * `maxBlocks - 1` positions plus the last message's block.\n */\nexport function appendCachePoint(\n  block: ContentBlock,\n  { maxBlocks = 4 }: { maxBlocks?: number } = {}\n): (\n  message: BaseMessage,\n  index: number,\n  messages: readonly BaseMessage[]\n) => BaseMessage {\n  return (message, index, messages) => {\n    const isLast = index === messages.length - 1;\n\n    if (isLast) {\n      const { content } = message;\n      if (Array.isArray(content)) {\n        if (content.some((b) => b.type === block.type)) return message;\n        message.content = [...content, block];\n      } else if (typeof content === \"string\") {\n        message.content = [\n          { type: \"text\", text: content },\n          block,\n        ] satisfies MessageContent;\n      }\n      return message;\n    }\n\n    const { content } = message;\n    if (\n      !Array.isArray(content) ||\n      !content.some((b) => b.type === block.type)\n    ) {\n      return message;\n    }\n\n    // Count cache blocks in messages after this one (excluding the last,\n    // which always gets one) plus 1 for the last message itself.\n    let cacheBlocksAfter = 1;\n    for (let i = index + 1; i < messages.length - 1; i++) {\n      const msg = messages[i];\n      if (!msg) continue;\n      const c = msg.content;\n      if (\n        Array.isArray(c) &&\n        c.some((b: ContentBlock) => b.type === block.type)\n      ) {\n        cacheBlocksAfter++;\n      }\n    }\n\n    if (cacheBlocksAfter >= maxBlocks) {\n      message.content = content.filter((b) => b.type !== block.type);\n    }\n\n    return message;\n  };\n}\n"]}
+{"version":3,"sources":["../../../../src/lib/thread/manager.ts","../../../../src/adapters/thread/langchain/thread-manager.ts","../../../../node_modules/uuid/dist/esm/stringify.js","../../../../node_modules/uuid/dist/esm/rng.js","../../../../node_modules/uuid/dist/esm/native.js","../../../../node_modules/uuid/dist/esm/v4.js","../../../../src/lib/activity.ts","../../../../src/adapters/thread/langchain/model-invoker.ts","../../../../src/adapters/thread/langchain/activities.ts","../../../../src/adapters/thread/langchain/hooks.ts"],"names":["invokeLangChainModel","content"],"mappings":"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","file":"index.js","sourcesContent":["import type { ThreadManagerConfig, BaseThreadManager } from \"./types\";\n\nconst THREAD_TTL_SECONDS = 60 * 60 * 24 * 90; // 90 days\n\n/**\n * Lua script for atomic idempotent append.\n * Checks a dedup key; if it exists the message was already appended and we\n * return 0. Otherwise appends all messages to the list, sets TTL on both\n * the list and the dedup key, and returns 1.\n *\n * KEYS[1] = dedup key, KEYS[2] = list key\n * ARGV[1] = TTL seconds, ARGV[2..N] = serialised messages\n */\nconst APPEND_IDEMPOTENT_SCRIPT = `\nif redis.call('EXISTS', KEYS[1]) == 1 then\n  return 0\nend\nfor i = 2, #ARGV do\n  redis.call('RPUSH', KEYS[2], ARGV[i])\nend\nredis.call('EXPIRE', KEYS[2], tonumber(ARGV[1]))\nredis.call('SET', KEYS[1], '1', 'EX', tonumber(ARGV[1]))\nreturn 1\n`;\n\nfunction getThreadKey(threadId: string, key: string): string {\n  return `${key}:thread:${threadId}`;\n}\n\n/**\n * Creates a generic thread manager for handling conversation state in Redis.\n * Framework-agnostic — works with any serializable message type.\n */\nexport function createThreadManager<T>(\n  config: ThreadManagerConfig<T>\n): BaseThreadManager<T> {\n  const {\n    redis,\n    threadId,\n    key = \"messages\",\n    serialize = (m: T): string => JSON.stringify(m),\n    deserialize = (raw: string): T => JSON.parse(raw) as T,\n    idOf,\n  } = config;\n  const redisKey = getThreadKey(threadId, key);\n  const metaKey = getThreadKey(threadId, `${key}:meta`);\n\n  async function assertThreadExists(): Promise<void> {\n    const exists = await redis.exists(metaKey);\n    if (!exists) {\n      throw new Error(`Thread \"${threadId}\" (key: ${key}) does not exist`);\n    }\n  }\n\n  return {\n    async initialize(): Promise<void> {\n      await redis.del(redisKey);\n      await redis.set(metaKey, \"1\", \"EX\", THREAD_TTL_SECONDS);\n    },\n\n    async load(): Promise<T[]> {\n      await assertThreadExists();\n      const data = await redis.lrange(redisKey, 0, -1);\n      return data.map(deserialize);\n    },\n\n    async append(messages: T[]): Promise<void> {\n      if (messages.length === 0) return;\n      await assertThreadExists();\n\n      if (idOf) {\n        const dedupId = messages.map(idOf).join(\":\");\n        const dedupKey = getThreadKey(threadId, `dedup:${dedupId}`);\n        await redis.eval(\n          APPEND_IDEMPOTENT_SCRIPT,\n          2,\n          dedupKey,\n          redisKey,\n          String(THREAD_TTL_SECONDS),\n          ...messages.map(serialize)\n        );\n      } else {\n        await redis.rpush(redisKey, ...messages.map(serialize));\n        await redis.expire(redisKey, THREAD_TTL_SECONDS);\n      }\n    },\n\n    async fork(newThreadId: string): Promise<BaseThreadManager<T>> {\n      await assertThreadExists();\n      const data = await redis.lrange(redisKey, 0, -1);\n      const forked = createThreadManager({\n        ...config,\n        threadId: newThreadId,\n      });\n      await forked.initialize();\n      if (data.length > 0) {\n        const newKey = getThreadKey(newThreadId, key);\n        await redis.rpush(newKey, ...data);\n        await redis.expire(newKey, THREAD_TTL_SECONDS);\n      }\n      return forked;\n    },\n\n    async delete(): Promise<void> {\n      await redis.del(redisKey, metaKey);\n    },\n\n    async length(): Promise<number> {\n      await assertThreadExists();\n      return redis.llen(redisKey);\n    },\n\n    async truncate(length: number): Promise<void> {\n      await assertThreadExists();\n      if (length <= 0) {\n        await redis.del(redisKey);\n        await redis.expire(metaKey, THREAD_TTL_SECONDS);\n      } else {\n        await redis.ltrim(redisKey, 0, length - 1);\n        await redis.expire(redisKey, THREAD_TTL_SECONDS);\n      }\n      // Dedup keys for removed messages are left to expire via their TTL.\n      // Post-truncate appends use fresh ids so collisions do not occur in practice.\n    },\n  };\n}\n","import type Redis from \"ioredis\";\nimport type { JsonValue } from \"../../../lib/state/types\";\nimport {\n  AIMessage,\n  type BaseMessage,\n  HumanMessage,\n  type MessageContent,\n  type StoredMessage,\n  SystemMessage,\n  ToolMessage,\n  mapStoredMessagesToChatMessages,\n} from \"@langchain/core/messages\";\nimport { createThreadManager } from \"../../../lib/thread/manager\";\nimport type {\n  ProviderThreadManager,\n  ThreadManagerConfig,\n  ThreadManagerHooks,\n} from \"../../../lib/thread/types\";\n\n/** SDK-native content type for LangChain human messages */\nexport type LangChainContent = string | MessageContent;\n\n/** SDK-native content type for LangChain system messages */\nexport type LangChainSystemContent = string | MessageContent;\n\nexport type LangChainThreadManagerHooks = ThreadManagerHooks<\n  StoredMessage,\n  BaseMessage\n>;\n\nexport interface LangChainThreadManagerConfig {\n  redis: Redis;\n  threadId: string;\n  /** Thread key, defaults to 'messages' */\n  key?: string;\n  hooks?: LangChainThreadManagerHooks;\n}\n\n/** Prepared payload ready to send to a LangChain chat model */\nexport interface LangChainInvocationPayload {\n  messages: BaseMessage[];\n  /** Number of stored messages loaded from Redis before preparation. */\n  storedLength: number;\n}\n\n/** Thread manager with LangChain StoredMessage convenience helpers */\nexport interface LangChainThreadManager extends ProviderThreadManager<\n  StoredMessage,\n  LangChainContent,\n  JsonValue,\n  LangChainSystemContent\n> {\n  appendAIMessage(id: string, content: string | MessageContent): Promise<void>;\n  prepareForInvocation(): Promise<LangChainInvocationPayload>;\n}\n\nfunction storedMessageId(msg: StoredMessage): string {\n  if (msg.type === \"tool\" && msg.data.tool_call_id) {\n    return msg.data.tool_call_id;\n  }\n\n  if (msg.data.id) {\n    return msg.data.id;\n  }\n\n  throw new Error(\"No id found for message\");\n}\n\n/**\n * Creates a LangChain-specific thread manager that stores StoredMessage\n * instances in Redis and provides convenience helpers for creating and\n * appending typed LangChain messages.\n */\nexport function createLangChainThreadManager(\n  config: LangChainThreadManagerConfig\n): LangChainThreadManager {\n  const baseConfig: ThreadManagerConfig<StoredMessage> = {\n    redis: config.redis,\n    threadId: config.threadId,\n    key: config.key,\n    idOf: storedMessageId,\n  };\n\n  const base = createThreadManager(baseConfig);\n\n  const helpers: Omit<LangChainThreadManager, keyof typeof base> = {\n    async appendUserMessage(\n      id: string,\n      content: LangChainContent\n    ): Promise<void> {\n      await base.append([\n        new HumanMessage({ id, content: content as MessageContent }).toDict(),\n      ]);\n    },\n\n    async appendSystemMessage(\n      id: string,\n      content: LangChainSystemContent\n    ): Promise<void> {\n      await base.initialize();\n      await base.append([\n        new SystemMessage({\n          id,\n          content: content as MessageContent,\n        }).toDict(),\n      ]);\n    },\n\n    async appendAIMessage(\n      id: string,\n      content: string | MessageContent\n    ): Promise<void> {\n      await base.append([\n        new AIMessage({ id, content: content as MessageContent }).toDict(),\n      ]);\n    },\n\n    async appendToolResult(\n      id: string,\n      _toolCallId: string,\n      _toolName: string,\n      content: JsonValue\n    ): Promise<void> {\n      await base.append([\n        new ToolMessage({\n          id,\n          content: content as MessageContent,\n          tool_call_id: _toolCallId,\n        }).toDict(),\n      ]);\n    },\n\n    async prepareForInvocation(): Promise<LangChainInvocationPayload> {\n      const stored = await base.load();\n      const { onPrepareMessage, onPreparedMessage } = config.hooks ?? {};\n      const mapped = onPrepareMessage\n        ? stored.map((msg, i) => onPrepareMessage(msg, i, stored))\n        : stored;\n      const messages = mapStoredMessagesToChatMessages(mapped);\n      return {\n        messages: onPreparedMessage\n          ? messages.map((msg, i) => onPreparedMessage(msg, i, messages))\n          : messages,\n        storedLength: stored.length,\n      };\n    },\n  };\n\n  return Object.assign(base, helpers);\n}\n","import validate from './validate.js';\nconst byteToHex = [];\nfor (let i = 0; i < 256; ++i) {\n    byteToHex.push((i + 0x100).toString(16).slice(1));\n}\nexport function unsafeStringify(arr, offset = 0) {\n    return (byteToHex[arr[offset + 0]] +\n        byteToHex[arr[offset + 1]] +\n        byteToHex[arr[offset + 2]] +\n        byteToHex[arr[offset + 3]] +\n        '-' +\n        byteToHex[arr[offset + 4]] +\n        byteToHex[arr[offset + 5]] +\n        '-' +\n        byteToHex[arr[offset + 6]] +\n        byteToHex[arr[offset + 7]] +\n        '-' +\n        byteToHex[arr[offset + 8]] +\n        byteToHex[arr[offset + 9]] +\n        '-' +\n        byteToHex[arr[offset + 10]] +\n        byteToHex[arr[offset + 11]] +\n        byteToHex[arr[offset + 12]] +\n        byteToHex[arr[offset + 13]] +\n        byteToHex[arr[offset + 14]] +\n        byteToHex[arr[offset + 15]]).toLowerCase();\n}\nfunction stringify(arr, offset = 0) {\n    const uuid = unsafeStringify(arr, offset);\n    if (!validate(uuid)) {\n        throw TypeError('Stringified UUID is invalid');\n    }\n    return uuid;\n}\nexport default stringify;\n","import { randomFillSync } from 'crypto';\nconst rnds8Pool = new Uint8Array(256);\nlet poolPtr = rnds8Pool.length;\nexport default function rng() {\n    if (poolPtr > rnds8Pool.length - 16) {\n        randomFillSync(rnds8Pool);\n        poolPtr = 0;\n    }\n    return rnds8Pool.slice(poolPtr, (poolPtr += 16));\n}\n","import { randomUUID } from 'crypto';\nexport default { randomUUID };\n","import native from './native.js';\nimport rng from './rng.js';\nimport { unsafeStringify } from './stringify.js';\nfunction v4(options, buf, offset) {\n    if (native.randomUUID && !buf && !options) {\n        return native.randomUUID();\n    }\n    options = options || {};\n    const rnds = options.random ?? options.rng?.() ?? rng();\n    if (rnds.length < 16) {\n        throw new Error('Random bytes length must be >= 16');\n    }\n    rnds[6] = (rnds[6] & 0x0f) | 0x40;\n    rnds[8] = (rnds[8] & 0x3f) | 0x80;\n    if (buf) {\n        offset = offset || 0;\n        if (offset < 0 || offset + 16 > buf.length) {\n            throw new RangeError(`UUID byte range ${offset}:${offset + 15} is out of buffer bounds`);\n        }\n        for (let i = 0; i < 16; ++i) {\n            buf[offset + i] = rnds[i];\n        }\n        return buf;\n    }\n    return unsafeStringify(rnds);\n}\nexport default v4;\n","import { Context } from \"@temporalio/activity\";\nimport type { WorkflowClient } from \"@temporalio/client\";\nimport type { BaseAgentState, RunAgentConfig } from \"./types\";\nimport type { JsonValue } from \"./state/types\";\nimport type {\n  ActivityToolHandler,\n  RouterContext,\n  ToolHandlerResponse,\n} from \"./tool-router/types\";\n\n/**\n * Safely retrieve Temporal activity heartbeat and cancellation signal.\n * Returns empty object when called outside a Temporal activity (e.g. tests).\n */\nexport function getActivityContext(): {\n  heartbeat?: () => void;\n  signal?: AbortSignal;\n} {\n  try {\n    const ctx = Context.current();\n    return { heartbeat: () => ctx.heartbeat(), signal: ctx.cancellationSignal };\n  } catch {\n    return {};\n  }\n}\n\n/**\n * Query the parent workflow's state from within an activity.\n * Resolves the workflow handle from the current activity context.\n */\nexport async function queryParentWorkflowState<T>(\n  client: WorkflowClient\n): Promise<T> {\n  const { workflowExecution } = Context.current().info;\n  const handle = client.getHandle(\n    workflowExecution.workflowId,\n    workflowExecution.runId\n  );\n  return handle.query<T>(\"getAgentState\");\n}\n\n/**\n * Wraps a handler into a scope-prefixed `RunAgentActivity` by auto-fetching\n * the parent workflow's agent state before each invocation.\n *\n * Returns a `Record` with a single key `run<Scope>` so it can be spread\n * into the activities object alongside adapter activities.\n *\n * @param scope - Workflow scope used to derive the activity name.\n *   `\"myAgentWorkflow\"` produces `{ runMyAgentWorkflow: fn }`.\n *\n * @example\n * ```typescript\n * import { createRunAgentActivity } from 'zeitlich';\n *\n * return {\n *   ...adapter.createActivities(\"myAgentWorkflow\"),\n *   ...createRunAgentActivity(client, adapter.invoker, \"myAgentWorkflow\"),\n * };\n * ```\n */\nexport function createRunAgentActivity<\n  R,\n  S extends BaseAgentState = BaseAgentState,\n>(\n  client: WorkflowClient,\n  handler: (config: RunAgentConfig & { state: S }) => Promise<R>,\n  scope: string\n): Record<string, (config: RunAgentConfig) => Promise<R>> {\n  const name = `run${scope.charAt(0).toUpperCase()}${scope.slice(1)}`;\n  return {\n    [name]: async (config: RunAgentConfig) => {\n      const state = await queryParentWorkflowState<S>(client);\n      return handler({ ...config, state });\n    },\n  };\n}\n\n/**\n * Context injected into tool handlers created via {@link withParentWorkflowState}.\n */\nexport interface AgentStateContext<\n  S extends BaseAgentState = BaseAgentState,\n> extends RouterContext {\n  state: S;\n}\n\n/**\n * Wraps a tool handler into an `ActivityToolHandler` by auto-fetching the\n * parent workflow's agent state before each invocation.\n *\n * @typeParam S - Custom agent state type (defaults to `BaseAgentState`)\n *\n * @example\n * ```typescript\n * import { withParentWorkflowState, type AgentStateContext } from 'zeitlich';\n *\n * // With custom state:\n * interface MyState extends BaseAgentState { customField: string }\n * const myHandler = withParentWorkflowState<MyArgs, MyResult, MyState>(\n *   client,\n *   async (args, ctx) => {\n *     console.log(ctx.state.customField);\n *     return { toolResponse: 'done', data: null };\n *   },\n * );\n * ```\n */\nexport function withParentWorkflowState<\n  TArgs,\n  TResult,\n  S extends BaseAgentState = BaseAgentState,\n  TToolResponse = JsonValue,\n>(\n  client: WorkflowClient,\n  handler: (\n    args: TArgs,\n    context: AgentStateContext<S>\n  ) => Promise<ToolHandlerResponse<TResult, TToolResponse>>\n): ActivityToolHandler<TArgs, TResult, RouterContext, TToolResponse> {\n  return async (args, context) => {\n    const state = await queryParentWorkflowState<S>(client);\n    return handler(args, { ...context, state });\n  };\n}\n","import type Redis from \"ioredis\";\nimport type { AgentResponse, ModelInvokerConfig } from \"../../../lib/model\";\nimport type { StoredMessage } from \"@langchain/core/messages\";\nimport { v4 as uuidv4 } from \"uuid\";\nimport type { BaseChatModel } from \"@langchain/core/language_models/chat_models\";\nimport {\n  createLangChainThreadManager,\n  type LangChainThreadManagerHooks,\n} from \"./thread-manager\";\nimport { getActivityContext } from \"../../../lib/activity\";\n\n \nexport interface LangChainModelInvokerConfig<\n  TModel extends BaseChatModel<any> = BaseChatModel<any>,\n> {\n  redis: Redis;\n  model: TModel;\n  hooks?: LangChainThreadManagerHooks;\n}\n\n/**\n * Creates a LangChain-based model invoker that satisfies the generic\n * `ModelInvoker<StoredMessage>` contract.\n *\n * Uses interval-based Temporal heartbeats during model.invoke() to keep\n * long-running LLM calls visible to the scheduler. LangChain's streaming\n * chunk accumulation is unreliable across providers (e.g. reasoning_content\n * blocks don't merge correctly), so we use invoke() for correctness.\n * The caller is responsible for appending the response to the thread.\n *\n * @example\n * ```typescript\n * import { createLangChainModelInvoker } from 'zeitlich/adapters/thread/langchain';\n * import { createRunAgentActivity } from 'zeitlich';\n * import { ChatAnthropic } from '@langchain/anthropic';\n *\n * const model = new ChatAnthropic({ model: \"claude-sonnet-4-6\" });\n * const invoker = createLangChainModelInvoker({ redis, model });\n *\n * return { ...createRunAgentActivity(client, invoker, \"myAgent\") };\n * ```\n */\n \nexport function createLangChainModelInvoker<\n  TModel extends BaseChatModel<any> = BaseChatModel<any>,\n>({ redis, model, hooks }: LangChainModelInvokerConfig<TModel>) {\n  return async function invokeLangChainModel(\n    config: ModelInvokerConfig\n  ): Promise<AgentResponse<StoredMessage>> {\n    const { threadId, threadKey, agentName, state, metadata } = config;\n    const { heartbeat, signal } = getActivityContext();\n\n    const thread = createLangChainThreadManager({\n      redis,\n      threadId,\n      key: threadKey,\n      hooks,\n    });\n    const runId = uuidv4();\n\n    const { messages, storedLength } = await thread.prepareForInvocation();\n\n    const heartbeatInterval = heartbeat\n      ? setInterval(() => heartbeat(), 30_000)\n      : undefined;\n\n    try {\n      const response = await model.invoke(messages, {\n        runName: agentName,\n        runId,\n        metadata: { thread_id: `${agentName}-${threadId}`, ...metadata },\n        tools: state.tools,\n        signal,\n      });\n\n      const toolCalls = response.tool_calls ?? [];\n\n      const providerUsage =\n        (response.response_metadata?.usage as Record<string, unknown>) ?? {};\n\n      return {\n        message: response.toDict(),\n        rawToolCalls: toolCalls.map((tc) => ({\n          id: tc.id,\n          name: tc.name,\n          args: tc.args,\n        })),\n        usage: {\n          inputTokens: response.usage_metadata?.input_tokens,\n          outputTokens: response.usage_metadata?.output_tokens,\n          reasonTokens:\n            response.usage_metadata?.output_token_details?.reasoning,\n          cachedWriteTokens:\n            response.usage_metadata?.input_token_details?.cache_creation ||\n            (providerUsage.cacheWriteInputTokens as number | undefined),\n          cachedReadTokens:\n            response.usage_metadata?.input_token_details?.cache_read ||\n            (providerUsage.cacheReadInputTokens as number | undefined),\n        },\n        threadLengthAtCall: storedLength,\n      };\n    } finally {\n      if (heartbeatInterval) clearInterval(heartbeatInterval);\n    }\n  };\n}\n\n/**\n * Standalone function for one-shot LangChain model invocation.\n * Convenience wrapper around createLangChainModelInvoker for cases where\n * you don't need to reuse the invoker.\n */\n \nexport async function invokeLangChainModel<\n  TModel extends BaseChatModel<any> = BaseChatModel<any>,\n>({\n  redis,\n  model,\n  hooks,\n  config,\n}: {\n  redis: Redis;\n  config: ModelInvokerConfig;\n  model: TModel;\n  hooks?: LangChainThreadManagerHooks;\n}): Promise<AgentResponse<StoredMessage>> {\n  const invoker = createLangChainModelInvoker({ redis, model, hooks });\n  return invoker(config);\n}\n","import type Redis from \"ioredis\";\nimport type { ToolResultConfig } from \"../../../lib/types\";\nimport type { MessageContent } from \"@langchain/core/messages\";\nimport type {\n  ActivityToolHandler,\n  RouterContext,\n  ToolHandlerResponse,\n} from \"../../../lib/tool-router/types\";\nimport type {\n  ThreadOps,\n  PrefixedThreadOps,\n  ScopedPrefix,\n} from \"../../../lib/session/types\";\nimport type { ModelInvoker } from \"../../../lib/model\";\nimport type { StoredMessage } from \"@langchain/core/messages\";\nimport type { BaseChatModel } from \"@langchain/core/language_models/chat_models\";\nimport {\n  createLangChainThreadManager,\n  type LangChainContent,\n  type LangChainSystemContent,\n  type LangChainThreadManagerHooks,\n} from \"./thread-manager\";\nimport { createLangChainModelInvoker } from \"./model-invoker\";\n\nconst ADAPTER_PREFIX = \"langChain\" as const;\n\nexport type LangChainThreadOps<TScope extends string = \"\"> = PrefixedThreadOps<\n  ScopedPrefix<TScope, typeof ADAPTER_PREFIX>,\n  LangChainContent\n>;\n\nexport interface LangChainAdapterConfig {\n  redis: Redis;\n  /** Optional default model — if omitted, use `createModelInvoker()` to create invokers later */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  model?: BaseChatModel<any>;\n  hooks?: LangChainThreadManagerHooks;\n}\n\n/**\n * Tool response type accepted by the LangChain adapter.\n *\n * Content is passed directly to `ToolMessage` as `MessageContent`.\n * Handlers can return a string or an array of content blocks\n * (e.g. `{ type: \"text\", text: \"...\" }`, `{ type: \"image_url\", image_url: { ... } }`).\n */\nexport type LangChainToolResponse = MessageContent;\n\nexport interface LangChainAdapter {\n  /** Model invoker using the default model (only available when `model` was provided) */\n  invoker: ModelInvoker<StoredMessage>;\n  /** Create an invoker for a specific model (for multi-model setups) */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  createModelInvoker(model: BaseChatModel<any>): ModelInvoker<StoredMessage>;\n  /**\n   * Create prefixed thread activities for registration on the worker.\n   *\n   * @param scope - Workflow name appended to the adapter prefix.\n   *\n   * @example\n   * ```typescript\n   * adapter.createActivities(\"codingAgent\")\n   * // → { langChainCodingAgentInitializeThread, langChainCodingAgentAppendHumanMessage, … }\n   * ```\n   */\n  createActivities<S extends string = \"\">(scope?: S): LangChainThreadOps<S>;\n\n  /**\n   * Identity wrapper that types a tool handler for this adapter.\n   * Constrains `toolResponse` to {@link LangChainToolResponse}.\n   */\n  wrapHandler<TArgs, TResult, TContext extends RouterContext = RouterContext>(\n    handler: (\n      args: TArgs,\n      context: TContext\n    ) => Promise<ToolHandlerResponse<TResult, LangChainToolResponse>>\n  ): ActivityToolHandler<TArgs, TResult, TContext, LangChainToolResponse>;\n}\n\n/**\n * Creates a LangChain adapter that bundles thread operations and model\n * invocation using a consistent message format (StoredMessage).\n *\n * Use `createActivities(scope)` to register scoped thread operations as\n * Temporal activities on the worker. The `invoker` (or invokers created via\n * `createModelInvoker`) should be wrapped with `createRunAgentActivity`.\n *\n * @example\n * ```typescript\n * import { createLangChainAdapter } from 'zeitlich/adapters/thread/langchain';\n * import { createRunAgentActivity } from 'zeitlich';\n *\n * const adapter = createLangChainAdapter({ redis, model });\n *\n * export function createActivities(client: WorkflowClient) {\n *   return {\n *     ...adapter.createActivities(\"codingAgent\"),\n *     ...createRunAgentActivity(client, adapter.invoker, \"codingAgent\"),\n *   };\n * }\n * ```\n *\n * @example Multi-agent worker\n * ```typescript\n * export function createActivities(client: WorkflowClient) {\n *   return {\n *     ...adapter.createActivities(\"codingAgent\"),\n *     ...adapter.createActivities(\"researchAgent\"),\n *     ...createRunAgentActivity(client, adapter.invoker, \"codingAgent\"),\n *     ...createRunAgentActivity(client, adapter.createModelInvoker(claude), \"researchAgent\"),\n *   };\n * }\n * ```\n */\nexport function createLangChainAdapter(\n  config: LangChainAdapterConfig\n): LangChainAdapter {\n  const { redis } = config;\n\n  const threadOps: ThreadOps<LangChainContent> = {\n    async initializeThread(\n      threadId: string,\n      threadKey?: string\n    ): Promise<void> {\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId,\n        key: threadKey,\n      });\n      await thread.initialize();\n    },\n\n    async appendHumanMessage(\n      threadId: string,\n      id: string,\n      content: LangChainContent,\n      threadKey?: string\n    ): Promise<void> {\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId,\n        key: threadKey,\n      });\n      await thread.appendUserMessage(id, content);\n    },\n\n    async appendSystemMessage(\n      threadId: string,\n      id: string,\n      content: LangChainSystemContent,\n      threadKey?: string\n    ): Promise<void> {\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId,\n        key: threadKey,\n      });\n      await thread.appendSystemMessage(id, content);\n    },\n\n    async appendToolResult(id: string, cfg: ToolResultConfig): Promise<void> {\n      const { threadId, threadKey, toolCallId, content } = cfg;\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId,\n        key: threadKey,\n      });\n      await thread.appendToolResult(id, toolCallId, \"\", content);\n    },\n\n    async appendAgentMessage(\n      threadId: string,\n      id: string,\n      message: StoredMessage,\n      threadKey?: string\n    ): Promise<void> {\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId,\n        key: threadKey,\n      });\n      const patched = { ...message, data: { ...message.data, id } };\n      await thread.append([patched]);\n    },\n\n    async forkThread(\n      sourceThreadId: string,\n      targetThreadId: string,\n      threadKey?: string\n    ): Promise<void> {\n      const thread = createLangChainThreadManager({\n        redis,\n        threadId: sourceThreadId,\n        key: threadKey,\n      });\n      await thread.fork(targetThreadId);\n    },\n\n    async truncateThread(\n      threadId: string,\n      length: number,\n      threadKey?: string,\n    ): Promise<void> {\n      const thread = createLangChainThreadManager({ redis, threadId, key: threadKey });\n      await thread.truncate(length);\n    },\n  };\n\n  function createActivities<S extends string = \"\">(\n    scope?: S\n  ): LangChainThreadOps<S> {\n    const prefix = scope\n      ? `${ADAPTER_PREFIX}${scope.charAt(0).toUpperCase()}${scope.slice(1)}`\n      : ADAPTER_PREFIX;\n    const cap = (s: string): string => s.charAt(0).toUpperCase() + s.slice(1);\n    return Object.fromEntries(\n      Object.entries(threadOps).map(([k, v]) => [`${prefix}${cap(k)}`, v])\n    ) as LangChainThreadOps<S>;\n  }\n\n  const makeInvoker = (\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    model: BaseChatModel<any>\n  ): ModelInvoker<StoredMessage> =>\n    createLangChainModelInvoker({ redis, model, hooks: config.hooks });\n\n  const invoker: ModelInvoker<StoredMessage> = config.model\n    ? makeInvoker(config.model)\n    : () => {\n        throw new Error(\n          \"No default model provided to createLangChainAdapter. \" +\n            \"Either pass `model` in the config or use `createModelInvoker(model)` instead.\"\n        );\n      };\n\n  return {\n    createActivities,\n    invoker,\n    createModelInvoker: makeInvoker,\n    wrapHandler: (handler) => handler,\n  };\n}\n","import type { BaseMessage, MessageContent } from \"@langchain/core/messages\";\n\ntype ContentBlock = MessageContent extends (infer U)[] | string ? U : never;\n\n/**\n * Creates an `onPreparedMessage` hook that appends a cache-point content\n * block to the last message in the thread, and strips excess cache-point\n * blocks from earlier messages so the total never exceeds `maxBlocks`.\n *\n * Older cache-point blocks are removed first, keeping the most recent\n * `maxBlocks - 1` positions plus the last message's block.\n */\nexport function appendCachePoint(\n  block: ContentBlock,\n  { maxBlocks = 4 }: { maxBlocks?: number } = {}\n): (\n  message: BaseMessage,\n  index: number,\n  messages: readonly BaseMessage[]\n) => BaseMessage {\n  return (message, index, messages) => {\n    const isLast = index === messages.length - 1;\n\n    if (isLast) {\n      const { content } = message;\n      if (Array.isArray(content)) {\n        if (content.some((b) => b.type === block.type)) return message;\n        message.content = [...content, block];\n      } else if (typeof content === \"string\") {\n        message.content = [\n          { type: \"text\", text: content },\n          block,\n        ] satisfies MessageContent;\n      }\n      return message;\n    }\n\n    const { content } = message;\n    if (\n      !Array.isArray(content) ||\n      !content.some((b) => b.type === block.type)\n    ) {\n      return message;\n    }\n\n    // Count cache blocks in messages after this one (excluding the last,\n    // which always gets one) plus 1 for the last message itself.\n    let cacheBlocksAfter = 1;\n    for (let i = index + 1; i < messages.length - 1; i++) {\n      const msg = messages[i];\n      if (!msg) continue;\n      const c = msg.content;\n      if (\n        Array.isArray(c) &&\n        c.some((b: ContentBlock) => b.type === block.type)\n      ) {\n        cacheBlocksAfter++;\n      }\n    }\n\n    if (cacheBlocksAfter >= maxBlocks) {\n      message.content = content.filter((b) => b.type !== block.type);\n    }\n\n    return message;\n  };\n}\n"]}

package/dist/adapters/thread/langchain/workflow.cjs

@@ -24,7 +24,8 @@ function createThreadOpsProxy(adapterPrefix, scope, options) {
     appendToolResult: acts[p("appendToolResult")],
     appendAgentMessage: acts[p("appendAgentMessage")],
     appendSystemMessage: acts[p("appendSystemMessage")],
-    forkThread: acts[p("forkThread")]
+    forkThread: acts[p("forkThread")],
+    truncateThread: acts[p("truncateThread")]
   };
 }