proomt

Search

Search posts, papers, and topics

All posts

SitePoint15 min readtutorialintermediate

AI Agent Tool Manifests: Building a Unified TypeScript JSON Schema

Read on sitepoint.com

Summary

A vendor‑agnostic JSON Schema manifest for AI agent tools, with a TypeScript adapter layer that compiles the manifest into OpenAI function‑calling and Anthropic Claude formats, plus runtime validation, permission scoping, and execution constraints.

  • Define a single `agent-skill-manifest.json` per tool; the manifest contains `toolId`, `version`, `name`, `description`, `inputSchema`, optional `outputSchema`, `permissions`, and `executionBoundary`.
  • The manifest uses JSON Schema draft 2020‑12 directly for `inputSchema`/`outputSchema`, enabling reuse of existing validators (e.g., AJV).
  • Adapters translate the manifest to provider‑specific shapes: OpenAI’s `type: "function"` wrapper and Anthropic’s flat `input_schema` format.
  • Permissions (`filesystem`, `network`, `exec`, `env`, `none`) and execution boundaries (`timeout`, `retryPolicy`, `maxConcurrency`, `sandboxMode`) are enforced by custom runtimes, not the LLM providers.

Without a unified manifest, teams must maintain N × M tool definitions (N tools, M providers), leading to drift and silent failures when required fields are omitted. A single source of truth eliminates duplication, reduces bugs, and makes sandbox policy enforcement explicit.

6/10
llmapi designtypescriptarchitectureml infrajson schema

Related reading

  1. Building Deterministic Multi-Agent State Machines in TypeScript

    The article shows how to build a deterministic, checkpoint‑backed finite state machine engine in TypeScript for orchestrating multi‑agent AI workflows. It uses Zod for schema validation, better‑sqlite3 for atomic persistence, and a pure transition function to make workflows traceable and recoverable in serverless environments.

    SitePointsitepoint.com18 min

  2. Build a Typed Context Compaction Gate for AI Agents

    A step‑by‑step tutorial showing how to build a typed context‑compaction gate for AI agents in TypeScript using LangChain and Zod. It defines a discriminated‑union schema for keep/summarize/discard actions, implements a fast gpt‑4o‑mini classifier, validates decisions at runtime, and wires the gate as middleware in an agent loop, with testing and production‑grade tuning advice.

    SitePointsitepoint.com16 min

  5. Introducing the DevOps Agent Kit

    The DevOps Agent Kit is an Apache‑2.0 open‑source starter kit that lets you plug an LLM‑based coding assistant into your existing CI/CD, security, and feature‑flag tooling via CloudBees Unify. It ships with seven read‑only example skills, enforces RBAC and audit trails, and normalises data from up to 63 tools so the agent can answer a single “are we good to ship?” question with verifiable evidenc…

    Codeshipcloudbees.com5 min