memma 0.1.0

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,2CAA2C;AAC3C,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAE1D,MAAM,UAAU,WAAW,CAAC,GAAG,QAAkB;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC;AAC3C,CAAC"}

package/dist/utils/prompts.d.ts

@@ -0,0 +1,4 @@
+export declare const promptLLMProviderSelection: () => Promise<string>;
+export declare const promptLLMProviderAPIKey: (provider: string) => Promise<string>;
+export declare const confirmMemmaReset: () => Promise<boolean>;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/utils/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/utils/prompts.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,0BAA0B,uBAWtC,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAU,UAAU,MAAM,oBAW7D,CAAC;AAEF,eAAO,MAAM,iBAAiB,wBAM7B,CAAC"}

package/dist/utils/prompts.js

@@ -0,0 +1,34 @@
+import { select, confirm, password } from '@inquirer/prompts';
+import { validateAPIKey } from './llm/validateAPIKey.js';
+import { CONFIRM_THEME, PASSWORD_THEME, SELECT_THEME, SUPPORTED_LLMS, } from '../constants.js';
+export const promptLLMProviderSelection = async () => {
+    return await select({
+        message: 'Which LLM provider would you like to use?',
+        choices: Object.entries(SUPPORTED_LLMS).map(([provider, details]) => {
+            return {
+                name: details.display,
+                value: provider,
+            };
+        }),
+        theme: SELECT_THEME,
+    });
+};
+export const promptLLMProviderAPIKey = async (provider) => {
+    return await password({
+        message: `Please enter your ${provider} API key:`,
+        mask: '*',
+        validate: async (key) => {
+            const validKey = await validateAPIKey(provider, key);
+            return validKey ? true : `Not a valid ${provider} API key.`;
+        },
+        theme: PASSWORD_THEME,
+    });
+};
+export const confirmMemmaReset = async () => {
+    return await confirm({
+        message: 'Reset all configurations for Memma?',
+        default: false,
+        theme: CONFIRM_THEME,
+    });
+};
+//# sourceMappingURL=prompts.js.map

package/dist/utils/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/utils/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EACL,aAAa,EACb,cAAc,EACd,YAAY,EACZ,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,IAAI,EAAE;IACnD,OAAO,MAAM,MAAM,CAAC;QAClB,OAAO,EAAE,2CAA2C;QACpD,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,EAAE;YAClE,OAAO;gBACL,IAAI,EAAE,OAAO,CAAC,OAAO;gBACrB,KAAK,EAAE,QAAQ;aAChB,CAAC;QACJ,CAAC,CAAC;QACF,KAAK,EAAE,YAAY;KACpB,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,EAAE,QAAgB,EAAE,EAAE;IAChE,OAAO,MAAM,QAAQ,CAAC;QACpB,OAAO,EAAE,qBAAqB,QAAQ,WAAW;QACjD,IAAI,EAAE,GAAG;QACT,QAAQ,EAAE,KAAK,EAAE,GAAW,EAA0B,EAAE;YACtD,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAErD,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,QAAQ,WAAW,CAAC;QAC9D,CAAC;QACD,KAAK,EAAE,cAAc;KACtB,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,IAAI,EAAE;IAC1C,OAAO,MAAM,OAAO,CAAC;QACnB,OAAO,EAAE,qCAAqC;QAC9C,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,aAAa;KACrB,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/utils/resolveDirectory.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveDirectory(targetDir?: string): string;
+//# sourceMappingURL=resolveDirectory.d.ts.map

package/dist/utils/resolveDirectory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveDirectory.d.ts","sourceRoot":"","sources":["../../src/utils/resolveDirectory.ts"],"names":[],"mappings":"AAKA,wBAAgB,gBAAgB,CAAC,SAAS,GAAE,MAAY,GAAG,MAAM,CAchE"}

package/dist/utils/resolveDirectory.js

