zeitlich 0.2.16 → 0.2.17

package/dist/{types-BSOte_8s.d.ts → queries-BlC1I3DK.d.ts}

@@ -122,4 +122,45 @@ interface VirtualSandboxContext<TCtx = unknown, TMeta = FileEntryMetadata> exten
     sandbox: VirtualSandbox<TCtx, TMeta>;
 }
 
-export { type FileEntryMetadata as F, type TreeMutation as T, type VirtualSandboxCreateOptions as V, type FileResolver as a, type VirtualSandboxContext as b, type FileEntry as c, type VirtualSandbox as d, type VirtualFileTree as e, VirtualSandboxFileSystem as f, type VirtualSandboxState as g };
+/**
+ * Structural constraint: accepts any `AgentStateManager<T>` whose custom
+ * state includes `fileTree: FileEntry<TMeta>[]`.
+ */
+interface FileTreeAccessor<TMeta> {
+    get(key: "fileTree"): FileEntry<TMeta>[];
+}
+/**
+ * Check whether any file in the tree has a `metadata.mimeType` that matches
+ * the given pattern.
+ *
+ * Patterns:
+ * - Exact: `"application/pdf"`
+ * - Wildcard type: `"image/*"`
+ *
+ * Useful for conditionally enabling tools:
+ *
+ * ```ts
+ * { enabled: hasFileWithMimeType(stateManager, "image/*") }
+ * { enabled: hasFileWithMimeType(stateManager, ["image/*", "application/pdf"]) }
+ * ```
+ */
+declare function hasFileWithMimeType<TMeta>(stateManager: FileTreeAccessor<TMeta>, pattern: string | string[]): boolean;
+/**
+ * Return all entries whose `metadata.mimeType` matches the given pattern.
+ */
+declare function filesWithMimeType<TMeta>(stateManager: FileTreeAccessor<TMeta>, pattern: string): FileEntry<TMeta>[];
+/**
+ * Check whether the tree contains a directory whose name matches the given
+ * pattern. Directories are inferred from file paths.
+ *
+ * Patterns:
+ * - Exact: `"src"`
+ * - Glob with `*` wildcard: `"test*"`, `"*.generated"`
+ *
+ * ```ts
+ * { enabled: hasDirectory(stateManager, "test*") }
+ * ```
+ */
+declare function hasDirectory<TMeta>(stateManager: FileTreeAccessor<TMeta>, pattern: string): boolean;
+
+export { type FileEntryMetadata as F, type TreeMutation as T, type VirtualSandboxCreateOptions as V, type FileResolver as a, type VirtualSandboxContext as b, type FileEntry as c, type VirtualSandbox as d, type FileTreeAccessor as e, type VirtualFileTree as f, VirtualSandboxFileSystem as g, type VirtualSandboxState as h, filesWithMimeType as i, hasDirectory as j, hasFileWithMimeType as k };

package/dist/{types-DCi2qXjN.d.cts → queries-DlJ3jE48.d.cts}

@@ -122,4 +122,45 @@ interface VirtualSandboxContext<TCtx = unknown, TMeta = FileEntryMetadata> exten
     sandbox: VirtualSandbox<TCtx, TMeta>;
 }
 
