@open-agent-toolkit/cli 0.2.53 → 0.2.55

package/dist/engine/scanner.d.ts

@@ -1,3 +1,5 @@
+import { type InventoryScopedPackInput, type ScopedPackInventory } from '../commands/tools/shared/pack-inventory.js';
+import { type PackDefinition } from '../commands/tools/shared/pack-manifest.js';
 import { type CanonicalScanTarget, type Scope } from '../shared/types.js';
 type ConcreteScope = Exclude<Scope, 'all'>;
 export interface CanonicalEntry {
@@ -6,7 +8,13 @@ export interface CanonicalEntry {
     canonicalPath: string;
     isFile: boolean;
 }
-export declare function scanBundledManagedAgents(): Promise<CanonicalEntry[]>;
+export interface ScanBundledManagedAgentsOptions {
+    scopeRoot?: string;
+    assetsRoot?: string;
+    manifest?: readonly PackDefinition[];
+    inventoryPack?: (input: InventoryScopedPackInput) => Promise<ScopedPackInventory>;
+}
+export declare function scanBundledManagedAgents(options?: ScanBundledManagedAgentsOptions): Promise<CanonicalEntry[]>;
 /**
  * User-scope Codex/Cursor materialization reads the bundled managed role files,
  * not the installed copies under `~/.agents/agents/`. Concatenating both lists

package/dist/engine/scanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/engine/scanner.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,KAAK,EACX,MAAM,eAAe,CAAC;AAEvB,KAAK,aAAa,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB;AA0DD,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAsB1E;AAED;;;;GAIG;AACH,wBAAgB,oCAAoC,CAClD,gBAAgB,EAAE,cAAc,EAAE,EAClC,oBAAoB,EAAE,cAAc,EAAE,GACrC,cAAc,EAAE,CAqBlB;AAED,wBAAgB,mCAAmC,CACjD,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,cAAc,EAC9B,qBAAqB,CAAC,EAAE,MAAM,EAAE,GAC/B,OAAO,CAqBT;AAED,qFAAqF;AACrF,eAAO,MAAM,6BAA6B,iCAA2B,CAAC;AAEtE,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,SAAS,mBAAmB,EAAE,GACvC,OAAO,CAAC,cAAc,EAAE,CAAC,CA6C3B"}
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/engine/scanner.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACzB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,KAAK,EACX,MAAM,eAAe,CAAC;AAEvB,KAAK,aAAa,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,+BAA+B;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACrC,aAAa,CAAC,EAAE,CACd,KAAK,EAAE,wBAAwB,KAC5B,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACnC;AA0DD,wBAAsB,wBAAwB,CAC5C,OAAO,GAAE,+BAAoC,GAC5C,OAAO,CAAC,cAAc,EAAE,CAAC,CAiG3B;AAED;;;;GAIG;AACH,wBAAgB,oCAAoC,CAClD,gBAAgB,EAAE,cAAc,EAAE,EAClC,oBAAoB,EAAE,cAAc,EAAE,GACrC,cAAc,EAAE,CAqBlB;AAED,wBAAgB,mCAAmC,CACjD,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,cAAc,EAC9B,qBAAqB,CAAC,EAAE,MAAM,EAAE,GAC/B,OAAO,CAqBT;AAED,qFAAqF;AACrF,eAAO,MAAM,6BAA6B,iCAA2B,CAAC;AAEtE,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,SAAS,mBAAmB,EAAE,GACvC,OAAO,CAAC,cAAc,EAAE,CAAC,CA6C3B"}

package/dist/engine/scanner.js

@@ -1,5 +1,7 @@
 import { readdir } from 'node:fs/promises';
-import { isAbsolute, join, relative, resolve, sep } from 'node:path';
+import { basename, isAbsolute, join, relative, resolve, sep } from 'node:path';
+import { inventoryScopedPack, } from '../commands/tools/shared/pack-inventory.js';
+import { PACK_MANIFEST, } from '../commands/tools/shared/pack-manifest.js';
 import { CliError } from '../errors/index.js';
 import { resolveAssetsRoot } from '../fs/assets.js';
 import { SCOPE_CONTENT_TYPES, USER_SCOPE_MANAGED_AGENT_FILES, } from '../shared/types.js';
@@ -43,20 +45,75 @@ async function readEntries(dirPath) {
         throw error;
     }
 }
-export async function scanBundledManagedAgents() {
-    const agentsDir = join(await resolveAssetsRoot(), 'agents');
+export async function scanBundledManagedAgents(options = {}) {
+    const assetsRoot = options.assetsRoot ?? (await resolveAssetsRoot());
+    const agentsDir = join(assetsRoot, 'agents');
     const entries = await readEntries(agentsDir);
     const available = new Set(entries.filter((entry) => entry.isFile).map((entry) => entry.name));
     const missing = USER_SCOPE_MANAGED_AGENT_FILES.filter((name) => !available.has(name));
     if (missing.length > 0) {
         throw new CliError(`Bundled managed role definitions are unavailable: ${missing.join(', ')}. Reinstall or rebuild OAT before running user sync.`);
     }
-    return USER_SCOPE_MANAGED_AGENT_FILES.map((name) => ({
+    const managed = USER_SCOPE_MANAGED_AGENT_FILES.map((name) => ({
         name,
         type: 'agent',
         canonicalPath: join(agentsDir, name),
         isFile: true,
     }));
+    if (!options.scopeRoot)
+        return managed;
+    const inventoryPack = options.inventoryPack ?? inventoryScopedPack;
+    const materializable = (options.manifest ?? PACK_MANIFEST).flatMap((pack) => {
+        const assets = pack.assets.filter((asset) => asset.kind === 'agent' &&
+            asset.userMaterializable === true &&
+            asset.scopes.includes('user') &&
+            asset.ownership.user === 'managed');
+        return assets.length === 0 ? [] : [{ pack, assets }];
+    });
+    const inventories = await Promise.all(materializable.map(async ({ pack, assets }) => ({
+        assets,
+        inventory: await inventoryPack({
+            pack: pack.name,
+            scope: 'user',
+            scopeRoot: options.scopeRoot,
+            assetsRoot,
+        }),
+    })));
+    const selected = new Map(managed.map((entry) => [entry.name, entry]));
+    for (const { assets, inventory } of inventories) {
+        if (!inventory.intent.enabled)
+            continue;
+        for (const definition of assets) {
+            const installed = inventory.assets.find(({ definition: candidate }) => candidate.id === definition.id);
+            if (!installed || installed.status === 'missing')
+                continue;
+            if (installed.status !== 'current') {
+                throw new CliError(`User-materializable agent ${definition.id} is ${installed.status}, not current. Run oat tools update --pack ${inventory.pack} --scope user before running user sync.`);
+            }
+            if (!definition.source) {
+                throw new CliError(`User-materializable agent ${definition.id} has no bundled source. Reinstall or rebuild OAT before running user sync.`);
+            }
+            const name = basename(definition.destination);
+            const sourceName = basename(definition.source);
+            if (name !== sourceName ||
+                definition.source !== `agents/${name}` ||
+                !available.has(sourceName)) {
+                throw new CliError(`Bundled user-materializable agent definition is unavailable or mismatched: ${definition.id} (${definition.source}). Reinstall or rebuild OAT before running user sync.`);
+            }
+            const existing = selected.get(name);
+            const canonicalPath = installed.path;
+            if (existing && existing.canonicalPath !== canonicalPath) {
+                throw new CliError(`User-scope managed agent collision for ${name}: ${existing.canonicalPath} and ${canonicalPath}.`);
+            }
+            selected.set(name, {
+                name,
+                type: 'agent',
+                canonicalPath,
+                isFile: true,
+            });
+        }
+    }
+    return [...selected.values()];
 }
 /**
  * User-scope Codex/Cursor materialization reads the bundled managed role files,

package/dist/shared/types.d.ts

@@ -12,4 +12,5 @@ export interface CanonicalScanTarget {
 }
 export declare const SCOPE_CONTENT_TYPES: Record<Scope, ContentType[]>;
 export declare const USER_SCOPE_MANAGED_AGENT_FILES: readonly ['oat-phase-implementer.md', 'oat-reviewer.md'];
+export declare function isBuiltInUserScopeManagedAgentFile(name: string): boolean;
 //# sourceMappingURL=types.d.ts.map

package/dist/shared/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB,uCAAqC,CAAC;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,kBAAkB,wCAAsC,CAAC;AACtE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,WAAW,uCAAqC,CAAC;AAC9D,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAChD,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAQD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,CAI5D,CAAC;AAEF,eAAO,MAAM,8BAA8B,YACzC,0BAA0B,EAC1B,iBAAiB,CACT,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB,uCAAqC,CAAC;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,kBAAkB,wCAAsC,CAAC;AACtE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,WAAW,uCAAqC,CAAC;AAC9D,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAChD,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAQD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,CAI5D,CAAC;AAEF,eAAO,MAAM,8BAA8B,YACzC,0BAA0B,EAC1B,iBAAiB,CACT,CAAC;AAEX,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExE"}

package/dist/shared/types.js

@@ -16,3 +16,6 @@ export const USER_SCOPE_MANAGED_AGENT_FILES = [
     'oat-phase-implementer.md',
     'oat-reviewer.md',
 ];
+export function isBuiltInUserScopeManagedAgentFile(name) {
+    return USER_SCOPE_MANAGED_AGENT_FILES.includes(name);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-agent-toolkit/cli",
-  "version": "0.2.53",
+  "version": "0.2.55",
   "private": false,
   "description": "Open Agent Toolkit CLI",
   "homepage": "https://github.com/voxmedia/open-agent-toolkit/tree/main/packages/cli",
@@ -34,7 +34,7 @@
     "ora": "^9.0.0",
     "yaml": "2.8.2",
     "zod": "^3.25.76",
-    "@open-agent-toolkit/control-plane": "0.2.53"
+    "@open-agent-toolkit/control-plane": "0.2.55"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",