API Agent

API agent for managing the Digital Twin API, creating scenes, and maintaining data.

Installation

Install globally via npm:

npm install -g @twinark/agent-api-manager

Or install locally in your project:

npm install @twinark/agent-api-manager

Usage

Start the agent:

dt-api-manager

The agent will:

1. Connect to the configured LLM proxy (any OpenAI-compatible endpoint)
2. Discover available AI models
3. Connect to framework bus (if token provided)

Configuration

Settings (.pi/agent/settings.json)

Located at ~/.agent-api-manager/settings.json when installed globally.

{
  "llmProxy": {
    "baseUrl": "http://localhost:4000"
  },
  "framework": {
    "busUrl": "http://localhost:8050",
    "heartbeatIntervalMs": 30000,
    "agentId": "agent-api-manager"
  }
}

Secrets (.env)

Located at ~/.agent-api-manager/.env when installed globally.

# LLM proxy API key (OpenAI, LiteLLM, Groq, Ollama, vLLM, etc.)
LLM_PROXY_API_KEY=sk-1234

# Framework Bus Token
DIGITAL_TWIN_API_KEY=your-jwt-token-here

Expertise

This agent specializes in:

• api
• scenes
• data
• assets
• digital-twin

Development

Local Development

Install dependencies

npm install

Start in development mode

npm start

### Publishing Updates

From the agents directory:

```powershell
# Interactive publish (select agent, bump version)
..\publish-agent.ps1

# Or specify agent and version bump
..\publish-agent.ps1 -AgentName "api" -VersionBump "patch"

Version bump types:

• patch: Bug fixes (0.1.0 → 0.1.1)
• minor: New features (0.1.0 → 0.2.0)
• major: Breaking changes (0.1.0 → 1.0.0)

Extensions

• model-provider: Dynamic model discovery from any OpenAI-compatible LLM proxy
• bus: Framework agent bus integration for coordination