@cleocode/contracts 2026.4.110 → 2026.4.111
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.
|
@@ -14,15 +14,21 @@
|
|
|
14
14
|
/**
|
|
15
15
|
* Tier where an agent is installed or resolved from.
|
|
16
16
|
*
|
|
17
|
-
* - `project`
|
|
18
|
-
* - `global`
|
|
19
|
-
* - `packaged`
|
|
20
|
-
* - `fallback`
|
|
17
|
+
* - `project` — installed in the current project (`.cleo/agents/`)
|
|
18
|
+
* - `global` — installed at the user/global scope (`$XDG_DATA_HOME/cleo/agents/`)
|
|
19
|
+
* - `packaged` — bundled with the CLEO distribution
|
|
20
|
+
* - `fallback` — synthesized at resolve-time when no concrete `.cant` exists
|
|
21
|
+
* for the requested agentId but a bundled seed-agent file matches
|
|
22
|
+
* - `universal` — synthesized at resolve-time from the universal protocol
|
|
23
|
+
* base (`@cleocode/agents/cleo-subagent.cant`). Acts as the
|
|
24
|
+
* final safety net so classifier output never produces
|
|
25
|
+
* `E_AGENT_NOT_FOUND` when the base file is reachable.
|
|
26
|
+
* Added in v2026.4.111 (T1241 / D035).
|
|
21
27
|
*
|
|
22
|
-
* @task T897
|
|
23
|
-
* @epic T889
|
|
28
|
+
* @task T897 / T1241
|
|
29
|
+
* @epic T889 / T1232
|
|
24
30
|
*/
|
|
25
|
-
export type AgentTier = 'project' | 'global' | 'packaged' | 'fallback';
|
|
31
|
+
export type AgentTier = 'project' | 'global' | 'packaged' | 'fallback' | 'universal';
|
|
26
32
|
/**
|
|
27
33
|
* Whether an agent is permitted to spawn other agents and its role in the
|
|
28
34
|
* orchestration hierarchy.
|
|
@@ -106,7 +112,7 @@ export interface ResolvedAgent {
|
|
|
106
112
|
/** Merged skill slugs (union of catalog bindings and `.cant`-declared skills). */
|
|
107
113
|
skills: string[];
|
|
108
114
|
/** Concrete source tier of the chosen row (mirrors `tier`). */
|
|
109
|
-
source: 'project' | 'global' | 'packaged' | 'fallback';
|
|
115
|
+
source: 'project' | 'global' | 'packaged' | 'fallback' | 'universal';
|
|
110
116
|
/** `true` when an alias redirected the lookup to another agentId. */
|
|
111
117
|
aliasApplied: boolean;
|
|
112
118
|
/** When `aliasApplied` is true, the terminal canonical agentId the alias pointed at. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent-registry-v3.d.ts","sourceRoot":"","sources":["../src/agent-registry-v3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH
|
|
1
|
+
{"version":3,"file":"agent-registry-v3.d.ts","sourceRoot":"","sources":["../src/agent-registry-v3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;AAErF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAM9D;;;;;;;;;GASG;AACH,MAAM,WAAW,2BAA2B;IAC1C,wDAAwD;IACxD,IAAI,EAAE,SAAS,CAAC;IAChB,6DAA6D;IAC7D,QAAQ,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oGAAoG;IACpG,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IACjD,qDAAqD;IACrD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,IAAI,EAAE,SAAS,CAAC;IAChB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,QAAQ,EAAE,OAAO,CAAC;IAClB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kFAAkF;IAClF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,+DAA+D;IAC/D,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;IACrE,qEAAqE;IACrE,YAAY,EAAE,OAAO,CAAC;IACtB,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,CAAC;AAEZ;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,IAAI,EAAE,eAAe,CAAC;IACtB,+BAA+B;IAC/B,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,0BAA0B;IAC1B,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;CACrB"}
|
package/package.json
CHANGED
package/src/agent-registry-v3.ts
CHANGED
|
@@ -19,15 +19,21 @@
|
|
|
19
19
|
/**
|
|
20
20
|
* Tier where an agent is installed or resolved from.
|
|
21
21
|
*
|
|
22
|
-
* - `project`
|
|
23
|
-
* - `global`
|
|
24
|
-
* - `packaged`
|
|
25
|
-
* - `fallback`
|
|
22
|
+
* - `project` — installed in the current project (`.cleo/agents/`)
|
|
23
|
+
* - `global` — installed at the user/global scope (`$XDG_DATA_HOME/cleo/agents/`)
|
|
24
|
+
* - `packaged` — bundled with the CLEO distribution
|
|
25
|
+
* - `fallback` — synthesized at resolve-time when no concrete `.cant` exists
|
|
26
|
+
* for the requested agentId but a bundled seed-agent file matches
|
|
27
|
+
* - `universal` — synthesized at resolve-time from the universal protocol
|
|
28
|
+
* base (`@cleocode/agents/cleo-subagent.cant`). Acts as the
|
|
29
|
+
* final safety net so classifier output never produces
|
|
30
|
+
* `E_AGENT_NOT_FOUND` when the base file is reachable.
|
|
31
|
+
* Added in v2026.4.111 (T1241 / D035).
|
|
26
32
|
*
|
|
27
|
-
* @task T897
|
|
28
|
-
* @epic T889
|
|
33
|
+
* @task T897 / T1241
|
|
34
|
+
* @epic T889 / T1232
|
|
29
35
|
*/
|
|
30
|
-
export type AgentTier = 'project' | 'global' | 'packaged' | 'fallback';
|
|
36
|
+
export type AgentTier = 'project' | 'global' | 'packaged' | 'fallback' | 'universal';
|
|
31
37
|
|
|
32
38
|
/**
|
|
33
39
|
* Whether an agent is permitted to spawn other agents and its role in the
|
|
@@ -119,7 +125,7 @@ export interface ResolvedAgent {
|
|
|
119
125
|
/** Merged skill slugs (union of catalog bindings and `.cant`-declared skills). */
|
|
120
126
|
skills: string[];
|
|
121
127
|
/** Concrete source tier of the chosen row (mirrors `tier`). */
|
|
122
|
-
source: 'project' | 'global' | 'packaged' | 'fallback';
|
|
128
|
+
source: 'project' | 'global' | 'packaged' | 'fallback' | 'universal';
|
|
123
129
|
/** `true` when an alias redirected the lookup to another agentId. */
|
|
124
130
|
aliasApplied: boolean;
|
|
125
131
|
/** When `aliasApplied` is true, the terminal canonical agentId the alias pointed at. */
|