@treeport/treeport 0.1.0 → 0.2.2

package/drizzle/meta/_journal.json

@@ -8,6 +8,55 @@
       "when": 1785230060971,
       "tag": "0000_public_baseline",
       "breakpoints": true
+    },
+    {
+      "idx": 1,
+      "version": "6",
+      "when": 1785577623909,
+      "tag": "0001_misty_spectrum",
+      "breakpoints": true
+    },
+    {
+      "idx": 2,
+      "version": "6",
+      "when": 1785589844379,
+      "tag": "0002_dazzling_princess_powerful",
+      "breakpoints": true
+    },
+    {
+      "idx": 3,
+      "version": "6",
+      "when": 1785834323406,
+      "tag": "0003_yummy_whirlwind",
+      "breakpoints": true
+    },
+    {
+      "idx": 4,
+      "version": "6",
+      "when": 1785920000000,
+      "tag": "0004_persistent_worktree_creation",
+      "breakpoints": true
+    },
+    {
+      "idx": 5,
+      "version": "6",
+      "when": 1786000000000,
+      "tag": "0005_git_authoritative_worktrees",
+      "breakpoints": true
+    },
+    {
+      "idx": 6,
+      "version": "6",
+      "when": 1786283200364,
+      "tag": "0006_web_panel_launch_input",
+      "breakpoints": true
+    },
+    {
+      "idx": 7,
+      "version": "6",
+      "when": 1786533775050,
+      "tag": "0007_dashing_pestilence",
+      "breakpoints": true
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeport/treeport",
-  "version": "0.1.0",
+  "version": "0.2.2",
   "description": "A worktree-first terminal driver for persistent development workspaces.",
   "type": "module",
   "bin": {
@@ -36,7 +36,10 @@
   },
   "dependencies": {
     "@hono/node-server": "^2.0.10",
+    "@hono/zod-validator": "^0.9.0",
     "@libsql/client": "^0.17.4",
+    "@radix-ui/react-context-menu": "^2.3.7",
+    "@vitejs/plugin-react": "5.2.0",
     "@xterm/headless": "^6.0.0",
     "commander": "14.0.3",
     "drizzle-orm": "^0.45.2",
@@ -46,7 +49,9 @@
     "node-pty": "1.2.0-beta.14",
     "socket.io": "4.8.3",
     "socket.io-client": "4.8.3",
-    "zod": "^4.3.6"
+    "vite": "8.1.5",
+    "zod": "^4.3.6",
+    "@treeport/panel-sdk": "0.2.2"
   },
   "devDependencies": {
     "@fontsource-variable/inter": "^5.2.8",
@@ -54,18 +59,15 @@
     "@radix-ui/react-alert-dialog": "^1.1.23",
     "@radix-ui/react-checkbox": "^1.3.11",
     "@radix-ui/react-dialog": "^1.1.23",
-    "@radix-ui/react-dropdown-menu": "^2.1.21",
     "@radix-ui/react-popover": "^1.1.19",
     "@radix-ui/react-separator": "^1.1.15",
     "@radix-ui/react-slot": "^1.3.0",
-    "@radix-ui/react-tabs": "^1.1.17",
     "@radix-ui/react-tooltip": "^1.2.12",
     "@tailwindcss/vite": "^4.3.3",
     "@tanstack/react-query": "^5.101.2",
     "@tanstack/react-router": "^1.170.18",
     "@types/react": "^19.2.10",
     "@types/react-dom": "^19.2.3",
-    "@vitejs/plugin-react": "^5.1.4",
     "@xterm/addon-fit": "^0.11.0",
     "@xterm/addon-web-links": "^0.12.0",
     "@xterm/xterm": "^6.0.0",
@@ -79,7 +81,6 @@
     "tailwind-merge": "^3.6.0",
     "tailwindcss": "^4.3.3",
     "tsdown": "0.22.14",
-    "vite": "^8.1.5",
     "@treeport/shared": "0.1.0"
   },
   "scripts": {
@@ -90,12 +91,11 @@
     "check:package": "node scripts/check-package.mjs",
     "test:package": "node scripts/smoke-package.mjs",
     "dev": "node scripts/development.mjs",
-    "dev:server": "TREEPORT_DATA_DIR=.treeport-dev/data TREEPORT_RUNTIME_DIR=.treeport-dev/runtime tsdown --watch --on-success \"node --enable-source-maps dist/node/server/index.js\"",
-    "dev:web": "vite",
+    "dev:server": "TREEPORT_DATA_DIR=.treeport-dev/data TREEPORT_RUNTIME_DIR=.treeport-dev/runtime TREEPORT_DAEMON_LIFECYCLE=external tsdown --watch --on-success \"node --enable-source-maps dist/node/server/index.js\"",
     "start": "TREEPORT_WEB_DIST=dist/web node dist/node/server/index.js",
     "db:generate": "drizzle-kit generate",
     "typecheck": "pnpm typecheck:node && pnpm typecheck:web",
-    "typecheck:node": "tsc --noEmit -p tsconfig.node.json --pretty",
+    "typecheck:node": "tsc -b tsconfig.node.json --pretty",
     "typecheck:web": "tsc --noEmit -p tsconfig.web.json --pretty"
   }
 }

