@agentyx/core 0.7.0 → 0.9.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/index.d.mts CHANGED
@@ -7,7 +7,7 @@ import { ZodError, z } from "zod";
7
7
  * unexpected runtime errors, and branch on the stable `code` when they need to
8
8
  * handle a specific failure.
9
9
  */
10
- declare class AgentyxError extends Error {
10
+ export declare class AgentyxError extends Error {
11
11
  readonly code: string;
12
12
  constructor(code: string, message: string, options?: ErrorOptions);
13
13
  }
@@ -24,36 +24,41 @@ interface AgentyxIssue {
24
24
  /** A single configuration problem, addressed by its location in the document. */
25
25
  type AgentyxConfigIssue = AgentyxIssue;
26
26
  /** Raised when the supplied directory has no `.agentyx.json`. */
27
- declare class AgentyxConfigNotFoundError extends AgentyxError {
27
+ export declare class AgentyxConfigNotFoundError extends AgentyxError {
28
28
  readonly filePath: string;
29
29
  constructor(filePath: string, options?: ErrorOptions);
30
30
  }
31
31
  /** Raised when `.agentyx.json` is not valid JSON. */
32
- declare class AgentyxConfigParseError extends AgentyxError {
32
+ export declare class AgentyxConfigParseError extends AgentyxError {
33
33
  readonly filePath: string;
34
34
  constructor(filePath: string, reason: string, options?: ErrorOptions);
35
35
  }
36
36
  /** Raised when the document parses as JSON but violates the Agentyx schema. */
37
- declare class AgentyxConfigValidationError extends AgentyxError {
37
+ export declare class AgentyxConfigValidationError extends AgentyxError {
38
38
  readonly issues: readonly AgentyxConfigIssue[];
39
39
  /** The file the configuration came from, when it was read from disk. */
40
40
  readonly filePath: string | undefined;
41
41
  constructor(error: ZodError, filePath?: string);
42
42
  }
43
- declare class UnknownEnabledCapabilityError extends AgentyxError {
43
+ export declare class UnknownEnabledCapabilityError extends AgentyxError {
44
44
  readonly capabilityName: string;
45
45
  readonly knownCapabilities: readonly string[];
46
46
  constructor(capabilityName: string, knownCapabilities: readonly string[]);
47
47
  }
48
48
  /** Raised when a configured local Skill directory cannot be loaded safely. */
49
- declare class LocalSkillDirectoryError extends AgentyxError {
49
+ export declare class LocalSkillDirectoryError extends AgentyxError {
50
50
  readonly directory: string;
51
51
  constructor(directory: string, reason: string, options?: ErrorOptions);
52
52
  }
53
+ /** Raised when a configured project-context path is missing or escapes the project. */
54
+ export declare class ProjectContextPathError extends AgentyxError {
55
+ readonly path: string;
56
+ constructor(path: string, reason: string, options?: ErrorOptions);
57
+ }
53
58
  //#endregion
54
59
  //#region src/config/json-schema.d.ts
55
60
  /** Canonical identifier of the published `.agentyx.json` schema. */
56
- declare const AGENTYX_CONFIG_SCHEMA_ID = "https://raw.githubusercontent.com/Andersseen/agentyx/main/packages/core/schema/agentyx.schema.json";
61
+ export declare const AGENTYX_CONFIG_SCHEMA_ID = "https://raw.githubusercontent.com/Andersseen/agentyx/main/packages/core/schema/agentyx.schema.json";
57
62
  /**
58
63
  * Derives the JSON Schema for `.agentyx.json` from the Zod model, which stays the
59
64
  * single source of truth. The committed `schema/agentyx.schema.json` is generated
@@ -62,23 +67,65 @@ declare const AGENTYX_CONFIG_SCHEMA_ID = "https://raw.githubusercontent.com/Ande
62
67
  * The `input` view is used so that fields with defaults stay optional, which is
63
68
  * what an author writing the file cares about.
64
69
  */
65
- declare function buildAgentyxConfigJsonSchema(): Record<string, unknown>;
70
+ export declare function buildAgentyxConfigJsonSchema(): Record<string, unknown>;
66
71
  //#endregion
67
72
  //#region src/config/schema.d.ts
68
73
  /**
69
74
  * Targets stay free-form strings on purpose: third-party adapters should be
70
75
  * able to register providers without a change to this schema.
71
76
  */
72
- declare const agentyxTargetSchema: z.ZodString;
73
- declare const enabledCapabilityNameSchema: z.ZodString;
77
+ export declare const agentyxTargetSchema: z.ZodString;
78
+ export declare const enabledCapabilityNameSchema: z.ZodString;
74
79
  /**
75
80
  * Portable project-relative path to a directory whose direct children are Agent Skills.
76
81
  * Backslashes, absolute paths and parent traversal are rejected so the same config is safe on
77
82
  * every supported platform.
78
83
  */
79
- declare const skillDirectorySchema: z.ZodString;
84
+ export declare const skillDirectorySchema: z.ZodString;
85
+ export declare const projectMetadataSchema: z.ZodObject<{
86
+ id: z.ZodString;
87
+ name: z.ZodString;
88
+ description: z.ZodOptional<z.ZodString>;
89
+ repository: z.ZodOptional<z.ZodString>;
90
+ docs: z.ZodDefault<z.ZodArray<z.ZodString>>;
91
+ mcp: z.ZodDefault<z.ZodArray<z.ZodString>>;
92
+ owns: z.ZodDefault<z.ZodArray<z.ZodString>>;
93
+ }, z.core.$strict>;
94
+ export declare const projectRelationTypeSchema: z.ZodEnum<{
95
+ uses: "uses";
96
+ integrates: "integrates";
97
+ consumes: "consumes";
98
+ extends: "extends";
99
+ }>;
100
+ export declare const projectRelationSchema: z.ZodObject<{
101
+ id: z.ZodString;
102
+ name: z.ZodString;
103
+ type: z.ZodEnum<{
104
+ uses: "uses";
105
+ integrates: "integrates";
106
+ consumes: "consumes";
107
+ extends: "extends";
108
+ }>;
109
+ role: z.ZodString;
110
+ repository: z.ZodOptional<z.ZodString>;
111
+ docs: z.ZodDefault<z.ZodArray<z.ZodString>>;
112
+ mcp: z.ZodDefault<z.ZodArray<z.ZodString>>;
113
+ owns: z.ZodDefault<z.ZodArray<z.ZodString>>;
114
+ guidance: z.ZodDefault<z.ZodArray<z.ZodString>>;
115
+ }, z.core.$strict>;
116
+ export declare const projectContextSchema: z.ZodObject<{
117
+ commands: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
118
+ command: z.ZodString;
119
+ cwd: z.ZodDefault<z.ZodString>;
120
+ }, z.core.$strict>>>;
121
+ areas: z.ZodDefault<z.ZodArray<z.ZodObject<{
122
+ path: z.ZodString;
123
+ purpose: z.ZodString;
124
+ }, z.core.$strict>>>;
125
+ constraints: z.ZodDefault<z.ZodArray<z.ZodString>>;
126
+ }, z.core.$strict>;
80
127
  /** The `.agentyx.json` project configuration. */
81
- declare const agentyxConfigSchema: z.ZodObject<{
128
+ export declare const agentyxConfigSchema: z.ZodObject<{
82
129
  $schema: z.ZodOptional<z.ZodString>;
83
130
  packs: z.ZodDefault<z.ZodArray<z.ZodString>>;
84
131
  enable: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -158,22 +205,61 @@ declare const agentyxConfigSchema: z.ZodObject<{
158
205
  path: z.ZodString;
159
206
  ref: z.ZodString;
160
207
  }, z.core.$strict>>>;
208
+ project: z.ZodOptional<z.ZodObject<{
209
+ id: z.ZodString;
210
+ name: z.ZodString;
211
+ description: z.ZodOptional<z.ZodString>;
212
+ repository: z.ZodOptional<z.ZodString>;
213
+ docs: z.ZodDefault<z.ZodArray<z.ZodString>>;
214
+ mcp: z.ZodDefault<z.ZodArray<z.ZodString>>;
215
+ owns: z.ZodDefault<z.ZodArray<z.ZodString>>;
216
+ }, z.core.$strict>>;
217
+ relations: z.ZodOptional<z.ZodArray<z.ZodObject<{
218
+ id: z.ZodString;
219
+ name: z.ZodString;
220
+ type: z.ZodEnum<{
221
+ uses: "uses";
222
+ integrates: "integrates";
223
+ consumes: "consumes";
224
+ extends: "extends";
225
+ }>;
226
+ role: z.ZodString;
227
+ repository: z.ZodOptional<z.ZodString>;
228
+ docs: z.ZodDefault<z.ZodArray<z.ZodString>>;
229
+ mcp: z.ZodDefault<z.ZodArray<z.ZodString>>;
230
+ owns: z.ZodDefault<z.ZodArray<z.ZodString>>;
231
+ guidance: z.ZodDefault<z.ZodArray<z.ZodString>>;
232
+ }, z.core.$strict>>>;
233
+ context: z.ZodOptional<z.ZodObject<{
234
+ commands: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
235
+ command: z.ZodString;
236
+ cwd: z.ZodDefault<z.ZodString>;
237
+ }, z.core.$strict>>>;
238
+ areas: z.ZodDefault<z.ZodArray<z.ZodObject<{
239
+ path: z.ZodString;
240
+ purpose: z.ZodString;
241
+ }, z.core.$strict>>>;
242
+ constraints: z.ZodDefault<z.ZodArray<z.ZodString>>;
243
+ }, z.core.$strict>>;
161
244
  }, z.core.$strict>;
162
245
  /** A validated configuration, with defaults applied. */
163
246
  type AgentyxConfig = z.infer<typeof agentyxConfigSchema>;
164
247
  /** The shape accepted in a `.agentyx.json` file. */
165
248
  type AgentyxConfigInput = z.input<typeof agentyxConfigSchema>;
249
+ type ProjectMetadata = z.infer<typeof projectMetadataSchema>;
250
+ type ProjectRelation = z.infer<typeof projectRelationSchema>;
251
+ type ProjectContext = z.infer<typeof projectContextSchema>;
166
252
  //#endregion
167
253
  //#region src/config/loader.d.ts
168
- declare const AGENTYX_CONFIG_FILENAME = ".agentyx.json";
254
+ export declare const AGENTYX_CONFIG_FILENAME = ".agentyx.json";
169
255
  /** The absolute path `.agentyx.json` is read from for a given project. */
170
- declare function agentyxConfigPath(projectPath?: string): string;
256
+ export declare function agentyxConfigPath(projectPath?: string): string;
171
257
  /**
172
258
  * Validates an already-parsed configuration document.
173
259
  *
174
260
  * @throws {AgentyxConfigValidationError} when the document violates the schema.
175
261
  */
176
- declare function parseAgentyxConfig(value: unknown, filePath?: string): AgentyxConfig;
262
+ export declare function parseAgentyxConfig(value: unknown, filePath?: string): AgentyxConfig;
177
263
  /**
178
264
  * Reads and validates `.agentyx.json` from `projectPath`.
179
265
  *
@@ -184,11 +270,48 @@ declare function parseAgentyxConfig(value: unknown, filePath?: string): AgentyxC
184
270
  * @throws {AgentyxConfigParseError} when the file is not valid JSON.
185
271
  * @throws {AgentyxConfigValidationError} when the document violates the schema.
186
272
  */
187
- declare function loadAgentyxConfig(projectPath?: string): Promise<AgentyxConfig>;
273
+ export declare function loadAgentyxConfig(projectPath?: string): Promise<AgentyxConfig>;
274
+ //#endregion
275
+ //#region src/project-graph.d.ts
276
+ export declare class ProjectGraphNotConfiguredError extends AgentyxError {
277
+ constructor();
278
+ }
279
+ interface ProjectGraph {
280
+ readonly project: ProjectMetadata;
281
+ readonly relations: readonly ProjectRelation[];
282
+ }
283
+ export declare function createProjectGraph(project: ProjectMetadata, relations: readonly ProjectRelation[]): ProjectGraph;
284
+ export declare function renderProjectGraphText(graph: ProjectGraph): string;
285
+ export declare function renderProjectGraphJson(graph: ProjectGraph): string;
286
+ export declare function renderProjectGraphMermaid(graph: ProjectGraph): string;
287
+ export declare function renderProjectGraphSvg(graph: ProjectGraph): string;
288
+ export declare function findProjectCapabilityOwners(graph: ProjectGraph, capability: string): {
289
+ capability: string;
290
+ currentProject: {
291
+ id: string;
292
+ name: string;
293
+ docs: string[];
294
+ mcp: string[];
295
+ owns: string[];
296
+ description?: string | undefined;
297
+ repository?: string | undefined;
298
+ } | undefined;
299
+ relatedProjects: {
300
+ id: string;
301
+ name: string;
302
+ type: "uses" | "integrates" | "consumes" | "extends";
303
+ role: string;
304
+ docs: string[];
305
+ mcp: string[];
306
+ owns: string[];
307
+ guidance: string[];
308
+ repository?: string | undefined;
309
+ }[];
310
+ };
188
311
  //#endregion
189
312
  //#region src/pack/schema.d.ts
190
- declare const PACK_CATEGORIES: readonly ["engineering", "language", "framework", "efficiency", "workflow"];
191
- declare const packCategorySchema: z.ZodEnum<{
313
+ export declare const PACK_CATEGORIES: readonly ["engineering", "language", "framework", "efficiency", "workflow"];
314
+ export declare const packCategorySchema: z.ZodEnum<{
192
315
  engineering: "engineering";
193
316
  language: "language";
194
317
  framework: "framework";
@@ -199,9 +322,9 @@ declare const packCategorySchema: z.ZodEnum<{
199
322
  * Pack names are plain identifiers. They are intentionally not constrained to
200
323
  * a closed list so that external registries can contribute packs later.
201
324
  */
202
- declare const packNameSchema: z.ZodString;
325
+ export declare const packNameSchema: z.ZodString;
203
326
  /** A pack is a composable provider-neutral capability bundle. */
204
- declare const packDefinitionSchema: z.ZodObject<{
327
+ export declare const packDefinitionSchema: z.ZodObject<{
205
328
  name: z.ZodString;
206
329
  category: z.ZodDefault<z.ZodEnum<{
207
330
  engineering: "engineering";
@@ -284,21 +407,21 @@ type PackDefinitionInput = z.input<typeof packDefinitionSchema>;
284
407
  */
285
408
  type PackRegistry = ReadonlyMap<string, PackDefinition>;
286
409
  /** Validates definitions and indexes them by name. */
287
- declare function createPackRegistry(definitions: Iterable<PackDefinitionInput>): PackRegistry;
410
+ export declare function createPackRegistry(definitions: Iterable<PackDefinitionInput>): PackRegistry;
288
411
  /**
289
412
  * The packs Agentyx ships with, expressed as data. Relationships live here, not
290
413
  * in the resolver.
291
414
  */
292
- declare const builtInPacks: readonly PackDefinitionInput[];
415
+ export declare const builtInPacks: readonly PackDefinitionInput[];
293
416
  /** The registry used by default when no explicit registry is supplied. */
294
- declare const builtInPackRegistry: PackRegistry;
417
+ export declare const builtInPackRegistry: PackRegistry;
295
418
  //#endregion
296
419
  //#region src/skill/schema.d.ts
297
420
  /**
298
421
  * A Skill is reusable instruction text for a coding agent. It is deliberately
299
422
  * provider-independent: nothing here says how or where a provider installs it.
300
423
  */
301
- declare const skillDefinitionSchema: z.ZodObject<{
424
+ export declare const skillDefinitionSchema: z.ZodObject<{
302
425
  name: z.ZodString;
303
426
  description: z.ZodString;
304
427
  content: z.ZodString;
@@ -344,7 +467,7 @@ interface SkillRegistry {
344
467
  * @throws {DuplicateSkillError} when two sources share a name.
345
468
  * @throws {InvalidSkillError} when a source name is not a valid skill name.
346
469
  */
347
- declare function createSkillRegistry(sources: Iterable<SkillSource>): SkillRegistry;
470
+ export declare function createSkillRegistry(sources: Iterable<SkillSource>): SkillRegistry;
348
471
  //#endregion
349
472
  //#region src/config/project.d.ts
350
473
  /** A validated project configuration plus the registries it owns. */
@@ -352,6 +475,7 @@ interface AgentyxProject {
352
475
  readonly config: AgentyxConfig;
353
476
  readonly packRegistry: PackRegistry;
354
477
  readonly skillRegistry: SkillRegistry;
478
+ readonly graph: ProjectGraph | undefined;
355
479
  }
356
480
  /**
357
481
  * Loads `.agentyx.json` and any checked-in Agent Skills it declares.
@@ -360,20 +484,20 @@ interface AgentyxProject {
360
484
  * the project even through symlinks. Loading is local-only: this function never clones a repository
361
485
  * or accesses the network.
362
486
  */
363
- declare function loadAgentyxProject(projectPath?: string): Promise<AgentyxProject>;
487
+ export declare function loadAgentyxProject(projectPath?: string): Promise<AgentyxProject>;
364
488
  //#endregion
365
489
  //#region src/hook/schema.d.ts
366
- declare const HOOK_ACTIVATION_LEVELS: readonly ["default", "optional"];
367
- declare const hookActivationLevelSchema: z.ZodEnum<{
490
+ export declare const HOOK_ACTIVATION_LEVELS: readonly ["default", "optional"];
491
+ export declare const hookActivationLevelSchema: z.ZodEnum<{
368
492
  default: "default";
369
493
  optional: "optional";
370
494
  }>;
371
- declare const HOOK_EVENTS: readonly ["SessionStart"];
372
- declare const hookEventSchema: z.ZodEnum<{
495
+ export declare const HOOK_EVENTS: readonly ["SessionStart"];
496
+ export declare const hookEventSchema: z.ZodEnum<{
373
497
  SessionStart: "SessionStart";
374
498
  }>;
375
- declare const hookNameSchema: z.ZodString;
376
- declare const hookDefinitionSchema: z.ZodObject<{
499
+ export declare const hookNameSchema: z.ZodString;
500
+ export declare const hookDefinitionSchema: z.ZodObject<{
377
501
  name: z.ZodString;
378
502
  description: z.ZodString;
379
503
  event: z.ZodEnum<{
@@ -382,7 +506,7 @@ declare const hookDefinitionSchema: z.ZodObject<{
382
506
  command: z.ZodString;
383
507
  args: z.ZodDefault<z.ZodArray<z.ZodString>>;
384
508
  }, z.core.$strict>;
385
- declare const hookReferenceSchema: z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
509
+ export declare const hookReferenceSchema: z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
386
510
  name: z.ZodString;
387
511
  activation: z.ZodDefault<z.ZodEnum<{
388
512
  default: "default";
@@ -424,24 +548,24 @@ interface HookRegistry {
424
548
  listMetadata(): readonly HookMetadata[];
425
549
  get(name: string): HookDefinition;
426
550
  }
427
- declare function createHookRegistry(sources: Iterable<HookSource>): HookRegistry;
551
+ export declare function createHookRegistry(sources: Iterable<HookSource>): HookRegistry;
428
552
  //#endregion
429
553
  //#region src/mcp/schema.d.ts
430
- declare const MCP_CAPABILITY_LEVELS: readonly ["default", "optional"];
431
- declare const mcpCapabilityLevelSchema: z.ZodEnum<{
554
+ export declare const MCP_CAPABILITY_LEVELS: readonly ["default", "optional"];
555
+ export declare const mcpCapabilityLevelSchema: z.ZodEnum<{
432
556
  default: "default";
433
557
  optional: "optional";
434
558
  }>;
435
- declare const MCP_CONTEXT_COSTS: readonly ["low", "medium", "high"];
436
- declare const mcpContextCostSchema: z.ZodEnum<{
559
+ export declare const MCP_CONTEXT_COSTS: readonly ["low", "medium", "high"];
560
+ export declare const mcpContextCostSchema: z.ZodEnum<{
437
561
  low: "low";
438
562
  medium: "medium";
439
563
  high: "high";
440
564
  }>;
441
- declare const mcpEnvReferenceSchema: z.ZodObject<{
565
+ export declare const mcpEnvReferenceSchema: z.ZodObject<{
442
566
  fromEnv: z.ZodString;
443
567
  }, z.core.$strict>;
444
- declare const mcpServerReferenceSchema: z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
568
+ export declare const mcpServerReferenceSchema: z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
445
569
  name: z.ZodString;
446
570
  activation: z.ZodDefault<z.ZodEnum<{
447
571
  default: "default";
@@ -460,7 +584,7 @@ declare const mcpServerReferenceSchema: z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly
460
584
  optional: "optional";
461
585
  }>;
462
586
  }, z.core.$strict>>;
463
- declare const mcpServerDefinitionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
587
+ export declare const mcpServerDefinitionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
464
588
  name: z.ZodString;
465
589
  description: z.ZodString;
466
590
  contextCost: z.ZodOptional<z.ZodEnum<{
@@ -522,16 +646,16 @@ interface McpServerRegistry {
522
646
  listMetadata(): readonly McpServerMetadata[];
523
647
  get(name: string): McpServerDefinition;
524
648
  }
525
- declare function createMcpServerRegistry(sources: Iterable<McpServerSource>): McpServerRegistry;
649
+ export declare function createMcpServerRegistry(sources: Iterable<McpServerSource>): McpServerRegistry;
526
650
  //#endregion
527
651
  //#region src/tool/schema.d.ts
528
- declare const TOOL_ACTIVATION_LEVELS: readonly ["default", "optional"];
529
- declare const toolActivationLevelSchema: z.ZodEnum<{
652
+ export declare const TOOL_ACTIVATION_LEVELS: readonly ["default", "optional"];
653
+ export declare const toolActivationLevelSchema: z.ZodEnum<{
530
654
  default: "default";
531
655
  optional: "optional";
532
656
  }>;
533
- declare const toolNameSchema: z.ZodString;
534
- declare const toolReferenceSchema: z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
657
+ export declare const toolNameSchema: z.ZodString;
658
+ export declare const toolReferenceSchema: z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
535
659
  name: z.ZodString;
536
660
  activation: z.ZodDefault<z.ZodEnum<{
537
661
  default: "default";
@@ -550,7 +674,7 @@ declare const toolReferenceSchema: z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.Zo
550
674
  optional: "optional";
551
675
  }>;
552
676
  }, z.core.$strict>>;
553
- declare const toolDefinitionSchema: z.ZodObject<{
677
+ export declare const toolDefinitionSchema: z.ZodObject<{
554
678
  name: z.ZodString;
555
679
  description: z.ZodString;
556
680
  kind: z.ZodLiteral<"executable">;
@@ -582,7 +706,7 @@ interface ToolRegistry {
582
706
  listMetadata(): readonly ToolMetadata[];
583
707
  get(name: string): ToolDefinition;
584
708
  }
585
- declare function createToolRegistry(sources: Iterable<ToolSource>): ToolRegistry;
709
+ export declare function createToolRegistry(sources: Iterable<ToolSource>): ToolRegistry;
586
710
  //#endregion
587
711
  //#region src/config/resolver.d.ts
588
712
  /** A project configuration with its selected packs resolved. */
@@ -612,39 +736,39 @@ interface ResolvedAgentyxConfig {
612
736
  * @throws {UnknownPackError} when a configured pack is missing.
613
737
  * @throws {UnknownSkillError} when a pack references an unknown skill.
614
738
  */
615
- declare function resolveAgentyxConfig(config: AgentyxConfig, registry?: PackRegistry, skillRegistry?: SkillRegistry, mcpRegistry?: McpServerRegistry, toolRegistry?: ToolRegistry, hookRegistry?: HookRegistry): ResolvedAgentyxConfig;
739
+ export declare function resolveAgentyxConfig(config: AgentyxConfig, registry?: PackRegistry, skillRegistry?: SkillRegistry, mcpRegistry?: McpServerRegistry, toolRegistry?: ToolRegistry, hookRegistry?: HookRegistry): ResolvedAgentyxConfig;
616
740
  //#endregion
617
741
  //#region src/hook/built-in.d.ts
618
- declare const builtInHookRegistry: HookRegistry;
619
- declare const builtInHookNames: readonly string[];
742
+ export declare const builtInHookRegistry: HookRegistry;
743
+ export declare const builtInHookNames: readonly string[];
620
744
  //#endregion
621
745
  //#region src/hook/errors.d.ts
622
- declare class UnknownHookError extends AgentyxError {
746
+ export declare class UnknownHookError extends AgentyxError {
623
747
  readonly hookName: string;
624
748
  readonly requiredBy: string | undefined;
625
749
  readonly knownHooks: readonly string[];
626
750
  constructor(hookName: string, requiredBy: string | undefined, knownHooks: readonly string[]);
627
751
  }
628
- declare class DuplicateHookError extends AgentyxError {
752
+ export declare class DuplicateHookError extends AgentyxError {
629
753
  readonly hookName: string;
630
754
  constructor(hookName: string);
631
755
  }
632
- declare class InvalidHookError extends AgentyxError {
756
+ export declare class InvalidHookError extends AgentyxError {
633
757
  readonly origin: string;
634
758
  readonly reason: string;
635
759
  constructor(origin: string, reason: string | ZodError, options?: ErrorOptions);
636
760
  }
637
761
  //#endregion
638
762
  //#region src/hook/resolver.d.ts
639
- declare function collectPackHookReferences(resolvedPacks: readonly string[], packRegistry: PackRegistry, hookRegistry: HookRegistry): HookReference[];
640
- declare function filterEffectiveHooks(hooks: readonly HookReference[], enabledCapabilities: readonly string[]): string[];
641
- declare function collectPackHooks(resolvedPacks: readonly string[], packRegistry: PackRegistry, hookRegistry: HookRegistry, enabledCapabilities?: readonly string[]): string[];
642
- declare function resolvePackHookReferences(requestedPacks: readonly string[], packRegistry?: PackRegistry, hookRegistry?: HookRegistry): HookReference[];
643
- declare function resolvePackHooks(requestedPacks: readonly string[], packRegistry?: PackRegistry, hookRegistry?: HookRegistry, enabledCapabilities?: readonly string[]): string[];
763
+ export declare function collectPackHookReferences(resolvedPacks: readonly string[], packRegistry: PackRegistry, hookRegistry: HookRegistry): HookReference[];
764
+ export declare function filterEffectiveHooks(hooks: readonly HookReference[], enabledCapabilities: readonly string[]): string[];
765
+ export declare function collectPackHooks(resolvedPacks: readonly string[], packRegistry: PackRegistry, hookRegistry: HookRegistry, enabledCapabilities?: readonly string[]): string[];
766
+ export declare function resolvePackHookReferences(requestedPacks: readonly string[], packRegistry?: PackRegistry, hookRegistry?: HookRegistry): HookReference[];
767
+ export declare function resolvePackHooks(requestedPacks: readonly string[], packRegistry?: PackRegistry, hookRegistry?: HookRegistry, enabledCapabilities?: readonly string[]): string[];
644
768
  //#endregion
645
769
  //#region src/manifest/errors.d.ts
646
770
  /** Raised when `.agentyx.lock.json` is not valid JSON. */
647
- declare class AgentyxManifestParseError extends AgentyxError {
771
+ export declare class AgentyxManifestParseError extends AgentyxError {
648
772
  readonly filePath: string;
649
773
  constructor(filePath: string, reason: string, options?: ErrorOptions);
650
774
  }
@@ -656,7 +780,7 @@ declare class AgentyxManifestParseError extends AgentyxError {
656
780
  * allowed to overwrite and delete, so guessing at a damaged one would be
657
781
  * guessing about destructive operations.
658
782
  */
659
- declare class AgentyxManifestValidationError extends AgentyxError {
783
+ export declare class AgentyxManifestValidationError extends AgentyxError {
660
784
  readonly issues: readonly AgentyxIssue[];
661
785
  readonly filePath: string | undefined;
662
786
  constructor(error: ZodError, filePath?: string);
@@ -670,9 +794,9 @@ declare class AgentyxManifestValidationError extends AgentyxError {
670
794
  * reinterpreted, because acting on a half-understood record of managed files is
671
795
  * how an installer deletes something it should not.
672
796
  */
673
- declare const INSTALL_MANIFEST_VERSION = 1;
797
+ export declare const INSTALL_MANIFEST_VERSION = 1;
674
798
  /** A `SKILL.md` file Agentyx wrote, owned entirely by Agentyx. */
675
- declare const skillManifestEntrySchema: z.ZodObject<{
799
+ export declare const skillManifestEntrySchema: z.ZodObject<{
676
800
  kind: z.ZodLiteral<"skill">;
677
801
  path: z.ZodString;
678
802
  skill: z.ZodString;
@@ -687,7 +811,7 @@ declare const skillManifestEntrySchema: z.ZodObject<{
687
811
  * `created` says whether the file existed before Agentyx first wrote it, which
688
812
  * is the only thing that makes removing the file itself safe.
689
813
  */
690
- declare const mcpManifestEntrySchema: z.ZodObject<{
814
+ export declare const mcpManifestEntrySchema: z.ZodObject<{
691
815
  kind: z.ZodLiteral<"mcp">;
692
816
  path: z.ZodString;
693
817
  servers: z.ZodArray<z.ZodString>;
@@ -702,7 +826,7 @@ declare const mcpManifestEntrySchema: z.ZodObject<{
702
826
  * user, so the entry records the hook names Agentyx added rather than
703
827
  * claiming the whole document.
704
828
  */
705
- declare const hookManifestEntrySchema: z.ZodObject<{
829
+ export declare const hookManifestEntrySchema: z.ZodObject<{
706
830
  kind: z.ZodLiteral<"hook">;
707
831
  path: z.ZodString;
708
832
  hooks: z.ZodArray<z.ZodString>;
@@ -710,7 +834,7 @@ declare const hookManifestEntrySchema: z.ZodObject<{
710
834
  hash: z.ZodString;
711
835
  created: z.ZodBoolean;
712
836
  }, z.core.$strict>;
713
- declare const installManifestEntrySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
837
+ export declare const installManifestEntrySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
714
838
  kind: z.ZodLiteral<"skill">;
715
839
  path: z.ZodString;
716
840
  skill: z.ZodString;
@@ -732,7 +856,7 @@ declare const installManifestEntrySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
732
856
  created: z.ZodBoolean;
733
857
  }, z.core.$strict>], "kind">;
734
858
  /** The `.agentyx.lock.json` record of everything Agentyx installed into a project. */
735
- declare const installManifestSchema: z.ZodObject<{
859
+ export declare const installManifestSchema: z.ZodObject<{
736
860
  version: z.ZodLiteral<1>;
737
861
  entries: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
738
862
  kind: z.ZodLiteral<"skill">;
@@ -766,11 +890,11 @@ type InstallManifest = z.infer<typeof installManifestSchema>;
766
890
  type InstallManifestInput = z.input<typeof installManifestSchema>;
767
891
  //#endregion
768
892
  //#region src/manifest/io.d.ts
769
- declare const AGENTYX_MANIFEST_FILENAME = ".agentyx.lock.json";
893
+ export declare const AGENTYX_MANIFEST_FILENAME = ".agentyx.lock.json";
770
894
  /** The absolute path `.agentyx.lock.json` is read from for a given project. */
771
- declare function agentyxManifestPath(projectPath?: string): string;
895
+ export declare function agentyxManifestPath(projectPath?: string): string;
772
896
  /** A manifest that claims nothing — what a project has before its first install. */
773
- declare function emptyInstallManifest(): InstallManifest;
897
+ export declare function emptyInstallManifest(): InstallManifest;
774
898
  /**
775
899
  * The SHA-256 digest Agentyx records for managed content.
776
900
  *
@@ -778,13 +902,13 @@ declare function emptyInstallManifest(): InstallManifest;
778
902
  * this and may replace it" from "someone else owns this file", so it is
779
903
  * computed over the exact bytes written, never over a normalised form.
780
904
  */
781
- declare function hashContent(content: string): string;
905
+ export declare function hashContent(content: string): string;
782
906
  /**
783
907
  * Validates an already-parsed manifest document.
784
908
  *
785
909
  * @throws {AgentyxManifestValidationError} when the document violates the schema.
786
910
  */
787
- declare function parseInstallManifest(value: unknown, filePath?: string): InstallManifest;
911
+ export declare function parseInstallManifest(value: unknown, filePath?: string): InstallManifest;
788
912
  /**
789
913
  * Reads `.agentyx.lock.json` from `projectPath`.
790
914
  *
@@ -796,7 +920,7 @@ declare function parseInstallManifest(value: unknown, filePath?: string): Instal
796
920
  * @throws {AgentyxManifestParseError} when the file is not valid JSON.
797
921
  * @throws {AgentyxManifestValidationError} when the document violates the schema.
798
922
  */
799
- declare function loadInstallManifest(projectPath?: string): Promise<InstallManifest>;
923
+ export declare function loadInstallManifest(projectPath?: string): Promise<InstallManifest>;
800
924
  /**
801
925
  * Serialises a manifest for writing.
802
926
  *
@@ -805,63 +929,63 @@ declare function loadInstallManifest(projectPath?: string): Promise<InstallManif
805
929
  * diff. Writing is deliberately not done here — only the install executor
806
930
  * touches the filesystem.
807
931
  */
808
- declare function formatInstallManifest(manifest: InstallManifest): string;
932
+ export declare function formatInstallManifest(manifest: InstallManifest): string;
809
933
  /**
810
934
  * Indexes manifest entries by managed path.
811
935
  *
812
936
  * Every ownership question — may this file be overwritten, may it be deleted —
813
937
  * is a lookup by path, so callers do not scan the list themselves.
814
938
  */
815
- declare function manifestEntriesByPath(manifest: InstallManifest): ReadonlyMap<string, InstallManifestEntry>;
939
+ export declare function manifestEntriesByPath(manifest: InstallManifest): ReadonlyMap<string, InstallManifestEntry>;
816
940
  //#endregion
817
941
  //#region src/mcp/built-in.d.ts
818
- declare const builtInMcpServerRegistry: McpServerRegistry;
819
- declare const builtInMcpServerNames: readonly string[];
942
+ export declare const builtInMcpServerRegistry: McpServerRegistry;
943
+ export declare const builtInMcpServerNames: readonly string[];
820
944
  //#endregion
821
945
  //#region src/mcp/errors.d.ts
822
- declare class UnknownMcpServerError extends AgentyxError {
946
+ export declare class UnknownMcpServerError extends AgentyxError {
823
947
  readonly serverName: string;
824
948
  readonly requiredBy: string | undefined;
825
949
  readonly knownServers: readonly string[];
826
950
  constructor(serverName: string, requiredBy: string | undefined, knownServers: readonly string[]);
827
951
  }
828
- declare class DuplicateMcpServerError extends AgentyxError {
952
+ export declare class DuplicateMcpServerError extends AgentyxError {
829
953
  readonly serverName: string;
830
954
  constructor(serverName: string);
831
955
  }
832
- declare class InvalidMcpServerError extends AgentyxError {
956
+ export declare class InvalidMcpServerError extends AgentyxError {
833
957
  readonly origin: string;
834
958
  readonly reason: string;
835
959
  constructor(origin: string, reason: string | ZodError, options?: ErrorOptions);
836
960
  }
837
961
  //#endregion
838
962
  //#region src/mcp/resolver.d.ts
839
- declare function collectPackMcpServerReferences(resolvedPacks: readonly string[], packRegistry: PackRegistry, mcpRegistry: McpServerRegistry): McpServerReference[];
840
- declare function filterEffectiveMcpServers(servers: readonly McpServerReference[], enabledCapabilities: readonly string[]): string[];
841
- declare function collectPackMcpServers(resolvedPacks: readonly string[], packRegistry: PackRegistry, mcpRegistry: McpServerRegistry, enabledCapabilities?: readonly string[]): string[];
842
- declare function resolvePackMcpServerReferences(requestedPacks: readonly string[], packRegistry?: PackRegistry, mcpRegistry?: McpServerRegistry): McpServerReference[];
843
- declare function resolvePackMcpServers(requestedPacks: readonly string[], packRegistry?: PackRegistry, mcpRegistry?: McpServerRegistry, enabledCapabilities?: readonly string[]): string[];
963
+ export declare function collectPackMcpServerReferences(resolvedPacks: readonly string[], packRegistry: PackRegistry, mcpRegistry: McpServerRegistry): McpServerReference[];
964
+ export declare function filterEffectiveMcpServers(servers: readonly McpServerReference[], enabledCapabilities: readonly string[]): string[];
965
+ export declare function collectPackMcpServers(resolvedPacks: readonly string[], packRegistry: PackRegistry, mcpRegistry: McpServerRegistry, enabledCapabilities?: readonly string[]): string[];
966
+ export declare function resolvePackMcpServerReferences(requestedPacks: readonly string[], packRegistry?: PackRegistry, mcpRegistry?: McpServerRegistry): McpServerReference[];
967
+ export declare function resolvePackMcpServers(requestedPacks: readonly string[], packRegistry?: PackRegistry, mcpRegistry?: McpServerRegistry, enabledCapabilities?: readonly string[]): string[];
844
968
  //#endregion
845
969
  //#region src/meta.d.ts
846
- declare const agentyxCoreName = "agentyx-core";
847
- declare function getCoreStatus(): string;
970
+ export declare const agentyxCoreName = "agentyx-core";
971
+ export declare function getCoreStatus(): string;
848
972
  //#endregion
849
973
  //#region src/pack/errors.d.ts
850
974
  /** Raised when a requested pack is not present in the registry. */
851
- declare class UnknownPackError extends AgentyxError {
975
+ export declare class UnknownPackError extends AgentyxError {
852
976
  readonly packName: string;
853
977
  readonly requiredBy: string | undefined;
854
978
  readonly knownPacks: readonly string[];
855
979
  constructor(packName: string, requiredBy: string | undefined, knownPacks: readonly string[]);
856
980
  }
857
981
  /** @deprecated Packs no longer inherit from other packs. */
858
- declare class CircularPackDependencyError extends AgentyxError {
982
+ export declare class CircularPackDependencyError extends AgentyxError {
859
983
  /** The cycle path, starting and ending with the same pack. */
860
984
  readonly cycle: readonly string[];
861
985
  constructor(cycle: readonly string[]);
862
986
  }
863
987
  /** Raised when a registry is built from definitions that reuse a pack name. */
864
- declare class DuplicatePackError extends AgentyxError {
988
+ export declare class DuplicatePackError extends AgentyxError {
865
989
  readonly packName: string;
866
990
  constructor(packName: string);
867
991
  }
@@ -875,10 +999,10 @@ declare class DuplicatePackError extends AgentyxError {
875
999
  *
876
1000
  * @throws {UnknownPackError} when a requested pack is missing.
877
1001
  */
878
- declare function resolvePacks(requestedPacks: readonly string[], registry?: PackRegistry): string[];
1002
+ export declare function resolvePacks(requestedPacks: readonly string[], registry?: PackRegistry): string[];
879
1003
  //#endregion
880
1004
  //#region src/project/signals.d.ts
881
- declare const PACKAGE_MANAGERS: readonly ["pnpm", "npm", "yarn", "bun"];
1005
+ export declare const PACKAGE_MANAGERS: readonly ["pnpm", "npm", "yarn", "bun"];
882
1006
  type PackageManagerName = (typeof PACKAGE_MANAGERS)[number];
883
1007
  interface PackageManagerDetection {
884
1008
  readonly name: PackageManagerName | undefined;
@@ -892,6 +1016,7 @@ interface ProjectPackageJsonDetection {
892
1016
  readonly path: string;
893
1017
  readonly name: string | undefined;
894
1018
  readonly packageManager: string | undefined;
1019
+ readonly scripts: Readonly<Record<string, string>>;
895
1020
  readonly error: string | undefined;
896
1021
  }
897
1022
  type DependencyField = "dependencies" | "devDependencies" | "peerDependencies" | "optionalDependencies";
@@ -907,6 +1032,17 @@ interface ContainerFileSignals {
907
1032
  interface CiFileSignals {
908
1033
  readonly githubActions: boolean;
909
1034
  }
1035
+ /**
1036
+ * Rust facts. `detected` requires a `Cargo.toml` that declares a `[package]` or `[workspace]`
1037
+ * table; stray `.rs` files never count. The other fields are supporting context only.
1038
+ */
1039
+ interface RustSignal {
1040
+ readonly detected: boolean;
1041
+ readonly workspace: boolean;
1042
+ readonly cargoLock: boolean;
1043
+ /** `rust-toolchain.toml` or `rust-toolchain`, whichever is present. */
1044
+ readonly toolchainFile: string | undefined;
1045
+ }
910
1046
  interface MonorepoSignal {
911
1047
  readonly detected: boolean;
912
1048
  readonly markers: readonly string[];
@@ -932,6 +1068,7 @@ interface ProjectSignals {
932
1068
  readonly tsconfig: boolean;
933
1069
  };
934
1070
  readonly angular: TechnologyMatch | undefined;
1071
+ readonly rust: RustSignal;
935
1072
  readonly testFrameworks: readonly TechnologyMatch[];
936
1073
  readonly browserTesting: readonly TechnologyMatch[];
937
1074
  readonly observability: readonly TechnologyMatch[];
@@ -946,15 +1083,15 @@ interface ProjectSignals {
946
1083
  };
947
1084
  }
948
1085
  /** Maximum directory entries visited by `scanRepositorySize`, regardless of match. */
949
- declare const REPOSITORY_SCAN_ENTRY_LIMIT = 5000;
1086
+ export declare const REPOSITORY_SCAN_ENTRY_LIMIT = 5000;
950
1087
  /** Gathers every project signal with a bounded, cheap set of reads. */
951
- declare function collectProjectSignals(projectDir: string): Promise<ProjectSignals>;
1088
+ export declare function collectProjectSignals(projectDir: string): Promise<ProjectSignals>;
952
1089
  /**
953
1090
  * Counts source-like files under a bounded traversal, ignoring dependency, VCS and build output
954
1091
  * directories. Stops after visiting `entryLimit` directory entries — cheap even on a monorepo — and
955
1092
  * reports `capped` so callers never mistake a partial scan for a complete one.
956
1093
  */
957
- declare function scanRepositorySize(projectDir: string, options?: {
1094
+ export declare function scanRepositorySize(projectDir: string, options?: {
958
1095
  readonly entryLimit?: number;
959
1096
  }): Promise<RepositorySizeSignal>;
960
1097
  //#endregion
@@ -971,20 +1108,20 @@ interface ProjectDetection {
971
1108
  * capabilities fit — that policy lives in `recommendCapabilities`, kept separate so each half stays
972
1109
  * independently testable.
973
1110
  */
974
- declare function detectProject(projectDir: string): Promise<ProjectDetection>;
975
- declare function buildAgentyxConfig(input: {
1111
+ export declare function detectProject(projectDir: string): Promise<ProjectDetection>;
1112
+ export declare function buildAgentyxConfig(input: {
976
1113
  readonly packs: readonly string[];
977
1114
  readonly enable?: readonly string[];
978
1115
  readonly targets: readonly string[];
979
1116
  }): AgentyxConfigInput;
980
- declare function formatAgentyxConfig(config: AgentyxConfigInput): string;
1117
+ export declare function formatAgentyxConfig(config: AgentyxConfigInput): string;
981
1118
  //#endregion
982
1119
  //#region src/project/executable.d.ts
983
1120
  /** Whether `command` resolves to an executable file, via `PATH` unless it already contains a `/`. */
984
- declare function isExecutableOnPath(command: string): Promise<boolean>;
1121
+ export declare function isExecutableOnPath(command: string): Promise<boolean>;
985
1122
  //#endregion
986
1123
  //#region src/project/recommend.d.ts
987
- declare const RECOMMENDATION_CONFIDENCES: readonly ["high", "medium"];
1124
+ export declare const RECOMMENDATION_CONFIDENCES: readonly ["high", "medium"];
988
1125
  type RecommendationConfidence = (typeof RECOMMENDATION_CONFIDENCES)[number];
989
1126
  type RecommendationKind = "pack" | "capability";
990
1127
  /**
@@ -1013,8 +1150,8 @@ interface RecommendCapabilitiesOptions {
1013
1150
  * These are approximate signals, not exact token accounting, and a monorepo is treated as already
1014
1151
  * complex enough to lower the bar.
1015
1152
  */
1016
- declare const CODEBASE_MEMORY_FILE_THRESHOLD = 2000;
1017
- declare const CODEBASE_MEMORY_MONOREPO_FILE_THRESHOLD = 800;
1153
+ export declare const CODEBASE_MEMORY_FILE_THRESHOLD = 2000;
1154
+ export declare const CODEBASE_MEMORY_MONOREPO_FILE_THRESHOLD = 800;
1018
1155
  /**
1019
1156
  * Applies conservative, deterministic policy on top of `ProjectSignals`. This is the only place
1020
1157
  * that turns an observed fact into a product suggestion — `ProjectSignals` stays fact-only so it
@@ -1023,7 +1160,7 @@ declare const CODEBASE_MEMORY_MONOREPO_FILE_THRESHOLD = 800;
1023
1160
  * Never enables anything and never touches the filesystem: the caller decides what, if anything,
1024
1161
  * to do with the result.
1025
1162
  */
1026
- declare function recommendCapabilities(signals: ProjectSignals, options?: RecommendCapabilitiesOptions): RecommendationResult;
1163
+ export declare function recommendCapabilities(signals: ProjectSignals, options?: RecommendCapabilitiesOptions): RecommendationResult;
1027
1164
  //#endregion
1028
1165
  //#region src/skill/built-in.d.ts
1029
1166
  /**
@@ -1031,9 +1168,9 @@ declare function recommendCapabilities(signals: ProjectSignals, options?: Recomm
1031
1168
  * `packages/core/skills`, and knowing them without touching the filesystem is
1032
1169
  * what lets pack resolution validate references without reading any body.
1033
1170
  */
1034
- declare const builtInSkillNames: readonly ["engineering-principles", "code-quality", "api-design", "code-review", "planning", "systematic-debugging", "verification", "brainstorming", "parallel-work", "worktree-workflow", "subagent-driven-development", "requesting-code-review", "typescript-strict", "typescript-modeling", "typescript-modern", "angular-modern", "angular-signals", "angular-architecture", "angular-testing", "context-efficient-development", "concise-output", "targeted-exploration", "focused-verification", "test-strategy", "test-doubles", "e2e-testing", "flaky-tests", "secure-coding", "secrets-handling", "dependency-security", "auth-patterns", "performance-profiling", "web-vitals", "query-performance", "semantic-html", "aria-patterns", "keyboard-navigation", "refactoring-safely", "legacy-code", "dependency-hygiene", "technical-writing", "api-documentation", "decision-records", "structured-logging", "metrics-and-tracing", "incident-response", "data-modeling", "schema-migrations", "transactions-and-consistency", "commit-hygiene", "branching-strategy", "pull-requests", "ci-pipelines", "containerization", "deployment-safety", "infrastructure-as-code"];
1171
+ export declare const builtInSkillNames: readonly ["engineering-principles", "code-quality", "api-design", "code-review", "planning", "systematic-debugging", "verification", "brainstorming", "parallel-work", "worktree-workflow", "subagent-driven-development", "requesting-code-review", "typescript-strict", "typescript-modeling", "typescript-modern", "rust-idiomatic-development", "rust-filesystem-safety", "rust-testing-portability", "cargo-project-verification", "angular-modern", "angular-signals", "angular-architecture", "angular-testing", "context-efficient-development", "concise-output", "targeted-exploration", "focused-verification", "test-strategy", "test-doubles", "e2e-testing", "flaky-tests", "secure-coding", "secrets-handling", "dependency-security", "auth-patterns", "performance-profiling", "web-vitals", "query-performance", "semantic-html", "aria-patterns", "keyboard-navigation", "refactoring-safely", "legacy-code", "dependency-hygiene", "technical-writing", "api-documentation", "decision-records", "structured-logging", "metrics-and-tracing", "incident-response", "data-modeling", "schema-migrations", "transactions-and-consistency", "commit-hygiene", "branching-strategy", "pull-requests", "ci-pipelines", "containerization", "deployment-safety", "infrastructure-as-code"];
1035
1172
  /** The registry used by default when no explicit registry is supplied. */
1036
- declare const builtInSkillRegistry: SkillRegistry;
1173
+ export declare const builtInSkillRegistry: SkillRegistry;
1037
1174
  //#endregion
1038
1175
  //#region src/skill/errors.d.ts
1039
1176
  /**
@@ -1042,7 +1179,7 @@ declare const builtInSkillRegistry: SkillRegistry;
1042
1179
  * The offending name is exposed as `skillName`; `pack` stays the JS pack
1043
1180
  * trace inherited from `Error`.
1044
1181
  */
1045
- declare class UnknownSkillError extends AgentyxError {
1182
+ export declare class UnknownSkillError extends AgentyxError {
1046
1183
  readonly skillName: string;
1047
1184
  /** The pack that declared the skill, when the failure came from resolution. */
1048
1185
  readonly requiredBy: string | undefined;
@@ -1050,7 +1187,7 @@ declare class UnknownSkillError extends AgentyxError {
1050
1187
  constructor(skillName: string, requiredBy: string | undefined, knownSkills: readonly string[]);
1051
1188
  }
1052
1189
  /** Raised when a registry is built from sources that reuse a skill name. */
1053
- declare class DuplicateSkillError extends AgentyxError {
1190
+ export declare class DuplicateSkillError extends AgentyxError {
1054
1191
  readonly skillName: string;
1055
1192
  constructor(skillName: string);
1056
1193
  }
@@ -1061,7 +1198,7 @@ declare class DuplicateSkillError extends AgentyxError {
1061
1198
  * Built-in skills ship with Agentyx, so this is a programmer error rather than
1062
1199
  * something a user can fix in their project.
1063
1200
  */
1064
- declare class InvalidSkillError extends AgentyxError {
1201
+ export declare class InvalidSkillError extends AgentyxError {
1065
1202
  /** Where the skill came from: a file path, or a label for an in-memory source. */
1066
1203
  readonly origin: string;
1067
1204
  readonly reason: string;
@@ -1090,7 +1227,7 @@ declare class InvalidSkillError extends AgentyxError {
1090
1227
  *
1091
1228
  * @throws {InvalidSkillError} when the frontmatter or the resulting skill is invalid.
1092
1229
  */
1093
- declare function parseSkillMarkdown(markdown: string, origin: string): SkillDefinition;
1230
+ export declare function parseSkillMarkdown(markdown: string, origin: string): SkillDefinition;
1094
1231
  /**
1095
1232
  * Renders a skill as canonical `SKILL.md` text — the inverse of
1096
1233
  * `parseSkillMarkdown`, and the single representation every consumer installs.
@@ -1107,7 +1244,7 @@ declare function parseSkillMarkdown(markdown: string, origin: string): SkillDefi
1107
1244
  * description cannot be represented in the flat frontmatter subset the parser
1108
1245
  * accepts.
1109
1246
  */
1110
- declare function formatSkillMarkdown(skill: SkillDefinitionInput): string;
1247
+ export declare function formatSkillMarkdown(skill: SkillDefinitionInput): string;
1111
1248
  //#endregion
1112
1249
  //#region src/skill/resolver.d.ts
1113
1250
  /**
@@ -1120,32 +1257,32 @@ declare function formatSkillMarkdown(skill: SkillDefinitionInput): string;
1120
1257
  * @throws {UnknownPackError} when a requested pack is missing.
1121
1258
  * @throws {UnknownSkillError} when a pack references a skill the registry lacks.
1122
1259
  */
1123
- declare function resolvePackSkills(requestedPacks: readonly string[], packRegistry?: PackRegistry, skillRegistry?: SkillRegistry): string[];
1260
+ export declare function resolvePackSkills(requestedPacks: readonly string[], packRegistry?: PackRegistry, skillRegistry?: SkillRegistry): string[];
1124
1261
  //#endregion
1125
1262
  //#region src/source/errors.d.ts
1126
- declare class DuplicateTrustedSourceError extends AgentyxError {
1263
+ export declare class DuplicateTrustedSourceError extends AgentyxError {
1127
1264
  readonly sourceName: string;
1128
1265
  constructor(sourceName: string);
1129
1266
  }
1130
- declare class UnknownTrustedSourceError extends AgentyxError {
1267
+ export declare class UnknownTrustedSourceError extends AgentyxError {
1131
1268
  readonly sourceName: string;
1132
1269
  readonly knownSources: readonly string[];
1133
1270
  constructor(sourceName: string, knownSources: readonly string[]);
1134
1271
  }
1135
- declare class TrustedSourceLoadError extends AgentyxError {
1272
+ export declare class TrustedSourceLoadError extends AgentyxError {
1136
1273
  readonly sourceName: string;
1137
1274
  constructor(sourceName: string, reason: string, options?: ErrorOptions);
1138
1275
  }
1139
1276
  //#endregion
1140
1277
  //#region src/source/schema.d.ts
1141
- declare const trustedSourceNameSchema: z.ZodString;
1142
- declare const trustedSourcePathSchema: z.ZodString;
1143
- declare const trustedSourceReferenceSchema: z.ZodObject<{
1278
+ export declare const trustedSourceNameSchema: z.ZodString;
1279
+ export declare const trustedSourcePathSchema: z.ZodString;
1280
+ export declare const trustedSourceReferenceSchema: z.ZodObject<{
1144
1281
  name: z.ZodString;
1145
1282
  path: z.ZodString;
1146
1283
  ref: z.ZodString;
1147
1284
  }, z.core.$strict>;
1148
- declare const trustedSourceDefinitionSchema: z.ZodObject<{
1285
+ export declare const trustedSourceDefinitionSchema: z.ZodObject<{
1149
1286
  name: z.ZodString;
1150
1287
  displayName: z.ZodString;
1151
1288
  repository: z.ZodString;
@@ -1159,7 +1296,7 @@ declare const trustedSourceDefinitionSchema: z.ZodObject<{
1159
1296
  }>;
1160
1297
  installNote: z.ZodString;
1161
1298
  }, z.core.$strict>;
1162
- declare const codexPluginManifestSchema: z.ZodObject<{
1299
+ export declare const codexPluginManifestSchema: z.ZodObject<{
1163
1300
  name: z.ZodString;
1164
1301
  version: z.ZodString;
1165
1302
  description: z.ZodString;
@@ -1167,7 +1304,7 @@ declare const codexPluginManifestSchema: z.ZodObject<{
1167
1304
  license: z.ZodString;
1168
1305
  skills: z.ZodString;
1169
1306
  }, z.core.$loose>;
1170
- declare const trustedSourceSkillSummarySchema: z.ZodObject<{
1307
+ export declare const trustedSourceSkillSummarySchema: z.ZodObject<{
1171
1308
  name: z.ZodString;
1172
1309
  description: z.ZodString;
1173
1310
  hasResources: z.ZodBoolean;
@@ -1188,39 +1325,39 @@ interface TrustedSourceInspection {
1188
1325
  readonly installable: boolean;
1189
1326
  readonly installNote: string;
1190
1327
  }
1191
- declare function inspectTrustedSource(projectPath: string, reference: TrustedSourceReference): Promise<TrustedSourceInspection>;
1328
+ export declare function inspectTrustedSource(projectPath: string, reference: TrustedSourceReference): Promise<TrustedSourceInspection>;
1192
1329
  //#endregion
1193
1330
  //#region src/source/registry.d.ts
1194
1331
  type TrustedSourceRegistry = ReadonlyMap<string, TrustedSourceDefinition>;
1195
- declare const knownTrustedSources: readonly TrustedSourceDefinition[];
1196
- declare const knownTrustedSourceRegistry: TrustedSourceRegistry;
1197
- declare function createTrustedSourceRegistry(definitions: Iterable<TrustedSourceDefinition>): TrustedSourceRegistry;
1198
- declare function getTrustedSourceDefinition(source: string | TrustedSourceReference, registry?: TrustedSourceRegistry): TrustedSourceDefinition;
1332
+ export declare const knownTrustedSources: readonly TrustedSourceDefinition[];
1333
+ export declare const knownTrustedSourceRegistry: TrustedSourceRegistry;
1334
+ export declare function createTrustedSourceRegistry(definitions: Iterable<TrustedSourceDefinition>): TrustedSourceRegistry;
1335
+ export declare function getTrustedSourceDefinition(source: string | TrustedSourceReference, registry?: TrustedSourceRegistry): TrustedSourceDefinition;
1199
1336
  //#endregion
1200
1337
  //#region src/tool/built-in.d.ts
1201
- declare const builtInToolRegistry: ToolRegistry;
1202
- declare const builtInToolNames: readonly string[];
1338
+ export declare const builtInToolRegistry: ToolRegistry;
1339
+ export declare const builtInToolNames: readonly string[];
1203
1340
  //#endregion
1204
1341
  //#region src/tool/errors.d.ts
1205
- declare class UnknownToolError extends AgentyxError {
1342
+ export declare class UnknownToolError extends AgentyxError {
1206
1343
  readonly toolName: string;
1207
1344
  readonly requiredBy: string | undefined;
1208
1345
  readonly knownTools: readonly string[];
1209
1346
  constructor(toolName: string, requiredBy: string | undefined, knownTools: readonly string[]);
1210
1347
  }
1211
- declare class DuplicateToolError extends AgentyxError {
1348
+ export declare class DuplicateToolError extends AgentyxError {
1212
1349
  readonly toolName: string;
1213
1350
  constructor(toolName: string);
1214
1351
  }
1215
- declare class InvalidToolError extends AgentyxError {
1352
+ export declare class InvalidToolError extends AgentyxError {
1216
1353
  constructor(origin: string, reason: unknown, options?: ErrorOptions);
1217
1354
  }
1218
1355
  //#endregion
1219
1356
  //#region src/tool/resolver.d.ts
1220
- declare function collectPackToolReferences(resolvedPacks: readonly string[], packRegistry: PackRegistry, toolRegistry: ToolRegistry): ToolReference[];
1221
- declare function filterEffectiveTools(tools: readonly ToolReference[], enabledCapabilities: readonly string[]): string[];
1222
- declare function resolvePackToolReferences(requestedPacks: readonly string[], packRegistry?: PackRegistry, toolRegistry?: ToolRegistry): ToolReference[];
1223
- declare function resolvePackTools(requestedPacks: readonly string[], packRegistry?: PackRegistry, toolRegistry?: ToolRegistry, enabledCapabilities?: readonly string[]): string[];
1357
+ export declare function collectPackToolReferences(resolvedPacks: readonly string[], packRegistry: PackRegistry, toolRegistry: ToolRegistry): ToolReference[];
1358
+ export declare function filterEffectiveTools(tools: readonly ToolReference[], enabledCapabilities: readonly string[]): string[];
1359
+ export declare function resolvePackToolReferences(requestedPacks: readonly string[], packRegistry?: PackRegistry, toolRegistry?: ToolRegistry): ToolReference[];
1360
+ export declare function resolvePackTools(requestedPacks: readonly string[], packRegistry?: PackRegistry, toolRegistry?: ToolRegistry, enabledCapabilities?: readonly string[]): string[];
1224
1361
  //#endregion
1225
- export { AGENTYX_CONFIG_FILENAME, AGENTYX_CONFIG_SCHEMA_ID, AGENTYX_MANIFEST_FILENAME, type AgentyxConfig, type AgentyxConfigInput, type AgentyxConfigIssue, AgentyxConfigNotFoundError, AgentyxConfigParseError, AgentyxConfigValidationError, AgentyxError, type AgentyxIssue, AgentyxManifestParseError, AgentyxManifestValidationError, type AgentyxProject, CODEBASE_MEMORY_FILE_THRESHOLD, CODEBASE_MEMORY_MONOREPO_FILE_THRESHOLD, type CiFileSignals, CircularPackDependencyError, type CodexPluginManifest, type ContainerFileSignals, type DependencyField, DuplicateHookError, DuplicateMcpServerError, DuplicatePackError, DuplicateSkillError, DuplicateToolError, DuplicateTrustedSourceError, HOOK_ACTIVATION_LEVELS, HOOK_EVENTS, type HookActivationLevel, type HookDefinition, type HookDefinitionInput, type HookEvent, type HookManifestEntry, type HookMetadata, type HookReference, type HookReferenceInput, type HookRegistry, type HookSource, INSTALL_MANIFEST_VERSION, type InstallManifest, type InstallManifestEntry, type InstallManifestInput, InvalidHookError, InvalidMcpServerError, InvalidSkillError, InvalidToolError, LocalSkillDirectoryError, MCP_CAPABILITY_LEVELS, MCP_CONTEXT_COSTS, type McpCapabilityLevel, type McpContextCost, type McpEnvReference, type McpManifestEntry, type McpServerDefinition, type McpServerDefinitionInput, type McpServerMetadata, type McpServerReference, type McpServerReferenceInput, type McpServerRegistry, type McpServerSource, type MonorepoSignal, PACKAGE_MANAGERS, PACK_CATEGORIES, type PackCategory, type PackDefinition, type PackDefinitionInput, type PackRegistry, type PackageManagerDetection, type PackageManagerName, type ProjectDetection, type ProjectPackageJsonDetection, type ProjectSignals, RECOMMENDATION_CONFIDENCES, REPOSITORY_SCAN_ENTRY_LIMIT, type Recommendation, type RecommendationConfidence, type RecommendationKind, type RecommendationResult, type RepositorySizeSignal, type ResolvedAgentyxConfig, type SkillDefinition, type SkillDefinitionInput, type SkillManifestEntry, type SkillRegistry, type SkillSource, TOOL_ACTIVATION_LEVELS, type TechnologyMatch, type ToolActivationLevel, type ToolDefinition, type ToolDefinitionInput, type ToolMetadata, type ToolReference, type ToolReferenceInput, type ToolRegistry, type ToolSource, type TrustedSourceDefinition, TrustedSourceLoadError, type TrustedSourceReference, type TrustedSourceSkillSummary, UnknownEnabledCapabilityError, UnknownHookError, UnknownMcpServerError, UnknownPackError, UnknownSkillError, UnknownToolError, UnknownTrustedSourceError, agentyxConfigPath, agentyxConfigSchema, agentyxCoreName, agentyxManifestPath, agentyxTargetSchema, buildAgentyxConfig, buildAgentyxConfigJsonSchema, builtInHookNames, builtInHookRegistry, builtInMcpServerNames, builtInMcpServerRegistry, builtInPackRegistry, builtInPacks, builtInSkillNames, builtInSkillRegistry, builtInToolNames, builtInToolRegistry, codexPluginManifestSchema, collectPackHookReferences, collectPackHooks, collectPackMcpServerReferences, collectPackMcpServers, collectPackToolReferences, collectProjectSignals, createHookRegistry, createMcpServerRegistry, createPackRegistry, createSkillRegistry, createToolRegistry, createTrustedSourceRegistry, detectProject, emptyInstallManifest, enabledCapabilityNameSchema, filterEffectiveHooks, filterEffectiveMcpServers, filterEffectiveTools, formatAgentyxConfig, formatInstallManifest, formatSkillMarkdown, getCoreStatus, getTrustedSourceDefinition, hashContent, hookActivationLevelSchema, hookDefinitionSchema, hookEventSchema, hookManifestEntrySchema, hookNameSchema, hookReferenceSchema, inspectTrustedSource, installManifestEntrySchema, installManifestSchema, isExecutableOnPath, knownTrustedSourceRegistry, knownTrustedSources, loadAgentyxConfig, loadAgentyxProject, loadInstallManifest, manifestEntriesByPath, mcpCapabilityLevelSchema, mcpContextCostSchema, mcpEnvReferenceSchema, mcpManifestEntrySchema, mcpServerDefinitionSchema, mcpServerReferenceSchema, packCategorySchema, packDefinitionSchema, packNameSchema, parseAgentyxConfig, parseInstallManifest, parseSkillMarkdown, recommendCapabilities, resolveAgentyxConfig, resolvePackHookReferences, resolvePackHooks, resolvePackMcpServerReferences, resolvePackMcpServers, resolvePackSkills, resolvePackToolReferences, resolvePackTools, resolvePacks, scanRepositorySize, skillDefinitionSchema, skillDirectorySchema, skillManifestEntrySchema, toolActivationLevelSchema, toolDefinitionSchema, toolNameSchema, toolReferenceSchema, trustedSourceDefinitionSchema, trustedSourceNameSchema, trustedSourcePathSchema, trustedSourceReferenceSchema, trustedSourceSkillSummarySchema };
1362
+ export type { AgentyxConfig, AgentyxConfigInput, AgentyxConfigIssue, AgentyxIssue, AgentyxProject, CiFileSignals, CodexPluginManifest, ContainerFileSignals, DependencyField, HookActivationLevel, HookDefinition, HookDefinitionInput, HookEvent, HookManifestEntry, HookMetadata, HookReference, HookReferenceInput, HookRegistry, HookSource, InstallManifest, InstallManifestEntry, InstallManifestInput, McpCapabilityLevel, McpContextCost, McpEnvReference, McpManifestEntry, McpServerDefinition, McpServerDefinitionInput, McpServerMetadata, McpServerReference, McpServerReferenceInput, McpServerRegistry, McpServerSource, MonorepoSignal, PackCategory, PackDefinition, PackDefinitionInput, PackRegistry, PackageManagerDetection, PackageManagerName, ProjectContext, ProjectDetection, ProjectGraph, ProjectMetadata, ProjectPackageJsonDetection, ProjectRelation, ProjectSignals, Recommendation, RecommendationConfidence, RecommendationKind, RecommendationResult, RepositorySizeSignal, ResolvedAgentyxConfig, RustSignal, SkillDefinition, SkillDefinitionInput, SkillManifestEntry, SkillRegistry, SkillSource, TechnologyMatch, ToolActivationLevel, ToolDefinition, ToolDefinitionInput, ToolMetadata, ToolReference, ToolReferenceInput, ToolRegistry, ToolSource, TrustedSourceDefinition, TrustedSourceReference, TrustedSourceSkillSummary };
1226
1363
  //# sourceMappingURL=index.d.mts.map