@xfey/tutti 0.1.11 → 0.1.13

package/dist/server-shell/cli/project-resolver.js

@@ -1,19 +1,141 @@
-import { resolve } from "node:path";
+import { existsSync, readdirSync } from "node:fs";
+import { basename, join, resolve } from "node:path";
+import { ID_PREFIXES, isPrefixedId } from "@tutti/shared/ids";
 import { readOpenAiProviderConfigProjection, readProjectOpenAiProviderConfig, resolveTuttiHome, } from "../../providers/openai/index.js";
 import { LaunchError } from "./errors.js";
 import { assertSafeProjectRoot } from "./git-bootstrap.js";
 import { readMachineProjectBinding, readMachineRuntimeEndpoint, } from "./machine-local.js";
 import { readProjectDisplayName, readProjectIdentity } from "./project-identity.js";
+function projectIdsFromTuttiHome(tuttiHome) {
+    const projectsRoot = join(tuttiHome, "projects");
+    if (!existsSync(projectsRoot)) {
+        return [];
+    }
+    return readdirSync(projectsRoot, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory() && isPrefixedId(entry.name, ID_PREFIXES.project))
+        .map((entry) => entry.name)
+        .sort();
+}
+function readRuntimeEndpoint(tuttiHome, projectId) {
+    try {
+        return readMachineRuntimeEndpoint(tuttiHome, projectId);
+    }
+    catch {
+        return null;
+    }
+}
+function readBinding(tuttiHome, projectId) {
+    try {
+        return readMachineProjectBinding(tuttiHome, projectId);
+    }
+    catch {
+        return null;
+    }
+}
+function readProjectTargetEntry(tuttiHome, projectId) {
+    const binding = readBinding(tuttiHome, projectId);
+    const endpoint = readRuntimeEndpoint(tuttiHome, projectId);
+    const workspaceRoot = binding?.workspace_root ?? endpoint?.workspace_root;
+    if (workspaceRoot === undefined) {
+        return null;
+    }
+    const workspaceName = basename(workspaceRoot) || projectId;
+    const displayName = readProjectDisplayName(workspaceRoot) ?? workspaceName;
+    const aliases = Array.from(new Set([displayName, workspaceName].filter((alias) => alias.trim() !== "")));
+    return {
+        project_id: projectId,
+        workspace_root: workspaceRoot,
+        display_name: displayName,
+        aliases,
+    };
+}
+function listProjectTargetEntries(tuttiHome) {
+    return projectIdsFromTuttiHome(tuttiHome)
+        .map((projectId) => readProjectTargetEntry(tuttiHome, projectId))
+        .filter((entry) => entry !== null);
+}
+function normalizeTargetName(value) {
+    return value.trim().toLowerCase();
+}
+function formatTargetMatch(entry) {
+    return `${entry.project_id}  ${entry.display_name}  ${entry.workspace_root}`;
+}
+function resolveSingleTargetMatch(target, matches) {
+    if (matches.length === 1) {
+        return matches[0];
+    }
+    if (matches.length > 1) {
+        throw new LaunchError("project_target_ambiguous", `Project target is ambiguous: ${target}`, "Use the unique project ID prefix shown by `tutti ps`, or the full project ID from this error.", { matches: matches.map(formatTargetMatch) });
+    }
+    throw new LaunchError("project_target_not_found", `Project target was not found: ${target}`, "Run `tutti ps` to list known projects, or pass a project workspace path.");
+}
+function resolveProjectTargetWorkspaceRoot(options) {
+    const target = options.target.trim();
+    if (target === "") {
+        return resolve(options.cwd, ".");
+    }
+    const pathCandidate = resolve(options.cwd, target);
+    if (existsSync(pathCandidate)) {
+        return pathCandidate;
+    }
+    const entries = listProjectTargetEntries(options.tuttiHome);
+    const exactId = entries.filter((entry) => entry.project_id === target);
+    if (exactId.length > 0) {
+        return resolveSingleTargetMatch(target, exactId).workspace_root;
+    }
+    if (target.startsWith(ID_PREFIXES.project)) {
+        const idPrefix = entries.filter((entry) => entry.project_id.startsWith(target));
+        if (idPrefix.length > 0) {
+            return resolveSingleTargetMatch(target, idPrefix).workspace_root;
+        }
+    }
+    const normalizedTarget = normalizeTargetName(target);
+    const nameMatches = entries.filter((entry) => entry.aliases.some((alias) => normalizeTargetName(alias) === normalizedTarget));
+    return resolveSingleTargetMatch(target, nameMatches).workspace_root;
+}
+export function resolveLaunchWorkspacePath(options) {
+    const cwd = options.cwd ?? process.cwd();
+    const env = options.env ?? process.env;
+    const target = options.target;
+    if (target === undefined) {
+        return resolve(cwd, ".");
+    }
+    const pathCandidate = resolve(cwd, target);
+    if (existsSync(pathCandidate)) {
+        return pathCandidate;
+    }
+    try {
+        return resolveProjectTargetWorkspaceRoot({
+            target,
+            cwd,
+            tuttiHome: resolveTuttiHome(env.TUTTI_HOME, cwd),
+        });
+    }
+    catch (error) {
+        if (error instanceof LaunchError &&
+            error.code === "project_target_not_found" &&
+            !target.startsWith(ID_PREFIXES.project)) {
+            return pathCandidate;
+        }
+        throw error;
+    }
+}
 export function resolveExistingProjectContext(options) {
     const cwd = options.cwd ?? process.cwd();
     const env = options.env ?? process.env;
-    const workspaceRoot = resolve(cwd, options.workspacePath ?? ".");
+    const tuttiHome = resolveTuttiHome(env.TUTTI_HOME, cwd);
+    const workspaceRoot = options.workspacePath === undefined
+        ? resolveProjectTargetWorkspaceRoot({
+            target: options.target ?? ".",
+            cwd,
+            tuttiHome,
+        })
+        : resolve(cwd, options.workspacePath);
     assertSafeProjectRoot(workspaceRoot);
     const identity = readProjectIdentity(workspaceRoot);
     if (identity.kind !== "present") {
         throw new LaunchError("project_identity_conflict", "Current directory is not a Tutti project", "Run `tutti launch` from a project root first.");
     }
-    const tuttiHome = resolveTuttiHome(env.TUTTI_HOME, cwd);
     const binding = readMachineProjectBinding(tuttiHome, identity.project_id);
     const projectConfig = readProjectOpenAiProviderConfig(tuttiHome, identity.project_id);
     return {

package/dist/server-shell/cli/runtime-commands.d.ts

@@ -11,6 +11,7 @@ export type RuntimeProjectRow = {
     relay_project_ref?: string;
     join_url?: string;
 };
+export declare function formatProjectIdForDisplay(projectId: ProjectId, projectIds: readonly ProjectId[]): string;
 export declare function listRuntimeProjects(options?: {
     env?: NodeJS.ProcessEnv;
     cwd?: string;
@@ -21,12 +22,11 @@ export declare function runPsManageCommand(options?: {
     stdin?: NodeJS.ReadStream;
     stdout?: NodeJS.WriteStream;
 }): Promise<void>;
-export declare function runStopCommand(workspacePath?: string): Promise<string>;
-export declare function runInviteCommand(workspacePath?: string): Promise<string>;
-export declare function runProviderStatusCommand(workspacePath?: string): string;
-export declare function runLogsCommand(workspacePath?: string, tailLines?: number): string;
+export declare function runStopCommand(target?: string): Promise<string>;
+export declare function runInviteCommand(target?: string): Promise<string>;
+export declare function runProviderStatusCommand(target?: string): string;
+export declare function runLogsCommand(target?: string, tailLines?: number): string;
 export declare function readRuntimeEndpointForProject(tuttiHome: string, projectId: ProjectId): MachineRuntimeEndpointRecord | null;
 export declare function runtimeEndpointPathForProject(tuttiHome: string, projectId: ProjectId): string;
 export declare function projectLocalStoreRoot(tuttiHome: string, projectId: ProjectId): string;
-export declare function resolveWorkspacePath(value: string | undefined): string;
 //# sourceMappingURL=runtime-commands.d.ts.map

package/dist/server-shell/cli/runtime-commands.js

@@ -1,5 +1,5 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
-import { join, resolve } from "node:path";
+import { join } from "node:path";
 import { emitKeypressEvents } from "node:readline";
 import { ID_PREFIXES, isPrefixedId } from "@tutti/shared/ids";
 import { redactText } from "@tutti/shared/utils";
@@ -8,11 +8,12 @@ import { getHostLogFilePath, getMachineRuntimeEndpointPath, getProjectLocalStore
 import { readHostLocalLaunchStatus, readHostLocalProject, readHostLocalProviderConfig, requestHostLocalShutdown, rotateHostLocalInvite, } from "./local-control-client.js";
 import { formatCliErrorReason, LaunchError } from "./errors.js";
 import { resolveExistingProjectContext } from "./project-resolver.js";
-import { renderTerminalQr } from "./terminal-qr.js";
+import { formatJoinLinkValidity, renderTerminalQr } from "./terminal-qr.js";
 import { resolveTuttiHome } from "../../providers/openai/index.js";
-function resolveProject(workspacePath) {
+const PROJECT_ID_DISPLAY_MIN_LENGTH = 12;
+function resolveProject(target) {
     return resolveExistingProjectContext({
-        ...(workspacePath === undefined ? {} : { workspacePath }),
+        ...(target === undefined ? {} : { target }),
     });
 }
 function projectIdsFromTuttiHome(tuttiHome) {
@@ -33,6 +34,23 @@ function readEndpointFile(tuttiHome, projectId) {
         return null;
     }
 }
+function readBindingFile(tuttiHome, projectId) {
+    try {
+        return readMachineProjectBinding(tuttiHome, projectId);
+    }
+    catch {
+        return null;
+    }
+}
+export function formatProjectIdForDisplay(projectId, projectIds) {
+    for (let length = Math.min(PROJECT_ID_DISPLAY_MIN_LENGTH, projectId.length); length <= projectId.length; length += 1) {
+        const prefix = projectId.slice(0, length);
+        if (projectIds.every((candidate) => candidate === projectId || !candidate.startsWith(prefix))) {
+            return prefix;
+        }
+    }
+    return projectId;
+}
 export async function listRuntimeProjects(options = {}) {
     const cwd = options.cwd ?? process.cwd();
     const tuttiHome = resolveTuttiHome(options.env?.TUTTI_HOME, cwd);
@@ -43,7 +61,7 @@ export async function listRuntimeProjects(options = {}) {
         if (endpoint === null) {
             continue;
         }
-        const binding = readMachineProjectBinding(tuttiHome, projectId);
+        const binding = readBindingFile(tuttiHome, projectId);
         const health = await probe(endpoint);
         if (health.kind === "stale") {
             rows.push({
@@ -85,9 +103,11 @@ function formatTable(rows) {
     if (rows.length === 0) {
         return "No Tutti host processes found.";
     }
-    const header = ["STATUS", "PROJECT", "PROVIDER", "WORKSPACE"];
+    const header = ["STATUS", "ID", "PROJECT", "PROVIDER", "WORKSPACE"];
+    const projectIds = rows.map((row) => row.project_id);
     const data = rows.map((row) => [
         row.status,
+        formatProjectIdForDisplay(row.project_id, projectIds),
         row.display_name,
         row.provider_status ?? "-",
         redactText(row.workspace_root),
@@ -124,10 +144,12 @@ function renderManager(options) {
         "",
     ];
     if (options.rows.length > 0) {
-        const header = ["", "STATUS", "PROJECT", "PROVIDER", "WORKSPACE"];
+        const header = ["", "STATUS", "ID", "PROJECT", "PROVIDER", "WORKSPACE"];
+        const projectIds = options.rows.map((row) => row.project_id);
         const data = options.rows.map((row, index) => [
             index === options.selectedIndex ? ">" : " ",
             row.status,
+            formatProjectIdForDisplay(row.project_id, projectIds),
             row.display_name,
             row.provider_status ?? "-",
             redactText(row.workspace_root),
@@ -249,8 +271,8 @@ export async function runPsManageCommand(options = {}) {
         stdout.write(SHOW_CURSOR);
     }
 }
-export async function runStopCommand(workspacePath) {
-    const project = resolveProject(workspacePath);
+export async function runStopCommand(target) {
+    const project = resolveProject(target);
     const endpoint = project.runtime_endpoint;
     if (endpoint === null) {
         return "Tutti host is not running for this project.";
@@ -263,8 +285,8 @@ export async function runStopCommand(workspacePath) {
     }
     return `Stopped ${project.display_name}.`;
 }
-export async function runInviteCommand(workspacePath) {
-    const project = resolveProject(workspacePath);
+export async function runInviteCommand(target) {
+    const project = resolveProject(target);
     const endpoint = project.runtime_endpoint;
     if (endpoint === null) {
         throw new LaunchError("host_not_running", "Tutti host is not running for this project.", "Run `tutti launch` first, then retry `tutti invite`.");
@@ -280,10 +302,22 @@ export async function runInviteCommand(workspacePath) {
     if (joinUrl === undefined) {
         throw new LaunchError("relay_registration_failed", "Relay did not return a visible join URL.", "Retry `tutti invite`; if it keeps failing, run `tutti launch` to reconnect the host.");
     }
-    return [`Join URL: ${joinUrl}`, "", renderTerminalQr(joinUrl)].join("\n");
+    return [
+        `Join URL: ${joinUrl}`,
+        formatJoinLinkValidity({
+            ...(status.relay?.join_token_expires_at === undefined
+                ? {}
+                : { expiresAt: status.relay.join_token_expires_at }),
+            ...(status.relay?.join_token_reusable === undefined
+                ? {}
+                : { reusable: status.relay.join_token_reusable }),
+        }),
+        "",
+        renderTerminalQr(joinUrl),
+    ].join("\n");
 }
-export function runProviderStatusCommand(workspacePath) {
-    const project = resolveProject(workspacePath);
+export function runProviderStatusCommand(target) {
+    const project = resolveProject(target);
     return [
         `Project: ${project.display_name}`,
         `Provider: ${project.provider_config.status}`,
@@ -296,8 +330,8 @@ export function runProviderStatusCommand(workspacePath) {
             : []),
     ].join("\n");
 }
-export function runLogsCommand(workspacePath, tailLines = 120) {
-    const project = resolveProject(workspacePath);
+export function runLogsCommand(target, tailLines = 120) {
+    const project = resolveProject(target);
     const logPath = getHostLogFilePath(project.tutti_home);
     if (!existsSync(logPath)) {
         return `No host log exists yet at ${redactText(logPath)}.`;
@@ -314,7 +348,4 @@ export function runtimeEndpointPathForProject(tuttiHome, projectId) {
 export function projectLocalStoreRoot(tuttiHome, projectId) {
     return getProjectLocalStoreRoot(tuttiHome, projectId);
 }
-export function resolveWorkspacePath(value) {
-    return resolve(process.cwd(), value ?? ".");
-}
 //# sourceMappingURL=runtime-commands.js.map

package/dist/server-shell/cli/terminal-qr.d.ts

@@ -1,2 +1,7 @@
 export declare function renderTerminalQr(input: string): string;
+export declare function formatJoinLinkValidity(options: {
+    expiresAt?: string;
+    reusable?: boolean;
+    now?: Date;
+}): string;
 //# sourceMappingURL=terminal-qr.d.ts.map

package/dist/server-shell/cli/terminal-qr.js

@@ -8,4 +8,21 @@ export function renderTerminalQr(input) {
     });
     return output.trimEnd();
 }
+export function formatJoinLinkValidity(options) {
+    if (options.expiresAt !== undefined) {
+        const expiresAt = new Date(options.expiresAt);
+        if (!Number.isNaN(expiresAt.getTime())) {
+            const now = options.now ?? new Date();
+            const remainingMs = expiresAt.getTime() - now.getTime();
+            const suffix = remainingMs <= 0
+                ? "expired"
+                : `about ${Math.ceil(remainingMs / 60_000).toString()} min`;
+            return `Join link valid until: ${options.expiresAt} (${suffix})`;
+        }
+    }
+    if (options.reusable === true) {
+        return "Join link validity: reusable; expiration was not reported.";
+    }
+    return "Join link validity: expiration was not reported.";
+}
 //# sourceMappingURL=terminal-qr.js.map

package/dist/server-shell/http/routes/project-api/openapi-execution-routes.d.ts

@@ -189,6 +189,20 @@ export declare const HOST_PROJECT_EXECUTION_OPENAPI_ROUTES: ({
                     lane: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"foreground">, import("@sinclair/typebox").TLiteral<"scratchpad_background">]>>;
                     started_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                 }>>>;
+                runtime: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                    activity_ref: import("@sinclair/typebox").TString;
+                    stage_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    started_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    updated_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    token_usage: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                        input_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                        cached_input_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                        output_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                        reasoning_output_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                        total_tokens: import("@sinclair/typebox").TInteger;
+                    }>>;
+                    current_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"reading_context">, import("@sinclair/typebox").TLiteral<"planning">, import("@sinclair/typebox").TLiteral<"editing_files">, import("@sinclair/typebox").TLiteral<"running_command">, import("@sinclair/typebox").TLiteral<"using_tool">, import("@sinclair/typebox").TLiteral<"waiting_for_approval">, import("@sinclair/typebox").TLiteral<"finalizing">]>>;
+                }>>;
                 blocked_by: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
                     kind: import("@sinclair/typebox").TLiteral<"clarification">;
                     thread_id: import("@sinclair/typebox").TString;

package/dist/server-shell/http/routes/project-api/openapi-workspace-routes.d.ts

@@ -1211,6 +1211,20 @@ export declare const HOST_PROJECT_WORKSPACE_OPENAPI_ROUTES: ({
                                     lane: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"foreground">, import("@sinclair/typebox").TLiteral<"scratchpad_background">]>>;
                                     started_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                                 }>>>;
+                                runtime: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                                    activity_ref: import("@sinclair/typebox").TString;
+                                    stage_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                                    started_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                                    updated_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                                    token_usage: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                                        input_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                                        cached_input_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                                        output_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                                        reasoning_output_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                                        total_tokens: import("@sinclair/typebox").TInteger;
+                                    }>>;
+                                    current_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"reading_context">, import("@sinclair/typebox").TLiteral<"planning">, import("@sinclair/typebox").TLiteral<"editing_files">, import("@sinclair/typebox").TLiteral<"running_command">, import("@sinclair/typebox").TLiteral<"using_tool">, import("@sinclair/typebox").TLiteral<"waiting_for_approval">, import("@sinclair/typebox").TLiteral<"finalizing">]>>;
+                                }>>;
                                 blocked_by: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
                                     kind: import("@sinclair/typebox").TLiteral<"clarification">;
                                     thread_id: import("@sinclair/typebox").TString;

package/dist/server-shell/http/routes/project-api/openapi.d.ts

@@ -799,6 +799,20 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                     lane: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"foreground">, import("@sinclair/typebox").TLiteral<"scratchpad_background">]>>;
                     started_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                 }>>>;
+                runtime: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                    activity_ref: import("@sinclair/typebox").TString;
+                    stage_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    started_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    updated_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                    token_usage: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                        input_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                        cached_input_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                        output_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                        reasoning_output_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                        total_tokens: import("@sinclair/typebox").TInteger;
+                    }>>;
+                    current_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"reading_context">, import("@sinclair/typebox").TLiteral<"planning">, import("@sinclair/typebox").TLiteral<"editing_files">, import("@sinclair/typebox").TLiteral<"running_command">, import("@sinclair/typebox").TLiteral<"using_tool">, import("@sinclair/typebox").TLiteral<"waiting_for_approval">, import("@sinclair/typebox").TLiteral<"finalizing">]>>;
+                }>>;
                 blocked_by: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
                     kind: import("@sinclair/typebox").TLiteral<"clarification">;
                     thread_id: import("@sinclair/typebox").TString;
@@ -2350,6 +2364,20 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                                     lane: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"foreground">, import("@sinclair/typebox").TLiteral<"scratchpad_background">]>>;
                                     started_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                                 }>>>;
+                                runtime: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                                    activity_ref: import("@sinclair/typebox").TString;
+                                    stage_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                                    started_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                                    updated_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                                    token_usage: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                                        input_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                                        cached_input_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                                        output_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                                        reasoning_output_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                                        total_tokens: import("@sinclair/typebox").TInteger;
+                                    }>>;
+                                    current_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"reading_context">, import("@sinclair/typebox").TLiteral<"planning">, import("@sinclair/typebox").TLiteral<"editing_files">, import("@sinclair/typebox").TLiteral<"running_command">, import("@sinclair/typebox").TLiteral<"using_tool">, import("@sinclair/typebox").TLiteral<"waiting_for_approval">, import("@sinclair/typebox").TLiteral<"finalizing">]>>;
+                                }>>;
                                 blocked_by: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
                                     kind: import("@sinclair/typebox").TLiteral<"clarification">;
                                     thread_id: import("@sinclair/typebox").TString;

package/dist/server-shell/http/routes/project-api/schemas.d.ts

@@ -1193,6 +1193,20 @@ export declare const BootstrapResponseSchema: {
                         lane: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"foreground">, import("@sinclair/typebox").TLiteral<"scratchpad_background">]>>;
                         started_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                     }>>>;
+                    runtime: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                        activity_ref: import("@sinclair/typebox").TString;
+                        stage_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        started_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        updated_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                        token_usage: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                            input_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                            cached_input_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                            output_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                            reasoning_output_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                            total_tokens: import("@sinclair/typebox").TInteger;
+                        }>>;
+                        current_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"reading_context">, import("@sinclair/typebox").TLiteral<"planning">, import("@sinclair/typebox").TLiteral<"editing_files">, import("@sinclair/typebox").TLiteral<"running_command">, import("@sinclair/typebox").TLiteral<"using_tool">, import("@sinclair/typebox").TLiteral<"waiting_for_approval">, import("@sinclair/typebox").TLiteral<"finalizing">]>>;
+                    }>>;
                     blocked_by: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
                         kind: import("@sinclair/typebox").TLiteral<"clarification">;
                         thread_id: import("@sinclair/typebox").TString;

package/node_modules/@tutti/shared/dist/schemas/api/runtime-events.d.ts

@@ -8,6 +8,28 @@ export declare const ExecutionActivitySummarySchema: import("@sinclair/typebox")
     lane: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"foreground">, import("@sinclair/typebox").TLiteral<"scratchpad_background">]>>;
     started_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
 }>;
+export declare const ExecutionRuntimeActionSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"reading_context">, import("@sinclair/typebox").TLiteral<"planning">, import("@sinclair/typebox").TLiteral<"editing_files">, import("@sinclair/typebox").TLiteral<"running_command">, import("@sinclair/typebox").TLiteral<"using_tool">, import("@sinclair/typebox").TLiteral<"waiting_for_approval">, import("@sinclair/typebox").TLiteral<"finalizing">]>;
+export declare const ExecutionRuntimeTokenUsageSchema: import("@sinclair/typebox").TObject<{
+    input_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    cached_input_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    output_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    reasoning_output_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    total_tokens: import("@sinclair/typebox").TInteger;
+}>;
+export declare const ExecutionRuntimeSnapshotSchema: import("@sinclair/typebox").TObject<{
+    activity_ref: import("@sinclair/typebox").TString;
+    stage_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    started_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    updated_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    token_usage: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        input_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+        cached_input_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+        output_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+        reasoning_output_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+        total_tokens: import("@sinclair/typebox").TInteger;
+    }>>;
+    current_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"reading_context">, import("@sinclair/typebox").TLiteral<"planning">, import("@sinclair/typebox").TLiteral<"editing_files">, import("@sinclair/typebox").TLiteral<"running_command">, import("@sinclair/typebox").TLiteral<"using_tool">, import("@sinclair/typebox").TLiteral<"waiting_for_approval">, import("@sinclair/typebox").TLiteral<"finalizing">]>>;
+}>;
 export declare const ExecutionStatusProjectionSchema: import("@sinclair/typebox").TObject<{
     status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"idle">, import("@sinclair/typebox").TLiteral<"running">, import("@sinclair/typebox").TLiteral<"pending">, import("@sinclair/typebox").TLiteral<"failed">]>;
     summary: import("@sinclair/typebox").TString;
