luca 2.0.0 → 3.0.0

package/docs/README.md

@@ -0,0 +1,60 @@
+# Models
+
+## Overview
+
+
+
+## Summary
+
+```
+Collection: /Users/jonathansoeder/@soederpop/luca/docs
+Root: /Users/jonathansoeder/@soederpop/luca/docs
+Items: 169
+
+  Model: Challenge
+    Prefix: challenges
+    Meta: difficulty(enum(`easy`, `medium`, `hard`)), maxTime(number)
+    Sections: (none)
+    Relationships: (none)
+    Documents: 13
+    IDs: challenges/build-a-websocket-server-with-matching-client, challenges/build-a-custom-command, challenges/build-a-caching-proxy, challenges/process-orchestrator, challenges/build-a-file-watcher-pipeline, challenges/grep-audit-report, challenges/build-a-multi-feature-dashboard, challenges/yaml-config-system, challenges/script-runner-with-vm, challenges/build-an-api, challenges/find-confusing-apis, challenges/build-a-rest-server-with-matching-client, challenges/content-db-round-trip
+
+  Model: Example
+    Prefix: examples
+    Meta: tags(string[])
+    Sections: (none)
+    Relationships: (none)
+    Documents: 43
+    IDs: examples/postgres, examples/yaml-tree, examples/grep, examples/ink, examples/git, examples/ink-renderer, examples/esbuild, examples/window-manager, examples/process-manager, examples/runpod, examples/google-auth, examples/downloader, examples/secure-shell, examples/vault, examples/window-manager-layouts, examples/ipc-socket, examples/google-sheets, examples/fs, examples/networking, examples/ink-blocks, examples/ui, examples/opener, examples/nlp, examples/disk-cache, examples/assistant/CORE, examples/vm, examples/google-docs, examples/google-calendar, examples/content-db, examples/yaml, examples/package-finder, examples/os, examples/json-tree, examples/google-drive, examples/telegram, examples/file-manager, examples/repl, examples/python, examples/sqlite, examples/tts, examples/docker, examples/proc
+
+  Model: Idea
+    Prefix: ideas
+    Meta: goal(string), tags(string[]), status(enum(`spark`, `exploring`, `parked`, `promoted`))
+    Sections: (none)
+    Relationships: (none)
+    Documents: 0
+
+  Model: Report
+    Prefix: reports
+    Meta: tags(string[])
+    Sections: (none)
+    Relationships: (none)
+    Documents: 5
+    IDs: reports/introspection-audit-tasks, reports/attach-pattern-usage, reports/code-audit-results, reports/assistant-bugs, reports/luca-mcp-improvements
+
+  Model: Tutorial
+    Prefix: tutorials
+    Meta: tags(string[])
+    Sections: (none)
+    Relationships: (none)
+    Documents: 19
+    IDs: tutorials/08-commands, tutorials/06-servers, tutorials/04-features-overview, tutorials/01-getting-started, tutorials/07-endpoints, tutorials/00-bootstrap, tutorials/10-creating-features, tutorials/13-introspection, tutorials/17-tui-blocks, tutorials/18-semantic-search, tutorials/03-scripts, tutorials/05-state-and-events, tutorials/14-type-system, tutorials/11-contentbase, tutorials/12-assistants, tutorials/02-container, tutorials/15-project-patterns, tutorials/09-clients, tutorials/16-google-features
+
+  Model: Base
+    Prefix: 
+    Meta: (none)
+    Sections: (none)
+    Relationships: (none)
+    Documents: 9
+    IDs: introspection, principles, todos, README, CLI, documentation-audit, introspection-audit, TABLE-OF-CONTENTS, philosophy
+```

package/docs/TABLE-OF-CONTENTS.md

