cyber-agentkit 0.7.1 → 1.1.0

package/dist/index.d.ts

@@ -1,5 +1,28 @@
 import { n as harnessIds, t as HarnessId } from "./harness-id-BgKL-x6C.js";
-import { A as FoundSkill, C as defaultLayer, D as ReferenceCode, E as userReferencesDir, M as skillsIn, N as Platform, O as ReferenceWarning, S as SkillDefaults, T as referenceLayers, _ as ReferenceLayer, a as ReferenceTrace, b as ReferencePlugin, c as ReferenceTraceSection, d as referenceNames, f as resolveReference, g as SectionSource, h as MergeOperation, i as ReferenceStatus, j as skillName, k as ReferenceWarningCode, l as ResolveOptions, m as parseReferenceName, n as ExtendsStep, o as ReferenceTraceContribution, p as ReferenceName, r as OperationSource, s as ReferenceTraceLayer, t as AmbiguousCause, u as ResolvedReference, v as ReferenceLayerOptions, w as projectReferencesDir, x as ReferenceTier, y as ReferenceLayers } from "./resolve-reference-Cis-Ye6T.js";
+import { A as FoundSkill, C as defaultLayer, D as ReferenceCode, E as userReferencesDir, M as skillsIn, N as Platform, O as ReferenceWarning, S as SkillDefaults, T as referenceLayers, _ as ReferenceLayer, a as ReferenceTrace, b as ReferencePlugin, c as ReferenceTraceSection, d as referenceNames, f as resolveReference, g as SectionSource, h as MergeOperation, i as ReferenceStatus, j as skillName, k as ReferenceWarningCode, l as ResolveOptions, m as parseReferenceName, n as ExtendsStep, o as ReferenceTraceContribution, p as ReferenceName, r as OperationSource, s as ReferenceTraceLayer, t as AmbiguousCause, u as ResolvedReference, v as ReferenceLayerOptions, w as projectReferencesDir, x as ReferenceTier, y as ReferenceLayers } from "./resolve-reference-D62VJZc0.js";
+//#region src/references/load-reference.d.ts
+/** `referenceLayers`' options, with the machine's own home directory, platform, and environment by default. */
+type LoadReferenceOptions = Omit<ReferenceLayerOptions, 'home' | 'platform' | 'folder'> & {
+  home?: string | undefined;
+  platform?: Platform | undefined;
+};
+/**
+ * Resolves one reference for `root` the way `reference show` does, returning the full record: every
+ * field `show` prints with `--metadata` and `--trace`. A name that is not a reference name comes back
+ * `invalid`, and one no contribution answers `missing`; neither throws.
+ */
+export declare function loadReference(name: string, options: LoadReferenceOptions & {
+  folder?: ReferenceLayerOptions['folder'];
+}): Promise<ResolvedReference>;
+//#endregion
+//#region src/assets/load-asset.d.ts
+/**
+ * Resolves one asset by name the way `asset load` does: the reference engine, reading `assets/` where
+ * it reads `references/`. A data file answers whole from the highest tier holding the name; the skill's
+ * own `assets/<name>.<ext>` (`defaultSkill`) is the lowest.
+ */
+export declare function loadAsset(name: string, options: LoadReferenceOptions): Promise<ResolvedReference>;
+//#endregion
 //#region src/harness/harness-environment.d.ts
 /**
  * The parts of the running process a harness query depends on. Every field defaults to the
@@ -38,7 +61,7 @@ interface PluginDependenciesRead {
   readonly error?: string;
 }
 /**
- * Read what the plugin at `pluginRoot` declares: `dependencies` under `extensions["org.spikyuni.plugin-manager"]`,
+ * Read what the plugin at `pluginRoot` declares: `dependencies` under `extensions["io.github.cyber-uni.plugin-manager"]`,
  * else under `extensions["org.cyberuni.universal-plugin"]` in the root `plugin.json`, else `dependencies` in
  * `.claude-plugin/plugin.json` (E-DEP-1, E-DEP-6, E-DEP-7).
  */
