@agenticprimitives/agent-skills 0.0.0-alpha.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agentic Trust Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,59 @@
+# @agenticprimitives/agent-skills
+
+**Agents get hired for what they can do — but publishing a full capability map on chain is an operational leak.** Discovery needs shared, versioned skill definitions everyone can point at; trust needs claims an agent cannot fake and an endorser cannot be impersonated on. This package splits the two cleanly: a **skill definition** is a public, versioned, on-chain anchor in `SkillDefinitionRegistry`; a **skill claim** — a Smart Agent's relation to a skill — is a **private verifiable credential in that agent's vault**, pointing at the on-chain `(skillId, version)`. There is no on-chain claim registry, by design.
+
+Because the claim's subject and issuer are Smart Agent addresses, endorsements carry real weight: a certifying body signs the `endorsementDigest` with its own on-chain identity (ERC-1271-verifiable), the claim survives the subject's key rotations, and selective public assertion — when the agent opts in — reuses the generic [`attestations`](../attestations) credential-hash path rather than a skill-specific contract.
+
+> Part of [agenticprimitives](../../README.md) — the trust substrate for the agent economy: one canonical Smart Agent identity with custody, delegation, naming, credentials, and audit evidence designed as one system.
+
+## What ships today
+
+This SDK owns the credential shape (`SkillClaimCredential`), the self/endorsed builders, the commitment/digest math, and a thin on-chain definition reader ([spec 251](../../specs/251-skills-and-geo-features.md)):
+
+- **Builders** — `buildSelfSkillClaim` (subject == issuer; proficiency capped at `SELF_MAX_PROFICIENCY`; self-meaningless relations forbidden) and `buildEndorsedSkillClaim` (cross-issued; returns the `endorsementDigest` the issuer signs).
+- **Codelists** — `SKILL_KIND` (lockstep with `SkillDefinitionRegistry.KIND_*` on chain — a cross-stack test reads the live `.sol`), `SKILL_RELATION`, `SkillVisibility`. All are keccak hashes of the `ns/skill#` C-box concept URIs.
+- **Math** — `computeSkillId`, `conceptHash`, `skillClaimId`, `skillEndorsementDigest`, `skillClaimHash`.
+- **Definition reader** — `skillDefinitionExists(read, registry, ref)` via an injected `readContract` function (no viem/contract dependency) + `SKILL_DEFINITION_READ_ABI`.
+
+```ts
+import { buildEndorsedSkillClaim, SKILL_RELATION, skillDefinitionExists } from '@agenticprimitives/agent-skills';
+
+const { credential, endorsementDigest } = buildEndorsedSkillClaim({
+  chainId: 84532,
+  subject: kcAgent,             // the Smart Agent the claim is about
+  issuer:  certifyingBody,      // a different SA endorses it
+  definition: { skillId, version: 1 },   // points to the on-chain SkillDefinitionRegistry
+  relation: SKILL_RELATION.certifiedIn,
+  proficiencyScore: 9000,
+  nonce,
+});
+// the issuer signs `endorsementDigest` (ERC-1271); the app stores `credential` in the subject's vault.
+```
+
+Vault I/O is the app's job — this package is transport-agnostic and builds the credential only. `evidenceCommit` is a bytes32 commitment/merkle root, never a URI; the preimage stays in the vault.
+
+## How it's different
+
+Skill taxonomies and agent-capability frameworks (OASF-style schemas, marketplace skill catalogs) describe what a skill *is*; they have no answer for who *verifiably has it*. The deltas here:
+
+1. **Claims are credentials, not catalog rows.** A claim is a signed VC bound to a persistent Smart Agent address — endorsable by another on-chain identity, revocable, and intact through credential recovery.
+2. **Public taxonomy, private possession.** Definitions are shared on-chain anchors; the agent↔skill association never touches the chain unless the holder opts in. Competitors' public skill registries make every participant's capability map free intelligence.
+3. **Lockstep, CI-checked.** `SKILL_KIND.Leaf === SkillDefinitionRegistry.KIND_LEAF` is asserted by a cross-stack test against the live Solidity — the SDK cannot drift from the contract.
+
+Geo is the independent sibling [`@agenticprimitives/geo-features`](../geo-features) — no skill↔geo mapping exists on chain or in the SDKs; a "skill X in region Y" fact is two separate claims. Neutral substrate: no vertical vocabulary (domain language lives in apps, per [ADR-0021](../../docs/architecture/decisions/0021-generic-packages-vs-white-label-apps.md)).
+
+## Status
+
+**W1 foundational — the off-chain skill-claim layer of the spec-251 skills/geo substrate is shipped.** The on-chain peer is `SkillDefinitionRegistry.sol` in [`packages/contracts`](../contracts). See [AUDIT.md](./AUDIT.md).
+
+> Testnet/pilot-ready. Production launch is gated on the public checklist in the root README — including third-party contract audit and governance key rotation. Track every security finding live in [`docs/audits/findings.yaml`](../../docs/audits/findings.yaml).
+
+**Authoritative spec:** [`specs/251-skills-and-geo-features.md`](../../specs/251-skills-and-geo-features.md). Bounded surface: `CLAUDE.md` + `capability.manifest.json`.
+
+## Build
+
+```bash
+pnpm --filter @agenticprimitives/agent-skills typecheck
+pnpm --filter @agenticprimitives/agent-skills test
+pnpm --filter @agenticprimitives/agent-skills build
+```

