@sequenceholdings/agent-spec

Preview SDK for authoring typed Sequence agent definitions.

The package is versioned independently and its API may change before a stable release. Use Node.js 20 or later.

Install

pnpm add @sequenceholdings/agent-spec

Define an agent

import { defineAgent } from '@sequenceholdings/agent-spec'

export const agent = defineAgent({
  id: '680000000000000000000001',
  name: 'Support Agent',
  model: { provider: 'anthropic', name: 'claude-sonnet-4-6' },
  systemPrompt: 'Help the support team investigate and resolve requests.',
})

Definitions must be pure data literals: do not read environment variables, call functions, or compute fields in agent.ts. Keep deployment targeting separate from a definition, then use seq-studio agents validate, plan, and apply.

Exports

• @sequenceholdings/agent-spec provides defineAgent, agentDefinitionSchema, deterministic source formatting, and bundle hashing.
• @sequenceholdings/agent-spec/compiler compiles agent.ts files and deploy manifests in Node.js. It statically extracts literal definitions and never imports or executes agent source.
• @sequenceholdings/agent-spec/yaml provides parseYamlAgent only for migrating legacy YAML definitions.