@todesktop/shared 7.192.0 → 7.194.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @todesktop/shared
 
+## 7.194.0
+
+### Minor Changes
+
+- dc5fe40: Add build introspection feature for interactive shell access to
+  in-progress builds
+  - `todesktop build --introspect` enables introspection on all platforms during
+    build creation
+  - New `todesktop introspect [buildId]` command for connecting to running
+    builds with interactive shell access
+  - Agent Introspection Service (AIS) runs on build agents, providing secure
+    WebSocket terminal access via Cloudflare Quick Tunnels
+  - Firebase function `startIntrospectionSession` handles authentication and
+    session management
+  - Builds with introspection sessions cannot be released (security safeguard)
+  - Session limits: 30 min inactivity timeout, 60 min absolute TTL, single
+    concurrent session per platform
+
 ## 7.191.1
 
 ### Patch Changes

package/lib/cjs/index.d.ts

@@ -3,6 +3,8 @@ export * from './desktopify';
 export * from './desktopify2';
 export * from './getSiteInfo';
 export * from './hsm';
+export * from './introspection/breakpoints';
+export * from './introspection/status';
 export * from './invitePermissionLabels';
 export * from './personalAccessTokens';
 export * from './plans';

package/lib/cjs/index.js

@@ -24,6 +24,8 @@ __exportStar(require("./desktopify"), exports);
 __exportStar(require("./desktopify2"), exports);
 __exportStar(require("./getSiteInfo"), exports);
 __exportStar(require("./hsm"), exports);
+__exportStar(require("./introspection/breakpoints"), exports);
+__exportStar(require("./introspection/status"), exports);
 __exportStar(require("./invitePermissionLabels"), exports);
 __exportStar(require("./personalAccessTokens"), exports);
 __exportStar(require("./plans"), exports);

package/lib/cjs/introspection/status.d.ts

@@ -0,0 +1,17 @@
+import type { Build, IntrospectBreakpointStatus, IntrospectShellStatus } from '../desktopify';
+export type IntrospectPlatformName = 'linux' | 'mac' | 'windows';
+/**
+ * Check if a build was introspected (has connectedAt or disconnectedAt on any platform).
+ * Builds that were introspected cannot be released.
+ */
+export declare function wasIntrospected(build: Build): boolean;
+/**
+ * Get list of platform names that were introspected (have connectedAt or disconnectedAt).
+ * Returns capitalized platform names (e.g., ['Mac', 'Windows']).
+ */
+export declare function getIntrospectedPlatformNames(build: Build): string[];
+/**
+ * Format introspection status as a human-readable string.
+ * Combines breakpoint status and shell status into a single label.
+ */
+export declare function formatIntrospectionStatus(breakpointStatus?: IntrospectBreakpointStatus, shellStatus?: IntrospectShellStatus): string;

