deepagents 1.13.1 → 1.13.3

package/dist/{agent-D50BBbJT.d.ts → agent-CVBXKZAu.d.ts}

@@ -4,6 +4,7 @@ import * as _langgraph from "@langchain/langgraph";
 import { AnnotationRoot, AnyStateSchema, Command, ReducedValue, StateDefinitionInit, StateSchema, StreamTransformer } from "@langchain/langgraph";
 import { z } from "zod/v4";
 import * as _messages from "@langchain/core/messages";
+import { SystemMessage as SystemMessage$1 } from "@langchain/core/messages";
 import * as z$2 from "zod";
 import { z as z$1 } from "zod";
 import { Client } from "@langchain/langgraph-sdk";
@@ -357,6 +358,23 @@ interface ReadResult {
   content?: string | Uint8Array;
   /** MIME type of the file, when available */
   mimeType?: string;
+  /**
+   * Total number of logical source lines for a text read, when known.
+   * Omitted for binary reads and for backends that cannot determine it.
+   */
+  totalLines?: number;
+  /**
+   * 1-indexed first source line represented by `content`.
+   * Text pagination fields are optional so older/custom backends remain valid.
+   */
+  startLine?: number;
+  /** 1-indexed last source line represented by `content`. */
+  endLine?: number;
+  /**
+   * 0-indexed offset of the next unread source line.
+   * Omitted when the returned text reaches EOF.
+   */
+  nextOffset?: number;
 }
 /**
  * Structured result from backend readRaw operations.
@@ -1188,11 +1206,13 @@ interface HarnessProfileOptions {
    */
   toolDescriptionOverrides?: Record<string, string>;
   /**
-   * Tool names to remove from the agent's visible tool set.
+   * Tool names to remove from the agent's visible tool set and reject at the
+   * tool-call boundary.
    *
-   * Applied via a filtering middleware after all tool-injecting
-   * middleware have run, so it catches both user-provided and
-   * middleware-provided tools.
+   * Applied via middleware after all tool-injecting middleware have run, so it
+   * catches both user-provided and middleware-provided tools. Each declarative
+   * subagent uses the profile resolved for its own model. Exclusions are
+   * model-facing calibration, not a security boundary.
    *
    * @default [] (no tools excluded)
    */
@@ -1266,11 +1286,13 @@ interface HarnessProfile {
    */
   toolDescriptionOverrides: Record<string, string>;
   /**
-   * Tool names to remove from the agent's visible tool set.
+   * Tool names to remove from the agent's visible tool set and reject at the
+   * tool-call boundary.
    *
-   * Applied via a filtering middleware after all tool-injecting
-   * middleware have run, so it catches both user-provided and
-   * middleware-provided tools.
+   * Applied via middleware after all tool-injecting middleware have run, so it
+   * catches both user-provided and middleware-provided tools. Each declarative
+   * subagent uses the profile resolved for its own model. Exclusions are
+   * model-facing calibration, not a security boundary.
    */
   excludedTools: Set<string>;
   /**
@@ -1494,31 +1516,55 @@ interface CompiledSubAgent<TRunnable extends ReactAgent<any> | Runnable = ReactA
   /**
    * Context mode. `"fork"` inherits the parent's conversation history
    * (but not its system prompt — that's baked into the runnable).
-   * `"handoff"` (default) is fully isolated.
+   * `"isolated"` (default) only sees the delegated task.
    */
-  mode?: "handoff" | "fork";
+  mode?: "isolated" | "fork";
 }
 /**
- * Fields shared by both {@link SubAgent} and {@link ForkedSubAgent}.
+ * Specification for a declarative subagent.
  *
- * @internal
+ * When using `createDeepAgent`, subagents automatically receive a default middleware
+ * stack (filesystemMiddleware, summarizationMiddleware, etc.) before any custom
+ * `middleware` specified in this spec. Add `todoListMiddleware` explicitly to opt in.
+ *
+ * By default the subagent is isolated — it only ever sees the delegated task
+ * description, never the parent's conversation. Setting `mode: "fork"` makes
+ * it continue the parent's conversation instead.
+ *
+ * @example
+ * ```typescript
+ * const researcher: SubAgent = {
+ *   name: "researcher",
+ *   description: "Research assistant for complex topics",
+ *   systemPrompt: "You are a research assistant.",
+ *   tools: [webSearchTool],
+ *   skills: ["/skills/research/"],
+ * };
+ * ```
+ *
+ * @experimental `mode: "fork"` is experimental and subject to change.
  */
