@agenticprimitives/agent-profile 1.0.0-alpha.21 → 1.0.0-alpha.23

package/dist/distribution.js

@@ -0,0 +1,167 @@
+/**
+ * `AgentDistributionV1` — validation + on-chain string encoding (spec 347 §8.5;
+ * `docs/architecture/ard-acp-crosswalk.md` §2–§3).
+ *
+ * Pure. The wire form is the RFC 8785 (JCS) canonical JSON string of the object, stored as the SA-keyed
+ * `atl:distribution` string property; two semantically-equal distributions encode to identical bytes.
+ * The rules mirror the ACP registry `agent.schema.json` `distribution` definitions exactly (field names,
+ * platform enum, `additionalProperties:false`, `minProperties:1`, sha256 pattern) plus the two AP-owned
+ * fields (`acp`, `version`) and the schema's prose rule that installer archives are unsupported.
+ *
+ * `decodeDistribution` is fail-closed: anything that is not a valid `AgentDistributionV1` is `null` —
+ * an unreadable record is an answer, never a trigger to guess (ADR-0013).
+ */
+import { jcsCanonicalize } from '@agenticprimitives/types';
+import { ACP_PLATFORMS } from './constants.js';
+import { InvalidProfileError } from './errors.js';
+const SHA256_HEX = /^[a-fA-F0-9]{64}$/;
+const SEMVER_PREFIX = /^[0-9]+\.[0-9]+\.[0-9]+/;
+/** Installer formats the ACP schema says are NOT supported for `archive`. */
+const INSTALLER_EXTENSIONS = ['.dmg', '.pkg', '.deb', '.rpm'];
+const TOP_LEVEL_KEYS = new Set(['acp', 'version', 'npx', 'uvx', 'binary']);
+const PACKAGE_KEYS = new Set(['package', 'args', 'env']);
+const BINARY_TARGET_KEYS = new Set(['archive', 'cmd', 'sha256', 'args', 'env']);
+const PLATFORM_SET = new Set(ACP_PLATFORMS);
+const isPlainObject = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+/**
+ * Validate a candidate `AgentDistributionV1`. Returns `[]` when valid, else one human-readable issue per
+ * violation (JSON-pointer-ish `path: reason`). Never throws; accepts `unknown` so a decoded record can be
+ * checked before it is trusted as the type.
+ */
+export function validateDistribution(d) {
+    const issues = [];
+    if (!isPlainObject(d))
+        return ['distribution: must be an object'];
+    for (const k of Object.keys(d)) {
+        if (!TOP_LEVEL_KEYS.has(k))
+            issues.push(`distribution.${k}: unknown property`);
+    }
+    if (d.acp !== undefined && typeof d.acp !== 'boolean')
+        issues.push('distribution.acp: must be a boolean');
+    if (d.version !== undefined) {
+        if (typeof d.version !== 'string' || !SEMVER_PREFIX.test(d.version)) {
+            issues.push('distribution.version: must be a semver string (MAJOR.MINOR.PATCH)');
+        }
+    }
+    if (d.npx !== undefined)
+        issues.push(...validatePackage(d.npx, 'distribution.npx'));
+    if (d.uvx !== undefined)
+        issues.push(...validatePackage(d.uvx, 'distribution.uvx'));
+    if (d.binary !== undefined)
+        issues.push(...validateBinary(d.binary));
+    if (d.npx === undefined && d.uvx === undefined && d.binary === undefined) {
+        issues.push('distribution: at least one of npx, uvx, binary is required');
+    }
+    return issues;
+}
+function validateArgsEnv(o, path) {
+    const issues = [];
+    if (o.args !== undefined) {
+        if (!Array.isArray(o.args) || !o.args.every((a) => typeof a === 'string')) {
+            issues.push(`${path}.args: must be an array of strings`);
+        }
+    }
+    if (o.env !== undefined) {
+        if (!isPlainObject(o.env))
+            issues.push(`${path}.env: must be an object of string values`);
+        else {
+            for (const [k, v] of Object.entries(o.env)) {
+                if (typeof v !== 'string')
+                    issues.push(`${path}.env.${k}: must be a string`);
+            }
+        }
+    }
+    return issues;
+}
+function validatePackage(p, path) {
+    if (!isPlainObject(p))
+        return [`${path}: must be an object`];
+    const issues = [];
+    for (const k of Object.keys(p))
+        if (!PACKAGE_KEYS.has(k))
+            issues.push(`${path}.${k}: unknown property`);
+    if (typeof p.package !== 'string' || p.package.length === 0)
+        issues.push(`${path}.package: must be a non-empty string`);
+    issues.push(...validateArgsEnv(p, path));
+    return issues;
+}
+function validateBinary(b) {
+    const path = 'distribution.binary';
+    if (!isPlainObject(b))
+        return [`${path}: must be an object`];
+    const issues = [];
+    const keys = Object.keys(b);
+    if (keys.length === 0)
+        issues.push(`${path}: at least one platform target is required`);
+    for (const platform of keys) {
+        const tp = `${path}.${platform}`;
+        if (!PLATFORM_SET.has(platform)) {
+            issues.push(`${tp}: unknown platform (allowed: ${ACP_PLATFORMS.join(', ')})`);
+            continue;
+        }
+        const t = b[platform];
+        if (!isPlainObject(t)) {
+            issues.push(`${tp}: must be an object`);
+            continue;
+        }
+        for (const k of Object.keys(t))
+            if (!BINARY_TARGET_KEYS.has(k))
+                issues.push(`${tp}.${k}: unknown property`);
+        issues.push(...validateArchive(t.archive, `${tp}.archive`));
+        if (typeof t.cmd !== 'string' || t.cmd.length === 0)
+            issues.push(`${tp}.cmd: must be a non-empty string`);
+        if (t.sha256 !== undefined && (typeof t.sha256 !== 'string' || !SHA256_HEX.test(t.sha256))) {
+            issues.push(`${tp}.sha256: must be 64 hex characters`);
+        }
+        issues.push(...validateArgsEnv(t, tp));
+    }
+    return issues;
+}
+function validateArchive(archive, path) {
+    if (typeof archive !== 'string' || archive.length === 0)
+        return [`${path}: must be a non-empty string`];
+    let url;
+    try {
+        url = new URL(archive);
+    }
+    catch {
+        return [`${path}: must be an absolute URL`];
+    }
+    if (url.protocol !== 'https:')
+        return [`${path}: must be https`];
+    const lower = url.pathname.toLowerCase();
+    const installer = INSTALLER_EXTENSIONS.find((ext) => lower.endsWith(ext));
+    if (installer)
+        return [`${path}: installer format ${installer} is not supported (use an archive or raw binary)`];
+    return [];
+}
+/**
+ * The on-chain string form: RFC 8785 JCS of the validated object (sorted keys, no whitespace,
+ * `undefined` members omitted). Throws `InvalidProfileError` on any validation issue — the write path is
+ * fail-loud, so an invalid distribution never reaches the chain.
+ */
+export function encodeDistribution(d) {
+    const issues = validateDistribution(d);
+    if (issues.length)
+        throw new InvalidProfileError(issues.join('; '), 'distribution');
+    return jcsCanonicalize(d);
+}
+/**
+ * Parse an on-chain / KB `atl:distribution` string. Fail-closed: not JSON, not an object, or any
+ * validation issue ⇒ `null`. Never throws.
+ */
+export function decodeDistribution(s) {
+    if (typeof s !== 'string' || s.length === 0)
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(s);
+    }
+    catch {
+        return null;
+    }
+    if (validateDistribution(parsed).length)
+        return null;
+    return parsed;
+}
+//# sourceMappingURL=distribution.js.map