@@ -41,6 +63,20 @@ export declare const ExecutionStatusProjectionSchema: import("@sinclair/typebox"
         lane: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"foreground">, import("@sinclair/typebox").TLiteral<"scratchpad_background">]>>;
         started_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     }>>>;
+    runtime: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        activity_ref: import("@sinclair/typebox").TString;
+        stage_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        started_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        updated_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        token_usage: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+            input_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+            cached_input_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+            output_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+            reasoning_output_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+            total_tokens: import("@sinclair/typebox").TInteger;
+        }>>;
+        current_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"reading_context">, import("@sinclair/typebox").TLiteral<"planning">, import("@sinclair/typebox").TLiteral<"editing_files">, import("@sinclair/typebox").TLiteral<"running_command">, import("@sinclair/typebox").TLiteral<"using_tool">, import("@sinclair/typebox").TLiteral<"waiting_for_approval">, import("@sinclair/typebox").TLiteral<"finalizing">]>>;
+    }>>;
     blocked_by: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
         kind: import("@sinclair/typebox").TLiteral<"clarification">;
         thread_id: import("@sinclair/typebox").TString;
@@ -164,6 +200,20 @@ export declare const ExecutionStatusChangedEventPayloadSchema: import("@sinclair
             lane: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"foreground">, import("@sinclair/typebox").TLiteral<"scratchpad_background">]>>;
             started_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
         }>>>;