@@ -0,0 +1,18 @@
+import path from 'path';
+import os from 'os';
+// Resolves a specified directory to an absolute path
+// Ex: ./todoList -> /Users/FooBar/Projects/todoList
+export function resolveDirectory(targetDir = '.') {
+    // 1. Expand tilde (~)
+    if (targetDir.startsWith('~')) {
+        const home = os.homedir();
+        targetDir = targetDir === '~' ? home : path.join(home, targetDir.slice(2)); // slice removes "~/"
+    }
+    // 2. Return absolute path as-is
+    if (path.isAbsolute(targetDir)) {
+        return path.normalize(targetDir);
+    }
+    // 3. Resolve relative path from current working directory
+    return path.resolve(process.cwd(), targetDir);
+}
+//# sourceMappingURL=resolveDirectory.js.map

package/dist/utils/resolveDirectory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveDirectory.js","sourceRoot":"","sources":["../../src/utils/resolveDirectory.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,qDAAqD;AACrD,oDAAoD;AACpD,MAAM,UAAU,gBAAgB,CAAC,YAAoB,GAAG;IACtD,sBAAsB;IACtB,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;QAC1B,SAAS,GAAG,SAAS,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,qBAAqB;IACnG,CAAC;IAED,gCAAgC;IAChC,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAED,0DAA0D;IAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;AAChD,CAAC"}

package/dist/utils/resolveOrchestratorState.d.ts

@@ -0,0 +1,3 @@
+import type { OrchestratorState } from '../types.js';
+export declare function resolveOrchestratorState(): Promise<OrchestratorState>;
+//# sourceMappingURL=resolveOrchestratorState.d.ts.map

package/dist/utils/resolveOrchestratorState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveOrchestratorState.d.ts","sourceRoot":"","sources":["../../src/utils/resolveOrchestratorState.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CA+B3E"}

package/dist/utils/resolveOrchestratorState.js

@@ -0,0 +1,32 @@
+import { MEMMA_ORCHESTRATOR_PORT } from '../constants.js';
+import { getMemmaConfig } from './config/getMemmaConfig.js';
+import { saveMemmaConfig } from './config/saveMemmaConfig.js';
+import { getPidOnPort } from './getPidOnPort.js';
+export async function resolveOrchestratorState() {
+    const config = await getMemmaConfig();
+    const currentPid = await getPidOnPort(MEMMA_ORCHESTRATOR_PORT); // PID found on port 23224
+    const configPid = config.orchestratorPid; // PID found on memma.config.file
+    // Config and port agree: orchestrator is running as expected
+    if (configPid && currentPid === configPid) {
+        return { state: 'RUNNING', pid: currentPid, config };
+    }
+    // No config PID, but port is active: typically another process is occupying the port
+    if (!configPid && currentPid) {
+        return { state: 'UNKNOWN_RUNNING', pid: currentPid, config };
+    }
+    // Config PID exists and port has a process, but they do not match: unsafe mismatch
+    if (configPid && currentPid && configPid !== currentPid) {
+        delete config.orchestratorPid; // Deletes recorded PID in config file
+        await saveMemmaConfig(config);
+        return { state: 'UNKNOWN_RUNNING', pid: currentPid, config };
+    }
+    // Config claims a PID, but no process is actually running: stale config
+    if (configPid && !currentPid) {
+        delete config.orchestratorPid; // Deletes recorded PID in config file
+        await saveMemmaConfig(config);
+        return { state: 'NOT_RUNNING', pid: null, config };
+    }
+    // Nothing running, no stale config: clean state
+    return { state: 'NOT_RUNNING', pid: null, config };
+}
+//# sourceMappingURL=resolveOrchestratorState.js.map

