@xfey/tutti 0.1.10 → 0.1.12

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

@@ -1,17 +1,19 @@
 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";
 import { createRuntimeEndpointProbe } from "./host-runtime-endpoint.js";
 import { getHostLogFilePath, getMachineRuntimeEndpointPath, getProjectLocalStoreRoot, readMachineProjectBinding, readMachineRuntimeEndpoint, } from "./machine-local.js";
 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) {
@@ -32,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);
@@ -42,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({
@@ -84,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),
@@ -123,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),
@@ -212,7 +235,7 @@ export async function runPsManageCommand(options = {}) {
                     message = `Invite refreshed for ${project.display_name}.`;
                 }
                 catch (error) {
-                    message = error instanceof Error ? error.message : "Invite refresh failed.";
+                    message = formatCliErrorReason(error);
                     detail = undefined;
                 }
                 render();
@@ -232,7 +255,7 @@ export async function runPsManageCommand(options = {}) {
                     detail = undefined;
                 }
                 catch (error) {
-                    message = error instanceof Error ? error.message : "Stop failed.";
+                    message = formatCliErrorReason(error);
                     detail = undefined;
                 }
                 render();
@@ -248,30 +271,53 @@ 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.";
     }
-    await requestHostLocalShutdown({ endpoint });
+    try {
+        await requestHostLocalShutdown({ endpoint });
+    }
+    catch (error) {
+        throw new LaunchError("existing_server_unhealthy", `Could not stop the host: ${formatCliErrorReason(error)}`, "Run `tutti ps` to inspect the runtime state, or stop the host process manually.");
+    }
     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 Error("Tutti host is not running for this project.");
+        throw new LaunchError("host_not_running", "Tutti host is not running for this project.", "Run `tutti launch` first, then retry `tutti invite`.");
+    }
+    let status;
+    try {
+        status = await rotateHostLocalInvite({ endpoint });
+    }
+    catch (error) {
+        throw new LaunchError("existing_server_unhealthy", `Could not refresh the invite: ${formatCliErrorReason(error)}`, "Run `tutti launch` to restart or reconnect the host, then retry `tutti invite`.");
     }
-    const status = await rotateHostLocalInvite({ endpoint });
     const joinUrl = status.relay?.join_url;
     if (joinUrl === undefined) {
-        throw new Error("Relay did not return a visible join URL.");
+        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}`,
@@ -284,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)}.`;
@@ -302,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.10",
+  "version": "0.1.12",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",