@agenticprimitives/agent-profile 1.0.0-alpha.4 → 1.0.0-alpha.41

package/dist/types.d.ts

@@ -1,8 +1,10 @@
-import type { Address, Hex, Caip10Address } from '@agenticprimitives/types';
+import type { Address, Hex, Caip10Address, AdvertisedCapabilityV1 } from '@agenticprimitives/types';
+import type { A2AAgentExtensionV1 } from './a2a/types.js';
 export type { Caip10Address };
 /**
- * Discriminator for AgentCard sub-shapes. Mirrors HCS-11 § typed-profile
- * categories with two additions specific to our model:
+ * Discriminator for AP-native AgentCard sub-shapes. Borrows the useful
+ * typed-profile idea from external registry/card ecosystems while keeping
+ * Ring 0 vocabulary AP-owned:
  *   - `treasury` (custody-policy-governed asset account)
  *   - `multisig` (collective Smart Agent with named members)
  *
@@ -10,10 +12,10 @@ export type { Caip10Address };
  * (b) handling in `canonicalProfileJson`, (c) a golden vector test
  * in `test/profile.test.ts`.
  */
-export type ProfileType = 'person' | 'org' | 'service' | 'treasury' | 'mcpServer' | 'multisig';
+export type ProfileType = 'person' | 'org' | 'team' | 'alliance' | 'church' | 'circle' | 'household' | 'service' | 'treasury' | 'mcpServer' | 'multisig';
 /**
- * Endpoint-control verification methods (matches GoDaddy ANS
- * `mcpServer.verification` pattern; we don't import their PKI).
+ * Endpoint-control verification methods. Inspired by external agent-card
+ * verification patterns, but not tied to any DNS/PKI registry integration.
  *
  * - `dns-txt` — owner publishes a TXT record at a known label;
  *   resolver fetches and matches against the on-chain digest.
@@ -24,6 +26,59 @@ export type ProfileType = 'person' | 'org' | 'service' | 'treasury' | 'mcpServer
  * - `verifiable-presentation` — W3C VP signed by the owner.
  */
 export type VerificationMethod = 'dns-txt' | 'signed-url' | 'http-challenge' | 'verifiable-presentation';
