Browser-based graphical shell and control plane for a Linux server you own — real terminal, file manager, live metrics and BYOK AI in one mobile-first workspace. Next.js 16 · React 19 · node-pty · Tailwind v4 · shadcn/ui. Public alpha, self-hosted.
TypeScript browser-shellcontrol-planefile-managerhomelabmobile-firstnextjsptyreactself-hostedserver-managementshadcn-uisysadmintailwindcssterminaltypescriptvpsweb-desktopweb-terminal
import type { Scope } from "@/lib/capabilities/scope";
import type { WorkflowOrchestrationSnapshot } from "@/lib/contracts/orchestration";
export type WorkflowStepState = "completed" | "failed" | "denied" | "rate_limited" | "invalid_args";
export type RecipeMaturity = "observed" | "candidate" | "verified";
export type WorkflowReplayHandle = {
kind: "file" | "job" | "artifact" | "cursor";
path?: string;
sha256?: string;
jobId?: string;
artifactId?: string;
cursor?: string;
truncated?: boolean;
rereadWith?: "fs_read" | "read_pipeline" | "exec_job_status" | "session_artifacts" | "project_candidate_search";
};
export type WorkflowCandidatePool = {
version: 1;
revision?: string;
paths: string[];
skillIds: string[];
connectionIds: string[];
mcpAliases: string[];
truncated?: boolean;
cursor?: string;
reusedFromRecipe?: string;
};
export type WorkflowStepProvenance = {
/** Human-readable session label only; internal session ids never enter learned recipes. */
sessionLabel: string;
actionRef: string;
eventRef: string;
artifactRefs?: string[];
evidenceRef?: string;
observedAt: string;
};
export type WorkflowStep = {
id: string;
tool: string;
state: WorkflowStepState;
target?: string;
args?: Record<string, string | number | boolean>;
durationMs?: number;
ts: string;
replay?: WorkflowReplayHandle[];
provenance?: WorkflowStepProvenance;
};
export type WorkflowStepInput = Omit<WorkflowStep, "args"> & { args?: Record<string, unknown> };
export type ActiveWorkflow = {
id: string;
actor: string;
scope: Scope;
intent: string;
project?: string;
constraints?: string;
orchestration?: WorkflowOrchestrationSnapshot;
candidatePool?: WorkflowCandidatePool;
startedAt: string;
steps: WorkflowStep[];
};
export type WorkflowQuality = {
stepAttempts: number; completedSteps: number; failedSteps: number; deniedSteps: number;
rateLimitedSteps: number; invalidArgSteps: number; retries: number; rollbackSignals: number;
timedSteps: number; totalStepDurationMs: number; averageStepDurationMs: number;
};
export type LearnedRecipe = {
id: string;
actor: string;
scope: Scope;
intent: string;
normalizedIntent: string;
project?: string;
summary: string;
embeddingVersion: string;
embedding: number[];
bestSteps: WorkflowStep[];
lastSteps: WorkflowStep[];
candidatePool?: WorkflowCandidatePool;
attempts: number;
successes: number;
failures: number;
averageDurationMs: number;
fastestDurationMs?: number;
lastDurationMs: number;
averageWallDurationMs: number;
lastWallDurationMs: number;
quality: WorkflowQuality;
lastQuality: WorkflowQuality;
qualityVersion?: 1;
createdAt: string;
updatedAt: string;
intentAliases?: string[];
recommendationCount?: number;
routeMatchCount?: number;
routeDivergenceCount?: number;
lastRecommendedAt?: string;
lastRouteMatchedAt?: string;
lastRouteDivergedAt?: string;
lastReuseScore?: number;
/** Legacy pre-v3 field: historical selection/recommendation time, not proof of application. */
lastUsedAt?: string;
};
export type ActiveWorkflowBuckets = Record<string, Record<string, ActiveWorkflow>>;
export type WorkflowStoreState = {
version: 3;
active: ActiveWorkflowBuckets;
recipes: Record<string, LearnedRecipe>;
};
export type FinishWorkflowResult = {
graphReceipt?: { state: "available" | "skipped" | "warning"; graphId?: string; warning?: string };
workflow: ActiveWorkflow;
recipe: LearnedRecipe;
currentDurationMs: number;
previousFastestMs?: number;
improvedByMs?: number;
improvedPct?: number;
reuse?: { recommendedRecipeId: string; routeMatched: boolean; score: number };
};
export type CancelWorkflowResult = { workflow: ActiveWorkflow; reason?: string };
export type RecipeAccess =
| { actor: string; scope: Scope; ownerView?: false }
| { ownerView: true; actor?: never; scope?: never };
export type ProjectContentionSummary = {
activeWorkflowCount: number;
conflictingWorkflowCount: number;
overlappingPaths: string[];
overlappingResources: string[];
};