zeitlich 0.2.15 → 0.2.17

package/dist/workflow.d.cts

@@ -1,13 +1,13 @@
 import { proxyActivities } from '@temporalio/workflow';
-import { k as SessionConfig, Z as ZeitlichSession, T as ThreadOps, f as JsonSerializable, e as AgentStateManager, p as SubagentConfig, q as SubagentHandlerResponse, r as SubagentHooks, b as SkillMetadata, c as Skill } from './types-Dje1TdH6.cjs';
-export { A as AgentResponse, d as AgentState, H as Hooks, J as JsonPrimitive, g as JsonValue, M as ModelInvoker, a as ModelInvokerConfig, P as PostHumanMessageAppendHook, h as PostHumanMessageAppendHookContext, i as PreHumanMessageAppendHook, j as PreHumanMessageAppendHookContext, R as RunAgentActivity, l as SessionEndHook, m as SessionEndHookContext, n as SessionStartHook, o as SessionStartHookContext, S as SkillProvider, s as SubagentInput, t as SubagentWorkflow } from './types-Dje1TdH6.cjs';
-import { g as SandboxOps } from './types-CDubRtad.cjs';
-export { h as ExecOptions, E as ExecResult, S as Sandbox, c as SandboxCapabilities, d as SandboxCreateOptions, e as SandboxCreateResult, D as SandboxDirentEntry, F as SandboxFileStat, a as SandboxFileSystem, i as SandboxNotFoundError, j as SandboxNotSupportedError, b as SandboxProvider, f as SandboxSnapshot } from './types-CDubRtad.cjs';
+import { k as SessionConfig, Z as ZeitlichSession, T as ThreadOps, f as JsonSerializable, e as AgentStateManager, q as SubagentDefinition, s as SubagentHooks, p as SubagentConfig, t as SubagentSessionInput, r as SubagentHandlerResponse, b as SkillMetadata, c as Skill } from './types-Bh-BbfCp.cjs';
+export { A as AgentResponse, d as AgentState, H as Hooks, J as JsonPrimitive, g as JsonValue, M as ModelInvoker, a as ModelInvokerConfig, P as PostHumanMessageAppendHook, h as PostHumanMessageAppendHookContext, i as PreHumanMessageAppendHook, j as PreHumanMessageAppendHookContext, R as RunAgentActivity, l as SessionEndHook, m as SessionEndHookContext, n as SessionStartHook, o as SessionStartHookContext, S as SkillProvider, u as SubagentWorkflow, v as SubagentWorkflowInput } from './types-Bh-BbfCp.cjs';
+import { g as SandboxOps } from './types-BMRzfELQ.cjs';
+export { h as ExecOptions, E as ExecResult, S as Sandbox, c as SandboxCapabilities, d as SandboxCreateOptions, e as SandboxCreateResult, D as SandboxDirentEntry, F as SandboxFileStat, a as SandboxFileSystem, i as SandboxNotFoundError, j as SandboxNotSupportedError, b as SandboxProvider, f as SandboxSnapshot } from './types-BMRzfELQ.cjs';
 import { a as ToolMap, B as BaseAgentState, N as ToolRouterOptions, J as ToolRouter, R as RouterContext, K as ToolWithHandler, p as ParsedToolCallUnion, G as ToolNames, c as ToolHandlerResponse, E as ToolHandler, W as WorkflowTask, A as ActivityToolHandler } from './types-BMXzv7TN.cjs';
 export { l as AgentConfig, m as AgentFile, h as AgentStatus, n as AppendToolResultFn, C as ContentPart, I as InferToolResults, M as MessageContent, o as ParsedToolCall, q as PostToolUseFailureHook, r as PostToolUseFailureHookContext, d as PostToolUseFailureHookResult, s as PostToolUseHook, t as PostToolUseHookContext, u as PreToolUseHook, v as PreToolUseHookContext, P as PreToolUseHookResult, w as ProcessToolCallsContext, e as RawToolCall, g as RunAgentConfig, x as SerializableToolDefinition, S as SessionExitReason, y as TaskStatus, f as TokenUsage, z as ToolArgs, D as ToolCallResult, k as ToolCallResultUnion, i as ToolDefinition, F as ToolHooks, T as ToolMessageContent, H as ToolResult, j as ToolResultConfig, b as ToolRouterHooks, L as isTerminalStatus } from './types-BMXzv7TN.cjs';
 import z$1, { z } from 'zod';
-import { F as FileEntryMetadata, e as VirtualFileTree, T as TreeMutation, c as FileEntry } from './types-BVP87m_W.cjs';
-export { a as FileResolver, g as VirtualSandboxState } from './types-BVP87m_W.cjs';
+import { F as FileEntryMetadata, f as VirtualFileTree, T as TreeMutation, c as FileEntry } from './queries-DlJ3jE48.cjs';
+export { a as FileResolver, h as VirtualSandboxState, i as filesWithMimeType, j as hasDirectory, k as hasFileWithMimeType } from './queries-DlJ3jE48.cjs';
 import '@temporalio/common';
 import '@temporalio/common/lib/interfaces';
 
