zeitlich 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,152 @@
+import { T as ToolDefinition, I as InvocationConfig, A as AgentResponse, a as ActivityToolHandler, b as AskUserQuestionToolSchemaType, F as FileSystemProvider, c as FileNode, G as GlobToolSchemaType, d as GrepToolSchemaType, e as GrepMatch, R as ReadToolSchemaType, f as FileContent, W as WriteToolSchemaType, E as EditToolSchemaType } from './workflow-DeVGEXSc.js';
+export { g as AGENT_HANDLER_NAMES, h as AgentFile, i as AgentState, j as AgentStateManager, k as AgentStateManagerConfig, l as AgentStatus, m as AppendToolResultFn, B as BackendConfig, n as BaseAgentState, o as BaseFileSystemProvider, C as CompositeFileSystemProvider, p as FileResolver, q as FileSystemToolsConfig, r as FileTreeRenderOptions, s as GenericTaskToolSchemaType, t as GrepOptions, u as InMemoryFileSystemProvider, J as JsonPrimitive, v as JsonSerializable, w as JsonValue, P as ParsedToolCall, x as ParsedToolCallUnion, y as PostToolUseFailureHook, z as PostToolUseFailureHookContext, D as PostToolUseFailureHookResult, H as PostToolUseHook, K as PostToolUseHookContext, L as PreToolUseHook, M as PreToolUseHookContext, N as PreToolUseHookResult, O as ProcessToolCallsContext, Q as PromptManager, S as PromptManagerConfig, U as RawToolCall, V as RunAgentActivity, X as RunAgentConfig, Y as SessionEndHook, Z as SessionEndHookContext, _ as SessionExitReason, $ as SessionHooks, a0 as SessionLifecycleHooks, a1 as SessionStartHook, a2 as SessionStartHookContext, a3 as SubagentConfig, a4 as SubagentInput, a5 as SubagentSupportConfig, a6 as SubagentSupportResult, a7 as TaskHandlerResult, a8 as TaskToolSchemaType, a9 as ToolCallResult, aa as ToolCallResultUnion, ab as ToolHandler, ac as ToolHandlerMap, ad as ToolHandlerResponse, ae as ToolMap, af as ToolMessageContent, ag as ToolNames, ah as ToolRegistry, ai as ToolResultConfig, aj as ToolRouter, ak as ToolRouterHooks, al as ToolRouterOptions, am as ZeitlichAgentConfig, an as ZeitlichSession, ao as ZeitlichSharedActivities, ap as askUserQuestionTool, aq as buildFileTreePrompt, ar as createAgentStateManager, as as createPromptManager, at as createSession, au as createSharedActivities, av as createTaskHandler, aw as createTaskTool, ax as createToolRegistry, ay as createToolRouter, az as editTool, aA as fileContentToMessageContent, aB as findNodeByPath, aC as flattenFileTree, aD as globTool, aE as grepTool, aF as hasNoOtherToolCalls, aG as hasTaskTool, aH as isPathInScope, aI as isTerminalStatus, aJ as readTool, aK as withSubagentSupport, aL as writeTool } from './workflow-DeVGEXSc.js';
+import { SimplePlugin } from '@temporalio/plugin';
+import Redis from 'ioredis';
+import { BaseChatModel, BaseChatModelCallOptions, BindToolsInput } from '@langchain/core/language_models/chat_models';
+import { StoredMessage, ContentBlock } from '@langchain/core/messages';
+import 'zod';
+
+/**
+ * Options for the Zeitlich plugin
+ *
+ * @experimental The Zeitlich plugin is an experimental feature; APIs may change without notice.
+ */
+interface ZeitlichPluginOptions {
+    redis: Redis;
+}
+/**
+ * A Temporal plugin that integrates Zeitlich for use in workflows.
+ * This plugin creates shared activities for thread management.
+ * Workflow-specific activities (like runAgent) should be created separately.
+ *
+ * @experimental The Zeitlich plugin is an experimental feature; APIs may change without notice.
+ */
+declare class ZeitlichPlugin extends SimplePlugin {
+    constructor(options: ZeitlichPluginOptions);
+}
+
+/**
+ * Configuration for invoking the model
+ */
+interface InvokeModelConfig {
+    threadId: string;
+    agentName: string;
+    tools: ToolDefinition[];
+}
+/**
+ * Core model invocation logic - shared utility for workflow-specific activities
+ *
+ * @param redis - Redis client for thread management
+ * @param config - Model invocation configuration
+ * @param model - Pre-instantiated LangChain chat model
+ * @param invocationConfig - Per-invocation configuration (system prompt, etc.)
+ * @returns Agent response with message and metadata
+ */
+declare function invokeModel(redis: Redis, { threadId, agentName, tools }: InvokeModelConfig, model: BaseChatModel<BaseChatModelCallOptions & {
+    tools?: BindToolsInput;
+}>, { systemPrompt }: InvocationConfig): Promise<AgentResponse>;
+
+/**
+ * Handle user interaction tool result - creates AI messages for display.
+ */
+declare const handleAskUserQuestionToolResult: ActivityToolHandler<AskUserQuestionToolSchemaType, {
+    chatMessages: StoredMessage[];
+}>;
+
+interface GlobHandlerConfig {
+    provider: FileSystemProvider;
+    scopedNodes: FileNode[];
+}
+/**
+ * Create a glob handler that searches within the scoped file tree.
+ */
+declare function createGlobHandler(config: GlobHandlerConfig): (args: GlobToolSchemaType) => Promise<{
+    content: string;
+    result: {
+        files: FileNode[];
+    };
+}>;
+
+interface GrepHandlerConfig {
+    provider: FileSystemProvider;
+    scopedNodes: FileNode[];
+}
+/**
+ * Create a grep handler that searches within the scoped file tree.
+ */
+declare function createGrepHandler(config: GrepHandlerConfig): (args: GrepToolSchemaType) => Promise<{
+    content: string;
+    result: {
+        matches: GrepMatch[];
+    };
+}>;
+
+interface ReadHandlerConfig {
+    provider: FileSystemProvider;
+    scopedNodes: FileNode[];
+}
+/**
+ * Create a read handler that reads files within the scoped file tree.
+ */
+declare function createReadHandler(config: ReadHandlerConfig): (args: ReadToolSchemaType) => Promise<{
+    content: ContentBlock[];
+    result: {
+        path: string;
+        content: FileContent;
+    };
+}>;
+
+interface WriteHandlerConfig {
+    provider: FileSystemProvider;
+    scopedNodes: FileNode[];
+    /**
+     * Set of file paths that have been read in this session.
+     * Required for enforcing read-before-write policy.
+     */
+    readFiles: Set<string>;
+    /**
+     * If true, skip the read-before-write check (not recommended)
+     */
+    skipReadCheck?: boolean;
+}
+interface WriteResult {
+    path: string;
+    success: boolean;
+    created: boolean;
+    bytesWritten: number;
+}
+/**
+ * Create a write handler that writes files within the scoped file tree.
+ */
+declare function createWriteHandler(config: WriteHandlerConfig): (args: WriteToolSchemaType) => Promise<{
+    content: string;
+    result: WriteResult;
+}>;
+
+interface EditHandlerConfig {
+    provider: FileSystemProvider;
+    scopedNodes: FileNode[];
+    /**
+     * Set of file paths that have been read in this session.
+     * Required for enforcing read-before-write policy.
+     */
+    readFiles: Set<string>;
+    /**
+     * If true, skip the read-before-write check (not recommended)
+     */
+    skipReadCheck?: boolean;
+}
+interface EditResult {
+    path: string;
+    success: boolean;
+    replacements: number;
+}
+/**
+ * Create an edit handler that edits files within the scoped file tree.
+ */
+declare function createEditHandler(config: EditHandlerConfig): (args: EditToolSchemaType) => Promise<{
+    content: string;
+    result: EditResult;
+}>;
+
+export { ActivityToolHandler, AgentResponse, AskUserQuestionToolSchemaType, type EditHandlerConfig, type EditResult, EditToolSchemaType, FileContent, FileNode, FileSystemProvider, type GlobHandlerConfig, GlobToolSchemaType, type GrepHandlerConfig, GrepMatch, GrepToolSchemaType, InvocationConfig, type InvokeModelConfig, type ReadHandlerConfig, ReadToolSchemaType, ToolDefinition, type WriteHandlerConfig, type WriteResult, WriteToolSchemaType, ZeitlichPlugin, type ZeitlichPluginOptions, createEditHandler, createGlobHandler, createGrepHandler, createReadHandler, createWriteHandler, handleAskUserQuestionToolResult, invokeModel };