@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
| Contract | Value |
|---|---|
| Package | @openagentid/sdk@0.7.2 |
| Entry point | @openagentid/sdk/skills |
| Availability | Current integration path |
| Reference source | Published TypeScript declarations |
| Package engines | node >=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.
| Condition | Published file |
|---|---|
| types | ./dist/skills.d.ts |
| import | ./dist/skills.js |
| require | ./dist/skills.cjs |
Exports
allowAllSkillsdenyAllSkillsInMemorySkillsPolicySkillId— typeSkillsPolicy— type
allowAllSkills
Policy that allows any skill (dangerous — use only in tests).
declare const allowAllSkills: SkillsPolicy;Source: @openagentid/sdk@0.7.2, dist/skills.d.ts:47.
denyAllSkills
Empty policy that denies everything.
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-designmatches onlyfrontend-design - Wildcard suffix:
frontend-*matchesfrontend-design,frontend-test, ...
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.
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.
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
| Package | Published range |
|---|---|
| zod | ^3.23.8 |
| jose | ^5.10.0 |
| @noble/hashes | ^1.8.0 |
| @scure/base | ^1.2.6 |
Peer dependencies
| Package | Published range | Optional |
|---|---|---|
| @openagentid/aegis-sdk | ^0.1.0 | Yes |
| @openagentid/arsenal-sdk | ^0.1.0 | Yes |
| @openagentid/crypto-wasm | ^0.1.0 | Yes |
| @openagentid/oas-sdk | ^1.0.2 | Yes |
Archive verification
Pinned integrity:
sha512-9YlDb02di8sGffhuMOwNAQa/M3oBrhaqPc7t+qBltdoQRCqlxDmYB/nTRSB4eZgwE4lvM4TKzI72nJtJSVm/ww==