-interface SubAgentBase {
+interface SubAgent {
   /** Identifier used to select this subagent in the task tool */
   name: string;
   /** Description shown to the model for subagent selection */
   description: string;
   /**
-   * The system prompt for the agent. Optional on {@link SubAgent} (falls
-   * back to an empty prompt if omitted); forbidden on {@link ForkedSubAgent},
-   * which always inherits the parent's instead.
+   * The system prompt for the agent. Falls back to an empty prompt if
+   * omitted. Under `mode: "fork"`, this is appended to the parent's
+   * inherited prompt rather than replacing it.
    */
   systemPrompt?: string | SystemMessage;
   /**
-   * Context mode. `"handoff"` (default) is fully isolated. `"fork"` inherits
-   * the parent's conversation history and system prompt.
+   * Context mode. `"isolated"` (default) only sees the delegated task.
+   * `"fork"` inherits the parent's conversation history and mirrors the
+   * parent's prompt-producing middleware (skills, memory, custom middleware)
+   * so it rebuilds an equivalent system prompt — the tradeoff is cache
+   * misses if this subagent's own `model` differs from the parent's. Cannot
+   * declare `skills` under `mode: "fork"`; the parent's skills are inherited
+   * instead.
    */
-  mode?: "handoff" | "fork";
+  mode?: "isolated" | "fork";
   /** The tools to use for the agent (tool instances, not names). Defaults to defaultTools */
   tools?: StructuredTool[];
   /** The model for the agent. Defaults to defaultModel */
@@ -1597,67 +1643,14 @@ interface SubAgentBase {
   permissions?: FilesystemPermission[];
 }
 /**
- * Specification for a subagent that can be dynamically created.
- *
- * When using `createDeepAgent`, subagents automatically receive a default middleware
- * stack (filesystemMiddleware, summarizationMiddleware, etc.) before any custom
- * `middleware` specified in this spec. Add `todoListMiddleware` explicitly to opt in.
- *
- * Always fully isolated — this subagent only ever sees the task description,
- * never the parent's conversation. Use {@link ForkedSubAgent} to inherit the
- * parent's history and system prompt instead.
- *
- * @example
- * ```typescript
- * const researcher: SubAgent = {
- *   name: "researcher",
- *   description: "Research assistant for complex topics",
- *   systemPrompt: "You are a research assistant.",
- *   tools: [webSearchTool],
- *   skills: ["/skills/research/"],
- * };
- * ```
- */
-interface SubAgent extends SubAgentBase {
-  /** The system prompt to use for the agent */
-  systemPrompt?: string | SystemMessage;
-  /**
-   * Context mode. `"handoff"` (default) is fully isolated. `"fork"` inherits
-   * the parent's conversation history and system prompt.
-   */
-  mode?: "handoff";
-}
-/**
- * Specification for a subagent that inherits the parent's conversation
- * instead of starting from just the task description.
- *
- * Always forks: it inherits the parent's full message history and its exact
- * system prompt (there's no own prompt to fall back to). Mirrored middleware
- * is only added when its model matches the parent's, since that's the only
- * case with a cache benefit to protect. Deliberately has no `systemPrompt`
- * of its own: since its system slot always carries the parent's prompt,
- * there's nothing of its own to put there. If you need a subagent with a
- * distinguishing system prompt, use {@link SubAgent} without forking instead.
- *
- * @example
- * ```typescript
- * const researcher: ForkedSubAgent = {
- *   name: "researcher",
- *   description: "Continues the current investigation with full context",
- *   mode: "fork",
- *   tools: [webSearchTool],
- * };
- * ```
+ * A {@link SubAgent} with `mode: "fork"`.
  *
- * @experimental Forking subagents is experimental and subject to change
+ * @deprecated Kept as a named type for backward compatibility with code that imported
+ * `ForkedSubAgent` before it merged into `SubAgent` — not a distinct shape
+ * with its own constraints (a fork can now declare its own `systemPrompt`,
+ * same as any `SubAgent`). Prefer `SubAgent` with `mode: "fork"` in new code.
  */
-interface ForkedSubAgent extends SubAgentBase {
-  /** A ForkedSubAgent never has its own system prompt — always the parent's. */
-  systemPrompt?: undefined;
-  /**
-   * Always `"fork"`. Required (not defaulted) so this can't structurally
-   * collapse into a plain `SubAgent` — see `isForkedSubAgent` below.
-   */
+interface ForkedSubAgent extends SubAgent {
   mode: "fork";
 }
 /**
@@ -1701,7 +1694,7 @@ declare const GENERAL_PURPOSE_SUBAGENT: {
   readonly name: "general-purpose";
   readonly description: "General-purpose agent for researching complex questions, searching for files and content, and executing multi-step tasks. When you are searching for a keyword or file and are not confident that you will find the right match in the first few tries use this agent to perform the search for you. This agent has access to all tools as the main agent.";
   readonly systemPrompt: "In order to complete the objective that the user asks of you, you have access to a number of standard tools.";
-  readonly mode: "handoff";
+  readonly mode: "isolated";
 };
 /**
  * Create a runnable agent from a declarative `SubAgent` spec.
@@ -1737,14 +1730,14 @@ interface SubAgentMiddlewareOptions {
   /** The tool configs for the default general-purpose subagent */
   defaultInterruptOn?: Record<string, boolean | InterruptOnConfig> | null;
   /** A list of additional subagents to provide to the agent */
-  subagents?: (SubAgent | CompiledSubAgent | ForkedSubAgent)[];
+  subagents?: (SubAgent | CompiledSubAgent)[];
   /** Full system prompt override */
   systemPrompt?: string | null;
   /** Whether to include the general-purpose agent */
   generalPurposeAgent?: boolean;
   /** Custom description for the task tool */
   taskDescription?: string | null;
-  /** Inherited by `ForkedSubAgent`s and `mode: "fork"` compiled subagents */
+  /** Inherited by a `mode: "fork"` declarative or compiled subagent */
   parentSystemPrompt?: string | SystemMessage | null;
 }
 /**
@@ -2491,8 +2484,8 @@ type BuiltinToolPlaceholder<N extends string> = {
  */
 type DeepAgentBuiltinToolsTuple = { [K in DeepAgentBuiltinToolName]: BuiltinToolPlaceholder<K>; }[DeepAgentBuiltinToolName][];
 type InferDeepAgentStreamExtensions<T extends ReadonlyArray<() => StreamTransformer<any>>> = T extends readonly [] ? Record<string, never> : T extends readonly [() => StreamTransformer<infer P>, ...infer Rest extends ReadonlyArray<() => StreamTransformer<any>>] ? P & InferDeepAgentStreamExtensions<Rest> : Record<string, unknown>;
-/** Any subagent specification — sync, compiled, forked, or async. */
-type AnySubAgent = SubAgent | CompiledSubAgent | ForkedSubAgent | AsyncSubAgent;
+/** Any subagent specification — sync, compiled, or async. */
+type AnySubAgent = SubAgent | CompiledSubAgent | AsyncSubAgent;
 interface TypedToolStrategy<T = unknown> extends Array<ToolStrategy<any>> {
   _schemaType?: T;
 }
@@ -2753,7 +2746,7 @@ type InferSubagentByName<T, TName extends string> = InferDeepAgentSubagents<T> e
  * type SubagentState = InferMiddlewareStates<SubagentMiddleware>;
  * ```
  */
-type InferSubagentReactAgentType<TSubagent extends SubAgent | CompiledSubAgent | ForkedSubAgent> = TSubagent extends CompiledSubAgent ? TSubagent["runnable"] : TSubagent extends SubAgent | ForkedSubAgent ? ReactAgent<AgentTypeConfig<ResponseFormatUndefined, undefined, AnyAnnotationRoot, ExtractSubAgentMiddleware<TSubagent>, readonly []>> : never;
+type InferSubagentReactAgentType<TSubagent extends SubAgent | CompiledSubAgent> = TSubagent extends CompiledSubAgent ? TSubagent["runnable"] : TSubagent extends SubAgent ? ReactAgent<AgentTypeConfig<ResponseFormatUndefined, undefined, AnyAnnotationRoot, ExtractSubAgentMiddleware<TSubagent>, readonly []>> : never;
 /**
  * Configuration parameters for creating a Deep Agent
  * Matches Python's create_deep_agent parameters
@@ -2769,7 +2762,10 @@ type InferSubagentReactAgentType<TSubagent extends SubAgent | CompiledSubAgent |
 interface CreateDeepAgentParams<TResponse extends SupportedResponseFormat = SupportedResponseFormat, ContextSchema extends AnnotationRoot<any> | InteropZodObject = AnnotationRoot<any>, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[], TSubagents extends readonly AnySubAgent[] = readonly AnySubAgent[], TTools extends readonly (ClientTool | ServerTool)[] = readonly (ClientTool | ServerTool)[], TStreamTransformers extends ReadonlyArray<() => StreamTransformer<any>> = readonly [], TStateSchema extends AnyStateSchema | InteropZodObject | undefined = undefined> {
   /** The model to use (model name string or LanguageModelLike instance). Defaults to claude-sonnet-4-5-20250929 */
   model?: BaseLanguageModel | string;
-  /** Tools the agent should have access to */
+  /**
+   * Additional tools for the agent. Passing tools here does not remove built-in
+   * filesystem tools; customize `FilesystemMiddleware` to remove them entirely.
+   */
   tools?: TTools | StructuredTool$1[];
   /**
    * Custom system instructions. Structured configuration is deprecated and
@@ -4213,6 +4209,20 @@ declare class LangSmithSandbox extends BaseSandbox {
 }
 //#endregion
 //#region src/backends/utils.d.ts
+/**
+ * Normalize model- or caller-supplied text pagination bounds.
+ *
+ * Every backend must slice content and calculate pagination metadata from the
+ * same normalized values. Otherwise a fractional or negative argument could
+ * return one window while advertising a different `nextOffset`.
+ *
+ * Binary reads do not use this helper because their backend contract ignores
+ * line-based offset and limit values.
+ */
+declare function normalizeReadPagination(offset: number, limit: number): {
+  offset: number;
+  limit: number;
+};
 /**
  * Adapt a v1 {@link BackendProtocol} to {@link BackendProtocolV2}.
  *
@@ -4380,5 +4390,5 @@ declare function createDeepAgent<TResponse extends SupportedResponseFormat = Sup
   }, import("zod/v4/core").$strip>>;
 }, import("zod/v4/core").$strip>, undefined, unknown, readonly (ServerTool | ClientTool)[], readonly []>, AgentMiddleware<undefined, undefined, unknown, readonly (ServerTool | ClientTool)[], readonly []>, ...TMiddleware, ...FlattenSubAgentMiddleware<TSubagents>], TTools, TSubagents, TStreamTransformers>>;
 //#endregion
-export { createAsyncSubAgentMiddleware as $, BackendProtocol as $t, findProjectRoot as A, BackendProtocolV2 as An, parseHarnessProfileConfig as At, InferDeepAgentSubagents as B, ASYNC_TASK_SYSTEM_PROMPT as Bt, parseSkillMetadata as C, SandboxListResponse as Cn, createSubAgent as Ct, Settings as D, isSandboxBackend as Dn, HarnessProfileConfigData as Dt, filesValue as E, applyGrepMaxCount as En, registerHarnessProfile as Et, DeepAgent as F, HarnessProfile as Ft, InferSubagentReactAgentType as G, FilesystemMiddlewareOptions as Gt, InferStructuredResponse as H, EXECUTION_SYSTEM_PROMPT as Ht, DeepAgentTypeConfig as I, HarnessProfileOptions as It, SupportedResponseFormat as J, FilesystemOperation as Jt, MergedDeepAgentState as K, FsToolName as Kt, DefaultDeepAgentTypeConfig as L, REQUIRED_MIDDLEWARE_NAMES as Lt, SubagentRunStream$1 as M, BackendProtocolV1 as Mn, EMPTY_HARNESS_PROFILE as Mt, AnySubAgent as N, SandboxBackendProtocolV1 as Nn, createHarnessProfile as Nt, SettingsOptions as O, isSandboxProtocol as On, generalPurposeSubagentConfigSchema as Ot, CreateDeepAgentParams as P, GeneralPurposeSubagentConfig as Pt, AsyncTaskStatus as Q, BackendFactory as Qt, ExtractSubAgentMiddleware as R, ConfigurationError as Rt, listSkills as S, SandboxListOptions as Sn, SubAgentMiddlewareOptions as St, createAgentMemoryMiddleware as T, WriteResult as Tn, getHarnessProfile as Tt, InferSubAgentMiddlewareStates as U, SystemPromptConfig as Ut, InferDeepAgentType as V, BASE_AGENT_PROMPT as Vt, InferSubagentByName as W, TASK_SYSTEM_PROMPT as Wt, AsyncSubAgentMiddlewareOptions as X, PermissionMode as Xt, AsyncSubAgent as Y, FilesystemPermission as Yt, AsyncTask as Z, AnyBackendProtocol as Zt, StoreBackendContext as _, SandboxDeleteOptions as _n, DEFAULT_SUBAGENT_PROMPT as _t, adaptBackendProtocol as a, FileDownloadResponse as an, MAX_SKILL_DESCRIPTION_LENGTH as at, ListSkillsOptions as b, SandboxGetOrCreateOptions as bn, SUBAGENT_RESPONSE_FORMAT_CONFIG_KEY as bt, LangSmithSandboxCreateOptions as c, FileUploadResponse as cn, SkillMetadata$1 as ct, LocalShellBackend as d, GrepResult as dn, MemoryMiddlewareOptions as dt, BackendRuntime as en, isAsyncSubAgent as et, LocalShellBackendOptions as f, LsResult as fn, createMemoryMiddleware as ft, StoreBackend as g, SandboxBackendProtocol as gn, DEFAULT_GENERAL_PURPOSE_DESCRIPTION as gt, FilesystemBackend as h, ReadResult as hn, CompiledSubAgent as ht, LangSmithStartSandboxOptions as i, FileData as in, createCompletionCallbackMiddleware as it, DeepAgentRunStream as j, SandboxBackendProtocolV2 as jn, serializeProfile as jt, createSettings as k, resolveBackend as kn, harnessProfileConfigSchema as kt, LangSmithSandboxOptions as l, GlobResult as ln, SkillsMiddlewareOptions as lt, CompositeBackend as m, ReadRawResult as mn, createPatchToolCallsMiddleware as mt, LangSmithCaptureSnapshotOptions as n, EditResult as nn, createSummarizationMiddleware as nt, adaptSandboxProtocol as o, FileInfo as on, MAX_SKILL_FILE_SIZE as ot, ContextHubBackend as p, MaybePromise as pn, StateBackend as pt, ResolveDeepAgentTypeConfig as q, createFilesystemMiddleware as qt, LangSmithSnapshot as r, ExecuteResponse as rn, CompletionCallbackOptions as rt, LangSmithSandbox as s, FileOperationError as sn, MAX_SKILL_NAME_LENGTH as st, createDeepAgent as t, DeleteResult as tn, computeSummarizationDefaults as tt, BaseSandbox as u, GrepMatch as un, createSkillsMiddleware as ut, StoreBackendNamespaceFactory as v, SandboxError as vn, ForkedSubAgent as vt, AgentMemoryMiddlewareOptions as w, StateAndStore as wn, createSubAgentMiddleware as wt, SkillMetadata as x, SandboxInfo as xn, SubAgent as xt, StoreBackendOptions as y, SandboxErrorCode as yn, GENERAL_PURPOSE_SUBAGENT as yt, FlattenSubAgentMiddleware as z, ConfigurationErrorCode as zt };
-//# sourceMappingURL=agent-D50BBbJT.d.ts.map
+export { AsyncTaskStatus as $, BackendFactory as $t, createSettings as A, resolveBackend as An, harnessProfileConfigSchema as At, FlattenSubAgentMiddleware as B, ConfigurationErrorCode as Bt, listSkills as C, SandboxListOptions as Cn, SubAgentMiddlewareOptions as Ct, filesValue as D, applyGrepMaxCount as Dn, registerHarnessProfile as Dt, createAgentMemoryMiddleware as E, WriteResult as En, getHarnessProfile as Et, CreateDeepAgentParams as F, GeneralPurposeSubagentConfig as Ft, InferSubagentByName as G, TASK_SYSTEM_PROMPT as Gt, InferDeepAgentType as H, BASE_AGENT_PROMPT as Ht, DeepAgent as I, HarnessProfile as It, ResolveDeepAgentTypeConfig as J, createFilesystemMiddleware as Jt, InferSubagentReactAgentType as K, FilesystemMiddlewareOptions as Kt, DeepAgentTypeConfig as L, HarnessProfileOptions as Lt, DeepAgentRunStream as M, SandboxBackendProtocolV2 as Mn, serializeProfile as Mt, SubagentRunStream$1 as N, BackendProtocolV1 as Nn, EMPTY_HARNESS_PROFILE as Nt, Settings as O, isSandboxBackend as On, HarnessProfileConfigData as Ot, AnySubAgent as P, SandboxBackendProtocolV1 as Pn, createHarnessProfile as Pt, AsyncTask as Q, AnyBackendProtocol as Qt, DefaultDeepAgentTypeConfig as R, REQUIRED_MIDDLEWARE_NAMES as Rt, SkillMetadata as S, SandboxInfo as Sn, SubAgent as St, AgentMemoryMiddlewareOptions as T, StateAndStore as Tn, createSubAgentMiddleware as Tt, InferStructuredResponse as U, EXECUTION_SYSTEM_PROMPT as Ut, InferDeepAgentSubagents as V, ASYNC_TASK_SYSTEM_PROMPT as Vt, InferSubAgentMiddlewareStates as W, SystemPromptConfig as Wt, AsyncSubAgent as X, FilesystemPermission as Xt, SupportedResponseFormat as Y, FilesystemOperation as Yt, AsyncSubAgentMiddlewareOptions as Z, PermissionMode as Zt, StoreBackend as _, SandboxBackendProtocol as _n, DEFAULT_GENERAL_PURPOSE_DESCRIPTION as _t, adaptBackendProtocol as a, FileData as an, createCompletionCallbackMiddleware as at, StoreBackendOptions as b, SandboxErrorCode as bn, GENERAL_PURPOSE_SUBAGENT as bt, LangSmithSandbox as c, FileOperationError as cn, MAX_SKILL_NAME_LENGTH as ct, BaseSandbox as d, GrepMatch as dn, createSkillsMiddleware as dt, BackendProtocol as en, createAsyncSubAgentMiddleware as et, LocalShellBackend as f, GrepResult as fn, MemoryMiddlewareOptions as ft, FilesystemBackend as g, ReadResult as gn, CompiledSubAgent as gt, CompositeBackend as h, ReadRawResult as hn, createPatchToolCallsMiddleware as ht, LangSmithStartSandboxOptions as i, ExecuteResponse as in, CompletionCallbackOptions as it, findProjectRoot as j, BackendProtocolV2 as jn, parseHarnessProfileConfig as jt, SettingsOptions as k, isSandboxProtocol as kn, generalPurposeSubagentConfigSchema as kt, LangSmithSandboxCreateOptions as l, FileUploadResponse as ln, SkillMetadata$1 as lt, ContextHubBackend as m, MaybePromise as mn, StateBackend as mt, LangSmithCaptureSnapshotOptions as n, DeleteResult as nn, computeSummarizationDefaults as nt, adaptSandboxProtocol as o, FileDownloadResponse as on, MAX_SKILL_DESCRIPTION_LENGTH as ot, LocalShellBackendOptions as p, LsResult as pn, createMemoryMiddleware as pt, MergedDeepAgentState as q, FsToolName as qt, LangSmithSnapshot as r, EditResult as rn, createSummarizationMiddleware as rt, normalizeReadPagination as s, FileInfo as sn, MAX_SKILL_FILE_SIZE as st, createDeepAgent as t, BackendRuntime as tn, isAsyncSubAgent as tt, LangSmithSandboxOptions as u, GlobResult as un, SkillsMiddlewareOptions as ut, StoreBackendContext as v, SandboxDeleteOptions as vn, DEFAULT_SUBAGENT_PROMPT as vt, parseSkillMetadata as w, SandboxListResponse as wn, createSubAgent as wt, ListSkillsOptions as x, SandboxGetOrCreateOptions as xn, SUBAGENT_RESPONSE_FORMAT_CONFIG_KEY as xt, StoreBackendNamespaceFactory as y, SandboxError as yn, ForkedSubAgent as yt, ExtractSubAgentMiddleware as z, ConfigurationError as zt };
+//# sourceMappingURL=agent-CVBXKZAu.d.ts.map

package/dist/{agent-HW8KptlB.d.cts → agent-D7nWARfg.d.cts}

@@ -357,6 +357,23 @@ interface ReadResult {
   content?: string | Uint8Array;
   /** MIME type of the file, when available */
   mimeType?: string;
+  /**
+   * Total number of logical source lines for a text read, when known.
+   * Omitted for binary reads and for backends that cannot determine it.
+   */
+  totalLines?: number;
+  /**
+   * 1-indexed first source line represented by `content`.
+   * Text pagination fields are optional so older/custom backends remain valid.
+   */
+  startLine?: number;
+  /** 1-indexed last source line represented by `content`. */
+  endLine?: number;
+  /**
+   * 0-indexed offset of the next unread source line.
+   * Omitted when the returned text reaches EOF.
+   */
+  nextOffset?: number;
 }
 /**
  * Structured result from backend readRaw operations.
@@ -1188,11 +1205,13 @@ interface HarnessProfileOptions {
    */
   toolDescriptionOverrides?: Record<string, string>;
   /**
-   * Tool names to remove from the agent's visible tool set.
+   * Tool names to remove from the agent's visible tool set and reject at the
+   * tool-call boundary.
    *
-   * Applied via a filtering middleware after all tool-injecting
-   * middleware have run, so it catches both user-provided and
-   * middleware-provided tools.
+   * Applied via middleware after all tool-injecting middleware have run, so it
+   * catches both user-provided and middleware-provided tools. Each declarative
+   * subagent uses the profile resolved for its own model. Exclusions are
+   * model-facing calibration, not a security boundary.
    *
    * @default [] (no tools excluded)
    */
@@ -1266,11 +1285,13 @@ interface HarnessProfile {
    */
   toolDescriptionOverrides: Record<string, string>;
   /**
-   * Tool names to remove from the agent's visible tool set.
+   * Tool names to remove from the agent's visible tool set and reject at the
+   * tool-call boundary.
    *
-   * Applied via a filtering middleware after all tool-injecting
-   * middleware have run, so it catches both user-provided and
-   * middleware-provided tools.
+   * Applied via middleware after all tool-injecting middleware have run, so it
+   * catches both user-provided and middleware-provided tools. Each declarative
+   * subagent uses the profile resolved for its own model. Exclusions are
+   * model-facing calibration, not a security boundary.
    */
   excludedTools: Set<string>;
   /**
@@ -1494,31 +1515,55 @@ interface CompiledSubAgent<TRunnable extends ReactAgent<any> | Runnable = ReactA
   /**
    * Context mode. `"fork"` inherits the parent's conversation history
    * (but not its system prompt — that's baked into the runnable).
-   * `"handoff"` (default) is fully isolated.
+   * `"isolated"` (default) only sees the delegated task.
    */
-  mode?: "handoff" | "fork";
+  mode?: "isolated" | "fork";
 }
 /**
- * Fields shared by both {@link SubAgent} and {@link ForkedSubAgent}.
+ * Specification for a declarative subagent.
  *
- * @internal
+ * When using `createDeepAgent`, subagents automatically receive a default middleware
+ * stack (filesystemMiddleware, summarizationMiddleware, etc.) before any custom
+ * `middleware` specified in this spec. Add `todoListMiddleware` explicitly to opt in.
+ *
+ * By default the subagent is isolated — it only ever sees the delegated task
+ * description, never the parent's conversation. Setting `mode: "fork"` makes
+ * it continue the parent's conversation instead.
+ *
+ * @example
+ * ```typescript
+ * const researcher: SubAgent = {
+ *   name: "researcher",
+ *   description: "Research assistant for complex topics",
+ *   systemPrompt: "You are a research assistant.",
+ *   tools: [webSearchTool],
+ *   skills: ["/skills/research/"],
+ * };
+ * ```
+ *
+ * @experimental `mode: "fork"` is experimental and subject to change.
  */
-interface SubAgentBase {
+interface SubAgent {
   /** Identifier used to select this subagent in the task tool */
   name: string;
   /** Description shown to the model for subagent selection */
   description: string;
   /**
-   * The system prompt for the agent. Optional on {@link SubAgent} (falls
-   * back to an empty prompt if omitted); forbidden on {@link ForkedSubAgent},
-   * which always inherits the parent's instead.
+   * The system prompt for the agent. Falls back to an empty prompt if
+   * omitted. Under `mode: "fork"`, this is appended to the parent's
+   * inherited prompt rather than replacing it.
    */
   systemPrompt?: string | SystemMessage;
   /**
-   * Context mode. `"handoff"` (default) is fully isolated. `"fork"` inherits
-   * the parent's conversation history and system prompt.
+   * Context mode. `"isolated"` (default) only sees the delegated task.
+   * `"fork"` inherits the parent's conversation history and mirrors the
+   * parent's prompt-producing middleware (skills, memory, custom middleware)
+   * so it rebuilds an equivalent system prompt — the tradeoff is cache
+   * misses if this subagent's own `model` differs from the parent's. Cannot
+   * declare `skills` under `mode: "fork"`; the parent's skills are inherited
+   * instead.
    */
-  mode?: "handoff" | "fork";
+  mode?: "isolated" | "fork";
   /** The tools to use for the agent (tool instances, not names). Defaults to defaultTools */
   tools?: StructuredTool[];
   /** The model for the agent. Defaults to defaultModel */
@@ -1597,67 +1642,14 @@ interface SubAgentBase {
   permissions?: FilesystemPermission[];
 }
 /**
- * Specification for a subagent that can be dynamically created.
- *
- * When using `createDeepAgent`, subagents automatically receive a default middleware
- * stack (filesystemMiddleware, summarizationMiddleware, etc.) before any custom
- * `middleware` specified in this spec. Add `todoListMiddleware` explicitly to opt in.
- *
- * Always fully isolated — this subagent only ever sees the task description,
- * never the parent's conversation. Use {@link ForkedSubAgent} to inherit the
- * parent's history and system prompt instead.
- *
- * @example
- * ```typescript
- * const researcher: SubAgent = {
- *   name: "researcher",
- *   description: "Research assistant for complex topics",
- *   systemPrompt: "You are a research assistant.",
- *   tools: [webSearchTool],
- *   skills: ["/skills/research/"],
- * };
- * ```
- */
-interface SubAgent extends SubAgentBase {
-  /** The system prompt to use for the agent */
-  systemPrompt?: string | SystemMessage;
-  /**
-   * Context mode. `"handoff"` (default) is fully isolated. `"fork"` inherits
-   * the parent's conversation history and system prompt.
-   */
-  mode?: "handoff";
-}
-/**
- * Specification for a subagent that inherits the parent's conversation
- * instead of starting from just the task description.
- *
- * Always forks: it inherits the parent's full message history and its exact
- * system prompt (there's no own prompt to fall back to). Mirrored middleware
- * is only added when its model matches the parent's, since that's the only
- * case with a cache benefit to protect. Deliberately has no `systemPrompt`
- * of its own: since its system slot always carries the parent's prompt,
- * there's nothing of its own to put there. If you need a subagent with a
- * distinguishing system prompt, use {@link SubAgent} without forking instead.
- *
- * @example
- * ```typescript
- * const researcher: ForkedSubAgent = {
- *   name: "researcher",
- *   description: "Continues the current investigation with full context",
- *   mode: "fork",
- *   tools: [webSearchTool],
- * };
- * ```
+ * A {@link SubAgent} with `mode: "fork"`.
  *
- * @experimental Forking subagents is experimental and subject to change
+ * @deprecated Kept as a named type for backward compatibility with code that imported
+ * `ForkedSubAgent` before it merged into `SubAgent` — not a distinct shape
+ * with its own constraints (a fork can now declare its own `systemPrompt`,
+ * same as any `SubAgent`). Prefer `SubAgent` with `mode: "fork"` in new code.
  */
-interface ForkedSubAgent extends SubAgentBase {
-  /** A ForkedSubAgent never has its own system prompt — always the parent's. */
-  systemPrompt?: undefined;
-  /**
-   * Always `"fork"`. Required (not defaulted) so this can't structurally
-   * collapse into a plain `SubAgent` — see `isForkedSubAgent` below.
-   */
+interface ForkedSubAgent extends SubAgent {
   mode: "fork";
 }
 /**
@@ -1701,7 +1693,7 @@ declare const GENERAL_PURPOSE_SUBAGENT: {
   readonly name: "general-purpose";
   readonly description: "General-purpose agent for researching complex questions, searching for files and content, and executing multi-step tasks. When you are searching for a keyword or file and are not confident that you will find the right match in the first few tries use this agent to perform the search for you. This agent has access to all tools as the main agent.";
   readonly systemPrompt: "In order to complete the objective that the user asks of you, you have access to a number of standard tools.";
-  readonly mode: "handoff";
+  readonly mode: "isolated";
 };
 /**
  * Create a runnable agent from a declarative `SubAgent` spec.
@@ -1737,14 +1729,14 @@ interface SubAgentMiddlewareOptions {
   /** The tool configs for the default general-purpose subagent */
   defaultInterruptOn?: Record<string, boolean | InterruptOnConfig> | null;
   /** A list of additional subagents to provide to the agent */
-  subagents?: (SubAgent | CompiledSubAgent | ForkedSubAgent)[];
+  subagents?: (SubAgent | CompiledSubAgent)[];
   /** Full system prompt override */
   systemPrompt?: string | null;
   /** Whether to include the general-purpose agent */
   generalPurposeAgent?: boolean;
   /** Custom description for the task tool */
   taskDescription?: string | null;
-  /** Inherited by `ForkedSubAgent`s and `mode: "fork"` compiled subagents */
+  /** Inherited by a `mode: "fork"` declarative or compiled subagent */
   parentSystemPrompt?: string | SystemMessage | null;
 }
 /**
@@ -2491,8 +2483,8 @@ type BuiltinToolPlaceholder<N extends string> = {
  */
 type DeepAgentBuiltinToolsTuple = { [K in DeepAgentBuiltinToolName]: BuiltinToolPlaceholder<K>; }[DeepAgentBuiltinToolName][];
 type InferDeepAgentStreamExtensions<T extends ReadonlyArray<() => StreamTransformer<any>>> = T extends readonly [] ? Record<string, never> : T extends readonly [() => StreamTransformer<infer P>, ...infer Rest extends ReadonlyArray<() => StreamTransformer<any>>] ? P & InferDeepAgentStreamExtensions<Rest> : Record<string, unknown>;
-/** Any subagent specification — sync, compiled, forked, or async. */
-type AnySubAgent = SubAgent | CompiledSubAgent | ForkedSubAgent | AsyncSubAgent;
+/** Any subagent specification — sync, compiled, or async. */
+type AnySubAgent = SubAgent | CompiledSubAgent | AsyncSubAgent;
 interface TypedToolStrategy<T = unknown> extends Array<ToolStrategy<any>> {
   _schemaType?: T;
 }
@@ -2753,7 +2745,7 @@ type InferSubagentByName<T, TName extends string> = InferDeepAgentSubagents<T> e
  * type SubagentState = InferMiddlewareStates<SubagentMiddleware>;
  * ```
  */
-type InferSubagentReactAgentType<TSubagent extends SubAgent | CompiledSubAgent | ForkedSubAgent> = TSubagent extends CompiledSubAgent ? TSubagent["runnable"] : TSubagent extends SubAgent | ForkedSubAgent ? ReactAgent<AgentTypeConfig<ResponseFormatUndefined, undefined, AnyAnnotationRoot, ExtractSubAgentMiddleware<TSubagent>, readonly []>> : never;
+type InferSubagentReactAgentType<TSubagent extends SubAgent | CompiledSubAgent> = TSubagent extends CompiledSubAgent ? TSubagent["runnable"] : TSubagent extends SubAgent ? ReactAgent<AgentTypeConfig<ResponseFormatUndefined, undefined, AnyAnnotationRoot, ExtractSubAgentMiddleware<TSubagent>, readonly []>> : never;
 /**
  * Configuration parameters for creating a Deep Agent
  * Matches Python's create_deep_agent parameters
@@ -2769,7 +2761,10 @@ type InferSubagentReactAgentType<TSubagent extends SubAgent | CompiledSubAgent |
 interface CreateDeepAgentParams<TResponse extends SupportedResponseFormat = SupportedResponseFormat, ContextSchema extends AnnotationRoot<any> | InteropZodObject = AnnotationRoot<any>, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[], TSubagents extends readonly AnySubAgent[] = readonly AnySubAgent[], TTools extends readonly (ClientTool | ServerTool)[] = readonly (ClientTool | ServerTool)[], TStreamTransformers extends ReadonlyArray<() => StreamTransformer<any>> = readonly [], TStateSchema extends AnyStateSchema | InteropZodObject | undefined = undefined> {
   /** The model to use (model name string or LanguageModelLike instance). Defaults to claude-sonnet-4-5-20250929 */
   model?: BaseLanguageModel | string;
-  /** Tools the agent should have access to */
+  /**
+   * Additional tools for the agent. Passing tools here does not remove built-in
+   * filesystem tools; customize `FilesystemMiddleware` to remove them entirely.
+   */
   tools?: TTools | StructuredTool$1[];
   /**
    * Custom system instructions. Structured configuration is deprecated and
@@ -4213,6 +4208,20 @@ declare class LangSmithSandbox extends BaseSandbox {
 }
 //#endregion
 //#region src/backends/utils.d.ts
+/**
+ * Normalize model- or caller-supplied text pagination bounds.
+ *
+ * Every backend must slice content and calculate pagination metadata from the
+ * same normalized values. Otherwise a fractional or negative argument could
+ * return one window while advertising a different `nextOffset`.
+ *
+ * Binary reads do not use this helper because their backend contract ignores
+ * line-based offset and limit values.
+ */
+declare function normalizeReadPagination(offset: number, limit: number): {
+  offset: number;
+  limit: number;
+};
 /**
  * Adapt a v1 {@link BackendProtocol} to {@link BackendProtocolV2}.
  *
@@ -4380,5 +4389,5 @@ declare function createDeepAgent<TResponse extends SupportedResponseFormat = Sup
   }, import("zod/v4/core").$strip>>;
 }, import("zod/v4/core").$strip>, undefined, unknown, readonly (ServerTool | ClientTool)[], readonly []>, AgentMiddleware<undefined, undefined, unknown, readonly (ServerTool | ClientTool)[], readonly []>, ...TMiddleware, ...FlattenSubAgentMiddleware<TSubagents>], TTools, TSubagents, TStreamTransformers>>;
 //#endregion
-export { createAsyncSubAgentMiddleware as $, BackendProtocol as $t, findProjectRoot as A, BackendProtocolV2 as An, parseHarnessProfileConfig as At, InferDeepAgentSubagents as B, ASYNC_TASK_SYSTEM_PROMPT as Bt, parseSkillMetadata as C, SandboxListResponse as Cn, createSubAgent as Ct, Settings as D, isSandboxBackend as Dn, HarnessProfileConfigData as Dt, filesValue as E, applyGrepMaxCount as En, registerHarnessProfile as Et, DeepAgent as F, HarnessProfile as Ft, InferSubagentReactAgentType as G, FilesystemMiddlewareOptions as Gt, InferStructuredResponse as H, EXECUTION_SYSTEM_PROMPT as Ht, DeepAgentTypeConfig as I, HarnessProfileOptions as It, SupportedResponseFormat as J, FilesystemOperation as Jt, MergedDeepAgentState as K, FsToolName as Kt, DefaultDeepAgentTypeConfig as L, REQUIRED_MIDDLEWARE_NAMES as Lt, SubagentRunStream$1 as M, BackendProtocolV1 as Mn, EMPTY_HARNESS_PROFILE as Mt, AnySubAgent as N, SandboxBackendProtocolV1 as Nn, createHarnessProfile as Nt, SettingsOptions as O, isSandboxProtocol as On, generalPurposeSubagentConfigSchema as Ot, CreateDeepAgentParams as P, GeneralPurposeSubagentConfig as Pt, AsyncTaskStatus as Q, BackendFactory as Qt, ExtractSubAgentMiddleware as R, ConfigurationError as Rt, listSkills as S, SandboxListOptions as Sn, SubAgentMiddlewareOptions as St, createAgentMemoryMiddleware as T, WriteResult as Tn, getHarnessProfile as Tt, InferSubAgentMiddlewareStates as U, SystemPromptConfig as Ut, InferDeepAgentType as V, BASE_AGENT_PROMPT as Vt, InferSubagentByName as W, TASK_SYSTEM_PROMPT as Wt, AsyncSubAgentMiddlewareOptions as X, PermissionMode as Xt, AsyncSubAgent as Y, FilesystemPermission as Yt, AsyncTask as Z, AnyBackendProtocol as Zt, StoreBackendContext as _, SandboxDeleteOptions as _n, DEFAULT_SUBAGENT_PROMPT as _t, adaptBackendProtocol as a, FileDownloadResponse as an, MAX_SKILL_DESCRIPTION_LENGTH as at, ListSkillsOptions as b, SandboxGetOrCreateOptions as bn, SUBAGENT_RESPONSE_FORMAT_CONFIG_KEY as bt, LangSmithSandboxCreateOptions as c, FileUploadResponse as cn, SkillMetadata$1 as ct, LocalShellBackend as d, GrepResult as dn, MemoryMiddlewareOptions as dt, BackendRuntime as en, isAsyncSubAgent as et, LocalShellBackendOptions as f, LsResult as fn, createMemoryMiddleware as ft, StoreBackend as g, SandboxBackendProtocol as gn, DEFAULT_GENERAL_PURPOSE_DESCRIPTION as gt, FilesystemBackend as h, ReadResult as hn, CompiledSubAgent as ht, LangSmithStartSandboxOptions as i, FileData as in, createCompletionCallbackMiddleware as it, DeepAgentRunStream as j, SandboxBackendProtocolV2 as jn, serializeProfile as jt, createSettings as k, resolveBackend as kn, harnessProfileConfigSchema as kt, LangSmithSandboxOptions as l, GlobResult as ln, SkillsMiddlewareOptions as lt, CompositeBackend as m, ReadRawResult as mn, createPatchToolCallsMiddleware as mt, LangSmithCaptureSnapshotOptions as n, EditResult as nn, createSummarizationMiddleware as nt, adaptSandboxProtocol as o, FileInfo as on, MAX_SKILL_FILE_SIZE as ot, ContextHubBackend as p, MaybePromise as pn, StateBackend as pt, ResolveDeepAgentTypeConfig as q, createFilesystemMiddleware as qt, LangSmithSnapshot as r, ExecuteResponse as rn, CompletionCallbackOptions as rt, LangSmithSandbox as s, FileOperationError as sn, MAX_SKILL_NAME_LENGTH as st, createDeepAgent as t, DeleteResult as tn, computeSummarizationDefaults as tt, BaseSandbox as u, GrepMatch as un, createSkillsMiddleware as ut, StoreBackendNamespaceFactory as v, SandboxError as vn, ForkedSubAgent as vt, AgentMemoryMiddlewareOptions as w, StateAndStore as wn, createSubAgentMiddleware as wt, SkillMetadata as x, SandboxInfo as xn, SubAgent as xt, StoreBackendOptions as y, SandboxErrorCode as yn, GENERAL_PURPOSE_SUBAGENT as yt, FlattenSubAgentMiddleware as z, ConfigurationErrorCode as zt };
-//# sourceMappingURL=agent-HW8KptlB.d.cts.map
+export { AsyncTaskStatus as $, BackendFactory as $t, createSettings as A, resolveBackend as An, harnessProfileConfigSchema as At, FlattenSubAgentMiddleware as B, ConfigurationErrorCode as Bt, listSkills as C, SandboxListOptions as Cn, SubAgentMiddlewareOptions as Ct, filesValue as D, applyGrepMaxCount as Dn, registerHarnessProfile as Dt, createAgentMemoryMiddleware as E, WriteResult as En, getHarnessProfile as Et, CreateDeepAgentParams as F, GeneralPurposeSubagentConfig as Ft, InferSubagentByName as G, TASK_SYSTEM_PROMPT as Gt, InferDeepAgentType as H, BASE_AGENT_PROMPT as Ht, DeepAgent as I, HarnessProfile as It, ResolveDeepAgentTypeConfig as J, createFilesystemMiddleware as Jt, InferSubagentReactAgentType as K, FilesystemMiddlewareOptions as Kt, DeepAgentTypeConfig as L, HarnessProfileOptions as Lt, DeepAgentRunStream as M, SandboxBackendProtocolV2 as Mn, serializeProfile as Mt, SubagentRunStream$1 as N, BackendProtocolV1 as Nn, EMPTY_HARNESS_PROFILE as Nt, Settings as O, isSandboxBackend as On, HarnessProfileConfigData as Ot, AnySubAgent as P, SandboxBackendProtocolV1 as Pn, createHarnessProfile as Pt, AsyncTask as Q, AnyBackendProtocol as Qt, DefaultDeepAgentTypeConfig as R, REQUIRED_MIDDLEWARE_NAMES as Rt, SkillMetadata as S, SandboxInfo as Sn, SubAgent as St, AgentMemoryMiddlewareOptions as T, StateAndStore as Tn, createSubAgentMiddleware as Tt, InferStructuredResponse as U, EXECUTION_SYSTEM_PROMPT as Ut, InferDeepAgentSubagents as V, ASYNC_TASK_SYSTEM_PROMPT as Vt, InferSubAgentMiddlewareStates as W, SystemPromptConfig as Wt, AsyncSubAgent as X, FilesystemPermission as Xt, SupportedResponseFormat as Y, FilesystemOperation as Yt, AsyncSubAgentMiddlewareOptions as Z, PermissionMode as Zt, StoreBackend as _, SandboxBackendProtocol as _n, DEFAULT_GENERAL_PURPOSE_DESCRIPTION as _t, adaptBackendProtocol as a, FileData as an, createCompletionCallbackMiddleware as at, StoreBackendOptions as b, SandboxErrorCode as bn, GENERAL_PURPOSE_SUBAGENT as bt, LangSmithSandbox as c, FileOperationError as cn, MAX_SKILL_NAME_LENGTH as ct, BaseSandbox as d, GrepMatch as dn, createSkillsMiddleware as dt, BackendProtocol as en, createAsyncSubAgentMiddleware as et, LocalShellBackend as f, GrepResult as fn, MemoryMiddlewareOptions as ft, FilesystemBackend as g, ReadResult as gn, CompiledSubAgent as gt, CompositeBackend as h, ReadRawResult as hn, createPatchToolCallsMiddleware as ht, LangSmithStartSandboxOptions as i, ExecuteResponse as in, CompletionCallbackOptions as it, findProjectRoot as j, BackendProtocolV2 as jn, parseHarnessProfileConfig as jt, SettingsOptions as k, isSandboxProtocol as kn, generalPurposeSubagentConfigSchema as kt, LangSmithSandboxCreateOptions as l, FileUploadResponse as ln, SkillMetadata$1 as lt, ContextHubBackend as m, MaybePromise as mn, StateBackend as mt, LangSmithCaptureSnapshotOptions as n, DeleteResult as nn, computeSummarizationDefaults as nt, adaptSandboxProtocol as o, FileDownloadResponse as on, MAX_SKILL_DESCRIPTION_LENGTH as ot, LocalShellBackendOptions as p, LsResult as pn, createMemoryMiddleware as pt, MergedDeepAgentState as q, FsToolName as qt, LangSmithSnapshot as r, EditResult as rn, createSummarizationMiddleware as rt, normalizeReadPagination as s, FileInfo as sn, MAX_SKILL_FILE_SIZE as st, createDeepAgent as t, BackendRuntime as tn, isAsyncSubAgent as tt, LangSmithSandboxOptions as u, GlobResult as un, SkillsMiddlewareOptions as ut, StoreBackendContext as v, SandboxDeleteOptions as vn, DEFAULT_SUBAGENT_PROMPT as vt, parseSkillMetadata as w, SandboxListResponse as wn, createSubAgent as wt, ListSkillsOptions as x, SandboxGetOrCreateOptions as xn, SUBAGENT_RESPONSE_FORMAT_CONFIG_KEY as xt, StoreBackendNamespaceFactory as y, SandboxError as yn, ForkedSubAgent as yt, ExtractSubAgentMiddleware as z, ConfigurationError as zt };
+//# sourceMappingURL=agent-D7nWARfg.d.cts.map

package/dist/browser.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_langsmith = require("./langsmith-Ck9t7AGW.cjs");
+const require_langsmith = require("./langsmith-Ynj9VKxb.cjs");
 exports.ASYNC_TASK_SYSTEM_PROMPT = require_langsmith.ASYNC_TASK_SYSTEM_PROMPT;
 exports.BASE_AGENT_PROMPT = require_langsmith.BASE_AGENT_PROMPT;
 exports.BaseSandbox = require_langsmith.BaseSandbox;