> ## Documentation Index
> Fetch the complete documentation index at: https://cognitio-agent.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://cognitio-agent.mintlify.site/cookbook/chat-cli.md) | [Chat application](https://github.com/ozgurugurlu/cognitio-agent-sdk/tree/main/examples/01-chat) |
| Extract a contact into validated JSON | [Structured extraction](https://cognitio-agent.mintlify.site/cookbook/structured-extraction.md) | [Extraction application](https://github.com/ozgurugurlu/cognitio-agent-sdk/tree/main/examples/02-structured-output) |
| Let the model call your multiplication function | [Custom calculator tool](https://cognitio-agent.mintlify.site/cookbook/custom-tool.md) | [Calculator application](https://github.com/ozgurugurlu/cognitio-agent-sdk/tree/main/examples/03-custom-tool) |
| Close a handle and resume the same conversation | [Session memory](https://cognitio-agent.mintlify.site/cookbook/session-memory.md) | [Conversation application](https://github.com/ozgurugurlu/cognitio-agent-sdk/tree/main/examples/04-session-memory) |

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:

```sh theme={null}
npm ci
```

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

```sh theme={null}
cp .env.example .env
```

On PowerShell:

```powershell theme={null}
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:

```sh theme={null}
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](https://github.com/ozgurugurlu/cognitio-agent-sdk/tree/main/packages/agent-sdk/examples).

| Feature | Guide | Source example |
| - | - | - |
| Basic agent call | [Agents and query](https://cognitio-agent.mintlify.site/concepts/agents.md) | [Simple agent](https://github.com/ozgurugurlu/cognitio-agent-sdk/blob/main/packages/agent-sdk/examples/01-simple.ts) |
| Typed application function | [Tools](https://cognitio-agent.mintlify.site/concepts/tools.md) | [Addition tool](https://github.com/ozgurugurlu/cognitio-agent-sdk/blob/main/packages/agent-sdk/examples/02-custom-tool.ts) |
| Delegate a task | [Subagents](https://cognitio-agent.mintlify.site/concepts/subagents.md) | [Subagent](https://github.com/ozgurugurlu/cognitio-agent-sdk/blob/main/packages/agent-sdk/examples/03-subagent.ts) |
| Observe tools and answer permission requests | [Hooks](https://cognitio-agent.mintlify.site/concepts/hooks.md) | [Hook callbacks](https://github.com/ozgurugurlu/cognitio-agent-sdk/blob/main/packages/agent-sdk/examples/04-hooks.ts) |
| Return schema-shaped data | [Structured output](https://cognitio-agent.mintlify.site/concepts/structured-output.md) | [Output schema](https://github.com/ozgurugurlu/cognitio-agent-sdk/blob/main/packages/agent-sdk/examples/05-structured-output.ts) |
| Continue a transcript | [Sessions](https://cognitio-agent.mintlify.site/concepts/sessions.md) | [Resume a session](https://github.com/ozgurugurlu/cognitio-agent-sdk/blob/main/packages/agent-sdk/examples/06-session-resume.ts) |
| Connect an MCP service | [MCP](https://cognitio-agent.mintlify.site/concepts/mcp.md) | [External HTTP server](https://github.com/ozgurugurlu/cognitio-agent-sdk/blob/main/packages/agent-sdk/examples/07-mcp-external.ts) |
| Use a runtime you operate | [Remote runtimes](https://cognitio-agent.mintlify.site/cookbook/remote.md) | [Remote client](https://github.com/ozgurugurlu/cognitio-agent-sdk/blob/main/packages/agent-sdk/examples/08-remote.ts) |
| Classify unresolved permissions | [Permissions](https://cognitio-agent.mintlify.site/concepts/permissions.md) | [Auto permission mode](https://github.com/ozgurugurlu/cognitio-agent-sdk/blob/main/packages/agent-sdk/examples/09-auto-permissions.ts) |
| Inspect effective configuration | [Defaults and isolation](https://cognitio-agent.mintlify.site/defaults-and-isolation.md) | [Applied settings](https://github.com/ozgurugurlu/cognitio-agent-sdk/blob/main/packages/agent-sdk/examples/10-applied-settings.ts) |
| Rewind files, fork, and compact | [Checkpoints](https://cognitio-agent.mintlify.site/concepts/checkpoints.md) | [Session features](https://github.com/ozgurugurlu/cognitio-agent-sdk/blob/main/packages/agent-sdk/examples/11-session-features.ts) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.