package/dist/utils/resolveOrchestratorState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveOrchestratorState.js","sourceRoot":"","sources":["../../src/utils/resolveOrchestratorState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,CAAC,KAAK,UAAU,wBAAwB;IAC5C,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAC;IACtC,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,uBAAuB,CAAC,CAAC,CAAC,0BAA0B;IAC1F,MAAM,SAAS,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC,iCAAiC;IAE3E,6DAA6D;IAC7D,IAAI,SAAS,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IACvD,CAAC;IAED,qFAAqF;IACrF,IAAI,CAAC,SAAS,IAAI,UAAU,EAAE,CAAC;QAC7B,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAC/D,CAAC;IAED,mFAAmF;IACnF,IAAI,SAAS,IAAI,UAAU,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QACxD,OAAO,MAAM,CAAC,eAAe,CAAC,CAAC,sCAAsC;QACrE,MAAM,eAAe,CAAC,MAAM,CAAC,CAAC;QAC9B,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAC/D,CAAC;IAED,wEAAwE;IACxE,IAAI,SAAS,IAAI,CAAC,UAAU,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,eAAe,CAAC,CAAC,sCAAsC;QACrE,MAAM,eAAe,CAAC,MAAM,CAAC,CAAC;QAC9B,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACrD,CAAC;IAED,gDAAgD;IAChD,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACrD,CAAC"}

package/dist/utils/typeGuards.d.ts

@@ -0,0 +1,8 @@
+import type { ExecaError } from 'execa';
+import { NotRunningOrchestratorState, OrchestratorState, RunningOrchestratorState } from '../types.js';
+export declare const isExecaError: (err: unknown) => err is ExecaError;
+export declare const isNoProcessFoundError: (err: unknown) => boolean;
+export declare function orchestratorIsRunning(orchestratorState: OrchestratorState): orchestratorState is RunningOrchestratorState;
+export declare function assertOrchestratorIsRunning(orchestratorState: OrchestratorState): asserts orchestratorState is RunningOrchestratorState;
+export declare function assertOrchestratorIsNotRunning(orchestratorState: OrchestratorState): asserts orchestratorState is NotRunningOrchestratorState;
+//# sourceMappingURL=typeGuards.d.ts.map

package/dist/utils/typeGuards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeGuards.d.ts","sourceRoot":"","sources":["../../src/utils/typeGuards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EACL,2BAA2B,EAC3B,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,aAAa,CAAC;AAMrB,eAAO,MAAM,YAAY,GAAI,KAAK,OAAO,KAAG,GAAG,IAAI,UAOlD,CAAC;AAGF,eAAO,MAAM,qBAAqB,GAAI,KAAK,OAAO,YAOjD,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,iBAAiB,EAAE,iBAAiB,GACnC,iBAAiB,IAAI,wBAAwB,CAiB/C;AAED,wBAAgB,2BAA2B,CACzC,iBAAiB,EAAE,iBAAiB,GACnC,OAAO,CAAC,iBAAiB,IAAI,wBAAwB,CAmBvD;AAED,wBAAgB,8BAA8B,CAC5C,iBAAiB,EAAE,iBAAiB,GACnC,OAAO,CAAC,iBAAiB,IAAI,2BAA2B,CAqB1D"}

package/dist/utils/typeGuards.js