package/dist/distribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distribution.js","sourceRoot":"","sources":["../src/distribution.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -19,4 +19,10 @@ export declare class InvalidCaip10Error extends Error {
     readonly reason: string;
     constructor(value: string, reason: string);
 }
+/** `publishProfile` refused: the card's `type` disagrees with the SA's on-chain `atl:agentType` (spec 346 §3.6 step 5). */
+export declare class ProfileTypeMismatchError extends Error {
+    readonly profileType: string;
+    readonly declaredType: string;
+    constructor(profileType: string, declaredType: string);
+}
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAoB,SAAQ,KAAK;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM;gBAAvC,MAAM,EAAE,MAAM,EAAW,KAAK,CAAC,EAAE,MAAM,YAAA;CAO7D;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAAzC,QAAQ,EAAE,MAAM,EAAW,MAAM,EAAE,MAAM;CAM/D;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAAlE,MAAM,EAAE,MAAM,EAAW,QAAQ,EAAE,MAAM,EAAW,MAAM,EAAE,MAAM;CAIxF;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAAtC,KAAK,EAAE,MAAM,EAAW,MAAM,EAAE,MAAM;CAI5D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAoB,SAAQ,KAAK;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM;gBAAvC,MAAM,EAAE,MAAM,EAAW,KAAK,CAAC,EAAE,MAAM,YAAA;CAO7D;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAAzC,QAAQ,EAAE,MAAM,EAAW,MAAM,EAAE,MAAM;CAM/D;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAAlE,MAAM,EAAE,MAAM,EAAW,QAAQ,EAAE,MAAM,EAAW,MAAM,EAAE,MAAM;CAIxF;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAAtC,KAAK,EAAE,MAAM,EAAW,MAAM,EAAE,MAAM;CAI5D;AAED,2HAA2H;AAC3H,qBAAa,wBAAyB,SAAQ,KAAK;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM;gBAAlD,WAAW,EAAE,MAAM,EAAW,YAAY,EAAE,MAAM;CAIxE"}

