faf-cli 7.13.1 → 7.14.0

package/dist/interop/cards.d.ts

@@ -2,9 +2,11 @@ import type { FafData } from '../core/types.js';
 import { type RenderedResult } from '../core/render-hash.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_CONTEXT_URI = "https://faf.one/ext/context/v1";
 export declare const A2A_PROTOCOL_BINDING = "JSONRPC";
 export declare const A2A_PROTOCOL_VERSION = "1.0";
+/** The three FAF-family media types the extension advertises, in family order. */
+export declare const FAF_MEDIA_TYPES: readonly ["application/vnd.faf+yaml", "application/vnd.fafm+yaml", "application/vnd.fafa+yaml"];
 export type CardTarget = 'a2a' | 'mcp' | 'registry' | 'catalog';
 export declare const CARD_TARGETS: CardTarget[];
 export interface FafaAgent {
@@ -20,6 +22,8 @@ export interface FafaCapability {
     name?: string;
     description?: string;
     tags?: unknown;
+    /** MIME type this capability reads, when it's one of the FAF family — drives the skill's `inputModes` and the card's `defaultInputModes`. */
+    cites_spec?: string;
 }
 export interface FafaEndpoint {
     protocol?: string;
@@ -28,6 +32,8 @@ export interface FafaEndpoint {
     version?: string;
 }
 export interface FafaDoc {
+    /** `.fafa` spec version this document is authored against, e.g. `"1.0"` — not `agent.version`. */
+    version?: string;
     agent?: FafaAgent;
     capabilities?: FafaCapability[];
     endpoints?: FafaEndpoint[];
@@ -51,7 +57,8 @@ export interface ProjectedA2A {
         protocolBinding: string;
         protocolVersion: string;
     }>;
-    provider: {
+    /** Omitted entirely when `agent.vendor` or `agent.homepage` is absent — A2A optional, never a guessed org name. */
+    provider?: {
         organization: string;
         url: string;
     };
@@ -74,6 +81,7 @@ export interface ProjectedA2A {
         name: string;
         description: string;
         tags: string[];
+        inputModes?: string[];
     }>;
 }
 export interface CatalogEntry {
@@ -136,7 +144,14 @@ export declare function projectCards(input: {
     targets?: CardTarget[];
     opts?: ProjectCardsOptions;
 }): ProjectedCards;
-/** Byte-identical context block on every emitted door. */
+/**
+ * Same underlying context on every emitted door. MCP and registry carry
+ * {@link fafContextBlock} byte-identically. A2A's extension params are a
+ * deliberate, richer superset (agentId, passport, mediaTypes — see
+ * {@link fafaExtensionParams}), so the check there is narrower: its nested
+ * `provenance.faf` / `provenance.mediaType` must match the same block's
+ * `faf` / `mediaType` — the same pointer, not a byte-identical payload.
+ */
 export declare function assertSameBlock(cards: ProjectedCards): void;
 /** True when `bytes` are an A2A Agent Card faf wrote: JSON whose
  *  `capabilities.extensions` carry the FAF context extension

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "faf-cli",
-  "version": "7.13.1",
+  "version": "7.14.0",
   "description": "Persistent AI context + memory — .faf and .fafm, IANA-registered. Anthropic-merged.",
   "type": "module",
   "icon": "https://faf.one/orange-smiley.svg",

package/project.faf

@@ -1,8 +1,8 @@
 faf_version: "3.0"
 project:
   name: faf-cli
-  version: "7.13.1"
-  goal: "CLI for IANA-registered `.faf` + `.fafm` — context DNA and portable agent memory. TypeScript, Bun-native since v6. package faf-cli v7.13.1 The Co-Author Edition."
+  version: "7.14.0"
+  goal: "CLI for IANA-registered `.faf` + `.fafm` — context DNA and portable agent memory. TypeScript, Bun-native since v6. package faf-cli v7.14.0 The Passport 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.13.1
+  when: Production since September 2025; Bun-native since v6; current package 7.14.0
   how: bunx faf-cli auto, then project.faf versions with your code — faf show renders it human-visible
 monorepo:
   packages_count: slotignored