@nexalab/agent-sdk 0.1.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/LICENSE +15 -0
- package/README.md +518 -0
- package/bin/nexa.mjs +33 -0
- package/dist/advanced-memory.d.ts +32 -0
- package/dist/advanced-memory.d.ts.map +1 -0
- package/dist/advanced-memory.js +54 -0
- package/dist/advanced-memory.js.map +1 -0
- package/dist/agent-builder.d.ts +60 -0
- package/dist/agent-builder.d.ts.map +1 -0
- package/dist/agent-builder.js +141 -0
- package/dist/agent-builder.js.map +1 -0
- package/dist/approvals.d.ts +34 -0
- package/dist/approvals.d.ts.map +1 -0
- package/dist/approvals.js +54 -0
- package/dist/approvals.js.map +1 -0
- package/dist/artifacts.d.ts +13 -0
- package/dist/artifacts.d.ts.map +1 -0
- package/dist/artifacts.js +13 -0
- package/dist/artifacts.js.map +1 -0
- package/dist/cache.d.ts +17 -0
- package/dist/cache.d.ts.map +1 -0
- package/dist/cache.js +29 -0
- package/dist/cache.js.map +1 -0
- package/dist/completion-gate.d.ts +5 -0
- package/dist/completion-gate.d.ts.map +1 -0
- package/dist/completion-gate.js +20 -0
- package/dist/completion-gate.js.map +1 -0
- package/dist/console-chat.d.ts +110 -0
- package/dist/console-chat.d.ts.map +1 -0
- package/dist/console-chat.js +284 -0
- package/dist/console-chat.js.map +1 -0
- package/dist/context.d.ts +45 -0
- package/dist/context.d.ts.map +1 -0
- package/dist/context.js +92 -0
- package/dist/context.js.map +1 -0
- package/dist/evals.d.ts +38 -0
- package/dist/evals.d.ts.map +1 -0
- package/dist/evals.js +37 -0
- package/dist/evals.js.map +1 -0
- package/dist/event-bus.d.ts +28 -0
- package/dist/event-bus.d.ts.map +1 -0
- package/dist/event-bus.js +28 -0
- package/dist/event-bus.js.map +1 -0
- package/dist/file-storage.d.ts +25 -0
- package/dist/file-storage.d.ts.map +1 -0
- package/dist/file-storage.js +100 -0
- package/dist/file-storage.js.map +1 -0
- package/dist/guardrails.d.ts +44 -0
- package/dist/guardrails.d.ts.map +1 -0
- package/dist/guardrails.js +37 -0
- package/dist/guardrails.js.map +1 -0
- package/dist/harness.d.ts +26 -0
- package/dist/harness.d.ts.map +1 -0
- package/dist/harness.js +49 -0
- package/dist/harness.js.map +1 -0
- package/dist/hooks.d.ts +58 -0
- package/dist/hooks.d.ts.map +1 -0
- package/dist/hooks.js +16 -0
- package/dist/hooks.js.map +1 -0
- package/dist/http-adapter.d.ts +13 -0
- package/dist/http-adapter.d.ts.map +1 -0
- package/dist/http-adapter.js +33 -0
- package/dist/http-adapter.js.map +1 -0
- package/dist/index.d.ts +58 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +58 -0
- package/dist/index.js.map +1 -0
- package/dist/kernel.d.ts +90 -0
- package/dist/kernel.d.ts.map +1 -0
- package/dist/kernel.js +251 -0
- package/dist/kernel.js.map +1 -0
- package/dist/knowledge.d.ts +35 -0
- package/dist/knowledge.d.ts.map +1 -0
- package/dist/knowledge.js +89 -0
- package/dist/knowledge.js.map +1 -0
- package/dist/local-tool-executor.d.ts +26 -0
- package/dist/local-tool-executor.d.ts.map +1 -0
- package/dist/local-tool-executor.js +30 -0
- package/dist/local-tool-executor.js.map +1 -0
- package/dist/loop-guard.d.ts +15 -0
- package/dist/loop-guard.d.ts.map +1 -0
- package/dist/loop-guard.js +12 -0
- package/dist/loop-guard.js.map +1 -0
- package/dist/manifest.d.ts +43 -0
- package/dist/manifest.d.ts.map +1 -0
- package/dist/manifest.js +31 -0
- package/dist/manifest.js.map +1 -0
- package/dist/mcp.d.ts +55 -0
- package/dist/mcp.d.ts.map +1 -0
- package/dist/mcp.js +175 -0
- package/dist/mcp.js.map +1 -0
- package/dist/memory.d.ts +32 -0
- package/dist/memory.d.ts.map +1 -0
- package/dist/memory.js +40 -0
- package/dist/memory.js.map +1 -0
- package/dist/mission-runtime.d.ts +106 -0
- package/dist/mission-runtime.d.ts.map +1 -0
- package/dist/mission-runtime.js +196 -0
- package/dist/mission-runtime.js.map +1 -0
- package/dist/model-harness.d.ts +23 -0
- package/dist/model-harness.d.ts.map +1 -0
- package/dist/model-harness.js +7 -0
- package/dist/model-harness.js.map +1 -0
- package/dist/model-router.d.ts +60 -0
- package/dist/model-router.d.ts.map +1 -0
- package/dist/model-router.js +90 -0
- package/dist/model-router.js.map +1 -0
- package/dist/multi-agent.d.ts +56 -0
- package/dist/multi-agent.d.ts.map +1 -0
- package/dist/multi-agent.js +69 -0
- package/dist/multi-agent.js.map +1 -0
- package/dist/native-tool-loop.d.ts +70 -0
- package/dist/native-tool-loop.d.ts.map +1 -0
- package/dist/native-tool-loop.js +92 -0
- package/dist/native-tool-loop.js.map +1 -0
- package/dist/openai-agent.d.ts +75 -0
- package/dist/openai-agent.d.ts.map +1 -0
- package/dist/openai-agent.js +190 -0
- package/dist/openai-agent.js.map +1 -0
- package/dist/openai-compatible.d.ts +117 -0
- package/dist/openai-compatible.d.ts.map +1 -0
- package/dist/openai-compatible.js +486 -0
- package/dist/openai-compatible.js.map +1 -0
- package/dist/otel.d.ts +12 -0
- package/dist/otel.d.ts.map +1 -0
- package/dist/otel.js +35 -0
- package/dist/otel.js.map +1 -0
- package/dist/permissions.d.ts +6 -0
- package/dist/permissions.d.ts.map +1 -0
- package/dist/permissions.js +33 -0
- package/dist/permissions.js.map +1 -0
- package/dist/plan-validator.d.ts +9 -0
- package/dist/plan-validator.d.ts.map +1 -0
- package/dist/plan-validator.js +27 -0
- package/dist/plan-validator.js.map +1 -0
- package/dist/policy.d.ts +27 -0
- package/dist/policy.d.ts.map +1 -0
- package/dist/policy.js +37 -0
- package/dist/policy.js.map +1 -0
- package/dist/postgres-storage.d.ts +33 -0
- package/dist/postgres-storage.d.ts.map +1 -0
- package/dist/postgres-storage.js +80 -0
- package/dist/postgres-storage.js.map +1 -0
- package/dist/provider-capabilities.d.ts +13 -0
- package/dist/provider-capabilities.d.ts.map +1 -0
- package/dist/provider-capabilities.js +19 -0
- package/dist/provider-capabilities.js.map +1 -0
- package/dist/providers.d.ts +14 -0
- package/dist/providers.d.ts.map +1 -0
- package/dist/providers.js +69 -0
- package/dist/providers.js.map +1 -0
- package/dist/queue.d.ts +29 -0
- package/dist/queue.d.ts.map +1 -0
- package/dist/queue.js +36 -0
- package/dist/queue.js.map +1 -0
- package/dist/redis-storage.d.ts +36 -0
- package/dist/redis-storage.d.ts.map +1 -0
- package/dist/redis-storage.js +68 -0
- package/dist/redis-storage.js.map +1 -0
- package/dist/replay.d.ts +13 -0
- package/dist/replay.d.ts.map +1 -0
- package/dist/replay.js +32 -0
- package/dist/replay.js.map +1 -0
- package/dist/runtime.d.ts +54 -0
- package/dist/runtime.d.ts.map +1 -0
- package/dist/runtime.js +218 -0
- package/dist/runtime.js.map +1 -0
- package/dist/sdk.d.ts +43 -0
- package/dist/sdk.d.ts.map +1 -0
- package/dist/sdk.js +82 -0
- package/dist/sdk.js.map +1 -0
- package/dist/secrets.d.ts +9 -0
- package/dist/secrets.d.ts.map +1 -0
- package/dist/secrets.js +23 -0
- package/dist/secrets.js.map +1 -0
- package/dist/sessions.d.ts +44 -0
- package/dist/sessions.d.ts.map +1 -0
- package/dist/sessions.js +76 -0
- package/dist/sessions.js.map +1 -0
- package/dist/skills.d.ts +12 -0
- package/dist/skills.d.ts.map +1 -0
- package/dist/skills.js +13 -0
- package/dist/skills.js.map +1 -0
- package/dist/smoke.d.ts +8 -0
- package/dist/smoke.d.ts.map +1 -0
- package/dist/smoke.js +5 -0
- package/dist/smoke.js.map +1 -0
- package/dist/sqlite-storage.d.ts +30 -0
- package/dist/sqlite-storage.d.ts.map +1 -0
- package/dist/sqlite-storage.js +52 -0
- package/dist/sqlite-storage.js.map +1 -0
- package/dist/storage.d.ts +74 -0
- package/dist/storage.d.ts.map +1 -0
- package/dist/storage.js +83 -0
- package/dist/storage.js.map +1 -0
- package/dist/structured-output.d.ts +14 -0
- package/dist/structured-output.d.ts.map +1 -0
- package/dist/structured-output.js +24 -0
- package/dist/structured-output.js.map +1 -0
- package/dist/telemetry.d.ts +27 -0
- package/dist/telemetry.d.ts.map +1 -0
- package/dist/telemetry.js +40 -0
- package/dist/telemetry.js.map +1 -0
- package/dist/tenancy.d.ts +9 -0
- package/dist/tenancy.d.ts.map +1 -0
- package/dist/tenancy.js +8 -0
- package/dist/tenancy.js.map +1 -0
- package/dist/tool-factory.d.ts +25 -0
- package/dist/tool-factory.d.ts.map +1 -0
- package/dist/tool-factory.js +38 -0
- package/dist/tool-factory.js.map +1 -0
- package/dist/tool-orchestrator.d.ts +89 -0
- package/dist/tool-orchestrator.d.ts.map +1 -0
- package/dist/tool-orchestrator.js +102 -0
- package/dist/tool-orchestrator.js.map +1 -0
- package/dist/tool-registry.d.ts +52 -0
- package/dist/tool-registry.d.ts.map +1 -0
- package/dist/tool-registry.js +19 -0
- package/dist/tool-registry.js.map +1 -0
- package/dist/types.d.ts +1020 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +115 -0
- package/dist/types.js.map +1 -0
- package/dist/vector-memory.d.ts +19 -0
- package/dist/vector-memory.d.ts.map +1 -0
- package/dist/vector-memory.js +58 -0
- package/dist/vector-memory.js.map +1 -0
- package/dist/workflow.d.ts +65 -0
- package/dist/workflow.d.ts.map +1 -0
- package/dist/workflow.js +102 -0
- package/dist/workflow.js.map +1 -0
- package/dist/workspace.d.ts +35 -0
- package/dist/workspace.d.ts.map +1 -0
- package/dist/workspace.js +131 -0
- package/dist/workspace.js.map +1 -0
- package/package.json +223 -0
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
import { mkdir, readFile, writeFile } from "node:fs/promises";
|
|
2
|
+
import { dirname, join } from "node:path";
|
|
3
|
+
export class JsonFileStorage {
|
|
4
|
+
rootDir;
|
|
5
|
+
constructor(rootDir) {
|
|
6
|
+
this.rootDir = rootDir;
|
|
7
|
+
}
|
|
8
|
+
async saveRun(run) {
|
|
9
|
+
await writeJson(this.path("runs", `${run.runId}.json`), run);
|
|
10
|
+
const indexPath = this.path("indexes", "runs.json");
|
|
11
|
+
await withLock(indexPath, async () => {
|
|
12
|
+
const runs = (await readJsonArray(indexPath)).filter((candidate) => candidate.runId !== run.runId);
|
|
13
|
+
runs.push(run);
|
|
14
|
+
await writeJson(indexPath, runs);
|
|
15
|
+
});
|
|
16
|
+
}
|
|
17
|
+
async getRun(runId) {
|
|
18
|
+
return readJson(this.path("runs", `${runId}.json`));
|
|
19
|
+
}
|
|
20
|
+
async listRuns() {
|
|
21
|
+
return readJsonArray(this.path("indexes", "runs.json"));
|
|
22
|
+
}
|
|
23
|
+
async appendEvent(event) {
|
|
24
|
+
const path = this.path("indexes", "events.json");
|
|
25
|
+
await withLock(path, async () => {
|
|
26
|
+
const events = await readJsonArray(path);
|
|
27
|
+
events.push(event);
|
|
28
|
+
await writeJson(path, events);
|
|
29
|
+
});
|
|
30
|
+
}
|
|
31
|
+
async listEvents() {
|
|
32
|
+
return readJsonArray(this.path("indexes", "events.json"));
|
|
33
|
+
}
|
|
34
|
+
async saveMemory(record) {
|
|
35
|
+
const path = this.path("indexes", "memories.json");
|
|
36
|
+
await withLock(path, async () => {
|
|
37
|
+
const records = (await readJsonArray(path)).filter((candidate) => candidate.id !== record.id);
|
|
38
|
+
records.push(record);
|
|
39
|
+
await writeJson(path, records);
|
|
40
|
+
});
|
|
41
|
+
}
|
|
42
|
+
async listMemories() {
|
|
43
|
+
return readJsonArray(this.path("indexes", "memories.json"));
|
|
44
|
+
}
|
|
45
|
+
async saveApproval(approval) {
|
|
46
|
+
const path = this.path("indexes", "approvals.json");
|
|
47
|
+
await withLock(path, async () => {
|
|
48
|
+
const approvals = (await readJsonArray(path)).filter((candidate) => candidate.id !== approval.id);
|
|
49
|
+
approvals.push(approval);
|
|
50
|
+
await writeJson(path, approvals);
|
|
51
|
+
});
|
|
52
|
+
}
|
|
53
|
+
async getApproval(id) {
|
|
54
|
+
return (await this.listApprovals()).find((approval) => approval.id === id);
|
|
55
|
+
}
|
|
56
|
+
async listApprovals(status) {
|
|
57
|
+
const approvals = await readJsonArray(this.path("indexes", "approvals.json"));
|
|
58
|
+
return status ? approvals.filter((approval) => approval.status === status) : approvals;
|
|
59
|
+
}
|
|
60
|
+
async saveWorkflow(run) {
|
|
61
|
+
await writeJson(this.path("workflows", `${run.id}.json`), run);
|
|
62
|
+
}
|
|
63
|
+
async getWorkflow(id) {
|
|
64
|
+
return readJson(this.path("workflows", `${id}.json`));
|
|
65
|
+
}
|
|
66
|
+
path(...parts) {
|
|
67
|
+
return join(this.rootDir, ...parts);
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
export function createJsonFileStorage(rootDir) {
|
|
71
|
+
return new JsonFileStorage(rootDir);
|
|
72
|
+
}
|
|
73
|
+
const locks = new Map();
|
|
74
|
+
async function withLock(path, fn) {
|
|
75
|
+
const previous = locks.get(path) ?? Promise.resolve();
|
|
76
|
+
const run = previous.then(fn, fn);
|
|
77
|
+
locks.set(path, run.then(() => undefined, () => undefined));
|
|
78
|
+
return run;
|
|
79
|
+
}
|
|
80
|
+
async function writeJson(path, value) {
|
|
81
|
+
await mkdir(dirname(path), { recursive: true });
|
|
82
|
+
await writeFile(path, `${JSON.stringify(value, null, 2)}\n`, "utf8");
|
|
83
|
+
}
|
|
84
|
+
async function readJson(path) {
|
|
85
|
+
try {
|
|
86
|
+
return JSON.parse(await readFile(path, "utf8"));
|
|
87
|
+
}
|
|
88
|
+
catch (error) {
|
|
89
|
+
if (isMissingFile(error))
|
|
90
|
+
return undefined;
|
|
91
|
+
throw error;
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
async function readJsonArray(path) {
|
|
95
|
+
return (await readJson(path)) ?? [];
|
|
96
|
+
}
|
|
97
|
+
function isMissingFile(error) {
|
|
98
|
+
return Boolean(error && typeof error === "object" && "code" in error && error.code === "ENOENT");
|
|
99
|
+
}
|
|
100
|
+
//# sourceMappingURL=file-storage.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"file-storage.js","sourceRoot":"","sources":["../src/file-storage.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import type { ChatMessage } from "./openai-compatible.js";
|
|
2
|
+
export type GuardrailContext = {
|
|
3
|
+
taskId: string;
|
|
4
|
+
runId: string;
|
|
5
|
+
};
|
|
6
|
+
export type GuardrailSeverity = "block" | "warn";
|
|
7
|
+
export type GuardrailCheckInput = {
|
|
8
|
+
text: string;
|
|
9
|
+
messages: ChatMessage[];
|
|
10
|
+
context: GuardrailContext;
|
|
11
|
+
};
|
|
12
|
+
export type GuardrailCheckResult = {
|
|
13
|
+
allowed: boolean;
|
|
14
|
+
reason?: string;
|
|
15
|
+
modifiedText?: string;
|
|
16
|
+
severity?: GuardrailSeverity;
|
|
17
|
+
};
|
|
18
|
+
export type GuardrailCheck = (input: GuardrailCheckInput) => GuardrailCheckResult | Promise<GuardrailCheckResult>;
|
|
19
|
+
export type GuardrailDefinition = {
|
|
20
|
+
id: string;
|
|
21
|
+
description?: string;
|
|
22
|
+
input?: GuardrailCheck;
|
|
23
|
+
output?: GuardrailCheck;
|
|
24
|
+
};
|
|
25
|
+
export type GuardrailViolation = {
|
|
26
|
+
guardrailId: string;
|
|
27
|
+
reason: string;
|
|
28
|
+
severity: GuardrailSeverity;
|
|
29
|
+
stage: "input" | "output";
|
|
30
|
+
};
|
|
31
|
+
export declare class GuardrailViolationError extends Error {
|
|
32
|
+
readonly violation: GuardrailViolation;
|
|
33
|
+
constructor(violation: GuardrailViolation);
|
|
34
|
+
}
|
|
35
|
+
export declare function defineGuardrail(definition: GuardrailDefinition): GuardrailDefinition;
|
|
36
|
+
export declare function runInputGuardrails(guardrails: GuardrailDefinition[], input: GuardrailCheckInput): Promise<{
|
|
37
|
+
text: string;
|
|
38
|
+
violations: GuardrailViolation[];
|
|
39
|
+
}>;
|
|
40
|
+
export declare function runOutputGuardrails(guardrails: GuardrailDefinition[], input: GuardrailCheckInput): Promise<{
|
|
41
|
+
text: string;
|
|
42
|
+
violations: GuardrailViolation[];
|
|
43
|
+
}>;
|
|
44
|
+
//# sourceMappingURL=guardrails.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"guardrails.d.ts","sourceRoot":"","sources":["../src/guardrails.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,MAAM,gBAAgB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AACjE,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,MAAM,CAAC;AAEjD,MAAM,MAAM,mBAAmB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAAC;AACvG,MAAM,MAAM,oBAAoB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAC9H,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,mBAAmB,KAAK,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAElH,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAA;CAAE,CAAC;AAEjI,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;gBAE3B,SAAS,EAAE,kBAAkB;CAK1C;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,mBAAmB,GAAG,mBAAmB,CAEpF;AAED,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,mBAAmB,EAAE,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,kBAAkB,EAAE,CAAA;CAAE,CAAC,CAEnK;AAED,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,mBAAmB,EAAE,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,kBAAkB,EAAE,CAAA;CAAE,CAAC,CAEpK"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
export class GuardrailViolationError extends Error {
|
|
2
|
+
violation;
|
|
3
|
+
constructor(violation) {
|
|
4
|
+
super(`Guardrail "${violation.guardrailId}" blocked the ${violation.stage}: ${violation.reason}`);
|
|
5
|
+
this.name = "GuardrailViolationError";
|
|
6
|
+
this.violation = violation;
|
|
7
|
+
}
|
|
8
|
+
}
|
|
9
|
+
export function defineGuardrail(definition) {
|
|
10
|
+
return definition;
|
|
11
|
+
}
|
|
12
|
+
export async function runInputGuardrails(guardrails, input) {
|
|
13
|
+
return runStage(guardrails, "input", input);
|
|
14
|
+
}
|
|
15
|
+
export async function runOutputGuardrails(guardrails, input) {
|
|
16
|
+
return runStage(guardrails, "output", input);
|
|
17
|
+
}
|
|
18
|
+
async function runStage(guardrails, stage, input) {
|
|
19
|
+
let text = input.text;
|
|
20
|
+
const violations = [];
|
|
21
|
+
for (const guardrail of guardrails) {
|
|
22
|
+
const check = stage === "input" ? guardrail.input : guardrail.output;
|
|
23
|
+
if (!check)
|
|
24
|
+
continue;
|
|
25
|
+
const result = await check({ ...input, text });
|
|
26
|
+
if (result.modifiedText !== undefined)
|
|
27
|
+
text = result.modifiedText;
|
|
28
|
+
if (!result.allowed) {
|
|
29
|
+
const violation = { guardrailId: guardrail.id, reason: result.reason ?? `Blocked by guardrail "${guardrail.id}".`, severity: result.severity ?? "block", stage };
|
|
30
|
+
if (violation.severity === "block")
|
|
31
|
+
throw new GuardrailViolationError(violation);
|
|
32
|
+
violations.push(violation);
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
return { text, violations };
|
|
36
|
+
}
|
|
37
|
+
//# sourceMappingURL=guardrails.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"guardrails.js","sourceRoot":"","sources":["../src/guardrails.ts"],"names":[],"mappings":"AAkBA,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACvC,SAAS,CAAqB;IAEvC,YAAY,SAA6B;QACvC,KAAK,CAAC,cAAc,SAAS,CAAC,WAAW,iBAAiB,SAAS,CAAC,KAAK,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QAClG,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,UAA+B;IAC7D,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,UAAiC,EAAE,KAA0B;IACpG,OAAO,QAAQ,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,UAAiC,EAAE,KAA0B;IACrG,OAAO,QAAQ,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,UAAiC,EAAE,KAAyB,EAAE,KAA0B;IAC9G,IAAI,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACtB,MAAM,UAAU,GAAyB,EAAE,CAAC;IAC5C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC;QACrE,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS;YAAE,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC;QAClE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,SAAS,GAAuB,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,yBAAyB,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACrL,IAAI,SAAS,CAAC,QAAQ,KAAK,OAAO;gBAAE,MAAM,IAAI,uBAAuB,CAAC,SAAS,CAAC,CAAC;YACjF,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAC9B,CAAC"}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
export type HarnessCheckStatus = "passed" | "failed" | "skipped";
|
|
2
|
+
export type HarnessCheck = {
|
|
3
|
+
id: string;
|
|
4
|
+
title: string;
|
|
5
|
+
status: HarnessCheckStatus;
|
|
6
|
+
durationMs: number;
|
|
7
|
+
severity: "info" | "warning" | "critical";
|
|
8
|
+
details?: string;
|
|
9
|
+
};
|
|
10
|
+
export type HarnessReport = {
|
|
11
|
+
ok: boolean;
|
|
12
|
+
startedAt: string;
|
|
13
|
+
endedAt: string;
|
|
14
|
+
durationMs: number;
|
|
15
|
+
checks: HarnessCheck[];
|
|
16
|
+
};
|
|
17
|
+
export type HarnessCheckDefinition = {
|
|
18
|
+
id: string;
|
|
19
|
+
title: string;
|
|
20
|
+
severity?: HarnessCheck["severity"];
|
|
21
|
+
run: () => Promise<string | void> | string | void;
|
|
22
|
+
};
|
|
23
|
+
export declare function runHarness(checks: HarnessCheckDefinition[]): Promise<HarnessReport>;
|
|
24
|
+
export declare function assertHarness(report: HarnessReport): void;
|
|
25
|
+
export declare function summarizeHarness(report: HarnessReport): string;
|
|
26
|
+
//# sourceMappingURL=harness.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../src/harness.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEjE,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,kBAAkB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IACpC,GAAG,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;CACnD,CAAC;AAEF,wBAAsB,UAAU,CAAC,MAAM,EAAE,sBAAsB,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAkCzF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAIzD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAK9D"}
|
package/dist/harness.js
ADDED
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
export async function runHarness(checks) {
|
|
2
|
+
const started = new Date();
|
|
3
|
+
const results = [];
|
|
4
|
+
for (const check of checks) {
|
|
5
|
+
const checkStarted = Date.now();
|
|
6
|
+
try {
|
|
7
|
+
const details = await check.run();
|
|
8
|
+
results.push({
|
|
9
|
+
id: check.id,
|
|
10
|
+
title: check.title,
|
|
11
|
+
status: "passed",
|
|
12
|
+
durationMs: Date.now() - checkStarted,
|
|
13
|
+
severity: check.severity ?? "critical",
|
|
14
|
+
...(details ? { details } : {})
|
|
15
|
+
});
|
|
16
|
+
}
|
|
17
|
+
catch (error) {
|
|
18
|
+
results.push({
|
|
19
|
+
id: check.id,
|
|
20
|
+
title: check.title,
|
|
21
|
+
status: "failed",
|
|
22
|
+
durationMs: Date.now() - checkStarted,
|
|
23
|
+
severity: check.severity ?? "critical",
|
|
24
|
+
details: error instanceof Error ? error.message : String(error)
|
|
25
|
+
});
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
const ended = new Date();
|
|
29
|
+
return {
|
|
30
|
+
ok: results.every((check) => check.status === "passed" || check.severity !== "critical"),
|
|
31
|
+
startedAt: started.toISOString(),
|
|
32
|
+
endedAt: ended.toISOString(),
|
|
33
|
+
durationMs: ended.getTime() - started.getTime(),
|
|
34
|
+
checks: results
|
|
35
|
+
};
|
|
36
|
+
}
|
|
37
|
+
export function assertHarness(report) {
|
|
38
|
+
if (report.ok)
|
|
39
|
+
return;
|
|
40
|
+
const failed = report.checks.filter((check) => check.status === "failed" && check.severity === "critical");
|
|
41
|
+
throw new Error(`Harness failed: ${failed.map((check) => `${check.id}: ${check.details ?? check.title}`).join("; ")}`);
|
|
42
|
+
}
|
|
43
|
+
export function summarizeHarness(report) {
|
|
44
|
+
const passed = report.checks.filter((check) => check.status === "passed").length;
|
|
45
|
+
const failed = report.checks.filter((check) => check.status === "failed").length;
|
|
46
|
+
const skipped = report.checks.filter((check) => check.status === "skipped").length;
|
|
47
|
+
return `Harness ${report.ok ? "passed" : "failed"}: ${passed} passed, ${failed} failed, ${skipped} skipped in ${report.durationMs}ms.`;
|
|
48
|
+
}
|
|
49
|
+
//# sourceMappingURL=harness.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"harness.js","sourceRoot":"","sources":["../src/harness.ts"],"names":[],"mappings":"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"}
|
package/dist/hooks.d.ts
ADDED
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
export type HookContext = {
|
|
2
|
+
taskId?: string;
|
|
3
|
+
runId?: string;
|
|
4
|
+
};
|
|
5
|
+
export type AgentHooks = {
|
|
6
|
+
beforeRun?: (input: {
|
|
7
|
+
text: string;
|
|
8
|
+
context: HookContext;
|
|
9
|
+
}) => void | Promise<void>;
|
|
10
|
+
afterRun?: (input: {
|
|
11
|
+
text: string;
|
|
12
|
+
result: unknown;
|
|
13
|
+
context: HookContext;
|
|
14
|
+
}) => void | Promise<void>;
|
|
15
|
+
beforeModel?: (input: {
|
|
16
|
+
context: HookContext;
|
|
17
|
+
}) => void | Promise<void>;
|
|
18
|
+
afterModel?: (input: {
|
|
19
|
+
text: string;
|
|
20
|
+
context: HookContext;
|
|
21
|
+
}) => void | Promise<void>;
|
|
22
|
+
beforeTool?: (input: {
|
|
23
|
+
toolId: string;
|
|
24
|
+
context: HookContext;
|
|
25
|
+
}) => void | Promise<void>;
|
|
26
|
+
afterTool?: (input: {
|
|
27
|
+
toolId: string;
|
|
28
|
+
result: unknown;
|
|
29
|
+
context: HookContext;
|
|
30
|
+
}) => void | Promise<void>;
|
|
31
|
+
onError?: (input: {
|
|
32
|
+
error: unknown;
|
|
33
|
+
context: HookContext;
|
|
34
|
+
}) => void | Promise<void>;
|
|
35
|
+
onRetry?: (input: {
|
|
36
|
+
attempt: number;
|
|
37
|
+
error: unknown;
|
|
38
|
+
context: HookContext;
|
|
39
|
+
}) => void | Promise<void>;
|
|
40
|
+
onHandoff?: (input: {
|
|
41
|
+
fromAgent: string;
|
|
42
|
+
toAgent: string;
|
|
43
|
+
context: HookContext;
|
|
44
|
+
}) => void | Promise<void>;
|
|
45
|
+
onMemoryWrite?: (input: {
|
|
46
|
+
record: unknown;
|
|
47
|
+
context: HookContext;
|
|
48
|
+
}) => void | Promise<void>;
|
|
49
|
+
};
|
|
50
|
+
type HookName = keyof AgentHooks;
|
|
51
|
+
export declare class HookDispatcher {
|
|
52
|
+
private readonly hooks;
|
|
53
|
+
constructor(hooks?: AgentHooks);
|
|
54
|
+
fire<K extends HookName>(name: K, input: Parameters<NonNullable<AgentHooks[K]>>[0]): Promise<void>;
|
|
55
|
+
}
|
|
56
|
+
export declare function createHookDispatcher(hooks?: AgentHooks): HookDispatcher;
|
|
57
|
+
export {};
|
|
58
|
+
//# sourceMappingURL=hooks.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpF,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpG,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrF,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvF,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvG,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrG,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1G,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5F,CAAC;AAEF,KAAK,QAAQ,GAAG,MAAM,UAAU,CAAC;AAEjC,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,GAAE,UAAe;IAE7C,IAAI,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAKzG;AAED,wBAAgB,oBAAoB,CAAC,KAAK,GAAE,UAAe,GAAG,cAAc,CAE3E"}
|
package/dist/hooks.js
ADDED
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
export class HookDispatcher {
|
|
2
|
+
hooks;
|
|
3
|
+
constructor(hooks = {}) {
|
|
4
|
+
this.hooks = hooks;
|
|
5
|
+
}
|
|
6
|
+
async fire(name, input) {
|
|
7
|
+
const handler = this.hooks[name];
|
|
8
|
+
if (!handler)
|
|
9
|
+
return;
|
|
10
|
+
await handler(input);
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
export function createHookDispatcher(hooks = {}) {
|
|
14
|
+
return new HookDispatcher(hooks);
|
|
15
|
+
}
|
|
16
|
+
//# sourceMappingURL=hooks.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAiBA,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,QAAoB,EAAE;QAAtB,UAAK,GAAL,KAAK,CAAiB;IAAG,CAAC;IAEvD,KAAK,CAAC,IAAI,CAAqB,IAAO,EAAE,KAAgD;QACtF,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAO,OAAoD,CAAC,KAAK,CAAC,CAAC;IACrE,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAoB,EAAE;IACzD,OAAO,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { OpenAICompatibleAgent } from "./openai-agent.js";
|
|
2
|
+
export type AgentHttpRequest = {
|
|
3
|
+
body?: unknown;
|
|
4
|
+
signal?: AbortSignal;
|
|
5
|
+
};
|
|
6
|
+
export type AgentHttpResponse = {
|
|
7
|
+
status: number;
|
|
8
|
+
headers: Record<string, string>;
|
|
9
|
+
body: unknown;
|
|
10
|
+
};
|
|
11
|
+
export declare function handleAgentJsonRequest(agent: Pick<OpenAICompatibleAgent, "runMessage">, request: AgentHttpRequest): Promise<AgentHttpResponse>;
|
|
12
|
+
export declare function createAgentRequestHandler(agent: Pick<OpenAICompatibleAgent, "runMessage">): (request: AgentHttpRequest) => Promise<AgentHttpResponse>;
|
|
13
|
+
//# sourceMappingURL=http-adapter.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"http-adapter.d.ts","sourceRoot":"","sources":["../src/http-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG/D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmBpJ;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAErJ"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
export async function handleAgentJsonRequest(agent, request) {
|
|
2
|
+
const body = parseBody(request.body);
|
|
3
|
+
if (!body.message) {
|
|
4
|
+
return {
|
|
5
|
+
status: 400,
|
|
6
|
+
headers: { "content-type": "application/json" },
|
|
7
|
+
body: { error: "Request body must include a non-empty message string." }
|
|
8
|
+
};
|
|
9
|
+
}
|
|
10
|
+
const result = await agent.runMessage(body.message, body.messages);
|
|
11
|
+
return {
|
|
12
|
+
status: 200,
|
|
13
|
+
headers: { "content-type": "application/json" },
|
|
14
|
+
body: {
|
|
15
|
+
text: result.text,
|
|
16
|
+
messages: result.messages,
|
|
17
|
+
tools: result.nativeToolTurn?.toolResults ?? result.toolTurn.results
|
|
18
|
+
}
|
|
19
|
+
};
|
|
20
|
+
}
|
|
21
|
+
export function createAgentRequestHandler(agent) {
|
|
22
|
+
return (request) => handleAgentJsonRequest(agent, request);
|
|
23
|
+
}
|
|
24
|
+
function parseBody(body) {
|
|
25
|
+
if (!body || typeof body !== "object")
|
|
26
|
+
return { message: "" };
|
|
27
|
+
const candidate = body;
|
|
28
|
+
return {
|
|
29
|
+
message: typeof candidate.message === "string" ? candidate.message : "",
|
|
30
|
+
...(Array.isArray(candidate.messages) ? { messages: candidate.messages } : {})
|
|
31
|
+
};
|
|
32
|
+
}
|
|
33
|
+
//# sourceMappingURL=http-adapter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"http-adapter.js","sourceRoot":"","sources":["../src/http-adapter.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,KAAgD,EAAE,OAAyB;IACtH,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO;YACL,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,EAAE,KAAK,EAAE,uDAAuD,EAAE;SACzE,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnE,OAAO;QACL,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK,EAAE,MAAM,CAAC,cAAc,EAAE,WAAW,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO;SACrE;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAgD;IACxF,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,sBAAsB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,SAAS,CAAC,IAAa;IAC9B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC9D,MAAM,SAAS,GAAG,IAAiD,CAAC;IACpE,OAAO;QACL,OAAO,EAAE,OAAO,SAAS,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;QACvE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAyB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChG,CAAC;AACJ,CAAC"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
export * from "./types.js";
|
|
2
|
+
export * from "./permissions.js";
|
|
3
|
+
export * from "./plan-validator.js";
|
|
4
|
+
export * from "./completion-gate.js";
|
|
5
|
+
export * from "./tool-registry.js";
|
|
6
|
+
export * from "./local-tool-executor.js";
|
|
7
|
+
export * from "./tool-orchestrator.js";
|
|
8
|
+
export * from "./console-chat.js";
|
|
9
|
+
export * from "./loop-guard.js";
|
|
10
|
+
export * from "./runtime.js";
|
|
11
|
+
export * from "./event-bus.js";
|
|
12
|
+
export * from "./memory.js";
|
|
13
|
+
export * from "./approvals.js";
|
|
14
|
+
export * from "./mission-runtime.js";
|
|
15
|
+
export * from "./openai-compatible.js";
|
|
16
|
+
export * from "./providers.js";
|
|
17
|
+
export * from "./tool-factory.js";
|
|
18
|
+
export * from "./storage.js";
|
|
19
|
+
export * from "./file-storage.js";
|
|
20
|
+
export * from "./sqlite-storage.js";
|
|
21
|
+
export * from "./telemetry.js";
|
|
22
|
+
export * from "./otel.js";
|
|
23
|
+
export * from "./evals.js";
|
|
24
|
+
export * from "./http-adapter.js";
|
|
25
|
+
export * from "./native-tool-loop.js";
|
|
26
|
+
export * from "./workflow.js";
|
|
27
|
+
export * from "./replay.js";
|
|
28
|
+
export * from "./policy.js";
|
|
29
|
+
export * from "./model-router.js";
|
|
30
|
+
export * from "./multi-agent.js";
|
|
31
|
+
export * from "./advanced-memory.js";
|
|
32
|
+
export * from "./postgres-storage.js";
|
|
33
|
+
export * from "./redis-storage.js";
|
|
34
|
+
export * from "./vector-memory.js";
|
|
35
|
+
export * from "./queue.js";
|
|
36
|
+
export * from "./smoke.js";
|
|
37
|
+
export * from "./harness.js";
|
|
38
|
+
export * from "./model-harness.js";
|
|
39
|
+
export * from "./agent-builder.js";
|
|
40
|
+
export * from "./openai-agent.js";
|
|
41
|
+
export * from "./sdk.js";
|
|
42
|
+
export * from "./context.js";
|
|
43
|
+
export * from "./sessions.js";
|
|
44
|
+
export * from "./structured-output.js";
|
|
45
|
+
export * from "./guardrails.js";
|
|
46
|
+
export * from "./hooks.js";
|
|
47
|
+
export * from "./skills.js";
|
|
48
|
+
export * from "./artifacts.js";
|
|
49
|
+
export * from "./mcp.js";
|
|
50
|
+
export * from "./knowledge.js";
|
|
51
|
+
export * from "./provider-capabilities.js";
|
|
52
|
+
export * from "./cache.js";
|
|
53
|
+
export * from "./secrets.js";
|
|
54
|
+
export * from "./tenancy.js";
|
|
55
|
+
export * from "./workspace.js";
|
|
56
|
+
export * from "./kernel.js";
|
|
57
|
+
export * from "./manifest.js";
|
|
58
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
export * from "./types.js";
|
|
2
|
+
export * from "./permissions.js";
|
|
3
|
+
export * from "./plan-validator.js";
|
|
4
|
+
export * from "./completion-gate.js";
|
|
5
|
+
export * from "./tool-registry.js";
|
|
6
|
+
export * from "./local-tool-executor.js";
|
|
7
|
+
export * from "./tool-orchestrator.js";
|
|
8
|
+
export * from "./console-chat.js";
|
|
9
|
+
export * from "./loop-guard.js";
|
|
10
|
+
export * from "./runtime.js";
|
|
11
|
+
export * from "./event-bus.js";
|
|
12
|
+
export * from "./memory.js";
|
|
13
|
+
export * from "./approvals.js";
|
|
14
|
+
export * from "./mission-runtime.js";
|
|
15
|
+
export * from "./openai-compatible.js";
|
|
16
|
+
export * from "./providers.js";
|
|
17
|
+
export * from "./tool-factory.js";
|
|
18
|
+
export * from "./storage.js";
|
|
19
|
+
export * from "./file-storage.js";
|
|
20
|
+
export * from "./sqlite-storage.js";
|
|
21
|
+
export * from "./telemetry.js";
|
|
22
|
+
export * from "./otel.js";
|
|
23
|
+
export * from "./evals.js";
|
|
24
|
+
export * from "./http-adapter.js";
|
|
25
|
+
export * from "./native-tool-loop.js";
|
|
26
|
+
export * from "./workflow.js";
|
|
27
|
+
export * from "./replay.js";
|
|
28
|
+
export * from "./policy.js";
|
|
29
|
+
export * from "./model-router.js";
|
|
30
|
+
export * from "./multi-agent.js";
|
|
31
|
+
export * from "./advanced-memory.js";
|
|
32
|
+
export * from "./postgres-storage.js";
|
|
33
|
+
export * from "./redis-storage.js";
|
|
34
|
+
export * from "./vector-memory.js";
|
|
35
|
+
export * from "./queue.js";
|
|
36
|
+
export * from "./smoke.js";
|
|
37
|
+
export * from "./harness.js";
|
|
38
|
+
export * from "./model-harness.js";
|
|
39
|
+
export * from "./agent-builder.js";
|
|
40
|
+
export * from "./openai-agent.js";
|
|
41
|
+
export * from "./sdk.js";
|
|
42
|
+
export * from "./context.js";
|
|
43
|
+
export * from "./sessions.js";
|
|
44
|
+
export * from "./structured-output.js";
|
|
45
|
+
export * from "./guardrails.js";
|
|
46
|
+
export * from "./hooks.js";
|
|
47
|
+
export * from "./skills.js";
|
|
48
|
+
export * from "./artifacts.js";
|
|
49
|
+
export * from "./mcp.js";
|
|
50
|
+
export * from "./knowledge.js";
|
|
51
|
+
export * from "./provider-capabilities.js";
|
|
52
|
+
export * from "./cache.js";
|
|
53
|
+
export * from "./secrets.js";
|
|
54
|
+
export * from "./tenancy.js";
|
|
55
|
+
export * from "./workspace.js";
|
|
56
|
+
export * from "./kernel.js";
|
|
57
|
+
export * from "./manifest.js";
|
|
58
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}
|
package/dist/kernel.d.ts
ADDED
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { AgentTool } from "./agent-builder.js";
|
|
3
|
+
import { type AgentMessageResult, type AgentToolRegistration, type OpenAICompatibleAgent } from "./openai-agent.js";
|
|
4
|
+
import type { ChatMessage, OpenAICompatibleProviderConfig } from "./openai-compatible.js";
|
|
5
|
+
import { AdvancedMemoryStore } from "./advanced-memory.js";
|
|
6
|
+
import { type ContextEngineConfig } from "./context.js";
|
|
7
|
+
import { type GuardrailDefinition } from "./guardrails.js";
|
|
8
|
+
import { type AgentHooks } from "./hooks.js";
|
|
9
|
+
import { AgentSession } from "./sessions.js";
|
|
10
|
+
import type { NexaStorage } from "./storage.js";
|
|
11
|
+
import type { NexaTelemetry } from "./telemetry.js";
|
|
12
|
+
import type { ModelRouter } from "./model-router.js";
|
|
13
|
+
import type { ToolRouter, ToolTraceEvent } from "./tool-orchestrator.js";
|
|
14
|
+
import { type SkillDefinition } from "./skills.js";
|
|
15
|
+
import { type Artifact } from "./artifacts.js";
|
|
16
|
+
import type { McpConnection } from "./mcp.js";
|
|
17
|
+
import type { Knowledge } from "./knowledge.js";
|
|
18
|
+
import type { Cache } from "./cache.js";
|
|
19
|
+
import { type TenantContext } from "./tenancy.js";
|
|
20
|
+
import type { PermissionMatrix } from "./permissions.js";
|
|
21
|
+
import type { ModelHarness } from "./model-harness.js";
|
|
22
|
+
export declare function resolveModelString(modelString: string): {
|
|
23
|
+
provider: OpenAICompatibleProviderConfig;
|
|
24
|
+
model: string;
|
|
25
|
+
};
|
|
26
|
+
export type NexaAgentConfig = {
|
|
27
|
+
name: string;
|
|
28
|
+
model: string;
|
|
29
|
+
provider?: OpenAICompatibleProviderConfig;
|
|
30
|
+
instructions?: string;
|
|
31
|
+
tools?: Array<AgentTool | AgentToolRegistration>;
|
|
32
|
+
skills?: SkillDefinition[];
|
|
33
|
+
mcp?: McpConnection[];
|
|
34
|
+
handoffs?: NexaAgent[];
|
|
35
|
+
memory?: boolean | AdvancedMemoryStore;
|
|
36
|
+
context?: ContextEngineConfig;
|
|
37
|
+
knowledge?: Knowledge[];
|
|
38
|
+
guardrails?: GuardrailDefinition[];
|
|
39
|
+
hooks?: AgentHooks;
|
|
40
|
+
outputSchema?: z.ZodTypeAny;
|
|
41
|
+
storage?: NexaStorage;
|
|
42
|
+
telemetry?: NexaTelemetry;
|
|
43
|
+
modelRouter?: ModelRouter;
|
|
44
|
+
trace?: (event: ToolTraceEvent) => void;
|
|
45
|
+
toolRouter?: ToolRouter;
|
|
46
|
+
cache?: Cache;
|
|
47
|
+
cacheTtlMs?: number;
|
|
48
|
+
permissions?: PermissionMatrix;
|
|
49
|
+
harness?: ModelHarness;
|
|
50
|
+
};
|
|
51
|
+
export type NexaAgentRunOptions<T = unknown> = {
|
|
52
|
+
messages?: ChatMessage[];
|
|
53
|
+
outputSchema?: z.ZodType<T>;
|
|
54
|
+
tenant?: TenantContext;
|
|
55
|
+
};
|
|
56
|
+
export type NexaAgentRunResult<T = unknown> = AgentMessageResult & {
|
|
57
|
+
output?: T;
|
|
58
|
+
artifacts: Artifact[];
|
|
59
|
+
handoffTo?: string;
|
|
60
|
+
};
|
|
61
|
+
export type NexaAgent = {
|
|
62
|
+
name: string;
|
|
63
|
+
underlying: OpenAICompatibleAgent;
|
|
64
|
+
memory?: AdvancedMemoryStore;
|
|
65
|
+
run<T = unknown>(text: string, options?: NexaAgentRunOptions<T>): Promise<NexaAgentRunResult<T>>;
|
|
66
|
+
session(id?: string): AgentSession;
|
|
67
|
+
asTool(input?: {
|
|
68
|
+
id?: string;
|
|
69
|
+
description?: string;
|
|
70
|
+
}): AgentToolRegistration;
|
|
71
|
+
};
|
|
72
|
+
export declare function agent(config: NexaAgentConfig): Promise<NexaAgent>;
|
|
73
|
+
export type TeamStrategy = "supervisor" | "router" | "parallel";
|
|
74
|
+
export type CreateTeamInput = {
|
|
75
|
+
supervisor?: NexaAgent;
|
|
76
|
+
agents: NexaAgent[];
|
|
77
|
+
strategy?: TeamStrategy;
|
|
78
|
+
};
|
|
79
|
+
export type TeamRunResult = {
|
|
80
|
+
text: string;
|
|
81
|
+
results: Array<{
|
|
82
|
+
agent: string;
|
|
83
|
+
result: NexaAgentRunResult;
|
|
84
|
+
}>;
|
|
85
|
+
};
|
|
86
|
+
export type Team = {
|
|
87
|
+
run(task: string): Promise<TeamRunResult>;
|
|
88
|
+
};
|
|
89
|
+
export declare function createTeam(input: CreateTeamInput): Team;
|
|
90
|
+
//# sourceMappingURL=kernel.d.ts.map
|