@agenticprimitives/agent-profile 0.1.0-alpha.2

package/dist/errors.js

@@ -0,0 +1,44 @@
+export class InvalidProfileError extends Error {
+    reason;
+    field;
+    constructor(reason, field) {
+        super(`[agent-profile] invalid profile: ${reason}` +
+            (field ? ` (field: ${field})` : ''));
+        this.reason = reason;
+        this.field = field;
+        this.name = 'InvalidProfileError';
+    }
+}
+export class ProfileHashMismatchError extends Error {
+    expected;
+    actual;
+    constructor(expected, actual) {
+        super(`[agent-profile] profile content-hash mismatch — on-chain ${expected} vs computed ${actual}`);
+        this.expected = expected;
+        this.actual = actual;
+        this.name = 'ProfileHashMismatchError';
+    }
+}
+export class EndpointVerificationError extends Error {
+    method;
+    endpoint;
+    reason;
+    constructor(method, endpoint, reason) {
+        super(`[agent-profile] ${method} verification failed for ${endpoint}: ${reason}`);
+        this.method = method;
+        this.endpoint = endpoint;
+        this.reason = reason;
+        this.name = 'EndpointVerificationError';
+    }
+}
+export class InvalidCaip10Error extends Error {
+    value;
+    reason;
+    constructor(value, reason) {
+        super(`[agent-profile] invalid CAIP-10 "${value}": ${reason}`);
+        this.value = value;
+        this.reason = reason;
+        this.name = 'InvalidCaip10Error';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +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"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { CAIP10_NAMESPACE_ALLOWLIST, AGENT_CARD_SCHEMA_VERSION, AUTH_ORIGIN, } from './constants';
+export { buildCaip10Address, parseCaip10, isValidCaip10, type Caip10Parts, } from './caip10';
+export { canonicalProfileJson, profileContentHash, } from './profile';
+export { InvalidProfileError, ProfileHashMismatchError, EndpointVerificationError, InvalidCaip10Error, } from './errors';
+export type { ProfileType, Caip10Address, VerificationMethod, AiAgentProfile, McpServerProfile, MultisigProfile, ServiceProfile, AgentCard, AgentIdentityClientOpts, PublishProfileInput, } from './types';
+export { AgentIdentityClient, type WriteContext } from './client';
+export { agentProfileResolverAbi } from './abis';
+export { buildRegisterProfileCall, buildSetProfileMetadataCall, buildSetProfileStringCall, buildSetProfileAddressCall, buildSetProfileBytes32Call, buildSetProfileActiveCall, type ContractCall, } from './calls';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,KAAK,WAAW,GACjB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,SAAS,EACT,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,mBAAmB,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAMlE,OAAO,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AAIjD,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,EACzB,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+// @agenticprimitives/agent-profile — public API.
+//
+// See:
+//   - capability.manifest.json — boundary
+//   - CLAUDE.md — doctrine
+//   - 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';
+export { buildCaip10Address, parseCaip10, isValidCaip10, } from './caip10';
+export { canonicalProfileJson, profileContentHash, } from './profile';
+export { InvalidProfileError, ProfileHashMismatchError, EndpointVerificationError, InvalidCaip10Error, } from './errors';
+export { AgentIdentityClient } from './client';
+// Phase 3 contract ABIs (live at deployed addresses recorded in
+// packages/contracts/deployments-<network>.json). Profile resolver
+// inherits AttributeStorage; predicates governed by the shared
+// OntologyTermRegistry from agent-naming.
+export { agentProfileResolverAbi } from './abis';
+// 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';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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,aAAa,CAAC;AAErB,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,aAAa,GAEd,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAelB,OAAO,EAAE,mBAAmB,EAAqB,MAAM,UAAU,CAAC;AAElE,gEAAgE;AAChE,mEAAmE;AACnE,+DAA+D;AAC/D,0CAA0C;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AAEjD,kEAAkE;AAClE,yDAAyD;AACzD,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,GAE1B,MAAM,SAAS,CAAC"}

package/dist/profile.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Canonical-JSON serialization + content-hash for AgentCard profiles.
+ *
+ * Subpath: `@agenticprimitives/agent-profile/profile`.
+ *
+ * The hash is used as the on-chain `metadata-hash` record predicate
+ * in agent-naming. Two semantically-equal profiles MUST produce the
+ * same hash — sort keys, fixed numeric format, no whitespace.
+ */
+import type { AgentCard } from './types';
+/**
+ * Canonical-JSON encoding. Sorts object keys recursively, omits
+ * `undefined`, refuses non-finite numbers, refuses functions.
+ *
+ * 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;
+/**
+ * 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}`;
+//# sourceMappingURL=profile.d.ts.map

package/dist/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;;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"}

package/dist/profile.js

@@ -0,0 +1,101 @@
+/**
+ * Canonical-JSON serialization + content-hash for AgentCard profiles.
+ *
+ * Subpath: `@agenticprimitives/agent-profile/profile`.
+ *
+ * The hash is used as the on-chain `metadata-hash` record predicate
+ * in agent-naming. Two semantically-equal profiles MUST produce the
+ * same hash — sort keys, fixed numeric format, no whitespace.
+ */
+import { keccak256, toHex } from 'viem';
+import { AGENT_CARD_SCHEMA_VERSION } from './constants';
+import { InvalidProfileError } from './errors';
+/**
+ * Canonical-JSON encoding. Sorts object keys recursively, omits
+ * `undefined`, refuses non-finite numbers, refuses functions.
+ *
+ * Note: `JSON.stringify` does NOT sort keys, so we do it manually.
+ * Arrays preserve insertion order (semantically meaningful).
+ */
+export function canonicalProfileJson(profile) {
+    validateProfile(profile);
+    const withVersion = { ...profile, schemaVersion: AGENT_CARD_SCHEMA_VERSION };
+    return canonicalJsonStringify(withVersion);
+}
+/**
+ * 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 function profileContentHash(profile) {
+    const json = canonicalProfileJson(profile);
+    return keccak256(toHex(json));
+}
+// ─── Internal ───────────────────────────────────────────────────────
+function validateProfile(profile) {
+    if (!profile || typeof profile !== 'object') {
+        throw new InvalidProfileError('profile must be an object');
+    }
+    if (typeof profile.type !== 'string') {
+        throw new InvalidProfileError('profile.type is required', 'type');
+    }
+    switch (profile.type) {
+        case 'person':
+        case 'org':
+        case 'service':
+        case 'treasury':
+        case 'mcpServer':
+        case 'multisig':
+            break;
+        default:
+            throw new InvalidProfileError(`unknown profile.type "${profile.type}"`, 'type');
+    }
+    if (profile.type === 'mcpServer') {
+        if (typeof profile.endpoint !== 'string' || profile.endpoint.length === 0) {
+            throw new InvalidProfileError('mcpServer profile requires endpoint', 'endpoint');
+        }
+        if (!Array.isArray(profile.verification) || profile.verification.length === 0) {
+            throw new InvalidProfileError('mcpServer profile requires at least one verification method', 'verification');
+        }
+    }
+    if (profile.type === 'multisig') {
+        if (!Array.isArray(profile.members) || profile.members.length === 0) {
+            throw new InvalidProfileError('multisig profile requires at least one member', 'members');
+        }
+        if (typeof profile.threshold !== 'number' || profile.threshold < 1 || profile.threshold > profile.members.length) {
+            throw new InvalidProfileError(`multisig threshold must be in [1, members.length] (got ${profile.threshold})`, 'threshold');
+        }
+    }
+}
+function canonicalJsonStringify(value) {
+    if (value === null)
+        return 'null';
+    if (typeof value === 'boolean')
+        return value ? 'true' : 'false';
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value)) {
+            throw new InvalidProfileError(`non-finite number ${value} not allowed in canonical JSON`);
+        }
+        return JSON.stringify(value);
+    }
+    if (typeof value === 'string')
+        return JSON.stringify(value);
+    if (typeof value === 'function' || typeof value === 'symbol' || typeof value === 'undefined') {
+        throw new InvalidProfileError(`value of type ${typeof value} not allowed in canonical JSON`);
+    }
+    if (Array.isArray(value)) {
+        return '[' + value.map(canonicalJsonStringify).join(',') + ']';
+    }
+    if (typeof value === 'object') {
+        const entries = Object.entries(value)
+            .filter(([, v]) => v !== undefined)
+            .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+        return ('{' +
+            entries
+                .map(([k, v]) => JSON.stringify(k) + ':' + canonicalJsonStringify(v))
+                .join(',') +
+            '}');
+    }
+    throw new InvalidProfileError(`unsupported value of type ${typeof value}`);
+}
+//# sourceMappingURL=profile.js.map

package/dist/profile.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,102 @@
+import type { Address, Hex, Caip10Address } from '@agenticprimitives/types';
+export type { Caip10Address };
+/**
+ * Discriminator for AgentCard sub-shapes. Mirrors HCS-11 § typed-profile
+ * categories with two additions specific to our model:
+ *   - `treasury` (custody-policy-governed asset account)
+ *   - `multisig` (collective Smart Agent with named members)
+ *
+ * Adding a new ProfileType requires: (a) a new sub-interface here,
+ * (b) handling in `canonicalProfileJson`, (c) a golden vector test
+ * in `test/profile.test.ts`.
+ */
+export type ProfileType = 'person' | 'org' | 'service' | 'treasury' | 'mcpServer' | 'multisig';
+/**
+ * Endpoint-control verification methods (matches GoDaddy ANS
+ * `mcpServer.verification` pattern; we don't import their PKI).
+ *
+ * - `dns-txt` — owner publishes a TXT record at a known label;
+ *   resolver fetches and matches against the on-chain digest.
+ * - `signed-url` — endpoint URL signed by the owner Smart Agent's
+ *   ERC-1271 key.
+ * - `http-challenge` — well-known path returns a value derived
+ *   from the agent address.
+ * - `verifiable-presentation` — W3C VP signed by the owner.
+ */
+export type VerificationMethod = 'dns-txt' | 'signed-url' | 'http-challenge' | 'verifiable-presentation';
+/** Common fields across all profile sub-shapes. */
+interface BaseProfile {
+    /** Human-friendly display name (may differ from agent-naming `displayName`). */
+    displayName?: string;
+    /** Free-text description. */
+    description?: string;
+    /** External profile / brand URL. */
+    homepage?: string;
+    /** Optional CAIP-10 chain-agnostic identifier (ADR-0008). */
+    nativeId?: Caip10Address;
+    /** Optional avatar / logo URL. */
+    avatar?: string;
+}
+export interface AiAgentProfile extends BaseProfile {
+    type: 'person' | 'org';
+    /** For `org`: list of member Smart Agent addresses (informational only — authority lives in agent-relationships edges). */
+    members?: Address[];
+}
+export interface McpServerProfile extends BaseProfile {
+    type: 'mcpServer';
+    /** Canonical MCP endpoint URL. */
+    endpoint: string;
+    /** Verification methods the owner publishes for this endpoint. */
+    verification: VerificationMethod[];
+    /** Optional list of tool names the server exposes (for discovery UIs). */
+    tools?: string[];
+}
+export interface MultisigProfile extends BaseProfile {
+    type: 'multisig';
+    /** Threshold for the collective Smart Agent's CustodyPolicy. */
+    threshold: number;
+    /** Named members — each member's Smart Agent address. */
+    members: Address[];
+}
+export interface ServiceProfile extends BaseProfile {
+    type: 'service' | 'treasury';
+    /** Canonical service endpoint (A2A / MCP / HTTP). */
+    endpoint?: string;
+}
+export type AgentCard = AiAgentProfile | McpServerProfile | MultisigProfile | ServiceProfile;
+export interface AgentIdentityClientOpts {
+    rpcUrl: string;
+    chainId: number;
+}
+/**
+ * Input to `AgentIdentityClient.publishProfile`. The client computes
+ * `profileContentHash` from `profile` and asserts it matches the
+ * caller-supplied `expectedHash` (anti-mutation invariant).
+ */
+export interface PublishProfileInput {
+    /** Smart Agent address publishing the profile. */
+    agent: Address;
+    /** Profile JSON to publish. The SDK computes its canonical content-hash. */
+    profile: AgentCard;
+    /**
+     * URI where the canonical-JSON profile is hosted. The caller is
+     * responsible for uploading the JSON to this URI BEFORE calling
+     * publishProfile — storage is intentionally out of the SDK's scope
+     * (per ADR-0007: identity stack stays storage-agnostic).
+     */
+    metadataURI: string;
+    /** Optional caller-computed hash for self-check (asserted == computed). */
+    expectedHash?: Hex;
+    /**
+     * For first-time publication only — registers the agent's profile
+     * with these initial fields before setting the metadata anchor.
+     * Omit (or pass {}) once the agent has already called `register`.
+     */
+    registerWith?: {
+        displayName?: string;
+        description?: string;
+        agentKind?: Hex;
+        profileSchemaURI?: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@agenticprimitives/agent-profile",
+  "version": "0.1.0-alpha.2",
+  "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.",
+  "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",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./caip10": {
+      "types": "./dist/caip10.d.ts",
+      "import": "./dist/caip10.js"
+    },
+    "./profile": {
+      "types": "./dist/profile.d.ts",
+      "import": "./dist/profile.js"
+    }
+  },
+  "files": [
+    "LICENSE",
+    "dist",
+    "spec.md",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@agenticprimitives/agent-account": "workspace:*",
+    "@agenticprimitives/connect-auth": "workspace:*",
+    "@agenticprimitives/types": "workspace:*",
+    "viem": "^2.50.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.7.0",
+    "vitest": "^2.1.0"
+  },
+  "keywords": [
+    "agent",
+    "identity",
+    "hcs-11",
+    "hcs-14",
+    "erc-8004",
+    "caip-10",
+    "agentic"
+  ]
+}

package/spec.md

@@ -0,0 +1,12 @@
+# @agenticprimitives/agent-profile — spec
+
+The full design lives in [`../../specs/217-agent-profile.md`](../../specs/217-agent-profile.md).
+
+Architecture decisions:
+
+- [ADR-0007](../../docs/architecture/decisions/0007-agent-identity-stack-three-packages.md)
+  — 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.
+
+Do not edit a divergent copy here — edit the canonical spec.