@aaspai/agent-sdk

Worker runtime SDK for running code-first AASPAI agents in separate worker containers.

What this package provides

• Worker execution loop (AgentWorkerRuntime)
• HTTP control-plane client for AASPAI backend internal worker APIs
• defineAgent(...) helper for code-first agent definitions
• High-level worker bootstrap APIs:
• createAgentWorker(...)
• startAgentWorker(...)
• LangGraph re-exports from @langchain/langgraph

Minimal usage (high-level API)

import {
  startAgentWorker,
  defineAgent,
} from '@aaspai/agent-sdk';

const agent = defineAgent({
  id: 'support-agent',
  capabilities: { runtime: 'langgraph-js' },
  async run(context) {
    const last = context.messages.at(-1)?.content;
    return `Support agent received: ${String(last ?? '')}`;
  },
});

startAgentWorker({
  agent,
  workerId: process.env.AGENT_WORKER_ID,
  // Control plane defaults from env:
  // AGENT_WORKER_CONTROL_PLANE_URL or API_BASE_URL
  // AGENT_WORKER_TOKEN
});

Notes

• This package is Node.js oriented.
• Worker runtime is transport-agnostic through AgentWorkerControlPlane.
• For production, always set a strong AGENT_WORKER_TOKEN.