package/lib/cjs/introspection/status.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wasIntrospected = wasIntrospected;
+exports.getIntrospectedPlatformNames = getIntrospectedPlatformNames;
+exports.formatIntrospectionStatus = formatIntrospectionStatus;
+const PLATFORM_LABELS = {
+    linux: 'Linux',
+    mac: 'Mac',
+    windows: 'Windows',
+};
+/**
+ * Check if a build was introspected (has connectedAt or disconnectedAt on any platform).
+ * Builds that were introspected cannot be released.
+ */
+function wasIntrospected(build) {
+    const { introspect } = build;
+    if (!introspect)
+        return false;
+    const platforms = ['mac', 'windows', 'linux'];
+    for (const platform of platforms) {
+        const data = introspect[platform];
+        if ((data === null || data === void 0 ? void 0 : data.connectedAt) || (data === null || data === void 0 ? void 0 : data.disconnectedAt)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Get list of platform names that were introspected (have connectedAt or disconnectedAt).
+ * Returns capitalized platform names (e.g., ['Mac', 'Windows']).
+ */
+function getIntrospectedPlatformNames(build) {
+    const { introspect } = build;
+    if (!introspect)
+        return [];
+    const platforms = ['mac', 'windows', 'linux'];
+    const result = [];
+    for (const platform of platforms) {
+        const data = introspect[platform];
+        if ((data === null || data === void 0 ? void 0 : data.connectedAt) || (data === null || data === void 0 ? void 0 : data.disconnectedAt)) {
+            result.push(PLATFORM_LABELS[platform]);
+        }
+    }
+    return result;
+}
+/**
+ * Format introspection status as a human-readable string.
+ * Combines breakpoint status and shell status into a single label.
+ */
+function formatIntrospectionStatus(breakpointStatus, shellStatus) {
+    if (breakpointStatus === 'paused') {
+        if (shellStatus === 'connected') {
+            return 'paused (shell connected)';
+        }
+        if (shellStatus === 'disconnected') {
+            return 'paused (shell disconnected)';
+        }
+        return 'paused';
+    }
+    if (breakpointStatus === 'ready') {
+        if (shellStatus === 'connected') {
+            return 'ready (shell connected)';
+        }
+        if (shellStatus === 'disconnected') {
+            return 'ready (shell disconnected)';
+        }
+        return 'ready';
+    }
+    if (breakpointStatus === 'resuming') {
+        return 'resuming';
+    }
+    if (breakpointStatus === 'initializing') {
+        return 'initializing';
+    }
+    if (breakpointStatus === 'finished') {
+        return 'finished';
+    }
+    if (breakpointStatus === 'error' || shellStatus === 'error') {
+        return 'error';
+    }
+    return 'status unknown';
+}

package/lib/esm/index.d.ts

@@ -4,6 +4,7 @@ export * from './desktopify2.js';
 export * from './getSiteInfo.js';
 export * from './hsm.js';
 export * from './introspection/breakpoints.js';
+export * from './introspection/status.js';
 export * from './invitePermissionLabels.js';
 export * from './personalAccessTokens.js';
 export * from './plans.js';

package/lib/esm/index.js

@@ -6,6 +6,7 @@ export * from './desktopify2.js';
 export * from './getSiteInfo.js';
 export * from './hsm.js';
 export * from './introspection/breakpoints.js';
+export * from './introspection/status.js';
 export * from './invitePermissionLabels.js';
 export * from './personalAccessTokens.js';
 export * from './plans.js';

package/lib/esm/introspection/status.d.ts

@@ -0,0 +1,17 @@
+import type { Build, IntrospectBreakpointStatus, IntrospectShellStatus } from '../desktopify';
+export type IntrospectPlatformName = 'linux' | 'mac' | 'windows';
+/**
+ * Check if a build was introspected (has connectedAt or disconnectedAt on any platform).
+ * Builds that were introspected cannot be released.
+ */
+export declare function wasIntrospected(build: Build): boolean;
+/**
+ * Get list of platform names that were introspected (have connectedAt or disconnectedAt).
+ * Returns capitalized platform names (e.g., ['Mac', 'Windows']).
+ */
+export declare function getIntrospectedPlatformNames(build: Build): string[];
+/**
+ * Format introspection status as a human-readable string.
+ * Combines breakpoint status and shell status into a single label.
+ */
+export declare function formatIntrospectionStatus(breakpointStatus?: IntrospectBreakpointStatus, shellStatus?: IntrospectShellStatus): string;

package/lib/esm/introspection/status.js

@@ -0,0 +1,77 @@
+const PLATFORM_LABELS = {
+    linux: 'Linux',
+    mac: 'Mac',
+    windows: 'Windows',
+};
+/**
+ * Check if a build was introspected (has connectedAt or disconnectedAt on any platform).
+ * Builds that were introspected cannot be released.
+ */
+export function wasIntrospected(build) {
+    const { introspect } = build;
+    if (!introspect)
+        return false;
+    const platforms = ['mac', 'windows', 'linux'];
+    for (const platform of platforms) {
+        const data = introspect[platform];
+        if ((data === null || data === void 0 ? void 0 : data.connectedAt) || (data === null || data === void 0 ? void 0 : data.disconnectedAt)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Get list of platform names that were introspected (have connectedAt or disconnectedAt).
+ * Returns capitalized platform names (e.g., ['Mac', 'Windows']).
+ */
+export function getIntrospectedPlatformNames(build) {
+    const { introspect } = build;
+    if (!introspect)
+        return [];
+    const platforms = ['mac', 'windows', 'linux'];
+    const result = [];
+    for (const platform of platforms) {
+        const data = introspect[platform];
+        if ((data === null || data === void 0 ? void 0 : data.connectedAt) || (data === null || data === void 0 ? void 0 : data.disconnectedAt)) {
+            result.push(PLATFORM_LABELS[platform]);
+        }
+    }
+    return result;
+}
+/**
+ * Format introspection status as a human-readable string.
+ * Combines breakpoint status and shell status into a single label.
+ */
+export function formatIntrospectionStatus(breakpointStatus, shellStatus) {
+    if (breakpointStatus === 'paused') {
+        if (shellStatus === 'connected') {
+            return 'paused (shell connected)';
+        }
+        if (shellStatus === 'disconnected') {
+            return 'paused (shell disconnected)';
+        }
+        return 'paused';
+    }
+    if (breakpointStatus === 'ready') {
+        if (shellStatus === 'connected') {
+            return 'ready (shell connected)';
+        }
+        if (shellStatus === 'disconnected') {
+            return 'ready (shell disconnected)';
+        }
+        return 'ready';
+    }
+    if (breakpointStatus === 'resuming') {
+        return 'resuming';
+    }
+    if (breakpointStatus === 'initializing') {
+        return 'initializing';
+    }
+    if (breakpointStatus === 'finished') {
+        return 'finished';
+    }
+    if (breakpointStatus === 'error' || shellStatus === 'error') {
+        return 'error';
+    }
+    return 'status unknown';
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@todesktop/shared",
-  "version": "7.192.0",
+  "version": "7.194.0",
   "description": "",
   "main": "./lib/cjs/index.js",
   "module": "./lib/esm/index.js",

package/src/index.cjs.ts

@@ -8,6 +8,8 @@ export * from './desktopify';
 export * from './desktopify2';
 export * from './getSiteInfo';
 export * from './hsm';
+export * from './introspection/breakpoints';
+export * from './introspection/status';
 export * from './invitePermissionLabels';
 export * from './personalAccessTokens';
 export * from './plans';

package/src/index.ts

@@ -7,6 +7,7 @@ export * from './desktopify2.js';
 export * from './getSiteInfo.js';
 export * from './hsm.js';
 export * from './introspection/breakpoints.js';
+export * from './introspection/status.js';
 export * from './invitePermissionLabels.js';
 export * from './personalAccessTokens.js';
 export * from './plans.js';

package/src/introspection/status.ts

@@ -0,0 +1,101 @@
+import type {
+  Build,
+  IntrospectBreakpointStatus,
+  IntrospectShellStatus,
+} from '../desktopify';
+
+export type IntrospectPlatformName = 'linux' | 'mac' | 'windows';
+
+const PLATFORM_LABELS: Record<IntrospectPlatformName, string> = {
+  linux: 'Linux',
+  mac: 'Mac',
+  windows: 'Windows',
+};
+
+/**
+ * Check if a build was introspected (has connectedAt or disconnectedAt on any platform).
+ * Builds that were introspected cannot be released.
+ */
+export function wasIntrospected(build: Build): boolean {
+  const { introspect } = build;
+  if (!introspect) return false;
+
+  const platforms: IntrospectPlatformName[] = ['mac', 'windows', 'linux'];
+
+  for (const platform of platforms) {
+    const data = introspect[platform];
+    if (data?.connectedAt || data?.disconnectedAt) {
+      return true;
+    }
+  }
+
+  return false;
+}
+
+/**
+ * Get list of platform names that were introspected (have connectedAt or disconnectedAt).
+ * Returns capitalized platform names (e.g., ['Mac', 'Windows']).
+ */
+export function getIntrospectedPlatformNames(build: Build): string[] {
+  const { introspect } = build;
+  if (!introspect) return [];
+
+  const platforms: IntrospectPlatformName[] = ['mac', 'windows', 'linux'];
+  const result: string[] = [];
+
+  for (const platform of platforms) {
+    const data = introspect[platform];
+    if (data?.connectedAt || data?.disconnectedAt) {
+      result.push(PLATFORM_LABELS[platform]);
+    }
+  }
+
+  return result;
+}
+
+/**
+ * Format introspection status as a human-readable string.
+ * Combines breakpoint status and shell status into a single label.
+ */
+export function formatIntrospectionStatus(
+  breakpointStatus?: IntrospectBreakpointStatus,
+  shellStatus?: IntrospectShellStatus,
+): string {
+  if (breakpointStatus === 'paused') {
+    if (shellStatus === 'connected') {
+      return 'paused (shell connected)';
+    }
+    if (shellStatus === 'disconnected') {
+      return 'paused (shell disconnected)';
+    }
+    return 'paused';
+  }
+
+  if (breakpointStatus === 'ready') {
+    if (shellStatus === 'connected') {
+      return 'ready (shell connected)';
+    }
+    if (shellStatus === 'disconnected') {
+      return 'ready (shell disconnected)';
+    }
+    return 'ready';
+  }
+
+  if (breakpointStatus === 'resuming') {
+    return 'resuming';
+  }
+
+  if (breakpointStatus === 'initializing') {
+    return 'initializing';
+  }
+
+  if (breakpointStatus === 'finished') {
+    return 'finished';
+  }
+
+  if (breakpointStatus === 'error' || shellStatus === 'error') {
+    return 'error';
+  }
+
+  return 'status unknown';
+}