OpenAgentIDDocumentation
API referencenpm packages@openagentid/sdk
OpenAgentIDAPI reference

@openagentid/sdk/skills

API contract shipped by @openagentid/sdk 0.7.2. Exact exports, signatures, dependencies and availability.

All packages · Runnable examples · Start an agent

ContractValue
Package@openagentid/sdk@0.7.2
Entry point@openagentid/sdk/skills
AvailabilityCurrent integration path
Reference sourcePublished TypeScript declarations
Package enginesnode >=20

Before integrating

The published VERSION constant is still the literal "0.6.0" in the 0.7.2 archive. Use package metadata or your lockfile to identify the installed release; do not use VERSION as a release check.

When using @openagentid/crypto-wasm 0.1.1 for ACT verification, call the SDK verifier builder .atTime(Math.floor(Date.now() / 1000)) on every verification. The default WASM system-clock path traps in Node. Supply trusted receiver current epoch seconds; never token-supplied time or a timestamp captured once at startup. The complete ACT example covers this requirement.

In SDK 0.7.2, withAct and requireActExpress do not expose a verification-clock option. The raw crypto-wasm 0.1.1 binding alone therefore traps for these wrappers; use the tested fluent .atTime(...) example, or qualify a binding adapter that supplies fresh trusted receiver time on every verification.

This reference is generated from the integrity-verified npm archive for this exact version. Signatures describe the public contract; they are not standalone programs. Complete examples are checked separately.

Import conditions

Use the public entry point above. The package resolves it to these shipped files; do not import its internal files directly.

ConditionPublished file
types./dist/skills.d.ts
import./dist/skills.js
require./dist/skills.cjs

Exports

allowAllSkills

Policy that allows any skill (dangerous — use only in tests).

Signature
declare const allowAllSkills: SkillsPolicy;

Source: @openagentid/sdk@0.7.2, dist/skills.d.ts:47.

denyAllSkills

Empty policy that denies everything.

Signature
declare const denyAllSkills: SkillsPolicy;

Source: @openagentid/sdk@0.7.2, dist/skills.d.ts:45.

InMemorySkillsPolicy

In-memory, immutable skills policy. Every mutation returns a new instance.

Supports two match modes:

  • Exact: frontend-design matches only frontend-design
  • Wildcard suffix: frontend-* matches frontend-design, frontend-test, ...
Signature
declare class InMemorySkillsPolicy implements SkillsPolicy {
    constructor(skills?: readonly SkillId[]);
    canInvoke(skill: SkillId): boolean;
    assertCanInvoke(skill: SkillId): void;
    listAllowed(): readonly SkillId[];
    grant(skill: SkillId): SkillsPolicy;
    revoke(skill: SkillId): SkillsPolicy;
}

Source: @openagentid/sdk@0.7.2, dist/skills.d.ts:35.

SkillId

A skill identifier such as frontend-design or sql-query.

Type-only declaration; it is not a runtime value.

Signature
type SkillId = string;

Source: @openagentid/sdk@0.7.2, dist/skills.d.ts:14.

SkillsPolicy

The minimum contract the OpenAgent SDK expects from a skills policy.

Type-only declaration; it is not a runtime value.

Signature
interface SkillsPolicy {
    canInvoke(skill: SkillId): boolean;
    assertCanInvoke(skill: SkillId): void;
    listAllowed(): readonly SkillId[];
    grant(skill: SkillId): SkillsPolicy;
    revoke(skill: SkillId): SkillsPolicy;
}

Source: @openagentid/sdk@0.7.2, dist/skills.d.ts:16.

Package requirements

Dependencies

PackagePublished range
zod^3.23.8
jose^5.10.0
@noble/hashes^1.8.0
@scure/base^1.2.6

Peer dependencies

PackagePublished rangeOptional
@openagentid/aegis-sdk^0.1.0Yes
@openagentid/arsenal-sdk^0.1.0Yes
@openagentid/crypto-wasm^0.1.0Yes
@openagentid/oas-sdk^1.0.2Yes

Archive verification

Pinned integrity:

SHA-512 integrity
sha512-9YlDb02di8sGffhuMOwNAQa/M3oBrhaqPc7t+qBltdoQRCqlxDmYB/nTRSB4eZgwE4lvM4TKzI72nJtJSVm/ww==

Machine-readable API manifest · Coverage

On this page