v0.4.0 — Production-ready agent metadata

[Tarcroi]

v0.4.0 is out!

This release brings 3 features that make Skrun agents production-grade:

Breaking: Typed tool declarations

tools: in agent.yaml now requires JSON Schema draft-07 typing. The LLM receives the real schema (not a stub), and arguments are validated with Ajv before scripts run. Invalid args return an error the LLM can self-correct from.

tools:
  - name: pdf-extract
    description: Extract text from a PDF
    input_schema:
      type: object
      properties:
        path: { type: string }
      required: [path]

Agent version pinning

Callers can now pin a specific agent version per call:

{ "input": {...}, "version": "1.2.0" }

Every response echoes agent_version so integrators know exactly what ran. Non-existent versions return 404 with an available list for quick recovery. SDK exposes { version } option on run(), stream(), runAsync().

Structured JSON logging

All ad-hoc console.log replaced with structured JSON via pino. Every log line has level, time, run_id, agent, agent_version. Pipe stdout to Axiom, Datadog, ELK — zero parsing needed.

LOG_LEVEL=warn pnpm dev:registry  # only warnings + errors

Numbers

• 354 tests green (279 unit + 50 E2E + 25 live)
• 5 npm packages at v0.4.0

Install

npm install -g @skrun-dev/cli@0.4.0
npm install @skrun-dev/sdk@0.4.0

Full changelog: CHANGELOG.md

Coming next: environment separation, files API, and cloud deploy.

Feedback welcome!