package/dist/errors.js

@@ -41,4 +41,15 @@ export class InvalidCaip10Error extends Error {
         this.name = 'InvalidCaip10Error';
     }
 }
+/** `publishProfile` refused: the card's `type` disagrees with the SA's on-chain `atl:agentType` (spec 346 §3.6 step 5). */
+export class ProfileTypeMismatchError extends Error {
+    profileType;
+    declaredType;
+    constructor(profileType, declaredType) {
+        super(`[agent-profile] profile type "${profileType}" is inconsistent with the agent's declared derived type "${declaredType}"`);
+        this.profileType = profileType;
+        this.declaredType = declaredType;
+        this.name = 'ProfileTypeMismatchError';
+    }
+}
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACvB;IAAyB;IAA9C,YAAqB,MAAc,EAAW,KAAc;QAC1D,KAAK,CACH,oCAAoC,MAAM,EAAE;YAC1C,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CACtC,CAAC;QAJiB,WAAM,GAAN,MAAM,CAAQ;QAAW,UAAK,GAAL,KAAK,CAAS;QAK1D,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAC5B;IAA2B;IAAhD,YAAqB,QAAgB,EAAW,MAAc;QAC5D,KAAK,CACH,4DAA4D,QAAQ,gBAAgB,MAAM,EAAE,CAC7F,CAAC;QAHiB,aAAQ,GAAR,QAAQ,CAAQ;QAAW,WAAM,GAAN,MAAM,CAAQ;QAI5D,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAC7B;IAAyB;IAA2B;IAAzE,YAAqB,MAAc,EAAW,QAAgB,EAAW,MAAc;QACrF,KAAK,CAAC,mBAAmB,MAAM,4BAA4B,QAAQ,KAAK,MAAM,EAAE,CAAC,CAAC;QAD/D,WAAM,GAAN,MAAM,CAAQ;QAAW,aAAQ,GAAR,QAAQ,CAAQ;QAAW,WAAM,GAAN,MAAM,CAAQ;QAErF,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACtB;IAAwB;IAA7C,YAAqB,KAAa,EAAW,MAAc;QACzD,KAAK,CAAC,oCAAoC,KAAK,MAAM,MAAM,EAAE,CAAC,CAAC;QAD5C,UAAK,GAAL,KAAK,CAAQ;QAAW,WAAM,GAAN,MAAM,CAAQ;QAEzD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACvB;IAAyB;IAA9C,YAAqB,MAAc,EAAW,KAAc;QAC1D,KAAK,CACH,oCAAoC,MAAM,EAAE;YAC1C,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CACtC,CAAC;QAJiB,WAAM,GAAN,MAAM,CAAQ;QAAW,UAAK,GAAL,KAAK,CAAS;QAK1D,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAC5B;IAA2B;IAAhD,YAAqB,QAAgB,EAAW,MAAc;QAC5D,KAAK,CACH,4DAA4D,QAAQ,gBAAgB,MAAM,EAAE,CAC7F,CAAC;QAHiB,aAAQ,GAAR,QAAQ,CAAQ;QAAW,WAAM,GAAN,MAAM,CAAQ;QAI5D,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAC7B;IAAyB;IAA2B;IAAzE,YAAqB,MAAc,EAAW,QAAgB,EAAW,MAAc;QACrF,KAAK,CAAC,mBAAmB,MAAM,4BAA4B,QAAQ,KAAK,MAAM,EAAE,CAAC,CAAC;QAD/D,WAAM,GAAN,MAAM,CAAQ;QAAW,aAAQ,GAAR,QAAQ,CAAQ;QAAW,WAAM,GAAN,MAAM,CAAQ;QAErF,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACtB;IAAwB;IAA7C,YAAqB,KAAa,EAAW,MAAc;QACzD,KAAK,CAAC,oCAAoC,KAAK,MAAM,MAAM,EAAE,CAAC,CAAC;QAD5C,UAAK,GAAL,KAAK,CAAQ;QAAW,WAAM,GAAN,MAAM,CAAQ;QAEzD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,2HAA2H;AAC3H,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAC5B;IAA8B;IAAnD,YAAqB,WAAmB,EAAW,YAAoB;QACrE,KAAK,CAAC,iCAAiC,WAAW,6DAA6D,YAAY,GAAG,CAAC,CAAC;QAD7G,gBAAW,GAAX,WAAW,CAAQ;QAAW,iBAAY,GAAZ,YAAY,CAAQ;QAErE,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF"}