@@ -71,6 +71,37 @@ declare function proxyDefaultThreadOps(options?: Parameters<typeof proxyActiviti
  */
 declare function proxySandboxOps(options?: Parameters<typeof proxyActivities>[0]): SandboxOps;
 
+/**
+ * Session config fields derived from a main workflow input, ready to spread
+ * into `createSession`.
+ */
+interface WorkflowSessionInput {
+    /** Thread ID to continue (set from `input.previousThreadId`) */
+    threadId?: string;
+    /** Whether to continue an existing thread (true when `previousThreadId` is present) */
+    continueThread?: boolean;
+    /** Optional sandbox ID forwarded to the session */
+    sandboxId?: string;
+}
+/** Raw workflow input fields that map into `WorkflowSessionInput`. */
+interface WorkflowInput {
+    /** When set, continue this thread instead of starting fresh */
+    previousThreadId?: string;
+    /** Optional sandbox ID to reuse */
+    sandboxId?: string;
+}
+/**
+ * Wraps a main workflow function, translating workflow input fields into
+ * session-compatible fields that can be spread directly into `createSession`.
+ *
+ * The wrapper:
+ * - Accepts a generic typed `input` as first argument
+ * - Accepts optional `workflowInput` ({ previousThreadId, sandboxId }) as second argument
+ * - Derives `threadId` + `continueThread` from `workflowInput.previousThreadId`
+ * - Derives `sandboxId` from `workflowInput.sandboxId`
+ */
+declare function defineWorkflow<TInput, TResult>(fn: (input: TInput, sessionInput: WorkflowSessionInput) => Promise<TResult>): (input: TInput, workflowInput?: WorkflowInput) => Promise<TResult>;
+
 /**
  * Generate a compact, workflow-deterministic identifier.
  *
@@ -182,52 +213,95 @@ type SubagentArgs = {
 };
 
 /**
- * Identity function that provides full type inference for subagent configurations.
- * Verifies the workflow function's input parameters match the configured context,
- * and properly types the lifecycle hooks with Task tool args and inferred result type.
+ * Creates a `SubagentConfig` from a `SubagentDefinition` (returned by `defineSubagentWorkflow`).
+ * Metadata (name, description, resultSchema) is read from the definition — only configure
+ * what's specific to this usage in the parent workflow.
  *
  * @example
  * ```ts
- * // With typed context — workflow must accept { prompt, context }
- * const researcher = defineSubagent({
- *   name: "researcher",
- *   description: "Researches topics",
- *   workflow: researcherWorkflow, // (input: { prompt: string; context: { apiKey: string } }) => Promise<...>
- *   context: { apiKey: "..." },
- *   resultSchema: z.object({ findings: z.string() }),
+ * // Minimal — all metadata comes from the definition
+ * export const researcher = defineSubagent(researcherWorkflow);
+ *
+ * // With parent-specific overrides
+ * export const researcher = defineSubagent(researcherWorkflow, {
+ *   allowThreadContinuation: true,
+ *   sandbox: "own",
  *   hooks: {
- *     onPostExecution: ({ result }) => {
- *       // result is typed as { findings: string }
- *     },
+ *     onPostExecution: ({ result }) => console.log(result),
  *   },
  * });
  *
- * // Without context — workflow only needs { prompt }
- * const writer = defineSubagent({
- *   name: "writer",
- *   description: "Writes content",
- *   workflow: writerWorkflow, // (input: { prompt: string }) => Promise<...>
- *   resultSchema: z.object({ content: z.string() }),
+ * // With typed context
+ * export const researcher = defineSubagent(researcherWorkflow, {
+ *   context: { apiKey: "..." },
  * });
  * ```
  */
-declare function defineSubagent<TResult extends z.ZodType = z.ZodType, TContext extends Record<string, unknown> = Record<string, unknown>>(config: Omit<SubagentConfig<TResult>, "hooks" | "workflow" | "context"> & {
-    workflow: string | ((input: {
-        prompt: string;
-        previousThreadId?: string;
-        context: TContext;
-    }) => Promise<SubagentHandlerResponse<z.infer<TResult> | null>>);
-    context: TContext;
-    hooks?: SubagentHooks<SubagentArgs, z.infer<TResult>>;
-}): SubagentConfig<TResult>;
-declare function defineSubagent<TResult extends z.ZodType = z.ZodType>(config: Omit<SubagentConfig<TResult>, "hooks" | "workflow"> & {
-    workflow: string | ((input: {
-        prompt: string;
-        previousThreadId?: string;
-    }) => Promise<SubagentHandlerResponse<z.infer<TResult> | null>>);
+declare function defineSubagent<TResult extends z.ZodType = z.ZodType, TContext extends Record<string, unknown> = Record<string, unknown>>(definition: SubagentDefinition<TResult, TContext>, overrides?: {
+    context?: TContext;
     hooks?: SubagentHooks<SubagentArgs, z.infer<TResult>>;
+    enabled?: boolean;
+    taskQueue?: string;
+    allowThreadContinuation?: boolean;
+    sandbox?: "inherit" | "own";
 }): SubagentConfig<TResult>;
 
+/**
+ * Defines a subagent workflow with embedded metadata (name, description, resultSchema).
+ * The returned value can be passed directly to `defineSubagent` — no need to repeat
+ * the name, description, or resultSchema in the parent workflow.
+ *
+ * Internally maps `SubagentWorkflowInput` fields to session-compatible `SubagentSessionInput`.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   defineSubagentWorkflow,
+ *   defineSubagent,
+ *   createSession,
+ *   createAgentStateManager,
+ * } from 'zeitlich/workflow';
+ *
+ * // Define once — carries name, description, resultSchema
+ * export const researcherWorkflow = defineSubagentWorkflow(
+ *   {
+ *     name: "researcher",
+ *     description: "Researches topics on the web",
+ *     resultSchema: z.object({ findings: z.string() }),
+ *   },
+ *   async (prompt, sessionInput) => {
+ *     const stateManager = createAgentStateManager({
+ *       initialState: { systemPrompt: "You are a researcher." },
+ *     });
+ *
+ *     const session = await createSession({
+ *       ...sessionInput,
+ *       agentName: "researcher",
+ *       runAgent: runAgentActivity,
+ *       buildContextMessage: () => [{ type: "text", text: prompt }],
+ *     });
+ *
+ *     const { finalMessage, threadId } = await session.runSession({ stateManager });
+ *     return { toolResponse: finalMessage ?? "No response", data: null, threadId };
+ *   },
+ * );
+ *
+ * // Use in parent — only configure what's parent-specific
+ * export const researcher = defineSubagent(researcherWorkflow, {
+ *   hooks: { onPostExecution: ({ result }) => console.log(result) },
+ * });
+ * ```
+ */
+declare function defineSubagentWorkflow<TContext extends Record<string, unknown> = Record<string, unknown>>(config: {
+    name: string;
+    description: string;
+}, fn: (prompt: string, sessionInput: SubagentSessionInput, context: TContext) => Promise<SubagentHandlerResponse<null>>): SubagentDefinition<z.ZodNull, TContext>;
+declare function defineSubagentWorkflow<TResult extends z.ZodType, TContext extends Record<string, unknown> = Record<string, unknown>>(config: {
+    name: string;
+    description: string;
+    resultSchema: TResult;
+}, fn: (prompt: string, sessionInput: SubagentSessionInput, context: TContext) => Promise<SubagentHandlerResponse<z.infer<TResult> | null>>): SubagentDefinition<TResult, TContext>;
+
 /**
  * Apply a list of {@link TreeMutation}s to the `fileTree` stored in a state
  * manager instance, updating it in place and returning the new tree.
@@ -506,4 +580,4 @@ declare const createAskUserQuestionHandler: () => ActivityToolHandler<AskUserQue
     }[];
 }>;
 
-export { ActivityToolHandler, AgentStateManager, type AskUserQuestionArgs, BaseAgentState, type BashArgs, type FileEditArgs, FileEntry, FileEntryMetadata, type FileReadArgs, type FileWriteArgs, type GlobArgs, type GrepArgs, JsonSerializable, ParsedToolCallUnion, type ReadSkillArgs, RouterContext, SandboxOps, SessionConfig, Skill, SkillMetadata, type SubagentArgs, SubagentConfig, SubagentHandlerResponse, SubagentHooks, type TaskCreateArgs, type TaskGetArgs, type TaskListArgs, type TaskUpdateArgs, ThreadOps, ToolHandler, ToolHandlerResponse, ToolMap, ToolNames, ToolRouter, ToolWithHandler, TreeMutation, VirtualFileTree, WorkflowTask, ZeitlichSession, applyVirtualTreeMutations, askUserQuestionTool, bashTool, createAgentStateManager, createAskUserQuestionHandler, createBashToolDescription, createReadSkillHandler, createReadSkillTool, createSession, createTaskCreateHandler, createTaskGetHandler, createTaskListHandler, createTaskUpdateHandler, createToolRouter, defineSubagent, defineTool, editTool, formatVirtualFileTree, getShortId, globTool, grepTool, hasNoOtherToolCalls, parseSkillFile, proxyDefaultThreadOps, proxySandboxOps, readFileTool, taskCreateTool, taskGetTool, taskListTool, taskUpdateTool, writeFileTool };
+export { ActivityToolHandler, AgentStateManager, type AskUserQuestionArgs, BaseAgentState, type BashArgs, type FileEditArgs, FileEntry, FileEntryMetadata, type FileReadArgs, type FileWriteArgs, type GlobArgs, type GrepArgs, JsonSerializable, ParsedToolCallUnion, type ReadSkillArgs, RouterContext, SandboxOps, SessionConfig, Skill, SkillMetadata, type SubagentArgs, SubagentConfig, SubagentDefinition, SubagentHandlerResponse, SubagentHooks, SubagentSessionInput, type TaskCreateArgs, type TaskGetArgs, type TaskListArgs, type TaskUpdateArgs, ThreadOps, ToolHandler, ToolHandlerResponse, ToolMap, ToolNames, ToolRouter, ToolWithHandler, TreeMutation, VirtualFileTree, type WorkflowInput, type WorkflowSessionInput, WorkflowTask, ZeitlichSession, applyVirtualTreeMutations, askUserQuestionTool, bashTool, createAgentStateManager, createAskUserQuestionHandler, createBashToolDescription, createReadSkillHandler, createReadSkillTool, createSession, createTaskCreateHandler, createTaskGetHandler, createTaskListHandler, createTaskUpdateHandler, createToolRouter, defineSubagent, defineSubagentWorkflow, defineTool, defineWorkflow, editTool, formatVirtualFileTree, getShortId, globTool, grepTool, hasNoOtherToolCalls, parseSkillFile, proxyDefaultThreadOps, proxySandboxOps, readFileTool, taskCreateTool, taskGetTool, taskListTool, taskUpdateTool, writeFileTool };

package/dist/workflow.d.ts

@@ -1,13 +1,13 @@
 import { proxyActivities } from '@temporalio/workflow';
-import { k as SessionConfig, Z as ZeitlichSession, T as ThreadOps, f as JsonSerializable, e as AgentStateManager, p as SubagentConfig, q as SubagentHandlerResponse, r as SubagentHooks, b as SkillMetadata, c as Skill } from './types-BWvIYK28.js';
-export { A as AgentResponse, d as AgentState, H as Hooks, J as JsonPrimitive, g as JsonValue, M as ModelInvoker, a as ModelInvokerConfig, P as PostHumanMessageAppendHook, h as PostHumanMessageAppendHookContext, i as PreHumanMessageAppendHook, j as PreHumanMessageAppendHookContext, R as RunAgentActivity, l as SessionEndHook, m as SessionEndHookContext, n as SessionStartHook, o as SessionStartHookContext, S as SkillProvider, s as SubagentInput, t as SubagentWorkflow } from './types-BWvIYK28.js';
-import { g as SandboxOps } from './types-CDubRtad.js';
-export { h as ExecOptions, E as ExecResult, S as Sandbox, c as SandboxCapabilities, d as SandboxCreateOptions, e as SandboxCreateResult, D as SandboxDirentEntry, F as SandboxFileStat, a as SandboxFileSystem, i as SandboxNotFoundError, j as SandboxNotSupportedError, b as SandboxProvider, f as SandboxSnapshot } from './types-CDubRtad.js';
+import { k as SessionConfig, Z as ZeitlichSession, T as ThreadOps, f as JsonSerializable, e as AgentStateManager, q as SubagentDefinition, s as SubagentHooks, p as SubagentConfig, t as SubagentSessionInput, r as SubagentHandlerResponse, b as SkillMetadata, c as Skill } from './types-NkiAxU4t.js';
+export { A as AgentResponse, d as AgentState, H as Hooks, J as JsonPrimitive, g as JsonValue, M as ModelInvoker, a as ModelInvokerConfig, P as PostHumanMessageAppendHook, h as PostHumanMessageAppendHookContext, i as PreHumanMessageAppendHook, j as PreHumanMessageAppendHookContext, R as RunAgentActivity, l as SessionEndHook, m as SessionEndHookContext, n as SessionStartHook, o as SessionStartHookContext, S as SkillProvider, u as SubagentWorkflow, v as SubagentWorkflowInput } from './types-NkiAxU4t.js';
+import { g as SandboxOps } from './types-BMRzfELQ.js';
+export { h as ExecOptions, E as ExecResult, S as Sandbox, c as SandboxCapabilities, d as SandboxCreateOptions, e as SandboxCreateResult, D as SandboxDirentEntry, F as SandboxFileStat, a as SandboxFileSystem, i as SandboxNotFoundError, j as SandboxNotSupportedError, b as SandboxProvider, f as SandboxSnapshot } from './types-BMRzfELQ.js';
 import { a as ToolMap, B as BaseAgentState, N as ToolRouterOptions, J as ToolRouter, R as RouterContext, K as ToolWithHandler, p as ParsedToolCallUnion, G as ToolNames, c as ToolHandlerResponse, E as ToolHandler, W as WorkflowTask, A as ActivityToolHandler } from './types-BMXzv7TN.js';
 export { l as AgentConfig, m as AgentFile, h as AgentStatus, n as AppendToolResultFn, C as ContentPart, I as InferToolResults, M as MessageContent, o as ParsedToolCall, q as PostToolUseFailureHook, r as PostToolUseFailureHookContext, d as PostToolUseFailureHookResult, s as PostToolUseHook, t as PostToolUseHookContext, u as PreToolUseHook, v as PreToolUseHookContext, P as PreToolUseHookResult, w as ProcessToolCallsContext, e as RawToolCall, g as RunAgentConfig, x as SerializableToolDefinition, S as SessionExitReason, y as TaskStatus, f as TokenUsage, z as ToolArgs, D as ToolCallResult, k as ToolCallResultUnion, i as ToolDefinition, F as ToolHooks, T as ToolMessageContent, H as ToolResult, j as ToolResultConfig, b as ToolRouterHooks, L as isTerminalStatus } from './types-BMXzv7TN.js';
 import z$1, { z } from 'zod';
-import { F as FileEntryMetadata, e as VirtualFileTree, T as TreeMutation, c as FileEntry } from './types-CwwgQ_9H.js';
-export { a as FileResolver, g as VirtualSandboxState } from './types-CwwgQ_9H.js';
+import { F as FileEntryMetadata, f as VirtualFileTree, T as TreeMutation, c as FileEntry } from './queries-BlC1I3DK.js';
+export { a as FileResolver, h as VirtualSandboxState, i as filesWithMimeType, j as hasDirectory, k as hasFileWithMimeType } from './queries-BlC1I3DK.js';
 import '@temporalio/common';
 import '@temporalio/common/lib/interfaces';
 
@@ -71,6 +71,37 @@ declare function proxyDefaultThreadOps(options?: Parameters<typeof proxyActiviti
  */
 declare function proxySandboxOps(options?: Parameters<typeof proxyActivities>[0]): SandboxOps;
 
+/**
+ * Session config fields derived from a main workflow input, ready to spread
+ * into `createSession`.
+ */
+interface WorkflowSessionInput {
+    /** Thread ID to continue (set from `input.previousThreadId`) */
+    threadId?: string;
+    /** Whether to continue an existing thread (true when `previousThreadId` is present) */
+    continueThread?: boolean;
+    /** Optional sandbox ID forwarded to the session */
+    sandboxId?: string;
+}
+/** Raw workflow input fields that map into `WorkflowSessionInput`. */
+interface WorkflowInput {
+    /** When set, continue this thread instead of starting fresh */
+    previousThreadId?: string;
+    /** Optional sandbox ID to reuse */
+    sandboxId?: string;
+}
+/**
+ * Wraps a main workflow function, translating workflow input fields into
+ * session-compatible fields that can be spread directly into `createSession`.
+ *
+ * The wrapper:
+ * - Accepts a generic typed `input` as first argument
+ * - Accepts optional `workflowInput` ({ previousThreadId, sandboxId }) as second argument
+ * - Derives `threadId` + `continueThread` from `workflowInput.previousThreadId`
+ * - Derives `sandboxId` from `workflowInput.sandboxId`
+ */
+declare function defineWorkflow<TInput, TResult>(fn: (input: TInput, sessionInput: WorkflowSessionInput) => Promise<TResult>): (input: TInput, workflowInput?: WorkflowInput) => Promise<TResult>;
+
 /**
  * Generate a compact, workflow-deterministic identifier.
  *
@@ -182,52 +213,95 @@ type SubagentArgs = {
 };
 
 /**
- * Identity function that provides full type inference for subagent configurations.
- * Verifies the workflow function's input parameters match the configured context,
- * and properly types the lifecycle hooks with Task tool args and inferred result type.
+ * Creates a `SubagentConfig` from a `SubagentDefinition` (returned by `defineSubagentWorkflow`).
+ * Metadata (name, description, resultSchema) is read from the definition — only configure
+ * what's specific to this usage in the parent workflow.
  *
  * @example
  * ```ts
- * // With typed context — workflow must accept { prompt, context }
- * const researcher = defineSubagent({
- *   name: "researcher",
- *   description: "Researches topics",
- *   workflow: researcherWorkflow, // (input: { prompt: string; context: { apiKey: string } }) => Promise<...>
- *   context: { apiKey: "..." },
- *   resultSchema: z.object({ findings: z.string() }),
+ * // Minimal — all metadata comes from the definition
+ * export const researcher = defineSubagent(researcherWorkflow);
+ *
+ * // With parent-specific overrides
+ * export const researcher = defineSubagent(researcherWorkflow, {
+ *   allowThreadContinuation: true,
+ *   sandbox: "own",
  *   hooks: {
- *     onPostExecution: ({ result }) => {
- *       // result is typed as { findings: string }
- *     },
+ *     onPostExecution: ({ result }) => console.log(result),
  *   },
  * });
  *
- * // Without context — workflow only needs { prompt }
- * const writer = defineSubagent({
- *   name: "writer",
- *   description: "Writes content",
- *   workflow: writerWorkflow, // (input: { prompt: string }) => Promise<...>
- *   resultSchema: z.object({ content: z.string() }),
+ * // With typed context
+ * export const researcher = defineSubagent(researcherWorkflow, {
+ *   context: { apiKey: "..." },
  * });
  * ```
  */
-declare function defineSubagent<TResult extends z.ZodType = z.ZodType, TContext extends Record<string, unknown> = Record<string, unknown>>(config: Omit<SubagentConfig<TResult>, "hooks" | "workflow" | "context"> & {
-    workflow: string | ((input: {
-        prompt: string;
-        previousThreadId?: string;
-        context: TContext;
-    }) => Promise<SubagentHandlerResponse<z.infer<TResult> | null>>);
-    context: TContext;
-    hooks?: SubagentHooks<SubagentArgs, z.infer<TResult>>;
-}): SubagentConfig<TResult>;
-declare function defineSubagent<TResult extends z.ZodType = z.ZodType>(config: Omit<SubagentConfig<TResult>, "hooks" | "workflow"> & {
-    workflow: string | ((input: {
-        prompt: string;
-        previousThreadId?: string;
-    }) => Promise<SubagentHandlerResponse<z.infer<TResult> | null>>);
+declare function defineSubagent<TResult extends z.ZodType = z.ZodType, TContext extends Record<string, unknown> = Record<string, unknown>>(definition: SubagentDefinition<TResult, TContext>, overrides?: {
+    context?: TContext;
     hooks?: SubagentHooks<SubagentArgs, z.infer<TResult>>;
+    enabled?: boolean;
+    taskQueue?: string;
+    allowThreadContinuation?: boolean;
+    sandbox?: "inherit" | "own";
 }): SubagentConfig<TResult>;
 
+/**
+ * Defines a subagent workflow with embedded metadata (name, description, resultSchema).
+ * The returned value can be passed directly to `defineSubagent` — no need to repeat
+ * the name, description, or resultSchema in the parent workflow.
+ *
+ * Internally maps `SubagentWorkflowInput` fields to session-compatible `SubagentSessionInput`.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   defineSubagentWorkflow,
+ *   defineSubagent,
+ *   createSession,
+ *   createAgentStateManager,
+ * } from 'zeitlich/workflow';
+ *
+ * // Define once — carries name, description, resultSchema
+ * export const researcherWorkflow = defineSubagentWorkflow(
+ *   {
+ *     name: "researcher",
+ *     description: "Researches topics on the web",
+ *     resultSchema: z.object({ findings: z.string() }),
+ *   },
+ *   async (prompt, sessionInput) => {
+ *     const stateManager = createAgentStateManager({
+ *       initialState: { systemPrompt: "You are a researcher." },
+ *     });
+ *
+ *     const session = await createSession({
+ *       ...sessionInput,
+ *       agentName: "researcher",
+ *       runAgent: runAgentActivity,
+ *       buildContextMessage: () => [{ type: "text", text: prompt }],
+ *     });
+ *
+ *     const { finalMessage, threadId } = await session.runSession({ stateManager });
+ *     return { toolResponse: finalMessage ?? "No response", data: null, threadId };
+ *   },
+ * );
+ *
+ * // Use in parent — only configure what's parent-specific
+ * export const researcher = defineSubagent(researcherWorkflow, {
+ *   hooks: { onPostExecution: ({ result }) => console.log(result) },
+ * });
+ * ```
+ */
+declare function defineSubagentWorkflow<TContext extends Record<string, unknown> = Record<string, unknown>>(config: {
+    name: string;
+    description: string;
+}, fn: (prompt: string, sessionInput: SubagentSessionInput, context: TContext) => Promise<SubagentHandlerResponse<null>>): SubagentDefinition<z.ZodNull, TContext>;
+declare function defineSubagentWorkflow<TResult extends z.ZodType, TContext extends Record<string, unknown> = Record<string, unknown>>(config: {
+    name: string;
+    description: string;
+    resultSchema: TResult;
+}, fn: (prompt: string, sessionInput: SubagentSessionInput, context: TContext) => Promise<SubagentHandlerResponse<z.infer<TResult> | null>>): SubagentDefinition<TResult, TContext>;
+
 /**
  * Apply a list of {@link TreeMutation}s to the `fileTree` stored in a state
  * manager instance, updating it in place and returning the new tree.
@@ -506,4 +580,4 @@ declare const createAskUserQuestionHandler: () => ActivityToolHandler<AskUserQue
     }[];
 }>;
 
-export { ActivityToolHandler, AgentStateManager, type AskUserQuestionArgs, BaseAgentState, type BashArgs, type FileEditArgs, FileEntry, FileEntryMetadata, type FileReadArgs, type FileWriteArgs, type GlobArgs, type GrepArgs, JsonSerializable, ParsedToolCallUnion, type ReadSkillArgs, RouterContext, SandboxOps, SessionConfig, Skill, SkillMetadata, type SubagentArgs, SubagentConfig, SubagentHandlerResponse, SubagentHooks, type TaskCreateArgs, type TaskGetArgs, type TaskListArgs, type TaskUpdateArgs, ThreadOps, ToolHandler, ToolHandlerResponse, ToolMap, ToolNames, ToolRouter, ToolWithHandler, TreeMutation, VirtualFileTree, WorkflowTask, ZeitlichSession, applyVirtualTreeMutations, askUserQuestionTool, bashTool, createAgentStateManager, createAskUserQuestionHandler, createBashToolDescription, createReadSkillHandler, createReadSkillTool, createSession, createTaskCreateHandler, createTaskGetHandler, createTaskListHandler, createTaskUpdateHandler, createToolRouter, defineSubagent, defineTool, editTool, formatVirtualFileTree, getShortId, globTool, grepTool, hasNoOtherToolCalls, parseSkillFile, proxyDefaultThreadOps, proxySandboxOps, readFileTool, taskCreateTool, taskGetTool, taskListTool, taskUpdateTool, writeFileTool };
+export { ActivityToolHandler, AgentStateManager, type AskUserQuestionArgs, BaseAgentState, type BashArgs, type FileEditArgs, FileEntry, FileEntryMetadata, type FileReadArgs, type FileWriteArgs, type GlobArgs, type GrepArgs, JsonSerializable, ParsedToolCallUnion, type ReadSkillArgs, RouterContext, SandboxOps, SessionConfig, Skill, SkillMetadata, type SubagentArgs, SubagentConfig, SubagentDefinition, SubagentHandlerResponse, SubagentHooks, SubagentSessionInput, type TaskCreateArgs, type TaskGetArgs, type TaskListArgs, type TaskUpdateArgs, ThreadOps, ToolHandler, ToolHandlerResponse, ToolMap, ToolNames, ToolRouter, ToolWithHandler, TreeMutation, VirtualFileTree, type WorkflowInput, type WorkflowSessionInput, WorkflowTask, ZeitlichSession, applyVirtualTreeMutations, askUserQuestionTool, bashTool, createAgentStateManager, createAskUserQuestionHandler, createBashToolDescription, createReadSkillHandler, createReadSkillTool, createSession, createTaskCreateHandler, createTaskGetHandler, createTaskListHandler, createTaskUpdateHandler, createToolRouter, defineSubagent, defineSubagentWorkflow, defineTool, defineWorkflow, editTool, formatVirtualFileTree, getShortId, globTool, grepTool, hasNoOtherToolCalls, parseSkillFile, proxyDefaultThreadOps, proxySandboxOps, readFileTool, taskCreateTool, taskGetTool, taskListTool, taskUpdateTool, writeFileTool };

package/dist/workflow.js

@@ -330,15 +330,15 @@ function createSubagentHandler(subagents) {
     const childWorkflowId = `${args.subagent}-${getShortId()}`;
     const { sandboxId: parentSandboxId } = context;
     const inheritSandbox = config.sandbox !== "own" && !!parentSandboxId;
-    const input = {
-      prompt: args.prompt,
-      ...config.context && { context: config.context },
-      ...args.threadId && args.threadId !== null && config.allowThreadContinuation && { previousThreadId: args.threadId },
+    const workflowInput = {
+      ...args.threadId && args.threadId !== null && config.allowThreadContinuation && {
+        previousThreadId: args.threadId
+      },
       ...inheritSandbox && { sandboxId: parentSandboxId }
     };
     const childOpts = {
       workflowId: childWorkflowId,
-      args: [input],
+      args: config.context === void 0 ? [args.prompt, workflowInput] : [args.prompt, workflowInput, config.context],
       taskQueue: config.taskQueue ?? parentTaskQueue
     };
     const {
@@ -553,9 +553,7 @@ var createSession = async ({
         const result = await sandboxOps.createSandbox({ id: threadId });
         sandboxId = result.sandboxId;
         if (result.stateUpdate) {
-          stateManager.mergeUpdate(
-            result.stateUpdate
-          );
+          stateManager.mergeUpdate(result.stateUpdate);
         }
       }
       if (hooks.onSessionStart) {
@@ -640,6 +638,7 @@ var createSession = async ({
             );
             if (!conditionMet) {
               stateManager.cancel();
+              exitReason = "cancelled";
               await condition(() => false, "2s");
               break;
             }
@@ -693,6 +692,20 @@ function proxySandboxOps(options) {
   );
 }
 
+// src/lib/workflow.ts
+function defineWorkflow(fn) {
+  return async (input, workflowInput = {}) => {
+    const sessionInput = {
+      ...workflowInput.previousThreadId && {
+        threadId: workflowInput.previousThreadId,
+        continueThread: true
+      },
+      ...workflowInput.sandboxId && { sandboxId: workflowInput.sandboxId }
+    };
+    return fn(input, sessionInput);
+  };
+}
+
 // src/lib/types.ts
 function isTerminalStatus(status) {
   return status === "COMPLETED" || status === "FAILED" || status === "CANCELLED";
@@ -855,8 +868,40 @@ function createAgentStateManager({
 }
 
 // src/lib/subagent/define.ts
-function defineSubagent(config) {
-  return config;
+function defineSubagent(definition, overrides) {
+  return {
+    agentName: definition.agentName,
+    description: definition.description,
+    workflow: definition,
+    ...definition.resultSchema !== void 0 && {
+      resultSchema: definition.resultSchema
+    },
+    ...overrides
+  };
+}
+
+// src/lib/subagent/workflow.ts
+function defineSubagentWorkflow(config, fn) {
+  const workflow = async (prompt, workflowInput, context) => {
+    const sessionInput = {
+      agentName: config.name,
+      ...workflowInput.previousThreadId && {
+        threadId: workflowInput.previousThreadId,
+        continueThread: true
+      },
+      ...workflowInput.sandboxId && { sandboxId: workflowInput.sandboxId }
+    };
+    return fn(prompt, sessionInput, context ?? {});
+  };
+  Object.defineProperty(workflow, "name", { value: config.name });
+  return Object.assign(workflow, {
+    agentName: config.name,
+    description: config.description,
+    ...config.resultSchema !== void 0 && {
+      resultSchema: config.resultSchema
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  });
 }
 var SandboxNotSupportedError = class extends ApplicationFailure$1 {
   constructor(operation) {
@@ -943,6 +988,48 @@ function formatVirtualFileTree(entries, opts = {}) {
   return "/" + printNode(root, "", sort);
 }
 
+// src/adapters/sandbox/virtual/queries.ts
+function hasFileWithMimeType(stateManager, pattern) {
+  const tree = stateManager.get("fileTree");
+  const matchers = (Array.isArray(pattern) ? pattern : [pattern]).map(buildMatcher);
+  return tree.some((entry) => {
+    const meta = entry.metadata;
+    const mime = meta?.mimeType;
+    return typeof mime === "string" && matchers.some((m) => m(mime));
+  });
+}
+function filesWithMimeType(stateManager, pattern) {
+  const tree = stateManager.get("fileTree");
+  const match = buildMatcher(pattern);
+  return tree.filter((entry) => {
+    const meta = entry.metadata;
+    const mime = meta?.mimeType;
+    return typeof mime === "string" && match(mime);
+  });
+}
+function hasDirectory(stateManager, pattern) {
+  const tree = stateManager.get("fileTree");
+  const match = buildGlobMatcher(pattern);
+  return tree.some((entry) => {
+    const segments = entry.path.split("/").filter(Boolean);
+    return segments.slice(0, -1).some(match);
+  });
+}
+function buildMatcher(pattern) {
+  if (pattern.endsWith("/*")) {
+    const prefix = pattern.slice(0, -1);
+    return (v) => v.startsWith(prefix);
+  }
+  return (v) => v === pattern;
+}
+function buildGlobMatcher(pattern) {
+  if (!pattern.includes("*")) return (v) => v === pattern;
+  const re = new RegExp(
+    "^" + pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*") + "$"
+  );
+  return (v) => re.test(v);
+}
+
 // src/lib/skills/parse.ts
 function parseSkillFile(raw) {
   const trimmed = raw.replace(/^\uFEFF/, "");
@@ -1365,6 +1452,6 @@ var createAskUserQuestionHandler = () => async (args) => {
   };
 };
 
-export { SandboxNotFoundError, SandboxNotSupportedError, applyVirtualTreeMutations, askUserQuestionTool, bashTool, createAgentStateManager, createAskUserQuestionHandler, createBashToolDescription, createReadSkillHandler, createReadSkillTool, createSession, createTaskCreateHandler, createTaskGetHandler, createTaskListHandler, createTaskUpdateHandler, createToolRouter, defineSubagent, defineTool, editTool, formatVirtualFileTree, getShortId, globTool, grepTool, hasNoOtherToolCalls, isTerminalStatus, parseSkillFile, proxyDefaultThreadOps, proxySandboxOps, readFileTool, taskCreateTool, taskGetTool, taskListTool, taskUpdateTool, writeFileTool };
+export { SandboxNotFoundError, SandboxNotSupportedError, applyVirtualTreeMutations, askUserQuestionTool, bashTool, createAgentStateManager, createAskUserQuestionHandler, createBashToolDescription, createReadSkillHandler, createReadSkillTool, createSession, createTaskCreateHandler, createTaskGetHandler, createTaskListHandler, createTaskUpdateHandler, createToolRouter, defineSubagent, defineSubagentWorkflow, defineTool, defineWorkflow, editTool, filesWithMimeType, formatVirtualFileTree, getShortId, globTool, grepTool, hasDirectory, hasFileWithMimeType, hasNoOtherToolCalls, isTerminalStatus, parseSkillFile, proxyDefaultThreadOps, proxySandboxOps, readFileTool, taskCreateTool, taskGetTool, taskListTool, taskUpdateTool, writeFileTool };
 //# sourceMappingURL=workflow.js.map
 //# sourceMappingURL=workflow.js.map