Examples

Build a chat app, extract data, call a tool, or continue a conversation.

Choose a recipe below. Each page includes installation commands, an environment template, complete JavaScript, the run command, and expected output. The examples use Node.js 22 or newer and cognitio-agent-sdk@2.0.1 from npm.

​

Start with a complete application

Build	Step-by-step recipe	GitHub project
Ask one question and print the answer	Chat CLI	Chat application
Extract a contact into validated JSON	Structured extraction	Extraction application
Let the model call your multiplication function	Custom calculator tool	Calculator application
Close a handle and resume the same conversation	Session memory	Conversation application

You can follow any recipe in a new directory without cloning the repository. Each linked GitHub project is also independently copyable and includes its own package manifest, npm lockfile, environment template, and README.

​

Run a downloaded project

After copying one of the linked project directories, open a terminal in that directory:

npm ci

Copy .env.example to .env, then replace the API-key placeholder. In a Unix shell:

cp .env.example .env

On PowerShell:

Copy-Item .env.example .env

The default configuration uses openai/gpt-4.1-mini and OPENAI_API_KEY. Model access depends on your provider account. Keep .env out of Git. After setting the key, run:

npm start

The programs make real model requests and can incur provider charges. They reject unsuccessful results and close the runtimes they own. Their estimated cost limits are not provider billing caps. Each recipe explains its output and what to change next.

​

Explore more features

These focused source examples show individual SDK features. Pair them with the linked guide when adding the feature to your own application; they use shared helpers from the feature examples directory.

Feature	Guide	Source example
Basic agent call	Agents and query	Simple agent
Typed application function	Tools	Addition tool
Delegate a task	Subagents	Subagent
Observe tools and answer permission requests	Hooks	Hook callbacks
Return schema-shaped data	Structured output	Output schema
Continue a transcript	Sessions	Resume a session
Connect an MCP service	MCP	External HTTP server
Use a runtime you operate	Remote runtimes	Remote client
Classify unresolved permissions	Permissions	Auto permission mode
Inspect effective configuration	Defaults and isolation	Applied settings
Rewind files, fork, and compact	Checkpoints	Session features