Sophon

Connector builder skill

This page is for teams who already have an agent runtime and want an AI coding assistant to build the Sophon connector around it.

Sophon should not teach your users how to build agents from scratch. The product surface is narrower: connect agents they already run to an iOS chat UI.

Use the skill

Install it from the public Sophon repository:

npx skills add serafim-labs/Sophon --skill sophon-connector

Or copy the source file directly:

Open SKILL.md on GitHub

Give it to your coding assistant as an Agent Skill, project rule, or repo instruction file. The skill tells the assistant to focus on the bridge layer:

  • authenticate with a Sophon bridge token
  • open the Sophon bridge WebSocket
  • receive session.message
  • call the existing runtime
  • stream deltas and final text back to Sophon
  • mirror tools and approvals when the runtime supports them

What the skill intentionally avoids

It does not explain how to design a new agent, choose an LLM, build a planner, or invent a tool system. Those decisions belong to the agent runtime.

The connector only adapts that runtime to the Sophon Agent Protocol.

When to use it

Use it when the repo already has one of these:

  • a local CLI agent
  • an HTTP agent service
  • a Python or TypeScript agent function
  • an MCP-backed runtime
  • a hosted API that takes user messages and returns text

The coding assistant should inspect that runtime first, then write the small bridge process next to it.

Skill contents

---
name: sophon-connector
description: Build a Sophon connector that exposes an existing agent runtime in the Sophon iOS app.
summary: Build a Sophon connector that exposes an existing agent runtime in the Sophon iOS app.
version: 0.1.0
---
 
# Sophon Connector Skill
 
Use this skill when the user wants to connect an existing agent runtime
to Sophon. Do not teach them how to build a general-purpose agent from
scratch. Your job is to build the bridge layer between Sophon and the
runtime they already have.
 
## Goal
 
Create a long-running connector process that:
 
1. Authenticates with a Sophon bridge token.
2. Opens `wss://api.sophon.at/v1/bridge/ws`.
3. Receives `session.message` updates.
4. Sends the message into the user's existing agent runtime.
5. Streams text back through `/v1/bridge/sendMessageDelta`.
6. Finalizes through `/v1/bridge/sendMessageEnd`.
7. Mirrors tool calls and approval requests when the runtime supports them.

The canonical file lives in the public repo at skills/sophon-connector/SKILL.md so it can be installed through npx skills add serafim-labs/Sophon.