happy-coder 0.9.0 → 0.10.0-0

package/dist/lib.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var types = require('./types-CyOnnZ8M.cjs');
+var types = require('./types-fU2E-jQl.cjs');
 require('axios');
 require('chalk');
 require('fs');

package/dist/lib.d.cts

@@ -1,6 +1,5 @@
 import { z } from 'zod';
 import { EventEmitter } from 'node:events';
-import { ChildProcess } from 'child_process';
 import { ExpoPushMessage } from 'expo-server-sdk';
 
 /**
@@ -379,6 +378,12 @@ declare const SessionSchema: z.ZodObject<{
     metadataVersion: z.ZodNumber;
     agentState: z.ZodNullable<z.ZodAny>;
     agentStateVersion: z.ZodNumber;
+    connectivityStatus: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["neverConnected", "online", "offline"]>, z.ZodString]>>;
+    connectivityStatusSince: z.ZodOptional<z.ZodNumber>;
+    connectivityStatusReason: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["running", "archiveRequested", "archived"]>, z.ZodString]>>;
+    stateSince: z.ZodOptional<z.ZodNumber>;
+    stateReason: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     seq: number;
@@ -388,6 +393,12 @@ declare const SessionSchema: z.ZodObject<{
     agentStateVersion: number;
     metadata?: any;
     agentState?: any;
+    connectivityStatus?: string | undefined;
+    connectivityStatusSince?: number | undefined;
+    connectivityStatusReason?: string | undefined;
+    state?: string | undefined;
+    stateSince?: number | undefined;
+    stateReason?: string | undefined;
 }, {
     id: string;
     seq: number;
@@ -397,6 +408,12 @@ declare const SessionSchema: z.ZodObject<{
     agentStateVersion: number;
     metadata?: any;
     agentState?: any;
+    connectivityStatus?: string | undefined;
+    connectivityStatusSince?: number | undefined;
+    connectivityStatusReason?: string | undefined;
+    state?: string | undefined;
+    stateSince?: number | undefined;
+    stateReason?: string | undefined;
 }>;
 type Session = z.infer<typeof SessionSchema>;
 /**
@@ -461,6 +478,12 @@ declare const MachineSchema: z.ZodObject<{
     activeAt: z.ZodNumber;
     createdAt: z.ZodNumber;
     updatedAt: z.ZodNumber;
+    connectivityStatus: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["neverConnected", "online", "offline"]>, z.ZodString]>>;
+    connectivityStatusSince: z.ZodOptional<z.ZodNumber>;
+    connectivityStatusReason: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["running", "archiveRequested", "archived"]>, z.ZodString]>>;
+    stateSince: z.ZodOptional<z.ZodNumber>;
+    stateReason: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     createdAt: number;
@@ -471,6 +494,12 @@ declare const MachineSchema: z.ZodObject<{
     activeAt: number;
     metadata?: any;
     daemonState?: any;
+    connectivityStatus?: string | undefined;
+    connectivityStatusSince?: number | undefined;
+    connectivityStatusReason?: string | undefined;
+    state?: string | undefined;
+    stateSince?: number | undefined;
+    stateReason?: string | undefined;
 }, {
     id: string;
     createdAt: number;
@@ -481,6 +510,12 @@ declare const MachineSchema: z.ZodObject<{
     activeAt: number;
     metadata?: any;
     daemonState?: any;
+    connectivityStatus?: string | undefined;
+    connectivityStatusSince?: number | undefined;
+    connectivityStatusReason?: string | undefined;
+    state?: string | undefined;
+    stateSince?: number | undefined;
+    stateReason?: string | undefined;
 }>;
 type Machine = z.infer<typeof MachineSchema>;
 declare const UserMessageSchema: z.ZodObject<{
@@ -571,6 +606,7 @@ type Metadata = {
         updatedAt: number;
     };
     machineId?: string;
+    claudeSessionId?: string;
     tools?: string[];
     slashCommands?: string[];
     homeDir?: string;
@@ -578,6 +614,10 @@ type Metadata = {
     startedFromDaemon?: boolean;
     hostPid?: number;
     startedBy?: 'daemon' | 'terminal';
+    lifecycleState?: 'running' | 'archiveRequested' | 'archived' | string;
+    lifecycleStateSince?: number;
+    archivedBy?: string;
+    archiveReason?: string;
 };
 type AgentState = {
     controlledByUser?: boolean | null | undefined;
@@ -603,22 +643,26 @@ type AgentState = {
 };
 
 /**
- * Daemon-specific types (not related to API/server communication)
+ * RPC handlers for API session communication
+ * Handles remote procedure calls from mobile clients
  */
 
