@voltagent/core 2.3.4 → 2.3.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -9,11 +9,11 @@ export { ROOT_CONTEXT, Span, SpanOptions, Tracer, context, propagation, trace }
9
9
  import { Logger, LogFn, LogBuffer } from '@voltagent/internal';
10
10
  import { AsyncIterableStream } from '@voltagent/internal/utils';
11
11
  export { AsyncIterableStream, createAsyncIterableStream } from '@voltagent/internal/utils';
12
+ import { DangerouslyAllowAny, PlainObject } from '@voltagent/internal/types';
13
+ import * as TF from 'type-fest';
12
14
  import { LogRecordProcessor, LoggerProvider, ReadableLogRecord, SdkLogRecord } from '@opentelemetry/sdk-logs';
13
15
  import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
14
16
  import { SpanProcessor, BasicTracerProvider, ReadableSpan, Span as Span$1 } from '@opentelemetry/sdk-trace-base';
15
- import { DangerouslyAllowAny, PlainObject } from '@voltagent/internal/types';
16
- import * as TF from 'type-fest';
17
17
  import { A2AServerLike, A2AServerDeps, A2AServerMetadata, A2AServerFactory } from '@voltagent/internal/a2a';
18
18
  import { MCPServerLike, MCPServerDeps, MCPServerMetadata, MCPServerFactory } from '@voltagent/internal/mcp';
19
19
  import { ElicitRequest, ElicitResult, ClientCapabilities, ListResourcesResult } from '@modelcontextprotocol/sdk/types.js';