package/dist/index.d.ts

@@ -1,10 +1,12 @@
-export { CAIP10_NAMESPACE_ALLOWLIST, AGENT_CARD_SCHEMA_VERSION, AUTH_ORIGIN, } from './constants.js';
+export { CAIP10_NAMESPACE_ALLOWLIST, AGENT_CARD_SCHEMA_VERSION, AUTH_ORIGIN, AGENT_TYPE, SERVICE_ROLE, DISTRIBUTION, ACP_PLATFORMS, } from './constants.js';
+export { validateDistribution, encodeDistribution, decodeDistribution, } from './distribution.js';
+export { derivedTypeId, decodeDerivedTypeId, profileTypesForDerivedType, isProfileTypeConsistent, } from './derived-type.js';
 export { buildCaip10Address, parseCaip10, isValidCaip10, type Caip10Parts, } from './caip10.js';
 export { canonicalProfileJson, profileContentHash, } from './profile.js';
-export { hashAgentCard, buildSignedAgentCardBundle, verifySignedAgentCardBundle, type Erc1271Verifier, type SmartAgentCardSigner, type BuildSignedAgentCardInput, type VerifySignedAgentCardResult, } from './card.js';
-export { InvalidProfileError, ProfileHashMismatchError, EndpointVerificationError, InvalidCaip10Error, } from './errors.js';
-export type { ProfileType, Caip10Address, VerificationMethod, AiAgentProfile, McpServerProfile, MultisigProfile, ServiceProfile, AgentCard, Sha256, SignedAgentCardBundleV1, AgentIdentityClientOpts, PublishProfileInput, } from './types.js';
+export { hashCanonicalProfile, buildSignedCanonicalProfileBundle, verifySignedCanonicalProfileBundle, hashAgentCard, buildSignedAgentCardBundle, verifySignedAgentCardBundle, type Erc1271Verifier, type SmartAgentCardSigner, type BuildSignedAgentCardInput, type VerifySignedAgentCardResult, } from './card.js';
+export { InvalidProfileError, ProfileHashMismatchError, EndpointVerificationError, InvalidCaip10Error, ProfileTypeMismatchError, } from './errors.js';
+export type { ProfileType, Caip10Address, VerificationMethod, AiAgentProfile, McpServerProfile, MultisigProfile, ServiceProfile, CanonicalAgentProfileV1, AcpPlatform, AgentPackageDistributionV1, AgentBinaryTargetV1, AgentDistributionV1, ProtocolFeatureSetV1, Sha256, SignedCanonicalProfileBundleV1, AgentCard, SignedAgentCardBundleV1, AgentIdentityClientOpts, PublishProfileInput, } from './types.js';
 export { AgentIdentityClient, type WriteContext } from './client.js';
 export { agentProfileResolverAbi } from './abis.js';
