faf-cli 7.6.0 → 7.8.0

package/dist/interop/cards.d.ts

@@ -0,0 +1,123 @@
+import type { FafData } from '../core/types.js';
+import { type ServerCardOptions } from './servercard.js';
+/** A2A extension URI — dereference, not the MCP `_meta` key `one.faf/context`. */
+export declare const A2A_CONTEXT_URI = "https://faf.one/context";
+export declare const A2A_PROTOCOL_BINDING = "JSONRPC";
+export declare const A2A_PROTOCOL_VERSION = "1.0";
+export type CardTarget = 'a2a' | 'mcp' | 'registry' | 'catalog';
+export declare const CARD_TARGETS: CardTarget[];
+export interface FafaAgent {
+    name?: string;
+    displayName?: string;
+    id?: string;
+    vendor?: string;
+    version?: string;
+    description?: string;
+    homepage?: string;
+}
+export interface FafaCapability {
+    name?: string;
+    description?: string;
+    tags?: unknown;
+}
+export interface FafaEndpoint {
+    protocol?: string;
+    transport?: string;
+    location?: string;
+    version?: string;
+}
+export interface FafaDoc {
+    agent?: FafaAgent;
+    capabilities?: FafaCapability[];
+    endpoints?: FafaEndpoint[];
+    provenance?: Record<string, unknown>;
+    metadata?: {
+        persona?: string;
+    };
+    [key: string]: unknown;
+}
+export interface ProjectCardsOptions extends ServerCardOptions {
+    /** Public URL of the emitted A2A card (catalog row). */
+    a2aCardUrl?: string;
+    /** Caller-supplied A2A door when `.fafa` has no `endpoints[].protocol: a2a`. */
+    doorUrl?: string;
+}
+export interface ProjectedA2A {
+    name: string;
+    description: string;
+    supportedInterfaces: Array<{
+        url: string;
+        protocolBinding: string;
+        protocolVersion: string;
+    }>;
+    provider: {
+        organization: string;
+        url: string;
+    };
+    version: string;
+    capabilities: {
+        streaming: boolean;
+        pushNotifications: boolean;
+        extendedAgentCard: boolean;
+        extensions: Array<{
+            uri: string;
+            description: string;
+            required: boolean;
+            params: Record<string, unknown>;
+        }>;
+    };
+    defaultInputModes: string[];
+    defaultOutputModes: string[];
+    skills: Array<{
+        id: string;
+        name: string;
+        description: string;
+        tags: string[];
+    }>;
+}
+export interface CatalogEntry {
+    identifier: string;
+    displayName?: string;
+    type: string;
+    description?: string;
+    url: string;
+    updatedAt?: string;
+}
+export interface AiCatalog {
+    specVersion: string;
+    host?: Record<string, unknown>;
+    entries: CatalogEntry[];
+    [key: string]: unknown;
+}
+export interface ProjectedCards {
+    block: Record<string, unknown>;
+    a2a?: ProjectedA2A;
+    mcp?: Record<string, unknown>;
+    registry?: {
+        name: string;
+        title?: string;
+        _meta: Record<string, unknown>;
+    };
+    catalog?: CatalogEntry[];
+}
+export declare function readFafa(path: string): FafaDoc;
+/** Discover agent.fafa / .fafa (cwd, then one parent). */
+export declare function findFafaFile(dir?: string): string | null;
+export declare function a2aEndpoints(fafa: FafaDoc): FafaEndpoint[];
+/** Authored A2A endpoints, else a single `doorUrl`. Never invents a door. */
+export declare function a2aDoors(fafa: FafaDoc, opts?: ProjectCardsOptions): FafaEndpoint[];
+export declare function generateA2ACard(fafa: FafaDoc, faf: FafData, opts?: ProjectCardsOptions): ProjectedA2A;
+export declare function catalogEntriesFor(fafa: FafaDoc, faf: FafData, opts?: ProjectCardsOptions): CatalogEntry[];
+/** Upsert projector entries into an existing catalog. Leaves unknown rows alone.
+ *  On match, only url / type / updatedAt move — host copy (title, tags) stays. */
+export declare function upsertCatalog(existing: AiCatalog | undefined, incoming: CatalogEntry[]): AiCatalog;
+export declare function projectCards(input: {
+    faf: FafData;
+    fafa?: FafaDoc;
+    targets?: CardTarget[];
+    opts?: ProjectCardsOptions;
+}): ProjectedCards;
+/** Byte-identical context block on every emitted door. */
+export declare function assertSameBlock(cards: ProjectedCards): void;
+export declare function writeJson(path: string, value: unknown): void;
+export declare function parseTargets(raw?: string): CardTarget[] | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "faf-cli",
-  "version": "7.6.0",
+  "version": "7.8.0",
   "description": "Persistent AI context + memory — .faf and .fafm, IANA-registered. Anthropic-merged.",
   "type": "module",
   "icon": "https://faf.one/orange-smiley.svg",