@@ -0,0 +1,69 @@
+import { MEMMA_ORCHESTRATOR_PORT } from '../constants.js';
+import { MemmaError } from './MemmaError.js';
+// "execa" package throws error to indicate package not found
+// This type guard checks if the error is from execa and indicates package not found
+export const isExecaError = (err) => {
+    return (err instanceof Error &&
+        'exitCode' in err &&
+        err.exitCode === 1 &&
+        typeof err.exitCode === 'number');
+};
+// lsof exited with code 1 → no process found on port
+export const isNoProcessFoundError = (err) => {
+    return (typeof err === 'object' &&
+        err !== null &&
+        'exitCode' in err &&
+        err.exitCode === 1);
+};
+export function orchestratorIsRunning(orchestratorState) {
+    const { state } = orchestratorState;
+    switch (state) {
+        case 'RUNNING': {
+            return true;
+        }
+        case 'UNKNOWN_RUNNING': {
+            return true;
+        }
+        case 'NOT_RUNNING': {
+            return false;
+        }
+        default: {
+            throw new MemmaError('Unknown orchestrator state.');
+        }
+    }
+}
+export function assertOrchestratorIsRunning(orchestratorState) {
+    const { state, pid } = orchestratorState;
+    switch (state) {
+        case 'RUNNING': {
+            return;
+        }
+        case 'UNKNOWN_RUNNING': {
+            throw new MemmaError(`Port ${MEMMA_ORCHESTRATOR_PORT} in use by another process. Check process #${pid}`);
+        }
+        case 'NOT_RUNNING': {
+            throw new MemmaError('Memma orchestrator server not running');
+        }
+        default: {
+            throw new MemmaError('Unknown orchestrator state.');
+        }
+    }
+}
+export function assertOrchestratorIsNotRunning(orchestratorState) {
+    const { state, pid } = orchestratorState;
+    switch (state) {
+        case 'RUNNING': {
+            throw new MemmaError(`Orchestrator running on port ${MEMMA_ORCHESTRATOR_PORT} - PID #${pid}`);
+        }
+        case 'UNKNOWN_RUNNING': {
+            throw new MemmaError(`Port ${MEMMA_ORCHESTRATOR_PORT} in use by another process. Check process #${pid}`);
+        }
+        case 'NOT_RUNNING': {
+            return;
+        }
+        default: {
+            throw new MemmaError('Unknown orchestrator state.');
+        }
+    }
+}
+//# sourceMappingURL=typeGuards.js.map

package/dist/utils/typeGuards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeGuards.js","sourceRoot":"","sources":["../../src/utils/typeGuards.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,6DAA6D;AAC7D,oFAAoF;AACpF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAY,EAAqB,EAAE;IAC9D,OAAO,CACL,GAAG,YAAY,KAAK;QACpB,UAAU,IAAI,GAAG;QACjB,GAAG,CAAC,QAAQ,KAAK,CAAC;QAClB,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,CACjC,CAAC;AACJ,CAAC,CAAC;AAEF,qDAAqD;AACrD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,GAAY,EAAE,EAAE;IACpD,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,UAAU,IAAI,GAAG;QAChB,GAA6B,CAAC,QAAQ,KAAK,CAAC,CAC9C,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,UAAU,qBAAqB,CACnC,iBAAoC;IAEpC,MAAM,EAAE,KAAK,EAAE,GAAG,iBAAiB,CAAC;IAEpC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,IAAI,UAAU,CAAC,6BAA6B,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,iBAAoC;IAEpC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,iBAAiB,CAAC;IAEzC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,OAAO;QACT,CAAC;QACD,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,MAAM,IAAI,UAAU,CAClB,QAAQ,uBAAuB,8CAA8C,GAAG,EAAE,CACnF,CAAC;QACJ,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,IAAI,UAAU,CAAC,uCAAuC,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,IAAI,UAAU,CAAC,6BAA6B,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,iBAAoC;IAEpC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,iBAAiB,CAAC;IAEzC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,IAAI,UAAU,CAClB,gCAAgC,uBAAuB,WAAW,GAAG,EAAE,CACxE,CAAC;QACJ,CAAC;QACD,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,MAAM,IAAI,UAAU,CAClB,QAAQ,uBAAuB,8CAA8C,GAAG,EAAE,CACnF,CAAC;QACJ,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,IAAI,UAAU,CAAC,6BAA6B,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/utils/wait.d.ts

@@ -0,0 +1,2 @@
+export declare function waitAsyncOperation<T>(callbackFn: (...args: any[]) => Promise<T>, callbackArgs: any[], startMsg: string | ((...args: any[]) => string), endMsg: string | ((result: T) => string)): Promise<T>;
+//# sourceMappingURL=wait.d.ts.map

package/dist/utils/wait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../src/utils/wait.ts"],"names":[],"mappings":"AAGA,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,YAAY,EAAE,GAAG,EAAE,EACnB,QAAQ,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,EAC/C,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC,GACvC,OAAO,CAAC,CAAC,CAAC,CAuBZ"}

package/dist/utils/wait.js

