@aaac/runtime 0.0.1 → 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/dist/adapters/adk-sdk.d.ts +129 -0
- package/dist/adapters/adk-sdk.js +185 -0
- package/dist/adapters/adk-sdk.js.map +1 -0
- package/dist/adapters/claude-agent-sdk.d.ts +97 -0
- package/dist/adapters/claude-agent-sdk.js +244 -0
- package/dist/adapters/claude-agent-sdk.js.map +1 -0
- package/dist/adapters/mock.d.ts +18 -0
- package/dist/adapters/mock.js +41 -0
- package/dist/adapters/mock.js.map +1 -0
- package/dist/adapters/openai-agents-sdk.d.ts +123 -0
- package/dist/adapters/openai-agents-sdk.js +239 -0
- package/dist/adapters/openai-agents-sdk.js.map +1 -0
- package/dist/chunk-LTZA6QWC.js +296 -0
- package/dist/chunk-LTZA6QWC.js.map +1 -0
- package/dist/chunk-MGRZBGQL.js +321 -0
- package/dist/chunk-MGRZBGQL.js.map +1 -0
- package/dist/context-B_bekYiE.d.ts +106 -0
- package/dist/generator/index.d.ts +140 -0
- package/dist/generator/index.js +308 -0
- package/dist/generator/index.js.map +1 -0
- package/dist/guardrail-hooks-C8G5NGsj.d.ts +83 -0
- package/dist/index.d.ts +805 -2
- package/dist/index.js +2505 -2
- package/dist/index.js.map +1 -1
- package/dist/task-runner-CNj3Ujy0.d.ts +492 -0
- package/package.json +51 -4
|
@@ -0,0 +1,308 @@
|
|
|
1
|
+
import {
|
|
2
|
+
buildContractContext,
|
|
3
|
+
buildGuardrailContext,
|
|
4
|
+
renderTemplate
|
|
5
|
+
} from "../chunk-LTZA6QWC.js";
|
|
6
|
+
|
|
7
|
+
// src/generator/index.ts
|
|
8
|
+
import { readFile as readFile2, writeFile, mkdir, rm } from "fs/promises";
|
|
9
|
+
import { resolve as resolve2, join as join2, relative } from "path";
|
|
10
|
+
import { createHash } from "crypto";
|
|
11
|
+
import YAML2 from "yaml";
|
|
12
|
+
|
|
13
|
+
// src/generator/config.ts
|
|
14
|
+
import { existsSync } from "fs";
|
|
15
|
+
import { readFile } from "fs/promises";
|
|
16
|
+
import { resolve, dirname, join, basename } from "path";
|
|
17
|
+
import { z } from "zod";
|
|
18
|
+
import YAML from "yaml";
|
|
19
|
+
var DEFAULT_CONFIG_PATH = "./agents.conf.yaml";
|
|
20
|
+
var LEGACY_CONFIG_FILENAME = "agent-runtime.config.yaml";
|
|
21
|
+
var RecoverySchema = z.object({
|
|
22
|
+
max_follow_ups: z.number().int().min(0).default(2),
|
|
23
|
+
max_retries: z.number().int().min(0).default(0)
|
|
24
|
+
}).default(() => ({ max_follow_ups: 2, max_retries: 0 }));
|
|
25
|
+
var ModelClassEntrySchema = z.object({
|
|
26
|
+
adapter: z.string(),
|
|
27
|
+
model: z.string().optional()
|
|
28
|
+
});
|
|
29
|
+
var ModelMappingSchema = z.object({
|
|
30
|
+
fast: ModelClassEntrySchema.optional(),
|
|
31
|
+
standard: ModelClassEntrySchema.optional(),
|
|
32
|
+
thinking: ModelClassEntrySchema.optional()
|
|
33
|
+
}).default({});
|
|
34
|
+
var ProgressLogSchema = z.object({
|
|
35
|
+
destination: z.enum(["stderr", "file", "both", "none"]).default("stderr"),
|
|
36
|
+
file: z.string().optional(),
|
|
37
|
+
naming: z.enum(["single", "per-invocation", "daily"]).default("single")
|
|
38
|
+
}).default(() => ({ destination: "stderr", naming: "single" })).refine(
|
|
39
|
+
(val) => {
|
|
40
|
+
if ((val.destination === "file" || val.destination === "both") && !val.file) return false;
|
|
41
|
+
return true;
|
|
42
|
+
},
|
|
43
|
+
{ message: "logging.progress_log.file is required when destination is 'file' or 'both'" }
|
|
44
|
+
);
|
|
45
|
+
var LoggingSchema = z.object({
|
|
46
|
+
progress_log: ProgressLogSchema
|
|
47
|
+
}).default(() => ({ progress_log: { destination: "stderr", naming: "single" } }));
|
|
48
|
+
var RuntimeConfigSchema = z.object({
|
|
49
|
+
dsl: z.string().default("./agent-contracts.yaml"),
|
|
50
|
+
generated_dir: z.string().default("./agent/generated"),
|
|
51
|
+
bindings: z.array(z.string()).default([]),
|
|
52
|
+
active_guardrail_policy: z.string().optional(),
|
|
53
|
+
templates_dir: z.string().optional(),
|
|
54
|
+
plugins: z.array(z.string()).default([]),
|
|
55
|
+
recovery: RecoverySchema,
|
|
56
|
+
model_mapping: ModelMappingSchema,
|
|
57
|
+
logging: LoggingSchema
|
|
58
|
+
});
|
|
59
|
+
var CliSectionSchema = z.object({
|
|
60
|
+
dsl: z.string().optional(),
|
|
61
|
+
generated_dir: z.string().optional(),
|
|
62
|
+
plugins: z.array(z.string()).optional(),
|
|
63
|
+
bindings: z.array(z.string()).optional()
|
|
64
|
+
}).strict();
|
|
65
|
+
var ProjectConfigSchema = z.object({
|
|
66
|
+
dsl: z.string().optional(),
|
|
67
|
+
generated_dir: z.string().optional(),
|
|
68
|
+
bindings: z.array(z.string()).optional(),
|
|
69
|
+
active_guardrail_policy: z.string().optional(),
|
|
70
|
+
templates_dir: z.string().optional(),
|
|
71
|
+
plugins: z.array(z.string()).optional(),
|
|
72
|
+
recovery: RecoverySchema,
|
|
73
|
+
model_mapping: ModelMappingSchema,
|
|
74
|
+
logging: LoggingSchema,
|
|
75
|
+
cli: z.record(z.string(), CliSectionSchema).optional()
|
|
76
|
+
});
|
|
77
|
+
function resolveConfigFilePath(configPath) {
|
|
78
|
+
const absPath = resolve(configPath);
|
|
79
|
+
if (existsSync(absPath)) {
|
|
80
|
+
return absPath;
|
|
81
|
+
}
|
|
82
|
+
const dir = dirname(absPath);
|
|
83
|
+
const base = basename(absPath);
|
|
84
|
+
if (base === "agents.conf.yaml") {
|
|
85
|
+
const legacyPath = join(dir, LEGACY_CONFIG_FILENAME);
|
|
86
|
+
if (existsSync(legacyPath)) {
|
|
87
|
+
return legacyPath;
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
return absPath;
|
|
91
|
+
}
|
|
92
|
+
function buildResolvedConfig(config, configDir) {
|
|
93
|
+
const pl = config.logging.progress_log;
|
|
94
|
+
return {
|
|
95
|
+
...config,
|
|
96
|
+
configDir,
|
|
97
|
+
dslPath: resolve(configDir, config.dsl),
|
|
98
|
+
generatedDir: resolve(configDir, config.generated_dir),
|
|
99
|
+
bindingPaths: config.bindings.map((b) => resolve(configDir, b)),
|
|
100
|
+
templatesDir: config.templates_dir ? resolve(configDir, config.templates_dir) : void 0,
|
|
101
|
+
pluginPaths: config.plugins,
|
|
102
|
+
resolvedLogging: {
|
|
103
|
+
progressLog: {
|
|
104
|
+
destination: pl.destination,
|
|
105
|
+
file: pl.file ? resolve(configDir, pl.file) : void 0,
|
|
106
|
+
naming: pl.naming
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
};
|
|
110
|
+
}
|
|
111
|
+
async function loadConfig(configPath) {
|
|
112
|
+
const absPath = resolveConfigFilePath(configPath);
|
|
113
|
+
const raw = await readFile(absPath, "utf8");
|
|
114
|
+
const parsed = YAML.parse(raw);
|
|
115
|
+
const config = RuntimeConfigSchema.parse(parsed);
|
|
116
|
+
const configDir = dirname(absPath);
|
|
117
|
+
return buildResolvedConfig(config, configDir);
|
|
118
|
+
}
|
|
119
|
+
async function loadProjectConfig(configPath, cliName) {
|
|
120
|
+
const absPath = resolveConfigFilePath(configPath);
|
|
121
|
+
const raw = await readFile(absPath, "utf8");
|
|
122
|
+
const parsed = YAML.parse(raw);
|
|
123
|
+
const projectConfig = ProjectConfigSchema.parse(parsed);
|
|
124
|
+
const { cli: _cli, ...baseConfig } = projectConfig;
|
|
125
|
+
let merged = { ...baseConfig };
|
|
126
|
+
if (cliName && projectConfig.cli?.[cliName]) {
|
|
127
|
+
merged = { ...merged, ...projectConfig.cli[cliName] };
|
|
128
|
+
}
|
|
129
|
+
const config = RuntimeConfigSchema.parse(merged);
|
|
130
|
+
const configDir = dirname(absPath);
|
|
131
|
+
return buildResolvedConfig(config, configDir);
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
// src/generator/index.ts
|
|
135
|
+
var DO_NOT_EDIT_HEADER = `/**
|
|
136
|
+
* AUTO-GENERATED by agent-contracts-runtime. DO NOT EDIT.
|
|
137
|
+
*
|
|
138
|
+
* Regenerate via: npx agent-runtime generate
|
|
139
|
+
*/
|
|
140
|
+
|
|
141
|
+
`;
|
|
142
|
+
async function loadYaml(filePath) {
|
|
143
|
+
const raw = await readFile2(filePath, "utf8");
|
|
144
|
+
return YAML2.parse(raw);
|
|
145
|
+
}
|
|
146
|
+
function computeHash(data) {
|
|
147
|
+
return createHash("sha256").update(data).digest("hex");
|
|
148
|
+
}
|
|
149
|
+
function sortDeep(value) {
|
|
150
|
+
if (Array.isArray(value)) return value.map(sortDeep);
|
|
151
|
+
if (value !== null && typeof value === "object") {
|
|
152
|
+
return Object.fromEntries(
|
|
153
|
+
Object.entries(value).sort(([a], [b]) => a.localeCompare(b)).map(([k, v]) => [k, sortDeep(v)])
|
|
154
|
+
);
|
|
155
|
+
}
|
|
156
|
+
return value;
|
|
157
|
+
}
|
|
158
|
+
function canonicalStringify(obj) {
|
|
159
|
+
return JSON.stringify(sortDeep(obj));
|
|
160
|
+
}
|
|
161
|
+
async function loadDsl(dslPath) {
|
|
162
|
+
const { resolve: resolveDsl } = await import("agent-contracts");
|
|
163
|
+
const result = await resolveDsl(dslPath);
|
|
164
|
+
return result.data;
|
|
165
|
+
}
|
|
166
|
+
var CONTRACT_TEMPLATES = [
|
|
167
|
+
{ template: "agents.ts.hbs", output: "agents.ts" },
|
|
168
|
+
{ template: "tasks.ts.hbs", output: "tasks.ts" },
|
|
169
|
+
{ template: "workflows.ts.hbs", output: "workflows.ts" },
|
|
170
|
+
{ template: "handoffs.ts.hbs", output: "handoffs.ts" },
|
|
171
|
+
{ template: "contracts-index.ts.hbs", output: "index.ts" }
|
|
172
|
+
];
|
|
173
|
+
async function generate(options = {}) {
|
|
174
|
+
const configPath = options.configPath ?? "./agents.conf.yaml";
|
|
175
|
+
const config = await loadConfig(configPath);
|
|
176
|
+
const templatesDir = options.templates ?? config.templatesDir;
|
|
177
|
+
const checkMode = options.check ?? false;
|
|
178
|
+
const cleaned = options.clean ?? false;
|
|
179
|
+
if (cleaned && !checkMode) {
|
|
180
|
+
try {
|
|
181
|
+
await rm(config.generatedDir, { recursive: true, force: true });
|
|
182
|
+
} catch {
|
|
183
|
+
}
|
|
184
|
+
}
|
|
185
|
+
const dsl = await loadDsl(config.dslPath);
|
|
186
|
+
const dslCanonical = canonicalStringify(dsl);
|
|
187
|
+
const dslHash = computeHash(dslCanonical);
|
|
188
|
+
const contractCtx = buildContractContext(dsl);
|
|
189
|
+
const files_generated = [];
|
|
190
|
+
const generatedContents = /* @__PURE__ */ new Map();
|
|
191
|
+
for (const { template, output } of CONTRACT_TEMPLATES) {
|
|
192
|
+
const rendered = DO_NOT_EDIT_HEADER + await renderTemplate(template, contractCtx, templatesDir);
|
|
193
|
+
const outPath = join2(config.generatedDir, output);
|
|
194
|
+
files_generated.push(relative(config.configDir, outPath));
|
|
195
|
+
generatedContents.set(outPath, rendered);
|
|
196
|
+
}
|
|
197
|
+
let guardrailRules;
|
|
198
|
+
if (config.bindingPaths.length > 0) {
|
|
199
|
+
for (const bindingPath of config.bindingPaths) {
|
|
200
|
+
const binding = await loadYaml(bindingPath);
|
|
201
|
+
const guardrailCtx = buildGuardrailContext(dsl, binding, config.active_guardrail_policy);
|
|
202
|
+
if (guardrailCtx.hasGuardrails) {
|
|
203
|
+
guardrailRules = {
|
|
204
|
+
commandRules: guardrailCtx.commandChecks.map((c) => ({
|
|
205
|
+
guardrail_id: c.guardrail_id,
|
|
206
|
+
pattern: c.pattern,
|
|
207
|
+
action: c.action,
|
|
208
|
+
message: c.message
|
|
209
|
+
})),
|
|
210
|
+
fileRules: guardrailCtx.fileChecks.map((c) => ({
|
|
211
|
+
guardrail_id: c.guardrail_id,
|
|
212
|
+
pattern: c.pattern,
|
|
213
|
+
action: c.action,
|
|
214
|
+
message: c.message,
|
|
215
|
+
...c.exclude_glob ? { exclude_glob: c.exclude_glob } : {}
|
|
216
|
+
})),
|
|
217
|
+
contentRules: guardrailCtx.contentChecks.map((c) => ({
|
|
218
|
+
guardrail_id: c.guardrail_id,
|
|
219
|
+
pattern: c.pattern,
|
|
220
|
+
action: c.action,
|
|
221
|
+
message: c.message,
|
|
222
|
+
...c.file_glob ? { file_glob: c.file_glob } : {},
|
|
223
|
+
...c.exclude_glob ? { exclude_glob: c.exclude_glob } : {}
|
|
224
|
+
}))
|
|
225
|
+
};
|
|
226
|
+
}
|
|
227
|
+
}
|
|
228
|
+
}
|
|
229
|
+
{
|
|
230
|
+
const dslWithRules = guardrailRules ? { ...dsl, _guardrailRules: guardrailRules } : dsl;
|
|
231
|
+
const dslDataContent = DO_NOT_EDIT_HEADER + `export const resolvedDsl: Record<string, unknown> = ${JSON.stringify(dslWithRules, null, 2)} as const;
|
|
232
|
+
`;
|
|
233
|
+
const outPath = join2(config.generatedDir, "dsl-data.ts");
|
|
234
|
+
files_generated.push(relative(config.configDir, outPath));
|
|
235
|
+
generatedContents.set(outPath, dslDataContent);
|
|
236
|
+
}
|
|
237
|
+
const generationInputParts = [dslCanonical];
|
|
238
|
+
for (const bp of config.bindingPaths) {
|
|
239
|
+
try {
|
|
240
|
+
generationInputParts.push(await readFile2(bp, "utf8"));
|
|
241
|
+
} catch {
|
|
242
|
+
}
|
|
243
|
+
}
|
|
244
|
+
const generation_input_hash = computeHash(generationInputParts.join("\n---\n"));
|
|
245
|
+
let has_differences = false;
|
|
246
|
+
if (checkMode) {
|
|
247
|
+
for (const [outPath, content] of generatedContents) {
|
|
248
|
+
try {
|
|
249
|
+
const existing = await readFile2(outPath, "utf8");
|
|
250
|
+
if (existing !== content) {
|
|
251
|
+
has_differences = true;
|
|
252
|
+
break;
|
|
253
|
+
}
|
|
254
|
+
} catch {
|
|
255
|
+
has_differences = true;
|
|
256
|
+
break;
|
|
257
|
+
}
|
|
258
|
+
}
|
|
259
|
+
} else {
|
|
260
|
+
for (const [outPath, content] of generatedContents) {
|
|
261
|
+
const dir = resolve2(outPath, "..");
|
|
262
|
+
await mkdir(dir, { recursive: true });
|
|
263
|
+
await writeFile(outPath, content, "utf8");
|
|
264
|
+
}
|
|
265
|
+
const manifest = {
|
|
266
|
+
generated_at: (/* @__PURE__ */ new Date()).toISOString(),
|
|
267
|
+
dsl_hash: dslHash,
|
|
268
|
+
generation_input_hash,
|
|
269
|
+
files: files_generated
|
|
270
|
+
};
|
|
271
|
+
const manifestPath = join2(config.generatedDir, ".manifest.json");
|
|
272
|
+
await mkdir(resolve2(manifestPath, ".."), { recursive: true });
|
|
273
|
+
await writeFile(manifestPath, JSON.stringify(manifest, null, 2) + "\n", "utf8");
|
|
274
|
+
}
|
|
275
|
+
return {
|
|
276
|
+
files_generated,
|
|
277
|
+
dsl_hash: dslHash,
|
|
278
|
+
generation_input_hash,
|
|
279
|
+
cleaned,
|
|
280
|
+
check_mode: checkMode,
|
|
281
|
+
has_differences
|
|
282
|
+
};
|
|
283
|
+
}
|
|
284
|
+
async function checkFreshness(configPath) {
|
|
285
|
+
const config = await loadConfig(configPath ?? "./agents.conf.yaml");
|
|
286
|
+
const manifestPath = join2(config.generatedDir, ".manifest.json");
|
|
287
|
+
try {
|
|
288
|
+
const raw = await readFile2(manifestPath, "utf8");
|
|
289
|
+
const manifest = JSON.parse(raw);
|
|
290
|
+
const dsl = await loadDsl(config.dslPath);
|
|
291
|
+
const dslCanonical = canonicalStringify(dsl);
|
|
292
|
+
const currentHash = computeHash(dslCanonical);
|
|
293
|
+
return manifest.dsl_hash === currentHash;
|
|
294
|
+
} catch {
|
|
295
|
+
return false;
|
|
296
|
+
}
|
|
297
|
+
}
|
|
298
|
+
export {
|
|
299
|
+
DEFAULT_CONFIG_PATH,
|
|
300
|
+
ProjectConfigSchema,
|
|
301
|
+
buildContractContext,
|
|
302
|
+
buildGuardrailContext,
|
|
303
|
+
checkFreshness,
|
|
304
|
+
generate,
|
|
305
|
+
loadConfig,
|
|
306
|
+
loadProjectConfig
|
|
307
|
+
};
|
|
308
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../../src/generator/index.ts","../../src/generator/config.ts"],"sourcesContent":["/**\n * Generator — orchestrates DSL-to-TypeScript code generation\n */\n\nimport { readFile, writeFile, mkdir, rm, stat } from \"node:fs/promises\";\nimport { resolve, join, relative } from \"node:path\";\nimport { createHash } from \"node:crypto\";\nimport YAML from \"yaml\";\nimport { loadConfig, type ResolvedConfig } from \"./config.js\";\nimport { renderTemplate } from \"./template-engine.js\";\nimport { buildContractContext, buildGuardrailContext } from \"./context.js\";\n\nexport interface GenerateOptions {\n clean?: boolean;\n check?: boolean;\n templates?: string;\n configPath?: string;\n}\n\nexport interface GenerateResult {\n files_generated: string[];\n dsl_hash: string;\n generation_input_hash: string;\n cleaned: boolean;\n check_mode: boolean;\n has_differences: boolean;\n}\n\nconst DO_NOT_EDIT_HEADER = `/**\n * AUTO-GENERATED by agent-contracts-runtime. DO NOT EDIT.\n *\n * Regenerate via: npx agent-runtime generate\n */\n\n`;\n\nasync function loadYaml(filePath: string): Promise<unknown> {\n const raw = await readFile(filePath, \"utf8\");\n return YAML.parse(raw);\n}\n\nfunction computeHash(data: string): string {\n return createHash(\"sha256\").update(data).digest(\"hex\");\n}\n\nfunction sortDeep(value: unknown): unknown {\n if (Array.isArray(value)) return value.map(sortDeep);\n if (value !== null && typeof value === \"object\") {\n return Object.fromEntries(\n Object.entries(value as Record<string, unknown>)\n .sort(([a], [b]) => a.localeCompare(b))\n .map(([k, v]) => [k, sortDeep(v)]),\n );\n }\n return value;\n}\n\nfunction canonicalStringify(obj: unknown): string {\n return JSON.stringify(sortDeep(obj));\n}\n\n/**\n * Load DSL via agent-contracts resolve() which handles extends, merge\n * operators ($replace/$append), and $ref resolution including\n * file.yaml#/json-pointer fragments.\n */\nasync function loadDsl(dslPath: string): Promise<Record<string, unknown>> {\n const { resolve: resolveDsl } = await import(\"agent-contracts\");\n const result = await resolveDsl(dslPath);\n return result.data;\n}\n\nconst CONTRACT_TEMPLATES = [\n { template: \"agents.ts.hbs\", output: \"agents.ts\" },\n { template: \"tasks.ts.hbs\", output: \"tasks.ts\" },\n { template: \"workflows.ts.hbs\", output: \"workflows.ts\" },\n { template: \"handoffs.ts.hbs\", output: \"handoffs.ts\" },\n { template: \"contracts-index.ts.hbs\", output: \"index.ts\" },\n];\n\nexport async function generate(options: GenerateOptions = {}): Promise<GenerateResult> {\n const configPath = options.configPath ?? \"./agents.conf.yaml\";\n const config = await loadConfig(configPath);\n\n const templatesDir = options.templates ?? config.templatesDir;\n const checkMode = options.check ?? false;\n const cleaned = options.clean ?? false;\n\n if (cleaned && !checkMode) {\n try {\n await rm(config.generatedDir, { recursive: true, force: true });\n } catch {\n // directory may not exist\n }\n }\n\n const dsl = await loadDsl(config.dslPath);\n const dslCanonical = canonicalStringify(dsl);\n const dslHash = computeHash(dslCanonical);\n\n const contractCtx = buildContractContext(dsl);\n\n const files_generated: string[] = [];\n const generatedContents: Map<string, string> = new Map();\n\n // Phase 1a: Contract files\n for (const { template, output } of CONTRACT_TEMPLATES) {\n const rendered = DO_NOT_EDIT_HEADER + await renderTemplate(template, contractCtx as unknown as Record<string, unknown>, templatesDir);\n const outPath = join(config.generatedDir, output);\n files_generated.push(relative(config.configDir, outPath));\n generatedContents.set(outPath, rendered);\n }\n\n // Resolve guardrail rules from bindings (before Phase 1b)\n let guardrailRules: Record<string, unknown> | undefined;\n if (config.bindingPaths.length > 0) {\n for (const bindingPath of config.bindingPaths) {\n const binding = await loadYaml(bindingPath);\n const guardrailCtx = buildGuardrailContext(dsl, binding, config.active_guardrail_policy);\n if (guardrailCtx.hasGuardrails) {\n guardrailRules = {\n commandRules: guardrailCtx.commandChecks.map((c) => ({\n guardrail_id: c.guardrail_id,\n pattern: c.pattern,\n action: c.action,\n message: c.message,\n })),\n fileRules: guardrailCtx.fileChecks.map((c) => ({\n guardrail_id: c.guardrail_id,\n pattern: c.pattern,\n action: c.action,\n message: c.message,\n ...(c.exclude_glob ? { exclude_glob: c.exclude_glob } : {}),\n })),\n contentRules: guardrailCtx.contentChecks.map((c) => ({\n guardrail_id: c.guardrail_id,\n pattern: c.pattern,\n action: c.action,\n message: c.message,\n ...(c.file_glob ? { file_glob: c.file_glob } : {}),\n ...(c.exclude_glob ? { exclude_glob: c.exclude_glob } : {}),\n })),\n };\n }\n }\n }\n\n // Phase 1b: Embedded DSL data + guardrail rules (for loadDslContext at runtime)\n {\n const dslWithRules = guardrailRules ? { ...dsl, _guardrailRules: guardrailRules } : dsl;\n const dslDataContent = DO_NOT_EDIT_HEADER +\n `export const resolvedDsl: Record<string, unknown> = ${JSON.stringify(dslWithRules, null, 2)} as const;\\n`;\n const outPath = join(config.generatedDir, \"dsl-data.ts\");\n files_generated.push(relative(config.configDir, outPath));\n generatedContents.set(outPath, dslDataContent);\n }\n\n // Compute generation input hash (DSL + binding + generator version)\n const generationInputParts = [dslCanonical];\n for (const bp of config.bindingPaths) {\n try {\n generationInputParts.push(await readFile(bp, \"utf8\"));\n } catch {\n // binding may not exist\n }\n }\n const generation_input_hash = computeHash(generationInputParts.join(\"\\n---\\n\"));\n\n // Check mode — compare without writing\n let has_differences = false;\n if (checkMode) {\n for (const [outPath, content] of generatedContents) {\n try {\n const existing = await readFile(outPath, \"utf8\");\n if (existing !== content) {\n has_differences = true;\n break;\n }\n } catch {\n has_differences = true;\n break;\n }\n }\n } else {\n // Write files\n for (const [outPath, content] of generatedContents) {\n const dir = resolve(outPath, \"..\");\n await mkdir(dir, { recursive: true });\n await writeFile(outPath, content, \"utf8\");\n }\n\n // Write manifest\n const manifest = {\n generated_at: new Date().toISOString(),\n dsl_hash: dslHash,\n generation_input_hash,\n files: files_generated,\n };\n const manifestPath = join(config.generatedDir, \".manifest.json\");\n await mkdir(resolve(manifestPath, \"..\"), { recursive: true });\n await writeFile(manifestPath, JSON.stringify(manifest, null, 2) + \"\\n\", \"utf8\");\n }\n\n return {\n files_generated,\n dsl_hash: dslHash,\n generation_input_hash,\n cleaned,\n check_mode: checkMode,\n has_differences,\n };\n}\n\nexport async function checkFreshness(configPath?: string): Promise<boolean> {\n const config = await loadConfig(configPath ?? \"./agents.conf.yaml\");\n const manifestPath = join(config.generatedDir, \".manifest.json\");\n\n try {\n const raw = await readFile(manifestPath, \"utf8\");\n const manifest = JSON.parse(raw) as { dsl_hash: string };\n\n const dsl = await loadDsl(config.dslPath);\n const dslCanonical = canonicalStringify(dsl);\n const currentHash = computeHash(dslCanonical);\n\n return manifest.dsl_hash === currentHash;\n } catch {\n return false;\n }\n}\n\nexport {\n loadConfig,\n loadProjectConfig,\n ProjectConfigSchema,\n DEFAULT_CONFIG_PATH,\n type ResolvedConfig,\n type ProjectConfig,\n} from \"./config.js\";\nexport { buildContractContext, buildGuardrailContext } from \"./context.js\";\n","/**\n * Generator configuration — loads and validates agents.conf.yaml / agent-runtime.config.yaml\n */\n\nimport { existsSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport { resolve, dirname, join, basename } from \"node:path\";\nimport { z } from \"zod\";\nimport YAML from \"yaml\";\n\nexport const DEFAULT_CONFIG_PATH = \"./agents.conf.yaml\";\nexport const LEGACY_CONFIG_FILENAME = \"agent-runtime.config.yaml\";\n\nconst RecoverySchema = z.object({\n max_follow_ups: z.number().int().min(0).default(2),\n max_retries: z.number().int().min(0).default(0),\n}).default(() => ({ max_follow_ups: 2, max_retries: 0 }));\n\nconst ModelClassEntrySchema = z.object({\n adapter: z.string(),\n model: z.string().optional(),\n});\n\nconst ModelMappingSchema = z.object({\n fast: ModelClassEntrySchema.optional(),\n standard: ModelClassEntrySchema.optional(),\n thinking: ModelClassEntrySchema.optional(),\n}).default({});\n\nconst ProgressLogSchema = z.object({\n destination: z.enum([\"stderr\", \"file\", \"both\", \"none\"]).default(\"stderr\"),\n file: z.string().optional(),\n naming: z.enum([\"single\", \"per-invocation\", \"daily\"]).default(\"single\"),\n}).default(() => ({ destination: \"stderr\" as const, naming: \"single\" as const }))\n .refine(\n (val) => {\n if ((val.destination === \"file\" || val.destination === \"both\") && !val.file) return false;\n return true;\n },\n { message: \"logging.progress_log.file is required when destination is 'file' or 'both'\" },\n );\n\nconst LoggingSchema = z.object({\n progress_log: ProgressLogSchema,\n}).default(() => ({ progress_log: { destination: \"stderr\" as const, naming: \"single\" as const } }));\n\nexport const RuntimeConfigSchema = z.object({\n dsl: z.string().default(\"./agent-contracts.yaml\"),\n generated_dir: z.string().default(\"./agent/generated\"),\n bindings: z.array(z.string()).default([]),\n active_guardrail_policy: z.string().optional(),\n templates_dir: z.string().optional(),\n plugins: z.array(z.string()).default([]),\n recovery: RecoverySchema,\n model_mapping: ModelMappingSchema,\n logging: LoggingSchema,\n});\n\nexport type RuntimeConfig = z.infer<typeof RuntimeConfigSchema>;\n\nconst CliSectionSchema = z.object({\n dsl: z.string().optional(),\n generated_dir: z.string().optional(),\n plugins: z.array(z.string()).optional(),\n bindings: z.array(z.string()).optional(),\n}).strict();\n\nexport const ProjectConfigSchema = z.object({\n dsl: z.string().optional(),\n generated_dir: z.string().optional(),\n bindings: z.array(z.string()).optional(),\n active_guardrail_policy: z.string().optional(),\n templates_dir: z.string().optional(),\n plugins: z.array(z.string()).optional(),\n recovery: RecoverySchema,\n model_mapping: ModelMappingSchema,\n logging: LoggingSchema,\n cli: z.record(z.string(), CliSectionSchema).optional(),\n});\n\nexport type ProjectConfig = z.infer<typeof ProjectConfigSchema>;\n\nexport interface ResolvedProgressLog {\n destination: \"stderr\" | \"file\" | \"both\" | \"none\";\n file: string | undefined;\n naming: \"single\" | \"per-invocation\" | \"daily\";\n}\n\nexport interface ResolvedConfig extends RuntimeConfig {\n configDir: string;\n dslPath: string;\n generatedDir: string;\n bindingPaths: string[];\n templatesDir: string | undefined;\n pluginPaths: string[];\n resolvedLogging: { progressLog: ResolvedProgressLog };\n}\n\nfunction resolveConfigFilePath(configPath: string): string {\n const absPath = resolve(configPath);\n if (existsSync(absPath)) {\n return absPath;\n }\n\n const dir = dirname(absPath);\n const base = basename(absPath);\n if (base === \"agents.conf.yaml\") {\n const legacyPath = join(dir, LEGACY_CONFIG_FILENAME);\n if (existsSync(legacyPath)) {\n return legacyPath;\n }\n }\n\n return absPath;\n}\n\nfunction buildResolvedConfig(config: RuntimeConfig, configDir: string): ResolvedConfig {\n const pl = config.logging.progress_log;\n\n return {\n ...config,\n configDir,\n dslPath: resolve(configDir, config.dsl),\n generatedDir: resolve(configDir, config.generated_dir),\n bindingPaths: config.bindings.map((b) => resolve(configDir, b)),\n templatesDir: config.templates_dir\n ? resolve(configDir, config.templates_dir)\n : undefined,\n pluginPaths: config.plugins,\n resolvedLogging: {\n progressLog: {\n destination: pl.destination,\n file: pl.file ? resolve(configDir, pl.file) : undefined,\n naming: pl.naming,\n },\n },\n };\n}\n\nexport async function loadConfig(configPath: string): Promise<ResolvedConfig> {\n const absPath = resolveConfigFilePath(configPath);\n const raw = await readFile(absPath, \"utf8\");\n const parsed = YAML.parse(raw);\n const config = RuntimeConfigSchema.parse(parsed);\n const configDir = dirname(absPath);\n\n return buildResolvedConfig(config, configDir);\n}\n\nexport async function loadProjectConfig(\n configPath: string,\n cliName?: string,\n): Promise<ResolvedConfig> {\n const absPath = resolveConfigFilePath(configPath);\n const raw = await readFile(absPath, \"utf8\");\n const parsed = YAML.parse(raw);\n const projectConfig = ProjectConfigSchema.parse(parsed);\n\n const { cli: _cli, ...baseConfig } = projectConfig;\n let merged = { ...baseConfig };\n\n if (cliName && projectConfig.cli?.[cliName]) {\n merged = { ...merged, ...projectConfig.cli[cliName] };\n }\n\n const config = RuntimeConfigSchema.parse(merged);\n const configDir = dirname(absPath);\n\n return buildResolvedConfig(config, configDir);\n}\n"],"mappings":"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","names":["readFile","resolve","join","YAML","readFile","YAML","join","resolve"]}
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SDK Guardrail Hook Bridge — generic adapter from guardrail check functions
|
|
3
|
+
* + plugin guardrails to SDK-compatible hook responses.
|
|
4
|
+
*
|
|
5
|
+
* Embedded guardrail rules are converted via createGuardrailHooksFromRules(),
|
|
6
|
+
* which delegates to createGuardrailHooks(). All hook logic lives here.
|
|
7
|
+
*/
|
|
8
|
+
interface GuardrailCheckResult {
|
|
9
|
+
guardrail_id: string;
|
|
10
|
+
passed: boolean;
|
|
11
|
+
action: "block" | "warn" | "shadow" | "info";
|
|
12
|
+
message: string;
|
|
13
|
+
}
|
|
14
|
+
interface HookResponse {
|
|
15
|
+
permission?: "deny";
|
|
16
|
+
user_message?: string;
|
|
17
|
+
agent_message?: string;
|
|
18
|
+
additionalContext?: string;
|
|
19
|
+
}
|
|
20
|
+
interface GuardrailRule {
|
|
21
|
+
guardrail_id: string;
|
|
22
|
+
pattern: string;
|
|
23
|
+
action: "block" | "warn" | "shadow" | "info";
|
|
24
|
+
message: string;
|
|
25
|
+
file_glob?: string;
|
|
26
|
+
exclude_glob?: string;
|
|
27
|
+
}
|
|
28
|
+
interface GuardrailRuleData {
|
|
29
|
+
commandRules: GuardrailRule[];
|
|
30
|
+
fileRules: GuardrailRule[];
|
|
31
|
+
contentRules: GuardrailRule[];
|
|
32
|
+
}
|
|
33
|
+
interface GuardrailCheckFunctions {
|
|
34
|
+
checkCommand: (command: string) => GuardrailCheckResult[];
|
|
35
|
+
checkFilePath: (filePath: string) => GuardrailCheckResult[];
|
|
36
|
+
checkContent: (filePath: string, content: string) => GuardrailCheckResult[];
|
|
37
|
+
}
|
|
38
|
+
interface HookContext {
|
|
39
|
+
/** Agent id for per-agent guardrail filtering. */
|
|
40
|
+
agentId?: string;
|
|
41
|
+
command?: string;
|
|
42
|
+
filePath?: string;
|
|
43
|
+
content?: string;
|
|
44
|
+
}
|
|
45
|
+
interface GuardrailHooks {
|
|
46
|
+
beforeShellExecution: (input: {
|
|
47
|
+
command?: string;
|
|
48
|
+
}) => HookResponse;
|
|
49
|
+
preToolUse: (input: {
|
|
50
|
+
tool_name?: string;
|
|
51
|
+
tool_input?: {
|
|
52
|
+
file_path?: string;
|
|
53
|
+
path?: string;
|
|
54
|
+
};
|
|
55
|
+
}) => HookResponse;
|
|
56
|
+
afterFileEdit: (input: {
|
|
57
|
+
file_path?: string;
|
|
58
|
+
content?: string;
|
|
59
|
+
}) => HookResponse;
|
|
60
|
+
runChecks: (ctx: HookContext) => GuardrailCheckResult[];
|
|
61
|
+
}
|
|
62
|
+
declare function getBlockingViolations(results: GuardrailCheckResult[]): GuardrailCheckResult[];
|
|
63
|
+
declare function getWarnings(results: GuardrailCheckResult[]): GuardrailCheckResult[];
|
|
64
|
+
declare function hasBlockingViolation(results: GuardrailCheckResult[]): boolean;
|
|
65
|
+
/**
|
|
66
|
+
* Create SDK hook functions from generated guardrail check functions.
|
|
67
|
+
*
|
|
68
|
+
* Merges DSL-generated checks with plugin-registered guardrails and
|
|
69
|
+
* returns hook functions in the format expected by the Claude SDK,
|
|
70
|
+
* plus a generic runChecks() for programmatic use.
|
|
71
|
+
*/
|
|
72
|
+
declare function createGuardrailHooks(checks: GuardrailCheckFunctions): GuardrailHooks;
|
|
73
|
+
/**
|
|
74
|
+
* Create SDK hook functions from embedded guardrail rule data.
|
|
75
|
+
*/
|
|
76
|
+
/**
|
|
77
|
+
* Create SDK hooks scoped to a single agent from a per-agent guardrail map.
|
|
78
|
+
* Returns empty-passing hooks when the agent has no rules in the map.
|
|
79
|
+
*/
|
|
80
|
+
declare function createGuardrailHooksForAgent(agentId: string, perAgent: Map<string, GuardrailRuleData>): GuardrailHooks;
|
|
81
|
+
declare function createGuardrailHooksFromRules(rules: GuardrailRuleData): GuardrailHooks;
|
|
82
|
+
|
|
83
|
+
export { type GuardrailHooks as G, type HookContext as H, type GuardrailRuleData as a, type GuardrailCheckFunctions as b, type GuardrailCheckResult as c, type GuardrailRule as d, type HookResponse as e, createGuardrailHooks as f, createGuardrailHooksForAgent as g, createGuardrailHooksFromRules as h, getBlockingViolations as i, getWarnings as j, hasBlockingViolation as k };
|