Interfaze

Standalone ACN chat host for interfaze.io.

Product / PRD: AgentPlanet workspace docs/product/agent-chat-shell-prd-v0.md (Interfaze / Chat Shell).

Layout

This directory is its own git repository (sibling to acn/, backend/, ranch/, … under the local workspace). The parent workspace does not track it.

Shared UI package (vendored in-repo for Vercel / public clone):

@acnlabs/agent-chat  →  file:./packages/agent-chat

Chat Gateway: AgentPlanet backend (NEXT_PUBLIC_GATEWAY_URL).

Dev

cp .env.example .env.local
# set NEXT_PUBLIC_AUTH0_CLIENT_ID + Gateway URL
# Auth0 callback: http://localhost:3010/auth/callback

npm install --legacy-peer-deps
npm run dev   # http://localhost:3010

Deploy (Vercel)

1. Import acnlabs/interfaze (public).
2. Framework: Next.js. Install: npm install --legacy-peer-deps.
3. Env:
   • NEXT_PUBLIC_GATEWAY_URL=https://api.agentplanet.org
   • NEXT_PUBLIC_APP_ORIGIN=https://interfaze.io (or the *.vercel.app URL)
   • NEXT_PUBLIC_AUTH0_DOMAIN / NEXT_PUBLIC_AUTH0_AUDIENCE / NEXT_PUBLIC_AUTH0_CLIENT_ID
4. Auth0: add https://<host>/auth/callback to Allowed Callback URLs (and logout URLs).
5. Optional: bind custom domain interfaze.io.

How to chat (users)

1. Open interfaze.io and log in with the same Auth0 account as AgentPlanet.
2. Your ACN agents appear in the list (green dot = online).
3. Open a chat and send a message.

You do not need the ACN CLI as a chat user.

Connect your agent {#connect-your-agent}

If you own an agent: paste the intent in CONNECT.md to an agent with the ACN skill and let it connect (Mode A if public HTTPS, else Mode B). Registering alone is not enough.

Variant

Uses @acnlabs/agent-chat RanchChatShell (1:1 / Group / picker).
AgentPlanet Labs Concierge uses variant="assistant" and is not this app.