跳转至
Canonical source：README.md。本页保留 Console canonical 文档，中文内容来自仓库的 RepoWiki 源文件。

NeKiro Console

The production React/Vite/TypeScript Console for the NeKiro Agent Operating Platform. This repository is the canonical Console source; the core platform repository does not maintain a production UI copy after the repository split.

The Console talks only to the NeKiro Gateway. It supports trusted Agent publication, public Agent share URLs, Catalog discovery, exact Release installation, managed JSON/SSE invocation, and Workspace-scoped Ledger reads.

The authenticated Console presents those capabilities as one guided journey:

1
Agents -> Publish -> Install -> Invoke -> Trace

Successful steps carry only the exact server-returned Agent, Release, Installation, and correlation identifiers into the next screen. The browser does not persist those handoffs or turn failed reads into local success.

Configuration

Copy .env.example to .env.local and provide every value explicitly:

1
2
3
4
5
6
7
VITE_NEKIRO_API_BASE_URL=https://gateway.example.test
VITE_NEKIRO_PROVIDER_ID=provider-id
VITE_NEKIRO_PROVIDER_NAME=Provider Name
VITE_NEKIRO_PROVIDER_TOKEN=provider-token
VITE_NEKIRO_OWNER_TOKEN=workspace-owner-token
VITE_NEKIRO_DEFAULT_WORKSPACE_ID=workspace-id
VITE_NEKIRO_PUBLIC_AGENT_ORIGIN=https://agents.example.test

Provider and Workspace credentials are sent only as authorization headers and are not written to browser storage. Missing, blank, whitespace-padded, or otherwise invalid required configuration fails at startup.

Development

1
2
pnpm install --frozen-lockfile
pnpm dev

Verification

1
2
3
4
pnpm install --frozen-lockfile
pnpm typecheck
pnpm test
pnpm build

A successful local verification has all of these observable results:

  • TypeScript exits with code 0 and reports no diagnostics.
  • The Node test runner reports no failed tests.
  • Vite exits with code 0 and creates the production dist/ directory.

The Playwright suite is intentionally not a standalone mock test. It requires the exact Core, Samples, and Stack environment prepared by NeKiro-Stack:

1
pnpm test:e2e

Success means every Playwright scenario passes against the live Gateway route; the Console must not connect directly to Core internals, PostgreSQL, or sample Agent endpoints.

Console CI verifies only Console-owned behavior. Full backend/browser product acceptance is owned by NeKiro-Stack, which checks out an exact Console commit and invokes the retained Playwright suite against its immutable component manifest.

Pull requests

Pull requests must state the user-visible surface, affected Gateway contract, commands run, and their success signals. Contract or route changes must also identify the Core revision and the NeKiro-Stack manifest update that will verify the production browser path.

RepoWiki

The NeKiro Console RepoWiki uses English and Chinese navigation for Console-owned documentation rendered with MkDocs Material. Detailed RepoWiki exports currently retain their canonical source language; the committed .qoder/repowiki documents remain the source of truth.

Fallback behavior is not implemented in the Console. Dependency, contract, authorization, lifecycle, timeout, cancellation, and malformed-response states remain explicit failures.