-export { buildRegisterProfileCall, buildSetProfileMetadataCall, buildSetProfileStringCall, buildSetProfileAddressCall, buildSetProfileBytes32Call, buildSetProfileActiveCall, type ContractCall, } from './calls.js';
+export { buildRegisterProfileCall, buildSetProfileMetadataCall, buildSetProfileStringCall, buildSetDistributionCall, buildSetProfileAddressCall, buildSetProfileBytes32Call, buildSetProfileActiveCall, type ContractCall, } from './calls.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,aAAa,EACb,0BAA0B,EAC1B,2BAA2B,EAC3B,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,GACjC,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,SAAS,EACT,MAAM,EACN,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAMrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAIpD,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,EACzB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,WAAW,EACX,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAItB,OAAO,EACL,oBAAoB,EACpB,iCAAiC,EACjC,kCAAkC,EAElC,aAAa,EACb,0BAA0B,EAC1B,2BAA2B,EAC3B,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,GACjC,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,WAAW,EACX,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,MAAM,EACN,8BAA8B,EAE9B,SAAS,EACT,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAMrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAIpD,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,EACzB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -6,12 +6,19 @@
 //   - specs/217-agent-profile.md — the contract
 //   - docs/architecture/decisions/0007-agent-identity-stack-three-packages.md
 //   - docs/architecture/decisions/0008-caip10-nativeid-record-predicate.md
-export { CAIP10_NAMESPACE_ALLOWLIST, AGENT_CARD_SCHEMA_VERSION, AUTH_ORIGIN, } from './constants.js';
+export { CAIP10_NAMESPACE_ALLOWLIST, AGENT_CARD_SCHEMA_VERSION, AUTH_ORIGIN, AGENT_TYPE, SERVICE_ROLE, DISTRIBUTION, ACP_PLATFORMS, } from './constants.js';
+// `distribution` canonical-profile fact (spec 347 §8.5): how to obtain + run the agent's software.
+export { validateDistribution, encodeDistribution, decodeDistribution, } from './distribution.js';
+// Derived-type consistency (spec 346 §2.3 / §6.2).
+export { derivedTypeId, decodeDerivedTypeId, profileTypesForDerivedType, isProfileTypeConsistent, } from './derived-type.js';
 export { buildCaip10Address, parseCaip10, isValidCaip10, } from './caip10.js';
 export { canonicalProfileJson, profileContentHash, } from './profile.js';
-// Signed agent card bundle (spec 279 §3.2) — prove `cardHash → subjectAgent` without trusting the server.
-export { hashAgentCard, buildSignedAgentCardBundle, verifySignedAgentCardBundle, } from './card.js';
-export { InvalidProfileError, ProfileHashMismatchError, EndpointVerificationError, InvalidCaip10Error, } from './errors.js';
+// Signed canonical-profile bundle (spec 279 §3.2) — prove `cardHash → subjectAgent` without trusting the
+// server. NOT the A2A Agent Card: that is `@agenticprimitives/agent-profile/a2a` (spec 347 §4).
+export { hashCanonicalProfile, buildSignedCanonicalProfileBundle, verifySignedCanonicalProfileBundle, 
+// @deprecated pre-spec-347 names (one release).
+hashAgentCard, buildSignedAgentCardBundle, verifySignedAgentCardBundle, } from './card.js';
+export { InvalidProfileError, ProfileHashMismatchError, EndpointVerificationError, InvalidCaip10Error, ProfileTypeMismatchError, } from './errors.js';
 export { AgentIdentityClient } from './client.js';
 // Phase 3 contract ABIs (live at deployed addresses recorded in
 // packages/contracts/deployments-<network>.json). Profile resolver