@@ -3695,6 +3695,27 @@ interface SpanAttributes {
3695
3695
  "workflow.step.type"?: string;
3696
3696
  "workflow.step.name"?: string;
3697
3697
  "tool.name"?: string;
3698
+ "workspace.id"?: string;
3699
+ "workspace.name"?: string;
3700
+ "workspace.scope"?: "agent" | "conversation";
3701
+ "workspace.operation"?: string;
3702
+ "workspace.fs.path"?: string;
3703
+ "workspace.fs.pattern"?: string;
3704
+ "workspace.fs.bytes"?: number;
3705
+ "workspace.fs.offset"?: number;
3706
+ "workspace.fs.limit"?: number;
3707
+ "workspace.fs.occurrences"?: number;
3708
+ "workspace.search.query"?: string;
3709
+ "workspace.search.mode"?: string;
3710
+ "workspace.search.top_k"?: number;
3711
+ "workspace.search.results"?: number;
3712
+ "workspace.sandbox.command"?: string;
3713
+ "workspace.sandbox.args"?: string[] | string;
3714
+ "workspace.sandbox.cwd"?: string;
3715
+ "workspace.sandbox.timeout_ms"?: number;
3716
+ "workspace.sandbox.exit_code"?: number;
3717
+ "workspace.skills.name"?: string;
3718
+ "workspace.skills.source"?: string;
3698
3719
  "user.id"?: string;
3699
3720
  "conversation.id"?: string;
3700
3721
  "model.name"?: string;
@@ -6706,6 +6727,591 @@ type ModelRouterModelId = {
6706
6727
  }[ProviderId] | (string & {});
6707
6728
  type ModelForProvider<P extends ProviderId> = ProviderModelsMap[P][number];
6708
6729
 
6730
+ type WorkspaceToolPolicy = {
6731
+ enabled?: boolean;
6732
+ needsApproval?: boolean | ToolNeedsApprovalFunction<any>;
6733
+ };
6734
+ type WorkspaceToolPolicyGroup<TName extends string, TPolicy = WorkspaceToolPolicy> = {
6735
+ defaults?: TPolicy;
6736
+ tools?: Partial<Record<TName, TPolicy>>;
6737
+ };
6738
+ type WorkspaceToolPolicies<TName extends string, TPolicy = WorkspaceToolPolicy> = Partial<Record<TName, TPolicy>> | WorkspaceToolPolicyGroup<TName, TPolicy>;
6739
+ type WorkspaceFilesystemToolPolicy = WorkspaceToolPolicy & {
6740
+ requireReadBeforeWrite?: boolean;
6741
+ };
6742
+ type WorkspaceToolConfig = {
6743
+ filesystem?: WorkspaceToolPolicies<string, WorkspaceFilesystemToolPolicy>;
6744
+ sandbox?: WorkspaceToolPolicies<string, WorkspaceToolPolicy>;
6745
+ search?: WorkspaceToolPolicies<string, WorkspaceToolPolicy>;
6746
+ skills?: WorkspaceToolPolicies<string, WorkspaceToolPolicy>;
6747
+ };
6748
+
6749
+ type WorkspaceSandboxExecuteOptions = {
6750
+ command: string;
6751
+ args?: string[];
6752
+ cwd?: string;
6753
+ env?: Record<string, string>;
6754
+ timeoutMs?: number;
6755
+ maxOutputBytes?: number;
6756
+ stdin?: string;
6757
+ signal?: AbortSignal;
6758
+ onStdout?: (chunk: string) => void;
6759
+ onStderr?: (chunk: string) => void;
6760
+ };
6761
+ type WorkspaceSandboxStatus = "idle" | "ready" | "destroyed" | "error";
6762
+ type WorkspaceSandboxResult = {
6763
+ stdout: string;
6764
+ stderr: string;
6765
+ exitCode: number | null;
6766
+ signal?: string;
6767
+ durationMs: number;
6768
+ timedOut: boolean;
6769
+ aborted: boolean;
6770
+ stdoutTruncated: boolean;
6771
+ stderrTruncated: boolean;
6772
+ };
6773
+ interface WorkspaceSandbox {
6774
+ name: string;
6775
+ status?: WorkspaceSandboxStatus;
6776
+ start?: () => Promise<void> | void;
6777
+ stop?: () => Promise<void> | void;
6778
+ destroy?: () => Promise<void> | void;
6779
+ getInfo?: () => Record<string, unknown>;
6780
+ getInstructions?: () => string | null;
6781
+ execute(options: WorkspaceSandboxExecuteOptions): Promise<WorkspaceSandboxResult>;
6782
+ }
6783
+
6784
+ type LocalSandboxOptions = {
6785
+ rootDir?: string;
6786
+ cleanupOnDestroy?: boolean;
6787
+ defaultTimeoutMs?: number;
6788
+ maxOutputBytes?: number;
6789
+ env?: Record<string, string>;
6790
+ inheritProcessEnv?: boolean;
6791
+ allowedCommands?: string[];
6792
+ blockedCommands?: string[];
6793
+ isolation?: LocalSandboxIsolationOptions;
6794
+ };
6795
+ type LocalSandboxIsolationProvider = "none" | "sandbox-exec" | "bwrap";
6796
+ type LocalSandboxIsolationOptions = {
6797
+ provider?: LocalSandboxIsolationProvider;
6798
+ allowNetwork?: boolean;
6799
+ allowSystemBinaries?: boolean;
6800
+ readWritePaths?: string[];
6801
+ readOnlyPaths?: string[];
6802
+ seatbeltProfilePath?: string;
6803
+ bwrapArgs?: string[];
6804
+ profile?: string;
6805
+ };
6806
+ declare const detectLocalSandboxIsolation: () => Promise<LocalSandboxIsolationProvider>;
6807
+ declare class LocalSandbox implements WorkspaceSandbox {
6808
+ name: string;
6809
+ status: WorkspaceSandboxStatus;
6810
+ private readonly rootDir?;
6811
+ private readonly autoRootDir;
6812
+ private readonly cleanupOnDestroy;
6813
+ private readonly defaultTimeoutMs;
6814
+ private readonly maxOutputBytes;
6815
+ private readonly env;
6816
+ private readonly inheritProcessEnv;
6817
+ private readonly allowedCommands?;
6818
+ private readonly blockedCommands?;
6819
+ private readonly isolation?;
6820
+ constructor(options?: LocalSandboxOptions);
6821
+ private rootDirReady?;
6822
+ private ensureRootDir;
6823
+ static detectIsolation(): Promise<LocalSandboxIsolationProvider>;
6824
+ start(): void;
6825
+ stop(): void;
6826
+ destroy(): void;
6827
+ getInfo(): Record<string, unknown>;
6828
+ getInstructions(): string | null;
6829
+ execute(options: WorkspaceSandboxExecuteOptions): Promise<WorkspaceSandboxResult>;
6830
+ }
6831
+
6832
+ type WorkspaceSandboxToolkitOptions = {
6833
+ systemPrompt?: string | null;
6834
+ operationTimeoutMs?: number;
6835
+ customToolDescription?: string | null;
6836
+ outputEvictionBytes?: number;
6837
+ outputEvictionPath?: string;
6838
+ toolPolicies?: WorkspaceToolPolicies<WorkspaceSandboxToolName> | null;
6839
+ };
6840
+ type WorkspaceSandboxToolkitContext = {
6841
+ sandbox?: WorkspaceSandbox;
6842
+ workspace?: WorkspaceIdentity;
6843
+ agent?: Agent;
6844
+ filesystem?: WorkspaceFilesystem;
6845
+ };
6846
+ type WorkspaceSandboxToolName = "execute_command";
6847
+ declare const createWorkspaceSandboxToolkit: (context: WorkspaceSandboxToolkitContext, options?: WorkspaceSandboxToolkitOptions) => Toolkit;
6848
+
6849
+ type WorkspaceSearchMode = "bm25" | "vector" | "hybrid";
6850
+ type WorkspaceSearchIndexPath = {
6851
+ path: string;
6852
+ glob?: string;
6853
+ };
6854
+ type WorkspaceSearchHybridWeights = {
6855
+ lexicalWeight?: number;
6856
+ vectorWeight?: number;
6857
+ };
6858
+ type WorkspaceSearchConfig = {
6859
+ bm25?: {
6860
+ k1?: number;
6861
+ b?: number;
6862
+ };
6863
+ embedding?: EmbeddingAdapterInput;
6864
+ vector?: VectorAdapter;
6865
+ autoIndexPaths?: Array<WorkspaceSearchIndexPath | string>;
6866
+ maxFileBytes?: number;
6867
+ snippetLength?: number;
6868
+ defaultMode?: WorkspaceSearchMode;
6869
+ hybrid?: WorkspaceSearchHybridWeights;
6870
+ allowDirectAccess?: boolean;
6871
+ };
6872
+ type WorkspaceSearchOptions = {
6873
+ mode?: WorkspaceSearchMode;
6874
+ topK?: number;
6875
+ minScore?: number;
6876
+ path?: string;
6877
+ glob?: string;
6878
+ snippetLength?: number;
6879
+ lexicalWeight?: number;
6880
+ vectorWeight?: number;
6881
+ };
6882
+ type WorkspaceSearchResult = {
6883
+ id: string;
6884
+ path: string;
6885
+ score: number;
6886
+ content: string;
6887
+ lineRange?: {
6888
+ start: number;
6889
+ end: number;
6890
+ };
6891
+ scoreDetails?: {
6892
+ bm25?: number;
6893
+ vector?: number;
6894
+ };
6895
+ bm25Score?: number;
6896
+ vectorScore?: number;
6897
+ snippet?: string;
6898
+ metadata?: Record<string, unknown>;
6899
+ };
6900
+ type WorkspaceSearchIndexSummary = {
6901
+ indexed: number;
6902
+ vectorIndexed?: number;
6903
+ skipped: number;
6904
+ errors: string[];
6905
+ };
6906
+
6907
+ type WorkspaceSkillSearchMode = "bm25" | "vector" | "hybrid";
6908
+ type WorkspaceSkillSearchHybridWeights = {
6909
+ lexicalWeight?: number;
6910
+ vectorWeight?: number;
6911
+ };
6912
+ type WorkspaceSkillsRootResolverContext = {
6913
+ workspace: WorkspaceIdentity;
6914
+ filesystem: WorkspaceFilesystem;
6915
+ };
6916
+ type WorkspaceSkillsRootResolver = (context?: WorkspaceSkillsRootResolverContext) => string[] | undefined | null | Promise<string[] | undefined | null>;
6917
+ type WorkspaceSkillsConfig = {
6918
+ rootPaths?: string[] | WorkspaceSkillsRootResolver;
6919
+ glob?: string;
6920
+ maxFileBytes?: number;
6921
+ autoDiscover?: boolean;
6922
+ autoIndex?: boolean;
6923
+ bm25?: {
6924
+ k1?: number;
6925
+ b?: number;
6926
+ };
6927
+ embedding?: EmbeddingAdapterInput;
6928
+ vector?: VectorAdapter;
6929
+ defaultMode?: WorkspaceSkillSearchMode;
6930
+ hybrid?: WorkspaceSkillSearchHybridWeights;
6931
+ };
6932
+ type WorkspaceSkillMetadata = {
6933
+ id: string;
6934
+ name: string;
6935
+ description?: string;
6936
+ version?: string;
6937
+ tags?: string[];
6938
+ path: string;
6939
+ root: string;
6940
+ references?: string[];
6941
+ scripts?: string[];
6942
+ assets?: string[];
6943
+ };
6944
+ type WorkspaceSkill = WorkspaceSkillMetadata & {
6945
+ instructions: string;
6946
+ };
6947
+ type WorkspaceSkillSearchOptions = {
6948
+ mode?: WorkspaceSkillSearchMode;
6949
+ topK?: number;
6950
+ snippetLength?: number;
6951
+ lexicalWeight?: number;
6952
+ vectorWeight?: number;
6953
+ };
6954
+ type WorkspaceSkillSearchResult = {
6955
+ id: string;
6956
+ name: string;
6957
+ score: number;
6958
+ bm25Score?: number;
6959
+ vectorScore?: number;
6960
+ snippet?: string;
6961
+ metadata?: Record<string, unknown>;
6962
+ };
6963
+ type WorkspaceSkillIndexSummary = {
6964
+ indexed: number;
6965
+ skipped: number;
6966
+ errors: string[];
6967
+ };
6968
+ type WorkspaceSkillsPromptOptions = {
6969
+ includeAvailable?: boolean;
6970
+ includeActivated?: boolean;
6971
+ maxAvailable?: number;
6972
+ maxActivated?: number;
6973
+ maxInstructionChars?: number;
6974
+ maxPromptChars?: number;
6975
+ };
6976
+
6977
+ type WorkspaceScope = "agent" | "conversation";
6978
+ type WorkspaceStatus = "idle" | "initializing" | "ready" | "destroyed" | "error";
6979
+ type WorkspaceComponentStatus = "idle" | "ready" | "destroyed" | "error";
6980
+ type WorkspaceIdentity = {
6981
+ id: string;
6982
+ name?: string;
6983
+ scope?: WorkspaceScope;
6984
+ };
6985
+ type WorkspaceFilesystemConfig = {
6986
+ backend?: FilesystemBackend | FilesystemBackendFactory;
6987
+ files?: Record<string, FileData>;
6988
+ directories?: string[];
6989
+ readOnly?: boolean;
6990
+ };
6991
+ type WorkspaceComponentInfo = {
6992
+ status?: WorkspaceComponentStatus;
6993
+ details?: Record<string, unknown>;
6994
+ };
6995
+ type WorkspaceInfo = {
6996
+ id: string;
6997
+ name?: string;
6998
+ scope: WorkspaceScope;
6999
+ status: WorkspaceStatus;
7000
+ operationTimeoutMs?: number;
7001
+ filesystem?: WorkspaceComponentInfo;
7002
+ sandbox?: WorkspaceComponentInfo;
7003
+ search?: WorkspaceComponentInfo;
7004
+ skills?: WorkspaceComponentInfo;
7005
+ };
7006
+ type WorkspacePathContext = {
7007
+ filesystem?: {
7008
+ status?: WorkspaceComponentStatus;
7009
+ instructions?: string | null;
7010
+ info?: Record<string, unknown>;
7011
+ };
7012
+ sandbox?: {
7013
+ status?: WorkspaceComponentStatus;
7014
+ instructions?: string | null;
7015
+ info?: Record<string, unknown>;
7016
+ };
7017
+ };
7018
+ type WorkspaceConfig = {
7019
+ id?: string;
7020
+ name?: string;
7021
+ scope?: WorkspaceScope;
7022
+ operationTimeoutMs?: number;
7023
+ filesystem?: WorkspaceFilesystemConfig;
7024
+ sandbox?: WorkspaceSandbox;
7025
+ search?: WorkspaceSearchConfig;
7026
+ skills?: WorkspaceSkillsConfig;
7027
+ toolConfig?: WorkspaceToolConfig;
7028
+ };
7029
+
7030
+ type MaybePromise<T> = T | Promise<T>;
7031
+ interface FileInfo {
7032
+ path: string;
7033
+ is_dir?: boolean;
7034
+ size?: number;
7035
+ modified_at?: string;
7036
+ created_at?: string;
7037
+ }
7038
+ interface GrepMatch {
7039
+ path: string;
7040
+ line: number;
7041
+ text: string;
7042
+ }
7043
+ interface FileData {
7044
+ content: string[];
7045
+ created_at: string;
7046
+ modified_at: string;
7047
+ }
7048
+ interface WriteResult {
7049
+ error?: string;
7050
+ path?: string;
7051
+ filesUpdate?: Record<string, FileData | null> | null;
7052
+ metadata?: Record<string, unknown>;
7053
+ }
7054
+ interface WriteOptions {
7055
+ overwrite?: boolean;
7056
+ }
7057
+ interface EditResult {
7058
+ error?: string;
7059
+ path?: string;
7060
+ filesUpdate?: Record<string, FileData | null> | null;
7061
+ occurrences?: number;
7062
+ metadata?: Record<string, unknown>;
7063
+ }
7064
+ interface DeleteResult {
7065
+ error?: string;
7066
+ path?: string;
7067
+ filesUpdate?: Record<string, FileData | null> | null;
7068
+ metadata?: Record<string, unknown>;
7069
+ }
7070
+ interface DeleteOptions {
7071
+ recursive?: boolean;
7072
+ }
7073
+ interface MkdirResult {
7074
+ error?: string;
7075
+ path?: string;
7076
+ metadata?: Record<string, unknown>;
7077
+ }
7078
+ interface RmdirResult {
7079
+ error?: string;
7080
+ path?: string;
7081
+ filesUpdate?: Record<string, FileData | null> | null;
7082
+ metadata?: Record<string, unknown>;
7083
+ }
7084
+ interface FilesystemBackend {
7085
+ lsInfo(path: string): MaybePromise<FileInfo[]>;
7086
+ read(filePath: string, offset?: number, limit?: number): MaybePromise<string>;
7087
+ readRaw(filePath: string): MaybePromise<FileData>;
7088
+ stat?(filePath: string): MaybePromise<FileInfo | null>;
7089
+ exists?(filePath: string): MaybePromise<boolean>;
7090
+ grepRaw(pattern: string, path?: string | null, glob?: string | null): MaybePromise<GrepMatch[] | string>;
7091
+ globInfo(pattern: string, path?: string): MaybePromise<FileInfo[]>;
7092
+ write(filePath: string, content: string, options?: WriteOptions): MaybePromise<WriteResult>;
7093
+ edit(filePath: string, oldString: string, newString: string, replaceAll?: boolean): MaybePromise<EditResult>;
7094
+ delete?(filePath: string, options?: DeleteOptions): MaybePromise<DeleteResult>;
7095
+ mkdir?(path: string, recursive?: boolean): MaybePromise<MkdirResult>;
7096
+ rmdir?(path: string, recursive?: boolean): MaybePromise<RmdirResult>;
7097
+ }
7098
+ type FilesystemBackendContext = {
7099
+ agent?: Agent;
7100
+ operationContext?: OperationContext;
7101
+ state: {
7102
+ files?: Record<string, FileData>;
7103
+ directories?: Set<string>;
7104
+ };
7105
+ };
7106
+ type FilesystemBackendFactory = (context: FilesystemBackendContext) => FilesystemBackend;
7107
+
7108
+ declare class CompositeFilesystemBackend implements FilesystemBackend {
7109
+ private defaultBackend;
7110
+ private routes;
7111
+ private sortedRoutes;
7112
+ constructor(defaultBackend: FilesystemBackend, routes: Record<string, FilesystemBackend>);
7113
+ private getBackendAndKey;
7114
+ private getMountPrefix;
7115
+ private remapFilesUpdate;
7116
+ private remapFilesUpdateResult;
7117
+ lsInfo(path: string): Promise<FileInfo[]>;
7118
+ read(filePath: string, offset?: number, limit?: number): Promise<string>;
7119
+ readRaw(filePath: string): Promise<FileData>;
7120
+ stat(filePath: string): Promise<FileInfo | null>;
7121
+ exists(filePath: string): Promise<boolean>;
7122
+ grepRaw(pattern: string, path?: string, glob?: string | null): Promise<GrepMatch[] | string>;
7123
+ globInfo(pattern: string, path?: string): Promise<FileInfo[]>;
7124
+ write(filePath: string, content: string, options?: WriteOptions): Promise<WriteResult>;
7125
+ edit(filePath: string, oldString: string, newString: string, replaceAll?: boolean): Promise<EditResult>;
7126
+ delete(filePath: string, options?: DeleteOptions): Promise<DeleteResult>;
7127
+ mkdir(path: string, recursive?: boolean): Promise<MkdirResult>;
7128
+ rmdir(path: string, recursive?: boolean): Promise<RmdirResult>;
7129
+ }
7130
+
7131
+ declare class NodeFilesystemBackend implements FilesystemBackend {
7132
+ private cwd;
7133
+ private virtualMode;
7134
+ private readonly contained;
7135
+ private maxFileSizeBytes;
7136
+ constructor(options?: {
7137
+ rootDir?: string;
7138
+ virtualMode?: boolean;
7139
+ contained?: boolean;
7140
+ maxFileSizeMb?: number;
7141
+ });
7142
+ private resolvePath;
7143
+ private isEnoentError;
7144
+ private assertPathContained;
7145
+ private toVirtualPath;
7146
+ lsInfo(dirPath: string): Promise<FileInfo[]>;
7147
+ read(filePath: string, offset?: number, limit?: number): Promise<string>;
7148
+ readRaw(filePath: string): Promise<FileData>;
7149
+ stat(filePath: string): Promise<FileInfo | null>;
7150
+ exists(filePath: string): Promise<boolean>;
7151
+ write(filePath: string, content: string, options?: WriteOptions): Promise<WriteResult>;
7152
+ mkdir(dirPath: string, recursive?: boolean): Promise<MkdirResult>;
7153
+ edit(filePath: string, oldString: string, newString: string, replaceAll?: boolean): Promise<EditResult>;
7154
+ delete(filePath: string, options?: DeleteOptions): Promise<DeleteResult>;
7155
+ rmdir(dirPath: string, recursive?: boolean): Promise<RmdirResult>;
7156
+ grepRaw(pattern: string, dirPath?: string, glob?: string | null): Promise<GrepMatch[] | string>;
7157
+ private ripgrepSearch;
7158
+ private fallbackSearch;
7159
+ globInfo(pattern: string, searchPath?: string): Promise<FileInfo[]>;
7160
+ }
7161
+
7162
+ declare class InMemoryFilesystemBackend implements FilesystemBackend {
7163
+ private files;
7164
+ private directories;
7165
+ constructor(files?: Record<string, FileData>, directories?: Set<string>);
7166
+ private getFiles;
7167
+ private getDirectories;
7168
+ private normalizeDirPath;
7169
+ private hasDirectory;
7170
+ lsInfo(path: string): FileInfo[];
7171
+ read(filePath: string, offset?: number, limit?: number): string;
7172
+ readRaw(filePath: string): FileData;
7173
+ stat(filePath: string): FileInfo | null;
7174
+ exists(filePath: string): boolean;
7175
+ write(filePath: string, content: string, options?: WriteOptions): WriteResult;
7176
+ edit(filePath: string, oldString: string, newString: string, replaceAll?: boolean): EditResult;
7177
+ delete(filePath: string, options?: DeleteOptions): DeleteResult;
7178
+ grepRaw(pattern: string, path?: string, glob?: string | null): GrepMatch[] | string;
7179
+ globInfo(pattern: string, path?: string): FileInfo[];
7180
+ mkdir(path: string, recursive?: boolean): MkdirResult;
7181
+ rmdir(path: string, recursive?: boolean): RmdirResult;
7182
+ }
7183
+
7184
+ type WorkspaceFilesystemToolName = "ls" | "read_file" | "write_file" | "edit_file" | "delete_file" | "stat" | "mkdir" | "rmdir" | "list_tree" | "list_files" | "glob" | "grep";
7185
+ type WorkspaceFilesystemToolkitOptions = {
7186
+ systemPrompt?: string | null;
7187
+ operationTimeoutMs?: number;
7188
+ customToolDescriptions?: Partial<Record<WorkspaceFilesystemToolName, string>> | null;
7189
+ toolPolicies?: WorkspaceToolPolicies<WorkspaceFilesystemToolName, WorkspaceFilesystemToolPolicy> | null;
7190
+ };
7191
+ type WorkspaceFilesystemOptions = {
7192
+ backend?: FilesystemBackend | FilesystemBackendFactory;
7193
+ files?: Record<string, FileData>;
7194
+ directories?: string[];
7195
+ readOnly?: boolean;
7196
+ };
7197
+ type WorkspaceFilesystemCallContext = {
7198
+ agent?: Agent;
7199
+ operationContext?: OperationContext;
7200
+ };
7201
+ type WorkspaceFilesystemReadOptions = {
7202
+ offset?: number;
7203
+ limit?: number;
7204
+ context?: WorkspaceFilesystemCallContext;
7205
+ };
7206
+ type WorkspaceFilesystemWriteOptions = {
7207
+ overwrite?: boolean;
7208
+ ensureDirs?: boolean;
7209
+ context?: WorkspaceFilesystemCallContext;
7210
+ };
7211
+ type WorkspaceFilesystemSearchOptions = {
7212
+ path?: string;
7213
+ glob?: string | null;
7214
+ context?: WorkspaceFilesystemCallContext;
7215
+ };
7216
+ type WorkspaceFilesystemOperationOptions = {
7217
+ context?: WorkspaceFilesystemCallContext;
7218
+ };
7219
+ type WorkspaceFilesystemDeleteOptions = {
7220
+ recursive?: boolean;
7221
+ context?: WorkspaceFilesystemCallContext;
7222
+ };
7223
+ type WorkspaceFilesystemRmdirOptions = {
7224
+ recursive?: boolean;
7225
+ context?: WorkspaceFilesystemCallContext;
7226
+ };
7227
+ type WorkspaceFilesystemToolkitContext = {
7228
+ filesystem: WorkspaceFilesystem;
7229
+ workspace?: WorkspaceIdentity;
7230
+ agent?: Agent;
7231
+ };
7232
+ declare class WorkspaceFilesystem {
7233
+ private backend;
7234
+ private files;
7235
+ private directories;
7236
+ readonly readOnly: boolean;
7237
+ status: WorkspaceComponentStatus;
7238
+ constructor(options?: WorkspaceFilesystemOptions);
7239
+ private normalizeDirectoryPath;
7240
+ private buildBackendContext;
7241
+ private updateFiles;
7242
+ init(): void;
7243
+ destroy(): void;
7244
+ getInfo(): Record<string, unknown>;
7245
+ getInstructions(): string;
7246
+ lsInfo(path?: string, options?: WorkspaceFilesystemOperationOptions): Promise<FileInfo[]>;
7247
+ read(filePath: string, options?: WorkspaceFilesystemReadOptions): Promise<string>;
7248
+ readRaw(filePath: string, options?: WorkspaceFilesystemOperationOptions): Promise<FileData>;
7249
+ write(filePath: string, content: string, options?: WorkspaceFilesystemWriteOptions): Promise<WriteResult>;
7250
+ edit(filePath: string, oldString: string, newString: string, replaceAll?: boolean, options?: WorkspaceFilesystemOperationOptions): Promise<EditResult>;
7251
+ delete(filePath: string, options?: WorkspaceFilesystemDeleteOptions): Promise<DeleteResult>;
7252
+ globInfo(pattern: string, path?: string, options?: WorkspaceFilesystemOperationOptions): Promise<FileInfo[]>;
7253
+ stat(filePath: string, options?: WorkspaceFilesystemOperationOptions): Promise<FileInfo | null>;
7254
+ exists(filePath: string, options?: WorkspaceFilesystemOperationOptions): Promise<boolean>;
7255
+ mkdir(path: string, recursive?: boolean, options?: WorkspaceFilesystemOperationOptions): Promise<MkdirResult>;
7256
+ rmdir(path: string, recursive?: boolean, options?: WorkspaceFilesystemRmdirOptions): Promise<RmdirResult>;
7257
+ grepRaw(pattern: string, options?: WorkspaceFilesystemSearchOptions): Promise<GrepMatch[] | string>;
7258
+ }
7259
+ declare const createWorkspaceFilesystemToolkit: (context: WorkspaceFilesystemToolkitContext, options?: WorkspaceFilesystemToolkitOptions) => Toolkit;
7260
+
7261
+ type WorkspaceSearchToolkitOptions = {
7262
+ systemPrompt?: string | null;
7263
+ operationTimeoutMs?: number;
7264
+ customIndexDescription?: string | null;
7265
+ customIndexContentDescription?: string | null;
7266
+ customSearchDescription?: string | null;
7267
+ toolPolicies?: WorkspaceToolPolicies<WorkspaceSearchToolName> | null;
7268
+ };
7269
+ type WorkspaceSearchToolkitContext = {
7270
+ search?: WorkspaceSearch;
7271
+ workspace?: WorkspaceIdentity;
7272
+ agent?: Agent;
7273
+ filesystem?: WorkspaceFilesystem;
7274
+ };
7275
+ type WorkspaceSearchToolName = "workspace_index" | "workspace_index_content" | "workspace_search";
7276
+ type WorkspaceSearchDocument = {
7277
+ id: string;
7278
+ path: string;
7279
+ content: string;
7280
+ metadata?: Record<string, unknown>;
7281
+ };
7282
+ declare class WorkspaceSearch {
7283
+ private readonly filesystem;
7284
+ private readonly bm25;
7285
+ private readonly documents;
7286
+ private readonly embedding?;
7287
+ private readonly vector?;
7288
+ private readonly autoIndexPaths?;
7289
+ private readonly maxFileBytes;
7290
+ private readonly snippetLength;
7291
+ private readonly defaultMode;
7292
+ private readonly defaultWeights;
7293
+ private autoIndexPromise?;
7294
+ status: WorkspaceComponentStatus;
7295
+ constructor(options: WorkspaceSearchConfig & {
7296
+ filesystem: WorkspaceFilesystem;
7297
+ });
7298
+ init(): Promise<void>;
7299
+ destroy(): void;
7300
+ getInfo(): Record<string, unknown>;
7301
+ getInstructions(): string;
7302
+ private ensureAutoIndex;
7303
+ indexPaths(paths?: Array<WorkspaceSearchIndexPath | string>, options?: {
7304
+ maxFileBytes?: number;
7305
+ }): Promise<WorkspaceSearchIndexSummary>;
7306
+ indexDocuments(docs: WorkspaceSearchDocument[]): Promise<WorkspaceSearchIndexSummary>;
7307
+ indexContent(path: string, content: string, metadata?: Record<string, unknown>): Promise<WorkspaceSearchIndexSummary>;
7308
+ search(query: string, options?: WorkspaceSearchOptions): Promise<WorkspaceSearchResult[]>;
7309
+ private resolveMode;
7310
+ private searchVector;
7311
+ private formatResults;
7312
+ }
7313
+ declare const createWorkspaceSearchToolkit: (context: WorkspaceSearchToolkitContext, options?: WorkspaceSearchToolkitOptions) => Toolkit;
7314
+
6709
7315
  interface OnStartHookArgs {
6710
7316
  agent: Agent;
6711
7317
  context: OperationContext;
@@ -6879,6 +7485,120 @@ type AgentHooks = {
6879
7485
  */
6880
7486
  declare function createHooks(hooks?: Partial<AgentHooks>): AgentHooks;
6881
7487
 
7488
+ type WorkspaceSkillsToolkitOptions = {
7489
+ systemPrompt?: string | null;
7490
+ operationTimeoutMs?: number;
7491
+ customToolDescriptions?: Partial<{
7492
+ list: string;
7493
+ search: string;
7494
+ read: string;
7495
+ activate: string;
7496
+ deactivate: string;
7497
+ readReference: string;
7498
+ readScript: string;
7499
+ readAsset: string;
7500
+ }> | null;
7501
+ toolPolicies?: WorkspaceToolPolicies<WorkspaceSkillsToolName> | null;
7502
+ };
7503
+ type WorkspaceSkillsToolkitContext = {
7504
+ skills?: WorkspaceSkills;
7505
+ workspace?: WorkspaceIdentity;
7506
+ agent?: Agent;
7507
+ };
7508
+ type WorkspaceSkillsToolName = "workspace_list_skills" | "workspace_search_skills" | "workspace_read_skill" | "workspace_activate_skill" | "workspace_deactivate_skill" | "workspace_read_skill_reference" | "workspace_read_skill_script" | "workspace_read_skill_asset";
7509
+ type WorkspaceSkillsPromptHookContext = {
7510
+ skills?: WorkspaceSkills;
7511
+ };
7512
+ declare class WorkspaceSkills {
7513
+ private readonly filesystem;
7514
+ private readonly workspaceIdentity;
7515
+ private rootPaths;
7516
+ private readonly rootResolver?;
7517
+ private rootResolved;
7518
+ private rootResolvePromise?;
7519
+ private readonly glob;
7520
+ private readonly maxFileBytes;
7521
+ private readonly bm25Options?;
7522
+ private bm25;
7523
+ private readonly embedding?;
7524
+ private readonly vector?;
7525
+ private readonly defaultMode;
7526
+ private readonly defaultWeights;
7527
+ private readonly skillsById;
7528
+ private readonly skillNameMap;
7529
+ private readonly skillCache;
7530
+ private readonly activeSkills;
7531
+ private readonly documents;
7532
+ private readonly indexedSkillIds;
7533
+ private discovered;
7534
+ private indexed;
7535
+ private autoDiscoverPromise?;
7536
+ private autoIndexPromise?;
7537
+ status: WorkspaceComponentStatus;
7538
+ constructor(options: WorkspaceSkillsConfig & {
7539
+ filesystem: WorkspaceFilesystem;
7540
+ workspace: WorkspaceSkillsRootResolverContext["workspace"];
7541
+ });
7542
+ init(): Promise<void>;
7543
+ destroy(): void;
7544
+ getInfo(): Record<string, unknown>;
7545
+ getInstructions(): string;
7546
+ private ensureDiscovered;
7547
+ private ensureRootPaths;
7548
+ private ensureIndexed;
7549
+ discoverSkills(options?: {
7550
+ refresh?: boolean;
7551
+ }): Promise<WorkspaceSkillMetadata[]>;
7552
+ loadSkill(identifier: string): Promise<WorkspaceSkill | null>;
7553
+ activateSkill(identifier: string): Promise<WorkspaceSkillMetadata | null>;
7554
+ deactivateSkill(identifier: string): Promise<boolean>;
7555
+ getActiveSkills(): WorkspaceSkillMetadata[];
7556
+ indexSkills(): Promise<WorkspaceSkillIndexSummary>;
7557
+ search(query: string, options?: WorkspaceSkillSearchOptions): Promise<WorkspaceSkillSearchResult[]>;
7558
+ buildPrompt(options?: WorkspaceSkillsPromptOptions): Promise<string | null>;
7559
+ private resolveMode;
7560
+ private searchVector;
7561
+ private formatResults;
7562
+ private resolveSkillId;
7563
+ resolveSkillFilePath(skill: WorkspaceSkillMetadata, relativePath: string, allowed: string[] | undefined): string | null;
7564
+ readFileContent(filePath: string): Promise<string>;
7565
+ }
7566
+ declare const createWorkspaceSkillsPromptHook: (context: WorkspaceSkillsPromptHookContext, options?: WorkspaceSkillsPromptOptions) => AgentHooks;
7567
+ declare const createWorkspaceSkillsToolkit: (context: WorkspaceSkillsToolkitContext, options?: WorkspaceSkillsToolkitOptions) => Toolkit;
7568
+
7569
+ declare class Workspace {
7570
+ readonly id: string;
7571
+ readonly name?: string;
7572
+ readonly scope: WorkspaceScope;
7573
+ readonly filesystem: WorkspaceFilesystem;
7574
+ readonly sandbox?: WorkspaceSandbox;
7575
+ private readonly searchService?;
7576
+ private readonly allowDirectSearchAccess;
7577
+ private readonly operationTimeoutMs?;
7578
+ readonly skills?: WorkspaceSkills;
7579
+ private readonly toolConfig?;
7580
+ status: WorkspaceStatus;
7581
+ private initPromise?;
7582
+ constructor(options?: WorkspaceConfig);
7583
+ init(): Promise<void>;
7584
+ destroy(): Promise<void>;
7585
+ private isDestroyed;
7586
+ getInfo(): WorkspaceInfo;
7587
+ getPathContext(): WorkspacePathContext;
7588
+ getToolsConfig(): WorkspaceToolConfig | undefined;
7589
+ getObservabilityAttributes(): Record<string, unknown>;
7590
+ private applyOperationTimeout;
7591
+ private resolveSearchToolPolicy;
7592
+ private assertDirectSearchAllowed;
7593
+ index(path: string, content: string, metadata?: Record<string, unknown>): Promise<WorkspaceSearchIndexSummary>;
7594
+ search(query: string, options?: WorkspaceSearchOptions): Promise<WorkspaceSearchResult[]>;
7595
+ createFilesystemToolkit(options?: WorkspaceFilesystemToolkitOptions): Toolkit;
7596
+ createSandboxToolkit(options?: WorkspaceSandboxToolkitOptions): Toolkit;
7597
+ createSearchToolkit(options?: WorkspaceSearchToolkitOptions): Toolkit;
7598
+ createSkillsToolkit(options?: WorkspaceSkillsToolkitOptions): Toolkit;
7599
+ createSkillsPromptHook(options?: WorkspaceSkillsPromptOptions): AgentHooks;
7600
+ }
7601
+
6882
7602
  /**
6883
7603
  * AgentTraceContext - Manages trace hierarchy and common attributes
6884
7604
  *
@@ -7023,6 +7743,12 @@ type AgentFeedbackMetadata = {
7023
7743
  type ToolWithNodeId = (BaseTool | ProviderTool) & {
7024
7744
  node_id: string;
7025
7745
  };
7746
+ type WorkspaceToolkitOptions = {
7747
+ filesystem?: WorkspaceFilesystemToolkitOptions | false;
7748
+ sandbox?: WorkspaceSandboxToolkitOptions | false;
7749
+ search?: WorkspaceSearchToolkitOptions | false;
7750
+ skills?: WorkspaceSkillsToolkitOptions | false;
7751
+ };
7026
7752
  interface AgentScorerState {
7027
7753
  key: string;
7028
7754
  id: string;
@@ -7398,6 +8124,8 @@ type AgentOptions = {
7398
8124
  tools?: (Tool<any, any> | Toolkit | Tool$1)[] | DynamicValue<(Tool<any, any> | Toolkit)[]>;
7399
8125
  toolkits?: Toolkit[];
7400
8126
  toolRouting?: ToolRoutingConfig | false;
8127
+ workspace?: Workspace | WorkspaceConfig | false;
8128
+ workspaceToolkits?: WorkspaceToolkitOptions | false;
7401
8129
  memory?: Memory | false;
7402
8130
  summarization?: AgentSummarizationOptions | false;
7403
8131
  retriever?: BaseRetriever;
@@ -8285,7 +9013,7 @@ interface GenerateObjectResultWithContext<T> extends GenerateObjectResult<T> {
8285
9013
  * Base options for all generation methods
8286
9014
  * Extends AI SDK's CallSettings for full compatibility
8287
9015
  */
8288
- interface BaseGenerationOptions extends Partial<CallSettings> {
9016
+ interface BaseGenerationOptions<TProviderOptions extends ProviderOptions$1 = ProviderOptions$1> extends Partial<CallSettings> {
8289
9017
  userId?: string;
8290
9018
  conversationId?: string;
8291
9019
  context?: ContextInput;
@@ -8321,7 +9049,7 @@ interface BaseGenerationOptions extends Partial<CallSettings> {
8321
9049
  inputMiddlewares?: InputMiddleware[];
8322
9050
  outputMiddlewares?: OutputMiddleware<any>[];
8323
9051
  maxMiddlewareRetries?: number;
8324
- providerOptions?: ProviderOptions$1;
9052
+ providerOptions?: TProviderOptions;
8325
9053
  output?: OutputSpec$1;
8326
9054
  /**
8327
9055
  * Optional explicit stop sequences to pass through to the underlying provider.
@@ -8333,10 +9061,10 @@ interface BaseGenerationOptions extends Partial<CallSettings> {
8333
9061
  */
8334
9062
  toolChoice?: ToolChoice<Record<string, unknown>>;
8335
9063
  }
8336
- type GenerateTextOptions<OUTPUT extends OutputSpec$1 = OutputSpec$1> = Omit<BaseGenerationOptions, "output"> & {
9064
+ type GenerateTextOptions<OUTPUT extends OutputSpec$1 = OutputSpec$1, TProviderOptions extends ProviderOptions$1 = ProviderOptions$1> = Omit<BaseGenerationOptions<TProviderOptions>, "output"> & {
8337
9065
  output?: OUTPUT;
8338
9066
  };
8339
- type StreamTextOptions = BaseGenerationOptions & {
9067
+ type StreamTextOptions<TProviderOptions extends ProviderOptions$1 = ProviderOptions$1> = BaseGenerationOptions<TProviderOptions> & {
8340
9068
  onFinish?: (result: any) => void | Promise<void>;
8341
9069
  /**
8342
9070
  * When true, avoids wiring the HTTP abort signal into the stream so clients can resume later.
@@ -8344,8 +9072,8 @@ type StreamTextOptions = BaseGenerationOptions & {
8344
9072
  */
8345
9073
  resumableStream?: boolean;
8346
9074
  };
8347
- type GenerateObjectOptions = BaseGenerationOptions;
8348
- type StreamObjectOptions = BaseGenerationOptions & {
9075
+ type GenerateObjectOptions<TProviderOptions extends ProviderOptions$1 = ProviderOptions$1> = BaseGenerationOptions<TProviderOptions>;
9076
+ type StreamObjectOptions<TProviderOptions extends ProviderOptions$1 = ProviderOptions$1> = BaseGenerationOptions<TProviderOptions> & {
8349
9077
  onFinish?: (result: any) => void | Promise<void>;
8350
9078
  };
8351
9079
  declare class Agent {
@@ -8372,6 +9100,7 @@ declare class Agent {
8372
9100
  private readonly memory?;
8373
9101
  private readonly memoryConfigured;
8374
9102
  private readonly summarization?;
9103
+ private readonly workspace?;
8375
9104
  private defaultObservability?;
8376
9105
  private readonly toolManager;
8377
9106
  private readonly toolPoolManager;
@@ -8395,21 +9124,21 @@ declare class Agent {
8395
9124
  /**
8396
9125
  * Generate text response
8397
9126
  */
8398
- generateText<OUTPUT extends OutputSpec$1 = OutputSpec$1>(input: string | UIMessage[] | BaseMessage[], options?: GenerateTextOptions<OUTPUT>): Promise<GenerateTextResultWithContext<ToolSet, OUTPUT>>;
9127
+ generateText<OUTPUT extends OutputSpec$1 = OutputSpec$1, TProviderOptions extends ProviderOptions$1 = ProviderOptions$1>(input: string | UIMessage[] | BaseMessage[], options?: GenerateTextOptions<OUTPUT, TProviderOptions>): Promise<GenerateTextResultWithContext<ToolSet, OUTPUT>>;
8399
9128
  /**
8400
9129
  * Stream text response
8401
9130
  */
8402
- streamText(input: string | UIMessage[] | BaseMessage[], options?: StreamTextOptions): Promise<StreamTextResultWithContext>;
9131
+ streamText<TProviderOptions extends ProviderOptions$1 = ProviderOptions$1>(input: string | UIMessage[] | BaseMessage[], options?: StreamTextOptions<TProviderOptions>): Promise<StreamTextResultWithContext>;
8403
9132
  /**
8404
9133
  * Generate structured object
8405
9134
  * @deprecated — Use generateText with an output setting instead.
8406
9135
  */
8407
- generateObject<T extends z.ZodType>(input: string | UIMessage[] | BaseMessage[], schema: T, options?: GenerateObjectOptions): Promise<GenerateObjectResultWithContext<z.infer<T>>>;
9136
+ generateObject<T extends z.ZodType, TProviderOptions extends ProviderOptions$1 = ProviderOptions$1>(input: string | UIMessage[] | BaseMessage[], schema: T, options?: GenerateObjectOptions<TProviderOptions>): Promise<GenerateObjectResultWithContext<z.infer<T>>>;
8408
9137
  /**
8409
9138
  * Stream structured object
8410
9139
  * @deprecated — Use streamText with an output setting instead.
8411
9140
  */
8412
- streamObject<T extends z.ZodType>(input: string | UIMessage[] | BaseMessage[], schema: T, options?: StreamObjectOptions): Promise<StreamObjectResultWithContext<z.infer<T>>>;
9141
+ streamObject<T extends z.ZodType, TProviderOptions extends ProviderOptions$1 = ProviderOptions$1>(input: string | UIMessage[] | BaseMessage[], schema: T, options?: StreamObjectOptions<TProviderOptions>): Promise<StreamObjectResultWithContext<z.infer<T>>>;
8413
9142
  private resolveGuardrailSets;
8414
9143
  private resolveMiddlewareSets;
8415
9144
  private resolveMiddlewareRetries;
@@ -8628,6 +9357,10 @@ declare class Agent {
8628
9357
  * Get tool manager
8629
9358
  */
8630
9359
  getToolManager(): ToolManager;
9360
+ /**
9361
+ * Get Workspace instance if configured
9362
+ */
9363
+ getWorkspace(): Workspace | undefined;
8631
9364
  /**
8632
9365
  * Get Memory instance if available
8633
9366
  */
@@ -11071,122 +11804,12 @@ declare class WorkflowRegistry extends SimpleEventEmitter {
11071
11804
  */
11072
11805
  declare function createSuspendController(): WorkflowSuspendController;
11073
11806
 
11074
- type PlanAgentTodoStatus = "pending" | "in_progress" | "done";
11075
- type PlanAgentTodoItem = {
11076
- id: string;
11077
- content: string;
11078
- status: PlanAgentTodoStatus;
11079
- createdAt?: string;
11080
- updatedAt?: string;
11081
- };
11082
- type PlanAgentFileData = {
11083
- content: string[];
11084
- created_at: string;
11085
- modified_at: string;
11086
- };
11087
- type PlanAgentState = {
11088
- todos?: PlanAgentTodoItem[];
11089
- files?: Record<string, PlanAgentFileData>;
11090
- };
11091
-
11092
- type MaybePromise<T> = T | Promise<T>;
11093
- interface FileInfo {
11094
- path: string;
11095
- is_dir?: boolean;
11096
- size?: number;
11097
- modified_at?: string;
11098
- }
11099
- interface GrepMatch {
11100
- path: string;
11101
- line: number;
11102
- text: string;
11103
- }
11104
- type FileData = PlanAgentFileData;
11105
- interface WriteResult {
11106
- error?: string;
11107
- path?: string;
11108
- filesUpdate?: Record<string, FileData> | null;
11109
- metadata?: Record<string, unknown>;
11110
- }
11111
- interface EditResult {
11112
- error?: string;
11113
- path?: string;
11114
- filesUpdate?: Record<string, FileData> | null;
11115
- occurrences?: number;
11116
- metadata?: Record<string, unknown>;
11117
- }
11118
- interface FilesystemBackend {
11119
- lsInfo(path: string): MaybePromise<FileInfo[]>;
11120
- read(filePath: string, offset?: number, limit?: number): MaybePromise<string>;
11121
- readRaw(filePath: string): MaybePromise<FileData>;
11122
- grepRaw(pattern: string, path?: string | null, glob?: string | null): MaybePromise<GrepMatch[] | string>;
11123
- globInfo(pattern: string, path?: string): MaybePromise<FileInfo[]>;
11124
- write(filePath: string, content: string): MaybePromise<WriteResult>;
11125
- edit(filePath: string, oldString: string, newString: string, replaceAll?: boolean): MaybePromise<EditResult>;
11126
- }
11127
- type FilesystemBackendContext = {
11128
- agent: Agent;
11129
- operationContext: OperationContext;
11130
- state: {
11131
- files?: Record<string, FileData>;
11132
- };
11133
- };
11134
- type FilesystemBackendFactory = (context: FilesystemBackendContext) => FilesystemBackend;
11135
-
11136
- declare class CompositeFilesystemBackend implements FilesystemBackend {
11137
- private defaultBackend;
11138
- private routes;
11139
- private sortedRoutes;
11140
- constructor(defaultBackend: FilesystemBackend, routes: Record<string, FilesystemBackend>);
11141
- private getBackendAndKey;
11142
- lsInfo(path: string): Promise<FileInfo[]>;
11143
- read(filePath: string, offset?: number, limit?: number): Promise<string>;
11144
- readRaw(filePath: string): Promise<FileData>;
11145
- grepRaw(pattern: string, path?: string, glob?: string | null): Promise<GrepMatch[] | string>;
11146
- globInfo(pattern: string, path?: string): Promise<FileInfo[]>;
11147
- write(filePath: string, content: string): Promise<WriteResult>;
11148
- edit(filePath: string, oldString: string, newString: string, replaceAll?: boolean): Promise<EditResult>;
11149
- }
11150
-
11151
- declare class NodeFilesystemBackend implements FilesystemBackend {
11152
- private cwd;
11153
- private virtualMode;
11154
- private maxFileSizeBytes;
11155
- constructor(options?: {
11156
- rootDir?: string;
11157
- virtualMode?: boolean;
11158
- maxFileSizeMb?: number;
11159
- });
11160
- private resolvePath;
11161
- lsInfo(dirPath: string): Promise<FileInfo[]>;
11162
- read(filePath: string, offset?: number, limit?: number): Promise<string>;
11163
- readRaw(filePath: string): Promise<FileData>;
11164
- write(filePath: string, content: string): Promise<WriteResult>;
11165
- edit(filePath: string, oldString: string, newString: string, replaceAll?: boolean): Promise<EditResult>;
11166
- grepRaw(pattern: string, dirPath?: string, glob?: string | null): Promise<GrepMatch[] | string>;
11167
- private ripgrepSearch;
11168
- private fallbackSearch;
11169
- globInfo(pattern: string, searchPath?: string): Promise<FileInfo[]>;
11170
- }
11171
-
11172
- declare class InMemoryFilesystemBackend implements FilesystemBackend {
11173
- private files;
11174
- constructor(files?: Record<string, FileData>);
11175
- private getFiles;
11176
- lsInfo(path: string): FileInfo[];
11177
- read(filePath: string, offset?: number, limit?: number): string;
11178
- readRaw(filePath: string): FileData;
11179
- write(filePath: string, content: string): WriteResult;
11180
- edit(filePath: string, oldString: string, newString: string, replaceAll?: boolean): EditResult;
11181
- grepRaw(pattern: string, path?: string, glob?: string | null): GrepMatch[] | string;
11182
- globInfo(pattern: string, path?: string): FileInfo[];
11183
- }
11184
-
11185
- declare const FILESYSTEM_SYSTEM_PROMPT = "You have access to a virtual filesystem. All file paths must start with a /.\n\n- ls: list files in a directory (requires absolute path)\n- read_file: read a file from the filesystem\n- write_file: write to a file in the filesystem\n- edit_file: edit a file in the filesystem\n- glob: find files matching a pattern (e.g., \"**/*.ts\")\n- grep: search for text within files";
11807
+ declare const FILESYSTEM_SYSTEM_PROMPT = "You have access to a virtual filesystem. All file paths must start with a /.\n\n- ls: list files in a directory (requires absolute path)\n- read_file: read a file from the filesystem\n- write_file: write to a file in the filesystem\n- edit_file: edit a file in the filesystem\n- delete_file: delete a file from the filesystem\n- glob: find files matching a pattern (e.g., \"**/*.ts\")\n- grep: search for text within files";
11186
11808
  declare const LS_TOOL_DESCRIPTION = "List files and directories in a directory";
11187
11809
  declare const READ_FILE_TOOL_DESCRIPTION = "Read the contents of a file";
11188
11810
  declare const WRITE_FILE_TOOL_DESCRIPTION = "Write content to a new file. Returns an error if the file already exists";
11189
11811
  declare const EDIT_FILE_TOOL_DESCRIPTION = "Edit a file by replacing a specific string with a new string";
11812
+ declare const DELETE_FILE_TOOL_DESCRIPTION = "Delete a file from the filesystem";
11190
11813
  declare const GLOB_TOOL_DESCRIPTION = "Find files matching a glob pattern (e.g., '**/*.ts' for all TypeScript files)";
11191
11814
  declare const GREP_TOOL_DESCRIPTION = "Search for a regex pattern in files. Returns matching files and line numbers";
11192
11815
  type FilesystemToolkitOptions = {
@@ -11203,6 +11826,20 @@ declare function createToolResultEvictor(options: {
11203
11826
  excludeToolNames?: string[];
11204
11827
  }): (tool: Tool<any, any>) => Tool<any, any>;
11205
11828
 
11829
+ type PlanAgentTodoStatus = "pending" | "in_progress" | "done";
11830
+ type PlanAgentTodoItem = {
11831
+ id: string;
11832
+ content: string;
11833
+ status: PlanAgentTodoStatus;
11834
+ createdAt?: string;
11835
+ updatedAt?: string;
11836
+ };
11837
+ type PlanAgentFileData = FileData;
11838
+ type PlanAgentState = {
11839
+ todos?: PlanAgentTodoItem[];
11840
+ files?: Record<string, PlanAgentFileData>;
11841
+ };
11842
+
11206
11843
  type TodoBackend = {
11207
11844
  listTodos(): Promise<PlanAgentTodoItem[]>;
11208
11845
  setTodos(todos: PlanAgentTodoItem[]): Promise<void>;
@@ -11243,7 +11880,7 @@ type TaskToolOptions = {
11243
11880
  maxSteps?: number;
11244
11881
  supervisorConfig?: SupervisorConfig;
11245
11882
  };
11246
- type PlanAgentOptions = Omit<AgentOptions, "instructions" | "tools" | "toolkits" | "subAgents" | "supervisorConfig"> & {
11883
+ type PlanAgentOptions = Omit<AgentOptions, "instructions" | "tools" | "toolkits" | "subAgents" | "supervisorConfig" | "workspace" | "workspaceToolkits"> & {
11247
11884
  systemPrompt?: InstructionsDynamicValue;
11248
11885
  tools?: (Tool<any, any> | Toolkit | Tool$1)[];
11249
11886
  toolkits?: Toolkit[];
@@ -13046,6 +13683,11 @@ type VoltAgentOptions = {
13046
13683
  * When enabled, agents expose searchTools/callTool and hide pool tools from the model.
13047
13684
  */
13048
13685
  toolRouting?: ToolRoutingConfig;
13686
+ /**
13687
+ * Optional global workspace instance or configuration.
13688
+ * Agents inherit this workspace unless they explicitly provide their own workspace or set it to false.
13689
+ */
13690
+ workspace?: Workspace | WorkspaceConfig;
13049
13691
  /** Optional VoltOps trigger handlers */
13050
13692
  triggers?: VoltAgentTriggersConfig;
13051
13693
  /**
@@ -14600,6 +15242,7 @@ declare class AgentRegistry {
14600
15242
  private globalAgentMemory?;
14601
15243
  private globalWorkflowMemory?;
14602
15244
  private globalToolRouting?;
15245
+ private globalWorkspace?;
14603
15246
  /**
14604
15247
  * Track parent-child relationships between agents (child -> parents)
14605
15248
  */
@@ -14718,6 +15361,14 @@ declare class AgentRegistry {
14718
15361
  * Get the global default tool routing configuration.
14719
15362
  */
14720
15363
  getGlobalToolRouting(): ToolRoutingConfig | undefined;
15364
+ /**
15365
+ * Set the global Workspace instance.
15366
+ */
15367
+ setGlobalWorkspace(workspace: Workspace | undefined): void;
15368
+ /**
15369
+ * Get the global Workspace instance.
15370
+ */
15371
+ getGlobalWorkspace(): Workspace | undefined;
14721
15372
  }
14722
15373
 
14723
15374
  type UpdateOptions = {
@@ -14788,6 +15439,9 @@ declare class VoltAgent {
14788
15439
  private readonly ensureEnvironmentBinding;
14789
15440
  private readonly triggerRegistry;
14790
15441
  private readonly agentRefs;
15442
+ readonly ready: Promise<void>;
15443
+ initError?: unknown;
15444
+ degraded: boolean;
14791
15445
  constructor(options: VoltAgentOptions);
14792
15446
  serverless(): IServerlessProvider;
14793
15447
  private ensureEnvironment;
@@ -14889,4 +15543,4 @@ declare class VoltAgent {
14889
15543
  */
14890
15544
  declare function convertUsage(usage: LanguageModelUsage | undefined): UsageInfo | undefined;
14891
15545
 
14892
- export { A2AServerRegistry, AbortError, Agent, type AgentEvalConfig, type AgentEvalContext, type AgentEvalFeedbackHelper, type AgentEvalFeedbackSaveInput, type AgentEvalOperationType, type AgentEvalPayload, type AgentEvalResult, type AgentEvalResultCallbackArgs, type AgentEvalSamplingPolicy, type AgentEvalScorerConfig, type AgentEvalScorerFactory, type AgentEvalScorerReference, type AgentFeedbackMetadata, type AgentFeedbackOptions, type AgentFullState, type AgentHookOnEnd, type AgentHookOnError, type AgentHookOnFallback, type AgentHookOnHandoff, type AgentHookOnHandoffComplete, type AgentHookOnPrepareMessages, type AgentHookOnPrepareModelMessages, type AgentHookOnRetry, type AgentHookOnStart, type AgentHookOnStepFinish, type AgentHookOnToolEnd, type AgentHookOnToolStart, type AgentHooks, type AgentModelConfig, type AgentModelReference, type AgentModelValue, type AgentOptions, AgentRegistry, type AgentResponse, type AgentScorerState, type AgentStatus, type AgentSummarizationOptions, type AgentTool, AiSdkEmbeddingAdapter, type AllowedVariableValue, type ApiToolInfo, type BaseEventMetadata, type BaseGenerationOptions, type BaseLLMOptions, type BaseMessage, BaseRetriever, type BaseTool, type BaseToolCall, type BuildScorerOptions, type BuildScorerRunArgs, type BuildScorerRunResult, type BuilderAnalyzeContext, type BuilderPrepareContext, type BuilderReasonContext, type BuilderScoreContext, type CachedPrompt, type ChatMessage, ClientHTTPError, type ClientSideToolResult, type CloudflareFetchHandler, CompositeFilesystemBackend, type Conversation, ConversationAlreadyExistsError, ConversationNotFoundError, type ConversationQueryOptions, type ConversationQueryOptions as ConversationQueryOptionsV2, type ConversationStepRecord, type ConversationStepType, type ConversationTitleConfig, type ConversationTitleGenerator, ConversationTodoBackend, type Conversation as ConversationV2, type CreateConversationInput, type CreateConversationInput as CreateConversationInputV2, type CreateInputGuardrailOptions, type CreateInputMiddlewareOptions, type CreateOutputGuardrailOptions, type CreateOutputMiddlewareOptions, type CreateReasoningToolsOptions, type CreateScorerOptions, DEFAULT_INSTRUCTIONS, type DataContent, type Document, type DynamicValue, type DynamicValueOptions, EDIT_FILE_TOOL_DESCRIPTION, type EditResult, type EmbeddingAdapter, type EmbeddingAdapterConfig, type EmbeddingAdapterInput, EmbeddingAdapterNotConfiguredError, EmbeddingError, type EmbeddingModelFactory, type EmbeddingModelReference, type EmbeddingRouterModelId, type ExtractVariableNames, FEW_SHOT_EXAMPLES, FILESYSTEM_SYSTEM_PROMPT, type FallbackStage, type FileData, type FileInfo, type FilesystemBackend, type FilesystemBackendContext, type FilesystemBackendFactory, type FilesystemToolkitOptions, GLOB_TOOL_DESCRIPTION, GREP_TOOL_DESCRIPTION, type GenerateObjectOptions, type GenerateObjectResultWithContext, type GenerateObjectSubAgentConfig, type GenerateReasonResult, type GenerateScoreResult, type GenerateScoreStep, type GenerateTextOptions, type GenerateTextResultWithContext, type GenerateTextSubAgentConfig, type GetConversationStepsOptions, type GetMessagesOptions, type GrepMatch, type GuardrailAction, type GuardrailContext, type GuardrailDefinition, type GuardrailFunction, type GuardrailSeverity, type IServerProvider, type IServerlessProvider, type VoltOpsClient$1 as IVoltOpsClient, InMemoryFilesystemBackend, InMemoryStorageAdapter$1 as InMemoryObservabilityAdapter, InMemoryStorageAdapter, InMemoryVectorAdapter, type InferGenerateObjectResponse, type InferGenerateTextResponse, type InferMessage, type InferModel, type InferProviderParams, type InferStreamResponse, type InferTool, type InputGuardrail, type InputGuardrailArgs, type InputGuardrailResult, type InputMiddleware, type InputMiddlewareArgs, type InputMiddlewareResult, type KnowledgeBaseTagFilter, type LLMProvider, LS_TOOL_DESCRIPTION, type LanguageModelFactory, LazyRemoteExportProcessor, type LocalScorerDefinition, type LocalScorerExecutionResult, LocalStorageSpanProcessor, type LogFilter, LoggerProxy, type MCPAuthorizationAction, type MCPAuthorizationConfig, type MCPAuthorizationContext, MCPAuthorizationError, type MCPCanFunction, type MCPCanParams, type MCPCanResult, MCPClient, type MCPClientCallOptions, type MCPClientConfig, MCPConfiguration, type MCPConfigurationOptions, type MCPElicitationAdapter, type MCPElicitationHandler, type MCPLoggingAdapter, type MCPPromptsAdapter, type MCPResourcesAdapter, MCPServerRegistry, type ManagedMemoryAddMessageInput, type ManagedMemoryAddMessagesInput, type ManagedMemoryClearMessagesInput, type ManagedMemoryConnectionInfo, type ManagedMemoryConversationsClient, type ManagedMemoryCredentialCreateResult, type ManagedMemoryCredentialListResult, type ManagedMemoryCredentialSummary, type ManagedMemoryDatabaseSummary, type ManagedMemoryDeleteMessagesInput, type ManagedMemoryGetMessagesInput, type ManagedMemoryMessagesClient, type ManagedMemoryQueryWorkflowRunsInput, type ManagedMemorySetWorkingMemoryInput, type ManagedMemoryStatus, type ManagedMemoryUpdateConversationInput, type ManagedMemoryVoltOpsClient, type ManagedMemoryWorkflowStateUpdateInput, type ManagedMemoryWorkflowStatesClient, type ManagedMemoryWorkingMemoryClient, type ManagedMemoryWorkingMemoryInput, Memory, type MemoryConfig, type MemoryOptions, type MemoryStorageMetadata, type MemoryUpdateMode, Memory as MemoryV2, MemoryV2Error, type MessageContent, MessageContentBuilder, type MessageRole, MiddlewareAbortError, type MiddlewareAbortOptions, type MiddlewareContext, type MiddlewareDefinition, type MiddlewareDirection, type MiddlewareFunction, type ModelForProvider, type ModelProvider, type ModelProviderEntry, type ModelProviderLoader, ModelProviderRegistry, type ModelRouterModelId, type ModelToolCall, NextAction, NodeFilesystemBackend, NodeType, VoltAgentObservability$1 as NodeVoltAgentObservability, type ObservabilityConfig, type ObservabilityLogRecord, type ObservabilitySpan, type ObservabilityStorageAdapter, type ObservabilityWebSocketEvent, type OnEndHookArgs, type OnErrorHookArgs, type OnFallbackHookArgs, type OnHandoffCompleteHookArgs, type OnHandoffHookArgs, type OnPrepareMessagesHookArgs, type OnPrepareMessagesHookResult, type OnPrepareModelMessagesHookArgs, type OnPrepareModelMessagesHookResult, type OnRetryHookArgs, type OnRetryHookArgsBase, type OnRetryLLMHookArgs, type OnRetryMiddlewareHookArgs, type OnStartHookArgs, type OnStepFinishHookArgs, type OnToolEndHookArgs, type OnToolEndHookResult, type OnToolStartHookArgs, type OperationContext, type OutputGuardrail, type OutputGuardrailArgs, type OutputGuardrailResult, type OutputMiddleware, type OutputMiddlewareArgs, type OutputMiddlewareResult, type OutputSpec$1 as OutputSpec, type PackageUpdateInfo, PlanAgent, type PlanAgentExtension, type PlanAgentExtensionContext, type PlanAgentExtensionResult, type PlanAgentFileData, type PlanAgentOptions, type PlanAgentState, type PlanAgentSubagentDefinition, type PlanAgentTodoItem, type PlanAgentTodoStatus, type PlanningToolkitOptions, type PromptApiClient, type PromptApiResponse, type PromptContent, type PromptCreator, type PromptHelper, type PromptReference, type PromptTemplate, type ProviderId, type ProviderModelsMap, type ProviderObjectResponse, type ProviderObjectStreamResponse, type ProviderParams, type ProviderResponse, type ProviderTextResponse, type ProviderTextStreamResponse, type ProviderTool, READ_FILE_TOOL_DESCRIPTION, type RagKnowledgeBaseSummary, type RagSearchKnowledgeBaseChildChunk, type RagSearchKnowledgeBaseRequest, type RagSearchKnowledgeBaseResponse, type RagSearchKnowledgeBaseResult, type ReadableStreamType, type ReasoningStep, ReasoningStepSchema, type RegisterOptions, type RegisteredTrigger, type RegisteredWorkflow, type RemoteLogExportConfig, RemoteLogProcessor, type ResumableStreamAdapter, type ResumableStreamContext, type RetrieveOptions, type Retriever, type RetrieverOptions, type RetrySource, type RunLocalScorersArgs, type RunLocalScorersResult, SERVERLESS_ENV_CONTEXT_KEY, type SamplingMetadata, type SamplingPolicy, type ScorerBuilder, type ScorerContext, type ScorerLifecycleScope, type ScorerPipelineContext, type ScorerReasonContext, type ScorerResult, type SearchOptions, type SearchResult$1 as SearchResult, type ServerAgentResponse, type ServerApiResponse, type ServerProviderDeps, type ServerProviderFactory, type ServerWorkflowResponse, type ServerlessProviderFactory, type ServerlessRemoteEndpointConfig, type ServerlessRemoteExportConfig, type ServerlessRequestHandler, ServerlessVoltAgentObservability, type SpanAttributes, type SpanEvent, type SpanFilterConfig, SpanFilterProcessor, SpanKind, type SpanLink, type SpanStatus, SpanStatusCode, type SpanTreeNode, type StepChunkCallback, type StepFinishCallback, type StepWithContent, type StopWhen, type StorageAdapter, StorageError, StorageLogProcessor, type StoredUIMessage, type StreamObjectFinishResult, type StreamObjectOnFinishCallback, type StreamObjectOptions, type StreamObjectResultWithContext, type StreamObjectSubAgentConfig, type StreamPart, type StreamTextFinishResult, type StreamTextOnFinishCallback, type StreamTextOptions, type StreamTextResultWithContext, type StreamTextSubAgentConfig, type SubAgentConfig, type SubAgentMethod, type SubAgentStateData, type SupervisorConfig, TRIGGER_CONTEXT_KEY, type TaskToolOptions, type TemplateVariables, type TimelineEventCoreLevel, type TimelineEventCoreStatus, type TimelineEventCoreType, type TodoBackend, type TodoBackendFactory, Tool, type ToolCall, type ToolContext, ToolDeniedError, type ToolErrorInfo, type ToolExecuteOptions, type ToolExecutionResult, type ToolHookOnEnd, type ToolHookOnEndArgs, type ToolHookOnEndResult, type ToolHookOnStart, type ToolHookOnStartArgs, type ToolHooks, ToolManager, type ToolOptions, type ToolResultOutput, type ToolRoutingConfig, type ToolRoutingEmbeddingConfig, type ToolRoutingEmbeddingInput, type ToolSchema, type ToolSearchCandidate, type ToolSearchContext, type ToolSearchResult, type ToolSearchResultItem, type ToolSearchSelection, type ToolSearchStrategy, type ToolStatus, type ToolStatusInfo, type ToolWithNodeId, type Toolkit, type TriggerHandler, type TriggerHandlerBody, type TriggerHandlerContext, type TriggerHandlerResponse, type TriggerHandlerResult, type TriggerHandlerReturn, type TriggerHttpMethod, TriggerRegistry, type Usage, type UsageInfo, UserInputBridge, type UserInputHandler, type VectorAdapter$1 as VectorAdapter, VectorAdapterNotConfiguredError, VectorError, type VectorItem$1 as VectorItem, type VectorSearchOptions, type Voice, type VoiceEventData, type VoiceEventType, type VoiceMetadata, type VoiceOptions, VoltAgent, VoltAgentError, VoltAgentObservability, type VoltAgentOptions, VoltAgentRagRetriever, type VoltAgentRagRetrieverOptions, type VoltAgentStreamTextResult, type VoltAgentTextStreamPart, type VoltAgentTriggerConfig, type VoltAgentTriggersConfig, type VoltOpsActionExecutionResult, type VoltOpsActionsApi, VoltOpsActionsClient, type VoltOpsActionsTransport, type VoltOpsAirtableCreateRecordParams, type VoltOpsAirtableCredential, type VoltOpsAirtableDeleteRecordParams, type VoltOpsAirtableGetRecordParams, type VoltOpsAirtableListRecordsParams, type VoltOpsAirtableUpdateRecordParams, type VoltOpsAppendEvalRunResultPayload, type VoltOpsAppendEvalRunResultsRequest, VoltOpsClient, type VoltOpsClientOptions, type VoltOpsCompleteEvalRunRequest, type VoltOpsCreateEvalRunRequest, type VoltOpsCreateScorerRequest, type VoltOpsDiscordChannelMessageParams, type VoltOpsDiscordChannelType, type VoltOpsDiscordConfig, type VoltOpsDiscordCreateChannelParams, type VoltOpsDiscordCredential, type VoltOpsDiscordDeleteChannelParams, type VoltOpsDiscordGetChannelParams, type VoltOpsDiscordListChannelsParams, type VoltOpsDiscordListMembersParams, type VoltOpsDiscordListMessagesParams, type VoltOpsDiscordMemberRoleParams, type VoltOpsDiscordReactionParams, type VoltOpsDiscordSendMessageParams, type VoltOpsDiscordSendWebhookMessageParams, type VoltOpsDiscordUpdateChannelParams, type VoltOpsEvalResultStatus, type VoltOpsEvalRunCompletionSummaryPayload, type VoltOpsEvalRunErrorPayload, type VoltOpsEvalRunResultLiveMetadata, type VoltOpsEvalRunResultScorePayload, type VoltOpsEvalRunStatus, type VoltOpsEvalRunSummary, type VoltOpsFeedback, type VoltOpsFeedbackConfig, type VoltOpsFeedbackCreateInput, type VoltOpsFeedbackExpiresIn, type VoltOpsFeedbackToken, type VoltOpsFeedbackTokenCreateInput, VoltOpsPromptApiClient, type VoltOpsPromptManager, VoltOpsPromptManagerImpl, type VoltOpsScorerSummary, type VoltOpsSlackCredential, type VoltOpsSlackDeleteMessageParams, type VoltOpsSlackPostMessageParams, type VoltOpsSlackSearchMessagesParams, type VoltOpsTerminalEvalRunStatus, type VoltOpsTriggerDefinition, VoltOpsTriggerDefinitions, type VoltOpsTriggerEnvelope, type VoltOpsTriggerGroupMap, type VoltOpsTriggerName, VoltOpsTriggerNames, WRITE_FILE_TOOL_DESCRIPTION, WRITE_TODOS_TOOL_DESCRIPTION, WRITE_TODOS_TOOL_NAME, WebSocketEventEmitter, WebSocketLogProcessor, WebSocketSpanProcessor, type WeightedBlendComponent, type WeightedBlendOptions, type Workflow, type WorkflowConfig, type WorkflowExecutionContext, type WorkflowHookContext, type WorkflowHookStatus, type WorkflowHooks, WorkflowRegistry, type WorkflowRunQuery, type WorkflowStateEntry, type WorkflowStateStore, type WorkflowStateUpdater, type WorkflowStats, type WorkflowStepContext, type WorkflowStepData, type WorkflowStepStatus, type WorkflowStepType, type WorkflowTimelineEvent, type WorkingMemoryConfig, type WorkingMemoryScope, type WorkingMemorySummary, type WorkingMemoryUpdateOptions, type WriteResult, addTimestampToMessage, andAgent, andAll, andBranch, andDoUntil, andDoWhile, andForEach, andGuardrail, andMap, andRace, andSleep, andSleepUntil, andTap, andThen, andWhen, andWorkflow, appendToMessage, buildRetrieverLogMessage, buildSamplingMetadata, buildScorer, buildSpanTree, checkForUpdates, convertUsage, cosineSimilarity, createDefaultInputSafetyGuardrails, createDefaultPIIGuardrails, createDefaultSafetyGuardrails, createEmailRedactorGuardrail, createEmbeddingToolSearchStrategy, createFilesystemToolkit, createHTMLSanitizerInputGuardrail, createHooks, createInputGuardrail, createInputLengthGuardrail, createInputMiddleware, createMaxLengthGuardrail, createNodeId, createOutputGuardrail, createOutputMiddleware, createPIIInputGuardrail, createPhoneNumberGuardrail, createPlanningToolkit, createProfanityGuardrail, createProfanityInputGuardrail, createPrompt, createPromptInjectionGuardrail, createReasoningTools, createRetrieverTool, createScorer, createSensitiveNumberGuardrail, createSimpleTemplateEngine, createSubagent, createSuspendController, createTool, createToolResultEvictor, createToolkit, createTriggers, createVoltAgentObservability, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, defineVoltOpsTrigger, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getEnvVar, getGlobalLogBuffer, getGlobalLogger, getGlobalVoltOpsClient, getNodeTypeFromNodeId, getVoltOpsTriggerDefinition, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isMiddlewareAbortError, isNodeRuntime, isServerlessRuntime, isStructuredContent, isTextContent, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeScorerResult, normalizeToArray, prependToMessage, readableLogRecordToObservabilityLog, readableSpanToObservabilitySpan, runLocalScorers, safeJsonParse, serializeValueForDebug, setWaitUntil, shouldSample, tool, transformTextContent, updateAllPackages, updateSinglePackage, weightedBlend, zodSchemaToJsonUI };
15546
+ export { A2AServerRegistry, AbortError, Agent, type AgentEvalConfig, type AgentEvalContext, type AgentEvalFeedbackHelper, type AgentEvalFeedbackSaveInput, type AgentEvalOperationType, type AgentEvalPayload, type AgentEvalResult, type AgentEvalResultCallbackArgs, type AgentEvalSamplingPolicy, type AgentEvalScorerConfig, type AgentEvalScorerFactory, type AgentEvalScorerReference, type AgentFeedbackMetadata, type AgentFeedbackOptions, type AgentFullState, type AgentHookOnEnd, type AgentHookOnError, type AgentHookOnFallback, type AgentHookOnHandoff, type AgentHookOnHandoffComplete, type AgentHookOnPrepareMessages, type AgentHookOnPrepareModelMessages, type AgentHookOnRetry, type AgentHookOnStart, type AgentHookOnStepFinish, type AgentHookOnToolEnd, type AgentHookOnToolStart, type AgentHooks, type AgentModelConfig, type AgentModelReference, type AgentModelValue, type AgentOptions, AgentRegistry, type AgentResponse, type AgentScorerState, type AgentStatus, type AgentSummarizationOptions, type AgentTool, AiSdkEmbeddingAdapter, type AllowedVariableValue, type ApiToolInfo, type BaseEventMetadata, type BaseGenerationOptions, type BaseLLMOptions, type BaseMessage, BaseRetriever, type BaseTool, type BaseToolCall, type BuildScorerOptions, type BuildScorerRunArgs, type BuildScorerRunResult, type BuilderAnalyzeContext, type BuilderPrepareContext, type BuilderReasonContext, type BuilderScoreContext, type CachedPrompt, type ChatMessage, ClientHTTPError, type ClientSideToolResult, type CloudflareFetchHandler, CompositeFilesystemBackend, type Conversation, ConversationAlreadyExistsError, ConversationNotFoundError, type ConversationQueryOptions, type ConversationQueryOptions as ConversationQueryOptionsV2, type ConversationStepRecord, type ConversationStepType, type ConversationTitleConfig, type ConversationTitleGenerator, ConversationTodoBackend, type Conversation as ConversationV2, type CreateConversationInput, type CreateConversationInput as CreateConversationInputV2, type CreateInputGuardrailOptions, type CreateInputMiddlewareOptions, type CreateOutputGuardrailOptions, type CreateOutputMiddlewareOptions, type CreateReasoningToolsOptions, type CreateScorerOptions, DEFAULT_INSTRUCTIONS, DELETE_FILE_TOOL_DESCRIPTION, type DataContent, type Document, type DynamicValue, type DynamicValueOptions, EDIT_FILE_TOOL_DESCRIPTION, type EditResult, type EmbeddingAdapter, type EmbeddingAdapterConfig, type EmbeddingAdapterInput, EmbeddingAdapterNotConfiguredError, EmbeddingError, type EmbeddingModelFactory, type EmbeddingModelReference, type EmbeddingRouterModelId, type ExtractVariableNames, FEW_SHOT_EXAMPLES, FILESYSTEM_SYSTEM_PROMPT, type FallbackStage, type FileData, type FileInfo, type FilesystemBackend, type FilesystemBackendContext, type FilesystemBackendFactory, type FilesystemToolkitOptions, GLOB_TOOL_DESCRIPTION, GREP_TOOL_DESCRIPTION, type GenerateObjectOptions, type GenerateObjectResultWithContext, type GenerateObjectSubAgentConfig, type GenerateReasonResult, type GenerateScoreResult, type GenerateScoreStep, type GenerateTextOptions, type GenerateTextResultWithContext, type GenerateTextSubAgentConfig, type GetConversationStepsOptions, type GetMessagesOptions, type GrepMatch, type GuardrailAction, type GuardrailContext, type GuardrailDefinition, type GuardrailFunction, type GuardrailSeverity, type IServerProvider, type IServerlessProvider, type VoltOpsClient$1 as IVoltOpsClient, InMemoryFilesystemBackend, InMemoryStorageAdapter$1 as InMemoryObservabilityAdapter, InMemoryStorageAdapter, InMemoryVectorAdapter, type InferGenerateObjectResponse, type InferGenerateTextResponse, type InferMessage, type InferModel, type InferProviderParams, type InferStreamResponse, type InferTool, type InputGuardrail, type InputGuardrailArgs, type InputGuardrailResult, type InputMiddleware, type InputMiddlewareArgs, type InputMiddlewareResult, type KnowledgeBaseTagFilter, type LLMProvider, LS_TOOL_DESCRIPTION, type LanguageModelFactory, LazyRemoteExportProcessor, LocalSandbox, type LocalSandboxIsolationOptions, type LocalSandboxIsolationProvider, type LocalSandboxOptions, type LocalScorerDefinition, type LocalScorerExecutionResult, LocalStorageSpanProcessor, type LogFilter, LoggerProxy, type MCPAuthorizationAction, type MCPAuthorizationConfig, type MCPAuthorizationContext, MCPAuthorizationError, type MCPCanFunction, type MCPCanParams, type MCPCanResult, MCPClient, type MCPClientCallOptions, type MCPClientConfig, MCPConfiguration, type MCPConfigurationOptions, type MCPElicitationAdapter, type MCPElicitationHandler, type MCPLoggingAdapter, type MCPPromptsAdapter, type MCPResourcesAdapter, MCPServerRegistry, type ManagedMemoryAddMessageInput, type ManagedMemoryAddMessagesInput, type ManagedMemoryClearMessagesInput, type ManagedMemoryConnectionInfo, type ManagedMemoryConversationsClient, type ManagedMemoryCredentialCreateResult, type ManagedMemoryCredentialListResult, type ManagedMemoryCredentialSummary, type ManagedMemoryDatabaseSummary, type ManagedMemoryDeleteMessagesInput, type ManagedMemoryGetMessagesInput, type ManagedMemoryMessagesClient, type ManagedMemoryQueryWorkflowRunsInput, type ManagedMemorySetWorkingMemoryInput, type ManagedMemoryStatus, type ManagedMemoryUpdateConversationInput, type ManagedMemoryVoltOpsClient, type ManagedMemoryWorkflowStateUpdateInput, type ManagedMemoryWorkflowStatesClient, type ManagedMemoryWorkingMemoryClient, type ManagedMemoryWorkingMemoryInput, Memory, type MemoryConfig, type MemoryOptions, type MemoryStorageMetadata, type MemoryUpdateMode, Memory as MemoryV2, MemoryV2Error, type MessageContent, MessageContentBuilder, type MessageRole, MiddlewareAbortError, type MiddlewareAbortOptions, type MiddlewareContext, type MiddlewareDefinition, type MiddlewareDirection, type MiddlewareFunction, type ModelForProvider, type ModelProvider, type ModelProviderEntry, type ModelProviderLoader, ModelProviderRegistry, type ModelRouterModelId, type ModelToolCall, NextAction, NodeFilesystemBackend, NodeType, VoltAgentObservability$1 as NodeVoltAgentObservability, type ObservabilityConfig, type ObservabilityLogRecord, type ObservabilitySpan, type ObservabilityStorageAdapter, type ObservabilityWebSocketEvent, type OnEndHookArgs, type OnErrorHookArgs, type OnFallbackHookArgs, type OnHandoffCompleteHookArgs, type OnHandoffHookArgs, type OnPrepareMessagesHookArgs, type OnPrepareMessagesHookResult, type OnPrepareModelMessagesHookArgs, type OnPrepareModelMessagesHookResult, type OnRetryHookArgs, type OnRetryHookArgsBase, type OnRetryLLMHookArgs, type OnRetryMiddlewareHookArgs, type OnStartHookArgs, type OnStepFinishHookArgs, type OnToolEndHookArgs, type OnToolEndHookResult, type OnToolStartHookArgs, type OperationContext, type OutputGuardrail, type OutputGuardrailArgs, type OutputGuardrailResult, type OutputMiddleware, type OutputMiddlewareArgs, type OutputMiddlewareResult, type OutputSpec$1 as OutputSpec, type PackageUpdateInfo, PlanAgent, type PlanAgentExtension, type PlanAgentExtensionContext, type PlanAgentExtensionResult, type PlanAgentFileData, type PlanAgentOptions, type PlanAgentState, type PlanAgentSubagentDefinition, type PlanAgentTodoItem, type PlanAgentTodoStatus, type PlanningToolkitOptions, type PromptApiClient, type PromptApiResponse, type PromptContent, type PromptCreator, type PromptHelper, type PromptReference, type PromptTemplate, type ProviderId, type ProviderModelsMap, type ProviderObjectResponse, type ProviderObjectStreamResponse, type ProviderParams, type ProviderResponse, type ProviderTextResponse, type ProviderTextStreamResponse, type ProviderTool, READ_FILE_TOOL_DESCRIPTION, type RagKnowledgeBaseSummary, type RagSearchKnowledgeBaseChildChunk, type RagSearchKnowledgeBaseRequest, type RagSearchKnowledgeBaseResponse, type RagSearchKnowledgeBaseResult, type ReadableStreamType, type ReasoningStep, ReasoningStepSchema, type RegisterOptions, type RegisteredTrigger, type RegisteredWorkflow, type RemoteLogExportConfig, RemoteLogProcessor, type ResumableStreamAdapter, type ResumableStreamContext, type RetrieveOptions, type Retriever, type RetrieverOptions, type RetrySource, type RunLocalScorersArgs, type RunLocalScorersResult, SERVERLESS_ENV_CONTEXT_KEY, type SamplingMetadata, type SamplingPolicy, type ScorerBuilder, type ScorerContext, type ScorerLifecycleScope, type ScorerPipelineContext, type ScorerReasonContext, type ScorerResult, type SearchOptions, type SearchResult$1 as SearchResult, type ServerAgentResponse, type ServerApiResponse, type ServerProviderDeps, type ServerProviderFactory, type ServerWorkflowResponse, type ServerlessProviderFactory, type ServerlessRemoteEndpointConfig, type ServerlessRemoteExportConfig, type ServerlessRequestHandler, ServerlessVoltAgentObservability, type SpanAttributes, type SpanEvent, type SpanFilterConfig, SpanFilterProcessor, SpanKind, type SpanLink, type SpanStatus, SpanStatusCode, type SpanTreeNode, type StepChunkCallback, type StepFinishCallback, type StepWithContent, type StopWhen, type StorageAdapter, StorageError, StorageLogProcessor, type StoredUIMessage, type StreamObjectFinishResult, type StreamObjectOnFinishCallback, type StreamObjectOptions, type StreamObjectResultWithContext, type StreamObjectSubAgentConfig, type StreamPart, type StreamTextFinishResult, type StreamTextOnFinishCallback, type StreamTextOptions, type StreamTextResultWithContext, type StreamTextSubAgentConfig, type SubAgentConfig, type SubAgentMethod, type SubAgentStateData, type SupervisorConfig, TRIGGER_CONTEXT_KEY, type TaskToolOptions, type TemplateVariables, type TimelineEventCoreLevel, type TimelineEventCoreStatus, type TimelineEventCoreType, type TodoBackend, type TodoBackendFactory, Tool, type ToolCall, type ToolContext, ToolDeniedError, type ToolErrorInfo, type ToolExecuteOptions, type ToolExecutionResult, type ToolHookOnEnd, type ToolHookOnEndArgs, type ToolHookOnEndResult, type ToolHookOnStart, type ToolHookOnStartArgs, type ToolHooks, ToolManager, type ToolOptions, type ToolResultOutput, type ToolRoutingConfig, type ToolRoutingEmbeddingConfig, type ToolRoutingEmbeddingInput, type ToolSchema, type ToolSearchCandidate, type ToolSearchContext, type ToolSearchResult, type ToolSearchResultItem, type ToolSearchSelection, type ToolSearchStrategy, type ToolStatus, type ToolStatusInfo, type ToolWithNodeId, type Toolkit, type TriggerHandler, type TriggerHandlerBody, type TriggerHandlerContext, type TriggerHandlerResponse, type TriggerHandlerResult, type TriggerHandlerReturn, type TriggerHttpMethod, TriggerRegistry, type Usage, type UsageInfo, UserInputBridge, type UserInputHandler, type VectorAdapter$1 as VectorAdapter, VectorAdapterNotConfiguredError, VectorError, type VectorItem$1 as VectorItem, type VectorSearchOptions, type Voice, type VoiceEventData, type VoiceEventType, type VoiceMetadata, type VoiceOptions, VoltAgent, VoltAgentError, VoltAgentObservability, type VoltAgentOptions, VoltAgentRagRetriever, type VoltAgentRagRetrieverOptions, type VoltAgentStreamTextResult, type VoltAgentTextStreamPart, type VoltAgentTriggerConfig, type VoltAgentTriggersConfig, type VoltOpsActionExecutionResult, type VoltOpsActionsApi, VoltOpsActionsClient, type VoltOpsActionsTransport, type VoltOpsAirtableCreateRecordParams, type VoltOpsAirtableCredential, type VoltOpsAirtableDeleteRecordParams, type VoltOpsAirtableGetRecordParams, type VoltOpsAirtableListRecordsParams, type VoltOpsAirtableUpdateRecordParams, type VoltOpsAppendEvalRunResultPayload, type VoltOpsAppendEvalRunResultsRequest, VoltOpsClient, type VoltOpsClientOptions, type VoltOpsCompleteEvalRunRequest, type VoltOpsCreateEvalRunRequest, type VoltOpsCreateScorerRequest, type VoltOpsDiscordChannelMessageParams, type VoltOpsDiscordChannelType, type VoltOpsDiscordConfig, type VoltOpsDiscordCreateChannelParams, type VoltOpsDiscordCredential, type VoltOpsDiscordDeleteChannelParams, type VoltOpsDiscordGetChannelParams, type VoltOpsDiscordListChannelsParams, type VoltOpsDiscordListMembersParams, type VoltOpsDiscordListMessagesParams, type VoltOpsDiscordMemberRoleParams, type VoltOpsDiscordReactionParams, type VoltOpsDiscordSendMessageParams, type VoltOpsDiscordSendWebhookMessageParams, type VoltOpsDiscordUpdateChannelParams, type VoltOpsEvalResultStatus, type VoltOpsEvalRunCompletionSummaryPayload, type VoltOpsEvalRunErrorPayload, type VoltOpsEvalRunResultLiveMetadata, type VoltOpsEvalRunResultScorePayload, type VoltOpsEvalRunStatus, type VoltOpsEvalRunSummary, type VoltOpsFeedback, type VoltOpsFeedbackConfig, type VoltOpsFeedbackCreateInput, type VoltOpsFeedbackExpiresIn, type VoltOpsFeedbackToken, type VoltOpsFeedbackTokenCreateInput, VoltOpsPromptApiClient, type VoltOpsPromptManager, VoltOpsPromptManagerImpl, type VoltOpsScorerSummary, type VoltOpsSlackCredential, type VoltOpsSlackDeleteMessageParams, type VoltOpsSlackPostMessageParams, type VoltOpsSlackSearchMessagesParams, type VoltOpsTerminalEvalRunStatus, type VoltOpsTriggerDefinition, VoltOpsTriggerDefinitions, type VoltOpsTriggerEnvelope, type VoltOpsTriggerGroupMap, type VoltOpsTriggerName, VoltOpsTriggerNames, WRITE_FILE_TOOL_DESCRIPTION, WRITE_TODOS_TOOL_DESCRIPTION, WRITE_TODOS_TOOL_NAME, WebSocketEventEmitter, WebSocketLogProcessor, WebSocketSpanProcessor, type WeightedBlendComponent, type WeightedBlendOptions, type Workflow, type WorkflowConfig, type WorkflowExecutionContext, type WorkflowHookContext, type WorkflowHookStatus, type WorkflowHooks, WorkflowRegistry, type WorkflowRunQuery, type WorkflowStateEntry, type WorkflowStateStore, type WorkflowStateUpdater, type WorkflowStats, type WorkflowStepContext, type WorkflowStepData, type WorkflowStepStatus, type WorkflowStepType, type WorkflowTimelineEvent, type WorkingMemoryConfig, type WorkingMemoryScope, type WorkingMemorySummary, type WorkingMemoryUpdateOptions, Workspace, type WorkspaceConfig, type DeleteResult as WorkspaceDeleteResult, type EditResult as WorkspaceEditResult, type FileData as WorkspaceFileData, type FileInfo as WorkspaceFileInfo, WorkspaceFilesystem, type FilesystemBackend as WorkspaceFilesystemBackend, type FilesystemBackendContext as WorkspaceFilesystemBackendContext, type FilesystemBackendFactory as WorkspaceFilesystemBackendFactory, type WorkspaceFilesystemCallContext, type WorkspaceFilesystemConfig, type WorkspaceFilesystemDeleteOptions, type WorkspaceFilesystemOperationOptions, type WorkspaceFilesystemOptions, type WorkspaceFilesystemReadOptions, type WorkspaceFilesystemRmdirOptions, type WorkspaceFilesystemSearchOptions, type WorkspaceFilesystemToolName, type WorkspaceFilesystemToolPolicy, type WorkspaceFilesystemToolkitOptions, type WorkspaceFilesystemWriteOptions, type GrepMatch as WorkspaceGrepMatch, type WorkspaceIdentity, type WorkspaceInfo, type MkdirResult as WorkspaceMkdirResult, type WorkspacePathContext, type RmdirResult as WorkspaceRmdirResult, type WorkspaceSandbox, type WorkspaceSandboxExecuteOptions, type WorkspaceSandboxResult, type WorkspaceSandboxStatus, type WorkspaceSandboxToolName, type WorkspaceSandboxToolkitContext, type WorkspaceSandboxToolkitOptions, type WorkspaceScope, WorkspaceSearch, type WorkspaceSearchConfig, type WorkspaceSearchHybridWeights, type WorkspaceSearchIndexPath, type WorkspaceSearchIndexSummary, type WorkspaceSearchMode, type WorkspaceSearchOptions, type WorkspaceSearchResult, type WorkspaceSearchToolName, type WorkspaceSearchToolkitContext, type WorkspaceSearchToolkitOptions, type WorkspaceSkill, type WorkspaceSkillIndexSummary, type WorkspaceSkillMetadata, type WorkspaceSkillSearchHybridWeights, type WorkspaceSkillSearchMode, type WorkspaceSkillSearchOptions, type WorkspaceSkillSearchResult, WorkspaceSkills, type WorkspaceSkillsConfig, type WorkspaceSkillsPromptHookContext, type WorkspaceSkillsPromptOptions, type WorkspaceSkillsRootResolver, type WorkspaceSkillsRootResolverContext, type WorkspaceSkillsToolName, type WorkspaceSkillsToolkitContext, type WorkspaceSkillsToolkitOptions, type WorkspaceStatus, type WorkspaceToolConfig, type WorkspaceToolPolicies, type WorkspaceToolPolicy, type WorkspaceToolPolicyGroup, type WorkspaceToolkitOptions, type WriteResult as WorkspaceWriteResult, type WriteResult, addTimestampToMessage, andAgent, andAll, andBranch, andDoUntil, andDoWhile, andForEach, andGuardrail, andMap, andRace, andSleep, andSleepUntil, andTap, andThen, andWhen, andWorkflow, appendToMessage, buildRetrieverLogMessage, buildSamplingMetadata, buildScorer, buildSpanTree, checkForUpdates, convertUsage, cosineSimilarity, createDefaultInputSafetyGuardrails, createDefaultPIIGuardrails, createDefaultSafetyGuardrails, createEmailRedactorGuardrail, createEmbeddingToolSearchStrategy, createFilesystemToolkit, createHTMLSanitizerInputGuardrail, createHooks, createInputGuardrail, createInputLengthGuardrail, createInputMiddleware, createMaxLengthGuardrail, createNodeId, createOutputGuardrail, createOutputMiddleware, createPIIInputGuardrail, createPhoneNumberGuardrail, createPlanningToolkit, createProfanityGuardrail, createProfanityInputGuardrail, createPrompt, createPromptInjectionGuardrail, createReasoningTools, createRetrieverTool, createScorer, createSensitiveNumberGuardrail, createSimpleTemplateEngine, createSubagent, createSuspendController, createTool, createToolResultEvictor, createToolkit, createTriggers, createVoltAgentObservability, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, createWorkspaceFilesystemToolkit, createWorkspaceSandboxToolkit, createWorkspaceSearchToolkit, createWorkspaceSkillsPromptHook, createWorkspaceSkillsToolkit, VoltAgent as default, defineVoltOpsTrigger, detectLocalSandboxIsolation, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getEnvVar, getGlobalLogBuffer, getGlobalLogger, getGlobalVoltOpsClient, getNodeTypeFromNodeId, getVoltOpsTriggerDefinition, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isMiddlewareAbortError, isNodeRuntime, isServerlessRuntime, isStructuredContent, isTextContent, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeScorerResult, normalizeToArray, prependToMessage, readableLogRecordToObservabilityLog, readableSpanToObservabilitySpan, runLocalScorers, safeJsonParse, serializeValueForDebug, setWaitUntil, shouldSample, tool, transformTextContent, updateAllPackages, updateSinglePackage, weightedBlend, zodSchemaToJsonUI };