@@ -0,0 +1,22 @@
+import ora from 'ora';
+import { primary } from './logger.js';
+export async function waitAsyncOperation(callbackFn, callbackArgs, startMsg, endMsg) {
+    // Resolve start message if it's a function
+    const startMessage = typeof startMsg === 'function' ? startMsg(...callbackArgs) : startMsg;
+    const spinner = ora(startMessage).start();
+    try {
+        const result = await callbackFn(...callbackArgs);
+        // Resolve end message if it's a function
+        const endMessage = typeof endMsg === 'function' ? endMsg(result) : endMsg;
+        spinner.stopAndPersist({
+            symbol: primary('✔'),
+            text: endMessage,
+        });
+        return result;
+    }
+    catch (err) {
+        spinner.fail('Operation failed');
+        throw err;
+    }
+}
+//# sourceMappingURL=wait.js.map

package/dist/utils/wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.js","sourceRoot":"","sources":["../../src/utils/wait.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAA0C,EAC1C,YAAmB,EACnB,QAA+C,EAC/C,MAAwC;IAExC,2CAA2C;IAC3C,MAAM,YAAY,GAChB,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAExE,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,KAAK,EAAE,CAAC;IAE1C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,YAAY,CAAC,CAAC;QAEjD,yCAAyC;QACzC,MAAM,UAAU,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAE1E,OAAO,CAAC,cAAc,CAAC;YACrB,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC;YACpB,IAAI,EAAE,UAAU;SACjB,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACjC,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "memma",
+  "version": "0.1.0",
+  "description": "Visual-to-Code CLI Tool",
+  "keywords": [
+    "cli",
+    "codegen",
+    "ai",
+    "agent",
+    "visual-to-code"
+  ],
+  "main": "./dist/cli.js",
+  "bin": {
+    "memma": "./dist/cli.js"
+  },
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "start": "ts-node src/cli.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "python"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.65.0",
+    "@inquirer/prompts": "^7.8.6",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.1",
+    "eventsource-parser": "^3.0.6",
+    "execa": "^9.6.0",
+    "fs-extra": "^11.3.2",
+    "gradient-string": "^3.0.0",
+    "openai": "^6.2.0",
+    "ora": "^9.0.0",
+    "semver": "^7.7.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/6207als/memma"
+  },
+  "devDependencies": {
+    "@types/commander": "^2.12.0",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^24.5.0",
+    "@types/semver": "^7.7.1",
+    "@typescript-eslint/eslint-plugin": "^8.44.0",
+    "@typescript-eslint/parser": "^8.44.0",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.6.2",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.2"
+  }
+}

package/python/agents/coordinator_agent.py

@@ -0,0 +1,28 @@
+from utils.llm_loader import llm
+
+from tools.generate_components import generate_components_tool
+from tools.inspect_site import take_screenshot_tool
+
+def create_coordinator_agent():
+    """
+    Creates the coordinator agent that decides workflow steps.
+    This agent ONLY reasons about what to do next.
+    """
+    system_prompt = """You are a workflow coordinator for Memma, a website replication system.
+
+Your job is to analyze the user's request, decide which tool should be called, and call it.
+
+Determine which of the following tools should be called and call it:
+- take_screenshot_tool(url) if you need to capture a website screenshot
+- generate_components_tool() if you have a screenshot and need to generate code
+
+Otherwise, say "DONE" if the  task is complete.
+
+You do NOT generate components or analyze screenshots yourself. You only call the tools."""
+
+    llm_with_tools = llm.bind_tools(
+        [take_screenshot_tool, generate_components_tool],
+        tool_choice="auto"  # Let model decide
+    )
+    
+    return llm_with_tools, system_prompt

package/python/agents/generator_agent.py

@@ -0,0 +1,7 @@
+from utils.llm_loader import llm
+
+def create_generator_agent():
+    """
+    Creates a specialist agent for component generation.
+    """
+    return llm

package/python/generate/generate_from_url.py

