zeitlich 0.2.50 → 0.2.51

package/dist/activities-IuOIvPHO.d.ts

@@ -1,162 +0,0 @@
-import { RedisClientType } from 'redis';
-import { Part, Content, GoogleGenAI } from '@google/genai';
-import { a as ModelInvoker, b as PrefixedThreadOps, S as ScopedPrefix, R as RouterContext, c as ToolHandlerResponse, d as ActivityToolHandler } from './types-YNesmGKV.js';
-import { C as ColdThreadStore } from './cold-store-CCnZYWjx.js';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-CbPnU4RM.js';
-import { A as ADAPTER_ID } from './adapter-id-BB-mmrts.js';
-
-/** SDK-native content type for Google GenAI human messages */
-type GoogleGenAIContent = string | Part[];
-/** SDK-native content type for Google GenAI system instructions */
-type GoogleGenAISystemContent = string | Part[];
-/** A Content with a unique ID for idempotent Redis storage */
-interface StoredContent {
-    id: string;
-    content: Content;
-}
-type GoogleGenAIThreadManagerHooks = ThreadManagerHooks<StoredContent, Content>;
-interface GoogleGenAIThreadManagerConfig {
-    redis: RedisClientType;
-    threadId: string;
-    /** Thread key, defaults to 'messages' */
-    key?: string;
-    hooks?: GoogleGenAIThreadManagerHooks;
-    /**
-     * Override the default thread TTL (90 days). When pairing the
-     * adapter with a durable cold tier, a shorter TTL (hours) is
-     * typically more appropriate.
-     */
-    ttlSeconds?: number;
-}
-/** Prepared payload ready to send to the Google GenAI API */
-interface GoogleGenAIInvocationPayload {
-    contents: Content[];
-    systemInstruction?: Part[];
-}
-/** Thread manager with Google GenAI Content convenience helpers */
-interface GoogleGenAIThreadManager extends ProviderThreadManager<StoredContent, GoogleGenAIContent, GoogleGenAIToolResponse, GoogleGenAISystemContent> {
-    appendModelContent(id: string, parts: Part[]): Promise<void>;
-    prepareForInvocation(): Promise<GoogleGenAIInvocationPayload>;
-}
-/**
- * Creates a Google GenAI-specific thread manager that stores StoredContent
- * instances in Redis and provides convenience helpers for creating and
- * appending typed Content messages.
- */
-declare function createGoogleGenAIThreadManager(config: GoogleGenAIThreadManagerConfig): GoogleGenAIThreadManager;
-
-type GoogleGenAIThreadOps<TScope extends string = ""> = PrefixedThreadOps<ScopedPrefix<TScope, typeof ADAPTER_ID>, GoogleGenAIContent>;
-interface GoogleGenAIAdapterConfig {
-    redis: RedisClientType;
-    client?: GoogleGenAI;
-    /** Default model name (e.g. 'gemini-2.5-flash'). If omitted, use `createModelInvoker()` */
-    model?: string;
-    hooks?: GoogleGenAIThreadManagerHooks;
-    /**
-     * Optional durable cold tier (e.g. S3, R2, GCS). When provided,
-     * the session hydrates the thread on entry (`continue`/`fork`) and
-     * flushes it on every exit path. When omitted, the adapter is
-     * Redis-only and `hydrateThread`/`flushThread` activities are no-ops.
-     */
-    coldStore?: ColdThreadStore;
-    /**
-     * Override the default Redis TTL (90 days). When pairing the
-     * adapter with a `coldStore`, a shorter TTL (hours) is typically
-     * more appropriate.
-     */
-    ttlSeconds?: number;
-}
-/**
- * Tool response type accepted by the Google GenAI adapter.
- *
- * Handlers can return:
- * - **`string`** — plain text, wrapped in a `functionResponse` part.
- * - **`Record<string, unknown>`** — structured object used as `functionResponse.response`.
- * - **`Part[]`** — pre-built parts used directly as `Content.parts`.
- *   The handler is responsible for building correct Part objects (e.g. `functionResponse`,
- *   `inlineData`, `text`). Use `context.toolCallId` and `context.toolName` to construct
- *   `functionResponse` parts.
- *
- * @example
- * ```typescript
- * adapter.wrapHandler(async (args, ctx) => ({
- *   toolResponse: [
- *     { functionResponse: { id: ctx.toolCallId, name: ctx.toolName, response: { result: "done" } } },
- *     { inlineData: { data: base64, mimeType: "image/png" } },
- *   ],
- *   data: null,
- * }));
- * ```
- */
-type GoogleGenAIToolResponse = string | Record<string, unknown> | Part[];
-interface GoogleGenAIAdapter {
-    /** Model invoker using the default model (only available when `model` was provided) */
-    invoker: ModelInvoker<Content>;
-    /** Create an invoker for a specific model name (for multi-model setups) */
-    createModelInvoker(model: string, client: GoogleGenAI): ModelInvoker<Content>;
-    /**
-     * Create prefixed thread activities for registration on the worker.
-     *
-     * @param scope - Workflow name appended to the adapter prefix.
-     *   Use different scopes for the main agent vs subagents to avoid collisions.
-     *
-     * @example
-     * ```typescript
-     * adapter.createActivities("codingAgent")
-     * // → { googleGenAICodingAgentInitializeThread, googleGenAICodingAgentAppendHumanMessage, … }
-     *
-     * adapter.createActivities("researchAgent")
-     * // → { googleGenAIResearchAgentInitializeThread, … }
-     * ```
-     */
-    createActivities<S extends string = "">(scope?: S): GoogleGenAIThreadOps<S>;
-    /**
-     * Identity wrapper that types a tool handler for this adapter.
-     * Constrains `toolResponse` to {@link GoogleGenAIToolResponse}.
-     */
-    wrapHandler<TArgs, TResult, TContext extends RouterContext = RouterContext>(handler: (args: TArgs, context: TContext) => Promise<ToolHandlerResponse<TResult, GoogleGenAIToolResponse>>): ActivityToolHandler<TArgs, TResult, TContext, GoogleGenAIToolResponse>;
-}
-/**
- * Creates a Google GenAI adapter that bundles thread operations and model
- * invocation using the `@google/genai` SDK.
- *
- * Use `createActivities(scope)` to register scoped thread operations as
- * Temporal activities on the worker. The `invoker` (or invokers created via
- * `createModelInvoker`) should be wrapped with `createRunAgentActivity`.
- *
- * @example
- * ```typescript
- * import { createGoogleGenAIAdapter } from 'zeitlich/adapters/thread/google-genai';
- * import { createRunAgentActivity } from 'zeitlich';
- * import { GoogleGenAI } from '@google/genai';
- *
- * const client = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
- * const adapter = createGoogleGenAIAdapter({ redis, client, model: 'gemini-2.5-flash' });
- *
- * export function createActivities(temporalClient: WorkflowClient) {
- *   return {
- *     ...adapter.createActivities("codingAgent"),
- *     ...createRunAgentActivity(temporalClient, adapter.invoker, "codingAgent"),
- *   };
- * }
- * ```
- *
- * @example Multi-agent worker (main + subagent share the adapter)
- * ```typescript
- * export function createActivities(temporalClient: WorkflowClient) {
- *   return {
- *     ...adapter.createActivities("codingAgent"),
- *     ...adapter.createActivities("researchAgent"),
- *     ...createRunAgentActivity(temporalClient, adapter.invoker, "codingAgent"),
- *     ...createRunAgentActivity(
- *       temporalClient,
- *       adapter.createModelInvoker('gemini-2.5-pro'),
- *       "researchAgent",
- *     ),
- *   };
- * }
- * ```
- */
-declare function createGoogleGenAIAdapter(config: GoogleGenAIAdapterConfig): GoogleGenAIAdapter;
-
-export { type GoogleGenAIThreadManagerHooks as G, type StoredContent as S, type GoogleGenAIAdapter as a, type GoogleGenAIAdapterConfig as b, type GoogleGenAIContent as c, type GoogleGenAIInvocationPayload as d, type GoogleGenAIThreadManager as e, type GoogleGenAIThreadManagerConfig as f, type GoogleGenAIThreadOps as g, type GoogleGenAIToolResponse as h, createGoogleGenAIAdapter as i, createGoogleGenAIThreadManager as j };

