@jungjaehoon/mama-os 0.1.1

package/dist/api/index.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * API module exports
+ *
+ * Provides HTTP API for cron job management and heartbeat functionality.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiError = exports.validateRequired = exports.asyncHandler = exports.DEFAULT_HEARTBEAT_PROMPT = exports.InMemoryHeartbeatTracker = exports.ScheduleStoreAdapter = exports.InMemoryLogStore = void 0;
+exports.createApiServer = createApiServer;
+exports.createApiRouters = createApiRouters;
+const express_1 = __importDefault(require("express"));
+const cron_handler_js_1 = require("./cron-handler.js");
+const heartbeat_handler_js_1 = require("./heartbeat-handler.js");
+const error_handler_js_1 = require("./error-handler.js");
+// Re-export types
+__exportStar(require("./types.js"), exports);
+var cron_handler_js_2 = require("./cron-handler.js");
+Object.defineProperty(exports, "InMemoryLogStore", { enumerable: true, get: function () { return cron_handler_js_2.InMemoryLogStore; } });
+Object.defineProperty(exports, "ScheduleStoreAdapter", { enumerable: true, get: function () { return cron_handler_js_2.ScheduleStoreAdapter; } });
+var heartbeat_handler_js_2 = require("./heartbeat-handler.js");
+Object.defineProperty(exports, "InMemoryHeartbeatTracker", { enumerable: true, get: function () { return heartbeat_handler_js_2.InMemoryHeartbeatTracker; } });
+Object.defineProperty(exports, "DEFAULT_HEARTBEAT_PROMPT", { enumerable: true, get: function () { return heartbeat_handler_js_2.DEFAULT_HEARTBEAT_PROMPT; } });
+var error_handler_js_2 = require("./error-handler.js");
+Object.defineProperty(exports, "asyncHandler", { enumerable: true, get: function () { return error_handler_js_2.asyncHandler; } });
+Object.defineProperty(exports, "validateRequired", { enumerable: true, get: function () { return error_handler_js_2.validateRequired; } });
+Object.defineProperty(exports, "ApiError", { enumerable: true, get: function () { return error_handler_js_2.ApiError; } });
+/**
+ * Create and configure the API server
+ */
+function createApiServer(options) {
+    const { scheduler, port = 3848, logStore = new cron_handler_js_1.InMemoryLogStore(), heartbeatTracker = new heartbeat_handler_js_1.InMemoryHeartbeatTracker(), onHeartbeat, } = options;
+    const app = (0, express_1.default)();
+    // Middleware
+    app.use(express_1.default.json());
+    // Set Content-Type header for API responses only
+    app.use('/api', (_req, res, next) => {
+        res.setHeader('Content-Type', 'application/json');
+        next();
+    });
+    // Mount API routers
+    const cronRouter = (0, cron_handler_js_1.createCronRouter)(scheduler, logStore);
+    const heartbeatRouter = (0, heartbeat_handler_js_1.createHeartbeatRouter)({
+        scheduler,
+        logStore,
+        tracker: heartbeatTracker,
+        onHeartbeat,
+    });
+    app.use('/api/cron', cronRouter);
+    app.use('/api/heartbeat', heartbeatRouter);
+    // Health check endpoint
+    app.get('/health', (_req, res) => {
+        res.json({ status: 'ok', timestamp: Date.now() });
+    });
+    // Note: Error handlers are mounted in start() to allow adding custom routes first
+    let server = null;
+    let actualPort = port;
+    let errorHandlersMounted = false;
+    return {
+        app,
+        get server() {
+            return server;
+        },
+        get port() {
+            return actualPort;
+        },
+        async start() {
+            // Mount error handlers right before starting
+            if (!errorHandlersMounted) {
+                app.use(error_handler_js_1.notFoundHandler);
+                app.use(error_handler_js_1.errorHandler);
+                errorHandlersMounted = true;
+            }
+            return new Promise((resolve, reject) => {
+                try {
+                    // SECURITY: Bind to localhost only to prevent remote access
+                    const host = process.env.MAMA_API_HOST || '127.0.0.1';
+                    server = app.listen(port, host, () => {
+                        actualPort = server.address().port;
+                        console.log(`API server listening on http://${host}:${actualPort}`);
+                        if (host === '0.0.0.0') {
+                            console.warn('⚠️  WARNING: API server exposed to all interfaces!');
+                            console.warn('   Set MAMA_API_HOST=127.0.0.1 for local-only access');
+                        }
+                        resolve();
+                    });
+                    server.on('error', reject);
+                }
+                catch (error) {
+                    reject(error);
+                }
+            });
+        },
+        async stop() {
+            return new Promise((resolve, reject) => {
+                if (!server) {
+                    resolve();
+                    return;
+                }
+                server.close((err) => {
+                    if (err) {
+                        reject(err);
+                    }
+                    else {
+                        server = null;
+                        resolve();
+                    }
+                });
+            });
+        },
+    };
+}
+/**
+ * Create API routers without starting a server
+ * Useful for integrating into an existing Express app
+ */
+function createApiRouters(options) {
+    const { scheduler, logStore = new cron_handler_js_1.InMemoryLogStore(), heartbeatTracker = new heartbeat_handler_js_1.InMemoryHeartbeatTracker(), onHeartbeat, } = options;
+    return {
+        cronRouter: (0, cron_handler_js_1.createCronRouter)(scheduler, logStore),
+        heartbeatRouter: (0, heartbeat_handler_js_1.createHeartbeatRouter)({
+            scheduler,
+            logStore,
+            tracker: heartbeatTracker,
+            onHeartbeat,
+        }),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"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"}

package/dist/api/types.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Type definitions for Heartbeat API
+ */
+import type { CronJob, JobResult } from '../scheduler/types.js';
+/**
+ * API representation of a cron job
+ */
+export interface ApiCronJob {
+    id: string;
+    name: string;
+    cron_expr: string;
+    prompt: string;
+    enabled: boolean;
+    last_run: number | null;
+    next_run: number | null;
+}
+/**
+ * Request body for creating a cron job
+ */
+export interface CreateCronJobRequest {
+    name: string;
+    cron_expr: string;
+    prompt: string;
+    enabled?: boolean;
+}
+/**
+ * Request body for updating a cron job
+ */
+export interface UpdateCronJobRequest {
+    name?: string;
+    cron_expr?: string;
+    prompt?: string;
+    enabled?: boolean;
+}
+/**
+ * Response for cron job list
+ */
+export interface ListCronJobsResponse {
+    jobs: ApiCronJob[];
+}
+/**
+ * Response for single cron job
+ */
+export interface GetCronJobResponse {
+    job: ApiCronJob;
+}
+/**
+ * Response for cron job creation
+ */
+export interface CreateCronJobResponse {
+    id: string;
+    created: boolean;
+}
+/**
+ * Response for cron job update
+ */
+export interface UpdateCronJobResponse {
+    updated: boolean;
+}
+/**
+ * Response for cron job deletion
+ */
+export interface DeleteCronJobResponse {
+    deleted: boolean;
+}
+/**
+ * Response for immediate job execution
+ */
+export interface RunCronJobResponse {
+    execution_id: string;
+    started: boolean;
+}
+/**
+ * Execution log entry
+ */
+export interface ExecutionLog {
+    id: string;
+    started_at: number;
+    finished_at: number | null;
+    status: 'running' | 'success' | 'failed';
+    output: string | null;
+    error: string | null;
+}
+/**
+ * Response for execution logs
+ */
+export interface GetLogsResponse {
+    logs: ExecutionLog[];
+}
+/**
+ * Query parameters for logs endpoint
+ */
+export interface GetLogsQuery {
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Last execution info for heartbeat status
+ */
+export interface LastExecution {
+    id: string;
+    started_at: number;
+    status: 'success' | 'failed';
+}
+/**
+ * Response for heartbeat status
+ */
+export interface HeartbeatStatusResponse {
+    status: 'active' | 'inactive';
+    active_jobs: number;
+    last_execution: LastExecution | null;
+}
+/**
+ * Request body for manual heartbeat trigger
+ */
+export interface TriggerHeartbeatRequest {
+    prompt?: string;
+}
+/**
+ * Response for heartbeat trigger
+ */
+export interface TriggerHeartbeatResponse {
+    execution_id: string;
+    started: boolean;
+}
+/**
+ * API error codes
+ */
+export type ApiErrorCode = 'BAD_REQUEST' | 'NOT_FOUND' | 'VALIDATION_ERROR' | 'JOB_RUNNING' | 'INTERNAL_ERROR';
+/**
+ * API error response
+ */
+export interface ApiErrorResponse {
+    error: string;
+    code?: ApiErrorCode;
+    details?: Record<string, unknown>;
+}
+/**
+ * Custom API error class
+ */
+export declare class ApiError extends Error {
+    readonly statusCode: number;
+    readonly code: ApiErrorCode;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(message: string, statusCode: number, code?: ApiErrorCode, details?: Record<string, unknown> | undefined);
+    toResponse(): ApiErrorResponse;
+}
+/**
+ * Convert internal CronJob to API format
+ */
+export declare function toApiCronJob(job: CronJob): ApiCronJob;
+/**
+ * Convert JobResult to ExecutionLog format
+ */
+export declare function toExecutionLog(id: string, result: JobResult): ExecutionLog;
+//# sourceMappingURL=types.d.ts.map

package/dist/api/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"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"}

package/dist/api/types.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * Type definitions for Heartbeat API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiError = void 0;
+exports.toApiCronJob = toApiCronJob;
+exports.toExecutionLog = toExecutionLog;
+/**
+ * Custom API error class
+ */
+class ApiError extends Error {
+    statusCode;
+    code;
+    details;
+    constructor(message, statusCode, code = 'INTERNAL_ERROR', details) {
+        super(message);
+        this.statusCode = statusCode;
+        this.code = code;
+        this.details = details;
+        this.name = 'ApiError';
+    }
+    toResponse() {
+        return {
+            error: this.message,
+            code: this.code,
+            details: this.details,
+        };
+    }
+}
+exports.ApiError = ApiError;
+// ============================================================================
+// Conversion Utilities
+// ============================================================================
+/**
+ * Convert internal CronJob to API format
+ */
+function toApiCronJob(job) {
+    return {
+        id: job.id,
+        name: job.name,
+        cron_expr: job.cronExpr,
+        prompt: job.prompt,
+        enabled: job.enabled,
+        last_run: job.lastRun ? job.lastRun.getTime() : null,
+        next_run: job.nextRun ? job.nextRun.getTime() : null,
+    };
+}
+/**
+ * Convert JobResult to ExecutionLog format
+ */
+function toExecutionLog(id, result) {
+    return {
+        id,
+        started_at: result.startedAt.getTime(),
+        finished_at: result.completedAt.getTime(),
+        status: result.success ? 'success' : 'failed',
+        output: result.response || null,
+        error: result.error || null,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AA0MH,oCAUC;AAKD,wCASC;AAtDD;;GAEG;AACH,MAAa,QAAS,SAAQ,KAAK;IAGf;IACA;IACA;IAJlB,YACE,OAAe,EACC,UAAkB,EAClB,OAAqB,gBAAgB,EACrC,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,eAAU,GAAV,UAAU,CAAQ;QAClB,SAAI,GAAJ,IAAI,CAAiC;QACrC,YAAO,GAAP,OAAO,CAA0B;QAGjD,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;IAED,UAAU;QACR,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,OAAO;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF;AAlBD,4BAkBC;AAED,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E;;GAEG;AACH,SAAgB,YAAY,CAAC,GAAY;IACvC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,SAAS,EAAE,GAAG,CAAC,QAAQ;QACvB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI;QACpD,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI;KACrD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,EAAU,EAAE,MAAiB;IAC1D,OAAO;QACL,EAAE;QACF,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE;QACtC,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE;QACzC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;QAC7C,MAAM,EAAE,MAAM,CAAC,QAAQ,IAAI,IAAI;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI;KAC5B,CAAC;AACJ,CAAC"}

package/dist/auth/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Auth module - OAuth Token Management for MAMA Standalone
+ */
+export { OAuthManager } from './oauth-manager.js';
+export type { ClaudeCredentialsFile, ClaudeAiOAuth, OAuthToken, TokenRefreshResponse, TokenStatus, OAuthManagerOptions, CachedToken, OAuthErrorCode, } from './types.js';
+export { OAuthError } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,YAAY,EACV,qBAAqB,EACrB,aAAa,EACb,UAAU,EACV,oBAAoB,EACpB,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/auth/index.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Auth module - OAuth Token Management for MAMA Standalone
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OAuthError = exports.OAuthManager = void 0;
+var oauth_manager_js_1 = require("./oauth-manager.js");
+Object.defineProperty(exports, "OAuthManager", { enumerable: true, get: function () { return oauth_manager_js_1.OAuthManager; } });
+var types_js_1 = require("./types.js");
+Object.defineProperty(exports, "OAuthError", { enumerable: true, get: function () { return types_js_1.OAuthError; } });
+//# sourceMappingURL=index.js.map

package/dist/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uDAAkD;AAAzC,gHAAA,YAAY,OAAA;AAarB,uCAAwC;AAA/B,sGAAA,UAAU,OAAA"}

package/dist/auth/oauth-manager.d.ts

@@ -0,0 +1,59 @@
+/**
+ * OAuth Token Manager for MAMA Standalone
+ *
+ * Manages Claude Pro OAuth tokens from ~/.claude/.credentials.json
+ * - Reads tokens from Claude Code credentials file
+ * - Caches tokens with TTL
+ * - Auto-refreshes tokens before expiry
+ * - Writes refreshed tokens back to file
+ */
+import type { TokenStatus, OAuthManagerOptions } from './types.js';
+export declare class OAuthManager {
+    private readonly credentialsPath;
+    private readonly cacheTtlMs;
+    private readonly refreshBufferMs;
+    private readonly fetchFn;
+    private cache;
+    constructor(options?: OAuthManagerOptions);
+    /**
+     * Get a valid access token, refreshing if necessary
+     *
+     * @returns Access token string
+     * @throws OAuthError if token cannot be obtained
+     */
+    getToken(): Promise<string>;
+    /**
+     * Get token status information
+     *
+     * @returns Token status including validity, expiry, and subscription info
+     */
+    getStatus(): Promise<TokenStatus>;
+    /**
+     * Force refresh the token
+     *
+     * @returns New access token
+     * @throws OAuthError if refresh fails
+     */
+    forceRefresh(): Promise<string>;
+    /**
+     * Clear the token cache
+     */
+    clearCache(): void;
+    /**
+     * Check if token needs refresh (expires within buffer time)
+     */
+    private needsRefresh;
+    /**
+     * Read credentials from file
+     */
+    private readCredentials;
+    /**
+     * Refresh the OAuth token
+     */
+    private refreshToken;
+    /**
+     * Write refreshed credentials to file
+     */
+    private writeCredentials;
+}
+//# sourceMappingURL=oauth-manager.d.ts.map

package/dist/auth/oauth-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-manager.d.ts","sourceRoot":"","sources":["../../src/auth/oauth-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAKV,WAAW,EACX,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAkBpB,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IAEvC,OAAO,CAAC,KAAK,CAA4B;gBAE7B,OAAO,GAAE,mBAAwB;IAO7C;;;;;OAKG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IA4CjC;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC;IA4BvC;;;;;OAKG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAerC;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;YACW,eAAe;IAyC7B;;OAEG;YACW,YAAY;IA4C1B;;OAEG;YACW,gBAAgB;CAiC/B"}