Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.auvy.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
TypeScript SDK

@auvy-synapse/client is the official public SDK for AUVY. It maps cleanly onto the unified resource spine: use auvy.resources for browse, search, resource trees, and catalog symmetry; use auvy.resourceStore for assets and artifacts; use auvy.receptors, auvy.neurons, auvy.pathways, and auvy.jobs for gateways and execution. See SDK resources for the full namespace map. Default integration is one workspace API key: fromApiKey() bootstraps workspace id/slug from the API. Advanced options cover manual config and browser (publishable key + JWT).

​
Install

npm install @auvy-synapse/client

​
Authentication (API key first)

ModeBest forSetup
fromApiKey()Servers, scripts, agentsRecommended. Pass the key string, or call with no args when AUVY_API_KEY is set. Same bootstrap as createAUVYClient.fromApiKey(key).
fromApiKey({ baseUrl, ... })Env + overridesMerges AUVY_API_KEY / AUVY_API_URL with optional fields.
createAUVYClient({ apiKey, ... })Advanced server configManual baseUrl / workspaceSlug without bootstrap.
createAUVYClient({ publishableKey, getAccessToken })Browser appsPublishable key plus user JWT.
createAUVYClient.fromEnv()Sync env read (no bootstrap)Does not call the API for workspace context; prefer fromApiKey() for API keys.
fromApiKey validates the key and calls GET /v1/session/context so workspace_id and workspace_slug are set automatically.

​
Server quick start

import { fromApiKey } from '@auvy-synapse/client'

const auvy = await fromApiKey(process.env.AUVY_API_KEY!)
// or: const auvy = await fromApiKey()

const receptors = await auvy.receptors.list()
const { job_id } = await auvy.receptors.invoke('my-workspace', 'support-bot', {
  message: 'Summarize the latest incidents',
})

​
Browser quick start

import { createAUVYClient } from '@auvy-synapse/client'
import { createClient } from '@supabase/supabase-js'

const supabase = createClient(SUPABASE_URL, SUPABASE_PUBLISHABLE_KEY)

const auvy = createAUVYClient({
  publishableKey: process.env.NEXT_PUBLIC_AUVY_PUBLISHABLE_KEY!,
  workspaceSlug: process.env.NEXT_PUBLIC_AUVY_WORKSPACE_SLUG,
  getAccessToken: async () => {
    const { data: { session } } = await supabase.auth.getSession()
    return session?.access_token ?? null
  },
})

​
Environment variables

The SDK supports these environment variables:
  • AUVY_API_KEY for backend API-key auth
  • AUVY_API_URL or NEXT_PUBLIC_AUVY_API_URL for self-hosted or local API URLs
  • AUVY_WORKSPACE_SLUG or NEXT_PUBLIC_AUVY_WORKSPACE_SLUG for default workspace scope
  • AUVY_PUBLISHABLE_KEY or NEXT_PUBLIC_AUVY_PUBLISHABLE_KEY for browser auth
  • AUVY_API_VERSION for explicit API version overrides
  • AUVY_TIMEOUT_MS for request timeouts

​
Core capabilities

  • resources (browse, search, trees, catalog symmetry) plus typed clients for receptors, jobs, resourceStore (assets and artifacts), traces, neurons, reflexes, recollections, usage, activity, and more
  • Streaming — createStream(auvy, jobId) (facade-aware), receptors.createStream(jobId), streamJobTokens, share-token options
  • Built-in retry and rate-limit handling
  • Async pagination utilities and listAll() helpers
  • Interceptors — auvy.interceptors.add(...) on the client from fromApiKey() / createAUVYClient() (shared request pipeline)
  • Public share-token helpers for public receptor and trace flows

​
Out of scope for this docs set

JWT-only workspace integration-management routes are intentionally outside this API-key-focused reference set. The public SDK docs here cover the surfaces you can drive directly with an API key, publishable key, or share token.

​
Next steps