@@ -69,10 +69,10 @@
     "url": "https://github.com/Wolfe-Jam/faf-cli/issues"
   },
   "dependencies": {
-    "commander": "^14.0.1",
+    "commander": "^14.0.3",
     "faf-scoring-kernel": "^2.0.3",
     "open": "^11.0.0",
-    "yaml": "^2.4.1"
+    "yaml": "^2.9.0"
   },
   "optionalDependencies": {
     "@anthropic-ai/sdk": "^0.91.1"
@@ -80,14 +80,19 @@
   "devDependencies": {
     "@faf/specification": "github:Wolfe-Jam/faf",
     "@types/bun": "^1.3.14",
-    "@types/node": "^22.15.0",
-    "@typescript-eslint/eslint-plugin": "^8.41.0",
-    "@typescript-eslint/parser": "^8.41.0",
-    "ajv": "^8.17.1",
-    "eslint": "^9.39.2",
-    "prettier": "^3.2.5",
-    "typescript": "^5.3.3",
-    "typescript-eslint": "^8.59.1"
+    "@types/node": "^22.20.1",
+    "@typescript-eslint/eslint-plugin": "^8.66.0",
+    "@typescript-eslint/parser": "^8.66.0",
+    "ajv": "^8.20.0",
+    "eslint": "^9.39.5",
+    "prettier": "^3.9.6",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.66.0"
+  },
+  "overrides": {
+    "brace-expansion": "^1.1.18",
+    "fast-uri": "^3.1.5",
+    "picomatch": "^4.0.5"
   },
   "engines": {
     "node": ">=18.0.0"

package/project.faf

@@ -1,8 +1,8 @@
 faf_version: "3.0"
 project:
   name: faf-cli
-  version: "7.6.0"
-  goal: "CLI for IANA-registered `.faf` + `.fafm` — context DNA and portable agent memory. TypeScript, Bun-native since v6. package faf-cli v7.6.0 The Ruby Edition."
+  version: "7.8.0"
+  goal: "CLI for IANA-registered `.faf` + `.fafm` — context DNA and portable agent memory. TypeScript, Bun-native since v6. package faf-cli v7.8.0 The Projector Edition."
   main_language: TypeScript
   type: cli  # found: package.json bin
 # Commands + key_files feed `faf export --agents` (hand values win over detection).
@@ -58,7 +58,7 @@ human_context:
   what: Persistent AI Context Standard — project DNA for AI. IANA-registered. Anthropic-merged.
   why: Eliminates 91% context re-discovery tax — define once, AI remembers forever
   where: npm registry, Homebrew, GitHub
-  when: Production since September 2025; Bun-native since v6; current package 7.6.0
+  when: Production since September 2025; Bun-native since v6; current package 7.8.0
   how: bunx faf-cli auto, then project.faf versions with your code — faf show renders it human-visible
 monorepo:
   packages_count: slotignored