cyber-agentkit 1.0.0 → 1.2.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
@@ -403,22 +426,101 @@ 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;
+//#region src/prose-update/split-sentences.d.ts
+type SentenceKind = 'text' | 'heading' | 'item' | 'row' | 'fence' | 'quote';
+/** The unit prose-update compares: see K4 in the prose-update spec. */
+type Sentence = {
+  text: string;
+  kind: SentenceKind;
+  /** What separated this sentence from the one before it: nothing, a space, a newline, or a blank line. */
+  gap: '' | ' ' | '\n' | '\n\n';
+};
+//#endregion
+//#region src/prose-update/merge.d.ts
+/** A place where the owner and the offered wording each changed the same base sentences differently. */
+type Collision = {
+  base: Sentence[];
+  found: Sentence[];
+  offered: Sentence[];
+};
+//#endregion
+//#region src/prose-update/classify.d.ts
+type Outcome = 'up-to-date' | 'update' | 'conflict' | 'owners' | 'undetermined';
+type Reason = 'no-history' | 'empty-section' | 'tied-base' | 'no-base';
+/** The retired wording a found text descends from: its place in the history (0 is the newest) and its date. */
+type BaseRef = {
+  index: number;
+  date?: string | undefined;
+};
+type PartResult = {
+  path: string[];
+  key: string;
+  outcome: Outcome;
+  reason?: Reason;
+  /** Set with `tied-base`: the places in the history of the wordings that tied. */
+  tied?: number[];
+  base?: BaseRef;
+  /** Sentences the found part shares with the base part (K10), and the base part's sentence count. */
+  shared?: number;
+  baseSentences?: number;
+  revision?: 'append' | 'rewrite';
+  /** The part's text: as found for `up-to-date` and `owners`, merged for `update` (empty when the part is removed). */
+  text?: string;
+  collisions?: Collision[];
+};
+type Classification = {
+  outcome: Outcome;
+  reason?: Reason;
+  base?: BaseRef;
+  parts: PartResult[];
+  /** The found text for every outcome but `update` and `conflict`; the merged text otherwise. */
+  text: string;
+};
+type ClassifyInput = {
+  found: string;
+  offered: string;
+  /** A history text (parsed by `parseHistory`), or retired wordings, newest first. */
+  history: string | readonly string[];
+};
+/** The offered wording is empty, so nothing can be classified (R33). */
+export declare class ProseUpdateError extends Error {
+  readonly code: 'empty-offered';
+  constructor(code: 'empty-offered', message: string);
+}
+/** Classifies each part of the found text against the offered wording and the history, and merges where it can. */
+export declare function classify(input: ClassifyInput): Classification;
+//#endregion
+//#region src/prose-update/history.d.ts
+type RetiredWording = {
+  wording: string;
+  date: string;
+  reason: string;
+};
+/** An entry that did not parse: its place among the `Superseded` headings (from 0), its line (from 1), and its heading. */
+type InvalidEntry = {
+  position: number;
+  line: number;
+  heading: string;
+};
+type ParsedHistory = {
+  entries: RetiredWording[];
+  invalid: InvalidEntry[];
 };
 /**
- * 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.
+ * Reads the retired wordings of a history text, newest first. Each entry is a `## Superseded <date> — <reason>`
+ * heading followed by the wording in a fence. An entry that does not parse is returned in `invalid`.
+ */
+export declare function parseHistory(text: string): ParsedHistory;
+/**
+ * Returns the history text with the outgoing wording added as its newest entry and every other byte unchanged.
+ * The wording equal to the newest retired one changes nothing.
  */
