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:
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.
Copy .env.example to .env.local and provide every value explicitly:
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.
pnpm install --frozen-lockfile
pnpm dev
pnpm install --frozen-lockfile
pnpm typecheck
pnpm test
pnpm build
A successful local verification has all of these observable results:
- TypeScript exits with code
0and reports no diagnostics. - The Node test runner reports no failed tests.
- Vite exits with code
0and creates the productiondist/directory.
The Playwright suite is intentionally not a standalone mock test. It requires the exact Core, Samples, and Stack environment prepared by NeKiro-Stack:
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 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.
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.