-export { type FileEntryMetadata as F, type TreeMutation as T, type VirtualSandboxCreateOptions as V, type FileResolver as a, type VirtualSandboxContext as b, type FileEntry as c, type VirtualSandbox as d, type VirtualFileTree as e, VirtualSandboxFileSystem as f, type VirtualSandboxState as g };
+/**
+ * Structural constraint: accepts any `AgentStateManager<T>` whose custom
+ * state includes `fileTree: FileEntry<TMeta>[]`.
+ */
+interface FileTreeAccessor<TMeta> {
+    get(key: "fileTree"): FileEntry<TMeta>[];
+}
+/**
+ * Check whether any file in the tree has a `metadata.mimeType` that matches
+ * the given pattern.
+ *
+ * Patterns:
+ * - Exact: `"application/pdf"`
+ * - Wildcard type: `"image/*"`
+ *
+ * Useful for conditionally enabling tools:
+ *
+ * ```ts
+ * { enabled: hasFileWithMimeType(stateManager, "image/*") }
+ * { enabled: hasFileWithMimeType(stateManager, ["image/*", "application/pdf"]) }
+ * ```
+ */
+declare function hasFileWithMimeType<TMeta>(stateManager: FileTreeAccessor<TMeta>, pattern: string | string[]): boolean;
+/**
+ * Return all entries whose `metadata.mimeType` matches the given pattern.
+ */
+declare function filesWithMimeType<TMeta>(stateManager: FileTreeAccessor<TMeta>, pattern: string): FileEntry<TMeta>[];
+/**
+ * Check whether the tree contains a directory whose name matches the given
+ * pattern. Directories are inferred from file paths.
+ *
+ * Patterns:
+ * - Exact: `"src"`
+ * - Glob with `*` wildcard: `"test*"`, `"*.generated"`
+ *
+ * ```ts
+ * { enabled: hasDirectory(stateManager, "test*") }
+ * ```
+ */
+declare function hasDirectory<TMeta>(stateManager: FileTreeAccessor<TMeta>, pattern: string): boolean;
+
+export { type FileEntryMetadata as F, type TreeMutation as T, type VirtualSandboxCreateOptions as V, type FileResolver as a, type VirtualSandboxContext as b, type FileEntry as c, type VirtualSandbox as d, type FileTreeAccessor as e, type VirtualFileTree as f, VirtualSandboxFileSystem as g, type VirtualSandboxState as h, filesWithMimeType as i, hasDirectory as j, hasFileWithMimeType as k };

package/dist/{types-Drli9aCK.d.cts → types-Bh-BbfCp.d.cts}

@@ -73,7 +73,26 @@ interface Hooks<T extends ToolMap, TResult = unknown> extends ToolRouterHooks<T,
 type SubagentHandlerResponse<TResult = null> = ToolHandlerResponse<TResult> & {
     threadId: string;
 };
-type SubagentWorkflow<TResult extends z.ZodType = z.ZodType> = (input: SubagentInput) => Promise<SubagentHandlerResponse<z.infer<TResult> | null>>;
+/**
+ * Raw workflow input fields passed from parent to child workflow.
+ * `defineSubagentWorkflow` maps this into `SubagentSessionInput`.
+ */
+interface SubagentWorkflowInput {
+    /** Thread ID from parent for continuation */
+    previousThreadId?: string;
+    /** Sandbox ID inherited from parent */
+    sandboxId?: string;
+}
+type SubagentWorkflow<TResult extends z.ZodType = z.ZodType> = (prompt: string, workflowInput: SubagentWorkflowInput, context?: Record<string, unknown>) => Promise<SubagentHandlerResponse<z.infer<TResult> | null>>;
+/**
+ * A subagent workflow with embedded metadata (name, description, resultSchema).
+ * Created by `defineSubagentWorkflow` — pass directly to `defineSubagent`.
+ */
+type SubagentDefinition<TResult extends z.ZodType = z.ZodType, TContext extends Record<string, unknown> = Record<string, unknown>> = ((prompt: string, workflowInput: SubagentWorkflowInput, context?: TContext) => Promise<SubagentHandlerResponse<z.infer<TResult> | null>>) & {
+    readonly agentName: string;
+    readonly description: string;
+    readonly resultSchema?: TResult;
+};
 /**
  * Configuration for a subagent that can be spawned by the parent workflow.
  *
@@ -133,16 +152,16 @@ interface SubagentHooks<TArgs = unknown, TResult = unknown> {
     }) => PostToolUseFailureHookResult | Promise<PostToolUseFailureHookResult>;
 }
 /**
- * Input passed to child workflows when spawned as subagents
+ * Session config fields passed from parent to child workflow.
  */