@@ -0,0 +1,53 @@
+from graphs.memma_graph import create_memma_graph
+from states.memma_state import MemmaState
+from utils.encode_base64 import encode_to_base64_from_path
+from utils.prompts import generate_main_prompt
+from schemas.types import GenerateRequestOptions
+from typing import AsyncGenerator, Any, Union
+
+async def generate_from_url(url: str, options: GenerateRequestOptions) -> AsyncGenerator[Union[str, dict[str, Any]], None]:
+    """
+    Execute the coordinator-specialist workflow.
+    
+    Args:
+        url: URL (or image file path) of website to replicate
+        prompt: Optional custom prompt
+        
+    Returns:
+        List of generated components
+    """
+
+    image_data = None
+
+    if options.localFile:
+        image_data = encode_to_base64_from_path(url)
+    
+    # Create the graph / Future: persist graph instance between calls
+    graph = create_memma_graph()
+
+    # Initial state
+    initial_state = MemmaState({
+        "original_prompt": generate_main_prompt(url),
+        "url": url,
+        "next_action": "start",
+        "image_data": image_data,
+        "messages": [],
+        "components": []
+    })
+
+    final_state = None
+
+    async for mode, chunk in graph.astream(initial_state, stream_mode=["custom", "values"]):
+        # yield progress/status updates as they come
+        if mode == 'values':
+            final_state = chunk
+        elif mode == 'custom':
+            yield chunk
+
+    # Graph reached END → emit final "done" event
+    yield {
+        "event": "done",
+        "message": "Workflow completed successfully.",
+        "llmResponse": final_state["components"] # type: ignore
+    }
+

package/python/graphs/memma_graph.py

@@ -0,0 +1,46 @@
+from langgraph.graph import StateGraph, END
+from states.memma_state import MemmaState, ActionState
+from nodes.coordinator_node import coordinator_node
+from nodes.screenshot_node import screenshot_node
+from nodes.generate_node import generator_node
+
+def router(state: MemmaState) -> ActionState:
+    """
+    Routes to the appropriate specialist based on coordinator's decision.
+    """
+    return state["next_action"]
+
+
+def create_memma_graph():
+    """
+    Creates the LangGraph workflow with coordinator-specialist pattern.
+    
+    Graph flow:
+    Entry → Coordinator → Router → Specialist → Coordinator → ... → END
+    """
+    workflow = StateGraph(MemmaState)
+    
+    # Add nodes
+    workflow.add_node("coordinator", coordinator_node)
+    workflow.add_node("take_screenshot", screenshot_node)
+    workflow.add_node("generate_components", generator_node)
+    
+    # Entry point
+    workflow.set_entry_point("coordinator")
+    
+    # Coordinator routes to tools/agents or finishes
+    workflow.add_conditional_edges(
+        "coordinator",
+        router,
+        {
+            "take_screenshot": "take_screenshot",
+            "generate_components": "generate_components",
+            "finish": END
+        }
+    )
+    
+    # After each tool, go back to coordinator to determine next steps
+    workflow.add_edge("take_screenshot", "coordinator")
+    workflow.add_edge("generate_components", "coordinator")
+    
+    return workflow.compile()

package/python/main.py