+        runtime: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+            activity_ref: import("@sinclair/typebox").TString;
+            stage_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            started_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            updated_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            token_usage: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                input_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                cached_input_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                output_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                reasoning_output_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+                total_tokens: import("@sinclair/typebox").TInteger;
+            }>>;
+            current_action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"reading_context">, import("@sinclair/typebox").TLiteral<"planning">, import("@sinclair/typebox").TLiteral<"editing_files">, import("@sinclair/typebox").TLiteral<"running_command">, import("@sinclair/typebox").TLiteral<"using_tool">, import("@sinclair/typebox").TLiteral<"waiting_for_approval">, import("@sinclair/typebox").TLiteral<"finalizing">]>>;
+        }>>;
         blocked_by: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
             kind: import("@sinclair/typebox").TLiteral<"clarification">;
             thread_id: import("@sinclair/typebox").TString;

package/node_modules/@tutti/shared/dist/schemas/api/runtime-events.js

@@ -22,12 +22,37 @@ export const ExecutionActivitySummarySchema = Type.Object({
     lane: Type.Optional(ProcedureLaneSchema),
     started_at: Type.Optional(IsoDateTimeStringSchema),
 }, { additionalProperties: false });
+export const ExecutionRuntimeActionSchema = Type.Union([
+    Type.Literal("reading_context"),
+    Type.Literal("planning"),
+    Type.Literal("editing_files"),
+    Type.Literal("running_command"),
+    Type.Literal("using_tool"),
+    Type.Literal("waiting_for_approval"),
+    Type.Literal("finalizing"),
+]);
+export const ExecutionRuntimeTokenUsageSchema = Type.Object({
+    input_tokens: Type.Optional(Type.Integer({ minimum: 0 })),
+    cached_input_tokens: Type.Optional(Type.Integer({ minimum: 0 })),
+    output_tokens: Type.Optional(Type.Integer({ minimum: 0 })),
+    reasoning_output_tokens: Type.Optional(Type.Integer({ minimum: 0 })),
+    total_tokens: Type.Integer({ minimum: 0 }),
+}, { additionalProperties: false });
+export const ExecutionRuntimeSnapshotSchema = Type.Object({
+    activity_ref: ActivityRefSchema,
+    stage_id: Type.Optional(Type.String()),
+    started_at: Type.Optional(IsoDateTimeStringSchema),
+    updated_at: Type.Optional(IsoDateTimeStringSchema),
+    token_usage: Type.Optional(ExecutionRuntimeTokenUsageSchema),
+    current_action: Type.Optional(ExecutionRuntimeActionSchema),
+}, { additionalProperties: false });
 export const ExecutionStatusProjectionSchema = Type.Object({
     status: ExecutionStatusKindSchema,
     summary: Type.String(),
     active_task: Type.Optional(TaskProjectionSchema),
     active_activity: Type.Optional(ExecutionActivitySummarySchema),
     active_activities: Type.Optional(Type.Array(ExecutionActivitySummarySchema)),
+    runtime: Type.Optional(ExecutionRuntimeSnapshotSchema),
     blocked_by: Type.Optional(Type.Union([
         Type.Object({
             kind: Type.Literal("clarification"),

package/node_modules/@tutti/shared/dist/schemas/api/types.d.ts

@@ -13,7 +13,7 @@ import type { ActiveClarificationProjectionSchema, ClarificationChangedEventPayl
 import type { GetProjectDocRequestSchema, GetProjectDocResponseSchema, GetProjectDocsResponseSchema, GetReferenceFilesRequestSchema, GetReferenceFilesResponseSchema, GetViewerAssetRequestSchema, GetViewerFileRequestSchema, GetViewerFileResponseSchema, GetViewerTreeRequestSchema, GetViewerTreeResponseSchema, ProjectDocKeySchema, ProjectDocParamsSchema, ProjectDocSummaryProjectionSchema, ReferenceDirectoryProjectionSchema, ReferenceFileProjectionSchema, ReferenceSummaryProjectionSchema, ReferenceTextReadBlockedReasonSchema, RefreshReferenceSummariesDispositionSchema, RefreshReferenceSummariesPayloadSchema, RefreshReferenceSummariesResultSchema, UploadReferenceFileDispositionSchema, UploadReferenceFilePayloadSchema, UploadReferenceFileResultSchema, ViewerAssetVariantSchema, ViewerFileContentProjectionSchema, ViewerFileProjectionSchema, ViewerPathSchema, ViewerRepoSnapshotSchema, ViewerTreeEntryProjectionSchema, ViewerTreeTextReadBlockedReasonSchema, ViewerUnreadableReasonSchema } from "./viewer-reference.js";
 import type { ArtifactKindSchema, ArtifactManifestPathSchema, ArtifactManifestSchema, ArtifactPreviewCommandPayloadSchema, ArtifactPreviewCommandResultSchema, ArtifactPreviewProjectionSchema, ArtifactPreviewStatusSchema, ArtifactProjectionSchema, ArtifactServerManifestSchema, ArtifactStaticManifestSchema, ArtifactSummaryProjectionSchema, GetArtifactsResponseSchema, HeartbeatArtifactPreviewDispositionSchema, StartArtifactPreviewDispositionSchema, StopArtifactPreviewDispositionSchema } from "./artifacts.js";
 import type { DeleteSkillDispositionSchema, DeleteSkillPayloadSchema, GetSkillParamsSchema, GetSkillResponseSchema, GetSkillsResponseSchema, ImportSkillZipDispositionSchema, ImportSkillZipPayloadSchema, ImportSkillZipResultSchema, SkillDetailProjectionSchema, SkillNameSchema, SkillProjectionSchema } from "./skills.js";
-import type { ActivityEventProjectionSchema, ActivityEventSsePayloadSchema, ApprovalChangedEventPayloadSchema, ActivityProjectionSchema, ConnectionReadyEventPayloadSchema, ExecutionActivitySummarySchema, ExecutionStatusChangedEventPayloadSchema, ExecutionStatusKindSchema, ExecutionStatusProjectionSchema, ProcedureLaneSchema, ProviderConfigChangedEventPayloadSchema, QueryInvalidateEventPayloadSchema, ScratchpadUpdatedEventPayloadSchema, TaskDetailUpdatedEventPayloadSchema, TaskUpdatedEventPayloadSchema, WorklistChangedEventPayloadSchema, WorkspaceRecoveredEventPayloadSchema } from "./runtime-events.js";
+import type { ActivityEventProjectionSchema, ActivityEventSsePayloadSchema, ApprovalChangedEventPayloadSchema, ActivityProjectionSchema, ConnectionReadyEventPayloadSchema, ExecutionActivitySummarySchema, ExecutionRuntimeActionSchema, ExecutionRuntimeSnapshotSchema, ExecutionRuntimeTokenUsageSchema, ExecutionStatusChangedEventPayloadSchema, ExecutionStatusKindSchema, ExecutionStatusProjectionSchema, ProcedureLaneSchema, ProviderConfigChangedEventPayloadSchema, QueryInvalidateEventPayloadSchema, ScratchpadUpdatedEventPayloadSchema, TaskDetailUpdatedEventPayloadSchema, TaskUpdatedEventPayloadSchema, WorklistChangedEventPayloadSchema, WorkspaceRecoveredEventPayloadSchema } from "./runtime-events.js";
 import type { ContextSyncDispositionSchema, ContextSyncPayloadSchema, ContextSyncResultSchema, InitializeProjectDocsDispositionSchema, InitializeProjectDocsPayloadSchema, InitializeProjectDocsResultSchema, RefreshScratchpadDispositionSchema, RefreshScratchpadResultSchema, RunSchedulerNowDispositionSchema, RunSchedulerNowPayloadSchema, SubmitWorklistDispositionSchema, SubmitWorklistPayloadSchema, SubmitWorklistResultSchema, UpdateProjectDisplayNameDispositionSchema, UpdateProjectDisplayNamePayloadSchema, UpdateProjectDisplayNameResultSchema } from "./workspace-commands.js";
 export type CursorPageRequest = Static<typeof CursorPageRequestSchema>;
 export type CursorPage<TItem> = {
@@ -128,6 +128,9 @@ export type GetRecoverySummaryResponse = Static<typeof GetRecoverySummaryRespons
 export type ExecutionStatusKind = Static<typeof ExecutionStatusKindSchema>;
 export type ProcedureLane = Static<typeof ProcedureLaneSchema>;
 export type ExecutionActivitySummary = Static<typeof ExecutionActivitySummarySchema>;
+export type ExecutionRuntimeAction = Static<typeof ExecutionRuntimeActionSchema>;
+export type ExecutionRuntimeTokenUsage = Static<typeof ExecutionRuntimeTokenUsageSchema>;
+export type ExecutionRuntimeSnapshot = Static<typeof ExecutionRuntimeSnapshotSchema>;
 export type ExecutionStatusProjection = Static<typeof ExecutionStatusProjectionSchema>;
 export type ActivityProjection = Static<typeof ActivityProjectionSchema>;
 export type ActivityEventProjection = Static<typeof ActivityEventProjectionSchema>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xfey/tutti",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -35,6 +35,7 @@
     "better-sqlite3": "^12.9.0",
     "fastify": "^5.8.5",
     "openai": "^6.34.0",
+    "prebuild-install": "npm:@scrypted/prebuild-install@7.1.10",
     "qrcode-terminal": "^0.12.0",
     "sharp": "^0.35.3",
     "ulid": "^3.0.2",