Calling AI Service

const client = new City({
  role: "user",
  federation_url: "http://127.0.0.1:43127",
  city_id: "city_downcity",
  user_token: "ub_xxx",
});

// List models
const catalog = await client.ai.listModels();

// Text generation
const result = await client.ai.text({
  model: catalog.get("deepseek-v4-flash"),
  prompt: "Hello",
});

// Stream
const stream = await client.ai.stream({
  model: "deepseek-v4-flash",
  prompt: "Stream a text",
});

// ModelHandle - bind model, skip model on subsequent calls
const handle = client.ai.model(catalog.get("deepseek-v4-flash"));
const text = await handle.text({ prompt: "Hello" });
const stream = await handle.stream({ prompt: "Continue" });

// handle also carries endpoint + token for external SDKs
handle.url()       // "http://127.0.0.1:43127/v1/ai"
handle.modelName() // "deepseek-v4-flash"
handle.token       // "ub_xxx"

# curl
curl http://127.0.0.1:43127/v1/ai/chat/completions \
  -H "Authorization: Bearer ub_xxx" \
  -d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"hello"}],"stream":true}'

// OpenAI SDK
const handle = client.ai.model(catalog.get("deepseek-v4-flash"));
const openai = new OpenAI({
  baseURL: handle.url(),
  apiKey: handle.token,
});
await openai.chat.completions.create({
  model: handle.modelName(),
  messages: [{ role: "user", content: "hello" }],
  stream: true,
});

// downcity agent
const handle = client.ai.model(catalog.get("deepseek-v4-flash"));
const session = await createPiAgentSession({
  model: handle,
  tools: "agent",
  onText: (text) => process.stdout.write(text),
});
await session.ask("Write an HTTP server");