package/dist/index.d.ts

@@ -0,0 +1,196 @@
+/**
+ * @agenticprimitives/agent-skills — off-chain skill CLAIM credentials + on-chain
+ * SkillDefinitionRegistry helpers (spec 251).
+ *
+ * Definitions are PUBLIC, versioned, on-chain anchors (SkillDefinitionRegistry).
+ * A claim — a Smart Agent's relation to a skill — is a PRIVATE verifiable credential
+ * in that agent's vault, pointing to an on-chain `(skillId, version)`. There is no
+ * on-chain claim registry; this SDK owns the credential shape + builders + the
+ * commitment/digest math + an on-chain definition reader.
+ *
+ * Neutral substrate — NO domain/faith vocabulary (spec 251).
+ */
+import type { Address, Hex } from '@agenticprimitives/types';
+export declare const PACKAGE_NAME = "@agenticprimitives/agent-skills";
+export declare const PACKAGE_STATUS: "w1-foundational";
+export declare const SPEC_REF = "specs/251-skills-and-geo-features.md";
+export type Uri = string;
+export type Hex32 = `0x${string}`;
+/** On-chain-bound skill kinds. `SKILL_KIND.Leaf === SkillDefinitionRegistry.KIND_LEAF`. */
+export declare const SKILL_KIND: {
+    readonly Leaf: `0x${string}`;
+    readonly Domain: `0x${string}`;
+    readonly Custom: `0x${string}`;
+};
+export declare const SKILL_KIND_URI: {
+    readonly Leaf: "https://agenticprimitives.dev/ns/skill#Leaf";
+    readonly Domain: "https://agenticprimitives.dev/ns/skill#Domain";
+    readonly Custom: "https://agenticprimitives.dev/ns/skill#Custom";
+};
+/** Claim relations (C-box `aps:skillRelation`). Off-chain only (in the credential). */
+export declare const SKILL_RELATION: {
+    readonly hasSkill: `0x${string}`;
+    readonly practicesSkill: `0x${string}`;
+    readonly certifiedIn: `0x${string}`;
+    readonly endorsesSkill: `0x${string}`;
+    readonly mentorsIn: `0x${string}`;
+    readonly canTrainOthersIn: `0x${string}`;
+};
+export type SkillVisibility = 'public' | 'public-coarse' | 'private-commitment' | 'private-zk' | 'offchain-only';
+/** Relations that are meaningless about oneself — forbidden on a self claim (mirrors smart-agent). */
+export declare const SELF_FORBIDDEN_RELATIONS: readonly Hex32[];
+export declare const SELF_MAX_PROFICIENCY = 6000;
+export declare const MAX_PROFICIENCY = 10000;
+/** Compute a stable skillId from a canonical id key (keccak). */
+export declare function computeSkillId(canonicalKey: string): Hex32;
+/** Canonical conceptHash a steward commits on chain (keccak of prefLabel + ancestors). */
+export declare function conceptHash(prefLabel: string, ancestors?: string[]): Hex32;
+/** Payload a steward submits to `SkillDefinitionRegistry.publish(...)`. */
+export interface SkillDefinitionPublishInput {
+    skillId: Hex32;
+    skillKind: Hex32;
+    stewardAccount: Address;
+    conceptHash: Hex32;
+    ontologyMerkleRoot: Hex32;
+    metadataURI: string;
+    validAfter: bigint;
+    validUntil: bigint;
+}
+/** A reference to an on-chain skill definition version — what a claim points to. */
+export interface SkillDefinitionRef {
+    skillId: Hex32;
+    version: number;
+}
+export interface SkillClaimSubject {
+    /** The Smart Agent the claim is about. */
+    subject: Address;
+    /** The on-chain definition version this claim references. */
+    definition: SkillDefinitionRef;
+    /** A SKILL_RELATION value. */
+    relation: Hex32;
+    visibility: SkillVisibility;
+    /** 0..10000 basis points. */
+    proficiencyScore?: number;
+    /** keccak commitment / merkle root (ZK-targetable). NEVER a URI; preimage in the vault. */
+    evidenceCommit?: Hex32;
+    validAfter?: number;
+    validUntil?: number;
+    nonce: Hex32;
+    /** Deterministic claim id (see {@link skillClaimId}). */
+    claimId: Hex32;
+}
+/** The vault-resident skill claim credential (a VC). */
+export interface SkillClaimCredential {
+    '@context': string[];
+    type: ['VerifiableCredential', 'SkillClaimCredential'];
+    /** CAIP-10 of the issuer Smart Agent. */
+    issuer: string;
+    validFrom?: string;
+    validUntil?: string;
+    credentialSubject: SkillClaimSubject;
+}
+/** Deterministic claim id = keccak(abi.encode(subject, skillId, relation, nonce)). */
+export declare function skillClaimId(args: {
+    subject: Address;
+    skillId: Hex32;
+    relation: Hex32;
+    nonce: Hex32;
+}): Hex32;
+/**
+ * NEW-SKILL-1 — typehash now binds `chainId` + `verifyingContract` so an endorsement
+ * signature can't be replayed across chains or against a different SkillDefinitionRegistry
+ * deployment (mirrors the EIP-712 domain binding in payments/mandate-sign.ts).
+ *
+ * Typehash for the cross-issued endorsement (issuer signs; verified via ERC-1271).
+ */
+export declare const SKILL_ENDORSEMENT_TYPEHASH: Hex32;
+/**
+ * The digest an issuer signs to endorse a cross-issued claim (ERC-1271-verifiable).
+ *
+ * NEW-SKILL-1 — `chainId` + `verifyingContract` are folded into the digest so the same
+ * endorsement can't be replayed on another chain or against a different registry deployment.
+ * `verifyingContract` is the SkillDefinitionRegistry the endorsed `(skillId, version)` lives in.
+ */
+export declare function skillEndorsementDigest(args: {
+    chainId: number;
+    verifyingContract: Address;
+    subject: Address;
+    skillId: Hex32;
+    skillVersion: number;
+    relation: Hex32;
+    proficiencyScore: number;
+    validAfter: number;
+    validUntil: number;
+    nonce: Hex32;
+}): Hex32;
+/** Build a SELF skill claim (subject == issuer). Capped proficiency; self-meaningless relations forbidden. */
+export declare function buildSelfSkillClaim(args: {
+    chainId: number;
+    subject: Address;
+    definition: SkillDefinitionRef;
+    relation: Hex32;
+    visibility?: SkillVisibility;
+    proficiencyScore?: number;
+    evidenceCommit?: Hex32;
+    validAfter?: number;
+    validUntil?: number;
+    nonce: Hex32;
+}): SkillClaimCredential;
+/** Build an ENDORSED skill claim + the digest the issuer must sign (cross-issued; subject != issuer). */
+export declare function buildEndorsedSkillClaim(args: {
+    chainId: number;
+    /** NEW-SKILL-1 — the SkillDefinitionRegistry the endorsed `(skillId, version)` lives in; bound into the digest. */
+    registry: Address;
+    subject: Address;
+    issuer: Address;
+    definition: SkillDefinitionRef;
+    relation: Hex32;
+    visibility?: SkillVisibility;
+    proficiencyScore?: number;
+    evidenceCommit?: Hex32;
+    validAfter?: number;
+    validUntil?: number;
+    nonce: Hex32;
+}): {
+    credential: SkillClaimCredential;
+    endorsementDigest: Hex32;
+};
+/** The canonical hash of a claim credential body (for vault keys / receipts). */
+export declare function skillClaimHash(credential: SkillClaimCredential): Hex;
+/** Minimal read ABI for SkillDefinitionRegistry — `exists` + `latestVersion`. */
+export declare const SKILL_DEFINITION_READ_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "exists";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "skillId";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "version";
+        readonly type: "uint64";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "latestVersion";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint64";
+    }];
+}];
+/** A `readContract`-shaped function (inject viem's `publicClient.readContract`). */
+export type ReadContractFn = (args: {
+    address: Address;
+    abi: typeof SKILL_DEFINITION_READ_ABI;
+    functionName: string;
+    args: readonly unknown[];
+}) => Promise<unknown>;
+/** Confirm a claim's pinned `(skillId, version)` still exists on the registry. */
+export declare function skillDefinitionExists(read: ReadContractFn, registry: Address, ref: SkillDefinitionRef): Promise<boolean>;
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,197 @@
+/**
+ * @agenticprimitives/agent-skills — off-chain skill CLAIM credentials + on-chain
+ * SkillDefinitionRegistry helpers (spec 251).
+ *
+ * Definitions are PUBLIC, versioned, on-chain anchors (SkillDefinitionRegistry).
+ * A claim — a Smart Agent's relation to a skill — is a PRIVATE verifiable credential
+ * in that agent's vault, pointing to an on-chain `(skillId, version)`. There is no
+ * on-chain claim registry; this SDK owns the credential shape + builders + the
+ * commitment/digest math + an on-chain definition reader.
+ *
+ * Neutral substrate — NO domain/faith vocabulary (spec 251).
+ */
+import { keccak_256 } from '@noble/hashes/sha3.js';
+import { utf8ToBytes } from '@noble/hashes/utils.js';
+import { credentialHash, VC_CONTEXT_V2 } from '@agenticprimitives/verifiable-credentials';
+export const PACKAGE_NAME = '@agenticprimitives/agent-skills';
+export const PACKAGE_STATUS = 'w1-foundational';
+export const SPEC_REF = 'specs/251-skills-and-geo-features.md';
+const NS = 'https://agenticprimitives.dev/ns/skill#';
+// ─── C-box codelists (keccak of the ns/skill# concept URIs) ────────────────
+// The kind values are LOCKSTEP with SkillDefinitionRegistry.KIND_* (ADR-0009);
+// the cross-stack test asserts equality against the live .sol.
+/** On-chain-bound skill kinds. `SKILL_KIND.Leaf === SkillDefinitionRegistry.KIND_LEAF`. */
+export const SKILL_KIND = {
+    Leaf: hashUri(`${NS}Leaf`),
+    Domain: hashUri(`${NS}Domain`),
+    Custom: hashUri(`${NS}Custom`),
+};
+export const SKILL_KIND_URI = { Leaf: `${NS}Leaf`, Domain: `${NS}Domain`, Custom: `${NS}Custom` };
+/** Claim relations (C-box `aps:skillRelation`). Off-chain only (in the credential). */
+export const SKILL_RELATION = {
+    hasSkill: hashUri(`${NS}hasSkill`),
+    practicesSkill: hashUri(`${NS}practicesSkill`),
+    certifiedIn: hashUri(`${NS}certifiedIn`),
+    endorsesSkill: hashUri(`${NS}endorsesSkill`),
+    mentorsIn: hashUri(`${NS}mentorsIn`),
+    canTrainOthersIn: hashUri(`${NS}canTrainOthersIn`),
+};
+/** Relations that are meaningless about oneself — forbidden on a self claim (mirrors smart-agent). */
+export const SELF_FORBIDDEN_RELATIONS = [
+    SKILL_RELATION.certifiedIn,
+    SKILL_RELATION.endorsesSkill,
+    SKILL_RELATION.mentorsIn,
+    SKILL_RELATION.canTrainOthersIn,
+];
+export const SELF_MAX_PROFICIENCY = 6000;
+export const MAX_PROFICIENCY = 10000;
+// ─── Definitions (the on-chain anchor) ─────────────────────────────────────
+/** Compute a stable skillId from a canonical id key (keccak). */
+export function computeSkillId(canonicalKey) {
+    return hashUri(canonicalKey);
+}
+/** Canonical conceptHash a steward commits on chain (keccak of prefLabel + ancestors). */
+export function conceptHash(prefLabel, ancestors = []) {
+    return hashUri([prefLabel, ...ancestors].join('|'));
+}
+/** Deterministic claim id = keccak(abi.encode(subject, skillId, relation, nonce)). */
+export function skillClaimId(args) {
+    const buf = new Uint8Array(4 * 32);
+    writeAddress(buf, 0, args.subject);
+    writeHex32(buf, 32, args.skillId);
+    writeHex32(buf, 64, args.relation);
+    writeHex32(buf, 96, args.nonce);
+    return toHex32(keccak_256(buf));
+}
+/**
+ * NEW-SKILL-1 — typehash now binds `chainId` + `verifyingContract` so an endorsement
+ * signature can't be replayed across chains or against a different SkillDefinitionRegistry
+ * deployment (mirrors the EIP-712 domain binding in payments/mandate-sign.ts).
+ *
+ * Typehash for the cross-issued endorsement (issuer signs; verified via ERC-1271).
+ */
+export const SKILL_ENDORSEMENT_TYPEHASH = hashUri('SkillEndorsement(uint256 chainId,address verifyingContract,address subjectAgent,bytes32 skillId,uint64 skillVersion,bytes32 relation,uint16 proficiencyScore,uint64 validAfter,uint64 validUntil,bytes32 nonce)');
+/**
+ * The digest an issuer signs to endorse a cross-issued claim (ERC-1271-verifiable).
+ *
+ * NEW-SKILL-1 — `chainId` + `verifyingContract` are folded into the digest so the same
+ * endorsement can't be replayed on another chain or against a different registry deployment.
+ * `verifyingContract` is the SkillDefinitionRegistry the endorsed `(skillId, version)` lives in.
+ */
+export function skillEndorsementDigest(args) {
+    const buf = new Uint8Array(11 * 32);
+    writeHex32(buf, 0, SKILL_ENDORSEMENT_TYPEHASH);
+    writeUint(buf, 32, BigInt(args.chainId));
+    writeAddress(buf, 64, args.verifyingContract);
+    writeAddress(buf, 96, args.subject);
+    writeHex32(buf, 128, args.skillId);
+    writeUint(buf, 160, BigInt(args.skillVersion));
+    writeHex32(buf, 192, args.relation);
+    writeUint(buf, 224, BigInt(args.proficiencyScore));
+    writeUint(buf, 256, BigInt(args.validAfter));
+    writeUint(buf, 288, BigInt(args.validUntil));
+    writeHex32(buf, 320, args.nonce);
+    return toHex32(keccak_256(buf));
+}
+function caip10(chainId, addr) {
+    return `eip155:${chainId}:${addr}`;
+}
+function buildSubject(args) {
+    return {
+        subject: args.subject,
+        definition: args.definition,
+        relation: args.relation,
+        visibility: args.visibility,
+        proficiencyScore: args.proficiencyScore,
+        evidenceCommit: args.evidenceCommit,
+        validAfter: args.validAfter,
+        validUntil: args.validUntil,
+        nonce: args.nonce,
+        claimId: skillClaimId({ subject: args.subject, skillId: args.definition.skillId, relation: args.relation, nonce: args.nonce }),
+    };
+}
+/** Build a SELF skill claim (subject == issuer). Capped proficiency; self-meaningless relations forbidden. */
+export function buildSelfSkillClaim(args) {
+    if (SELF_FORBIDDEN_RELATIONS.includes(args.relation)) {
+        throw new Error('agent-skills: that relation is meaningless about oneself (use an endorsed claim)');
+    }
+    if ((args.proficiencyScore ?? 0) > SELF_MAX_PROFICIENCY) {
+        throw new Error(`agent-skills: self proficiency capped at ${SELF_MAX_PROFICIENCY}`);
+    }
+    return {
+        '@context': [VC_CONTEXT_V2],
+        type: ['VerifiableCredential', 'SkillClaimCredential'],
+        issuer: caip10(args.chainId, args.subject),
+        credentialSubject: buildSubject({ ...args, visibility: args.visibility ?? 'private-commitment' }),
+    };
+}
+/** Build an ENDORSED skill claim + the digest the issuer must sign (cross-issued; subject != issuer). */
+export function buildEndorsedSkillClaim(args) {
+    if (args.subject === args.issuer)
+        throw new Error('agent-skills: an endorsed claim must be cross-issued');
+    if ((args.proficiencyScore ?? 0) > MAX_PROFICIENCY)
+        throw new Error('agent-skills: proficiency out of range');
+    const credential = {
+        '@context': [VC_CONTEXT_V2],
+        type: ['VerifiableCredential', 'SkillClaimCredential'],
+        issuer: caip10(args.chainId, args.issuer),
+        credentialSubject: buildSubject({ ...args, visibility: args.visibility ?? 'public' }),
+    };
+    const endorsementDigest = skillEndorsementDigest({
+        chainId: args.chainId, // NEW-SKILL-1 — bind chain + registry so the signature is deployment-scoped
+        verifyingContract: args.registry,
+        subject: args.subject,
+        skillId: args.definition.skillId,
+        skillVersion: args.definition.version,
+        relation: args.relation,
+        proficiencyScore: args.proficiencyScore ?? 0,
+        validAfter: args.validAfter ?? 0,
+        validUntil: args.validUntil ?? 0,
+        nonce: args.nonce,
+    });
+    return { credential, endorsementDigest };
+}
+/** The canonical hash of a claim credential body (for vault keys / receipts). */
+export function skillClaimHash(credential) {
+    return credentialHash(credential);
+}
+// ─── On-chain definition reader (minimal ABI fragment) ─────────────────────
+/** Minimal read ABI for SkillDefinitionRegistry — `exists` + `latestVersion`. */
+export const SKILL_DEFINITION_READ_ABI = [
+    { type: 'function', name: 'exists', stateMutability: 'view', inputs: [{ name: 'skillId', type: 'bytes32' }, { name: 'version', type: 'uint64' }], outputs: [{ type: 'bool' }] },
+    { type: 'function', name: 'latestVersion', stateMutability: 'view', inputs: [{ name: '', type: 'bytes32' }], outputs: [{ type: 'uint64' }] },
+];
+/** Confirm a claim's pinned `(skillId, version)` still exists on the registry. */
+export async function skillDefinitionExists(read, registry, ref) {
+    return (await read({ address: registry, abi: SKILL_DEFINITION_READ_ABI, functionName: 'exists', args: [ref.skillId, BigInt(ref.version)] }));
+}
+// ─── Hash helpers ──────────────────────────────────────────────────────────
+function hashUri(s) {
+    return toHex32(keccak_256(utf8ToBytes(s)));
+}
+function toHex32(b) {
+    let hex = '0x';
+    for (const v of b)
+        hex += v.toString(16).padStart(2, '0');
+    return hex;
+}
+function writeHex32(buf, offset, h) {
+    const clean = h.toLowerCase().replace(/^0x/, '').padStart(64, '0');
+    for (let i = 0; i < 32; i++)
+        buf[offset + i] = parseInt(clean.substring(i * 2, i * 2 + 2), 16);
+}
+function writeAddress(buf, offset, addr) {
+    const clean = addr.toLowerCase().replace(/^0x/, '');
+    if (clean.length !== 40)
+        throw new Error(`bad address: ${addr}`);
+    for (let i = 0; i < 20; i++)
+        buf[offset + 12 + i] = parseInt(clean.substring(i * 2, i * 2 + 2), 16);
+}
+function writeUint(buf, offset, n) {
+    let v = n;
+    for (let i = 31; i >= 0; i--) {
+        buf[offset + i] = Number(v & 0xffn);
+        v >>= 8n;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@agenticprimitives/agent-skills",
+  "version": "0.0.0-alpha.10",
+  "description": "Off-chain skill CLAIM credentials + on-chain SkillDefinitionRegistry helpers (spec 251). Definitions on chain; the agent↔skill claim is a private vault credential pointing to a (skillId, version).",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agentictrustlabs/agenticprimitives.git",
+    "directory": "packages/agent-skills"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "LICENSE",
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.8"
+  },
+  "keywords": [
+    "agentic",
+    "primitives",
+    "skills"
+  ],
+  "dependencies": {
+    "@noble/hashes": "^2.2.0",
+    "@agenticprimitives/types": "1.0.0-alpha.13",
+    "@agenticprimitives/verifiable-credentials": "0.0.0-alpha.10"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:unit": "vitest run test/unit --passWithNoTests",
+    "clean": "rm -rf dist"
+  }
+}