@aaac/runtime 0.1.8 → 0.1.10

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.
@@ -1,430 +1,16 @@
1
1
  import {
2
- buildContractContext,
2
+ ComponentOverrideSchema,
3
+ DEFAULT_CONFIG_PATH,
4
+ ProjectConfigSchema,
3
5
  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 ComponentOverrideSchema = z.object({
66
- dsl: z.string().optional(),
67
- component_contract: z.string().optional(),
68
- generated_dir: z.string().optional(),
69
- bindings: z.array(z.string()).optional(),
70
- plugins: z.array(z.string()).optional(),
71
- model_mapping: ModelMappingSchema.optional(),
72
- recovery: RecoverySchema.optional(),
73
- templates_dir: z.string().optional()
74
- }).strict();
75
- var BindingsConfigSchema = z.object({
76
- guardrail: z.array(z.string()).optional(),
77
- observability: z.object({
78
- event_mapping: z.string().optional(),
79
- recorder: z.string().optional()
80
- }).optional()
81
- }).optional();
82
- var EnvironmentsSchema = z.object({
83
- git: z.object({
84
- hooks: z.array(z.string()).optional()
85
- }).optional(),
86
- cursor: z.object({
87
- hooks_json: z.string().optional()
88
- }).optional(),
89
- ci: z.object({
90
- provider: z.string().optional()
91
- }).optional()
92
- }).optional();
93
- var ProjectConfigSchema = z.object({
94
- schema: z.string().optional(),
95
- dsl: z.string().optional(),
96
- generated_dir: z.string().optional(),
97
- bindings: z.array(z.string()).optional(),
98
- active_guardrail_policy: z.string().optional(),
99
- templates_dir: z.string().optional(),
100
- plugins: z.array(z.string()).optional(),
101
- recovery: RecoverySchema,
102
- model_mapping: ModelMappingSchema,
103
- logging: LoggingSchema,
104
- artifacts: z.string().optional(),
105
- toolchains: z.string().optional(),
106
- bindings_config: BindingsConfigSchema,
107
- components: z.record(z.string(), ComponentOverrideSchema).optional(),
108
- environments: EnvironmentsSchema,
109
- cli: z.record(z.string(), CliSectionSchema).optional()
110
- });
111
- function resolveConfigFilePath(configPath) {
112
- const absPath = resolve(configPath);
113
- if (existsSync(absPath)) {
114
- return absPath;
115
- }
116
- const dir = dirname(absPath);
117
- const base = basename(absPath);
118
- if (base === "agents.conf.yaml") {
119
- const legacyPath = join(dir, LEGACY_CONFIG_FILENAME);
120
- if (existsSync(legacyPath)) {
121
- return legacyPath;
122
- }
123
- }
124
- return absPath;
125
- }
126
- function mergeBindingsUnion(root, override) {
127
- const base = root ?? [];
128
- const extra = override ?? [];
129
- const seen = new Set(base);
130
- const result = [...base];
131
- for (const binding of extra) {
132
- if (!seen.has(binding)) {
133
- result.push(binding);
134
- seen.add(binding);
135
- }
136
- }
137
- return result;
138
- }
139
- function mergeConfigWithOverride(base, override) {
140
- const merged = { ...base };
141
- if (override.dsl !== void 0) merged.dsl = override.dsl;
142
- if (override.generated_dir !== void 0) merged.generated_dir = override.generated_dir;
143
- if (override.bindings !== void 0) {
144
- merged.bindings = mergeBindingsUnion(base.bindings, override.bindings);
145
- }
146
- if (override.plugins !== void 0) merged.plugins = override.plugins;
147
- if ("templates_dir" in override && override.templates_dir !== void 0) {
148
- merged.templates_dir = override.templates_dir;
149
- }
150
- if ("model_mapping" in override && override.model_mapping) {
151
- merged.model_mapping = {
152
- ...base.model_mapping,
153
- ...override.model_mapping.fast ? { fast: override.model_mapping.fast } : {},
154
- ...override.model_mapping.standard ? { standard: override.model_mapping.standard } : {},
155
- ...override.model_mapping.thinking ? { thinking: override.model_mapping.thinking } : {}
156
- };
157
- }
158
- if ("recovery" in override && override.recovery) {
159
- merged.recovery = {
160
- ...base.recovery,
161
- ...override.recovery
162
- };
163
- }
164
- return merged;
165
- }
166
- function resolveEnvironments(environments, configDir) {
167
- if (!environments) return void 0;
168
- const resolved = {};
169
- if (environments.git?.hooks) {
170
- resolved.git = { hooks: environments.git.hooks };
171
- }
172
- if (environments.cursor?.hooks_json) {
173
- resolved.cursor = {
174
- hooks_json: resolve(configDir, environments.cursor.hooks_json)
175
- };
176
- }
177
- if (environments.ci?.provider) {
178
- resolved.ci = { provider: environments.ci.provider };
179
- }
180
- return Object.keys(resolved).length > 0 ? resolved : void 0;
181
- }
182
- function buildResolvedConfig(config, configDir, governance) {
183
- const pl = config.logging.progress_log;
184
- return {
185
- ...config,
186
- configDir,
187
- dslPath: resolve(configDir, config.dsl),
188
- generatedDir: resolve(configDir, config.generated_dir),
189
- bindingPaths: config.bindings.map((b) => resolve(configDir, b)),
190
- templatesDir: config.templates_dir ? resolve(configDir, config.templates_dir) : void 0,
191
- pluginPaths: config.plugins,
192
- resolvedLogging: {
193
- progressLog: {
194
- destination: pl.destination,
195
- file: pl.file ? resolve(configDir, pl.file) : void 0,
196
- naming: pl.naming
197
- }
198
- },
199
- artifactsPath: governance?.artifacts ? resolve(configDir, governance.artifacts) : void 0,
200
- toolchainsPath: governance?.toolchains ? resolve(configDir, governance.toolchains) : void 0,
201
- environments: resolveEnvironments(governance?.environments, configDir),
202
- componentOverrides: governance?.componentOverrides
203
- };
204
- }
205
- function stripGovernanceFields(projectConfig) {
206
- const {
207
- cli: _cli,
208
- components: _components,
209
- schema: _schema,
210
- artifacts: _artifacts,
211
- toolchains: _toolchains,
212
- bindings_config: _bindingsConfig,
213
- environments: _environments,
214
- ...baseConfig
215
- } = projectConfig;
216
- return baseConfig;
217
- }
218
- function resolveOverride(projectConfig, target) {
219
- if (!target) return void 0;
220
- if (projectConfig.components?.[target]) {
221
- return projectConfig.components[target];
222
- }
223
- if (projectConfig.cli?.[target]) {
224
- return projectConfig.cli[target];
225
- }
226
- return void 0;
227
- }
228
- async function loadConfig(configPath) {
229
- const absPath = resolveConfigFilePath(configPath);
230
- const raw = await readFile(absPath, "utf8");
231
- const parsed = YAML.parse(raw);
232
- const config = RuntimeConfigSchema.parse(parsed);
233
- const configDir = dirname(absPath);
234
- return buildResolvedConfig(config, configDir);
235
- }
236
- async function loadProjectConfig(configPath, target) {
237
- const absPath = resolveConfigFilePath(configPath);
238
- const raw = await readFile(absPath, "utf8");
239
- const parsed = YAML.parse(raw);
240
- const projectConfig = ProjectConfigSchema.parse(parsed);
241
- let merged = stripGovernanceFields(projectConfig);
242
- const override = resolveOverride(projectConfig, target);
243
- if (override) {
244
- merged = mergeConfigWithOverride(merged, override);
245
- }
246
- const config = RuntimeConfigSchema.parse(merged);
247
- const configDir = dirname(absPath);
248
- return buildResolvedConfig(config, configDir, {
249
- artifacts: projectConfig.artifacts,
250
- toolchains: projectConfig.toolchains,
251
- environments: projectConfig.environments,
252
- componentOverrides: projectConfig.components
253
- });
254
- }
255
-
256
- // src/generator/index.ts
257
- var DO_NOT_EDIT_HEADER = `/**
258
- * AUTO-GENERATED by agent-contracts-runtime. DO NOT EDIT.
259
- *
260
- * Regenerate via: npx agent-runtime generate
261
- */
262
-
263
- `;
264
- async function loadYaml(filePath) {
265
- const raw = await readFile2(filePath, "utf8");
266
- return YAML2.parse(raw);
267
- }
268
- function computeHash(data) {
269
- return createHash("sha256").update(data).digest("hex");
270
- }
271
- function sortDeep(value) {
272
- if (Array.isArray(value)) return value.map(sortDeep);
273
- if (value !== null && typeof value === "object") {
274
- return Object.fromEntries(
275
- Object.entries(value).sort(([a], [b]) => a.localeCompare(b)).map(([k, v]) => [k, sortDeep(v)])
276
- );
277
- }
278
- return value;
279
- }
280
- function canonicalStringify(obj) {
281
- return JSON.stringify(sortDeep(obj));
282
- }
283
- async function loadDsl(dslPath) {
284
- const { resolve: resolveDsl } = await import("agent-contracts");
285
- const result = await resolveDsl(dslPath);
286
- return result.data;
287
- }
288
- var CONTRACT_TEMPLATES = [
289
- { template: "agents.ts.hbs", output: "agents.ts" },
290
- { template: "tasks.ts.hbs", output: "tasks.ts" },
291
- { template: "workflows.ts.hbs", output: "workflows.ts" },
292
- { template: "handoffs.ts.hbs", output: "handoffs.ts" },
293
- { template: "contracts-index.ts.hbs", output: "index.ts" }
294
- ];
295
- async function generate(options = {}) {
296
- const configPath = options.configPath ?? "./agents.conf.yaml";
297
- const config = await loadConfig(configPath);
298
- const templatesDir = options.templates ?? config.templatesDir;
299
- const checkMode = options.check ?? false;
300
- const cleaned = options.clean ?? false;
301
- if (cleaned && !checkMode) {
302
- try {
303
- await rm(config.generatedDir, { recursive: true, force: true });
304
- } catch {
305
- }
306
- }
307
- const dsl = await loadDsl(config.dslPath);
308
- const dslCanonical = canonicalStringify(dsl);
309
- const dslHash = computeHash(dslCanonical);
310
- const contractCtx = buildContractContext(dsl);
311
- const files_generated = [];
312
- const generatedContents = /* @__PURE__ */ new Map();
313
- for (const { template, output } of CONTRACT_TEMPLATES) {
314
- const rendered = DO_NOT_EDIT_HEADER + await renderTemplate(template, contractCtx, templatesDir);
315
- const outPath = join2(config.generatedDir, output);
316
- files_generated.push(relative(config.configDir, outPath));
317
- generatedContents.set(outPath, rendered);
318
- }
319
- let guardrailRules;
320
- if (config.bindingPaths.length > 0) {
321
- for (const bindingPath of config.bindingPaths) {
322
- const binding = await loadYaml(bindingPath);
323
- const guardrailCtx = buildGuardrailContext(dsl, binding, config.active_guardrail_policy);
324
- if (guardrailCtx.hasGuardrails) {
325
- guardrailRules = {
326
- commandRules: guardrailCtx.commandChecks.map((c) => ({
327
- guardrail_id: c.guardrail_id,
328
- pattern: c.pattern,
329
- action: c.action,
330
- message: c.message
331
- })),
332
- fileRules: guardrailCtx.fileChecks.map((c) => ({
333
- guardrail_id: c.guardrail_id,
334
- pattern: c.pattern,
335
- action: c.action,
336
- message: c.message,
337
- ...c.exclude_glob ? { exclude_glob: c.exclude_glob } : {}
338
- })),
339
- contentRules: guardrailCtx.contentChecks.map((c) => ({
340
- guardrail_id: c.guardrail_id,
341
- pattern: c.pattern,
342
- action: c.action,
343
- message: c.message,
344
- ...c.file_glob ? { file_glob: c.file_glob } : {},
345
- ...c.exclude_glob ? { exclude_glob: c.exclude_glob } : {}
346
- }))
347
- };
348
- }
349
- }
350
- }
351
- {
352
- const dslWithRules = guardrailRules ? { ...dsl, _guardrailRules: guardrailRules } : dsl;
353
- const dslDataContent = DO_NOT_EDIT_HEADER + `export const resolvedDsl: Record<string, unknown> = ${JSON.stringify(dslWithRules, null, 2)} as const;
354
- `;
355
- const outPath = join2(config.generatedDir, "dsl-data.ts");
356
- files_generated.push(relative(config.configDir, outPath));
357
- generatedContents.set(outPath, dslDataContent);
358
- }
359
- const generationInputParts = [dslCanonical];
360
- for (const bp of config.bindingPaths) {
361
- try {
362
- generationInputParts.push(await readFile2(bp, "utf8"));
363
- } catch {
364
- }
365
- }
366
- const generation_input_hash = computeHash(generationInputParts.join("\n---\n"));
367
- let has_differences = false;
368
- if (checkMode) {
369
- for (const [outPath, content] of generatedContents) {
370
- try {
371
- const existing = await readFile2(outPath, "utf8");
372
- if (existing !== content) {
373
- has_differences = true;
374
- break;
375
- }
376
- } catch {
377
- has_differences = true;
378
- break;
379
- }
380
- }
381
- } else {
382
- for (const [outPath, content] of generatedContents) {
383
- const dir = resolve2(outPath, "..");
384
- await mkdir(dir, { recursive: true });
385
- await writeFile(outPath, content, "utf8");
386
- }
387
- const manifest = {
388
- generated_at: (/* @__PURE__ */ new Date()).toISOString(),
389
- dsl_hash: dslHash,
390
- generation_input_hash,
391
- files: files_generated
392
- };
393
- const manifestPath = join2(config.generatedDir, ".manifest.json");
394
- await mkdir(resolve2(manifestPath, ".."), { recursive: true });
395
- await writeFile(manifestPath, JSON.stringify(manifest, null, 2) + "\n", "utf8");
396
- }
397
- return {
398
- files_generated,
399
- dsl_hash: dslHash,
400
- generation_input_hash,
401
- cleaned,
402
- check_mode: checkMode,
403
- has_differences
404
- };
405
- }
406
- async function checkFreshness(configPath) {
407
- const config = await loadConfig(configPath ?? "./agents.conf.yaml");
408
- const manifestPath = join2(config.generatedDir, ".manifest.json");
409
- try {
410
- const raw = await readFile2(manifestPath, "utf8");
411
- const manifest = JSON.parse(raw);
412
- const dsl = await loadDsl(config.dslPath);
413
- const dslCanonical = canonicalStringify(dsl);
414
- const currentHash = computeHash(dslCanonical);
415
- return manifest.dsl_hash === currentHash;
416
- } catch {
417
- return false;
418
- }
419
- }
6
+ loadConfig,
7
+ loadProjectConfig
8
+ } from "../chunk-5FL4NAC5.js";
420
9
  export {
421
10
  ComponentOverrideSchema,
422
11
  DEFAULT_CONFIG_PATH,
423
12
  ProjectConfigSchema,
424
- buildContractContext,
425
13
  buildGuardrailContext,
426
- checkFreshness,
427
- generate,
428
14
  loadConfig,
429
15
  loadProjectConfig
430
16
  };
