memoryblock 0.0.1 → 0.1.1-beta

package/dist/types.d.ts

@@ -0,0 +1,188 @@
+export type BlockStatus = 'SLEEPING' | 'ACTIVE' | 'BUSY' | 'ERROR';
+export interface PulseState {
+    status: BlockStatus;
+    lastRun: string | null;
+    nextWakeUp: string | null;
+    currentTask: string | null;
+    error: string | null;
+}
+export interface AdapterConfig {
+    provider: string;
+    model: string;
+    region: string;
+    maxTokens: number;
+    cacheControl: boolean;
+}
+export interface ToolsConfig {
+    enabled: string[];
+    searchProvider: string;
+    sandbox: boolean;
+    workingDir?: string;
+}
+export interface ChannelConfig {
+    type: string;
+    telegram?: {
+        chatId: string;
+    };
+}
+export interface MemoryConfig {
+    maxContextTokens: number;
+    thresholdPercent: number;
+}
+export interface PulseConfig {
+    intervalSeconds: number;
+}
+export type PermissionScope = 'block' | 'workspace' | 'system';
+export interface PermissionsConfig {
+    scope: PermissionScope;
+    allowShell: boolean;
+    allowNetwork: boolean;
+    maxTimeout: number;
+}
+export interface BlockConfig {
+    name: string;
+    description: string;
+    adapter: AdapterConfig;
+    goals: string[];
+    tools: ToolsConfig;
+    channel: ChannelConfig;
+    memory: MemoryConfig;
+    pulse: PulseConfig;
+    permissions: PermissionsConfig;
+    monitorName?: string;
+    monitorEmoji?: string;
+    /** Persistent flag — blocks with enabled:true auto-start on boot/restart */
+    enabled?: boolean;
+}
+export interface GlobalConfig {
+    language?: string;
+    blocksDir: string;
+    channelAlerts?: boolean;
+    defaults: {
+        adapter: AdapterConfig;
+        memory: MemoryConfig;
+        pulse: PulseConfig;
+    };
+}
+export interface AuthConfig {
+    aws?: {
+        accessKeyId: string;
+        secretAccessKey: string;
+        region: string;
+    };
+    openai?: {
+        apiKey: string;
+    };
+    gemini?: {
+        apiKey: string;
+    };
+    anthropic?: {
+        apiKey: string;
+    };
+    telegram?: {
+        botToken: string;
+        chatId?: string;
+    };
+    brave?: {
+        apiKey: string;
+    };
+}
+export type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
+export interface ToolCall {
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface ToolResultMessage {
+    toolCallId: string;
+    name: string;
+    content: string;
+    isError?: boolean;
+}
+export interface LLMMessage {
+    role: MessageRole;
+    content?: string;
+    toolCalls?: ToolCall[];
+    toolResults?: ToolResultMessage[];
+}
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+}
+export type StopReason = 'end_turn' | 'tool_use' | 'max_tokens' | 'stop_sequence';
+export interface LLMResponse {
+    message: LLMMessage;
+    usage: TokenUsage;
+    stopReason: StopReason;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    requiresApproval: boolean;
+}
+export interface ToolContext {
+    blockPath: string;
+    blockName: string;
+    workingDir: string;
+    workspacePath?: string;
+    sandbox?: boolean;
+    permissions?: PermissionsConfig;
+    dispatchMessage?: (target: string, content: string) => Promise<void>;
+}
+export interface ToolExecutionResult {
+    content: string;
+    isError: boolean;
+}
+export interface ChannelMessage {
+    blockName: string;
+    monitorName: string;
+    content: string;
+    isSystem: boolean;
+    timestamp: string;
+    costReport?: string;
+    sessionReport?: string;
+    totalReport?: string;
+    /** Internal: the channel that originated this message (set by MultiChannelManager). */
+    _sourceChannel?: string;
+    /** Internal: the channel to route this message to (set by sendToChannel). */
+    _targetChannel?: string;
+}
+export interface ApprovalRequest {
+    toolName: string;
+    toolInput: Record<string, unknown>;
+    description: string;
+    blockName: string;
+    monitorName: string;
+}
+export interface LLMAdapter {
+    readonly provider: string;
+    readonly model: string;
+    converse(messages: LLMMessage[], tools?: ToolDefinition[]): Promise<LLMResponse>;
+    converseStream?(messages: LLMMessage[], tools?: ToolDefinition[], onChunk?: (text: string) => void): Promise<LLMResponse>;
+}
+export interface Channel {
+    readonly name: string;
+    send(message: ChannelMessage): Promise<void>;
+    streamChunk?(chunk: string): Promise<void>;
+    onMessage(handler: (message: ChannelMessage) => void): void;
+    requestApproval(request: ApprovalRequest): Promise<boolean>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getActiveChannels?(): string[];
+}
+export interface Tool {
+    readonly definition: ToolDefinition;
+    execute(params: Record<string, unknown>, context: ToolContext): Promise<ToolExecutionResult>;
+}
+/**
+ * Tool Registry interface — defined in core so the engine can use it
+ * without a circular dependency on the tools package.
+ */
+export interface IToolRegistry {
+    listTools(): ToolDefinition[];
+    getDiscoveryTool(): ToolDefinition;
+    execute(name: string, params: Record<string, unknown>, context: ToolContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnE,MAAM,WAAW,UAAU;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAGD,MAAM,WAAW,aAAa;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC;CACL;AAED,MAAM,WAAW,YAAY;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IACxB,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,eAAe,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE;QACN,OAAO,EAAE,aAAa,CAAC;QACvB,MAAM,EAAE,YAAY,CAAC;QACrB,KAAK,EAAE,WAAW,CAAC;KACtB,CAAC;CACL;AAED,MAAM,WAAW,UAAU;IACvB,GAAG,CAAC,EAAE;QACF,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,CAAC,EAAE;QACL,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,CAAC,EAAE;QACL,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,SAAS,CAAC,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,QAAQ,CAAC,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,KAAK,CAAC,EAAE;QACJ,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC;CACL;AAGD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAEnE,MAAM,WAAW,QAAQ;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,UAAU;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,eAAe,CAAC;AAElF,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,UAAU,CAAC;CAC1B;AAGD,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,gBAAgB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE;AAED,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CACpB;AAGD,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uFAAuF;IACvF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACvB;AAGD,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,KAAK,CAAC,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACjF,cAAc,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,KAAK,CAAC,EAAE,cAAc,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC7H;AAED,MAAM,WAAW,OAAO;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,WAAW,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI,CAAC;IAC5D,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,iBAAiB,CAAC,IAAI,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,IAAI;IACjB,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAChG;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B,SAAS,IAAI,cAAc,EAAE,CAAC;IAC9B,gBAAgB,IAAI,cAAc,CAAC;IACnC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC9G"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/config.d.ts

@@ -0,0 +1,24 @@
+import type { GlobalConfig, BlockConfig, AuthConfig, PulseState } from '../types.js';
+export declare function getHome(): string;
+export declare function getWsRoot(): string;
+export declare function getConfigPath(): string;
+export declare function getAuthPath(): string;
+/** Check if memoryblock has been initialized. */
+export declare function isInitialized(): Promise<boolean>;
+/**
+ * Load global config from ~/.memoryblock/ws/config.json
+ */
+export declare function loadGlobalConfig(): Promise<GlobalConfig>;
+export declare function saveGlobalConfig(config: GlobalConfig): Promise<void>;
+/**
+ * Load auth credentials from ~/.memoryblock/ws/auth.json
+ */
+export declare function loadAuth(): Promise<AuthConfig>;
+export declare function saveAuth(auth: AuthConfig): Promise<void>;
+export declare function loadBlockConfig(blockPath: string): Promise<BlockConfig>;
+export declare function saveBlockConfig(blockPath: string, config: BlockConfig): Promise<void>;
+export declare function loadPulseState(blockPath: string): Promise<PulseState>;
+export declare function savePulseState(blockPath: string, state: PulseState): Promise<void>;
+export declare function resolveBlocksDir(globalConfig: GlobalConfig): string;
+export declare function resolveBlockPath(globalConfig: GlobalConfig, blockName: string): string;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACR,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EACpD,MAAM,aAAa,CAAC;AAQrB,wBAAgB,OAAO,IAAI,MAAM,CAA6B;AAC9D,wBAAgB,SAAS,IAAI,MAAM,CAAoB;AACvD,wBAAgB,aAAa,IAAI,MAAM,CAAwB;AAC/D,wBAAgB,WAAW,IAAI,MAAM,CAAsB;AAE3D,iDAAiD;AACjD,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAEtD;AAoBD;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,YAAY,CAAC,CAU9D;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1E;AAGD;;GAEG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,CAGpD;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAGD,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAI7E;AAED,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3F;AAGD,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAI3E;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAExF;AAGD,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAEnE;AAED,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtF"}

package/dist/utils/config.js

@@ -0,0 +1,86 @@
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { readJson, readJsonSafe, writeJson, pathExists } from './fs.js';
+import { GlobalConfigSchema, BlockConfigSchema, AuthConfigSchema, PulseStateSchema, } from '../schemas.js';
+// ===== Paths =====
+const MEMORYBLOCK_HOME = join(homedir(), '.memoryblock');
+const WS_ROOT = join(MEMORYBLOCK_HOME, 'ws');
+const CONFIG_PATH = join(WS_ROOT, 'config.json');
+const AUTH_PATH = join(WS_ROOT, 'auth.json');
+export function getHome() { return MEMORYBLOCK_HOME; }
+export function getWsRoot() { return WS_ROOT; }
+export function getConfigPath() { return CONFIG_PATH; }
+export function getAuthPath() { return AUTH_PATH; }
+/** Check if memoryblock has been initialized. */
+export async function isInitialized() {
+    return pathExists(CONFIG_PATH);
+}
+import { setLocale } from '@memoryblock/locale';
+/**
+ * Wraps Zod schema parsing to provide human-readable errors.
+ */
+function parseConfig(schema, data, filePath) {
+    try {
+        return schema.parse(data);
+    }
+    catch (err) {
+        if (err && err.issues) {
+            const issues = err.issues.map((i) => `  - [${i.path.join('.') || 'root'}]: ${i.message}`).join('\n');
+            throw new Error(`Configuration error in ${filePath}:\n${issues}\n\nPlease fix the file to continue.`);
+        }
+        throw new Error(`Failed to parse ${filePath}: ${err.message}`);
+    }
+}
+// ===== Global Config =====
+/**
+ * Load global config from ~/.memoryblock/ws/config.json
+ */
+export async function loadGlobalConfig() {
+    const raw = await readJsonSafe(CONFIG_PATH, {});
+    const config = parseConfig(GlobalConfigSchema, raw, CONFIG_PATH);
+    // Auto-apply language preference globally
+    if (config.language) {
+        setLocale(config.language);
+    }
+    return config;
+}
+export async function saveGlobalConfig(config) {
+    await writeJson(CONFIG_PATH, config);
+}
+// ===== Auth =====
+/**
+ * Load auth credentials from ~/.memoryblock/ws/auth.json
+ */
+export async function loadAuth() {
+    const raw = await readJsonSafe(AUTH_PATH, {});
+    return parseConfig(AuthConfigSchema, raw, AUTH_PATH);
+}
+export async function saveAuth(auth) {
+    await writeJson(AUTH_PATH, auth);
+}
+// ===== Block Config =====
+export async function loadBlockConfig(blockPath) {
+    const filePath = join(blockPath, 'config.json');
+    const raw = await readJson(filePath);
+    return parseConfig(BlockConfigSchema, raw, filePath);
+}
+export async function saveBlockConfig(blockPath, config) {
+    await writeJson(join(blockPath, 'config.json'), config);
+}
+// ===== Pulse State =====
+export async function loadPulseState(blockPath) {
+    const filePath = join(blockPath, 'pulse.json');
+    const raw = await readJsonSafe(filePath, {});
+    return parseConfig(PulseStateSchema, raw, filePath);
+}
+export async function savePulseState(blockPath, state) {
+    await writeJson(join(blockPath, 'pulse.json'), state);
+}
+// ===== Path Resolution =====
+export function resolveBlocksDir(globalConfig) {
+    return resolve(WS_ROOT, globalConfig.blocksDir);
+}
+export function resolveBlockPath(globalConfig, blockName) {
+    return join(resolveBlocksDir(globalConfig), blockName);
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

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

package/dist/utils/fs.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Write content atomically: write to temp file, then rename.
+ * Prevents corruption if the process crashes mid-write.
+ */
+export declare function atomicWrite(filePath: string, content: string): Promise<void>;
+/** Atomically write JSON with pretty formatting. */
+export declare function writeJson(filePath: string, data: unknown): Promise<void>;
+/** Read and parse JSON. Throws on missing file or invalid JSON. */
+export declare function readJson<T>(filePath: string): Promise<T>;
+/** Read and parse JSON, returning fallback on any error. */
+export declare function readJsonSafe<T>(filePath: string, fallback: T): Promise<T>;
+/** Read text file, returning fallback on any error. */
+export declare function readTextSafe(filePath: string, fallback?: string): Promise<string>;
+/** Ensure directory exists (recursive). */
+export declare function ensureDir(dirPath: string): Promise<void>;
+/** Check if a path exists. */
+export declare function pathExists(targetPath: string): Promise<boolean>;
+//# sourceMappingURL=fs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWlF;AAED,oDAAoD;AACpD,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9E;AAED,mEAAmE;AACnE,wBAAsB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAG9D;AAED,4DAA4D;AAC5D,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAM/E;AAED,uDAAuD;AACvD,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAM3F;AAED,2CAA2C;AAC3C,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,8BAA8B;AAC9B,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOrE"}

package/dist/utils/fs.js

@@ -0,0 +1,65 @@
+import { promises as fsp } from 'node:fs';
+import { dirname } from 'node:path';
+import { randomUUID } from 'node:crypto';
+/**
+ * Write content atomically: write to temp file, then rename.
+ * Prevents corruption if the process crashes mid-write.
+ */
+export async function atomicWrite(filePath, content) {
+    const dir = dirname(filePath);
+    await fsp.mkdir(dir, { recursive: true });
+    const tmpPath = `${filePath}.${randomUUID().slice(0, 8)}.tmp`;
+    try {
+        await fsp.writeFile(tmpPath, content, 'utf-8');
+        await fsp.rename(tmpPath, filePath);
+    }
+    catch (err) {
+        try {
+            await fsp.unlink(tmpPath);
+        }
+        catch { /* ignore cleanup failure */ }
+        throw err;
+    }
+}
+/** Atomically write JSON with pretty formatting. */
+export async function writeJson(filePath, data) {
+    await atomicWrite(filePath, JSON.stringify(data, null, 2) + '\n');
+}
+/** Read and parse JSON. Throws on missing file or invalid JSON. */
+export async function readJson(filePath) {
+    const content = await fsp.readFile(filePath, 'utf-8');
+    return JSON.parse(content);
+}
+/** Read and parse JSON, returning fallback on any error. */
+export async function readJsonSafe(filePath, fallback) {
+    try {
+        return await readJson(filePath);
+    }
+    catch {
+        return fallback;
+    }
+}
+/** Read text file, returning fallback on any error. */
+export async function readTextSafe(filePath, fallback = '') {
+    try {
+        return await fsp.readFile(filePath, 'utf-8');
+    }
+    catch {
+        return fallback;
+    }
+}
+/** Ensure directory exists (recursive). */
+export async function ensureDir(dirPath) {
+    await fsp.mkdir(dirPath, { recursive: true });
+}
+/** Check if a path exists. */
+export async function pathExists(targetPath) {
+    try {
+        await fsp.access(targetPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB,EAAE,OAAe;IAC/D,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9B,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,GAAG,QAAQ,IAAI,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;IAC9D,IAAI,CAAC;QACD,MAAM,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,IAAI,CAAC;YAAC,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,4BAA4B,CAAC,CAAC;QACzE,MAAM,GAAG,CAAC;IACd,CAAC;AACL,CAAC;AAED,oDAAoD;AACpD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAgB,EAAE,IAAa;IAC3D,MAAM,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACtE,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAI,QAAgB;IAC9C,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACtD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;AACpC,CAAC;AAED,4DAA4D;AAC5D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,QAAgB,EAAE,QAAW;IAC/D,IAAI,CAAC;QACD,OAAO,MAAM,QAAQ,CAAI,QAAQ,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,QAAQ,CAAC;IACpB,CAAC;AACL,CAAC;AAED,uDAAuD;AACvD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB,EAAE,WAAmB,EAAE;IACtE,IAAI,CAAC;QACD,OAAO,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,QAAQ,CAAC;IACpB,CAAC;AACL,CAAC;AAED,2CAA2C;AAC3C,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe;IAC3C,MAAM,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,8BAA8B;AAC9B,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAkB;IAC/C,IAAI,CAAC;QACD,MAAM,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC"}

package/package.json

@@ -1,11 +1,85 @@
 {
   "name": "memoryblock",
-  "version": "0.0.1",
-  "description": "placeholder package to reserve the name memoryblock",
+  "version": "0.1.1-beta",
+  "type": "module",
+  "description": "Deploy isolated, multi-agent AI assistants on your local machine with extreme resource efficiency.",
+  "files": [
+    "dist/",
+    "bin/"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "mblk": "./bin/mblk.js",
+    "memoryblock": "./bin/mblk.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch"
+  },
+  "dependencies": {
+    "@memoryblock/daemon": "^0.1.1-beta",
+    "@memoryblock/adapters": "^0.1.1-beta",
+    "@memoryblock/channels": "^0.1.1-beta",
+    "@memoryblock/tools": "^0.1.1-beta",
+    "@memoryblock/api": "^0.1.1-beta",
+    "@memoryblock/web": "^0.1.1-beta",
+    "@memoryblock/locale": "^0.1.1-beta",
+    "@memoryblock/plugin-installer": "^0.1.1-beta",
+    "@memoryblock/plugin-agents": "^0.1.1-beta",
+    "@clack/prompts": "^1.1.0",
+    "commander": "^13.0.0",
+    "chalk": "^5.4.0",
+    "zod": "^3.24.0"
+  },
+  "optionalDependencies": {
+    "@memoryblock/plugin-web-search": "workspace:*"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "memoryblock",
+    "mblk",
+    "ai-agent",
+    "assistants",
+    "agents",
+    "automation",
+    "multi-agent",
+    "agentic-framework",
+    "core",
+    "framework",
+    "interface",
+    "channels",
+    "adapters",
+    "tools",
+    "skills",
+    "local-ai",
+    "local-llm",
+    "openai",
+    "anthropic",
+    "gemini",
+    "groq",
+    "chatgpt",
+    "deepseek",
+    "ollama"
+  ],
+  "author": {
+    "name": "Ghazi",
+    "url": "https://mgks.dev"
+  },
   "repository": {
     "type": "git",
-    "url": "https://github.com/memoryblock/memoryblock"
+    "url": "git+https://github.com/memoryblock-io/memoryblock.git"
+  },
+  "bugs": {
+    "url": "https://github.com/memoryblock-io/memoryblock/issues"
   },
-  "author": "Ghazi Khan <hello@mgks.dev>",
+  "homepage": "https://memoryblock.io",
+  "funding": "https://github.com/sponsors/mgks",
   "license": "MIT"
 }