-interface SubagentInput {
-    /** The prompt/task from the parent agent */
-    prompt: string;
-    /** Optional context parameters passed from the parent agent */
-    context?: Record<string, unknown>;
-    /** When set, the subagent should continue this thread instead of starting a new one */
-    previousThreadId?: string;
-    /** Sandbox ID inherited from the parent agent (when SubagentConfig.sandbox is 'inherit') */
+interface SubagentSessionInput {
+    /** Agent name — spread directly into `createSession` */
+    agentName: string;
+    /** Thread ID to continue from */
+    threadId?: string;
+    /** Whether to continue an existing thread */
+    continueThread?: boolean;
+    /** Sandbox ID inherited from the parent agent */
     sandboxId?: string;
 }
 
@@ -388,4 +407,4 @@ interface ZeitlichSession<M = unknown> {
     }>;
 }
 
-export type { AgentResponse as A, Hooks as H, JsonPrimitive as J, ModelInvoker as M, PostHumanMessageAppendHook as P, RunAgentActivity as R, SkillProvider as S, ThreadOps as T, ZeitlichSession as Z, ModelInvokerConfig as a, SkillMetadata as b, Skill as c, AgentState as d, AgentStateManager as e, JsonSerializable as f, JsonValue as g, PostHumanMessageAppendHookContext as h, PreHumanMessageAppendHook as i, PreHumanMessageAppendHookContext as j, SessionConfig as k, SessionEndHook as l, SessionEndHookContext as m, SessionStartHook as n, SessionStartHookContext as o, SubagentConfig as p, SubagentHandlerResponse as q, SubagentHooks as r, SubagentInput as s, SubagentWorkflow as t };
+export type { AgentResponse as A, Hooks as H, JsonPrimitive as J, ModelInvoker as M, PostHumanMessageAppendHook as P, RunAgentActivity as R, SkillProvider as S, ThreadOps as T, ZeitlichSession as Z, ModelInvokerConfig as a, SkillMetadata as b, Skill as c, AgentState as d, AgentStateManager as e, JsonSerializable as f, JsonValue as g, PostHumanMessageAppendHookContext as h, PreHumanMessageAppendHook as i, PreHumanMessageAppendHookContext as j, SessionConfig as k, SessionEndHook as l, SessionEndHookContext as m, SessionStartHook as n, SessionStartHookContext as o, SubagentConfig as p, SubagentDefinition as q, SubagentHandlerResponse as r, SubagentHooks as s, SubagentSessionInput as t, SubagentWorkflow as u, SubagentWorkflowInput as v };

package/dist/{types-XPtivmSJ.d.ts → types-NkiAxU4t.d.ts}

@@ -73,7 +73,26 @@ interface Hooks<T extends ToolMap, TResult = unknown> extends ToolRouterHooks<T,
 type SubagentHandlerResponse<TResult = null> = ToolHandlerResponse<TResult> & {
     threadId: string;
 };
-type SubagentWorkflow<TResult extends z.ZodType = z.ZodType> = (input: SubagentInput) => Promise<SubagentHandlerResponse<z.infer<TResult> | null>>;
+/**
+ * Raw workflow input fields passed from parent to child workflow.
+ * `defineSubagentWorkflow` maps this into `SubagentSessionInput`.
+ */
+interface SubagentWorkflowInput {
+    /** Thread ID from parent for continuation */
+    previousThreadId?: string;
+    /** Sandbox ID inherited from parent */
+    sandboxId?: string;
+}
+type SubagentWorkflow<TResult extends z.ZodType = z.ZodType> = (prompt: string, workflowInput: SubagentWorkflowInput, context?: Record<string, unknown>) => Promise<SubagentHandlerResponse<z.infer<TResult> | null>>;
+/**
+ * A subagent workflow with embedded metadata (name, description, resultSchema).
+ * Created by `defineSubagentWorkflow` — pass directly to `defineSubagent`.
+ */
+type SubagentDefinition<TResult extends z.ZodType = z.ZodType, TContext extends Record<string, unknown> = Record<string, unknown>> = ((prompt: string, workflowInput: SubagentWorkflowInput, context?: TContext) => Promise<SubagentHandlerResponse<z.infer<TResult> | null>>) & {
+    readonly agentName: string;
+    readonly description: string;
+    readonly resultSchema?: TResult;
+};
 /**
  * Configuration for a subagent that can be spawned by the parent workflow.
  *
@@ -133,16 +152,16 @@ interface SubagentHooks<TArgs = unknown, TResult = unknown> {
     }) => PostToolUseFailureHookResult | Promise<PostToolUseFailureHookResult>;
 }
 /**
- * Input passed to child workflows when spawned as subagents
+ * Session config fields passed from parent to child workflow.
  */