+/**
+ * The six install targets the ACP registry `binaryDistribution` accepts (`agent.schema.json`
+ * `propertyNames.enum`). Mirrored verbatim — the key IS the wire key.
+ */
+export type AcpPlatform = 'darwin-aarch64' | 'darwin-x86_64' | 'linux-aarch64' | 'linux-x86_64' | 'windows-aarch64' | 'windows-x86_64';
+/** `npx` / `uvx` package distribution (ACP `packageDistribution`). `package` may carry a version suffix. */
+export interface AgentPackageDistributionV1 {
+    /** Package name (with optional version), non-empty. */
+    package: string;
+    /** Command line arguments. */
+    args?: string[];
+    /** Environment variables (string values only). */
+    env?: Record<string, string>;
+}
+/** One per-platform binary target (ACP `binaryTarget`). */
+export interface AgentBinaryTargetV1 {
+    /**
+     * https URL of the archive (.zip, .tar.gz, .tgz, .tar.bz2, .tbz2 or a raw binary). Installer formats
+     * (.dmg, .pkg, .deb, .rpm) are NOT allowed — `validateDistribution` refuses them.
+     */
+    archive: string;
+    /** Command to execute after extraction, non-empty. */
+    cmd: string;
+    /** Optional SHA-256 of the archive — 64 hex characters, no `0x`. */
+    sha256?: string;
+    /** Command line arguments. */
+    args?: string[];
+    /** Environment variables (string values only). */
+    env?: Record<string, string>;
+}
+/**
+ * How to OBTAIN AND RUN this agent's software (spec 347 §8.5; `docs/architecture/ard-acp-crosswalk.md`
+ * §2). A registry-neutral canonical-profile fact, stored on chain as the SA-keyed `atl:distribution`
+ * string property (JCS-canonical JSON, `encodeDistribution`) and projected to the discovery KB as
+ * `approf:distribution`. Public and on-chain-derivable by construction (ADR-0040) — never put a secret
+ * in `env`.
+ *
+ * Field names mirror the ACP registry `agent.schema.json` `distribution` object exactly so a registry
+ * projection is a copy, never a translation. Two AP-owned extras sit beside them: `acp` (this agent
+ * speaks the Agent Client Protocol and may be listed in an ACP `registry.json`) and `version` (the
+ * agent IMPLEMENTATION's semver — the ACP entry REQUIRES one and the canonical profile has no other
+ * implementation-version field). At least one of `npx` / `uvx` / `binary` MUST be present.
+ */
+export interface AgentDistributionV1 {
+    /** Declares ACP conformance → eligible for the hosted ACP registry projection. Absent ≠ false-claimed; it means "not declared". */
+    acp?: boolean;
+    /** Implementation semver `MAJOR.MINOR.PATCH[…]` (ACP `^[0-9]+\.[0-9]+\.[0-9]+`). */
+    version?: string;
+    npx?: AgentPackageDistributionV1;
+    uvx?: AgentPackageDistributionV1;
+    /** Keys restricted to `ACP_PLATFORMS`; at least one target when present. */
+    binary?: Partial<Record<AcpPlatform, AgentBinaryTargetV1>>;
+}
 /** Common fields across all profile sub-shapes. */
 interface BaseProfile {
     /** Human-friendly display name (may differ from agent-naming `displayName`). */
@@ -36,9 +91,36 @@ interface BaseProfile {
     nativeId?: Caip10Address;
     /** Optional avatar / logo URL. */
     avatar?: string;
+    /** How to obtain + run this agent's software (spec 347 §8.5). Validated by `validateDistribution` on every write path. */
+    distribution?: AgentDistributionV1;
+    /**
+     * What this agent can do — the SYSTEM OF RECORD for it (ADR-0051).
+     *
+     * The A2A card's `skills[]` and ARD's `capabilities[]` are both PROJECTIONS of this list, produced by
+     * the A2A projector. Before this existed the card was the only place advertised abilities lived, which
+     * made the signed wire document the source of truth for a fact the owner should own.
+     */
+    capabilities?: AdvertisedCapabilityV1[];
+    /**
+     * A2A PROTOCOL flags — streaming, push, extensions. Not business capabilities, despite A2A calling
+     * this object `capabilities` on the wire. The two are separate fields here precisely because the
+     * protocol's name for its transport flags collides with our name for what an agent can do, and the
+     * card editor's two sections used to be titled "Capabilities" and "Skills" for exactly these two
+     * things — backwards in both cases.
+     */
+    protocolFeatures?: ProtocolFeatureSetV1;
+}
+/** The A2A protocol feature flags an agent declares. Projects to the card's `capabilities` object. */
+export interface ProtocolFeatureSetV1 {
+    streaming?: boolean;
+    /** DERIVED by the runtime. Claiming it without runtime evidence is `CAPABILITY_UNVERIFIED`. */
+    pushNotifications?: boolean;
+    stateTransitionHistory?: boolean;
+    extendedAgentCard?: boolean;
+    extensions?: A2AAgentExtensionV1[];
 }
 export interface AiAgentProfile extends BaseProfile {
-    type: 'person' | 'org';
+    type: 'person' | 'org' | 'team' | 'alliance' | 'church' | 'circle';
     /** For `org`: list of member Smart Agent addresses (informational only — authority lives in agent-relationships edges). */
     members?: Address[];
 }
@@ -62,8 +144,52 @@ export interface ServiceProfile extends BaseProfile {
     type: 'service' | 'treasury';
     /** Canonical service endpoint (A2A / MCP / HTTP). */
     endpoint?: string;
+    /**
+     * Open-set service ROLE (ADR-0046: indexer, relay, marketplace, assistant, …). `'workspace'`
+     * and `'registry'` are the roles that are also derived types (`.workspace` / `.registry` name them —
+     * spec 346 §2.1); each MUST match the SA-keyed on-chain `atl:serviceRole` record.
+     */
+    serviceRole?: string;
+}
+/**
+ * The AP-native, registry-neutral Canonical Agent Profile (spec 347 §2; ADR-0062). Facts and claims ABOUT
+ * the canonical Smart Agent — never the identity, and NOT the A2A Agent Card. The A2A card (what this A2A
+ * server does and how to reach it) is `A2AAgentCardV1` under `@agenticprimitives/agent-profile/a2a`.
+ */
+export type CanonicalAgentProfileV1 = AiAgentProfile | McpServerProfile | MultisigProfile | ServiceProfile;
+/** @deprecated Renamed `CanonicalAgentProfileV1` (spec 347 §0.3). Alias kept for one release. */
+export type AgentCard = CanonicalAgentProfileV1;
+/** sha256 content hash, e.g. `sha256:ab12…`. The discovery substrate hashes cards with sha256
+ *  (distinct from the keccac `profileContentHash` used as the on-chain `metadata-hash` predicate). */
+export type Sha256 = `sha256:${string}`;
+/**
+ * A self-asserted, SA-signed agent card (spec 279 §3.2). The distinct guarantee: a verifier can prove
+ * `cardHash → subjectAgent` WITHOUT trusting the registry or server that served the card — the subject
+ * Smart Agent signs (via ERC-1271) a digest binding the card hash to its own address + chain. This is the
+ * card that a registry entry's `cardHash` references; it is descriptive evidence and carries NO authority to act.
+ */
+export interface SignedCanonicalProfileBundleV1 {
+    /** Wire discriminator unchanged by the spec-347 rename — existing signed bundles stay valid. */
+    type: 'SignedAgentCardBundleV1';
+    card: CanonicalAgentProfileV1;
+    /** sha256 over the canonical-JSON card (`hashAgentCard`). */
+    cardHash: Sha256;
+    /** The canonical Smart Agent this card is a facet of (= signer = verifyingContract in V1). */
+    subjectAgent: Address;
+    issuedAt: string;
+    expiresAt?: string;
+    proof: {
+        type: 'ERC1271SmartAgentSignature';
+        chainId: number;
+        /** The ERC-1271 contract whose `isValidSignature` validates the signature (the subject SA in V1). */
+        verifyingContract: Address;
+        /** The signing identity (the subject SA in V1). */
+        signer: Address;
+        signature: Hex;
+    };
 }
-export type AgentCard = AiAgentProfile | McpServerProfile | MultisigProfile | ServiceProfile;
+/** @deprecated Renamed `SignedCanonicalProfileBundleV1` (spec 347 §0.3). Alias kept for one release. */
+export type SignedAgentCardBundleV1 = SignedCanonicalProfileBundleV1;
 export interface AgentIdentityClientOpts {
     rpcUrl: string;
     chainId: number;
@@ -77,7 +203,7 @@ export interface PublishProfileInput {
     /** Smart Agent address publishing the profile. */
     agent: Address;
     /** Profile JSON to publish. The SDK computes its canonical content-hash. */
-    profile: AgentCard;
+    profile: CanonicalAgentProfileV1;
     /**
      * URI where the canonical-JSON profile is hosted. The caller is
      * responsible for uploading the JSON to this URI BEFORE calling

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAK5E,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,KAAK,GACL,SAAS,GACT,UAAU,GACV,WAAW,GACX,UAAU,CAAC;AAEf;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,YAAY,GACZ,gBAAgB,GAChB,yBAAyB,CAAC;AAE9B,mDAAmD;AACnD,UAAU,WAAW;IACnB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC;IACvB,2HAA2H;IAC3H,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,IAAI,EAAE,WAAW,CAAC;IAClB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,IAAI,EAAE,UAAU,CAAC;IACjB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,IAAI,EAAE,SAAS,GAAG,UAAU,CAAC;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,gBAAgB,GAAG,eAAe,GAAG,cAAc,CAAC;AAE7F,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,kDAAkD;IAClD,KAAK,EAAE,OAAO,CAAC;IACf,4EAA4E;IAC5E,OAAO,EAAE,SAAS,CAAC;IACnB;;;;;OAKG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB;;;;OAIG;IACH,YAAY,CAAC,EAAE;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,GAAG,CAAC;QAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,17 +1,21 @@
 {
   "name": "@agenticprimitives/agent-profile",
-  "version": "1.0.0-alpha.4",
-  "description": "Agent identity SDK: HCS-11-aligned typed profile schema (AgentCard), HCS-14 CAIP-10 nativeId helpers, mcpServer.verification methods (DNS TXT / signed URL / HTTP challenge / VP), canonical-JSON content-hash. Speaks identity-domain vocabulary only.",
+  "version": "1.0.0-alpha.41",
+  "description": "Agent identity SDK: AP-native Canonical Agent Profile (CanonicalAgentProfileV1) + signed profile bundle, CAIP-10 nativeId helpers, endpoint verification methods, and the A2A 1.0 Agent Card model (./a2a: JCS canonical bytes, ES256 JWS, EIP-712 Smart Agent binding, field provenance, pure validation, import, release lifecycle). External registry projections stay outside Ring 0.",
+  "homepage": "https://agenticprimitives.dev",
+  "bugs": {
+    "url": "https://github.com/agentictrustlabs/agenticprimitives/issues"
+  },
+  "author": {
+    "name": "Agentic Trust Labs",
+    "url": "https://agenticprimitives.dev"
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/agentictrustlabs/agenticprimitives.git",
     "directory": "packages/agent-profile"
   },
-  "homepage": "https://github.com/agentictrustlabs/agenticprimitives/tree/master/packages/agent-profile",
-  "bugs": {
-    "url": "https://github.com/agentictrustlabs/agenticprimitives/issues"
-  },
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -27,6 +31,14 @@
     "./profile": {
       "types": "./dist/profile.d.ts",
       "import": "./dist/profile.js"
+    },
+    "./card": {
+      "types": "./dist/card.d.ts",
+      "import": "./dist/card.js"
+    },
+    "./a2a": {
+      "types": "./dist/a2a/index.d.ts",
+      "import": "./dist/a2a/index.js"
     }
   },
   "files": [
@@ -39,14 +51,14 @@
     "access": "public"
   },
   "peerDependencies": {
-    "viem": "^2.50.0",
-    "@agenticprimitives/agent-account": "1.0.0-alpha.4",
-    "@agenticprimitives/connect-auth": "1.0.0-alpha.4",
-    "@agenticprimitives/types": "1.0.0-alpha.4"
+    "viem": "^2.52.2",
+    "@agenticprimitives/agent-account": "^1.0.0-alpha.41",
+    "@agenticprimitives/connect-auth": "^1.0.0-alpha.41",
+    "@agenticprimitives/types": "^1.0.0-alpha.41"
   },
   "devDependencies": {
     "@types/node": "^22.7.0",
-    "vitest": "^2.1.0"
+    "vitest": "^4.1.11"
   },
   "keywords": [
     "agent",
@@ -55,7 +67,15 @@
     "hcs-14",
     "erc-8004",
     "caip-10",
-    "agentic"
+    "agentic",
+    "a2a",
+    "agent-card",
+    "jws",
+    "agentic-primitives",
+    "agenticprimitives",
+    "ai-agents",
+    "agent-authority",
+    "agentic-trust"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.build.json",

package/spec.md

@@ -1,6 +1,8 @@
 # @agenticprimitives/agent-profile — spec
 
-The full design lives in [`../../specs/217-agent-profile.md`](../../specs/217-agent-profile.md).
+The full design lives in [`../../specs/217-agent-profile.md`](../../specs/217-agent-profile.md) (canonical profile)
+and [`../../specs/347-a2a-agent-card-and-projection-studio.md`](../../specs/347-a2a-agent-card-and-projection-studio.md)
+§3–§4 (the `./a2a` A2A Agent Card model; W1 shipped 2026-08-30).
 
 Architecture decisions:
 
@@ -8,5 +10,7 @@ Architecture decisions:
   — why the identity stack is three packages, not one.
 - [ADR-0008](../../docs/architecture/decisions/0008-caip10-nativeid-record-predicate.md)
   — why we expose CAIP-10 `nativeId` rather than generate UAIDs.
+- [ADR-0062](../../docs/architecture/decisions/0062-agent-card-projection-publication-binding.md)
+  — canonical profile ≠ A2A card; JWS + Smart Agent binding; projections generated from a released card.
 
 Do not edit a divergent copy here — edit the canonical spec.