package/skills/treeport/SKILL.md

@@ -17,6 +17,7 @@ Treeport does not define task sources, planning or approval states, agent tool p
 - Do not use `eval` or an implicit `sh -lc`. Launch a shell explicitly only when the caller intentionally requests shell semantics.
 - Do not place untrusted titles, prompts, or other external text into interpolated shell fragments. Pass each value as one argument or use a caller-managed file when the child supports file arguments.
 - Never delete a terminal or remove a worktree unless the user explicitly asks.
+- Obey the daemon lifecycle reported by `treeport context`. When it is `external`, never run `treeport up`, `treeport down`, or `treeport remote enable`; the parent process owns startup, shutdown, and remote exposure.
 - Do not restrict a launched agent's normal tools or make it ephemeral unless the caller explicitly asks. The persistent interactive session is intended to remain useful when the user takes over.
 
 ## Understand the current context
@@ -27,7 +28,7 @@ Run:
 treeport context
 ```
 
-Inside a managed terminal, this reports the current project, worktree, terminal, paths, statuses, IDs, and daemon URL. It resolves the injected IDs strictly; it does not guess identity from the current path.
+Inside a managed terminal, this reports the current project, worktree, terminal, paths, statuses, IDs, daemon URL, and whether the daemon lifecycle is managed by Treeport or by an external process. It resolves the injected IDs strictly; it does not guess identity from the current path.
 
 Outside Treeport it reports that the terminal is not managed and exits successfully. `TREEPORT_API_URL` may be configured outside a managed terminal; if any context ID is present, however, all injected values are required. Partial IDs or IDs that no longer belong together fail instead of falling back to path inference.
 
@@ -150,4 +151,4 @@ JSON success output is written to stdout. JSON errors use `{ "error": { "code",
 - `5`: API, domain, or invalid-context refusal.
 - `130`: a terminal wait was interrupted with Ctrl+C.
 
-Treeport currently has no authentication. Use it only through a trusted local or private-network listener; do not invent credentials or put secrets in command arguments or URLs.
+Treeport trusts the local OS boundary for loopback access and delegates supported remote authentication to Tailscale Serve. Do not expose the daemon through a direct network listener, invent credentials, or put secrets in command arguments or URLs.

package/dist/dist-CUkImh2W.js

@@ -1,254 +0,0 @@
-import { z } from "zod";
-//#region ../../packages/shared/dist/terminal-protocol.js
-const SOCKET_IO_PATH = "/api/socket.io/";
-const TERMINAL_CONTROLLER_GRACE_MS = 1e4;
-const TERMINAL_OUTPUT_HIGH_WATERMARK = 256 * 1024;
-const TERMINAL_OUTPUT_LOW_WATERMARK = 64 * 1024;
-const TERMINAL_OUTPUT_STALL_TIMEOUT_MS = 3e4;
-const TERMINAL_MAX_CLIENT_MESSAGE_BYTES = 128 * 1024;
-const TERMINAL_MAX_INPUT_BYTES = 64 * 1024;
-const terminalId = z.string().min(1).max(128);
-const clientId = z.string().min(1).max(128);
-const streamId = z.string().min(1).max(128);
-const generation = z.number().int().nonnegative();
-const dimensions = {
-	cols: z.number().int().min(2).max(1e3),
-	rows: z.number().int().min(2).max(500)
-};
-const terminalSizeSchema = z.strictObject(dimensions);
-const terminalProgressSchema = z.strictObject({
-	state: z.enum([
-		"normal",
-		"error",
-		"indeterminate",
-		"paused"
-	]),
-	value: z.number().int().min(0).max(100).nullable()
-});
-const terminalRuntimeMetadataSchema = z.strictObject({
-	terminalId: z.string().min(1),
-	title: z.string().max(256).nullable(),
-	hasForegroundProcess: z.boolean().nullable().optional(),
-	progress: terminalProgressSchema.nullable(),
-	progressStartedAt: z.string().datetime().nullable().default(null),
-	progressClearedAt: z.string().datetime().nullable().default(null),
-	bell: z.strictObject({
-		sequence: z.number().int().positive(),
-		at: z.string().datetime(),
-		unread: z.boolean()
-	}).nullable().default(null)
-});
-const terminalBellAcknowledgementSchema = z.strictObject({ sequence: z.number().int().positive() });
-function parseTerminalRuntimeMetadata(value) {
-	const parsed = terminalRuntimeMetadataSchema.safeParse(value);
-	return parsed.success ? parsed.data : null;
-}
-function parseTerminalProgress(data) {
-	const [command, rawState, rawValue, ...extra] = data.split(";");
-	if (command !== "4" || extra.length > 0 || !/^[0-4]$/.test(rawState ?? "")) return;
-	const state = Number(rawState);
-	if (state === 0) return null;
-	if (rawValue !== void 0 && rawValue !== "" && !/^\d{1,3}$/.test(rawValue)) return;
-	const value = rawValue === void 0 || rawValue === "" ? null : Number(rawValue);
-	if (value !== null && value > 100) return;
-	return {
-		state: [
-			void 0,
-			"normal",
-			"error",
-			"indeterminate",
-			"paused"
-		][state],
-		value
-	};
-}
-const terminalAuthSchema = z.strictObject({
-	terminalId,
-	clientId,
-	...dimensions
-});
-const terminalInputSchema = z.strictObject({
-	generation,
-	data: z.string().max(TERMINAL_MAX_INPUT_BYTES)
-});
-const terminalBinarySchema = z.strictObject({
-	generation,
-	data: z.string().max(TERMINAL_MAX_INPUT_BYTES)
-});
-const terminalResizeSchema = z.strictObject({
-	generation,
-	...dimensions
-});
-const terminalTakeControlSchema = z.strictObject({
-	generation,
-	...dimensions
-});
-const terminalLegacyTakeControlSchema = z.strictObject({ generation });
-const terminalOutputAckSchema = z.strictObject({
-	streamId,
-	sequence: z.number().int().nonnegative()
-});
-const terminalReadyBase = {
-	connectionId: z.string().min(1).max(128),
-	streamId,
-	generation,
-	controller: z.boolean(),
-	reset: z.literal("full")
-};
-const terminalLegacyReadySchema = z.strictObject(terminalReadyBase);
-const terminalReadyV2Schema = z.strictObject({
-	...terminalReadyBase,
-	...dimensions,
-	revision: z.number().int().positive()
-});
-z.union([terminalLegacyReadySchema, terminalReadyV2Schema]);
-z.strictObject({
-	...dimensions,
-	revision: z.number().int().positive()
-});
-z.strictObject({
-	streamId,
-	sequence: z.number().int().positive(),
-	data: z.string()
-});
-z.strictObject({ title: z.string().max(256) });
-z.strictObject({ progress: terminalProgressSchema.nullable() });
-z.strictObject({
-	generation,
-	controller: z.boolean()
-});
-z.strictObject({ exitCode: z.number().int().nullable() });
-z.strictObject({
-	code: z.string().min(1).max(80),
-	message: z.string().min(1).max(1e3),
-	retryable: z.boolean()
-});
-function parseTerminalAuth(value) {
-	const parsed = terminalAuthSchema.safeParse(value);
-	return parsed.success ? parsed.data : null;
-}
-//#endregion
-//#region ../../packages/shared/dist/socket-protocol.js
-const productEventTypeSchema = z.enum([
-	"project.created",
-	"project.updated",
-	"project.removed",
-	"worktree.created",
-	"worktree.updated",
-	"worktree.removed",
-	"terminal.created",
-	"terminal.updated",
-	"terminal.removed",
-	"terminal.metadata",
-	"terminal.controller_changed",
-	"remove.started",
-	"remove.completed",
-	"remove.failed"
-]);
-const productEventSchema = z.strictObject({
-	id: z.string().min(1).max(128),
-	type: productEventTypeSchema,
-	at: z.string().datetime(),
-	data: z.record(z.string(), z.unknown())
-});
-const eventsSnapshotSchema = z.strictObject({
-	at: z.string().datetime(),
-	terminalMetadata: z.array(terminalRuntimeMetadataSchema)
-});
-function parseEventsSnapshot(value) {
-	const parsed = eventsSnapshotSchema.safeParse(value);
-	return parsed.success ? parsed.data : null;
-}
-function parseProductEvent(value) {
-	const parsed = productEventSchema.safeParse(value);
-	return parsed.success ? parsed.data : null;
-}
-//#endregion
-//#region ../../packages/shared/dist/index.js
-const TERMINAL_MAX_UPLOAD_BYTES = 50 * 1024 * 1024;
-const TERMINAL_EXECUTABLE_MAX_LENGTH = 4096;
-const TERMINAL_ARGUMENT_MAX_LENGTH = 4096;
-const TERMINAL_CAPTURE_MAX_LINES = 5e3;
-const PROJECT_COLORS = [
-	"rose",
-	"orange",
-	"amber",
-	"emerald",
-	"cyan",
-	"blue",
-	"violet",
-	"pink"
-];
-const browseDirectoryQuerySchema = z.object({
-	input: z.string().trim().min(1).max(4096),
-	hidden: z.enum(["true", "false"]).optional().default("false").transform((value) => value === "true")
-});
-const terminalCaptureQuerySchema = z.object({ lines: z.coerce.number().int().min(1).max(TERMINAL_CAPTURE_MAX_LINES).optional().default(200) });
-const registerProjectSchema = z.object({
-	path: z.string().trim().min(1),
-	name: z.string().trim().min(1).max(120).optional()
-});
-const updateProjectSchema = z.object({ color: z.enum(PROJECT_COLORS).nullable() });
-const terminalNameSchema = z.string().trim().min(1).max(120);
-const terminalArgvSchema = z.array(z.string()).min(1).max(128);
-const terminalPresetArgumentSchema = z.string().max(TERMINAL_ARGUMENT_MAX_LENGTH);
-const terminalPresetFields = {
-	name: terminalNameSchema,
-	executable: z.string().min(1).max(TERMINAL_EXECUTABLE_MAX_LENGTH).refine((value) => value.trim().length > 0, { message: "Executable cannot be blank" }),
-	args: z.array(terminalPresetArgumentSchema).max(127),
-	closeOnSuccess: z.boolean().default(false)
-};
-const terminalPresetRevisionSchema = z.string().min(1).max(64);
-const initialTerminalSchema = z.object({
-	name: terminalNameSchema,
-	argv: terminalArgvSchema.optional(),
-	returnToShell: z.boolean().optional(),
-	initialSize: terminalSizeSchema.optional()
-});
-const createWorktreeSchema = z.object({
-	name: z.string().trim().min(1).max(120),
-	base: z.enum(["default", "current"]).default("default"),
-	sourceWorktreeId: z.string().min(1).optional(),
-	initialTerminal: initialTerminalSchema.optional()
-}).superRefine((value, context) => {
-	if (value.base === "current" && !value.sourceWorktreeId) context.addIssue({
-		code: "custom",
-		path: ["sourceWorktreeId"],
-		message: "A source worktree is required when starting from current"
-	});
-});
-const createTerminalSchema = z.object({
-	name: terminalNameSchema,
-	argv: terminalArgvSchema.optional(),
-	returnToShell: z.boolean().optional(),
-	closeOnSuccess: z.boolean().optional(),
-	initialSize: terminalSizeSchema.optional()
-}).refine((value) => !(value.returnToShell && value.closeOnSuccess), { message: "A terminal cannot return to a shell and close on success" });
-const updateTerminalSchema = z.object({ name: terminalNameSchema });
-const createTerminalPresetSchema = z.object(terminalPresetFields);
-const updateTerminalPresetSchema = z.object({
-	...terminalPresetFields,
-	closeOnSuccess: z.boolean().optional(),
-	expectedUpdatedAt: terminalPresetRevisionSchema
-});
-const deleteTerminalPresetSchema = z.object({ expectedUpdatedAt: terminalPresetRevisionSchema });
-const removeWorktreeSchema = z.object({
-	confirmationToken: z.string().length(64),
-	confirmDestructive: z.boolean()
-});
-const spawnSchema = z.object({
-	project: z.string().min(1),
-	worktreeName: z.string().trim().min(1).max(120),
-	name: terminalNameSchema,
-	argv: terminalArgvSchema.optional(),
-	base: z.enum(["default", "current"]).default("default"),
-	sourceWorktreeId: z.string().min(1).optional()
-}).superRefine((value, context) => {
-	if (value.base === "current" && !value.sourceWorktreeId) context.addIssue({
-		code: "custom",
-		path: ["sourceWorktreeId"],
-		message: "A source worktree is required when starting from current"
-	});
-});
-//#endregion
-export { terminalLegacyTakeControlSchema as A, TERMINAL_OUTPUT_STALL_TIMEOUT_MS as C, terminalBellAcknowledgementSchema as D, parseTerminalRuntimeMetadata as E, terminalResizeSchema as M, terminalSizeSchema as N, terminalBinarySchema as O, terminalTakeControlSchema as P, TERMINAL_OUTPUT_LOW_WATERMARK as S, parseTerminalProgress as T, SOCKET_IO_PATH as _, createTerminalSchema as a, TERMINAL_MAX_INPUT_BYTES as b, registerProjectSchema as c, terminalCaptureQuerySchema as d, updateProjectSchema as f, parseProductEvent as g, parseEventsSnapshot as h, createTerminalPresetSchema as i, terminalOutputAckSchema as j, terminalInputSchema as k, removeWorktreeSchema as l, updateTerminalSchema as m, TERMINAL_MAX_UPLOAD_BYTES as n, createWorktreeSchema as o, updateTerminalPresetSchema as p, browseDirectoryQuerySchema as r, deleteTerminalPresetSchema as s, TERMINAL_CAPTURE_MAX_LINES as t, spawnSchema as u, TERMINAL_CONTROLLER_GRACE_MS as v, parseTerminalAuth as w, TERMINAL_OUTPUT_HIGH_WATERMARK as x, TERMINAL_MAX_CLIENT_MESSAGE_BYTES as y };