-export declare function loadReference(name: string, options: LoadReferenceOptions): Promise<ResolvedReference>;
+export declare function retire(history: string, wording: string, date: string, reason: string): string;
 //#endregion
 //#region src/references/reference-catalog.d.ts
 /** One row per name. */
 type ReferenceListRow = {
+  format?: string;
   name: string;
   description: string;
   status: ReferenceStatus;
@@ -604,9 +706,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
 /**
@@ -721,4 +825,4 @@ interface SkillsDirectories {
  */
 export declare function skillsDirectories(harness: HarnessId): SkillsDirectories | undefined;
 //#endregion
-export { type AmbiguousCause, type CheckOptions, type CheckPluginDependenciesOptions, type CheckedDependency, type DependencyState, type DetectHarnessOptions, type EnabledPluginSource, type EnabledPluginsOptions, type EnabledPluginsResult, type ExcludedImplementation, type ExtendsStep, type FoundSkill, type HarnessDetectionResult, type HarnessEnvironment, type HarnessEvidence, type HarnessId, type HeadlessCommand, type HeadlessCommandOptions, type HeadlessExitCode, type HeadlessInvocation, type HeadlessMode, type HeadlessOutputFormat, type HeadlessPermission, type HeadlessTranscript, type HeadlessUnavailable, type HeadlessUsage, type ImplementationsOptions, type ImplementsEntry, type InstalledPlugin, type InstalledPluginSource, type InstalledPluginsResult, type InterfaceCardinality, type InterfaceCheck, type InterfaceCheckFailure, type ListOptions, type LoadReferenceOptions, type ManagedPolicyKind, type ManagedPolicyLocation, type ManagedPolicyOptions, type MatchKind, type MergeOperation, type OperationSource, type Platform, type PluginDependenciesRead, type PluginDependency, type PluginDependencyCheck, type PluginEnablement, type PluginScope, type PluginSkill, type PluginStorage, type PluginStorageKind, type PluginStorageLocation, type ReferenceCheckEntry, type ReferenceCheckFailure, type ReferenceCheckKind, type ReferenceCode, type ReferenceImplementation, type ReferenceImplementations, type ReferenceInterface, type ReferenceLayer, type ReferenceLayerOptions, type ReferenceLayers, type ReferenceListLayerRow, type ReferenceListRow, type ReferenceListing, type ReferenceName, type ReferencePlugin, type ReferenceSearch, type ReferenceStatus, type ReferenceTier, type ReferenceTrace, type ReferenceTraceContribution, type ReferenceTraceLayer, type ReferenceTraceSection, type ReferenceWarning, type ReferenceWarningCode, type ReferenceWherePlace, type ReferenceWhereReport, type ResolveOptions, type ResolvedReference, type SearchMatch, type SectionSource, type SkillDefaults, type SkillFolderOptions, type SkillInvocation, type SkillsDirectories, type WhereOptions, defaultLayer, harnessIds, parseReferenceName, projectReferencesDir, referenceLayers, referenceNames, resolveReference, skillName, skillsIn, userReferencesDir };
+export { type AmbiguousCause, type BaseRef, type CheckOptions, type CheckPluginDependenciesOptions, type CheckedDependency, type Classification, type ClassifyInput, type Collision, type DependencyState, type DetectHarnessOptions, type EnabledPluginSource, type EnabledPluginsOptions, type EnabledPluginsResult, type ExcludedImplementation, type ExtendsStep, type FoundSkill, type HarnessDetectionResult, type HarnessEnvironment, type HarnessEvidence, type HarnessId, type HeadlessCommand, type HeadlessCommandOptions, type HeadlessExitCode, type HeadlessInvocation, type HeadlessMode, type HeadlessOutputFormat, type HeadlessPermission, type HeadlessTranscript, type HeadlessUnavailable, type HeadlessUsage, type ImplementationsOptions, type ImplementsEntry, type InstalledPlugin, type InstalledPluginSource, type InstalledPluginsResult, type InterfaceCardinality, type InterfaceCheck, type InterfaceCheckFailure, type InvalidEntry, type ListOptions, type LoadReferenceOptions, type ManagedPolicyKind, type ManagedPolicyLocation, type ManagedPolicyOptions, type MatchKind, type MergeOperation, type OperationSource, type Outcome, type ParsedHistory, type PartResult, type Platform, type PluginDependenciesRead, type PluginDependency, type PluginDependencyCheck, type PluginEnablement, type PluginScope, type PluginSkill, type PluginStorage, type PluginStorageKind, type PluginStorageLocation, type Reason, type ReferenceCheckEntry, type ReferenceCheckFailure, type ReferenceCheckKind, type ReferenceCode, type ReferenceImplementation, type ReferenceImplementations, type ReferenceInterface, type ReferenceLayer, type ReferenceLayerOptions, type ReferenceLayers, type ReferenceListLayerRow, type ReferenceListRow, type ReferenceListing, type ReferenceName, type ReferencePlugin, type ReferenceSearch, type ReferenceStatus, type ReferenceTier, type ReferenceTrace, type ReferenceTraceContribution, type ReferenceTraceLayer, type ReferenceTraceSection, type ReferenceWarning, type ReferenceWarningCode, type ReferenceWherePlace, type ReferenceWhereReport, type ResolveOptions, type ResolvedReference, type RetiredWording, type SearchMatch, type SectionSource, type SkillDefaults, type SkillFolderOptions, type SkillInvocation, type SkillsDirectories, type WhereOptions, defaultLayer, harnessIds, parseReferenceName, projectReferencesDir, referenceLayers, referenceNames, resolveReference, skillName, skillsIn, userReferencesDir };