@@ -20,5 +27,5 @@ export { AgentIdentityClient } from './client.js';
 export { agentProfileResolverAbi } from './abis.js';
 // Phase 4 pure call builders. Compose into AgentAccount.execute /
 // CustodyPolicy ceremonies / ERC-4337 UserOps as needed.
-export { buildRegisterProfileCall, buildSetProfileMetadataCall, buildSetProfileStringCall, buildSetProfileAddressCall, buildSetProfileBytes32Call, buildSetProfileActiveCall, } from './calls.js';
+export { buildRegisterProfileCall, buildSetProfileMetadataCall, buildSetProfileStringCall, buildSetDistributionCall, buildSetProfileAddressCall, buildSetProfileBytes32Call, buildSetProfileActiveCall, } from './calls.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,OAAO;AACP,0CAA0C;AAC1C,2BAA2B;AAC3B,gDAAgD;AAChD,8EAA8E;AAC9E,2EAA2E;AAE3E,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,aAAa,GAEd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAEtB,0GAA0G;AAC1G,OAAO,EACL,aAAa,EACb,0BAA0B,EAC1B,2BAA2B,GAK5B,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAiBrB,OAAO,EAAE,mBAAmB,EAAqB,MAAM,aAAa,CAAC;AAErE,gEAAgE;AAChE,mEAAmE;AACnE,+DAA+D;AAC/D,0CAA0C;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAEpD,kEAAkE;AAClE,yDAAyD;AACzD,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,GAE1B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,OAAO;AACP,0CAA0C;AAC1C,2BAA2B;AAC3B,gDAAgD;AAChD,8EAA8E;AAC9E,2EAA2E;AAE3E,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,WAAW,EACX,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,mGAAmG;AACnG,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,mDAAmD;AACnD,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,aAAa,GAEd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAEtB,yGAAyG;AACzG,gGAAgG;AAChG,OAAO,EACL,oBAAoB,EACpB,iCAAiC,EACjC,kCAAkC;AAClC,gDAAgD;AAChD,aAAa,EACb,0BAA0B,EAC1B,2BAA2B,GAK5B,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAyBrB,OAAO,EAAE,mBAAmB,EAAqB,MAAM,aAAa,CAAC;AAErE,gEAAgE;AAChE,mEAAmE;AACnE,+DAA+D;AAC/D,0CAA0C;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAEpD,kEAAkE;AAClE,yDAAyD;AACzD,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,GAE1B,MAAM,YAAY,CAAC"}

package/dist/profile.d.ts

@@ -1,5 +1,5 @@
 /**
- * Canonical-JSON serialization + content-hash for AgentCard profiles.
+ * Canonical-JSON serialization + content-hash for CanonicalAgentProfileV1 profiles (the AP-native profile — NOT the A2A card).
  *
  * Subpath: `@agenticprimitives/agent-profile/profile`.
  *
@@ -7,7 +7,7 @@
  * in agent-naming. Two semantically-equal profiles MUST produce the
  * same hash — sort keys, fixed numeric format, no whitespace.
  */
-import type { AgentCard } from './types.js';
+import type { CanonicalAgentProfileV1 } from './types.js';
 /**
  * Canonical-JSON encoding. Sorts object keys recursively, omits
  * `undefined`, refuses non-finite numbers, refuses functions.
@@ -15,11 +15,11 @@ import type { AgentCard } from './types.js';
  * Note: `JSON.stringify` does NOT sort keys, so we do it manually.
  * Arrays preserve insertion order (semantically meaningful).
  */
-export declare function canonicalProfileJson(profile: AgentCard): string;
+export declare function canonicalProfileJson(profile: CanonicalAgentProfileV1): string;
 /**
  * Keccak-256 of the canonical-JSON encoding of a profile. Matches
  * the `metadata-hash` predicate in `agent-naming/records`. Stable
  * across runtimes — UTF-8 byte-level deterministic.
  */
