@vertesia/tools-sdk 1.5.0-dev.20260725.083715Z → 1.5.0-dev.20260804.124748Z
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.
|
@@ -9,7 +9,16 @@ export declare class RenderingTemplateCollection implements ICollection<Renderin
|
|
|
9
9
|
icon?: string;
|
|
10
10
|
description?: string;
|
|
11
11
|
constructor({ name, title, icon, description, templates }: RenderingTemplateCollectionProps);
|
|
12
|
-
getTemplateDefinitions():
|
|
12
|
+
getTemplateDefinitions(): {
|
|
13
|
+
instructions: string;
|
|
14
|
+
id: string;
|
|
15
|
+
name: string;
|
|
16
|
+
description: string;
|
|
17
|
+
type: "document" | "presentation";
|
|
18
|
+
assets: string[];
|
|
19
|
+
title?: string | undefined;
|
|
20
|
+
tags?: string[] | undefined;
|
|
21
|
+
}[];
|
|
13
22
|
getTemplate(name: string): RenderingTemplateDefinition | undefined;
|
|
14
23
|
[Symbol.iterator](): Iterator<RenderingTemplateDefinition>;
|
|
15
24
|
map<U>(callback: (template: RenderingTemplateDefinition, index: number) => U): U[];
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"RenderingTemplateCollection.d.ts","sourceRoot":"","sources":["../src/RenderingTemplateCollection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAGjG,MAAM,WAAW,gCAAiC,SAAQ,oBAAoB;IAC1E,SAAS,EAAE,2BAA2B,EAAE,CAAC;CAC5C;AAED,qBAAa,2BAA4B,YAAW,WAAW,CAAC,2BAA2B,CAAC;IACxF,SAAS,EAAE,2BAA2B,EAAE,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;gBAET,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,gCAAgC;IAQ3F,sBAAsB
|
|
1
|
+
{"version":3,"file":"RenderingTemplateCollection.d.ts","sourceRoot":"","sources":["../src/RenderingTemplateCollection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAGjG,MAAM,WAAW,gCAAiC,SAAQ,oBAAoB;IAC1E,SAAS,EAAE,2BAA2B,EAAE,CAAC;CAC5C;AAED,qBAAa,2BAA4B,YAAW,WAAW,CAAC,2BAA2B,CAAC;IACxF,SAAS,EAAE,2BAA2B,EAAE,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;gBAET,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,gCAAgC;IAQ3F,sBAAsB;;;;;;;;;;IAItB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,2BAA2B,GAAG,SAAS;IAIlE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,2BAA2B,CAAC;IAe1D,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,2BAA2B,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE;CAGrF"}
|
package/lib/types.d.ts
CHANGED
|
@@ -121,6 +121,39 @@ export interface Tool<ParamsT extends object = object> extends ToolDefinition {
|
|
|
121
121
|
* @returns
|
|
122
122
|
*/
|
|
123
123
|
isEnabled?: (payload: ToolUseContext) => boolean;
|
|
124
|
+
/**
|
|
125
|
+
* Declares which parameter carries the *name of another tool*. See {@link ToolDispatchDescriptor}.
|
|
126
|
+
*/
|
|
127
|
+
dispatch?: ToolDispatchDescriptor;
|
|
128
|
+
}
|
|
129
|
+
/**
|
|
130
|
+
* Which parameter of a tool carries the name of another tool.
|
|
131
|
+
*
|
|
132
|
+
* JSON Schema types such a field as `string`, so every phantom name validates against it. Naming
|
|
133
|
+
* the field here lets build-time validation resolve those names against the registry; without it
|
|
134
|
+
* the mistake surfaces only when an agent attempts the call and the server rejects it.
|
|
135
|
+
*
|
|
136
|
+
* Purely descriptive — nothing reads it at runtime. `@dglabs/workflows` and the skill-markdown
|
|
137
|
+
* checker each declare a structural twin, since neither can depend on this package.
|
|
138
|
+
*/
|
|
139
|
+
export interface ToolDispatchDescriptor {
|
|
140
|
+
/**
|
|
141
|
+
* Path to the parameter holding the tool name, using dots for nesting and `[]` for arrays.
|
|
142
|
+
* Examples: `tool_name`, `allowed_tools[]`, `agent_runner_options.tool_names[]`.
|
|
143
|
+
*/
|
|
144
|
+
field: string;
|
|
145
|
+
/**
|
|
146
|
+
* Path to the parameter holding the input forwarded to the dispatched tool, if any.
|
|
147
|
+
* When set, examples can also be validated against the *dispatched* tool's schema.
|
|
148
|
+
*/
|
|
149
|
+
inputField?: string;
|
|
150
|
+
/** Tool names this dispatcher refuses at runtime. Referencing one is an error. */
|
|
151
|
+
deny?: readonly string[];
|
|
152
|
+
/**
|
|
153
|
+
* True when the runtime strips a leading `+` or `-` before resolving the name — the selection
|
|
154
|
+
* prefixes that add to, or remove from, the default toolset.
|
|
155
|
+
*/
|
|
156
|
+
stripsSelectionPrefix?: boolean;
|
|
124
157
|
}
|
|
125
158
|
/**
|
|
126
159
|
* The interface that should be returned when requesting a collection endpoint using a GET
|
package/lib/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EACR,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,EACrB,UAAU,EACV,iBAAiB,EACjB,cAAc,EACjB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,qBAAqB,EAAE,CAAC;AAEtC,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,MAAM,IAAI,oBAAoB,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AAEzE,MAAM,WAAW,oBAAoB;IACjC;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACjC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,OAAO,EAAE,gBAAgB,CAAC;IAC1B;;;OAGG;IACH,SAAS,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC1D;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB,EAAE,UAAU;IAC1E;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,0BAA0B;IACvC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM;IACjE,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B;;OAEG;IACH,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CACpC;AAED,MAAM,MAAM,MAAM,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,IAAI,CAClD,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC,EACtC,OAAO,EAAE,oBAAoB,KAC5B,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,MAAM,0BAA0B,GAAG,WAAW,GAAG,gBAAgB,GAAG,SAAS,GAAG,uBAAuB,CAAC;AAE9G,MAAM,WAAW,cAAc;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,IAAI,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,cAAc;IACzE,GAAG,CAAC,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACzG;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAEjC;;;;OAIG;IACH,cAAc,CAAC,EAAE,0BAA0B,CAAC;IAE5C;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC;
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@vertesia/tools-sdk",
|
|
3
|
-
"version": "1.5.0-dev.
|
|
3
|
+
"version": "1.5.0-dev.20260804.124748Z",
|
|
4
4
|
"description": "Tools SDK - utilities for building remote tools",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./lib/index.js",
|
|
@@ -23,14 +23,14 @@
|
|
|
23
23
|
"@vertesia/tsconfig": "0.1.0"
|
|
24
24
|
},
|
|
25
25
|
"peerDependencies": {
|
|
26
|
-
"hono": "^4.12.
|
|
26
|
+
"hono": "^4.12.34"
|
|
27
27
|
},
|
|
28
28
|
"dependencies": {
|
|
29
|
-
"jose": "^6.2.
|
|
29
|
+
"jose": "^6.2.4",
|
|
30
30
|
"zod": "^4.4.3",
|
|
31
|
-
"@
|
|
32
|
-
"@vertesia/common": "1.5.0-dev.
|
|
33
|
-
"@
|
|
31
|
+
"@llumiverse/common": "1.5.0-dev.20260804.122431Z",
|
|
32
|
+
"@vertesia/common": "1.5.0-dev.20260804.124748Z",
|
|
33
|
+
"@vertesia/client": "1.5.0-dev.20260804.124748Z"
|
|
34
34
|
},
|
|
35
35
|
"repository": {
|
|
36
36
|
"type": "git",
|
|
@@ -46,7 +46,7 @@
|
|
|
46
46
|
"agents",
|
|
47
47
|
"typescript"
|
|
48
48
|
],
|
|
49
|
-
"gitHead": "
|
|
49
|
+
"gitHead": "87ac9166db2b38bd1be6e37adf0414ea83e402ee",
|
|
50
50
|
"scripts": {
|
|
51
51
|
"lint": "biome lint src",
|
|
52
52
|
"test": "vitest run",
|
package/src/types.ts
CHANGED
|
@@ -149,6 +149,41 @@ export interface Tool<ParamsT extends object = object> extends ToolDefinition {
|
|
|
149
149
|
* @returns
|
|
150
150
|
*/
|
|
151
151
|
isEnabled?: (payload: ToolUseContext) => boolean;
|
|
152
|
+
|
|
153
|
+
/**
|
|
154
|
+
* Declares which parameter carries the *name of another tool*. See {@link ToolDispatchDescriptor}.
|
|
155
|
+
*/
|
|
156
|
+
dispatch?: ToolDispatchDescriptor;
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
/**
|
|
160
|
+
* Which parameter of a tool carries the name of another tool.
|
|
161
|
+
*
|
|
162
|
+
* JSON Schema types such a field as `string`, so every phantom name validates against it. Naming
|
|
163
|
+
* the field here lets build-time validation resolve those names against the registry; without it
|
|
164
|
+
* the mistake surfaces only when an agent attempts the call and the server rejects it.
|
|
165
|
+
*
|
|
166
|
+
* Purely descriptive — nothing reads it at runtime. `@dglabs/workflows` and the skill-markdown
|
|
167
|
+
* checker each declare a structural twin, since neither can depend on this package.
|
|
168
|
+
*/
|
|
169
|
+
export interface ToolDispatchDescriptor {
|
|
170
|
+
/**
|
|
171
|
+
* Path to the parameter holding the tool name, using dots for nesting and `[]` for arrays.
|
|
172
|
+
* Examples: `tool_name`, `allowed_tools[]`, `agent_runner_options.tool_names[]`.
|
|
173
|
+
*/
|
|
174
|
+
field: string;
|
|
175
|
+
/**
|
|
176
|
+
* Path to the parameter holding the input forwarded to the dispatched tool, if any.
|
|
177
|
+
* When set, examples can also be validated against the *dispatched* tool's schema.
|
|
178
|
+
*/
|
|
179
|
+
inputField?: string;
|
|
180
|
+
/** Tool names this dispatcher refuses at runtime. Referencing one is an error. */
|
|
181
|
+
deny?: readonly string[];
|
|
182
|
+
/**
|
|
183
|
+
* True when the runtime strips a leading `+` or `-` before resolving the name — the selection
|
|
184
|
+
* prefixes that add to, or remove from, the default toolset.
|
|
185
|
+
*/
|
|
186
|
+
stripsSelectionPrefix?: boolean;
|
|
152
187
|
}
|
|
153
188
|
|
|
154
189
|
/**
|