-/**
- * Session tracking for daemon
- */
-interface TrackedSession {
-    startedBy: 'daemon' | string;
-    happySessionId?: string;
-    happySessionMetadataFromLocalWebhook?: Metadata;
-    pid: number;
-    childProcess?: ChildProcess;
-    error?: string;
-    directoryCreated?: boolean;
-    message?: string;
+interface SpawnSessionOptions {
+    machineId?: string;
+    directory: string;
+    sessionId?: string;
+    approvedNewDirectoryCreation?: boolean;
 }
+type SpawnSessionResult = {
+    type: 'success';
+    sessionId: string;
+} | {
+    type: 'requestToApproveDirectoryCreation';
+    directory: string;
+} | {
+    type: 'error';
+    errorMessage: string;
+};
 
 /**
  * WebSocket client for machine/daemon communication with Happy server
@@ -626,7 +670,7 @@ interface TrackedSession {
  */
 
 type MachineRpcHandlers = {
-    spawnSession: (directory: string, sessionId?: string) => Promise<TrackedSession | null>;
+    spawnSession: (options: SpawnSessionOptions) => Promise<SpawnSessionResult>;
     stopSession: (sessionId: string) => boolean;
     requestShutdown: () => void;
 };
@@ -717,6 +761,11 @@ declare class ApiClient {
     sessionSyncClient(session: Session): ApiSessionClient;
     machineSyncClient(machine: Machine): ApiMachineClient;
     push(): PushNotificationClient;
+    /**
+     * Register a vendor API token with the server
+     * The token is sent as a JSON string - server handles encryption
+     */
+    registerVendorToken(vendor: 'openai' | 'anthropic' | 'gemini', apiKey: any): Promise<void>;
 }
 
 /**

package/dist/lib.d.mts

@@ -1,6 +1,5 @@
 import { z } from 'zod';
 import { EventEmitter } from 'node:events';
-import { ChildProcess } from 'child_process';
 import { ExpoPushMessage } from 'expo-server-sdk';
 
 /**
@@ -379,6 +378,12 @@ declare const SessionSchema: z.ZodObject<{
     metadataVersion: z.ZodNumber;
     agentState: z.ZodNullable<z.ZodAny>;
     agentStateVersion: z.ZodNumber;
+    connectivityStatus: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["neverConnected", "online", "offline"]>, z.ZodString]>>;
+    connectivityStatusSince: z.ZodOptional<z.ZodNumber>;
+    connectivityStatusReason: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["running", "archiveRequested", "archived"]>, z.ZodString]>>;
+    stateSince: z.ZodOptional<z.ZodNumber>;
+    stateReason: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     seq: number;
@@ -388,6 +393,12 @@ declare const SessionSchema: z.ZodObject<{
     agentStateVersion: number;
     metadata?: any;
     agentState?: any;
+    connectivityStatus?: string | undefined;
+    connectivityStatusSince?: number | undefined;
+    connectivityStatusReason?: string | undefined;
+    state?: string | undefined;
+    stateSince?: number | undefined;
+    stateReason?: string | undefined;
 }, {
     id: string;
     seq: number;
@@ -397,6 +408,12 @@ declare const SessionSchema: z.ZodObject<{
     agentStateVersion: number;
     metadata?: any;
     agentState?: any;
+    connectivityStatus?: string | undefined;
+    connectivityStatusSince?: number | undefined;
+    connectivityStatusReason?: string | undefined;
+    state?: string | undefined;
+    stateSince?: number | undefined;
+    stateReason?: string | undefined;
 }>;
 type Session = z.infer<typeof SessionSchema>;
 /**
@@ -461,6 +478,12 @@ declare const MachineSchema: z.ZodObject<{
     activeAt: z.ZodNumber;
     createdAt: z.ZodNumber;
     updatedAt: z.ZodNumber;
+    connectivityStatus: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["neverConnected", "online", "offline"]>, z.ZodString]>>;
+    connectivityStatusSince: z.ZodOptional<z.ZodNumber>;
+    connectivityStatusReason: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["running", "archiveRequested", "archived"]>, z.ZodString]>>;
+    stateSince: z.ZodOptional<z.ZodNumber>;
+    stateReason: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     createdAt: number;
@@ -471,6 +494,12 @@ declare const MachineSchema: z.ZodObject<{
     activeAt: number;
     metadata?: any;
     daemonState?: any;
+    connectivityStatus?: string | undefined;
+    connectivityStatusSince?: number | undefined;
+    connectivityStatusReason?: string | undefined;
+    state?: string | undefined;
+    stateSince?: number | undefined;
+    stateReason?: string | undefined;
 }, {
     id: string;
     createdAt: number;
@@ -481,6 +510,12 @@ declare const MachineSchema: z.ZodObject<{
     activeAt: number;
     metadata?: any;
     daemonState?: any;
+    connectivityStatus?: string | undefined;
+    connectivityStatusSince?: number | undefined;
+    connectivityStatusReason?: string | undefined;
+    state?: string | undefined;
+    stateSince?: number | undefined;
+    stateReason?: string | undefined;
 }>;
 type Machine = z.infer<typeof MachineSchema>;
 declare const UserMessageSchema: z.ZodObject<{
@@ -571,6 +606,7 @@ type Metadata = {
         updatedAt: number;
     };
     machineId?: string;
+    claudeSessionId?: string;
     tools?: string[];
     slashCommands?: string[];
     homeDir?: string;
@@ -578,6 +614,10 @@ type Metadata = {
     startedFromDaemon?: boolean;
     hostPid?: number;
     startedBy?: 'daemon' | 'terminal';
+    lifecycleState?: 'running' | 'archiveRequested' | 'archived' | string;
+    lifecycleStateSince?: number;
+    archivedBy?: string;
+    archiveReason?: string;
 };
 type AgentState = {
     controlledByUser?: boolean | null | undefined;
@@ -603,22 +643,26 @@ type AgentState = {
 };
 
 /**
- * Daemon-specific types (not related to API/server communication)
+ * RPC handlers for API session communication
+ * Handles remote procedure calls from mobile clients
  */
 
-/**
- * Session tracking for daemon
- */
-interface TrackedSession {
-    startedBy: 'daemon' | string;
-    happySessionId?: string;
-    happySessionMetadataFromLocalWebhook?: Metadata;
-    pid: number;
-    childProcess?: ChildProcess;
-    error?: string;
-    directoryCreated?: boolean;
-    message?: string;
+interface SpawnSessionOptions {
+    machineId?: string;
+    directory: string;
+    sessionId?: string;
+    approvedNewDirectoryCreation?: boolean;
 }
+type SpawnSessionResult = {
+    type: 'success';
+    sessionId: string;
+} | {
+    type: 'requestToApproveDirectoryCreation';
+    directory: string;
+} | {
+    type: 'error';
+    errorMessage: string;
+};
 
 /**
  * WebSocket client for machine/daemon communication with Happy server
@@ -626,7 +670,7 @@ interface TrackedSession {
  */
 
 type MachineRpcHandlers = {
-    spawnSession: (directory: string, sessionId?: string) => Promise<TrackedSession | null>;
+    spawnSession: (options: SpawnSessionOptions) => Promise<SpawnSessionResult>;
     stopSession: (sessionId: string) => boolean;
     requestShutdown: () => void;
 };
@@ -717,6 +761,11 @@ declare class ApiClient {
     sessionSyncClient(session: Session): ApiSessionClient;
     machineSyncClient(machine: Machine): ApiMachineClient;
     push(): PushNotificationClient;
+    /**
+     * Register a vendor API token with the server
+     * The token is sent as a JSON string - server handles encryption
+     */
+    registerVendorToken(vendor: 'openai' | 'anthropic' | 'gemini', apiKey: any): Promise<void>;
 }
 
 /**

package/dist/lib.mjs

@@ -1,4 +1,4 @@
-export { A as ApiClient, a as ApiSessionClient, R as RawJSONLinesSchema, c as configuration, l as logger } from './types-Cezp_n6O.mjs';
+export { A as ApiClient, a as ApiSessionClient, R as RawJSONLinesSchema, c as configuration, l as logger } from './types-CGbH1LGX.mjs';
 import 'axios';
 import 'chalk';
 import 'fs';

package/dist/{types-Cezp_n6O.mjs → types-CGbH1LGX.mjs}

@@ -14,7 +14,7 @@ import { io } from 'socket.io-client';
 import { Expo } from 'expo-server-sdk';
 
 var name = "happy-coder";
-var version = "0.9.0";
+var version = "0.10.0-0";
 var description = "Claude Code session sharing CLI";
 var author = "Kirill Dubovitskiy";
 var license = "MIT";
@@ -79,6 +79,7 @@ var dependencies = {
 	"@types/react": "^19.1.9",
 	axios: "^1.10.0",
 	chalk: "^5.4.1",
+	"cross-spawn": "^7.0.6",
 	"expo-server-sdk": "^3.15.0",
 	fastify: "^5.5.0",
 	"fastify-type-provider-zod": "4.0.2",
@@ -86,6 +87,7 @@ var dependencies = {
 	"http-proxy-middleware": "^3.0.5",
 	ink: "^6.1.0",
 	open: "^10.2.0",
+	"ps-list": "^8.1.1",
 	"qrcode-terminal": "^0.12.0",
 	react: "^19.1.1",
 	"socket.io-client": "^4.8.1",
@@ -94,7 +96,9 @@ var dependencies = {
 };
 var devDependencies = {
 	"@eslint/compat": "^1",
+	"@types/cross-spawn": "^6.0.6",
 	"@types/node": ">=20",
+	"@types/ps-list": "^6.2.1",
 	"cross-env": "^10.0.0",
 	dotenv: "^16.6.1",
 	eslint: "^9",
@@ -153,7 +157,7 @@ class Configuration {
   currentCliVersion;
   isExperimentalEnabled;
   constructor() {
-    this.serverUrl = process.env.HAPPY_SERVER_URL || "https://handy-api.korshakov.org";
+    this.serverUrl = process.env.HAPPY_SERVER_URL || "https://api.cluster-fluster.com";
     const args = process.argv.slice(2);
     this.isDaemonProcess = args.length >= 2 && args[0] === "daemon" && args[1] === "start-sync";
     if (process.env.HAPPY_HOME_DIR) {
@@ -533,7 +537,7 @@ class Logger {
       appendFileSync(this.logFilePath, logLine);
     } catch (appendError) {
       if (process.env.DEBUG) {
-        console.error("Failed to append to log file:", appendError);
+        console.error("[DEV MODE ONLY THROWING] Failed to append to log file:", appendError);
         throw appendError;
       }
     }
@@ -640,7 +644,23 @@ z$1.object({
   metadata: z$1.any(),
   metadataVersion: z$1.number(),
   agentState: z$1.any().nullable(),
-  agentStateVersion: z$1.number()
+  agentStateVersion: z$1.number(),
+  // Connectivity tracking (from server)
+  connectivityStatus: z$1.union([
+    z$1.enum(["neverConnected", "online", "offline"]),
+    z$1.string()
+    // Forward compatibility
+  ]).optional(),
+  connectivityStatusSince: z$1.number().optional(),
+  connectivityStatusReason: z$1.string().optional(),
+  // State tracking (from server)
+  state: z$1.union([
+    z$1.enum(["running", "archiveRequested", "archived"]),
+    z$1.string()
+    // Forward compatibility
+  ]).optional(),
+  stateSince: z$1.number().optional(),
+  stateReason: z$1.string().optional()
 });
 z$1.object({
   host: z$1.string(),
@@ -678,7 +698,23 @@ z$1.object({
   active: z$1.boolean(),
   activeAt: z$1.number(),
   createdAt: z$1.number(),
-  updatedAt: z$1.number()
+  updatedAt: z$1.number(),
+  // Connectivity tracking (from server)
+  connectivityStatus: z$1.union([
+    z$1.enum(["neverConnected", "online", "offline"]),
+    z$1.string()
+    // Forward compatibility
+  ]).optional(),
+  connectivityStatusSince: z$1.number().optional(),
+  connectivityStatusReason: z$1.string().optional(),
+  // State tracking (from server)
+  state: z$1.union([
+    z$1.enum(["running", "archiveRequested", "archived"]),
+    z$1.string()
+    // Forward compatibility
+  ]).optional(),
+  stateSince: z$1.number().optional(),
+  stateReason: z$1.string().optional()
 });
 z$1.object({
   content: SessionMessageContentSchema,
@@ -991,7 +1027,9 @@ class ApiSessionClient extends EventEmitter {
    * Send a ping message to keep the connection alive
    */
   keepAlive(thinking, mode) {
-    logger.debug(`[API] Sending keep alive message: ${thinking}`);
+    if (process.env.DEBUG) {
+      logger.debug(`[API] Sending keep alive message: ${thinking}`);
+    }
     this.socket.volatile.emit("session-alive", {
       sid: this.sessionId,
       time: Date.now(),
@@ -1229,37 +1267,39 @@ class ApiMachineClient {
     this.socket.on("rpc-request", async (data, callback) => {
       logger.debugLargeJson(`[API MACHINE] Received RPC request:`, data);
       try {
-        const spawnMethod2 = `${this.machine.id}:spawn-happy-session`;
-        const stopMethod2 = `${this.machine.id}:stop-session`;
-        const stopDaemonMethod2 = `${this.machine.id}:stop-daemon`;
-        if (data.method === spawnMethod2) {
+        if (data.method === spawnMethod) {
           if (!this.spawnSession) {
             throw new Error("Spawn session handler not set");
           }
-          const { directory, sessionId } = decrypt(decodeBase64(data.params), this.secret) || {};
+          const { directory, sessionId, machineId, approvedNewDirectoryCreation } = decrypt(decodeBase64(data.params), this.secret) || {};
           if (!directory) {
             throw new Error("Directory is required");
           }
-          const session = await this.spawnSession(directory, sessionId);
-          if (!session) {
-            throw new Error("Failed to spawn session");
-          }
-          if (session.error) {
-            throw new Error(session.error);
-          }
-          logger.debug(`[API MACHINE] Spawned session ${session.happySessionId || "WARNING - not session Id recieved in webhook"} with PID ${session.pid}`);
-          if (!session.happySessionId) {
-            throw new Error(`Session spawned (PID ${session.pid}) but no sessionId received from webhook. The session process may still be initializing.`);
+          const result = await this.spawnSession({ directory, sessionId, machineId, approvedNewDirectoryCreation });
+          switch (result.type) {
+            case "success": {
+              logger.debug(`[API MACHINE] Spawned session ${result.sessionId}`);
+              const response = {
+                type: "success",
+                sessionId: result.sessionId
+              };
+              logger.debug(`[API MACHINE] Sending RPC response:`, response);
+              callback(encodeBase64(encrypt(response, this.secret)));
+              return;
+            }
+            case "requestToApproveDirectoryCreation":
+              const promptResponse = {
+                type: "requestToApproveDirectoryCreation",
+                directory: result.directory
+              };
+              logger.debug(`[API MACHINE] Requesting directory creation approval for: ${result.directory}`);
+              callback(encodeBase64(encrypt(promptResponse, this.secret)));
+              return;
+            case "error":
+              throw new Error(result.errorMessage);
           }
-          const response = {
-            sessionId: session.happySessionId,
-            message: session.message
-          };
-          logger.debug(`[API MACHINE] Sending RPC response:`, response);
-          callback(encodeBase64(encrypt(response, this.secret)));
-          return;
         }
-        if (data.method === stopMethod2) {
+        if (data.method === stopMethod) {
           logger.debug("[API MACHINE] Received stop-session RPC request");
           const decryptedParams = decrypt(decodeBase64(data.params), this.secret);
           const { sessionId } = decryptedParams || {};
@@ -1279,7 +1319,7 @@ class ApiMachineClient {
           callback(encryptedResponse);
           return;
         }
-        if (data.method === stopDaemonMethod2) {
+        if (data.method === stopDaemonMethod) {
           logger.debug("[API MACHINE] Received stop-daemon RPC request");
           callback(encodeBase64(encrypt({
             message: "Daemon stop request acknowledged, starting shutdown sequence..."
@@ -1340,7 +1380,9 @@ class ApiMachineClient {
         machineId: this.machine.id,
         time: Date.now()
       };
-      logger.debugLargeJson(`[API MACHINE] Emitting machine-alive`, payload);
+      if (process.env.DEBUG) {
+        logger.debugLargeJson(`[API MACHINE] Emitting machine-alive`, payload);
+      }
       this.socket.emit("machine-alive", payload);
     }, 2e4);
     logger.debug("[API MACHINE] Keep-alive started (20s interval)");
@@ -1366,7 +1408,7 @@ class PushNotificationClient {
   token;
   baseUrl;
   expo;
-  constructor(token, baseUrl = "https://handy-api.korshakov.org") {
+  constructor(token, baseUrl = "https://api.cluster-fluster.com") {
     this.token = token;
     this.baseUrl = baseUrl;
     this.expo = new Expo();
@@ -1615,6 +1657,34 @@ class ApiClient {
   push() {
     return this.pushClient;
   }
+  /**
+   * Register a vendor API token with the server
+   * The token is sent as a JSON string - server handles encryption
+   */
+  async registerVendorToken(vendor, apiKey) {
+    try {
+      const response = await axios.post(
+        `${configuration.serverUrl}/v1/connect/${vendor}/register`,
+        {
+          token: JSON.stringify(apiKey)
+        },
+        {
+          headers: {
+            "Authorization": `Bearer ${this.token}`,
+            "Content-Type": "application/json"
+          },
+          timeout: 5e3
+        }
+      );
+      if (response.status !== 200 && response.status !== 201) {
+        throw new Error(`Server returned status ${response.status}`);
+      }
+      logger.debug(`[API] Vendor token for ${vendor} registered successfully`);
+    } catch (error) {
+      logger.debug(`[API] [ERROR] Failed to register vendor token:`, error);
+      throw new Error(`Failed to register vendor token: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+  }
 }
 
 const UsageSchema = z$1.object({