-export declare function profileContentHash(profile: AgentCard): `0x${string}`;
+export declare function profileContentHash(profile: CanonicalAgentProfileV1): `0x${string}`;
 //# sourceMappingURL=profile.d.ts.map

package/dist/profile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,CAI/D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,GAAG,KAAK,MAAM,EAAE,CAGpE"}
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAI7E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,GAAG,KAAK,MAAM,EAAE,CAGlF"}

package/dist/profile.js

@@ -1,5 +1,5 @@
 /**
- * Canonical-JSON serialization + content-hash for AgentCard profiles.
+ * Canonical-JSON serialization + content-hash for CanonicalAgentProfileV1 profiles (the AP-native profile — NOT the A2A card).
  *
  * Subpath: `@agenticprimitives/agent-profile/profile`.
  *
@@ -9,6 +9,7 @@
  */
 import { keccak256, toHex } from 'viem';
 import { AGENT_CARD_SCHEMA_VERSION } from './constants.js';
+import { validateDistribution } from './distribution.js';
 import { InvalidProfileError } from './errors.js';
 /**
  * Canonical-JSON encoding. Sorts object keys recursively, omits
@@ -42,6 +43,10 @@ function validateProfile(profile) {
     switch (profile.type) {
         case 'person':
         case 'org':
+        case 'team':
+        case 'alliance':
+        case 'church':
+        case 'circle':
         case 'service':
         case 'treasury':
         case 'mcpServer':
@@ -50,6 +55,12 @@ function validateProfile(profile) {
         default:
             throw new InvalidProfileError(`unknown profile.type "${profile.type}"`, 'type');
     }
+    // spec 347 §8.5 — an invalid `distribution` never reaches the content hash / the chain (fail-loud on write).
+    if (profile.distribution !== undefined) {
+        const issues = validateDistribution(profile.distribution);
+        if (issues.length)
+            throw new InvalidProfileError(issues.join('; '), 'distribution');
+    }
     if (profile.type === 'mcpServer') {
         if (typeof profile.endpoint !== 'string' || profile.endpoint.length === 0) {
             throw new InvalidProfileError('mcpServer profile requires endpoint', 'endpoint');

package/dist/profile.js.map

@@ -1 +1 @@
-{"version":3,"file":"profile.js","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgC;IACnE,eAAe,CAAC,OAAO,CAAC,CAAC;IACzB,MAAM,WAAW,GAAG,EAAE,GAAG,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAE,CAAC;IAC7E,OAAO,sBAAsB,CAAC,WAAW,CAAC,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgC;IACjE,MAAM,IAAI,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,uEAAuE;AAEvE,SAAS,eAAe,CAAC,OAAgC;IACvD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,IAAI,mBAAmB,CAAC,2BAA2B,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACrC,MAAM,IAAI,mBAAmB,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC;IACD,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,QAAQ,CAAC;QACd,KAAK,KAAK,CAAC;QACX,KAAK,MAAM,CAAC;QACZ,KAAK,UAAU,CAAC;QAChB,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC;QACf,KAAK,UAAU,CAAC;QAChB,KAAK,WAAW,CAAC;QACjB,KAAK,UAAU;YACb,MAAM;QACR;YACE,MAAM,IAAI,mBAAmB,CAAC,yBAA0B,OAA4B,CAAC,IAAI,GAAG,EAAE,MAAM,CAAC,CAAC;IAC1G,CAAC;IACD,6GAA6G;IAC7G,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC1D,IAAI,MAAM,CAAC,MAAM;YAAE,MAAM,IAAI,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACjC,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1E,MAAM,IAAI,mBAAmB,CAAC,qCAAqC,EAAE,UAAU,CAAC,CAAC;QACnF,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9E,MAAM,IAAI,mBAAmB,CAAC,6DAA6D,EAAE,cAAc,CAAC,CAAC;QAC/G,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpE,MAAM,IAAI,mBAAmB,CAAC,+CAA+C,EAAE,SAAS,CAAC,CAAC;QAC5F,CAAC;QACD,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,IAAI,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACjH,MAAM,IAAI,mBAAmB,CAC3B,0DAA0D,OAAO,CAAC,SAAS,GAAG,EAC9E,WAAW,CACZ,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,sBAAsB,CAAC,KAAc;IAC5C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAChE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,mBAAmB,CAAC,qBAAqB,KAAK,gCAAgC,CAAC,CAAC;QAC5F,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC5D,IAAI,OAAO,KAAK,KAAK,UAAU,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,WAAW,EAAE,CAAC;QAC7F,MAAM,IAAI,mBAAmB,CAAC,iBAAiB,OAAO,KAAK,gCAAgC,CAAC,CAAC;IAC/F,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACjE,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC;aAC7D,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC;aAClC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,OAAO,CACL,GAAG;YACH,OAAO;iBACJ,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC;iBACpE,IAAI,CAAC,GAAG,CAAC;YACZ,GAAG,CACJ,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,mBAAmB,CAAC,6BAA6B,OAAO,KAAK,EAAE,CAAC,CAAC;AAC7E,CAAC"}

package/dist/types.d.ts

@@ -1,4 +1,5 @@
-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 AP-native AgentCard sub-shapes. Borrows the useful
@@ -11,7 +12,7 @@ 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. Inspired by external agent-card
  * verification patterns, but not tied to any DNS/PKI registry integration.
@@ -25,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`). */
@@ -37,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[];
 }
