@agentyx/core 0.8.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/README.md +5 -1
- package/dist/index.d.mts +159 -147
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +62 -3
- package/dist/index.mjs.map +1 -1
- package/package.json +2 -2
- package/skills/cargo-project-verification/SKILL.md +48 -0
- package/skills/rust-filesystem-safety/SKILL.md +46 -0
- package/skills/rust-idiomatic-development/SKILL.md +46 -0
- package/skills/rust-testing-portability/SKILL.md +41 -0
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,41 +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
53
|
/** Raised when a configured project-context path is missing or escapes the project. */
|
|
54
|
-
declare class ProjectContextPathError extends AgentyxError {
|
|
54
|
+
export declare class ProjectContextPathError extends AgentyxError {
|
|
55
55
|
readonly path: string;
|
|
56
56
|
constructor(path: string, reason: string, options?: ErrorOptions);
|
|
57
57
|
}
|
|
58
58
|
//#endregion
|
|
59
59
|
//#region src/config/json-schema.d.ts
|
|
60
60
|
/** Canonical identifier of the published `.agentyx.json` schema. */
|
|
61
|
-
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";
|
|
62
62
|
/**
|
|
63
63
|
* Derives the JSON Schema for `.agentyx.json` from the Zod model, which stays the
|
|
64
64
|
* single source of truth. The committed `schema/agentyx.schema.json` is generated
|
|
@@ -67,22 +67,22 @@ declare const AGENTYX_CONFIG_SCHEMA_ID = "https://raw.githubusercontent.com/Ande
|
|
|
67
67
|
* The `input` view is used so that fields with defaults stay optional, which is
|
|
68
68
|
* what an author writing the file cares about.
|
|
69
69
|
*/
|
|
70
|
-
declare function buildAgentyxConfigJsonSchema(): Record<string, unknown>;
|
|
70
|
+
export declare function buildAgentyxConfigJsonSchema(): Record<string, unknown>;
|
|
71
71
|
//#endregion
|
|
72
72
|
//#region src/config/schema.d.ts
|
|
73
73
|
/**
|
|
74
74
|
* Targets stay free-form strings on purpose: third-party adapters should be
|
|
75
75
|
* able to register providers without a change to this schema.
|
|
76
76
|
*/
|
|
77
|
-
declare const agentyxTargetSchema: z.ZodString;
|
|
78
|
-
declare const enabledCapabilityNameSchema: z.ZodString;
|
|
77
|
+
export declare const agentyxTargetSchema: z.ZodString;
|
|
78
|
+
export declare const enabledCapabilityNameSchema: z.ZodString;
|
|
79
79
|
/**
|
|
80
80
|
* Portable project-relative path to a directory whose direct children are Agent Skills.
|
|
81
81
|
* Backslashes, absolute paths and parent traversal are rejected so the same config is safe on
|
|
82
82
|
* every supported platform.
|
|
83
83
|
*/
|
|
84
|
-
declare const skillDirectorySchema: z.ZodString;
|
|
85
|
-
declare const projectMetadataSchema: z.ZodObject<{
|
|
84
|
+
export declare const skillDirectorySchema: z.ZodString;
|
|
85
|
+
export declare const projectMetadataSchema: z.ZodObject<{
|
|
86
86
|
id: z.ZodString;
|
|
87
87
|
name: z.ZodString;
|
|
88
88
|
description: z.ZodOptional<z.ZodString>;
|
|
@@ -91,13 +91,13 @@ declare const projectMetadataSchema: z.ZodObject<{
|
|
|
91
91
|
mcp: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
92
92
|
owns: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
93
93
|
}, z.core.$strict>;
|
|
94
|
-
declare const projectRelationTypeSchema: z.ZodEnum<{
|
|
94
|
+
export declare const projectRelationTypeSchema: z.ZodEnum<{
|
|
95
95
|
uses: "uses";
|
|
96
96
|
integrates: "integrates";
|
|
97
97
|
consumes: "consumes";
|
|
98
98
|
extends: "extends";
|
|
99
99
|
}>;
|
|
100
|
-
declare const projectRelationSchema: z.ZodObject<{
|
|
100
|
+
export declare const projectRelationSchema: z.ZodObject<{
|
|
101
101
|
id: z.ZodString;
|
|
102
102
|
name: z.ZodString;
|
|
103
103
|
type: z.ZodEnum<{
|
|
@@ -113,7 +113,7 @@ declare const projectRelationSchema: z.ZodObject<{
|
|
|
113
113
|
owns: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
114
114
|
guidance: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
115
115
|
}, z.core.$strict>;
|
|
116
|
-
declare const projectContextSchema: z.ZodObject<{
|
|
116
|
+
export declare const projectContextSchema: z.ZodObject<{
|
|
117
117
|
commands: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
|
|
118
118
|
command: z.ZodString;
|
|
119
119
|
cwd: z.ZodDefault<z.ZodString>;
|
|
@@ -125,7 +125,7 @@ declare const projectContextSchema: z.ZodObject<{
|
|
|
125
125
|
constraints: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
126
126
|
}, z.core.$strict>;
|
|
127
127
|
/** The `.agentyx.json` project configuration. */
|
|
128
|
-
declare const agentyxConfigSchema: z.ZodObject<{
|
|
128
|
+
export declare const agentyxConfigSchema: z.ZodObject<{
|
|
129
129
|
$schema: z.ZodOptional<z.ZodString>;
|
|
130
130
|
packs: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
131
131
|
enable: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
@@ -251,15 +251,15 @@ type ProjectRelation = z.infer<typeof projectRelationSchema>;
|
|
|
251
251
|
type ProjectContext = z.infer<typeof projectContextSchema>;
|
|
252
252
|
//#endregion
|
|
253
253
|
//#region src/config/loader.d.ts
|
|
254
|
-
declare const AGENTYX_CONFIG_FILENAME = ".agentyx.json";
|
|
254
|
+
export declare const AGENTYX_CONFIG_FILENAME = ".agentyx.json";
|
|
255
255
|
/** The absolute path `.agentyx.json` is read from for a given project. */
|
|
256
|
-
declare function agentyxConfigPath(projectPath?: string): string;
|
|
256
|
+
export declare function agentyxConfigPath(projectPath?: string): string;
|
|
257
257
|
/**
|
|
258
258
|
* Validates an already-parsed configuration document.
|
|
259
259
|
*
|
|
260
260
|
* @throws {AgentyxConfigValidationError} when the document violates the schema.
|
|
261
261
|
*/
|
|
262
|
-
declare function parseAgentyxConfig(value: unknown, filePath?: string): AgentyxConfig;
|
|
262
|
+
export declare function parseAgentyxConfig(value: unknown, filePath?: string): AgentyxConfig;
|
|
263
263
|
/**
|
|
264
264
|
* Reads and validates `.agentyx.json` from `projectPath`.
|
|
265
265
|
*
|
|
@@ -270,22 +270,22 @@ declare function parseAgentyxConfig(value: unknown, filePath?: string): AgentyxC
|
|
|
270
270
|
* @throws {AgentyxConfigParseError} when the file is not valid JSON.
|
|
271
271
|
* @throws {AgentyxConfigValidationError} when the document violates the schema.
|
|
272
272
|
*/
|
|
273
|
-
declare function loadAgentyxConfig(projectPath?: string): Promise<AgentyxConfig>;
|
|
273
|
+
export declare function loadAgentyxConfig(projectPath?: string): Promise<AgentyxConfig>;
|
|
274
274
|
//#endregion
|
|
275
275
|
//#region src/project-graph.d.ts
|
|
276
|
-
declare class ProjectGraphNotConfiguredError extends AgentyxError {
|
|
276
|
+
export declare class ProjectGraphNotConfiguredError extends AgentyxError {
|
|
277
277
|
constructor();
|
|
278
278
|
}
|
|
279
279
|
interface ProjectGraph {
|
|
280
280
|
readonly project: ProjectMetadata;
|
|
281
281
|
readonly relations: readonly ProjectRelation[];
|
|
282
282
|
}
|
|
283
|
-
declare function createProjectGraph(project: ProjectMetadata, relations: readonly ProjectRelation[]): ProjectGraph;
|
|
284
|
-
declare function renderProjectGraphText(graph: ProjectGraph): string;
|
|
285
|
-
declare function renderProjectGraphJson(graph: ProjectGraph): string;
|
|
286
|
-
declare function renderProjectGraphMermaid(graph: ProjectGraph): string;
|
|
287
|
-
declare function renderProjectGraphSvg(graph: ProjectGraph): string;
|
|
288
|
-
declare function findProjectCapabilityOwners(graph: ProjectGraph, capability: string): {
|
|
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
289
|
capability: string;
|
|
290
290
|
currentProject: {
|
|
291
291
|
id: string;
|
|
@@ -310,8 +310,8 @@ declare function findProjectCapabilityOwners(graph: ProjectGraph, capability: st
|
|
|
310
310
|
};
|
|
311
311
|
//#endregion
|
|
312
312
|
//#region src/pack/schema.d.ts
|
|
313
|
-
declare const PACK_CATEGORIES: readonly ["engineering", "language", "framework", "efficiency", "workflow"];
|
|
314
|
-
declare const packCategorySchema: z.ZodEnum<{
|
|
313
|
+
export declare const PACK_CATEGORIES: readonly ["engineering", "language", "framework", "efficiency", "workflow"];
|
|
314
|
+
export declare const packCategorySchema: z.ZodEnum<{
|
|
315
315
|
engineering: "engineering";
|
|
316
316
|
language: "language";
|
|
317
317
|
framework: "framework";
|
|
@@ -322,9 +322,9 @@ declare const packCategorySchema: z.ZodEnum<{
|
|
|
322
322
|
* Pack names are plain identifiers. They are intentionally not constrained to
|
|
323
323
|
* a closed list so that external registries can contribute packs later.
|
|
324
324
|
*/
|
|
325
|
-
declare const packNameSchema: z.ZodString;
|
|
325
|
+
export declare const packNameSchema: z.ZodString;
|
|
326
326
|
/** A pack is a composable provider-neutral capability bundle. */
|
|
327
|
-
declare const packDefinitionSchema: z.ZodObject<{
|
|
327
|
+
export declare const packDefinitionSchema: z.ZodObject<{
|
|
328
328
|
name: z.ZodString;
|
|
329
329
|
category: z.ZodDefault<z.ZodEnum<{
|
|
330
330
|
engineering: "engineering";
|
|
@@ -407,21 +407,21 @@ type PackDefinitionInput = z.input<typeof packDefinitionSchema>;
|
|
|
407
407
|
*/
|
|
408
408
|
type PackRegistry = ReadonlyMap<string, PackDefinition>;
|
|
409
409
|
/** Validates definitions and indexes them by name. */
|
|
410
|
-
declare function createPackRegistry(definitions: Iterable<PackDefinitionInput>): PackRegistry;
|
|
410
|
+
export declare function createPackRegistry(definitions: Iterable<PackDefinitionInput>): PackRegistry;
|
|
411
411
|
/**
|
|
412
412
|
* The packs Agentyx ships with, expressed as data. Relationships live here, not
|
|
413
413
|
* in the resolver.
|
|
414
414
|
*/
|
|
415
|
-
declare const builtInPacks: readonly PackDefinitionInput[];
|
|
415
|
+
export declare const builtInPacks: readonly PackDefinitionInput[];
|
|
416
416
|
/** The registry used by default when no explicit registry is supplied. */
|
|
417
|
-
declare const builtInPackRegistry: PackRegistry;
|
|
417
|
+
export declare const builtInPackRegistry: PackRegistry;
|
|
418
418
|
//#endregion
|
|
419
419
|
//#region src/skill/schema.d.ts
|
|
420
420
|
/**
|
|
421
421
|
* A Skill is reusable instruction text for a coding agent. It is deliberately
|
|
422
422
|
* provider-independent: nothing here says how or where a provider installs it.
|
|
423
423
|
*/
|
|
424
|
-
declare const skillDefinitionSchema: z.ZodObject<{
|
|
424
|
+
export declare const skillDefinitionSchema: z.ZodObject<{
|
|
425
425
|
name: z.ZodString;
|
|
426
426
|
description: z.ZodString;
|
|
427
427
|
content: z.ZodString;
|
|
@@ -467,7 +467,7 @@ interface SkillRegistry {
|
|
|
467
467
|
* @throws {DuplicateSkillError} when two sources share a name.
|
|
468
468
|
* @throws {InvalidSkillError} when a source name is not a valid skill name.
|
|
469
469
|
*/
|
|
470
|
-
declare function createSkillRegistry(sources: Iterable<SkillSource>): SkillRegistry;
|
|
470
|
+
export declare function createSkillRegistry(sources: Iterable<SkillSource>): SkillRegistry;
|
|
471
471
|
//#endregion
|
|
472
472
|
//#region src/config/project.d.ts
|
|
473
473
|
/** A validated project configuration plus the registries it owns. */
|
|
@@ -484,20 +484,20 @@ interface AgentyxProject {
|
|
|
484
484
|
* the project even through symlinks. Loading is local-only: this function never clones a repository
|
|
485
485
|
* or accesses the network.
|
|
486
486
|
*/
|
|
487
|
-
declare function loadAgentyxProject(projectPath?: string): Promise<AgentyxProject>;
|
|
487
|
+
export declare function loadAgentyxProject(projectPath?: string): Promise<AgentyxProject>;
|
|
488
488
|
//#endregion
|
|
489
489
|
//#region src/hook/schema.d.ts
|
|
490
|
-
declare const HOOK_ACTIVATION_LEVELS: readonly ["default", "optional"];
|
|
491
|
-
declare const hookActivationLevelSchema: z.ZodEnum<{
|
|
490
|
+
export declare const HOOK_ACTIVATION_LEVELS: readonly ["default", "optional"];
|
|
491
|
+
export declare const hookActivationLevelSchema: z.ZodEnum<{
|
|
492
492
|
default: "default";
|
|
493
493
|
optional: "optional";
|
|
494
494
|
}>;
|
|
495
|
-
declare const HOOK_EVENTS: readonly ["SessionStart"];
|
|
496
|
-
declare const hookEventSchema: z.ZodEnum<{
|
|
495
|
+
export declare const HOOK_EVENTS: readonly ["SessionStart"];
|
|
496
|
+
export declare const hookEventSchema: z.ZodEnum<{
|
|
497
497
|
SessionStart: "SessionStart";
|
|
498
498
|
}>;
|
|
499
|
-
declare const hookNameSchema: z.ZodString;
|
|
500
|
-
declare const hookDefinitionSchema: z.ZodObject<{
|
|
499
|
+
export declare const hookNameSchema: z.ZodString;
|
|
500
|
+
export declare const hookDefinitionSchema: z.ZodObject<{
|
|
501
501
|
name: z.ZodString;
|
|
502
502
|
description: z.ZodString;
|
|
503
503
|
event: z.ZodEnum<{
|
|
@@ -506,7 +506,7 @@ declare const hookDefinitionSchema: z.ZodObject<{
|
|
|
506
506
|
command: z.ZodString;
|
|
507
507
|
args: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
508
508
|
}, z.core.$strict>;
|
|
509
|
-
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<{
|
|
510
510
|
name: z.ZodString;
|
|
511
511
|
activation: z.ZodDefault<z.ZodEnum<{
|
|
512
512
|
default: "default";
|
|
@@ -548,24 +548,24 @@ interface HookRegistry {
|
|
|
548
548
|
listMetadata(): readonly HookMetadata[];
|
|
549
549
|
get(name: string): HookDefinition;
|
|
550
550
|
}
|
|
551
|
-
declare function createHookRegistry(sources: Iterable<HookSource>): HookRegistry;
|
|
551
|
+
export declare function createHookRegistry(sources: Iterable<HookSource>): HookRegistry;
|
|
552
552
|
//#endregion
|
|
553
553
|
//#region src/mcp/schema.d.ts
|
|
554
|
-
declare const MCP_CAPABILITY_LEVELS: readonly ["default", "optional"];
|
|
555
|
-
declare const mcpCapabilityLevelSchema: z.ZodEnum<{
|
|
554
|
+
export declare const MCP_CAPABILITY_LEVELS: readonly ["default", "optional"];
|
|
555
|
+
export declare const mcpCapabilityLevelSchema: z.ZodEnum<{
|
|
556
556
|
default: "default";
|
|
557
557
|
optional: "optional";
|
|
558
558
|
}>;
|
|
559
|
-
declare const MCP_CONTEXT_COSTS: readonly ["low", "medium", "high"];
|
|
560
|
-
declare const mcpContextCostSchema: z.ZodEnum<{
|
|
559
|
+
export declare const MCP_CONTEXT_COSTS: readonly ["low", "medium", "high"];
|
|
560
|
+
export declare const mcpContextCostSchema: z.ZodEnum<{
|
|
561
561
|
low: "low";
|
|
562
562
|
medium: "medium";
|
|
563
563
|
high: "high";
|
|
564
564
|
}>;
|
|
565
|
-
declare const mcpEnvReferenceSchema: z.ZodObject<{
|
|
565
|
+
export declare const mcpEnvReferenceSchema: z.ZodObject<{
|
|
566
566
|
fromEnv: z.ZodString;
|
|
567
567
|
}, z.core.$strict>;
|
|
568
|
-
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<{
|
|
569
569
|
name: z.ZodString;
|
|
570
570
|
activation: z.ZodDefault<z.ZodEnum<{
|
|
571
571
|
default: "default";
|
|
@@ -584,7 +584,7 @@ declare const mcpServerReferenceSchema: z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly
|
|
|
584
584
|
optional: "optional";
|
|
585
585
|
}>;
|
|
586
586
|
}, z.core.$strict>>;
|
|
587
|
-
declare const mcpServerDefinitionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
587
|
+
export declare const mcpServerDefinitionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
588
588
|
name: z.ZodString;
|
|
589
589
|
description: z.ZodString;
|
|
590
590
|
contextCost: z.ZodOptional<z.ZodEnum<{
|
|
@@ -646,16 +646,16 @@ interface McpServerRegistry {
|
|
|
646
646
|
listMetadata(): readonly McpServerMetadata[];
|
|
647
647
|
get(name: string): McpServerDefinition;
|
|
648
648
|
}
|
|
649
|
-
declare function createMcpServerRegistry(sources: Iterable<McpServerSource>): McpServerRegistry;
|
|
649
|
+
export declare function createMcpServerRegistry(sources: Iterable<McpServerSource>): McpServerRegistry;
|
|
650
650
|
//#endregion
|
|
651
651
|
//#region src/tool/schema.d.ts
|
|
652
|
-
declare const TOOL_ACTIVATION_LEVELS: readonly ["default", "optional"];
|
|
653
|
-
declare const toolActivationLevelSchema: z.ZodEnum<{
|
|
652
|
+
export declare const TOOL_ACTIVATION_LEVELS: readonly ["default", "optional"];
|
|
653
|
+
export declare const toolActivationLevelSchema: z.ZodEnum<{
|
|
654
654
|
default: "default";
|
|
655
655
|
optional: "optional";
|
|
656
656
|
}>;
|
|
657
|
-
declare const toolNameSchema: z.ZodString;
|
|
658
|
-
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<{
|
|
659
659
|
name: z.ZodString;
|
|
660
660
|
activation: z.ZodDefault<z.ZodEnum<{
|
|
661
661
|
default: "default";
|
|
@@ -674,7 +674,7 @@ declare const toolReferenceSchema: z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.Zo
|
|
|
674
674
|
optional: "optional";
|
|
675
675
|
}>;
|
|
676
676
|
}, z.core.$strict>>;
|
|
677
|
-
declare const toolDefinitionSchema: z.ZodObject<{
|
|
677
|
+
export declare const toolDefinitionSchema: z.ZodObject<{
|
|
678
678
|
name: z.ZodString;
|
|
679
679
|
description: z.ZodString;
|
|
680
680
|
kind: z.ZodLiteral<"executable">;
|
|
@@ -706,7 +706,7 @@ interface ToolRegistry {
|
|
|
706
706
|
listMetadata(): readonly ToolMetadata[];
|
|
707
707
|
get(name: string): ToolDefinition;
|
|
708
708
|
}
|
|
709
|
-
declare function createToolRegistry(sources: Iterable<ToolSource>): ToolRegistry;
|
|
709
|
+
export declare function createToolRegistry(sources: Iterable<ToolSource>): ToolRegistry;
|
|
710
710
|
//#endregion
|
|
711
711
|
//#region src/config/resolver.d.ts
|
|
712
712
|
/** A project configuration with its selected packs resolved. */
|
|
@@ -736,39 +736,39 @@ interface ResolvedAgentyxConfig {
|
|
|
736
736
|
* @throws {UnknownPackError} when a configured pack is missing.
|
|
737
737
|
* @throws {UnknownSkillError} when a pack references an unknown skill.
|
|
738
738
|
*/
|
|
739
|
-
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;
|
|
740
740
|
//#endregion
|
|
741
741
|
//#region src/hook/built-in.d.ts
|
|
742
|
-
declare const builtInHookRegistry: HookRegistry;
|
|
743
|
-
declare const builtInHookNames: readonly string[];
|
|
742
|
+
export declare const builtInHookRegistry: HookRegistry;
|
|
743
|
+
export declare const builtInHookNames: readonly string[];
|
|
744
744
|
//#endregion
|
|
745
745
|
//#region src/hook/errors.d.ts
|
|
746
|
-
declare class UnknownHookError extends AgentyxError {
|
|
746
|
+
export declare class UnknownHookError extends AgentyxError {
|
|
747
747
|
readonly hookName: string;
|
|
748
748
|
readonly requiredBy: string | undefined;
|
|
749
749
|
readonly knownHooks: readonly string[];
|
|
750
750
|
constructor(hookName: string, requiredBy: string | undefined, knownHooks: readonly string[]);
|
|
751
751
|
}
|
|
752
|
-
declare class DuplicateHookError extends AgentyxError {
|
|
752
|
+
export declare class DuplicateHookError extends AgentyxError {
|
|
753
753
|
readonly hookName: string;
|
|
754
754
|
constructor(hookName: string);
|
|
755
755
|
}
|
|
756
|
-
declare class InvalidHookError extends AgentyxError {
|
|
756
|
+
export declare class InvalidHookError extends AgentyxError {
|
|
757
757
|
readonly origin: string;
|
|
758
758
|
readonly reason: string;
|
|
759
759
|
constructor(origin: string, reason: string | ZodError, options?: ErrorOptions);
|
|
760
760
|
}
|
|
761
761
|
//#endregion
|
|
762
762
|
//#region src/hook/resolver.d.ts
|
|
763
|
-
declare function collectPackHookReferences(resolvedPacks: readonly string[], packRegistry: PackRegistry, hookRegistry: HookRegistry): HookReference[];
|
|
764
|
-
declare function filterEffectiveHooks(hooks: readonly HookReference[], enabledCapabilities: readonly string[]): string[];
|
|
765
|
-
declare function collectPackHooks(resolvedPacks: readonly string[], packRegistry: PackRegistry, hookRegistry: HookRegistry, enabledCapabilities?: readonly string[]): string[];
|
|
766
|
-
declare function resolvePackHookReferences(requestedPacks: readonly string[], packRegistry?: PackRegistry, hookRegistry?: HookRegistry): HookReference[];
|
|
767
|
-
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[];
|
|
768
768
|
//#endregion
|
|
769
769
|
//#region src/manifest/errors.d.ts
|
|
770
770
|
/** Raised when `.agentyx.lock.json` is not valid JSON. */
|
|
771
|
-
declare class AgentyxManifestParseError extends AgentyxError {
|
|
771
|
+
export declare class AgentyxManifestParseError extends AgentyxError {
|
|
772
772
|
readonly filePath: string;
|
|
773
773
|
constructor(filePath: string, reason: string, options?: ErrorOptions);
|
|
774
774
|
}
|
|
@@ -780,7 +780,7 @@ declare class AgentyxManifestParseError extends AgentyxError {
|
|
|
780
780
|
* allowed to overwrite and delete, so guessing at a damaged one would be
|
|
781
781
|
* guessing about destructive operations.
|
|
782
782
|
*/
|
|
783
|
-
declare class AgentyxManifestValidationError extends AgentyxError {
|
|
783
|
+
export declare class AgentyxManifestValidationError extends AgentyxError {
|
|
784
784
|
readonly issues: readonly AgentyxIssue[];
|
|
785
785
|
readonly filePath: string | undefined;
|
|
786
786
|
constructor(error: ZodError, filePath?: string);
|
|
@@ -794,9 +794,9 @@ declare class AgentyxManifestValidationError extends AgentyxError {
|
|
|
794
794
|
* reinterpreted, because acting on a half-understood record of managed files is
|
|
795
795
|
* how an installer deletes something it should not.
|
|
796
796
|
*/
|
|
797
|
-
declare const INSTALL_MANIFEST_VERSION = 1;
|
|
797
|
+
export declare const INSTALL_MANIFEST_VERSION = 1;
|
|
798
798
|
/** A `SKILL.md` file Agentyx wrote, owned entirely by Agentyx. */
|
|
799
|
-
declare const skillManifestEntrySchema: z.ZodObject<{
|
|
799
|
+
export declare const skillManifestEntrySchema: z.ZodObject<{
|
|
800
800
|
kind: z.ZodLiteral<"skill">;
|
|
801
801
|
path: z.ZodString;
|
|
802
802
|
skill: z.ZodString;
|
|
@@ -811,7 +811,7 @@ declare const skillManifestEntrySchema: z.ZodObject<{
|
|
|
811
811
|
* `created` says whether the file existed before Agentyx first wrote it, which
|
|
812
812
|
* is the only thing that makes removing the file itself safe.
|
|
813
813
|
*/
|
|
814
|
-
declare const mcpManifestEntrySchema: z.ZodObject<{
|
|
814
|
+
export declare const mcpManifestEntrySchema: z.ZodObject<{
|
|
815
815
|
kind: z.ZodLiteral<"mcp">;
|
|
816
816
|
path: z.ZodString;
|
|
817
817
|
servers: z.ZodArray<z.ZodString>;
|
|
@@ -826,7 +826,7 @@ declare const mcpManifestEntrySchema: z.ZodObject<{
|
|
|
826
826
|
* user, so the entry records the hook names Agentyx added rather than
|
|
827
827
|
* claiming the whole document.
|
|
828
828
|
*/
|
|
829
|
-
declare const hookManifestEntrySchema: z.ZodObject<{
|
|
829
|
+
export declare const hookManifestEntrySchema: z.ZodObject<{
|
|
830
830
|
kind: z.ZodLiteral<"hook">;
|
|
831
831
|
path: z.ZodString;
|
|
832
832
|
hooks: z.ZodArray<z.ZodString>;
|
|
@@ -834,7 +834,7 @@ declare const hookManifestEntrySchema: z.ZodObject<{
|
|
|
834
834
|
hash: z.ZodString;
|
|
835
835
|
created: z.ZodBoolean;
|
|
836
836
|
}, z.core.$strict>;
|
|
837
|
-
declare const installManifestEntrySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
837
|
+
export declare const installManifestEntrySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
838
838
|
kind: z.ZodLiteral<"skill">;
|
|
839
839
|
path: z.ZodString;
|
|
840
840
|
skill: z.ZodString;
|
|
@@ -856,7 +856,7 @@ declare const installManifestEntrySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
|
856
856
|
created: z.ZodBoolean;
|
|
857
857
|
}, z.core.$strict>], "kind">;
|
|
858
858
|
/** The `.agentyx.lock.json` record of everything Agentyx installed into a project. */
|
|
859
|
-
declare const installManifestSchema: z.ZodObject<{
|
|
859
|
+
export declare const installManifestSchema: z.ZodObject<{
|
|
860
860
|
version: z.ZodLiteral<1>;
|
|
861
861
|
entries: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
862
862
|
kind: z.ZodLiteral<"skill">;
|
|
@@ -890,11 +890,11 @@ type InstallManifest = z.infer<typeof installManifestSchema>;
|
|
|
890
890
|
type InstallManifestInput = z.input<typeof installManifestSchema>;
|
|
891
891
|
//#endregion
|
|
892
892
|
//#region src/manifest/io.d.ts
|
|
893
|
-
declare const AGENTYX_MANIFEST_FILENAME = ".agentyx.lock.json";
|
|
893
|
+
export declare const AGENTYX_MANIFEST_FILENAME = ".agentyx.lock.json";
|
|
894
894
|
/** The absolute path `.agentyx.lock.json` is read from for a given project. */
|
|
895
|
-
declare function agentyxManifestPath(projectPath?: string): string;
|
|
895
|
+
export declare function agentyxManifestPath(projectPath?: string): string;
|
|
896
896
|
/** A manifest that claims nothing — what a project has before its first install. */
|
|
897
|
-
declare function emptyInstallManifest(): InstallManifest;
|
|
897
|
+
export declare function emptyInstallManifest(): InstallManifest;
|
|
898
898
|
/**
|
|
899
899
|
* The SHA-256 digest Agentyx records for managed content.
|
|
900
900
|
*
|
|
@@ -902,13 +902,13 @@ declare function emptyInstallManifest(): InstallManifest;
|
|
|
902
902
|
* this and may replace it" from "someone else owns this file", so it is
|
|
903
903
|
* computed over the exact bytes written, never over a normalised form.
|
|
904
904
|
*/
|
|
905
|
-
declare function hashContent(content: string): string;
|
|
905
|
+
export declare function hashContent(content: string): string;
|
|
906
906
|
/**
|
|
907
907
|
* Validates an already-parsed manifest document.
|
|
908
908
|
*
|
|
909
909
|
* @throws {AgentyxManifestValidationError} when the document violates the schema.
|
|
910
910
|
*/
|
|
911
|
-
declare function parseInstallManifest(value: unknown, filePath?: string): InstallManifest;
|
|
911
|
+
export declare function parseInstallManifest(value: unknown, filePath?: string): InstallManifest;
|
|
912
912
|
/**
|
|
913
913
|
* Reads `.agentyx.lock.json` from `projectPath`.
|
|
914
914
|
*
|
|
@@ -920,7 +920,7 @@ declare function parseInstallManifest(value: unknown, filePath?: string): Instal
|
|
|
920
920
|
* @throws {AgentyxManifestParseError} when the file is not valid JSON.
|
|
921
921
|
* @throws {AgentyxManifestValidationError} when the document violates the schema.
|
|
922
922
|
*/
|
|
923
|
-
declare function loadInstallManifest(projectPath?: string): Promise<InstallManifest>;
|
|
923
|
+
export declare function loadInstallManifest(projectPath?: string): Promise<InstallManifest>;
|
|
924
924
|
/**
|
|
925
925
|
* Serialises a manifest for writing.
|
|
926
926
|
*
|
|
@@ -929,63 +929,63 @@ declare function loadInstallManifest(projectPath?: string): Promise<InstallManif
|
|
|
929
929
|
* diff. Writing is deliberately not done here — only the install executor
|
|
930
930
|
* touches the filesystem.
|
|
931
931
|
*/
|
|
932
|
-
declare function formatInstallManifest(manifest: InstallManifest): string;
|
|
932
|
+
export declare function formatInstallManifest(manifest: InstallManifest): string;
|
|
933
933
|
/**
|
|
934
934
|
* Indexes manifest entries by managed path.
|
|
935
935
|
*
|
|
936
936
|
* Every ownership question — may this file be overwritten, may it be deleted —
|
|
937
937
|
* is a lookup by path, so callers do not scan the list themselves.
|
|
938
938
|
*/
|
|
939
|
-
declare function manifestEntriesByPath(manifest: InstallManifest): ReadonlyMap<string, InstallManifestEntry>;
|
|
939
|
+
export declare function manifestEntriesByPath(manifest: InstallManifest): ReadonlyMap<string, InstallManifestEntry>;
|
|
940
940
|
//#endregion
|
|
941
941
|
//#region src/mcp/built-in.d.ts
|
|
942
|
-
declare const builtInMcpServerRegistry: McpServerRegistry;
|
|
943
|
-
declare const builtInMcpServerNames: readonly string[];
|
|
942
|
+
export declare const builtInMcpServerRegistry: McpServerRegistry;
|
|
943
|
+
export declare const builtInMcpServerNames: readonly string[];
|
|
944
944
|
//#endregion
|
|
945
945
|
//#region src/mcp/errors.d.ts
|
|
946
|
-
declare class UnknownMcpServerError extends AgentyxError {
|
|
946
|
+
export declare class UnknownMcpServerError extends AgentyxError {
|
|
947
947
|
readonly serverName: string;
|
|
948
948
|
readonly requiredBy: string | undefined;
|
|
949
949
|
readonly knownServers: readonly string[];
|
|
950
950
|
constructor(serverName: string, requiredBy: string | undefined, knownServers: readonly string[]);
|
|
951
951
|
}
|
|
952
|
-
declare class DuplicateMcpServerError extends AgentyxError {
|
|
952
|
+
export declare class DuplicateMcpServerError extends AgentyxError {
|
|
953
953
|
readonly serverName: string;
|
|
954
954
|
constructor(serverName: string);
|
|
955
955
|
}
|
|
956
|
-
declare class InvalidMcpServerError extends AgentyxError {
|
|
956
|
+
export declare class InvalidMcpServerError extends AgentyxError {
|
|
957
957
|
readonly origin: string;
|
|
958
958
|
readonly reason: string;
|
|
959
959
|
constructor(origin: string, reason: string | ZodError, options?: ErrorOptions);
|
|
960
960
|
}
|
|
961
961
|
//#endregion
|
|
962
962
|
//#region src/mcp/resolver.d.ts
|
|
963
|
-
declare function collectPackMcpServerReferences(resolvedPacks: readonly string[], packRegistry: PackRegistry, mcpRegistry: McpServerRegistry): McpServerReference[];
|
|
964
|
-
declare function filterEffectiveMcpServers(servers: readonly McpServerReference[], enabledCapabilities: readonly string[]): string[];
|
|
965
|
-
declare function collectPackMcpServers(resolvedPacks: readonly string[], packRegistry: PackRegistry, mcpRegistry: McpServerRegistry, enabledCapabilities?: readonly string[]): string[];
|
|
966
|
-
declare function resolvePackMcpServerReferences(requestedPacks: readonly string[], packRegistry?: PackRegistry, mcpRegistry?: McpServerRegistry): McpServerReference[];
|
|
967
|
-
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[];
|
|
968
968
|
//#endregion
|
|
969
969
|
//#region src/meta.d.ts
|
|
970
|
-
declare const agentyxCoreName = "agentyx-core";
|
|
971
|
-
declare function getCoreStatus(): string;
|
|
970
|
+
export declare const agentyxCoreName = "agentyx-core";
|
|
971
|
+
export declare function getCoreStatus(): string;
|
|
972
972
|
//#endregion
|
|
973
973
|
//#region src/pack/errors.d.ts
|
|
974
974
|
/** Raised when a requested pack is not present in the registry. */
|
|
975
|
-
declare class UnknownPackError extends AgentyxError {
|
|
975
|
+
export declare class UnknownPackError extends AgentyxError {
|
|
976
976
|
readonly packName: string;
|
|
977
977
|
readonly requiredBy: string | undefined;
|
|
978
978
|
readonly knownPacks: readonly string[];
|
|
979
979
|
constructor(packName: string, requiredBy: string | undefined, knownPacks: readonly string[]);
|
|
980
980
|
}
|
|
981
981
|
/** @deprecated Packs no longer inherit from other packs. */
|
|
982
|
-
declare class CircularPackDependencyError extends AgentyxError {
|
|
982
|
+
export declare class CircularPackDependencyError extends AgentyxError {
|
|
983
983
|
/** The cycle path, starting and ending with the same pack. */
|
|
984
984
|
readonly cycle: readonly string[];
|
|
985
985
|
constructor(cycle: readonly string[]);
|
|
986
986
|
}
|
|
987
987
|
/** Raised when a registry is built from definitions that reuse a pack name. */
|
|
988
|
-
declare class DuplicatePackError extends AgentyxError {
|
|
988
|
+
export declare class DuplicatePackError extends AgentyxError {
|
|
989
989
|
readonly packName: string;
|
|
990
990
|
constructor(packName: string);
|
|
991
991
|
}
|
|
@@ -999,10 +999,10 @@ declare class DuplicatePackError extends AgentyxError {
|
|
|
999
999
|
*
|
|
1000
1000
|
* @throws {UnknownPackError} when a requested pack is missing.
|
|
1001
1001
|
*/
|
|
1002
|
-
declare function resolvePacks(requestedPacks: readonly string[], registry?: PackRegistry): string[];
|
|
1002
|
+
export declare function resolvePacks(requestedPacks: readonly string[], registry?: PackRegistry): string[];
|
|
1003
1003
|
//#endregion
|
|
1004
1004
|
//#region src/project/signals.d.ts
|
|
1005
|
-
declare const PACKAGE_MANAGERS: readonly ["pnpm", "npm", "yarn", "bun"];
|
|
1005
|
+
export declare const PACKAGE_MANAGERS: readonly ["pnpm", "npm", "yarn", "bun"];
|
|
1006
1006
|
type PackageManagerName = (typeof PACKAGE_MANAGERS)[number];
|
|
1007
1007
|
interface PackageManagerDetection {
|
|
1008
1008
|
readonly name: PackageManagerName | undefined;
|
|
@@ -1032,6 +1032,17 @@ interface ContainerFileSignals {
|
|
|
1032
1032
|
interface CiFileSignals {
|
|
1033
1033
|
readonly githubActions: boolean;
|
|
1034
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
|
+
}
|
|
1035
1046
|
interface MonorepoSignal {
|
|
1036
1047
|
readonly detected: boolean;
|
|
1037
1048
|
readonly markers: readonly string[];
|
|
@@ -1057,6 +1068,7 @@ interface ProjectSignals {
|
|
|
1057
1068
|
readonly tsconfig: boolean;
|
|
1058
1069
|
};
|
|
1059
1070
|
readonly angular: TechnologyMatch | undefined;
|
|
1071
|
+
readonly rust: RustSignal;
|
|
1060
1072
|
readonly testFrameworks: readonly TechnologyMatch[];
|
|
1061
1073
|
readonly browserTesting: readonly TechnologyMatch[];
|
|
1062
1074
|
readonly observability: readonly TechnologyMatch[];
|
|
@@ -1071,15 +1083,15 @@ interface ProjectSignals {
|
|
|
1071
1083
|
};
|
|
1072
1084
|
}
|
|
1073
1085
|
/** Maximum directory entries visited by `scanRepositorySize`, regardless of match. */
|
|
1074
|
-
declare const REPOSITORY_SCAN_ENTRY_LIMIT = 5000;
|
|
1086
|
+
export declare const REPOSITORY_SCAN_ENTRY_LIMIT = 5000;
|
|
1075
1087
|
/** Gathers every project signal with a bounded, cheap set of reads. */
|
|
1076
|
-
declare function collectProjectSignals(projectDir: string): Promise<ProjectSignals>;
|
|
1088
|
+
export declare function collectProjectSignals(projectDir: string): Promise<ProjectSignals>;
|
|
1077
1089
|
/**
|
|
1078
1090
|
* Counts source-like files under a bounded traversal, ignoring dependency, VCS and build output
|
|
1079
1091
|
* directories. Stops after visiting `entryLimit` directory entries — cheap even on a monorepo — and
|
|
1080
1092
|
* reports `capped` so callers never mistake a partial scan for a complete one.
|
|
1081
1093
|
*/
|
|
1082
|
-
declare function scanRepositorySize(projectDir: string, options?: {
|
|
1094
|
+
export declare function scanRepositorySize(projectDir: string, options?: {
|
|
1083
1095
|
readonly entryLimit?: number;
|
|
1084
1096
|
}): Promise<RepositorySizeSignal>;
|
|
1085
1097
|
//#endregion
|
|
@@ -1096,20 +1108,20 @@ interface ProjectDetection {
|
|
|
1096
1108
|
* capabilities fit — that policy lives in `recommendCapabilities`, kept separate so each half stays
|
|
1097
1109
|
* independently testable.
|
|
1098
1110
|
*/
|
|
1099
|
-
declare function detectProject(projectDir: string): Promise<ProjectDetection>;
|
|
1100
|
-
declare function buildAgentyxConfig(input: {
|
|
1111
|
+
export declare function detectProject(projectDir: string): Promise<ProjectDetection>;
|
|
1112
|
+
export declare function buildAgentyxConfig(input: {
|
|
1101
1113
|
readonly packs: readonly string[];
|
|
1102
1114
|
readonly enable?: readonly string[];
|
|
1103
1115
|
readonly targets: readonly string[];
|
|
1104
1116
|
}): AgentyxConfigInput;
|
|
1105
|
-
declare function formatAgentyxConfig(config: AgentyxConfigInput): string;
|
|
1117
|
+
export declare function formatAgentyxConfig(config: AgentyxConfigInput): string;
|
|
1106
1118
|
//#endregion
|
|
1107
1119
|
//#region src/project/executable.d.ts
|
|
1108
1120
|
/** Whether `command` resolves to an executable file, via `PATH` unless it already contains a `/`. */
|
|
1109
|
-
declare function isExecutableOnPath(command: string): Promise<boolean>;
|
|
1121
|
+
export declare function isExecutableOnPath(command: string): Promise<boolean>;
|
|
1110
1122
|
//#endregion
|
|
1111
1123
|
//#region src/project/recommend.d.ts
|
|
1112
|
-
declare const RECOMMENDATION_CONFIDENCES: readonly ["high", "medium"];
|
|
1124
|
+
export declare const RECOMMENDATION_CONFIDENCES: readonly ["high", "medium"];
|
|
1113
1125
|
type RecommendationConfidence = (typeof RECOMMENDATION_CONFIDENCES)[number];
|
|
1114
1126
|
type RecommendationKind = "pack" | "capability";
|
|
1115
1127
|
/**
|
|
@@ -1138,8 +1150,8 @@ interface RecommendCapabilitiesOptions {
|
|
|
1138
1150
|
* These are approximate signals, not exact token accounting, and a monorepo is treated as already
|
|
1139
1151
|
* complex enough to lower the bar.
|
|
1140
1152
|
*/
|
|
1141
|
-
declare const CODEBASE_MEMORY_FILE_THRESHOLD = 2000;
|
|
1142
|
-
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;
|
|
1143
1155
|
/**
|
|
1144
1156
|
* Applies conservative, deterministic policy on top of `ProjectSignals`. This is the only place
|
|
1145
1157
|
* that turns an observed fact into a product suggestion — `ProjectSignals` stays fact-only so it
|
|
@@ -1148,7 +1160,7 @@ declare const CODEBASE_MEMORY_MONOREPO_FILE_THRESHOLD = 800;
|
|
|
1148
1160
|
* Never enables anything and never touches the filesystem: the caller decides what, if anything,
|
|
1149
1161
|
* to do with the result.
|
|
1150
1162
|
*/
|
|
1151
|
-
declare function recommendCapabilities(signals: ProjectSignals, options?: RecommendCapabilitiesOptions): RecommendationResult;
|
|
1163
|
+
export declare function recommendCapabilities(signals: ProjectSignals, options?: RecommendCapabilitiesOptions): RecommendationResult;
|
|
1152
1164
|
//#endregion
|
|
1153
1165
|
//#region src/skill/built-in.d.ts
|
|
1154
1166
|
/**
|
|
@@ -1156,9 +1168,9 @@ declare function recommendCapabilities(signals: ProjectSignals, options?: Recomm
|
|
|
1156
1168
|
* `packages/core/skills`, and knowing them without touching the filesystem is
|
|
1157
1169
|
* what lets pack resolution validate references without reading any body.
|
|
1158
1170
|
*/
|
|
1159
|
-
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"];
|
|
1160
1172
|
/** The registry used by default when no explicit registry is supplied. */
|
|
1161
|
-
declare const builtInSkillRegistry: SkillRegistry;
|
|
1173
|
+
export declare const builtInSkillRegistry: SkillRegistry;
|
|
1162
1174
|
//#endregion
|
|
1163
1175
|
//#region src/skill/errors.d.ts
|
|
1164
1176
|
/**
|
|
@@ -1167,7 +1179,7 @@ declare const builtInSkillRegistry: SkillRegistry;
|
|
|
1167
1179
|
* The offending name is exposed as `skillName`; `pack` stays the JS pack
|
|
1168
1180
|
* trace inherited from `Error`.
|
|
1169
1181
|
*/
|
|
1170
|
-
declare class UnknownSkillError extends AgentyxError {
|
|
1182
|
+
export declare class UnknownSkillError extends AgentyxError {
|
|
1171
1183
|
readonly skillName: string;
|
|
1172
1184
|
/** The pack that declared the skill, when the failure came from resolution. */
|
|
1173
1185
|
readonly requiredBy: string | undefined;
|
|
@@ -1175,7 +1187,7 @@ declare class UnknownSkillError extends AgentyxError {
|
|
|
1175
1187
|
constructor(skillName: string, requiredBy: string | undefined, knownSkills: readonly string[]);
|
|
1176
1188
|
}
|
|
1177
1189
|
/** Raised when a registry is built from sources that reuse a skill name. */
|
|
1178
|
-
declare class DuplicateSkillError extends AgentyxError {
|
|
1190
|
+
export declare class DuplicateSkillError extends AgentyxError {
|
|
1179
1191
|
readonly skillName: string;
|
|
1180
1192
|
constructor(skillName: string);
|
|
1181
1193
|
}
|
|
@@ -1186,7 +1198,7 @@ declare class DuplicateSkillError extends AgentyxError {
|
|
|
1186
1198
|
* Built-in skills ship with Agentyx, so this is a programmer error rather than
|
|
1187
1199
|
* something a user can fix in their project.
|
|
1188
1200
|
*/
|
|
1189
|
-
declare class InvalidSkillError extends AgentyxError {
|
|
1201
|
+
export declare class InvalidSkillError extends AgentyxError {
|
|
1190
1202
|
/** Where the skill came from: a file path, or a label for an in-memory source. */
|
|
1191
1203
|
readonly origin: string;
|
|
1192
1204
|
readonly reason: string;
|
|
@@ -1215,7 +1227,7 @@ declare class InvalidSkillError extends AgentyxError {
|
|
|
1215
1227
|
*
|
|
1216
1228
|
* @throws {InvalidSkillError} when the frontmatter or the resulting skill is invalid.
|
|
1217
1229
|
*/
|
|
1218
|
-
declare function parseSkillMarkdown(markdown: string, origin: string): SkillDefinition;
|
|
1230
|
+
export declare function parseSkillMarkdown(markdown: string, origin: string): SkillDefinition;
|
|
1219
1231
|
/**
|
|
1220
1232
|
* Renders a skill as canonical `SKILL.md` text — the inverse of
|
|
1221
1233
|
* `parseSkillMarkdown`, and the single representation every consumer installs.
|
|
@@ -1232,7 +1244,7 @@ declare function parseSkillMarkdown(markdown: string, origin: string): SkillDefi
|
|
|
1232
1244
|
* description cannot be represented in the flat frontmatter subset the parser
|
|
1233
1245
|
* accepts.
|
|
1234
1246
|
*/
|
|
1235
|
-
declare function formatSkillMarkdown(skill: SkillDefinitionInput): string;
|
|
1247
|
+
export declare function formatSkillMarkdown(skill: SkillDefinitionInput): string;
|
|
1236
1248
|
//#endregion
|
|
1237
1249
|
//#region src/skill/resolver.d.ts
|
|
1238
1250
|
/**
|
|
@@ -1245,32 +1257,32 @@ declare function formatSkillMarkdown(skill: SkillDefinitionInput): string;
|
|
|
1245
1257
|
* @throws {UnknownPackError} when a requested pack is missing.
|
|
1246
1258
|
* @throws {UnknownSkillError} when a pack references a skill the registry lacks.
|
|
1247
1259
|
*/
|
|
1248
|
-
declare function resolvePackSkills(requestedPacks: readonly string[], packRegistry?: PackRegistry, skillRegistry?: SkillRegistry): string[];
|
|
1260
|
+
export declare function resolvePackSkills(requestedPacks: readonly string[], packRegistry?: PackRegistry, skillRegistry?: SkillRegistry): string[];
|
|
1249
1261
|
//#endregion
|
|
1250
1262
|
//#region src/source/errors.d.ts
|
|
1251
|
-
declare class DuplicateTrustedSourceError extends AgentyxError {
|
|
1263
|
+
export declare class DuplicateTrustedSourceError extends AgentyxError {
|
|
1252
1264
|
readonly sourceName: string;
|
|
1253
1265
|
constructor(sourceName: string);
|
|
1254
1266
|
}
|
|
1255
|
-
declare class UnknownTrustedSourceError extends AgentyxError {
|
|
1267
|
+
export declare class UnknownTrustedSourceError extends AgentyxError {
|
|
1256
1268
|
readonly sourceName: string;
|
|
1257
1269
|
readonly knownSources: readonly string[];
|
|
1258
1270
|
constructor(sourceName: string, knownSources: readonly string[]);
|
|
1259
1271
|
}
|
|
1260
|
-
declare class TrustedSourceLoadError extends AgentyxError {
|
|
1272
|
+
export declare class TrustedSourceLoadError extends AgentyxError {
|
|
1261
1273
|
readonly sourceName: string;
|
|
1262
1274
|
constructor(sourceName: string, reason: string, options?: ErrorOptions);
|
|
1263
1275
|
}
|
|
1264
1276
|
//#endregion
|
|
1265
1277
|
//#region src/source/schema.d.ts
|
|
1266
|
-
declare const trustedSourceNameSchema: z.ZodString;
|
|
1267
|
-
declare const trustedSourcePathSchema: z.ZodString;
|
|
1268
|
-
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<{
|
|
1269
1281
|
name: z.ZodString;
|
|
1270
1282
|
path: z.ZodString;
|
|
1271
1283
|
ref: z.ZodString;
|
|
1272
1284
|
}, z.core.$strict>;
|
|
1273
|
-
declare const trustedSourceDefinitionSchema: z.ZodObject<{
|
|
1285
|
+
export declare const trustedSourceDefinitionSchema: z.ZodObject<{
|
|
1274
1286
|
name: z.ZodString;
|
|
1275
1287
|
displayName: z.ZodString;
|
|
1276
1288
|
repository: z.ZodString;
|
|
@@ -1284,7 +1296,7 @@ declare const trustedSourceDefinitionSchema: z.ZodObject<{
|
|
|
1284
1296
|
}>;
|
|
1285
1297
|
installNote: z.ZodString;
|
|
1286
1298
|
}, z.core.$strict>;
|
|
1287
|
-
declare const codexPluginManifestSchema: z.ZodObject<{
|
|
1299
|
+
export declare const codexPluginManifestSchema: z.ZodObject<{
|
|
1288
1300
|
name: z.ZodString;
|
|
1289
1301
|
version: z.ZodString;
|
|
1290
1302
|
description: z.ZodString;
|
|
@@ -1292,7 +1304,7 @@ declare const codexPluginManifestSchema: z.ZodObject<{
|
|
|
1292
1304
|
license: z.ZodString;
|
|
1293
1305
|
skills: z.ZodString;
|
|
1294
1306
|
}, z.core.$loose>;
|
|
1295
|
-
declare const trustedSourceSkillSummarySchema: z.ZodObject<{
|
|
1307
|
+
export declare const trustedSourceSkillSummarySchema: z.ZodObject<{
|
|
1296
1308
|
name: z.ZodString;
|
|
1297
1309
|
description: z.ZodString;
|
|
1298
1310
|
hasResources: z.ZodBoolean;
|
|
@@ -1313,39 +1325,39 @@ interface TrustedSourceInspection {
|
|
|
1313
1325
|
readonly installable: boolean;
|
|
1314
1326
|
readonly installNote: string;
|
|
1315
1327
|
}
|
|
1316
|
-
declare function inspectTrustedSource(projectPath: string, reference: TrustedSourceReference): Promise<TrustedSourceInspection>;
|
|
1328
|
+
export declare function inspectTrustedSource(projectPath: string, reference: TrustedSourceReference): Promise<TrustedSourceInspection>;
|
|
1317
1329
|
//#endregion
|
|
1318
1330
|
//#region src/source/registry.d.ts
|
|
1319
1331
|
type TrustedSourceRegistry = ReadonlyMap<string, TrustedSourceDefinition>;
|
|
1320
|
-
declare const knownTrustedSources: readonly TrustedSourceDefinition[];
|
|
1321
|
-
declare const knownTrustedSourceRegistry: TrustedSourceRegistry;
|
|
1322
|
-
declare function createTrustedSourceRegistry(definitions: Iterable<TrustedSourceDefinition>): TrustedSourceRegistry;
|
|
1323
|
-
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;
|
|
1324
1336
|
//#endregion
|
|
1325
1337
|
//#region src/tool/built-in.d.ts
|
|
1326
|
-
declare const builtInToolRegistry: ToolRegistry;
|
|
1327
|
-
declare const builtInToolNames: readonly string[];
|
|
1338
|
+
export declare const builtInToolRegistry: ToolRegistry;
|
|
1339
|
+
export declare const builtInToolNames: readonly string[];
|
|
1328
1340
|
//#endregion
|
|
1329
1341
|
//#region src/tool/errors.d.ts
|
|
1330
|
-
declare class UnknownToolError extends AgentyxError {
|
|
1342
|
+
export declare class UnknownToolError extends AgentyxError {
|
|
1331
1343
|
readonly toolName: string;
|
|
1332
1344
|
readonly requiredBy: string | undefined;
|
|
1333
1345
|
readonly knownTools: readonly string[];
|
|
1334
1346
|
constructor(toolName: string, requiredBy: string | undefined, knownTools: readonly string[]);
|
|
1335
1347
|
}
|
|
1336
|
-
declare class DuplicateToolError extends AgentyxError {
|
|
1348
|
+
export declare class DuplicateToolError extends AgentyxError {
|
|
1337
1349
|
readonly toolName: string;
|
|
1338
1350
|
constructor(toolName: string);
|
|
1339
1351
|
}
|
|
1340
|
-
declare class InvalidToolError extends AgentyxError {
|
|
1352
|
+
export declare class InvalidToolError extends AgentyxError {
|
|
1341
1353
|
constructor(origin: string, reason: unknown, options?: ErrorOptions);
|
|
1342
1354
|
}
|
|
1343
1355
|
//#endregion
|
|
1344
1356
|
//#region src/tool/resolver.d.ts
|
|
1345
|
-
declare function collectPackToolReferences(resolvedPacks: readonly string[], packRegistry: PackRegistry, toolRegistry: ToolRegistry): ToolReference[];
|
|
1346
|
-
declare function filterEffectiveTools(tools: readonly ToolReference[], enabledCapabilities: readonly string[]): string[];
|
|
1347
|
-
declare function resolvePackToolReferences(requestedPacks: readonly string[], packRegistry?: PackRegistry, toolRegistry?: ToolRegistry): ToolReference[];
|
|
1348
|
-
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[];
|
|
1349
1361
|
//#endregion
|
|
1350
|
-
export {
|
|
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 };
|
|
1351
1363
|
//# sourceMappingURL=index.d.mts.map
|