Quick Start

The smallest useful program: create an agent from an ACL file, open a session on a project directory, run one turn with send, print the reply text, and inspect the verification summary the runtime produced for that turn.

Node.js
Python
TypeScript
import { Agent } from '@a3s-lab/code';
// Agent.create accepts an .acl file path or inline ACL string.
const agent = await Agent.create('agent.acl');
const session = agent.session('.');
const result = await session.send('List the files in this directory.');
console.log(result.text);
// What the runtime checked while producing that turn.
console.log(result.verificationSummaryText);
session.close();

Agent.create() accepts either an .acl file path or inline ACL source text in both SDKs. Always close() the session when you are done so the runtime can flush state and release resources.

Next steps

  • Streaming — read tokens as they arrive
  • Sessions — persist and resume conversations