@@ -63,8 +144,21 @@ 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;
 }
-export type AgentCard = AiAgentProfile | McpServerProfile | MultisigProfile | ServiceProfile;
+/**
+ * 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}`;
@@ -74,9 +168,10 @@ export type Sha256 = `sha256:${string}`;
  * 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 SignedAgentCardBundleV1 {
+export interface SignedCanonicalProfileBundleV1 {
+    /** Wire discriminator unchanged by the spec-347 rename — existing signed bundles stay valid. */
     type: 'SignedAgentCardBundleV1';
-    card: AgentCard;
+    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). */
@@ -93,6 +188,8 @@ export interface SignedAgentCardBundleV1 {
         signature: Hex;
     };
 }
+/** @deprecated Renamed `SignedCanonicalProfileBundleV1` (spec 347 §0.3). Alias kept for one release. */
+export type SignedAgentCardBundleV1 = SignedCanonicalProfileBundleV1;
 export interface AgentIdentityClientOpts {
     rpcUrl: string;
     chainId: number;
@@ -106,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":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agenticprimitives/agent-profile",
-  "version": "1.0.0-alpha.21",
-  "description": "Agent identity SDK: AP-native typed profile/card schema (AgentCard), CAIP-10 nativeId helpers, endpoint verification methods (DNS TXT / signed URL / HTTP challenge / VP), canonical-JSON content-hash. External registry projections stay outside Ring 0.",
+  "version": "1.0.0-alpha.23",
+  "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.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -31,6 +31,10 @@
     "./card": {
       "types": "./dist/card.d.ts",
       "import": "./dist/card.js"
+    },
+    "./a2a": {
+      "types": "./dist/a2a/index.d.ts",
+      "import": "./dist/a2a/index.js"
     }
   },
   "files": [
@@ -44,9 +48,9 @@
   },
   "peerDependencies": {
     "viem": "^2.52.2",
-    "@agenticprimitives/agent-account": "1.0.0-alpha.21",
-    "@agenticprimitives/connect-auth": "1.0.0-alpha.21",
-    "@agenticprimitives/types": "1.0.0-alpha.21"
+    "@agenticprimitives/agent-account": "1.0.0-alpha.23",
+    "@agenticprimitives/connect-auth": "1.0.0-alpha.23",
+    "@agenticprimitives/types": "1.0.0-alpha.23"
   },
   "devDependencies": {
     "@types/node": "^22.7.0",
@@ -59,7 +63,10 @@
     "hcs-14",
     "erc-8004",
     "caip-10",
-    "agentic"
+    "agentic",
+    "a2a",
+    "agent-card",
+    "jws"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.build.json",