@@ -0,0 +1,183 @@
+# Table of Contents
+
+## Challenges
+
+- [Build a Caching Proxy](./challenges/build-a-caching-proxy.md)
+- [Build a custom command](./challenges/build-a-custom-command.md)
+- [Build a File Watcher Pipeline](./challenges/build-a-file-watcher-pipeline.md)
+- [Build a Multi-Feature Dashboard](./challenges/build-a-multi-feature-dashboard.md)
+- [Build a REST server with a matching REST Client](./challenges/build-a-rest-server-with-matching-client.md)
+- [Build a websocket server with a matching websocket client](./challenges/build-a-websocket-server-with-matching-client.md)
+- [Build an API](./challenges/build-an-api.md)
+- [Content DB Round-Trip](./challenges/content-db-round-trip.md)
+- [Find Confusing APIs](./challenges/find-confusing-apis.md)
+- [Grep Audit Report](./challenges/grep-audit-report.md)
+- [Process Orchestrator](./challenges/process-orchestrator.md)
+- [Script Runner with VM](./challenges/script-runner-with-vm.md)
+- [YAML Config System](./challenges/yaml-config-system.md)
+
+## Examples
+
+- [Luca Assistant Example](./examples/assistant/CORE.md)
+- [Content Database](./examples/content-db.md)
+- [Disk Cache](./examples/disk-cache.md)
+- [Docker](./examples/docker.md)
+- [Downloader](./examples/downloader.md)
+- [esbuild](./examples/esbuild.md)
+- [File Manager](./examples/file-manager.md)
+- [fs](./examples/fs.md)
+- [git](./examples/git.md)
+- [Google Auth](./examples/google-auth.md)
+- [Google Calendar](./examples/google-calendar.md)
+- [Google Docs](./examples/google-docs.md)
+- [Google Drive](./examples/google-drive.md)
+- [Google Sheets](./examples/google-sheets.md)
+- [grep](./examples/grep.md)
+- [Ink](./examples/ink.md)
+- [Ink Blocks — Poor Man's MDX](./examples/ink-blocks.md)
+- [Feature Registry](./examples/ink-renderer.md)
+- [IPC Socket](./examples/ipc-socket.md)
+- [JSON Tree](./examples/json-tree.md)
+- [networking](./examples/networking.md)
+- [Natural Language Processing](./examples/nlp.md)
+- [Opener](./examples/opener.md)
+- [os](./examples/os.md)
+- [Package Finder](./examples/package-finder.md)
+- [PostgreSQL](./examples/postgres.md)
+- [proc](./examples/proc.md)
+- [Process Manager](./examples/process-manager.md)
+- [Python](./examples/python.md)
+- [REPL](./examples/repl.md)
+- [RunPod GPU Cloud](./examples/runpod.md)
+- [Secure Shell](./examples/secure-shell.md)
+- [SQLite](./examples/sqlite.md)
+- [Telegram Bot](./examples/telegram.md)
+- [Text-to-Speech](./examples/tts.md)
+- [ui](./examples/ui.md)
+- [Vault](./examples/vault.md)
+- [vm](./examples/vm.md)
+- [YAML](./examples/yaml.md)
+- [YAML Tree](./examples/yaml-tree.md)
+
+## Reports
+
+- [Assistant systemPrompt Bug Fix Verification](./reports/assistant-bugs.md)
+- [Attach Pattern](./reports/attach-pattern-usage.md)
+- [Code Audit - Container Abstraction Violations](./reports/code-audit-results.md)
+- [Introspection Audit Results](./reports/introspection-audit-tasks.md)
+- [Problem](./reports/luca-mcp-improvements.md)
+
+## Tutorials
+
+- [Bootstrap: Learning the Container at Runtime](./tutorials/00-bootstrap.md)
+- [Getting Started with Luca](./tutorials/01-getting-started.md)
+- [The Container](./tutorials/02-container.md)
+- [Running Scripts and Markdown Notebooks](./tutorials/03-scripts.md)
+- [Features Overview](./tutorials/04-features-overview.md)
+- [State and Events](./tutorials/05-state-and-events.md)
+- [Servers](./tutorials/06-servers.md)
+- [Writing Endpoints](./tutorials/07-endpoints.md)
+- [Writing Commands](./tutorials/08-commands.md)
+- [Using Clients](./tutorials/09-clients.md)
+- [Creating Custom Features](./tutorials/10-creating-features.md)
+- [Contentbase - Markdown as a Database](./tutorials/11-contentbase.md)
+- [Building Assistants](./tutorials/12-assistants.md)
+- [Introspection and Discovery](./tutorials/13-introspection.md)
+- [Type System and Module Augmentation](./tutorials/14-type-system.md)
+- [Project Patterns and Recipes](./tutorials/15-project-patterns.md)
+- [Google Features](./tutorials/16-google-features.md)
+- [Building TUI Primitive Blocks](./tutorials/17-tui-blocks.md)
+- [Semantic Search](./tutorials/18-semantic-search.md)
+
+## Bases
+
+- [Luca CLI](./CLI.md)
+- [Models](./README.md)
+- [Table of Contents](./TABLE-OF-CONTENTS.md)
+- [Documentation Audit](./documentation-audit.md)
+- [Introspection](./introspection.md)
+- [Introspection Audit](./introspection-audit.md)
+- [Luca's Philosophy](./philosophy.md)
+- [Random Principles](./principles.md)
+- [todos](./todos.md)
+
+## Other
+
+- [ElevenLabsClient (clients.elevenlabs)](./apis/clients/elevenlabs.md)
+- [GraphClient (clients.graph)](./apis/clients/graph.md)
+- [OpenAIClient (clients.openai)](./apis/clients/openai.md)
+- [RestClient (clients.rest)](./apis/clients/rest.md)
+- [WebSocketClient (clients.websocket)](./apis/clients/websocket.md)
+- [Assistant (features.assistant)](./apis/features/agi/assistant.md)
+- [AssistantsManager (features.assistantsManager)](./apis/features/agi/assistants-manager.md)
+- [ClaudeCode (features.claudeCode)](./apis/features/agi/claude-code.md)
+- [Conversation (features.conversation)](./apis/features/agi/conversation.md)
+- [ConversationHistory (features.conversationHistory)](./apis/features/agi/conversation-history.md)
+- [DocsReader (features.docsReader)](./apis/features/agi/docs-reader.md)
+- [OpenAICodex (features.openaiCodex)](./apis/features/agi/openai-codex.md)
+- [OpenAPI (features.openapi)](./apis/features/agi/openapi.md)
+- [SemanticSearch (features.semanticSearch)](./apis/features/agi/semantic-search.md)
+- [ContainerLink (features.containerLink)](./apis/features/node/container-link.md)
+- [ContentDb (features.contentDb)](./apis/features/node/content-db.md)
+- [DiskCache (features.diskCache)](./apis/features/node/disk-cache.md)
+- [Dns (features.dns)](./apis/features/node/dns.md)
+- [Docker (features.docker)](./apis/features/node/docker.md)
+- [Downloader (features.downloader)](./apis/features/node/downloader.md)
+- [Esbuild (features.esbuild)](./apis/features/node/esbuild.md)
+- [FileManager (features.fileManager)](./apis/features/node/file-manager.md)
+- [FS (features.fs)](./apis/features/node/fs.md)
+- [Git (features.git)](./apis/features/node/git.md)
+- [GoogleAuth (features.googleAuth)](./apis/features/node/google-auth.md)
+- [GoogleCalendar (features.googleCalendar)](./apis/features/node/google-calendar.md)
+- [GoogleDocs (features.googleDocs)](./apis/features/node/google-docs.md)
+- [GoogleDrive (features.googleDrive)](./apis/features/node/google-drive.md)
+- [GoogleSheets (features.googleSheets)](./apis/features/node/google-sheets.md)
+- [Grep (features.grep)](./apis/features/node/grep.md)
+- [Helpers (features.helpers)](./apis/features/node/helpers.md)
+- [Ink (features.ink)](./apis/features/node/ink.md)
+- [IpcSocket (features.ipcSocket)](./apis/features/node/ipc-socket.md)
+- [JsonTree (features.jsonTree)](./apis/features/node/json-tree.md)
+- [Networking (features.networking)](./apis/features/node/networking.md)
+- [NLP (features.nlp)](./apis/features/node/nlp.md)
+- [Opener (features.opener)](./apis/features/node/opener.md)
+- [OS (features.os)](./apis/features/node/os.md)
+- [PackageFinder (features.packageFinder)](./apis/features/node/package-finder.md)
+- [Postgres (features.postgres)](./apis/features/node/postgres.md)
+- [ChildProcess (features.proc)](./apis/features/node/proc.md)
+- [ProcessManager (features.processManager)](./apis/features/node/process-manager.md)
+- [Python (features.python)](./apis/features/node/python.md)
+- [Repl (features.repl)](./apis/features/node/repl.md)
+- [Runpod (features.runpod)](./apis/features/node/runpod.md)
+- [SecureShell (features.secureShell)](./apis/features/node/secure-shell.md)
+- [SemanticSearch (features.semanticSearch)](./apis/features/node/semantic-search.md)
+- [Sqlite (features.sqlite)](./apis/features/node/sqlite.md)
+- [Telegram (features.telegram)](./apis/features/node/telegram.md)
+- [TTS (features.tts)](./apis/features/node/tts.md)
+- [UI (features.ui)](./apis/features/node/ui.md)
+- [WebVault (features.vault)](./apis/features/node/vault.md)
+- [VM (features.vm)](./apis/features/node/vm.md)
+- [YAML (features.yaml)](./apis/features/node/yaml.md)
+- [YamlTree (features.yamlTree)](./apis/features/node/yaml-tree.md)
+- [AssetLoader (features.assetLoader)](./apis/features/web/asset-loader.md)
+- [ContainerLink (features.containerLink)](./apis/features/web/container-link.md)
+- [Esbuild (features.esbuild)](./apis/features/web/esbuild.md)
+- [Helpers (features.helpers)](./apis/features/web/helpers.md)
+- [Network (features.network)](./apis/features/web/network.md)
+- [Speech (features.speech)](./apis/features/web/speech.md)
+- [WebVault (features.vault)](./apis/features/web/vault.md)
+- [VM (features.vm)](./apis/features/web/vm.md)
+- [VoiceRecognition (features.voice)](./apis/features/web/voice.md)
+- [ExpressServer (servers.express)](./apis/servers/express.md)
+- [MCPServer (servers.mcp)](./apis/servers/mcp.md)
+- [WebsocketServer (servers.websocket)](./apis/servers/websocket.md)
+- [Luca Project](./bootstrap/CLAUDE.md)
+- [Luca: Learning the Container at Runtime](./bootstrap/SKILL.md)
+- [Docs](./bootstrap/templates/docs-readme.md)
+- [Luca Development Guide](./mcp/readme.md)
+- [Code Audit](./prompts/audit-codebase-for-failures-to-use-the-container.md)
+- [MCP Test: Build a Command](./prompts/mcp-test-easy-command.md)
+- [Building a Client](./scaffolds/client.md)
+- [Building a Command](./scaffolds/command.md)
+- [Building an Endpoint](./scaffolds/endpoint.md)
+- [Building a Feature](./scaffolds/feature.md)
+- [Building a Server](./scaffolds/server.md)

package/docs/apis/clients/elevenlabs.md

@@ -0,0 +1,308 @@
+# ElevenLabsClient (clients.elevenlabs)
+
+ElevenLabs client — text-to-speech synthesis via the ElevenLabs REST API. Provides methods for listing voices, listing models, and generating speech audio. Audio is returned as a Buffer; use `say()` for a convenience method that writes to disk.
+
+## Usage
+
+```ts
+container.client('elevenlabs', {
+  // Base URL for the client connection
+  baseURL,
+  // Whether to automatically parse responses as JSON
+  json,
+  // ElevenLabs API key (falls back to ELEVENLABS_API_KEY env var)
+  apiKey,
+  // Default voice ID for speech synthesis
+  defaultVoiceId,
+  // Default TTS model ID
+  defaultModelId,
+  // Audio output format (e.g. mp3_44100_128, pcm_16000)
+  outputFormat,
+})
+```
+
+## Options (Zod v4 schema)
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `baseURL` | `string` | Base URL for the client connection |
+| `json` | `boolean` | Whether to automatically parse responses as JSON |
+| `apiKey` | `string` | ElevenLabs API key (falls back to ELEVENLABS_API_KEY env var) |
+| `defaultVoiceId` | `string` | Default voice ID for speech synthesis |
+| `defaultModelId` | `string` | Default TTS model ID |
+| `outputFormat` | `string` | Audio output format (e.g. mp3_44100_128, pcm_16000) |
+
+## Methods
+
+### beforeRequest
+
+Inject the xi-api-key header before each request.
+
+**Returns:** `void`
+
+
+
+### connect
+
+Validate the API key by listing available models.
+
+**Returns:** `Promise<this>`
+
+```ts
+await el.connect()
+```
+
+
+
+### listVoices
+
+List available voices with optional search and filtering.
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `options` | `{
+    search?: string
+    category?: string
+    voice_type?: string
+    page_size?: number
+    next_page_token?: string
+  }` |  | Query parameters for filtering voices |
+
+**Returns:** `Promise<any>`
+
+```ts
+const voices = await el.listVoices()
+const premade = await el.listVoices({ category: 'premade' })
+```
+
+
+
+### getVoice
+
+Get details for a single voice.
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `voiceId` | `string` | ✓ | The voice ID to look up |
+
+**Returns:** `Promise<any>`
+
+```ts
+const voice = await el.getVoice('21m00Tcm4TlvDq8ikWAM')
+console.log(voice.name, voice.settings)
+```
+
+
+
+### listModels
+
+List available TTS models.
+
+**Returns:** `Promise<any[]>`
+
+```ts
+const models = await el.listModels()
+console.log(models.map(m => m.model_id))
+```
+
+
+
+### synthesize
+
+Synthesize speech from text, returning audio as a Buffer.
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `text` | `string` | ✓ | The text to convert to speech |
+| `options` | `SynthesizeOptions` |  | Voice, model, format, and voice settings overrides |
+
+`SynthesizeOptions` properties:
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `voiceId` | `string` |  |
+| `modelId` | `string` |  |
+| `outputFormat` | `string` |  |
+| `voiceSettings` | `ElevenLabsVoiceSettings` |  |
+| `disableCache` | `boolean` |  |
+
+**Returns:** `Promise<Buffer>`
+
+```ts
+const audio = await el.synthesize('Hello world')
+// audio is a Buffer of mp3 data
+
+const custom = await el.synthesize('Hello', {
+ voiceId: '21m00Tcm4TlvDq8ikWAM',
+ voiceSettings: { stability: 0.5, similarityBoost: 0.8 }
+})
+```
+
+
+
+### say
+
+Synthesize speech and write the audio to a file.
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `text` | `string` | ✓ | The text to convert to speech |
+| `outputPath` | `string` | ✓ | File path to write the audio to |
+| `options` | `SynthesizeOptions` |  | Voice, model, format, and voice settings overrides |
+
+`SynthesizeOptions` properties:
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `voiceId` | `string` |  |
+| `modelId` | `string` |  |
+| `outputFormat` | `string` |  |
+| `voiceSettings` | `ElevenLabsVoiceSettings` |  |
+| `disableCache` | `boolean` |  |
+
+**Returns:** `Promise<string>`
+
+```ts
+const path = await el.say('Hello world', './hello.mp3')
+console.log(`Audio saved to ${path}`)
+```
+
+
+
+## Getters
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `apiKey` | `string` | The resolved API key from options or environment. |
+
+## Events (Zod v4 schema)
+
+### failure
+
+Emitted when a request fails
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `any` | The error object |
+
+
+
+### voices
+
+Emitted after listing voices
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `array` |  |
+
+
+
+### speech
+
+Emitted after speech synthesis completes
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `voiceId` | `string` |  |
+| `text` | `string` |  |
+| `audioSize` | `number` |  |
+
+
+
+## State (Zod v4 schema)
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `connected` | `boolean` | Whether the client is currently connected |
+| `requestCount` | `number` | Total number of API requests made |
+| `characterCount` | `number` | Total characters sent for synthesis (tracks billing usage) |
+| `lastRequestTime` | `any` | Timestamp of the last API request |
+
+## Environment Variables
+
+- `ELEVENLABS_API_KEY`
+
+## Examples
+
+**clients.elevenlabs**
+
+```ts
+const el = container.client('elevenlabs')
+await el.connect()
+const voices = await el.listVoices()
+const audio = await el.synthesize('Hello world')
+// audio is a Buffer of mp3 data
+```
+
+
+
+**connect**
+
+```ts
+await el.connect()
+```
+
+
+
+**listVoices**
+
+```ts
+const voices = await el.listVoices()
+const premade = await el.listVoices({ category: 'premade' })
+```
+
+
+
+**getVoice**
+
+```ts
+const voice = await el.getVoice('21m00Tcm4TlvDq8ikWAM')
+console.log(voice.name, voice.settings)
+```
+
+
+
+**listModels**
+
+```ts
+const models = await el.listModels()
+console.log(models.map(m => m.model_id))
+```
+
+
+
+**synthesize**
+
+```ts
+const audio = await el.synthesize('Hello world')
+// audio is a Buffer of mp3 data
+
+const custom = await el.synthesize('Hello', {
+ voiceId: '21m00Tcm4TlvDq8ikWAM',
+ voiceSettings: { stability: 0.5, similarityBoost: 0.8 }
+})
+```
+
+
+
+**say**
+
+```ts
+const path = await el.say('Hello world', './hello.mp3')
+console.log(`Audio saved to ${path}`)
+```
+

package/docs/apis/clients/graph.md

@@ -0,0 +1,107 @@
+# GraphClient (clients.graph)
+
+GraphQL client that wraps RestClient with convenience methods for executing queries and mutations. Automatically handles the GraphQL request envelope (query/variables/operationName) and unwraps responses, extracting the `data` field and emitting events for GraphQL-level errors.
+
+## Usage
+
+```ts
+container.client('graph', {
+  // Base URL for the client connection
+  baseURL,
+  // Whether to automatically parse responses as JSON
+  json,
+  // The GraphQL endpoint path, defaults to /graphql
+  endpoint,
+})
+```
+
+## Options (Zod v4 schema)
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `baseURL` | `string` | Base URL for the client connection |
+| `json` | `boolean` | Whether to automatically parse responses as JSON |
+| `endpoint` | `string` | The GraphQL endpoint path, defaults to /graphql |
+
+## Methods
+
+### query
+
+Execute a GraphQL query and return the unwrapped data.
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `query` | `string` | ✓ | The GraphQL query string |
+| `variables` | `Record<string, any>` |  | Optional variables for the query |
+| `operationName` | `string` |  | Optional operation name when the query contains multiple operations |
+
+**Returns:** `Promise<R>`
+
+
+
+### mutate
+
+Execute a GraphQL mutation and return the unwrapped data. Semantically identical to query() but named for clarity when performing mutations.
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `mutation` | `string` | ✓ | The GraphQL mutation string |
+| `variables` | `Record<string, any>` |  | Optional variables for the mutation |
+| `operationName` | `string` |  | Optional operation name when the mutation contains multiple operations |
+
+**Returns:** `Promise<R>`
+
+
+
+## Getters
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `endpoint` | `any` | The GraphQL endpoint path. Defaults to '/graphql'. |
+
+## Events (Zod v4 schema)
+
+### graphqlError
+
+Emitted when GraphQL-level errors are present in the response
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `array` | Array of GraphQL errors |
+
+
+
+### failure
+
+Emitted when a request fails
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `any` | The error object |
+
+
+
+## State (Zod v4 schema)
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `connected` | `boolean` | Whether the client is currently connected |
+
+## Examples
+
+**clients.graph**
+
+```ts
+const gql = container.client('graph', { baseURL: 'https://api.example.com' })
+const data = await gql.query(`{ users { id name } }`)
+await gql.mutate(`mutation($name: String!) { createUser(name: $name) { id } }`, { name: 'Alice' })
+```
+