@@ -403,22 +426,10 @@ interface PluginStorage {
  */
 export declare function pluginStorage(harness: HarnessId, environment?: HarnessEnvironment): PluginStorage;
 //#endregion
-//#region src/references/load-reference.d.ts
-/** `referenceLayers`' options, with the machine's own home directory, platform, and environment by default. */
-type LoadReferenceOptions = Omit<ReferenceLayerOptions, 'home' | 'platform'> & {
-  home?: string | undefined;
-  platform?: Platform | undefined;
-};
-/**
- * Resolves one reference for `root` the way `reference show` does, returning the full record: every
- * field `show` prints with `--metadata` and `--trace`. A name that is not a reference name comes back
- * `invalid`, and one no contribution answers `missing`; neither throws.
- */
-export declare function loadReference(name: string, options: LoadReferenceOptions): Promise<ResolvedReference>;
-//#endregion
 //#region src/references/reference-catalog.d.ts
 /** One row per name. */
 type ReferenceListRow = {
+  format?: string;
   name: string;
   description: string;
   status: ReferenceStatus;
@@ -604,9 +615,11 @@ type WhereOptions = {
   root: string;
   /** How a path outside the project is shown, such as with the home directory collapsed to `~`. */
   display?: ((path: string) => string) | undefined;
+  /** An assets call: the project write goes to `.agents/assets/`. */
+  assets?: boolean | undefined;
 };
 /** The project and user files a customization of `name` is written to, with the document below each. */
-export declare function whereReference(input: string | ReferenceName, source: ReferenceLayers | readonly ReferenceLayer[], { root, display }: WhereOptions): ReferenceWhereReport;
+export declare function whereReference(input: string | ReferenceName, source: ReferenceLayers | readonly ReferenceLayer[], { root, display, assets }: WhereOptions): ReferenceWhereReport;
 //#endregion
 //#region src/skills/harness-skill-folders.d.ts
 /**

package/dist/index.js

@@ -1,6 +1,34 @@
-import { A as skillFoldersVerified, B as isRecord, C as userReferencesDir, D as adminSkillFolders, F as packageDir, H as stripJsonComments, I as detectHarness, L as installedPlugins, M as pluginManifestName, N as pluginManifestPaths, O as harnessSkillFolders, P as declaredDependencies, R as enabledPlugins, T as skillsIn, U as managedPolicyLocations, V as readText, b as projectReferencesDir, d as parseReferenceName, j as skillsDirectories, k as pluginSkillFolders, l as referenceNames, n as referenceImplementations, o as listReferences, r as checkReferences, s as searchReferences, t as whereReference, u as resolveReference, w as skillName, x as referenceLayers, y as defaultLayer, z as pluginStorage } from "./reference-where-BhymfNgA.js";
-import { join } from "node:path";
+import { A as skillName, B as declaredDependencies, D as pluginStorage, E as enabledPlugins, F as pluginSkillFolders, H as isRecord, I as skillFoldersVerified, L as skillsDirectories, N as adminSkillFolders, O as managedPolicyLocations, P as harnessSkillFolders, R as pluginManifestName, S as referenceLayers, T as installedPlugins, U as readText, V as packageDir, W as stripJsonComments, b as defaultLayer, d as parseReferenceName, j as skillsIn, k as detectHarness, l as referenceNames, n as referenceImplementations, o as listReferences, r as checkReferences, s as searchReferences, t as whereReference, u as resolveReference, w as userReferencesDir, x as projectReferencesDir, z as pluginManifestPaths } from "./reference-where-C84J6MsR.js";
 import { homedir } from "node:os";
+import { join } from "node:path";
+//#region src/references/load-reference.ts
+/**
+* Resolves one reference for `root` the way `reference show` does, returning the full record: every
+* field `show` prints with `--metadata` and `--trace`. A name that is not a reference name comes back
+* `invalid`, and one no contribution answers `missing`; neither throws.
+*/
+async function loadReference(name, options) {
+	const layers = await referenceLayers({
+		...options,
+		home: options.home ?? homedir(),
+		platform: options.platform ?? process.platform
+	});
+	return resolveReference(name, layers);
+}
+//#endregion
+//#region src/assets/load-asset.ts
+/**
+* Resolves one asset by name the way `asset load` does: the reference engine, reading `assets/` where
+* it reads `references/`. A data file answers whole from the highest tier holding the name; the skill's
+* own `assets/<name>.<ext>` (`defaultSkill`) is the lowest.
+*/
+async function loadAsset(name, options) {
+	return loadReference(name, {
+		...options,
+		folder: "assets"
+	});
+}
+//#endregion
 //#region src/plugins/plugin-dependencies.ts
 /**
 * Whether a harness lets a plugin declare other plugins it depends on. Only Claude Code does, via
@@ -39,9 +67,9 @@ function declaredPluginDependencies(manifest) {
 }
 const nonEmpty = (value) => typeof value === "string" && value !== "" ? value : void 0;
 /** The extension namespaces a root `plugin.json` may author its dependency list under, newest first (E-DEP-6, E-DEP-7). */
-const extensionNamespaces = ["org.spikyuni.plugin-manager", "org.cyberuni.universal-plugin"];
+const extensionNamespaces = ["io.github.cyber-uni.plugin-manager", "org.cyberuni.universal-plugin"];
 /**
-* Read what the plugin at `pluginRoot` declares: `dependencies` under `extensions["org.spikyuni.plugin-manager"]`,
+* Read what the plugin at `pluginRoot` declares: `dependencies` under `extensions["io.github.cyber-uni.plugin-manager"]`,
 * else under `extensions["org.cyberuni.universal-plugin"]` in the root `plugin.json`, else `dependencies` in
 * `.claude-plugin/plugin.json` (E-DEP-1, E-DEP-6, E-DEP-7).
 */
@@ -559,21 +587,6 @@ function headlessCommand(harness, options) {
 	};
 }
 //#endregion
-//#region src/references/load-reference.ts
-/**
-* Resolves one reference for `root` the way `reference show` does, returning the full record: every
-* field `show` prints with `--metadata` and `--trace`. A name that is not a reference name comes back
-* `invalid`, and one no contribution answers `missing`; neither throws.
-*/
-async function loadReference(name, options) {
-	const layers = await referenceLayers({
-		...options,
-		home: options.home ?? homedir(),
-		platform: options.platform ?? process.platform
-	});
-	return resolveReference(name, layers);
-}
-//#endregion
 //#region src/skills/skill-invocation.ts
 /**
 * How a user invokes a plugin's skill in a harness.
@@ -649,4 +662,4 @@ function skillInvocation(harness, { plugin, skill }) {
 	}
 }
 //#endregion
-export { adminSkillFolders, checkPluginDependencies, checkReferences, declaredDependencies, declaredPluginDependencies, defaultLayer, detectHarness, enabledPlugins, harnessIds, harnessSkillFolders, headlessCommand, headlessInvocation, installedPlugins, listReferences, loadReference, managedPolicyLocations, packageDir, parseReferenceName, pluginManifestName, pluginManifestPaths, pluginSkillFolders, pluginStorage, projectReferencesDir, readPluginDependencies, referenceImplementations, referenceLayers, referenceNames, resolveReference, searchReferences, skillFoldersVerified, skillInvocation, skillName, skillsDirectories, skillsIn, supportsPluginDependencies, userReferencesDir, whereReference };
+export { adminSkillFolders, checkPluginDependencies, checkReferences, declaredDependencies, declaredPluginDependencies, defaultLayer, detectHarness, enabledPlugins, harnessIds, harnessSkillFolders, headlessCommand, headlessInvocation, installedPlugins, listReferences, loadAsset, loadReference, managedPolicyLocations, packageDir, parseReferenceName, pluginManifestName, pluginManifestPaths, pluginSkillFolders, pluginStorage, projectReferencesDir, readPluginDependencies, referenceImplementations, referenceLayers, referenceNames, resolveReference, searchReferences, skillFoldersVerified, skillInvocation, skillName, skillsDirectories, skillsIn, supportsPluginDependencies, userReferencesDir, whereReference };