package/dist/activities-cIlq1y1y.d.cts

@@ -1,162 +0,0 @@
-import { RedisClientType } from 'redis';
-import { Part, Content, GoogleGenAI } from '@google/genai';
-import { a as ModelInvoker, b as PrefixedThreadOps, S as ScopedPrefix, R as RouterContext, c as ToolHandlerResponse, d as ActivityToolHandler } from './types-DZnUqCAP.cjs';
-import { C as ColdThreadStore } from './cold-store-C0uvYTSi.cjs';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-d2RvEP6v.cjs';
-import { A as ADAPTER_ID } from './adapter-id-BB-mmrts.cjs';
-
-/** SDK-native content type for Google GenAI human messages */
-type GoogleGenAIContent = string | Part[];
-/** SDK-native content type for Google GenAI system instructions */
-type GoogleGenAISystemContent = string | Part[];
-/** A Content with a unique ID for idempotent Redis storage */
-interface StoredContent {
-    id: string;
-    content: Content;
-}
-type GoogleGenAIThreadManagerHooks = ThreadManagerHooks<StoredContent, Content>;
-interface GoogleGenAIThreadManagerConfig {
-    redis: RedisClientType;
-    threadId: string;
-    /** Thread key, defaults to 'messages' */
-    key?: string;
-    hooks?: GoogleGenAIThreadManagerHooks;
-    /**
-     * Override the default thread TTL (90 days). When pairing the
-     * adapter with a durable cold tier, a shorter TTL (hours) is
-     * typically more appropriate.
-     */
-    ttlSeconds?: number;
-}
-/** Prepared payload ready to send to the Google GenAI API */
-interface GoogleGenAIInvocationPayload {
-    contents: Content[];
-    systemInstruction?: Part[];
-}
-/** Thread manager with Google GenAI Content convenience helpers */
-interface GoogleGenAIThreadManager extends ProviderThreadManager<StoredContent, GoogleGenAIContent, GoogleGenAIToolResponse, GoogleGenAISystemContent> {
-    appendModelContent(id: string, parts: Part[]): Promise<void>;
-    prepareForInvocation(): Promise<GoogleGenAIInvocationPayload>;
-}
-/**
- * Creates a Google GenAI-specific thread manager that stores StoredContent
- * instances in Redis and provides convenience helpers for creating and
- * appending typed Content messages.
- */
-declare function createGoogleGenAIThreadManager(config: GoogleGenAIThreadManagerConfig): GoogleGenAIThreadManager;
-
-type GoogleGenAIThreadOps<TScope extends string = ""> = PrefixedThreadOps<ScopedPrefix<TScope, typeof ADAPTER_ID>, GoogleGenAIContent>;
-interface GoogleGenAIAdapterConfig {
-    redis: RedisClientType;
-    client?: GoogleGenAI;
-    /** Default model name (e.g. 'gemini-2.5-flash'). If omitted, use `createModelInvoker()` */
-    model?: string;
-    hooks?: GoogleGenAIThreadManagerHooks;
-    /**
-     * Optional durable cold tier (e.g. S3, R2, GCS). When provided,
-     * the session hydrates the thread on entry (`continue`/`fork`) and
-     * flushes it on every exit path. When omitted, the adapter is
-     * Redis-only and `hydrateThread`/`flushThread` activities are no-ops.
-     */
-    coldStore?: ColdThreadStore;
-    /**
-     * Override the default Redis TTL (90 days). When pairing the
-     * adapter with a `coldStore`, a shorter TTL (hours) is typically
-     * more appropriate.
-     */
-    ttlSeconds?: number;
-}
-/**
- * Tool response type accepted by the Google GenAI adapter.
- *
- * Handlers can return:
- * - **`string`** — plain text, wrapped in a `functionResponse` part.
- * - **`Record<string, unknown>`** — structured object used as `functionResponse.response`.
- * - **`Part[]`** — pre-built parts used directly as `Content.parts`.
- *   The handler is responsible for building correct Part objects (e.g. `functionResponse`,
- *   `inlineData`, `text`). Use `context.toolCallId` and `context.toolName` to construct
- *   `functionResponse` parts.
- *
- * @example
- * ```typescript
- * adapter.wrapHandler(async (args, ctx) => ({
- *   toolResponse: [
- *     { functionResponse: { id: ctx.toolCallId, name: ctx.toolName, response: { result: "done" } } },
- *     { inlineData: { data: base64, mimeType: "image/png" } },
- *   ],
- *   data: null,
- * }));
- * ```
- */
-type GoogleGenAIToolResponse = string | Record<string, unknown> | Part[];
-interface GoogleGenAIAdapter {
-    /** Model invoker using the default model (only available when `model` was provided) */
-    invoker: ModelInvoker<Content>;
-    /** Create an invoker for a specific model name (for multi-model setups) */
-    createModelInvoker(model: string, client: GoogleGenAI): ModelInvoker<Content>;
-    /**
-     * Create prefixed thread activities for registration on the worker.
-     *
-     * @param scope - Workflow name appended to the adapter prefix.
-     *   Use different scopes for the main agent vs subagents to avoid collisions.
-     *
-     * @example
-     * ```typescript
-     * adapter.createActivities("codingAgent")
-     * // → { googleGenAICodingAgentInitializeThread, googleGenAICodingAgentAppendHumanMessage, … }
-     *
-     * adapter.createActivities("researchAgent")
-     * // → { googleGenAIResearchAgentInitializeThread, … }
-     * ```
-     */
-    createActivities<S extends string = "">(scope?: S): GoogleGenAIThreadOps<S>;
-    /**
-     * Identity wrapper that types a tool handler for this adapter.
-     * Constrains `toolResponse` to {@link GoogleGenAIToolResponse}.
-     */
-    wrapHandler<TArgs, TResult, TContext extends RouterContext = RouterContext>(handler: (args: TArgs, context: TContext) => Promise<ToolHandlerResponse<TResult, GoogleGenAIToolResponse>>): ActivityToolHandler<TArgs, TResult, TContext, GoogleGenAIToolResponse>;
-}
-/**
- * Creates a Google GenAI adapter that bundles thread operations and model
- * invocation using the `@google/genai` SDK.
- *
- * Use `createActivities(scope)` to register scoped thread operations as
- * Temporal activities on the worker. The `invoker` (or invokers created via
- * `createModelInvoker`) should be wrapped with `createRunAgentActivity`.
- *
- * @example
- * ```typescript
- * import { createGoogleGenAIAdapter } from 'zeitlich/adapters/thread/google-genai';
- * import { createRunAgentActivity } from 'zeitlich';
- * import { GoogleGenAI } from '@google/genai';
- *
- * const client = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
- * const adapter = createGoogleGenAIAdapter({ redis, client, model: 'gemini-2.5-flash' });
- *
- * export function createActivities(temporalClient: WorkflowClient) {
- *   return {
- *     ...adapter.createActivities("codingAgent"),
- *     ...createRunAgentActivity(temporalClient, adapter.invoker, "codingAgent"),
- *   };
- * }
- * ```
- *
- * @example Multi-agent worker (main + subagent share the adapter)
- * ```typescript
- * export function createActivities(temporalClient: WorkflowClient) {
- *   return {
- *     ...adapter.createActivities("codingAgent"),
- *     ...adapter.createActivities("researchAgent"),
- *     ...createRunAgentActivity(temporalClient, adapter.invoker, "codingAgent"),
- *     ...createRunAgentActivity(
- *       temporalClient,
- *       adapter.createModelInvoker('gemini-2.5-pro'),
- *       "researchAgent",
- *     ),
- *   };
- * }
- * ```
- */
-declare function createGoogleGenAIAdapter(config: GoogleGenAIAdapterConfig): GoogleGenAIAdapter;
-
-export { type GoogleGenAIThreadManagerHooks as G, type StoredContent as S, type GoogleGenAIAdapter as a, type GoogleGenAIAdapterConfig as b, type GoogleGenAIContent as c, type GoogleGenAIInvocationPayload as d, type GoogleGenAIThreadManager as e, type GoogleGenAIThreadManagerConfig as f, type GoogleGenAIThreadOps as g, type GoogleGenAIToolResponse as h, createGoogleGenAIAdapter as i, createGoogleGenAIThreadManager as j };