@@ -1 +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 ComponentOverrideSchema,\n DEFAULT_CONFIG_PATH,\n type ResolvedConfig,\n type ProjectConfig,\n type ComponentOverride,\n type ResolvedEnvironments,\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 ComponentOverrideSchema = z.object({\n dsl: z.string().optional(),\n component_contract: z.string().optional(),\n generated_dir: z.string().optional(),\n bindings: z.array(z.string()).optional(),\n plugins: z.array(z.string()).optional(),\n model_mapping: ModelMappingSchema.optional(),\n recovery: RecoverySchema.optional(),\n templates_dir: z.string().optional(),\n}).strict();\n\nexport type ComponentOverride = z.infer<typeof ComponentOverrideSchema>;\n\nconst BindingsConfigSchema = z.object({\n guardrail: z.array(z.string()).optional(),\n observability: z.object({\n event_mapping: z.string().optional(),\n recorder: z.string().optional(),\n }).optional(),\n}).optional();\n\nconst EnvironmentsSchema = z.object({\n git: z.object({\n hooks: z.array(z.string()).optional(),\n }).optional(),\n cursor: z.object({\n hooks_json: z.string().optional(),\n }).optional(),\n ci: z.object({\n provider: z.string().optional(),\n }).optional(),\n}).optional();\n\nexport const ProjectConfigSchema = z.object({\n schema: z.string().optional(),\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 artifacts: z.string().optional(),\n toolchains: z.string().optional(),\n bindings_config: BindingsConfigSchema,\n components: z.record(z.string(), ComponentOverrideSchema).optional(),\n environments: EnvironmentsSchema,\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 ResolvedEnvironments {\n git?: { hooks: string[] };\n cursor?: { hooks_json: string };\n ci?: { provider: string };\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 artifactsPath?: string;\n toolchainsPath?: string;\n environments?: ResolvedEnvironments;\n componentOverrides?: Record<string, ComponentOverride>;\n}\n\ninterface GovernanceFields {\n artifacts?: string;\n toolchains?: string;\n environments?: z.infer<typeof EnvironmentsSchema>;\n componentOverrides?: Record<string, ComponentOverride>;\n}\n\ntype ConfigOverride = ComponentOverride | z.infer<typeof CliSectionSchema>;\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 mergeBindingsUnion(root: string[] | undefined, override: string[] | undefined): string[] {\n const base = root ?? [];\n const extra = override ?? [];\n const seen = new Set(base);\n const result = [...base];\n for (const binding of extra) {\n if (!seen.has(binding)) {\n result.push(binding);\n seen.add(binding);\n }\n }\n return result;\n}\n\nfunction mergeConfigWithOverride(\n base: Omit<ProjectConfig, \"cli\" | \"components\" | \"schema\" | \"artifacts\" | \"toolchains\" | \"bindings_config\" | \"environments\">,\n override: ConfigOverride,\n): Omit<ProjectConfig, \"cli\" | \"components\" | \"schema\" | \"artifacts\" | \"toolchains\" | \"bindings_config\" | \"environments\"> {\n const merged: typeof base = { ...base };\n\n if (override.dsl !== undefined) merged.dsl = override.dsl;\n if (override.generated_dir !== undefined) merged.generated_dir = override.generated_dir;\n if (override.bindings !== undefined) {\n merged.bindings = mergeBindingsUnion(base.bindings, override.bindings);\n }\n if (override.plugins !== undefined) merged.plugins = override.plugins;\n\n if (\"templates_dir\" in override && override.templates_dir !== undefined) {\n merged.templates_dir = override.templates_dir;\n }\n\n if (\"model_mapping\" in override && override.model_mapping) {\n merged.model_mapping = {\n ...base.model_mapping,\n ...(override.model_mapping.fast ? { fast: override.model_mapping.fast } : {}),\n ...(override.model_mapping.standard ? { standard: override.model_mapping.standard } : {}),\n ...(override.model_mapping.thinking ? { thinking: override.model_mapping.thinking } : {}),\n };\n }\n\n if (\"recovery\" in override && override.recovery) {\n merged.recovery = {\n ...base.recovery,\n ...override.recovery,\n };\n }\n\n return merged;\n}\n\nfunction resolveEnvironments(\n environments: z.infer<typeof EnvironmentsSchema>,\n configDir: string,\n): ResolvedEnvironments | undefined {\n if (!environments) return undefined;\n\n const resolved: ResolvedEnvironments = {};\n\n if (environments.git?.hooks) {\n resolved.git = { hooks: environments.git.hooks };\n }\n\n if (environments.cursor?.hooks_json) {\n resolved.cursor = {\n hooks_json: resolve(configDir, environments.cursor.hooks_json),\n };\n }\n\n if (environments.ci?.provider) {\n resolved.ci = { provider: environments.ci.provider };\n }\n\n return Object.keys(resolved).length > 0 ? resolved : undefined;\n}\n\nfunction buildResolvedConfig(\n config: RuntimeConfig,\n configDir: string,\n governance?: GovernanceFields,\n): 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 artifactsPath: governance?.artifacts\n ? resolve(configDir, governance.artifacts)\n : undefined,\n toolchainsPath: governance?.toolchains\n ? resolve(configDir, governance.toolchains)\n : undefined,\n environments: resolveEnvironments(governance?.environments, configDir),\n componentOverrides: governance?.componentOverrides,\n };\n}\n\nfunction stripGovernanceFields(projectConfig: ProjectConfig): Omit<\n ProjectConfig,\n \"cli\" | \"components\" | \"schema\" | \"artifacts\" | \"toolchains\" | \"bindings_config\" | \"environments\"\n> {\n const {\n cli: _cli,\n components: _components,\n schema: _schema,\n artifacts: _artifacts,\n toolchains: _toolchains,\n bindings_config: _bindingsConfig,\n environments: _environments,\n ...baseConfig\n } = projectConfig;\n return baseConfig;\n}\n\nfunction resolveOverride(\n projectConfig: ProjectConfig,\n target?: string,\n): ConfigOverride | undefined {\n if (!target) return undefined;\n\n if (projectConfig.components?.[target]) {\n return projectConfig.components[target];\n }\n\n if (projectConfig.cli?.[target]) {\n return projectConfig.cli[target];\n }\n\n return undefined;\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 target?: 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 let merged = stripGovernanceFields(projectConfig);\n const override = resolveOverride(projectConfig, target);\n\n if (override) {\n merged = mergeConfigWithOverride(merged, override);\n }\n\n const config = RuntimeConfigSchema.parse(merged);\n const configDir = dirname(absPath);\n\n return buildResolvedConfig(config, configDir, {\n artifacts: projectConfig.artifacts,\n toolchains: projectConfig.toolchains,\n environments: projectConfig.environments,\n componentOverrides: projectConfig.components,\n });\n}\n"],"mappings":"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","names":["readFile","resolve","join","YAML","readFile","YAML","join","resolve"]}
1
+ {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
package/dist/index.d.ts CHANGED
@@ -1,9 +1,67 @@
1
- import { T as TaskContext, b as TaskOutcome, c as AgentContractLike, d as TaskContractLike, P as PromptBuilderOptions, W as WorkflowResult, S as SdkAdapter, e as WorkflowRegistries, H as HandoffInput, f as StepCompleteEvent, g as StepResult, D as DelegateStep, h as GuardrailRuleData, i as MemoryStore, M as MemoryRef, L as LibraryToolRegistry, G as GuardrailHooks, R as ResolvedComponent, j as ArtifactBindingConfig, k as TaskRunResult, O as ObserverEmitFn, l as ResolvedToolchain, m as LibraryToolDefinition } from './task-runner-Dw8oWJD6.js';
2
- export { n as AdapterOrFactory, A as AdapterSendOptions, a as AgentExecutionRequest, o as AgentProgressEvent, B as BoundResolveOptions, p as BoundResolver, C as CacheConfig, q as CandidateAgent, E as EnvelopeParams, r as GateStep, s as GuardrailCheckFunctions, t as GuardrailCheckResult, u as GuardrailRule, v as HookContext, w as HookResponse, I as InMemoryStore, x as ModelAwareSdkAdapterFactory, y as ModelClass, z as ModelMappingConfig, F as ModelResolver, J as ModelResolverOptions, K as ReceiveSpec, N as ResolvedModel, Q as RetryDecision, U as SdkAdapterFactory, V as SplitPrompt, X as TaskRunOptions, Y as WorkflowContractLike, Z as WorkflowInvocation, _ as WorkflowRunOptions, $ as WorkflowStep, a0 as buildCandidateAgents, a1 as buildGateEvaluationPrompt, a2 as buildPerAgentGuardrails, a3 as buildRetryFollowUp, a4 as buildSplitTaskPrompt, a5 as buildTaskPrompt, a6 as createExecutionEnvelope, a7 as createGuardrailHooks, a8 as createGuardrailHooksForAgent, a9 as createGuardrailHooksFromRules, aa as createLibraryToolRegistry, ab as createModelResolver, ac as deriveToolchainsForAgents, ad as emitSessionClose, ae as emitSessionOpen, af as emitSubagentClose, ag as emitSubagentOpen, ah as emitToolchainClose, ai as emitToolchainOpen, aj as extractStructuredResult, ak as getBlockingViolations, al as getEffectiveGuardrailIds, am as getGuardrailRulesForAgent, an as getWarnings, ao as guardrailContextToRuleData, ap as hasBlockingViolation, aq as parseGateEvaluationResponse, ar as renderAgentSystemPrompt, as as runTask, at as runWorkflow, au as zodSchemaToPromptDescription, av as zodSchemaToYamlExample } from './task-runner-Dw8oWJD6.js';
1
+ import { O as ObserverEmitFn, T as TaskContext, b as TaskOutcome, c as AgentContractLike, d as TaskContractLike, P as PromptBuilderOptions, W as WorkflowResult, S as SdkAdapter, e as WorkflowRegistries, H as HandoffInput, f as StepCompleteEvent, g as StepResult, D as DelegateStep, h as GuardrailRuleData, i as MemoryStore, M as MemoryRef, L as LibraryToolRegistry, G as GuardrailHooks, R as ResolvedComponent, j as ArtifactBindingConfig, k as TaskRunResult, l as ResolvedToolchain, m as LibraryToolDefinition } from './task-runner-CZScv9Yb.js';
2
+ export { n as AdapterOrFactory, A as AdapterSendOptions, a as AgentExecutionRequest, o as AgentProgressEvent, B as BoundResolveOptions, p as BoundResolver, C as CacheConfig, q as CandidateAgent, E as EnvelopeParams, r as GateStep, s as GuardrailCheckFunctions, t as GuardrailCheckResult, u as GuardrailRule, v as HookContext, w as HookResponse, I as InMemoryStore, x as ModelAwareSdkAdapterFactory, y as ModelClass, z as ModelMappingConfig, F as ModelResolver, J as ModelResolverOptions, K as ReceiveSpec, N as ResolvedModel, Q as RetryDecision, U as SdkAdapterFactory, V as SplitPrompt, X as TaskRunOptions, Y as WorkflowContractLike, Z as WorkflowInvocation, _ as WorkflowRunOptions, $ as WorkflowStep, a0 as buildCandidateAgents, a1 as buildGateEvaluationPrompt, a2 as buildPerAgentGuardrails, a3 as buildRetryFollowUp, a4 as buildSplitTaskPrompt, a5 as buildTaskPrompt, a6 as createExecutionEnvelope, a7 as createGuardrailHooks, a8 as createGuardrailHooksForAgent, a9 as createGuardrailHooksFromRules, aa as createLibraryToolRegistry, ab as createModelResolver, ac as deriveToolchainsForAgents, ad as emitSessionClose, ae as emitSessionOpen, af as emitSubagentClose, ag as emitSubagentOpen, ah as emitToolchainClose, ai as emitToolchainOpen, aj as extractStructuredResult, ak as getBlockingViolations, al as getEffectiveGuardrailIds, am as getGuardrailRulesForAgent, an as getWarnings, ao as guardrailContextToRuleData, ap as hasBlockingViolation, aq as parseGateEvaluationResponse, ar as renderAgentSystemPrompt, as as runTask, at as runWorkflow, au as zodSchemaToPromptDescription, av as zodSchemaToYamlExample } from './task-runner-CZScv9Yb.js';
3
3
  import { z } from 'zod';
4
4
  import { OperationIR, ComponentIR } from '@aaac/contracts';
5
+ import { ResolvedConfig } from './generator/index.js';
5
6
  export { ExecutionEnvelope } from '@aaac/observability';
6
- import './context-B_bekYiE.js';
7
+ import './context-DKkamYX_.js';
8
+
9
+ /**
10
+ * Process axis emit helpers for runtime integration.
11
+ * These wrap @aaac/observability's EventCollector for structured process axis events.
12
+ */
13
+
14
+ interface ProcessWorkflowOptions {
15
+ workflowId: string;
16
+ sessionId: string;
17
+ parentSpanId?: string;
18
+ /** Optional observer — no-op when undefined. */
19
+ observer?: ObserverEmitFn;
20
+ }
21
+ interface ProcessTaskOptions {
22
+ taskId: string;
23
+ targetAgent: string;
24
+ sessionId: string;
25
+ parentSpanId?: string;
26
+ /** Optional observer — no-op when undefined. */
27
+ observer?: ObserverEmitFn;
28
+ }
29
+ interface ProcessEditOptions {
30
+ filePath: string;
31
+ artifactId?: string;
32
+ sessionId: string;
33
+ parentSpanId?: string;
34
+ /** Optional observer — no-op when undefined. */
35
+ observer?: ObserverEmitFn;
36
+ }
37
+ /**
38
+ * Emit process.workflow open span.
39
+ */
40
+ declare function emitProcessWorkflowOpen(options: ProcessWorkflowOptions): string | undefined;
41
+ /**
42
+ * Emit process.workflow close span.
43
+ */
44
+ declare function emitProcessWorkflowClose(spanId: string, options: {
45
+ status: string;
46
+ durationMs?: number;
47
+ observer?: ObserverEmitFn;
48
+ }): void;
49
+ /**
50
+ * Emit process.task open span.
51
+ */
52
+ declare function emitProcessTaskOpen(options: ProcessTaskOptions): string | undefined;
53
+ /**
54
+ * Emit process.task close span.
55
+ */
56
+ declare function emitProcessTaskClose(spanId: string, options: {
57
+ status: string;
58
+ durationMs?: number;
59
+ observer?: ObserverEmitFn;
60
+ }): void;
61
+ /**
62
+ * Emit process.edit instant span.
63
+ */
64
+ declare function emitProcessEdit(options: ProcessEditOptions): string | undefined;
7
65
 
8
66
  /**
9
67
  * Plugin Interface — extension points for user code injection
@@ -474,6 +532,71 @@ interface RuntimeBinding {
474
532
  }
475
533
  declare function createRuntimeBinding(component: ComponentIR, handlers?: Record<string, OperationHandler>): RuntimeBinding;
476
534
 
535
+ /**
536
+ * Standard project runtime — the reusable, CLI-facing `AaacRuntime` that every
537
+ * generated component CLI uses, so that NO caller hand-writes `ctx.runtime`.
538
+ * Named "project" because it is driven by the external `project.yaml` manifest.
539
+ *
540
+ * It:
541
+ * - discovers/loads the external `project.yaml` (walk up from cwd, or explicit
542
+ * config path) via loadProjectConfig,
543
+ * - resolves the effective DSL = project `agents` overlay merged over the
544
+ * bundled `/$embedded/` component DSL (reusing executeWorkflow/executeTask's
545
+ * loadDslContext merge — the overlay may `extends: /$embedded/` or be
546
+ * self-contained),
547
+ * - selects adapter/model from the project model_mapping (env/flag overrides)
548
+ * via createModelResolver,
549
+ * - implements runWorkflow → executeWorkflow and runTask → executeTask,
550
+ * passing bindingPaths / activeGuardrailPolicy / artifactBinding so machine
551
+ * guardrails operate on the merged DSL.
552
+ */
553
+
554
+ declare const PROJECT_CONFIG_FILENAME = "project.yaml";
555
+ /**
556
+ * Walk up from `startDir` to the filesystem root looking for the nearest
557
+ * `project.yaml`. Returns the absolute path, or undefined if none is found.
558
+ */
559
+ declare function findProjectConfig(startDir: string, filename?: string): string | undefined;
560
+ interface CreateProjectRuntimeOptions {
561
+ /** The bundled `/$embedded/` component DSL (the component's own agent-contracts). */
562
+ embeddedDsl: Record<string, unknown>;
563
+ /** Explicit project.yaml path; when omitted, discovered by walking up from cwd. */
564
+ configPath?: string;
565
+ /** Launch directory for config discovery (defaults to process.cwd()). */
566
+ cwd?: string;
567
+ /** Adapter override (CLI `--adapter`); falls back to env + model_mapping. */
568
+ adapter?: string;
569
+ /** Model override (CLI `--model`). */
570
+ model?: string;
571
+ /** Environment for adapter/model resolution (defaults to process.env). */
572
+ env?: Record<string, string | undefined>;
573
+ /** Auto-approve workflow gates (CLI is non-interactive by default). */
574
+ autoApproveGates?: boolean;
575
+ }
576
+ interface ResolvedAdapterSelection {
577
+ adapter: string;
578
+ model?: string;
579
+ }
580
+ interface ProjectRuntime {
581
+ /** The standard AaacRuntime — assign to `ctx.runtime` (or use `.context`). */
582
+ runtime: AaacRuntime;
583
+ /** A ready-made invocation context with `runtime` wired in. */
584
+ context: AaacInvocationContext;
585
+ /** The loaded, resolved project config. */
586
+ config: ResolvedConfig;
587
+ /** Absolute path to the discovered/explicit project.yaml. */
588
+ configPath: string;
589
+ /** Absolute path to the project's `agents` overlay DSL (cfg.dslPath). */
590
+ dslSource: string;
591
+ /** Resolve the effective adapter + model (for --dry-run reporting). */
592
+ resolveAdapter(): ResolvedAdapterSelection;
593
+ }
594
+ /**
595
+ * Build the standard component runtime from the bundled embedded DSL + the
596
+ * discovered/explicit project.yaml. Throws a clear error when no config exists.
597
+ */
598
+ declare function createProjectRuntime(options: CreateProjectRuntimeOptions): Promise<ProjectRuntime>;
599
+
477
600
  interface ComponentScope {
478
601
  componentId: string;
479
602
  componentIR: ComponentIR;
@@ -536,4 +659,4 @@ declare function resolveArtifacts(options: ArtifactResolveOptions): Promise<Arti
536
659
  /** Package version string. */
537
660
  declare const version: string;
538
661
 
539
- export { type AaacInvocationContext, type AaacObserver, type AaacPolicy, type AaacRuntime, AgentContractLike, AgentLogWriter, type AgentLogWriterOptions, type AgentPlugin, ArtifactBindingConfig, type ArtifactResolveOptions, type ArtifactResolveResult, type ComponentScope, type CreateAdapterOptions, type CreateComponentScopeOptions, DelegateStep, type DslContext, DslValidationError, type ExecuteOptions, type ExecuteTaskOptions, type ExecuteWorkflowOptions, FileMemoryStore, GuardrailHooks, type GuardrailResult, GuardrailRuleData, HandoffInput, LibraryToolDefinition, LibraryToolRegistry, type LoadDslOptions, MemoryRef, MemoryStore, type MemoryStoreEntry, type NavigationContext, type NavigationContextOptions, ObserverEmitFn, type OperationHandler, type OperationMemoryRefConfig, type PermissionMode, type PluginLoadResult, PluginRegistry, type ProgressSink, type ProgressSinkOptions, type PromptBuilderArgs, PromptBuilderOptions, type RequiredEntities, ResolvedComponent, ResolvedToolchain, type RunLogEvent, type Runtime, type RuntimeBinding, type RuntimeConfig, SdkAdapter, type SdkFunctionTool, StepCompleteEvent, StepResult, TaskContext, TaskContractLike, type TaskHookContext, TaskOutcome, TaskRunResult, WorkflowBuilder, type WorkflowHookContext, WorkflowRegistries, WorkflowResult, buildGuardrailRulesFromDsl, buildNavigationContext, buildRegistriesFromDsl, buildSdkFunctionTools, createAdapter, createComponentScope, createProgressSink, createRuntime, createRuntimeBinding, executeTask, executeWorkflow, jsonSchemaToZod, loadDslContext, loadPlugins, loadPluginsFromDirectory, loadPluginsFromPaths, pluginRegistry, resolveArtifacts, version };
662
+ export { type AaacInvocationContext, type AaacObserver, type AaacPolicy, type AaacRuntime, AgentContractLike, AgentLogWriter, type AgentLogWriterOptions, type AgentPlugin, ArtifactBindingConfig, type ArtifactResolveOptions, type ArtifactResolveResult, type ComponentScope, type CreateAdapterOptions, type CreateComponentScopeOptions, type CreateProjectRuntimeOptions, DelegateStep, type DslContext, DslValidationError, type ExecuteOptions, type ExecuteTaskOptions, type ExecuteWorkflowOptions, FileMemoryStore, GuardrailHooks, type GuardrailResult, GuardrailRuleData, HandoffInput, LibraryToolDefinition, LibraryToolRegistry, type LoadDslOptions, MemoryRef, MemoryStore, type MemoryStoreEntry, type NavigationContext, type NavigationContextOptions, ObserverEmitFn, type OperationHandler, type OperationMemoryRefConfig, PROJECT_CONFIG_FILENAME, type PermissionMode, type PluginLoadResult, PluginRegistry, type ProcessEditOptions, type ProcessTaskOptions, type ProcessWorkflowOptions, type ProgressSink, type ProgressSinkOptions, type ProjectRuntime, type PromptBuilderArgs, PromptBuilderOptions, type RequiredEntities, type ResolvedAdapterSelection, ResolvedComponent, ResolvedToolchain, type RunLogEvent, type Runtime, type RuntimeBinding, type RuntimeConfig, SdkAdapter, type SdkFunctionTool, StepCompleteEvent, StepResult, TaskContext, TaskContractLike, type TaskHookContext, TaskOutcome, TaskRunResult, WorkflowBuilder, type WorkflowHookContext, WorkflowRegistries, WorkflowResult, buildGuardrailRulesFromDsl, buildNavigationContext, buildRegistriesFromDsl, buildSdkFunctionTools, createAdapter, createComponentScope, createProgressSink, createProjectRuntime, createRuntime, createRuntimeBinding, emitProcessEdit, emitProcessTaskClose, emitProcessTaskOpen, emitProcessWorkflowClose, emitProcessWorkflowOpen, executeTask, executeWorkflow, findProjectConfig, jsonSchemaToZod, loadDslContext, loadPlugins, loadPluginsFromDirectory, loadPluginsFromPaths, pluginRegistry, resolveArtifacts, version };