skills.rest
Lingtai-AI
Lingtai-AIOFFICIAL
Explore all skills by this author →
GitHub

portal-guide-topology-and-api

Documents topology tape frames, replay chunks, and portal HTTP API endpoints.

692|60|Updated Mar 15, 2026
Search Tags:#reference#topology#api documentation#Json#replay#http endpoints#network state
One-click install
npx skills add https://github.com/Lingtai-AI/lingtai --skill portal-guide-topology-and-api
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: portal-guide-topology-and-api
Source: https://github.com/Lingtai-AI/lingtai/tree/main/tui/internal/preset/skills/lingtai-portal-guide/reference/topology-and-api
Command: npx skills add https://github.com/Lingtai-AI/lingtai --skill portal-guide-topology-and-api

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers working with the LingTai portal need a single reference for how network topology data is stored on disk and served over HTTP, without reading the source code.

Core Features & Use Cases

  • Topology Tape Format: Explains the topology.jsonl TapeFrame structure with millisecond timestamps and embedded Network objects.
  • Replay Chunk Storage: Describes delta-encoded, keyframed, gzipped JSON chunks bucketed by hour under .lingtai/.portal/replay/chunks/ with a manifest.
  • HTTP API Reference: Documents endpoints such as /api/network, /api/topology, /api/topology/manifest, /api/topology/chunk, /api/topology/progress, and /api/topology/rebuild.
  • Use Case: When building a dashboard that visualizes the live agent network, consult this reference to learn the Network JSON shape (nodes, avatar_edges, contact_edges, mail_edges, stats) returned by /api/network.

Quick Start

Ask the AI to explain the LingTai portal topology tape format and the /api/network response shape using this reference.

Frequently Asked Questions about portal-guide-topology-and-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get live network state from the LingTai portal API?▼

Send a GET request to /api/network on the portal's localhost port. It returns a Network JSON object with nodes, avatar_edges, contact_edges, mail_edges, and aggregate stats such as active, idle, and total_mails.

What is the format of the topology.jsonl tape file?▼

Each line of topology.jsonl is a TapeFrame containing a millisecond epoch timestamp field t and a net field holding the same Network object served by /api/network.

How are historical topology replay chunks stored on disk?▼

Historical data lives under .lingtai/.portal/replay/chunks/ as delta-encoded, keyframed, gzipped JSON chunks bucketed by hour. A manifest.json in that directory lists all chunks with their time ranges and frame counts.

How do I trigger a rebuild of the topology replay data?▼

Send a POST request to /api/topology/rebuild. It reconstructs the tape from source data, rewrites the replay chunks, and returns a ReplayManifest JSON describing the result.

What fields does a node in the Network response contain?▼

Each node includes address, agent_name, nickname, state (such as ACTIVE), alive, is_human, and a capabilities array listing abilities like avatar or search.

Related Skills

Explore More Software Engineering Skills→
Lingtai-AILingtai-AI
621

lingtai-portal-guide

Explain LingTai portal internals, topology recording, and .portal directory structure.

Official
Intermediate
dy9759dy9759
1

data-visualization-expert

Design charts, dashboards, and interactive data applications for business analytics.

Community
Intermediate
Lingtai-AILingtai-AI
621

lingtai-issue-report

File structured LingTai issue reports via GitHub CLI or manual submission.

Official
Advanced
huangzesenhuangzesen
621

lingtai-portal-guide

Document LingTai portal API endpoints, topology data, and .portal directory structure.

Community
Basic