@@ -0,0 +1,75 @@
+# type: ignore
+
+import datetime
+from pathlib import Path
+
+from fastapi import FastAPI 
+from fastapi.responses import StreamingResponse
+from pydantic import BaseModel
+import traceback
+import uvicorn
+import json
+import sys
+
+from schemas.types import GenerateRequestOptions
+from generate.generate_from_url import generate_from_url
+
+app = FastAPI()
+
+# Request Model
+class GenerateRequest(BaseModel):
+    url: str        # URL or local file path
+    options: GenerateRequestOptions
+
+class GenerateResponse(BaseModel):
+    success: bool
+    llmResponse: str
+    message: str = None
+
+@app.post("/generate", response_model=GenerateResponse)
+async def generate_components(req: GenerateRequest):
+    """
+    Generate React components of a UI using a lightweight multi-agent workflow.
+
+    The system primarily uses coordinator-specialist pattern:
+    1. Coordinator agent decides which tools/node to call: screenshot_node or generate_node
+    2. Screenshot node captures the website
+    3. Generator nodes creates components using screenshot data and clean context
+    """
+
+    async def event_stream():
+        stream_finished = False
+        try:
+            # Iterate over each chunk yielded by the async generator
+            async for update in generate_from_url(req.url, req.options):
+                # Send chunk as SSE
+                yield f"event: event\ndata: {json.dumps(update)}\n\n"
+
+            # Fallback: yield a final "done" signal (if generate_from_url doesn’t do it)
+                if update.get("event") == "done":
+                    stream_finished = True
+
+        except Exception as e:
+            tb = traceback.format_exc()
+            error_payload = {
+                "event": "error",
+                "message": str(e),
+                "traceback": tb,
+            }
+            yield f"data: {json.dumps(error_payload)}\n\n"
+
+        finally:
+            # Fallback if "done" event isn't sent
+            if not stream_finished:
+                yield "event: event\ndata: {\"event\": \"done\"}\n\n"
+
+    # Return streaming response with text/event-stream media type
+    return StreamingResponse(event_stream(), media_type="text/event-stream")
+
+@app.get("/health")
+def health_check():
+    return {"status": "healthy"}
+
+if __name__ == "__main__":
+    port = int(sys.argv[1]) if len(sys.argv) > 1 else 5000
+    uvicorn.run(app, host="127.0.0.1", port=port)

package/python/nodes/coordinator_node.py

@@ -0,0 +1,89 @@
+from agents.coordinator_agent import create_coordinator_agent
+from langgraph.config import get_stream_writer
+from langchain_core.messages import AIMessage
+from states.memma_state import MemmaState
+
+def coordinator_node(state: MemmaState) -> MemmaState:
+    """
+    Coordinator node that analyzes state and decides next action.
+    """
+    # initialize StreamWriter if graph is configured to stream
+    writer = get_stream_writer()
+    
+    coordinator, system_prompt = create_coordinator_agent()
+    
+    # Build status message
+    has_image = bool(state.get('image_data'))
+    has_components = bool(state.get('components'))
+    
+    status = f"""Task: {state['original_prompt']}
+URL: {state.get('url', 'Not provided')}
+
+Current Status:
+- Screenshot: {'Has been captured' if has_image else 'Not yet captured'}
+- Components: {'Have been generated' if has_components else 'Not yet generated'}
+
+What should we do next?"""
+    
+    if writer:
+        writer({
+            "event": "status",
+            "task": "reasoning",
+            "progress": "in progress",
+            "message": "Thinking..."
+        })
+
+    result = coordinator.invoke([
+        {"role": "system", "content": system_prompt},
+        {"role": "user", "content": status}
+    ])
+    
+    # Check which tool has been called, update "next_action" graph state appropriately
+    if isinstance(result, AIMessage) and result.tool_calls:
+        tool_call = result.tool_calls[0]
+
+        if tool_call['name'] == 'take_screenshot_tool':
+            url = tool_call['args'].get('url') or state.get('url')
+            
+            if writer:
+                writer({
+                    "event": "status",
+                    "task": "reasoning",
+                    "progress": "complete",
+                    "message": "Decision: Take screenshot of website"
+                })
+
+            return {
+                **state,
+                "next_action": "take_screenshot",
+                "url": url
+            }
+        
+        elif tool_call['name'] == 'generate_components_tool':
+
+            if writer:
+                writer({
+                    "event": "status",
+                    "task": "reasoning",
+                    "progress": "complete",
+                    "message": "Decision: Generate components"
+                })
+
+            return {
+                **state,
+                "next_action": "generate_components"
+            }
+    
+    # No tool call means we're done
+    if writer:
+        writer({
+            "event": "status",
+            "task": "reasoning",
+            "progress": "complete",
+            "message": "Finished"
+        })
+
+    return {
+        **state,
+        "next_action": "finish"
+    }