Skip to content

Align skills types with ext-skills#157 - #457

Merged
jancurn merged 1 commit into
apify:mainfrom
olaservo:skills-spec-align
Oct 20, 2026
Merged

jancurn merged 1 commit into
apify:mainfrom
olaservo:skills-spec-align

Conversation

@olaservo

@olaservo olaservo commented Oct 20, 2026 •

Copy link
Copy Markdown
Contributor

ext-skills#157 aligned the Skills spec with the 2026-07-28 base schema. For a client this means ReadResourceDirectoryResult extends CacheableResult (ttlMs, cacheScope), Skill has an optional _meta, and every request carries _meta.

  • src/lib/types.ts: type the caching hints on the directory read result and _meta on Skill.
  • src/core/skills-schema.ts: reject a skill entry whose _meta is not an object.
  • test/e2e/server/index-v2.ts: the test server returns the hints from resources/directory/read.
  • test/unit/core/skills-schema.test.ts: cover _meta pass-through and rejection, and the hints on directory reads.

Request _meta needed no change: SDK 2.3.1 stamps it on every 2026-07-28 request.

No changelog entry. resources-directory-read prints only the children, so the hints never reach a user, and entry _meta already passed through to --json.

Verified with tsc, eslint, the skills unit tests, and test/e2e/suites/basic/skills.test.sh against the modern test server.

Also tested with the live Cloudflare MCP server which serves skills.

AI Disclosure: I used a coding agent to make these changes but have read and understand them.

The spec's alignment with the 2026-07-28 base schema made
ReadResourceDirectoryResult cacheable and added an optional _meta to
Skill. Type both, reject a non-object _meta, and return the caching hints
from the e2e test server's directory read.

Request _meta, also required by that revision, is already stamped by the
SDK on every 2026-07-28 request.

No changelog entry: the directory read command prints only the children,
so the hints never reach a user, and entry _meta already passed through.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@jancurn

jancurn commented Oct 20, 2026

Copy link
Copy Markdown
Member

Thanks for the fix!

@jancurn
jancurn merged commit 7e765fd into apify:main Oct 20, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants