@contractspec/lib.ai-agent 1.57.0 → 1.59.0
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/agent/agent-factory.d.ts +67 -71
- package/dist/agent/agent-factory.d.ts.map +1 -1
- package/dist/agent/agent-factory.js +658 -100
- package/dist/agent/agent.test.d.ts +2 -0
- package/dist/agent/agent.test.d.ts.map +1 -0
- package/dist/agent/contract-spec-agent.d.ts +48 -52
- package/dist/agent/contract-spec-agent.d.ts.map +1 -1
- package/dist/agent/contract-spec-agent.js +605 -146
- package/dist/agent/index.d.ts +4 -4
- package/dist/agent/index.d.ts.map +1 -0
- package/dist/agent/index.js +2102 -4
- package/dist/agent/json-runner.d.ts +15 -19
- package/dist/agent/json-runner.d.ts.map +1 -1
- package/dist/agent/json-runner.js +672 -57
- package/dist/agent/json-runner.test.d.ts +2 -0
- package/dist/agent/json-runner.test.d.ts.map +1 -0
- package/dist/agent/unified-agent.d.ts +132 -109
- package/dist/agent/unified-agent.d.ts.map +1 -1
- package/dist/agent/unified-agent.js +2011 -293
- package/dist/approval/index.d.ts +3 -2
- package/dist/approval/index.d.ts.map +1 -0
- package/dist/approval/index.js +128 -2
- package/dist/approval/workflow.d.ts +106 -110
- package/dist/approval/workflow.d.ts.map +1 -1
- package/dist/approval/workflow.js +126 -157
- package/dist/exporters/claude-agent-exporter.d.ts +50 -48
- package/dist/exporters/claude-agent-exporter.d.ts.map +1 -1
- package/dist/exporters/claude-agent-exporter.js +258 -203
- package/dist/exporters/index.d.ts +28 -4
- package/dist/exporters/index.d.ts.map +1 -0
- package/dist/exporters/index.js +737 -3
- package/dist/exporters/opencode-exporter.d.ts +47 -45
- package/dist/exporters/opencode-exporter.d.ts.map +1 -1
- package/dist/exporters/opencode-exporter.js +507 -191
- package/dist/exporters/types.d.ts +171 -169
- package/dist/exporters/types.d.ts.map +1 -1
- package/dist/exporters/types.js +1 -0
- package/dist/index.d.ts +15 -39
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +3337 -32
- package/dist/interop/index.d.ts +48 -4
- package/dist/interop/index.d.ts.map +1 -0
- package/dist/interop/index.js +709 -3
- package/dist/interop/spec-consumer.d.ts +57 -53
- package/dist/interop/spec-consumer.d.ts.map +1 -1
- package/dist/interop/spec-consumer.js +302 -282
- package/dist/interop/tool-consumer.d.ts +57 -53
- package/dist/interop/tool-consumer.d.ts.map +1 -1
- package/dist/interop/tool-consumer.js +412 -213
- package/dist/interop/types.d.ts +173 -171
- package/dist/interop/types.d.ts.map +1 -1
- package/dist/interop/types.js +1 -0
- package/dist/knowledge/index.d.ts +2 -2
- package/dist/knowledge/index.d.ts.map +1 -0
- package/dist/knowledge/index.js +66 -2
- package/dist/knowledge/injector.d.ts +16 -20
- package/dist/knowledge/injector.d.ts.map +1 -1
- package/dist/knowledge/injector.js +56 -47
- package/dist/memory/in-memory.d.ts +15 -19
- package/dist/memory/in-memory.d.ts.map +1 -1
- package/dist/memory/in-memory.js +152 -46
- package/dist/memory/index.d.ts +3 -3
- package/dist/memory/index.d.ts.map +1 -0
- package/dist/memory/index.js +155 -3
- package/dist/memory/manager.d.ts +32 -36
- package/dist/memory/manager.d.ts.map +1 -1
- package/dist/memory/manager.js +96 -70
- package/dist/memory/memory.test.d.ts +2 -0
- package/dist/memory/memory.test.d.ts.map +1 -0
- package/dist/node/agent/agent-factory.js +661 -0
- package/dist/node/agent/contract-spec-agent.js +607 -0
- package/dist/node/agent/index.js +2103 -0
- package/dist/node/agent/json-runner.js +684 -0
- package/dist/node/agent/unified-agent.js +2019 -0
- package/dist/node/approval/index.js +129 -0
- package/dist/node/approval/workflow.js +129 -0
- package/dist/node/exporters/claude-agent-exporter.js +265 -0
- package/dist/node/exporters/index.js +738 -0
- package/dist/node/exporters/opencode-exporter.js +516 -0
- package/dist/node/exporters/types.js +0 -0
- package/dist/node/index.js +3337 -0
- package/dist/node/interop/index.js +710 -0
- package/dist/node/interop/spec-consumer.js +307 -0
- package/dist/node/interop/tool-consumer.js +419 -0
- package/dist/node/interop/types.js +0 -0
- package/dist/node/knowledge/index.js +67 -0
- package/dist/node/knowledge/injector.js +67 -0
- package/dist/node/memory/in-memory.js +154 -0
- package/dist/node/memory/index.js +156 -0
- package/dist/node/memory/manager.js +105 -0
- package/dist/node/providers/claude-agent-sdk/adapter.js +624 -0
- package/dist/node/providers/claude-agent-sdk/index.js +673 -0
- package/dist/node/providers/claude-agent-sdk/session-bridge.js +149 -0
- package/dist/node/providers/claude-agent-sdk/tool-bridge.js +118 -0
- package/dist/node/providers/index.js +1261 -0
- package/dist/node/providers/opencode-sdk/adapter.js +669 -0
- package/dist/node/providers/opencode-sdk/agent-bridge.js +299 -0
- package/dist/node/providers/opencode-sdk/index.js +703 -0
- package/dist/node/providers/opencode-sdk/tool-bridge.js +141 -0
- package/dist/node/providers/registry.js +89 -0
- package/dist/node/providers/types.js +56 -0
- package/dist/node/schema/index.js +195 -0
- package/dist/node/schema/json-schema-to-zod.js +152 -0
- package/dist/node/schema/schema-output.js +190 -0
- package/dist/node/session/index.js +90 -0
- package/dist/node/session/store.js +90 -0
- package/dist/node/spec/index.js +85 -0
- package/dist/node/spec/registry.js +56 -0
- package/dist/node/spec/spec.js +44 -0
- package/dist/node/telemetry/adapter.js +85 -0
- package/dist/node/telemetry/index.js +86 -0
- package/dist/node/tools/index.js +345 -0
- package/dist/node/tools/knowledge-tool.js +74 -0
- package/dist/node/tools/mcp-client.js +47 -0
- package/dist/node/tools/mcp-server.js +205 -0
- package/dist/node/tools/tool-adapter.js +197 -0
- package/dist/node/types.js +0 -0
- package/dist/providers/claude-agent-sdk/adapter.d.ts +60 -52
- package/dist/providers/claude-agent-sdk/adapter.d.ts.map +1 -1
- package/dist/providers/claude-agent-sdk/adapter.js +622 -304
- package/dist/providers/claude-agent-sdk/index.d.ts +22 -4
- package/dist/providers/claude-agent-sdk/index.d.ts.map +1 -0
- package/dist/providers/claude-agent-sdk/index.js +672 -4
- package/dist/providers/claude-agent-sdk/session-bridge.d.ts +43 -40
- package/dist/providers/claude-agent-sdk/session-bridge.d.ts.map +1 -1
- package/dist/providers/claude-agent-sdk/session-bridge.js +121 -130
- package/dist/providers/claude-agent-sdk/tool-bridge.d.ts +63 -60
- package/dist/providers/claude-agent-sdk/tool-bridge.d.ts.map +1 -1
- package/dist/providers/claude-agent-sdk/tool-bridge.js +104 -108
- package/dist/providers/index.d.ts +28 -7
- package/dist/providers/index.d.ts.map +1 -0
- package/dist/providers/index.js +1261 -8
- package/dist/providers/opencode-sdk/adapter.d.ts +56 -48
- package/dist/providers/opencode-sdk/adapter.d.ts.map +1 -1
- package/dist/providers/opencode-sdk/adapter.js +667 -274
- package/dist/providers/opencode-sdk/agent-bridge.d.ts +62 -57
- package/dist/providers/opencode-sdk/agent-bridge.d.ts.map +1 -1
- package/dist/providers/opencode-sdk/agent-bridge.js +289 -155
- package/dist/providers/opencode-sdk/index.d.ts +22 -4
- package/dist/providers/opencode-sdk/index.d.ts.map +1 -0
- package/dist/providers/opencode-sdk/index.js +702 -4
- package/dist/providers/opencode-sdk/tool-bridge.d.ts +41 -42
- package/dist/providers/opencode-sdk/tool-bridge.d.ts.map +1 -1
- package/dist/providers/opencode-sdk/tool-bridge.js +121 -107
- package/dist/providers/registry.d.ts +10 -11
- package/dist/providers/registry.d.ts.map +1 -1
- package/dist/providers/registry.js +86 -49
- package/dist/providers/types.d.ts +169 -166
- package/dist/providers/types.d.ts.map +1 -1
- package/dist/providers/types.js +54 -42
- package/dist/schema/index.d.ts +3 -3
- package/dist/schema/index.d.ts.map +1 -0
- package/dist/schema/index.js +194 -3
- package/dist/schema/json-schema-to-zod.d.ts +23 -26
- package/dist/schema/json-schema-to-zod.d.ts.map +1 -1
- package/dist/schema/json-schema-to-zod.js +138 -110
- package/dist/schema/schema-output.d.ts +29 -32
- package/dist/schema/schema-output.d.ts.map +1 -1
- package/dist/schema/schema-output.js +178 -53
- package/dist/session/index.d.ts +2 -2
- package/dist/session/index.d.ts.map +1 -0
- package/dist/session/index.js +89 -2
- package/dist/session/store.d.ts +51 -55
- package/dist/session/store.d.ts.map +1 -1
- package/dist/session/store.js +85 -74
- package/dist/spec/index.d.ts +3 -3
- package/dist/spec/index.d.ts.map +1 -0
- package/dist/spec/index.js +84 -3
- package/dist/spec/registry.d.ts +32 -36
- package/dist/spec/registry.d.ts.map +1 -1
- package/dist/spec/registry.js +51 -60
- package/dist/spec/spec.d.ts +80 -84
- package/dist/spec/spec.d.ts.map +1 -1
- package/dist/spec/spec.js +40 -26
- package/dist/telemetry/adapter.d.ts +33 -37
- package/dist/telemetry/adapter.d.ts.map +1 -1
- package/dist/telemetry/adapter.js +78 -96
- package/dist/telemetry/index.d.ts +2 -2
- package/dist/telemetry/index.d.ts.map +1 -0
- package/dist/telemetry/index.js +85 -2
- package/dist/tools/index.d.ts +5 -5
- package/dist/tools/index.d.ts.map +1 -0
- package/dist/tools/index.js +344 -5
- package/dist/tools/knowledge-tool.d.ts +4 -8
- package/dist/tools/knowledge-tool.d.ts.map +1 -1
- package/dist/tools/knowledge-tool.js +68 -48
- package/dist/tools/mcp-client.d.ts +17 -21
- package/dist/tools/mcp-client.d.ts.map +1 -1
- package/dist/tools/mcp-client.js +42 -53
- package/dist/tools/mcp-server.d.ts +14 -18
- package/dist/tools/mcp-server.d.ts.map +1 -1
- package/dist/tools/mcp-server.js +200 -64
- package/dist/tools/tool-adapter.d.ts +7 -11
- package/dist/tools/tool-adapter.d.ts.map +1 -1
- package/dist/tools/tool-adapter.js +187 -70
- package/dist/tools/tools.test.d.ts +2 -0
- package/dist/tools/tools.test.d.ts.map +1 -0
- package/dist/types.d.ts +108 -111
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +1 -0
- package/package.json +448 -90
- package/dist/_virtual/_rolldown/runtime.js +0 -8
- package/dist/agent/agent-factory.js.map +0 -1
- package/dist/agent/contract-spec-agent.js.map +0 -1
- package/dist/agent/json-runner.js.map +0 -1
- package/dist/agent/unified-agent.js.map +0 -1
- package/dist/approval/workflow.js.map +0 -1
- package/dist/exporters/claude-agent-exporter.js.map +0 -1
- package/dist/exporters/opencode-exporter.js.map +0 -1
- package/dist/interop/spec-consumer.js.map +0 -1
- package/dist/interop/tool-consumer.js.map +0 -1
- package/dist/knowledge/injector.js.map +0 -1
- package/dist/memory/in-memory.js.map +0 -1
- package/dist/memory/manager.js.map +0 -1
- package/dist/providers/claude-agent-sdk/adapter.js.map +0 -1
- package/dist/providers/claude-agent-sdk/session-bridge.js.map +0 -1
- package/dist/providers/claude-agent-sdk/tool-bridge.js.map +0 -1
- package/dist/providers/opencode-sdk/adapter.js.map +0 -1
- package/dist/providers/opencode-sdk/agent-bridge.js.map +0 -1
- package/dist/providers/opencode-sdk/tool-bridge.js.map +0 -1
- package/dist/providers/registry.js.map +0 -1
- package/dist/providers/types.js.map +0 -1
- package/dist/schema/json-schema-to-zod.js.map +0 -1
- package/dist/schema/schema-output.js.map +0 -1
- package/dist/session/store.js.map +0 -1
- package/dist/spec/registry.js.map +0 -1
- package/dist/spec/spec.js.map +0 -1
- package/dist/telemetry/adapter.js.map +0 -1
- package/dist/tools/knowledge-tool.js.map +0 -1
- package/dist/tools/mcp-client.js.map +0 -1
- package/dist/tools/mcp-server.js.map +0 -1
- package/dist/tools/tool-adapter.js.map +0 -1
package/dist/spec/index.js
CHANGED
|
@@ -1,4 +1,85 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
1
|
+
// @bun
|
|
2
|
+
var __defProp = Object.defineProperty;
|
|
3
|
+
var __export = (target, all) => {
|
|
4
|
+
for (var name in all)
|
|
5
|
+
__defProp(target, name, {
|
|
6
|
+
get: all[name],
|
|
7
|
+
enumerable: true,
|
|
8
|
+
configurable: true,
|
|
9
|
+
set: (newValue) => all[name] = () => newValue
|
|
10
|
+
});
|
|
11
|
+
};
|
|
12
|
+
var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
|
|
13
|
+
var __require = import.meta.require;
|
|
3
14
|
|
|
4
|
-
|
|
15
|
+
// src/spec/spec.ts
|
|
16
|
+
function defineAgent(spec) {
|
|
17
|
+
if (!spec.meta?.key) {
|
|
18
|
+
throw new Error("Agent key is required");
|
|
19
|
+
}
|
|
20
|
+
if (typeof spec.meta.version !== "string") {
|
|
21
|
+
throw new Error(`Agent ${spec.meta.key} is missing a string version`);
|
|
22
|
+
}
|
|
23
|
+
if (!spec.instructions?.trim()) {
|
|
24
|
+
throw new Error(`Agent ${spec.meta.key} requires instructions`);
|
|
25
|
+
}
|
|
26
|
+
if (!spec.tools?.length) {
|
|
27
|
+
throw new Error(`Agent ${spec.meta.key} must expose at least one tool`);
|
|
28
|
+
}
|
|
29
|
+
const toolNames = new Set;
|
|
30
|
+
for (const tool of spec.tools) {
|
|
31
|
+
if (toolNames.has(tool.name)) {
|
|
32
|
+
throw new Error(`Agent ${spec.meta.key} has duplicate tool name: ${tool.name}`);
|
|
33
|
+
}
|
|
34
|
+
toolNames.add(tool.name);
|
|
35
|
+
}
|
|
36
|
+
return Object.freeze(spec);
|
|
37
|
+
}
|
|
38
|
+
function agentKey(meta) {
|
|
39
|
+
return `${meta.key}.v${meta.version}`;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
// src/spec/registry.ts
|
|
43
|
+
import { compareVersions } from "compare-versions";
|
|
44
|
+
import { SpecContractRegistry } from "@contractspec/lib.contracts/registry";
|
|
45
|
+
|
|
46
|
+
class AgentRegistry extends SpecContractRegistry {
|
|
47
|
+
constructor(items) {
|
|
48
|
+
super("agent", items);
|
|
49
|
+
}
|
|
50
|
+
listNames() {
|
|
51
|
+
const names = new Set;
|
|
52
|
+
for (const spec of this.items.values()) {
|
|
53
|
+
names.add(spec.meta.key);
|
|
54
|
+
}
|
|
55
|
+
return [...names];
|
|
56
|
+
}
|
|
57
|
+
require(name, version) {
|
|
58
|
+
const spec = this.get(name, version);
|
|
59
|
+
if (!spec) {
|
|
60
|
+
throw new Error(`Agent spec not found for ${name}${version != null ? `.v${version}` : ""}`);
|
|
61
|
+
}
|
|
62
|
+
return spec;
|
|
63
|
+
}
|
|
64
|
+
has(name, version) {
|
|
65
|
+
return this.get(name, version) !== undefined;
|
|
66
|
+
}
|
|
67
|
+
getVersions(name) {
|
|
68
|
+
const versions = [];
|
|
69
|
+
for (const spec of this.items.values()) {
|
|
70
|
+
if (spec.meta.key === name) {
|
|
71
|
+
versions.push(spec);
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
return versions.sort((a, b) => compareVersions(a.meta.version, b.meta.version));
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
function createAgentRegistry() {
|
|
78
|
+
return new AgentRegistry;
|
|
79
|
+
}
|
|
80
|
+
export {
|
|
81
|
+
defineAgent,
|
|
82
|
+
createAgentRegistry,
|
|
83
|
+
agentKey,
|
|
84
|
+
AgentRegistry
|
|
85
|
+
};
|
package/dist/spec/registry.d.ts
CHANGED
|
@@ -1,46 +1,42 @@
|
|
|
1
|
-
import { AgentSpec } from
|
|
2
|
-
import { SpecContractRegistry } from
|
|
3
|
-
|
|
4
|
-
//#region src/spec/registry.d.ts
|
|
1
|
+
import type { AgentSpec } from './spec';
|
|
2
|
+
import { SpecContractRegistry } from '@contractspec/lib.contracts/registry';
|
|
5
3
|
/**
|
|
6
4
|
* Registry for managing agent specifications.
|
|
7
5
|
*
|
|
8
6
|
* Provides registration, lookup, and version management for agent specs.
|
|
9
7
|
*/
|
|
10
|
-
declare class AgentRegistry extends SpecContractRegistry<'agent', AgentSpec> {
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
8
|
+
export declare class AgentRegistry extends SpecContractRegistry<'agent', AgentSpec> {
|
|
9
|
+
constructor(items?: AgentSpec[]);
|
|
10
|
+
/**
|
|
11
|
+
* List all unique agent names (without versions).
|
|
12
|
+
*/
|
|
13
|
+
listNames(): string[];
|
|
14
|
+
/**
|
|
15
|
+
* Get an agent specification or throw if not found.
|
|
16
|
+
*
|
|
17
|
+
* @param name - Agent name
|
|
18
|
+
* @param version - Optional version
|
|
19
|
+
* @returns The agent spec
|
|
20
|
+
* @throws Error if the spec is not found
|
|
21
|
+
*/
|
|
22
|
+
require(name: string, version?: string): AgentSpec;
|
|
23
|
+
/**
|
|
24
|
+
* Check if an agent is registered.
|
|
25
|
+
*
|
|
26
|
+
* @param name - Agent name
|
|
27
|
+
* @param version - Optional version
|
|
28
|
+
*/
|
|
29
|
+
has(name: string, version?: string): boolean;
|
|
30
|
+
/**
|
|
31
|
+
* Get all versions of an agent.
|
|
32
|
+
*
|
|
33
|
+
* @param name - Agent name
|
|
34
|
+
* @returns Array of specs sorted by version (ascending)
|
|
35
|
+
*/
|
|
36
|
+
getVersions(name: string): AgentSpec[];
|
|
39
37
|
}
|
|
40
38
|
/**
|
|
41
39
|
* Create a new agent registry.
|
|
42
40
|
*/
|
|
43
|
-
declare function createAgentRegistry(): AgentRegistry;
|
|
44
|
-
//#endregion
|
|
45
|
-
export { AgentRegistry, createAgentRegistry };
|
|
41
|
+
export declare function createAgentRegistry(): AgentRegistry;
|
|
46
42
|
//# sourceMappingURL=registry.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"registry.d.ts","
|
|
1
|
+
{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/spec/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAE5E;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,oBAAoB,CAAC,OAAO,EAAE,SAAS,CAAC;gBACtD,KAAK,CAAC,EAAE,SAAS,EAAE;IAItC;;OAEG;IACH,SAAS,IAAI,MAAM,EAAE;IAQrB;;;;;;;OAOG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;IAUlD;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO;IAI5C;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE;CAWvC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD"}
|
package/dist/spec/registry.js
CHANGED
|
@@ -1,65 +1,56 @@
|
|
|
1
|
+
// @bun
|
|
2
|
+
var __defProp = Object.defineProperty;
|
|
3
|
+
var __export = (target, all) => {
|
|
4
|
+
for (var name in all)
|
|
5
|
+
__defProp(target, name, {
|
|
6
|
+
get: all[name],
|
|
7
|
+
enumerable: true,
|
|
8
|
+
configurable: true,
|
|
9
|
+
set: (newValue) => all[name] = () => newValue
|
|
10
|
+
});
|
|
11
|
+
};
|
|
12
|
+
var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
|
|
13
|
+
var __require = import.meta.require;
|
|
14
|
+
|
|
15
|
+
// src/spec/registry.ts
|
|
1
16
|
import { compareVersions } from "compare-versions";
|
|
2
17
|
import { SpecContractRegistry } from "@contractspec/lib.contracts/registry";
|
|
3
18
|
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
/**
|
|
36
|
-
* Check if an agent is registered.
|
|
37
|
-
*
|
|
38
|
-
* @param name - Agent name
|
|
39
|
-
* @param version - Optional version
|
|
40
|
-
*/
|
|
41
|
-
has(name, version) {
|
|
42
|
-
return this.get(name, version) !== void 0;
|
|
43
|
-
}
|
|
44
|
-
/**
|
|
45
|
-
* Get all versions of an agent.
|
|
46
|
-
*
|
|
47
|
-
* @param name - Agent name
|
|
48
|
-
* @returns Array of specs sorted by version (ascending)
|
|
49
|
-
*/
|
|
50
|
-
getVersions(name) {
|
|
51
|
-
const versions = [];
|
|
52
|
-
for (const spec of this.items.values()) if (spec.meta.key === name) versions.push(spec);
|
|
53
|
-
return versions.sort((a, b) => compareVersions(a.meta.version, b.meta.version));
|
|
54
|
-
}
|
|
55
|
-
};
|
|
56
|
-
/**
|
|
57
|
-
* Create a new agent registry.
|
|
58
|
-
*/
|
|
19
|
+
class AgentRegistry extends SpecContractRegistry {
|
|
20
|
+
constructor(items) {
|
|
21
|
+
super("agent", items);
|
|
22
|
+
}
|
|
23
|
+
listNames() {
|
|
24
|
+
const names = new Set;
|
|
25
|
+
for (const spec of this.items.values()) {
|
|
26
|
+
names.add(spec.meta.key);
|
|
27
|
+
}
|
|
28
|
+
return [...names];
|
|
29
|
+
}
|
|
30
|
+
require(name, version) {
|
|
31
|
+
const spec = this.get(name, version);
|
|
32
|
+
if (!spec) {
|
|
33
|
+
throw new Error(`Agent spec not found for ${name}${version != null ? `.v${version}` : ""}`);
|
|
34
|
+
}
|
|
35
|
+
return spec;
|
|
36
|
+
}
|
|
37
|
+
has(name, version) {
|
|
38
|
+
return this.get(name, version) !== undefined;
|
|
39
|
+
}
|
|
40
|
+
getVersions(name) {
|
|
41
|
+
const versions = [];
|
|
42
|
+
for (const spec of this.items.values()) {
|
|
43
|
+
if (spec.meta.key === name) {
|
|
44
|
+
versions.push(spec);
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
return versions.sort((a, b) => compareVersions(a.meta.version, b.meta.version));
|
|
48
|
+
}
|
|
49
|
+
}
|
|
59
50
|
function createAgentRegistry() {
|
|
60
|
-
|
|
51
|
+
return new AgentRegistry;
|
|
61
52
|
}
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
53
|
+
export {
|
|
54
|
+
createAgentRegistry,
|
|
55
|
+
AgentRegistry
|
|
56
|
+
};
|
package/dist/spec/spec.d.ts
CHANGED
|
@@ -1,113 +1,111 @@
|
|
|
1
|
-
import { OwnerShipMeta } from
|
|
2
|
-
import { KnowledgeCategory } from
|
|
3
|
-
import { PolicyRef } from
|
|
4
|
-
|
|
5
|
-
//#region src/spec/spec.d.ts
|
|
1
|
+
import type { OwnerShipMeta } from '@contractspec/lib.contracts/ownership';
|
|
2
|
+
import type { KnowledgeCategory } from '@contractspec/lib.contracts/knowledge/spec';
|
|
3
|
+
import type { PolicyRef } from '@contractspec/lib.contracts/policy/spec';
|
|
6
4
|
/**
|
|
7
5
|
* Metadata for an agent specification.
|
|
8
6
|
*/
|
|
9
|
-
type AgentMeta = OwnerShipMeta;
|
|
7
|
+
export type AgentMeta = OwnerShipMeta;
|
|
10
8
|
/**
|
|
11
9
|
* Configuration for a tool that an agent can use.
|
|
12
10
|
*/
|
|
13
|
-
interface AgentToolConfig {
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
11
|
+
export interface AgentToolConfig {
|
|
12
|
+
/** Tool name (unique within the agent) */
|
|
13
|
+
name: string;
|
|
14
|
+
/** Human-readable description for the LLM */
|
|
15
|
+
description?: string;
|
|
16
|
+
/** JSON Schema fragment for tool parameters */
|
|
17
|
+
schema?: Record<string, unknown>;
|
|
18
|
+
/** Optional cooldown in milliseconds between invocations */
|
|
19
|
+
cooldownMs?: number;
|
|
20
|
+
/** Maximum execution time before timeout */
|
|
21
|
+
timeoutMs?: number;
|
|
22
|
+
/** Whether the tool can be executed without human approval (AI SDK needsApproval = !automationSafe) */
|
|
23
|
+
automationSafe?: boolean;
|
|
24
|
+
/** Explicit approval requirement (overrides automationSafe) */
|
|
25
|
+
requiresApproval?: boolean;
|
|
26
|
+
/** Optional policy guard that must evaluate to allow the tool call */
|
|
27
|
+
policy?: PolicyRef;
|
|
30
28
|
}
|
|
31
29
|
/**
|
|
32
30
|
* Reference to a knowledge space that the agent can access.
|
|
33
31
|
*/
|
|
34
|
-
interface AgentKnowledgeRef {
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
32
|
+
export interface AgentKnowledgeRef {
|
|
33
|
+
/** Knowledge space key */
|
|
34
|
+
key: string;
|
|
35
|
+
/** Optional specific version */
|
|
36
|
+
version?: number;
|
|
37
|
+
/** Filter by knowledge category */
|
|
38
|
+
category?: KnowledgeCategory;
|
|
39
|
+
/** Whether the knowledge is required (static injection) or optional (dynamic RAG) */
|
|
40
|
+
required?: boolean;
|
|
41
|
+
/** Additional instructions appended when the space is available */
|
|
42
|
+
instructions?: string;
|
|
45
43
|
}
|
|
46
44
|
/**
|
|
47
45
|
* Memory configuration for agent session persistence.
|
|
48
46
|
*/
|
|
49
|
-
interface AgentMemoryConfig {
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
47
|
+
export interface AgentMemoryConfig {
|
|
48
|
+
/** Maximum entries to keep in memory */
|
|
49
|
+
maxEntries?: number;
|
|
50
|
+
/** Time-to-live in minutes */
|
|
51
|
+
ttlMinutes?: number;
|
|
52
|
+
/** Number of messages before triggering summarization */
|
|
53
|
+
summaryTrigger?: number;
|
|
54
|
+
/** Whether to persist to long-term storage */
|
|
55
|
+
persistLongTerm?: boolean;
|
|
58
56
|
}
|
|
59
57
|
/**
|
|
60
58
|
* Confidence policy for agent responses.
|
|
61
59
|
*/
|
|
62
|
-
interface AgentConfidencePolicy {
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
60
|
+
export interface AgentConfidencePolicy {
|
|
61
|
+
/** Minimum acceptable confidence before escalation. Defaults to 0.7 */
|
|
62
|
+
min?: number;
|
|
63
|
+
/** Default value used when provider does not report confidence */
|
|
64
|
+
default?: number;
|
|
67
65
|
}
|
|
68
66
|
/**
|
|
69
67
|
* Escalation policy for handling uncertain or failed agent responses.
|
|
70
68
|
*/
|
|
71
|
-
interface AgentEscalationPolicy {
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
69
|
+
export interface AgentEscalationPolicy {
|
|
70
|
+
/** Auto escalate when confidence < threshold */
|
|
71
|
+
confidenceThreshold?: number;
|
|
72
|
+
/** Escalate when a tool throws irrecoverable errors */
|
|
73
|
+
onToolFailure?: boolean;
|
|
74
|
+
/** Escalate when iteration budget exceeded */
|
|
75
|
+
onTimeout?: boolean;
|
|
76
|
+
/** Optional human approval workflow ID */
|
|
77
|
+
approvalWorkflow?: string;
|
|
80
78
|
}
|
|
81
79
|
/**
|
|
82
80
|
* Combined policy configuration for an agent.
|
|
83
81
|
*/
|
|
84
|
-
interface AgentPolicy {
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
82
|
+
export interface AgentPolicy {
|
|
83
|
+
confidence?: AgentConfidencePolicy;
|
|
84
|
+
escalation?: AgentEscalationPolicy;
|
|
85
|
+
/** Feature flags to apply to this agent */
|
|
86
|
+
flags?: string[];
|
|
89
87
|
}
|
|
90
88
|
/**
|
|
91
89
|
* Complete specification for a ContractSpec agent.
|
|
92
90
|
*/
|
|
93
|
-
interface AgentSpec {
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
91
|
+
export interface AgentSpec {
|
|
92
|
+
meta: AgentMeta;
|
|
93
|
+
/** System instructions for the agent */
|
|
94
|
+
instructions: string;
|
|
95
|
+
/** Human-readable description */
|
|
96
|
+
description?: string;
|
|
97
|
+
/** Tags for categorization */
|
|
98
|
+
tags?: string[];
|
|
99
|
+
/** Tools the agent can use */
|
|
100
|
+
tools: AgentToolConfig[];
|
|
101
|
+
/** Memory/session configuration */
|
|
102
|
+
memory?: AgentMemoryConfig;
|
|
103
|
+
/** Knowledge spaces the agent can access */
|
|
104
|
+
knowledge?: AgentKnowledgeRef[];
|
|
105
|
+
/** Policy configuration */
|
|
106
|
+
policy?: AgentPolicy;
|
|
107
|
+
/** Maximum steps per generation (defaults to 10) */
|
|
108
|
+
maxSteps?: number;
|
|
111
109
|
}
|
|
112
110
|
/**
|
|
113
111
|
* Define and validate an agent specification.
|
|
@@ -116,11 +114,9 @@ interface AgentSpec {
|
|
|
116
114
|
* @returns The frozen, validated specification
|
|
117
115
|
* @throws Error if the specification is invalid
|
|
118
116
|
*/
|
|
119
|
-
declare function defineAgent(spec: AgentSpec): AgentSpec;
|
|
117
|
+
export declare function defineAgent(spec: AgentSpec): AgentSpec;
|
|
120
118
|
/**
|
|
121
119
|
* Generate a unique key for an agent spec.
|
|
122
120
|
*/
|
|
123
|
-
declare function agentKey(meta: AgentMeta): string;
|
|
124
|
-
//#endregion
|
|
125
|
-
export { AgentConfidencePolicy, AgentEscalationPolicy, AgentKnowledgeRef, AgentMemoryConfig, AgentMeta, AgentPolicy, AgentSpec, AgentToolConfig, agentKey, defineAgent };
|
|
121
|
+
export declare function agentKey(meta: AgentMeta): string;
|
|
126
122
|
//# sourceMappingURL=spec.d.ts.map
|
package/dist/spec/spec.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"spec.d.ts","
|
|
1
|
+
{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/spec/spec.ts"],"names":[],"mappings":"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"}
|
package/dist/spec/spec.js
CHANGED
|
@@ -1,30 +1,44 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
1
|
+
// @bun
|
|
2
|
+
var __defProp = Object.defineProperty;
|
|
3
|
+
var __export = (target, all) => {
|
|
4
|
+
for (var name in all)
|
|
5
|
+
__defProp(target, name, {
|
|
6
|
+
get: all[name],
|
|
7
|
+
enumerable: true,
|
|
8
|
+
configurable: true,
|
|
9
|
+
set: (newValue) => all[name] = () => newValue
|
|
10
|
+
});
|
|
11
|
+
};
|
|
12
|
+
var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
|
|
13
|
+
var __require = import.meta.require;
|
|
14
|
+
|
|
15
|
+
// src/spec/spec.ts
|
|
9
16
|
function defineAgent(spec) {
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
17
|
+
if (!spec.meta?.key) {
|
|
18
|
+
throw new Error("Agent key is required");
|
|
19
|
+
}
|
|
20
|
+
if (typeof spec.meta.version !== "string") {
|
|
21
|
+
throw new Error(`Agent ${spec.meta.key} is missing a string version`);
|
|
22
|
+
}
|
|
23
|
+
if (!spec.instructions?.trim()) {
|
|
24
|
+
throw new Error(`Agent ${spec.meta.key} requires instructions`);
|
|
25
|
+
}
|
|
26
|
+
if (!spec.tools?.length) {
|
|
27
|
+
throw new Error(`Agent ${spec.meta.key} must expose at least one tool`);
|
|
28
|
+
}
|
|
29
|
+
const toolNames = new Set;
|
|
30
|
+
for (const tool of spec.tools) {
|
|
31
|
+
if (toolNames.has(tool.name)) {
|
|
32
|
+
throw new Error(`Agent ${spec.meta.key} has duplicate tool name: ${tool.name}`);
|
|
33
|
+
}
|
|
34
|
+
toolNames.add(tool.name);
|
|
35
|
+
}
|
|
36
|
+
return Object.freeze(spec);
|
|
20
37
|
}
|
|
21
|
-
/**
|
|
22
|
-
* Generate a unique key for an agent spec.
|
|
23
|
-
*/
|
|
24
38
|
function agentKey(meta) {
|
|
25
|
-
|
|
39
|
+
return `${meta.key}.v${meta.version}`;
|
|
26
40
|
}
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
41
|
+
export {
|
|
42
|
+
defineAgent,
|
|
43
|
+
agentKey
|
|
44
|
+
};
|