@agent-facets/adapter-claude-code 0.2.0 → 0.2.2

package/dist/index.d.mts

@@ -1,10 +1,91 @@
-import * as _$_agent_facets_adapter0 from "@agent-facets/adapter";
-
+//#region ../../common/src/types.d.ts
+/**
+ * A structured validation error decoupled from any specific validation library.
+ * Used across all packages to report schema and parsing failures.
+ */
+interface ValidationError {
+  /** Dot-separated path to the invalid field (e.g., "agents.reviewer.prompt") */
+  path: string;
+  /** Human-readable error message */
+  message: string;
+  /** What was expected at this location */
+  expected: string;
+  /** What was actually found */
+  actual: string;
+}
+/**
+ * Discriminated result type for validation operations.
+ * Callers check `ok` to determine success or failure.
+ *
+ * Replaces the previous `Result<T>` (which required a type parameter)
+ * and `ValidationResult` (which was `Result<void>`). Every validation
+ * operation returns data on success — `T` is always required.
+ *
+ * @example
+ * ```ts
+ * const result: Validated<FacetManifest> = loadManifest(dir)
+ * if (result.ok) {
+ *   console.log(result.data) // FacetManifest
+ * } else {
+ *   console.error(result.errors) // ValidationError[]
+ * }
+ * ```
+ */
+type Validated<T> = {
+  ok: true;
+  data: T;
+} | {
+  ok: false;
+  errors: ValidationError[];
+};
+/**
+ * The canonical asset type — singular form.
+ * Code that needs the plural/manifest-key form should derive it.
+ */
+type AssetType = 'skill' | 'agent' | 'command';
+/**
+ * Classifies the scope for adapter interactions
+ */
+type Scope = 'system' | 'user' | 'project';
+//#endregion
+//#region ../../adapter/src/types.d.ts
+/**
+ * Opaque record type for adapter-specific asset metadata.
+ * Each adapter defines its own schema — this is the generic container.
+ */
+type AdapterMetadata = Record<string, unknown>;
+/**
+ * The full adapter contract. Returned by `defineAdapter()`.
+ *
+ * An adapter is an AI coding tool (OpenCode, Claude Code, Codex, etc.)
+ * that wraps around an LLM. The adapter is a full abstraction layer
+ * over its tool's storage and configuration.
+ */
+interface Adapter {
+  /** Unique adapter name (e.g., "opencode", "claude-code", "codex") */
+  readonly name: string;
+  /**
+   * Validate and enrich per-asset adapter metadata from a facet manifest.
+   * Takes raw metadata, validates it against the adapter's schema,
+   * applies adapter-specific defaults, and returns the enriched object.
+   */
+  buildAssetMetadata(data: unknown): Validated<AdapterMetadata>;
+  /** Install an asset at the given scope */
+  installAsset(scope: Scope, assetType: AssetType, name: string, content: string, metadata: unknown): Promise<void>;
+  /** Read an asset's content from the given scope */
+  readAsset(scope: Scope, assetType: AssetType, name: string): Promise<{
+    content: string;
+    metadata?: AdapterMetadata;
+  }>;
+  /** Delete an asset from the given scope */
+  deleteAsset(scope: Scope, assetType: AssetType, name: string): Promise<void>;
+}
+//#endregion
 //#region src/index.d.ts
 /**
  * Claude Code adapter — defines the conventions for Claude Code,
  * Anthropic's AI coding tool.
  */
-declare const _default: _$_agent_facets_adapter0.Adapter;
+declare const _default: Adapter;
 //#endregion
 export { _default as default };