happy-coder 0.6.4 → 0.7.1-beta.2

package/dist/lib.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var types = require('./types-BDtHM1DY.cjs');
+var types = require('./types-CzvFvJwf.cjs');
 require('axios');
 require('chalk');
 require('fs');
@@ -20,13 +20,5 @@ require('expo-server-sdk');
 exports.ApiClient = types.ApiClient;
 exports.ApiSessionClient = types.ApiSessionClient;
 exports.RawJSONLinesSchema = types.RawJSONLinesSchema;
-Object.defineProperty(exports, "configuration", {
-	enumerable: true,
-	get: function () { return types.configuration; }
-});
-exports.initLoggerWithGlobalConfiguration = types.initLoggerWithGlobalConfiguration;
-exports.initializeConfiguration = types.initializeConfiguration;
-Object.defineProperty(exports, "logger", {
-	enumerable: true,
-	get: function () { return types.logger; }
-});
+exports.configuration = types.configuration;
+exports.logger = types.logger;

package/dist/lib.d.cts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { EventEmitter } from 'node:events';
+import { ChildProcess } from 'child_process';
 import { ExpoPushMessage } from 'expo-server-sdk';
 
 /**
@@ -323,6 +324,90 @@ declare const SessionSchema: z.ZodObject<{
     agentState?: any;
 }>;
 type Session = z.infer<typeof SessionSchema>;
+/**
+ * Machine metadata - static information (rarely changes)
+ */
+declare const MachineMetadataSchema: z.ZodObject<{
+    host: z.ZodString;
+    platform: z.ZodString;
+    happyCliVersion: z.ZodString;
+    homeDir: z.ZodString;
+    happyHomeDir: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    host: string;
+    platform: string;
+    happyCliVersion: string;
+    homeDir: string;
+    happyHomeDir: string;
+}, {
+    host: string;
+    platform: string;
+    happyCliVersion: string;
+    homeDir: string;
+    happyHomeDir: string;
+}>;
+type MachineMetadata = z.infer<typeof MachineMetadataSchema>;
+/**
+ * Daemon state - dynamic runtime information (frequently updated)
+ */
+declare const DaemonStateSchema: z.ZodObject<{
+    status: z.ZodUnion<[z.ZodEnum<["running", "shutting-down"]>, z.ZodString]>;
+    pid: z.ZodOptional<z.ZodNumber>;
+    httpPort: z.ZodOptional<z.ZodNumber>;
+    startedAt: z.ZodOptional<z.ZodNumber>;
+    shutdownRequestedAt: z.ZodOptional<z.ZodNumber>;
+    shutdownSource: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["mobile-app", "cli", "os-signal", "unknown"]>, z.ZodString]>>;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    pid?: number | undefined;
+    httpPort?: number | undefined;
+    startedAt?: number | undefined;
+    shutdownRequestedAt?: number | undefined;
+    shutdownSource?: string | undefined;
+}, {
+    status: string;
+    pid?: number | undefined;
+    httpPort?: number | undefined;
+    startedAt?: number | undefined;
+    shutdownRequestedAt?: number | undefined;
+    shutdownSource?: string | undefined;
+}>;
+type DaemonState = z.infer<typeof DaemonStateSchema>;
+/**
+ * Machine information - similar to Session
+ */
+declare const MachineSchema: z.ZodObject<{
+    id: z.ZodString;
+    metadata: z.ZodAny;
+    metadataVersion: z.ZodNumber;
+    daemonState: z.ZodNullable<z.ZodAny>;
+    daemonStateVersion: z.ZodNumber;
+    active: z.ZodBoolean;
+    activeAt: z.ZodNumber;
+    createdAt: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    createdAt: number;
+    updatedAt: number;
+    metadataVersion: number;
+    daemonStateVersion: number;
+    active: boolean;
+    activeAt: number;
+    metadata?: any;
+    daemonState?: any;
+}, {
+    id: string;
+    createdAt: number;
+    updatedAt: number;
+    metadataVersion: number;
+    daemonStateVersion: number;
+    active: boolean;
+    activeAt: number;
+    metadata?: any;
+    daemonState?: any;
+}>;
+type Machine = z.infer<typeof MachineSchema>;
 declare const UserMessageSchema: z.ZodObject<{
     role: z.ZodLiteral<"user">;
     content: z.ZodObject<{
@@ -414,6 +499,10 @@ type Metadata = {
     tools?: string[];
     slashCommands?: string[];
     homeDir?: string;
+    happyHomeDir?: string;
+    startedFromDaemon?: boolean;
+    hostPid?: number;
+    startedBy?: 'daemon' | 'terminal';
 };
 type AgentState = {
     controlledByUser?: boolean | null | undefined;
@@ -507,6 +596,59 @@ declare class ApiSessionClient extends EventEmitter {
     close(): Promise<void>;
 }
 
+/**
+ * Daemon-specific types (not related to API/server communication)
+ */
+
+/**
+ * Session tracking for daemon
+ */
+interface TrackedSession {
+    startedBy: 'daemon' | string;
+    happySessionId?: string;
+    happySessionMetadataFromLocalWebhook?: Metadata;
+    pid: number;
+    childProcess?: ChildProcess;
+}
+
+/**
+ * WebSocket client for machine/daemon communication with Happy server
+ * Similar to ApiSessionClient but for machine-scoped connections
+ */
+
+type MachineRpcHandlers = {
+    spawnSession: (directory: string, sessionId?: string) => Promise<TrackedSession | null>;
+    stopSession: (sessionId: string) => boolean;
+    requestShutdown: () => void;
+};
+declare class ApiMachineClient {
+    private token;
+    private secret;
+    private machine;
+    private socket;
+    private keepAliveInterval;
+    private spawnSession?;
+    private stopSession?;
+    private requestShutdown?;
+    constructor(token: string, secret: Uint8Array, machine: Machine);
+    setRPCHandlers({ spawnSession, stopSession, requestShutdown }: MachineRpcHandlers): void;
+    /**
+     * Update machine metadata
+     * Currently unused, changes from the mobile client are more likely
+     * for example to set a custom name.
+     */
+    updateMachineMetadata(handler: (metadata: MachineMetadata | null) => MachineMetadata): Promise<void>;
+    /**
+     * Update daemon state (runtime info) - similar to session updateAgentState
+     * Simplified without lock - relies on backoff for retry
+     */
+    updateDaemonState(handler: (state: DaemonState | null) => DaemonState): Promise<void>;
+    connect(): void;
+    private startKeepAlive;
+    private stopKeepAlive;
+    shutdown(): void;
+}
+
 interface PushToken {
     id: string;
     token: string;
@@ -550,15 +692,21 @@ declare class ApiClient {
         state: AgentState | null;
     }): Promise<Session>;
     /**
-     * Start realtime session client
-     * @param id - Session ID
-     * @returns Session client
+     * Get machine by ID from the server
+     * Returns the current machine state from the server with decrypted metadata and daemonState
      */
-    session(session: Session): ApiSessionClient;
+    getMachine(machineId: string): Promise<Machine | null>;
     /**
-     * Get push notification client
-     * @returns Push notification client
+     * Register or update machine with the server
+     * Returns the current machine state from the server with decrypted metadata and daemonState
      */
+    createOrReturnExistingAsIs(opts: {
+        machineId: string;
+        metadata: MachineMetadata;
+        daemonState: DaemonState;
+    }): Promise<Machine>;
+    sessionSyncClient(session: Session): ApiSessionClient;
+    machineSyncClient(machine: Machine): ApiMachineClient;
     push(): PushNotificationClient;
 }
 
@@ -570,6 +718,7 @@ declare class ApiClient {
  */
 declare class Logger {
     readonly logFilePathPromise: Promise<string>;
+    private dangerouslyUnencryptedServerLoggingUrl;
     constructor(logFilePathPromise?: Promise<string>);
     localTimezoneTimestamp(): string;
     debug(message: string, ...args: unknown[]): void;
@@ -577,10 +726,10 @@ declare class Logger {
     info(message: string, ...args: unknown[]): void;
     infoDeveloper(message: string, ...args: unknown[]): void;
     private logToConsole;
+    private sendToRemoteServer;
     private logToFile;
 }
 declare let logger: Logger;
-declare function initLoggerWithGlobalConfiguration(): void;
 
 /**
  * Global configuration for happy CLI
@@ -590,17 +739,16 @@ declare function initLoggerWithGlobalConfiguration(): void;
  */
 declare class Configuration {
     readonly serverUrl: string;
-    readonly installationLocation: 'global' | 'local';
     readonly isDaemonProcess: boolean;
-    readonly happyDir: string;
+    readonly happyHomeDir: string;
     readonly logsDir: string;
     readonly daemonLogsDir: string;
     readonly settingsFile: string;
     readonly privateKeyFile: string;
-    readonly daemonMetadataFile: string;
-    constructor(location: 'global' | 'local' | string);
+    readonly daemonStateFile: string;
+    constructor();
 }
-declare let configuration: Configuration;
-declare function initializeConfiguration(location: 'global' | 'local' | string): void;
+declare const configuration: Configuration;
 
-export { ApiClient, ApiSessionClient, type RawJSONLines, RawJSONLinesSchema, configuration, initLoggerWithGlobalConfiguration, initializeConfiguration, logger };
+export { ApiClient, ApiSessionClient, RawJSONLinesSchema, configuration, logger };
+export type { RawJSONLines };

package/dist/lib.d.mts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { EventEmitter } from 'node:events';
+import { ChildProcess } from 'child_process';
 import { ExpoPushMessage } from 'expo-server-sdk';
 
 /**
@@ -323,6 +324,90 @@ declare const SessionSchema: z.ZodObject<{
     agentState?: any;
 }>;
 type Session = z.infer<typeof SessionSchema>;
+/**
+ * Machine metadata - static information (rarely changes)
+ */
+declare const MachineMetadataSchema: z.ZodObject<{
+    host: z.ZodString;
+    platform: z.ZodString;
+    happyCliVersion: z.ZodString;
+    homeDir: z.ZodString;
+    happyHomeDir: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    host: string;
+    platform: string;
+    happyCliVersion: string;
+    homeDir: string;
+    happyHomeDir: string;
+}, {
+    host: string;
+    platform: string;
+    happyCliVersion: string;
+    homeDir: string;
+    happyHomeDir: string;
+}>;
+type MachineMetadata = z.infer<typeof MachineMetadataSchema>;
+/**
+ * Daemon state - dynamic runtime information (frequently updated)
+ */
+declare const DaemonStateSchema: z.ZodObject<{
+    status: z.ZodUnion<[z.ZodEnum<["running", "shutting-down"]>, z.ZodString]>;
+    pid: z.ZodOptional<z.ZodNumber>;
+    httpPort: z.ZodOptional<z.ZodNumber>;
+    startedAt: z.ZodOptional<z.ZodNumber>;
+    shutdownRequestedAt: z.ZodOptional<z.ZodNumber>;
+    shutdownSource: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["mobile-app", "cli", "os-signal", "unknown"]>, z.ZodString]>>;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    pid?: number | undefined;
+    httpPort?: number | undefined;
+    startedAt?: number | undefined;
+    shutdownRequestedAt?: number | undefined;
+    shutdownSource?: string | undefined;
+}, {
+    status: string;
+    pid?: number | undefined;
+    httpPort?: number | undefined;
+    startedAt?: number | undefined;
+    shutdownRequestedAt?: number | undefined;
+    shutdownSource?: string | undefined;
+}>;
+type DaemonState = z.infer<typeof DaemonStateSchema>;
+/**
+ * Machine information - similar to Session
+ */
+declare const MachineSchema: z.ZodObject<{
+    id: z.ZodString;
+    metadata: z.ZodAny;
+    metadataVersion: z.ZodNumber;
+    daemonState: z.ZodNullable<z.ZodAny>;
+    daemonStateVersion: z.ZodNumber;
+    active: z.ZodBoolean;
+    activeAt: z.ZodNumber;
+    createdAt: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    createdAt: number;
+    updatedAt: number;
+    metadataVersion: number;
+    daemonStateVersion: number;
+    active: boolean;
+    activeAt: number;
+    metadata?: any;
+    daemonState?: any;
+}, {
+    id: string;
+    createdAt: number;
+    updatedAt: number;
+    metadataVersion: number;
+    daemonStateVersion: number;
+    active: boolean;
+    activeAt: number;
+    metadata?: any;
+    daemonState?: any;
+}>;
+type Machine = z.infer<typeof MachineSchema>;
 declare const UserMessageSchema: z.ZodObject<{
     role: z.ZodLiteral<"user">;
     content: z.ZodObject<{
@@ -414,6 +499,10 @@ type Metadata = {
     tools?: string[];
     slashCommands?: string[];
     homeDir?: string;
+    happyHomeDir?: string;
+    startedFromDaemon?: boolean;
+    hostPid?: number;
+    startedBy?: 'daemon' | 'terminal';
 };
 type AgentState = {
     controlledByUser?: boolean | null | undefined;
@@ -507,6 +596,59 @@ declare class ApiSessionClient extends EventEmitter {
     close(): Promise<void>;
 }
 
+/**
+ * Daemon-specific types (not related to API/server communication)
+ */
+
+/**
+ * Session tracking for daemon
+ */
+interface TrackedSession {
+    startedBy: 'daemon' | string;
+    happySessionId?: string;
+    happySessionMetadataFromLocalWebhook?: Metadata;
+    pid: number;
+    childProcess?: ChildProcess;
+}
+
+/**
+ * WebSocket client for machine/daemon communication with Happy server
+ * Similar to ApiSessionClient but for machine-scoped connections
+ */
+
+type MachineRpcHandlers = {
+    spawnSession: (directory: string, sessionId?: string) => Promise<TrackedSession | null>;
+    stopSession: (sessionId: string) => boolean;
+    requestShutdown: () => void;
+};
+declare class ApiMachineClient {
+    private token;
+    private secret;
+    private machine;
+    private socket;
+    private keepAliveInterval;
+    private spawnSession?;
+    private stopSession?;
+    private requestShutdown?;
+    constructor(token: string, secret: Uint8Array, machine: Machine);
+    setRPCHandlers({ spawnSession, stopSession, requestShutdown }: MachineRpcHandlers): void;
+    /**
+     * Update machine metadata
+     * Currently unused, changes from the mobile client are more likely
+     * for example to set a custom name.
+     */
+    updateMachineMetadata(handler: (metadata: MachineMetadata | null) => MachineMetadata): Promise<void>;
+    /**
+     * Update daemon state (runtime info) - similar to session updateAgentState
+     * Simplified without lock - relies on backoff for retry
+     */
+    updateDaemonState(handler: (state: DaemonState | null) => DaemonState): Promise<void>;
+    connect(): void;
+    private startKeepAlive;
+    private stopKeepAlive;
+    shutdown(): void;
+}
+
 interface PushToken {
     id: string;
     token: string;
@@ -550,15 +692,21 @@ declare class ApiClient {
         state: AgentState | null;
     }): Promise<Session>;
     /**
-     * Start realtime session client
-     * @param id - Session ID
-     * @returns Session client
+     * Get machine by ID from the server
+     * Returns the current machine state from the server with decrypted metadata and daemonState
      */
-    session(session: Session): ApiSessionClient;
+    getMachine(machineId: string): Promise<Machine | null>;
     /**
-     * Get push notification client
-     * @returns Push notification client
+     * Register or update machine with the server
+     * Returns the current machine state from the server with decrypted metadata and daemonState
      */
+    createOrReturnExistingAsIs(opts: {
+        machineId: string;
+        metadata: MachineMetadata;
+        daemonState: DaemonState;
+    }): Promise<Machine>;
+    sessionSyncClient(session: Session): ApiSessionClient;
+    machineSyncClient(machine: Machine): ApiMachineClient;
     push(): PushNotificationClient;
 }
 
@@ -570,6 +718,7 @@ declare class ApiClient {
  */
 declare class Logger {
     readonly logFilePathPromise: Promise<string>;
+    private dangerouslyUnencryptedServerLoggingUrl;
     constructor(logFilePathPromise?: Promise<string>);
     localTimezoneTimestamp(): string;
     debug(message: string, ...args: unknown[]): void;
@@ -577,10 +726,10 @@ declare class Logger {
     info(message: string, ...args: unknown[]): void;
     infoDeveloper(message: string, ...args: unknown[]): void;
     private logToConsole;
+    private sendToRemoteServer;
     private logToFile;
 }
 declare let logger: Logger;
-declare function initLoggerWithGlobalConfiguration(): void;
 
 /**
  * Global configuration for happy CLI
@@ -590,17 +739,16 @@ declare function initLoggerWithGlobalConfiguration(): void;
  */
 declare class Configuration {
     readonly serverUrl: string;
-    readonly installationLocation: 'global' | 'local';
     readonly isDaemonProcess: boolean;
-    readonly happyDir: string;
+    readonly happyHomeDir: string;
     readonly logsDir: string;
     readonly daemonLogsDir: string;
     readonly settingsFile: string;
     readonly privateKeyFile: string;
-    readonly daemonMetadataFile: string;
-    constructor(location: 'global' | 'local' | string);
+    readonly daemonStateFile: string;
+    constructor();
 }
-declare let configuration: Configuration;
-declare function initializeConfiguration(location: 'global' | 'local' | string): void;
+declare const configuration: Configuration;
 
-export { ApiClient, ApiSessionClient, type RawJSONLines, RawJSONLinesSchema, configuration, initLoggerWithGlobalConfiguration, initializeConfiguration, logger };
+export { ApiClient, ApiSessionClient, RawJSONLinesSchema, configuration, logger };
+export type { RawJSONLines };

package/dist/lib.mjs

@@ -1,4 +1,4 @@
-export { A as ApiClient, a as ApiSessionClient, R as RawJSONLinesSchema, c as configuration, i as initLoggerWithGlobalConfiguration, b as initializeConfiguration, l as logger } from './types-Dz5kZrVh.mjs';
+export { A as ApiClient, a as ApiSessionClient, R as RawJSONLinesSchema, c as configuration, l as logger } from './types-BZC9-exR.mjs';
 import 'axios';
 import 'chalk';
 import 'fs';