@voltagent/core 2.3.5 → 2.3.7
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 +26 -16
- package/dist/index.d.ts +26 -16
- package/dist/index.js +155 -56
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +155 -56
- package/dist/index.mjs.map +1 -1
- package/docs/agents/memory/in-memory.md +2 -0
- package/docs/agents/memory/overview.md +13 -3
- package/docs/agents/overview.md +2 -2
- package/docs/agents/subagents.md +17 -2
- package/docs/agents/voltagent-instance.md +1 -1
- package/docs/api/api-reference.md +10 -0
- package/docs/api/endpoints/workflows.md +29 -8
- package/docs/api/overview.md +1 -1
- package/docs/workspaces/filesystem.md +21 -0
- package/docs/workspaces/sandbox.md +140 -0
- package/docs/workspaces/search.md +36 -0
- package/docs/workspaces/skills.md +19 -0
- package/package.json +1 -1
package/dist/index.d.mts
CHANGED
|
@@ -1552,6 +1552,8 @@ interface WorkflowRunQuery {
|
|
|
1552
1552
|
to?: Date;
|
|
1553
1553
|
limit?: number;
|
|
1554
1554
|
offset?: number;
|
|
1555
|
+
userId?: string;
|
|
1556
|
+
metadata?: Record<string, unknown>;
|
|
1555
1557
|
}
|
|
1556
1558
|
/**
|
|
1557
1559
|
* Working memory scope - conversation or user level
|
|
@@ -2808,6 +2810,8 @@ interface ManagedMemoryQueryWorkflowRunsInput {
|
|
|
2808
2810
|
to?: Date;
|
|
2809
2811
|
limit?: number;
|
|
2810
2812
|
offset?: number;
|
|
2813
|
+
userId?: string;
|
|
2814
|
+
metadata?: Record<string, unknown>;
|
|
2811
2815
|
}
|
|
2812
2816
|
interface ManagedMemoryWorkflowStateUpdateInput {
|
|
2813
2817
|
executionId: string;
|
|
@@ -6757,6 +6761,7 @@ type WorkspaceSandboxExecuteOptions = {
|
|
|
6757
6761
|
signal?: AbortSignal;
|
|
6758
6762
|
onStdout?: (chunk: string) => void;
|
|
6759
6763
|
onStderr?: (chunk: string) => void;
|
|
6764
|
+
operationContext?: OperationContext;
|
|
6760
6765
|
};
|
|
6761
6766
|
type WorkspaceSandboxStatus = "idle" | "ready" | "destroyed" | "error";
|
|
6762
6767
|
type WorkspaceSandboxResult = {
|
|
@@ -6878,6 +6883,7 @@ type WorkspaceSearchOptions = {
|
|
|
6878
6883
|
snippetLength?: number;
|
|
6879
6884
|
lexicalWeight?: number;
|
|
6880
6885
|
vectorWeight?: number;
|
|
6886
|
+
context?: WorkspaceFilesystemCallContext;
|
|
6881
6887
|
};
|
|
6882
6888
|
type WorkspaceSearchResult = {
|
|
6883
6889
|
id: string;
|
|
@@ -6912,6 +6918,7 @@ type WorkspaceSkillSearchHybridWeights = {
|
|
|
6912
6918
|
type WorkspaceSkillsRootResolverContext = {
|
|
6913
6919
|
workspace: WorkspaceIdentity;
|
|
6914
6920
|
filesystem: WorkspaceFilesystem;
|
|
6921
|
+
operationContext?: OperationContext;
|
|
6915
6922
|
};
|
|
6916
6923
|
type WorkspaceSkillsRootResolver = (context?: WorkspaceSkillsRootResolverContext) => string[] | undefined | null | Promise<string[] | undefined | null>;
|
|
6917
6924
|
type WorkspaceSkillsConfig = {
|
|
@@ -6950,6 +6957,7 @@ type WorkspaceSkillSearchOptions = {
|
|
|
6950
6957
|
snippetLength?: number;
|
|
6951
6958
|
lexicalWeight?: number;
|
|
6952
6959
|
vectorWeight?: number;
|
|
6960
|
+
context?: WorkspaceFilesystemCallContext;
|
|
6953
6961
|
};
|
|
6954
6962
|
type WorkspaceSkillSearchResult = {
|
|
6955
6963
|
id: string;
|
|
@@ -7302,9 +7310,12 @@ declare class WorkspaceSearch {
|
|
|
7302
7310
|
private ensureAutoIndex;
|
|
7303
7311
|
indexPaths(paths?: Array<WorkspaceSearchIndexPath | string>, options?: {
|
|
7304
7312
|
maxFileBytes?: number;
|
|
7313
|
+
context?: WorkspaceFilesystemCallContext;
|
|
7305
7314
|
}): Promise<WorkspaceSearchIndexSummary>;
|
|
7306
7315
|
indexDocuments(docs: WorkspaceSearchDocument[]): Promise<WorkspaceSearchIndexSummary>;
|
|
7307
|
-
indexContent(path: string, content: string, metadata?: Record<string, unknown
|
|
7316
|
+
indexContent(path: string, content: string, metadata?: Record<string, unknown>, _options?: {
|
|
7317
|
+
context?: WorkspaceFilesystemCallContext;
|
|
7318
|
+
}): Promise<WorkspaceSearchIndexSummary>;
|
|
7308
7319
|
search(query: string, options?: WorkspaceSearchOptions): Promise<WorkspaceSearchResult[]>;
|
|
7309
7320
|
private resolveMode;
|
|
7310
7321
|
private searchVector;
|
|
@@ -7509,6 +7520,9 @@ type WorkspaceSkillsToolName = "workspace_list_skills" | "workspace_search_skill
|
|
|
7509
7520
|
type WorkspaceSkillsPromptHookContext = {
|
|
7510
7521
|
skills?: WorkspaceSkills;
|
|
7511
7522
|
};
|
|
7523
|
+
type WorkspaceSkillsOperationOptions = {
|
|
7524
|
+
context?: WorkspaceFilesystemCallContext;
|
|
7525
|
+
};
|
|
7512
7526
|
declare class WorkspaceSkills {
|
|
7513
7527
|
private readonly filesystem;
|
|
7514
7528
|
private readonly workspaceIdentity;
|
|
@@ -7548,22 +7562,25 @@ declare class WorkspaceSkills {
|
|
|
7548
7562
|
private ensureIndexed;
|
|
7549
7563
|
discoverSkills(options?: {
|
|
7550
7564
|
refresh?: boolean;
|
|
7565
|
+
context?: WorkspaceFilesystemCallContext;
|
|
7551
7566
|
}): Promise<WorkspaceSkillMetadata[]>;
|
|
7552
|
-
loadSkill(identifier: string): Promise<WorkspaceSkill | null>;
|
|
7553
|
-
activateSkill(identifier: string): Promise<WorkspaceSkillMetadata | null>;
|
|
7554
|
-
deactivateSkill(identifier: string): Promise<boolean>;
|
|
7567
|
+
loadSkill(identifier: string, options?: WorkspaceSkillsOperationOptions): Promise<WorkspaceSkill | null>;
|
|
7568
|
+
activateSkill(identifier: string, options?: WorkspaceSkillsOperationOptions): Promise<WorkspaceSkillMetadata | null>;
|
|
7569
|
+
deactivateSkill(identifier: string, options?: WorkspaceSkillsOperationOptions): Promise<boolean>;
|
|
7555
7570
|
getActiveSkills(): WorkspaceSkillMetadata[];
|
|
7556
|
-
indexSkills(): Promise<WorkspaceSkillIndexSummary>;
|
|
7571
|
+
indexSkills(options?: WorkspaceSkillsOperationOptions): Promise<WorkspaceSkillIndexSummary>;
|
|
7557
7572
|
search(query: string, options?: WorkspaceSkillSearchOptions): Promise<WorkspaceSkillSearchResult[]>;
|
|
7558
|
-
buildPrompt(options?: WorkspaceSkillsPromptOptions
|
|
7573
|
+
buildPrompt(options?: WorkspaceSkillsPromptOptions & {
|
|
7574
|
+
context?: WorkspaceFilesystemCallContext;
|
|
7575
|
+
}): Promise<string | null>;
|
|
7559
7576
|
private resolveMode;
|
|
7560
7577
|
private searchVector;
|
|
7561
7578
|
private formatResults;
|
|
7562
7579
|
private resolveSkillId;
|
|
7563
7580
|
resolveSkillFilePath(skill: WorkspaceSkillMetadata, relativePath: string, allowed: string[] | undefined): string | null;
|
|
7564
|
-
readFileContent(filePath: string): Promise<string>;
|
|
7581
|
+
readFileContent(filePath: string, options?: WorkspaceSkillsOperationOptions): Promise<string>;
|
|
7565
7582
|
}
|
|
7566
|
-
declare const createWorkspaceSkillsPromptHook: (
|
|
7583
|
+
declare const createWorkspaceSkillsPromptHook: (hookContext: WorkspaceSkillsPromptHookContext, options?: WorkspaceSkillsPromptOptions) => AgentHooks;
|
|
7567
7584
|
declare const createWorkspaceSkillsToolkit: (context: WorkspaceSkillsToolkitContext, options?: WorkspaceSkillsToolkitOptions) => Toolkit;
|
|
7568
7585
|
|
|
7569
7586
|
declare class Workspace {
|
|
@@ -14513,14 +14530,7 @@ declare class InMemoryStorageAdapter implements StorageAdapter {
|
|
|
14513
14530
|
/**
|
|
14514
14531
|
* Query workflow states with optional filters
|
|
14515
14532
|
*/
|
|
14516
|
-
queryWorkflowRuns(query:
|
|
14517
|
-
workflowId?: string;
|
|
14518
|
-
status?: WorkflowStateEntry["status"];
|
|
14519
|
-
from?: Date;
|
|
14520
|
-
to?: Date;
|
|
14521
|
-
limit?: number;
|
|
14522
|
-
offset?: number;
|
|
14523
|
-
}): Promise<WorkflowStateEntry[]>;
|
|
14533
|
+
queryWorkflowRuns(query: WorkflowRunQuery): Promise<WorkflowStateEntry[]>;
|
|
14524
14534
|
/**
|
|
14525
14535
|
* Set workflow state
|
|
14526
14536
|
*/
|
package/dist/index.d.ts
CHANGED
|
@@ -1552,6 +1552,8 @@ interface WorkflowRunQuery {
|
|
|
1552
1552
|
to?: Date;
|
|
1553
1553
|
limit?: number;
|
|
1554
1554
|
offset?: number;
|
|
1555
|
+
userId?: string;
|
|
1556
|
+
metadata?: Record<string, unknown>;
|
|
1555
1557
|
}
|
|
1556
1558
|
/**
|
|
1557
1559
|
* Working memory scope - conversation or user level
|
|
@@ -2808,6 +2810,8 @@ interface ManagedMemoryQueryWorkflowRunsInput {
|
|
|
2808
2810
|
to?: Date;
|
|
2809
2811
|
limit?: number;
|
|
2810
2812
|
offset?: number;
|
|
2813
|
+
userId?: string;
|
|
2814
|
+
metadata?: Record<string, unknown>;
|
|
2811
2815
|
}
|
|
2812
2816
|
interface ManagedMemoryWorkflowStateUpdateInput {
|
|
2813
2817
|
executionId: string;
|
|
@@ -6757,6 +6761,7 @@ type WorkspaceSandboxExecuteOptions = {
|
|
|
6757
6761
|
signal?: AbortSignal;
|
|
6758
6762
|
onStdout?: (chunk: string) => void;
|
|
6759
6763
|
onStderr?: (chunk: string) => void;
|
|
6764
|
+
operationContext?: OperationContext;
|
|
6760
6765
|
};
|
|
6761
6766
|
type WorkspaceSandboxStatus = "idle" | "ready" | "destroyed" | "error";
|
|
6762
6767
|
type WorkspaceSandboxResult = {
|
|
@@ -6878,6 +6883,7 @@ type WorkspaceSearchOptions = {
|
|
|
6878
6883
|
snippetLength?: number;
|
|
6879
6884
|
lexicalWeight?: number;
|
|
6880
6885
|
vectorWeight?: number;
|
|
6886
|
+
context?: WorkspaceFilesystemCallContext;
|
|
6881
6887
|
};
|
|
6882
6888
|
type WorkspaceSearchResult = {
|
|
6883
6889
|
id: string;
|
|
@@ -6912,6 +6918,7 @@ type WorkspaceSkillSearchHybridWeights = {
|
|
|
6912
6918
|
type WorkspaceSkillsRootResolverContext = {
|
|
6913
6919
|
workspace: WorkspaceIdentity;
|
|
6914
6920
|
filesystem: WorkspaceFilesystem;
|
|
6921
|
+
operationContext?: OperationContext;
|
|
6915
6922
|
};
|
|
6916
6923
|
type WorkspaceSkillsRootResolver = (context?: WorkspaceSkillsRootResolverContext) => string[] | undefined | null | Promise<string[] | undefined | null>;
|
|
6917
6924
|
type WorkspaceSkillsConfig = {
|
|
@@ -6950,6 +6957,7 @@ type WorkspaceSkillSearchOptions = {
|
|
|
6950
6957
|
snippetLength?: number;
|
|
6951
6958
|
lexicalWeight?: number;
|
|
6952
6959
|
vectorWeight?: number;
|
|
6960
|
+
context?: WorkspaceFilesystemCallContext;
|
|
6953
6961
|
};
|
|
6954
6962
|
type WorkspaceSkillSearchResult = {
|
|
6955
6963
|
id: string;
|
|
@@ -7302,9 +7310,12 @@ declare class WorkspaceSearch {
|
|
|
7302
7310
|
private ensureAutoIndex;
|
|
7303
7311
|
indexPaths(paths?: Array<WorkspaceSearchIndexPath | string>, options?: {
|
|
7304
7312
|
maxFileBytes?: number;
|
|
7313
|
+
context?: WorkspaceFilesystemCallContext;
|
|
7305
7314
|
}): Promise<WorkspaceSearchIndexSummary>;
|
|
7306
7315
|
indexDocuments(docs: WorkspaceSearchDocument[]): Promise<WorkspaceSearchIndexSummary>;
|
|
7307
|
-
indexContent(path: string, content: string, metadata?: Record<string, unknown
|
|
7316
|
+
indexContent(path: string, content: string, metadata?: Record<string, unknown>, _options?: {
|
|
7317
|
+
context?: WorkspaceFilesystemCallContext;
|
|
7318
|
+
}): Promise<WorkspaceSearchIndexSummary>;
|
|
7308
7319
|
search(query: string, options?: WorkspaceSearchOptions): Promise<WorkspaceSearchResult[]>;
|
|
7309
7320
|
private resolveMode;
|
|
7310
7321
|
private searchVector;
|
|
@@ -7509,6 +7520,9 @@ type WorkspaceSkillsToolName = "workspace_list_skills" | "workspace_search_skill
|
|
|
7509
7520
|
type WorkspaceSkillsPromptHookContext = {
|
|
7510
7521
|
skills?: WorkspaceSkills;
|
|
7511
7522
|
};
|
|
7523
|
+
type WorkspaceSkillsOperationOptions = {
|
|
7524
|
+
context?: WorkspaceFilesystemCallContext;
|
|
7525
|
+
};
|
|
7512
7526
|
declare class WorkspaceSkills {
|
|
7513
7527
|
private readonly filesystem;
|
|
7514
7528
|
private readonly workspaceIdentity;
|
|
@@ -7548,22 +7562,25 @@ declare class WorkspaceSkills {
|
|
|
7548
7562
|
private ensureIndexed;
|
|
7549
7563
|
discoverSkills(options?: {
|
|
7550
7564
|
refresh?: boolean;
|
|
7565
|
+
context?: WorkspaceFilesystemCallContext;
|
|
7551
7566
|
}): Promise<WorkspaceSkillMetadata[]>;
|
|
7552
|
-
loadSkill(identifier: string): Promise<WorkspaceSkill | null>;
|
|
7553
|
-
activateSkill(identifier: string): Promise<WorkspaceSkillMetadata | null>;
|
|
7554
|
-
deactivateSkill(identifier: string): Promise<boolean>;
|
|
7567
|
+
loadSkill(identifier: string, options?: WorkspaceSkillsOperationOptions): Promise<WorkspaceSkill | null>;
|
|
7568
|
+
activateSkill(identifier: string, options?: WorkspaceSkillsOperationOptions): Promise<WorkspaceSkillMetadata | null>;
|
|
7569
|
+
deactivateSkill(identifier: string, options?: WorkspaceSkillsOperationOptions): Promise<boolean>;
|
|
7555
7570
|
getActiveSkills(): WorkspaceSkillMetadata[];
|
|
7556
|
-
indexSkills(): Promise<WorkspaceSkillIndexSummary>;
|
|
7571
|
+
indexSkills(options?: WorkspaceSkillsOperationOptions): Promise<WorkspaceSkillIndexSummary>;
|
|
7557
7572
|
search(query: string, options?: WorkspaceSkillSearchOptions): Promise<WorkspaceSkillSearchResult[]>;
|
|
7558
|
-
buildPrompt(options?: WorkspaceSkillsPromptOptions
|
|
7573
|
+
buildPrompt(options?: WorkspaceSkillsPromptOptions & {
|
|
7574
|
+
context?: WorkspaceFilesystemCallContext;
|
|
7575
|
+
}): Promise<string | null>;
|
|
7559
7576
|
private resolveMode;
|
|
7560
7577
|
private searchVector;
|
|
7561
7578
|
private formatResults;
|
|
7562
7579
|
private resolveSkillId;
|
|
7563
7580
|
resolveSkillFilePath(skill: WorkspaceSkillMetadata, relativePath: string, allowed: string[] | undefined): string | null;
|
|
7564
|
-
readFileContent(filePath: string): Promise<string>;
|
|
7581
|
+
readFileContent(filePath: string, options?: WorkspaceSkillsOperationOptions): Promise<string>;
|
|
7565
7582
|
}
|
|
7566
|
-
declare const createWorkspaceSkillsPromptHook: (
|
|
7583
|
+
declare const createWorkspaceSkillsPromptHook: (hookContext: WorkspaceSkillsPromptHookContext, options?: WorkspaceSkillsPromptOptions) => AgentHooks;
|
|
7567
7584
|
declare const createWorkspaceSkillsToolkit: (context: WorkspaceSkillsToolkitContext, options?: WorkspaceSkillsToolkitOptions) => Toolkit;
|
|
7568
7585
|
|
|
7569
7586
|
declare class Workspace {
|
|
@@ -14513,14 +14530,7 @@ declare class InMemoryStorageAdapter implements StorageAdapter {
|
|
|
14513
14530
|
/**
|
|
14514
14531
|
* Query workflow states with optional filters
|
|
14515
14532
|
*/
|
|
14516
|
-
queryWorkflowRuns(query:
|
|
14517
|
-
workflowId?: string;
|
|
14518
|
-
status?: WorkflowStateEntry["status"];
|
|
14519
|
-
from?: Date;
|
|
14520
|
-
to?: Date;
|
|
14521
|
-
limit?: number;
|
|
14522
|
-
offset?: number;
|
|
14523
|
-
}): Promise<WorkflowStateEntry[]>;
|
|
14533
|
+
queryWorkflowRuns(query: WorkflowRunQuery): Promise<WorkflowStateEntry[]>;
|
|
14524
14534
|
/**
|
|
14525
14535
|
* Set workflow state
|
|
14526
14536
|
*/
|