-interface SubagentInput {
-    /** The prompt/task from the parent agent */
-    prompt: string;
-    /** Optional context parameters passed from the parent agent */
-    context?: Record<string, unknown>;
-    /** When set, the subagent should continue this thread instead of starting a new one */
-    previousThreadId?: string;
-    /** Sandbox ID inherited from the parent agent (when SubagentConfig.sandbox is 'inherit') */
+interface SubagentSessionInput {
+    /** Agent name — spread directly into `createSession` */
+    agentName: string;
+    /** Thread ID to continue from */
+    threadId?: string;
+    /** Whether to continue an existing thread */
+    continueThread?: boolean;
+    /** Sandbox ID inherited from the parent agent */
     sandboxId?: string;
 }
 
@@ -388,4 +407,4 @@ interface ZeitlichSession<M = unknown> {
     }>;
 }
 
-export type { AgentResponse as A, Hooks as H, JsonPrimitive as J, ModelInvoker as M, PostHumanMessageAppendHook as P, RunAgentActivity as R, SkillProvider as S, ThreadOps as T, ZeitlichSession as Z, ModelInvokerConfig as a, SkillMetadata as b, Skill as c, AgentState as d, AgentStateManager as e, JsonSerializable as f, JsonValue as g, PostHumanMessageAppendHookContext as h, PreHumanMessageAppendHook as i, PreHumanMessageAppendHookContext as j, SessionConfig as k, SessionEndHook as l, SessionEndHookContext as m, SessionStartHook as n, SessionStartHookContext as o, SubagentConfig as p, SubagentHandlerResponse as q, SubagentHooks as r, SubagentInput as s, SubagentWorkflow as t };
+export type { AgentResponse as A, Hooks as H, JsonPrimitive as J, ModelInvoker as M, PostHumanMessageAppendHook as P, RunAgentActivity as R, SkillProvider as S, ThreadOps as T, ZeitlichSession as Z, ModelInvokerConfig as a, SkillMetadata as b, Skill as c, AgentState as d, AgentStateManager as e, JsonSerializable as f, JsonValue as g, PostHumanMessageAppendHookContext as h, PreHumanMessageAppendHook as i, PreHumanMessageAppendHookContext as j, SessionConfig as k, SessionEndHook as l, SessionEndHookContext as m, SessionStartHook as n, SessionStartHookContext as o, SubagentConfig as p, SubagentDefinition as q, SubagentHandlerResponse as r, SubagentHooks as s, SubagentSessionInput as t, SubagentWorkflow as u, SubagentWorkflowInput as v };

package/dist/workflow.cjs

@@ -336,15 +336,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 {
@@ -698,6 +698,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";
@@ -860,8 +874,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 common.ApplicationFailure {
   constructor(operation) {
@@ -948,6 +994,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/, "");
@@ -1387,12 +1475,17 @@ exports.createTaskListHandler = createTaskListHandler;
 exports.createTaskUpdateHandler = createTaskUpdateHandler;
 exports.createToolRouter = createToolRouter;
 exports.defineSubagent = defineSubagent;
+exports.defineSubagentWorkflow = defineSubagentWorkflow;
 exports.defineTool = defineTool;
+exports.defineWorkflow = defineWorkflow;
 exports.editTool = editTool;
+exports.filesWithMimeType = filesWithMimeType;
 exports.formatVirtualFileTree = formatVirtualFileTree;
 exports.getShortId = getShortId;
 exports.globTool = globTool;
 exports.grepTool = grepTool;
+exports.hasDirectory = hasDirectory;
+exports.hasFileWithMimeType = hasFileWithMimeType;
 exports.hasNoOtherToolCalls = hasNoOtherToolCalls;
 exports.isTerminalStatus = isTerminalStatus;
 exports.parseSkillFile = parseSkillFile;