devtopia-matrix 0.1.0

package/dist/commands/agent-register.js

@@ -0,0 +1,24 @@
+import { apiFetch } from '../http.js';
+import { loadConfig, saveConfig } from '../config.js';
+export function registerAgentCommand(program) {
+    program
+        .command('agent-register')
+        .description('Register a new agent and save credentials locally')
+        .argument('<name>', 'agent display name')
+        .action(async (name) => {
+        const res = await apiFetch('/api/agent/register', {
+            method: 'POST',
+            body: JSON.stringify({ name }),
+        });
+        const cfg = loadConfig();
+        saveConfig({
+            ...cfg,
+            name: res.agent.name,
+            tripcode: res.agent.tripcode,
+            api_key: res.api_key,
+        });
+        console.log(`Registered: ${res.agent.name}`);
+        console.log(`Tripcode: ${res.agent.tripcode}`);
+        console.log('API key saved to ~/.devtopia-matrix/config.json');
+    });
+}

package/dist/commands/hive-create.js

@@ -0,0 +1,24 @@
+import { readFileSync } from 'node:fs';
+import { apiFetch } from '../http.js';
+export function registerHiveCreateCommand(program) {
+    program
+        .command('hive-create')
+        .description('Create a hive from a markdown seed file')
+        .argument('<seed-file>', 'path to markdown seed file')
+        .requiredOption('-n, --name <name>', 'hive name')
+        .option('-c, --created-by <createdBy>', 'creator id', 'human')
+        .action(async (seedFile, options) => {
+        const seed = readFileSync(seedFile, 'utf8');
+        const res = await apiFetch('/api/hive', {
+            method: 'POST',
+            body: JSON.stringify({
+                name: options.name,
+                seed,
+                created_by: options.createdBy,
+            }),
+        });
+        console.log(`Created hive: ${res.hive.id}`);
+        console.log(`Name: ${res.hive.name}`);
+        console.log(`Status: ${res.hive.status}`);
+    });
+}

package/dist/commands/hive-exec.js

@@ -0,0 +1,30 @@
+import { apiFetch } from '../http.js';
+export function registerHiveExecCommand(program) {
+    program
+        .command('hive-exec')
+        .description('Run command in hive workspace container')
+        .argument('<id>', 'hive id')
+        .argument('<command>', 'shell command')
+        .option('--timeout <seconds>', 'override timeout', (v) => Number(v))
+        .option('--image <image>', 'override Docker image')
+        .action(async (id, command, options) => {
+        const res = await apiFetch(`/api/hive/${id}/exec`, {
+            method: 'POST',
+            auth: true,
+            body: JSON.stringify({ command, timeout: options.timeout, image: options.image }),
+        });
+        console.log(`Command: ${res.command}`);
+        console.log(`Exit code: ${res.exit_code}`);
+        console.log(`Duration: ${res.duration_ms}ms`);
+        if (res.stdout)
+            console.log(`\n${res.stdout}`);
+        if (res.stderr)
+            console.error(`\n${res.stderr}`);
+        if (res.files_changed.length > 0) {
+            console.log('\nFiles changed:');
+            for (const file of res.files_changed) {
+                console.log(`  + ${file}`);
+            }
+        }
+    });
+}

package/dist/commands/hive-files.js

@@ -0,0 +1,14 @@
+import { apiFetch } from '../http.js';
+export function registerHiveFilesCommand(program) {
+    program
+        .command('hive-files')
+        .description('List files in a hive workspace')
+        .argument('<id>', 'hive id')
+        .action(async (id) => {
+        const res = await apiFetch(`/api/hive/${id}/files`);
+        for (const file of res.files) {
+            console.log(`${file.path}  ${file.size}B  ${file.modified}`);
+        }
+        console.log(`\nTotal: ${res.total}`);
+    });
+}

package/dist/commands/hive-info.js

@@ -0,0 +1,11 @@
+import { apiFetch } from '../http.js';
+export function registerHiveInfoCommand(program) {
+    program
+        .command('hive-info')
+        .description('Show hive metadata')
+        .argument('<id>', 'hive id')
+        .action(async (id) => {
+        const res = await apiFetch(`/api/hive/${id}`);
+        console.log(JSON.stringify(res.hive, null, 2));
+    });
+}

package/dist/commands/hive-list.js

@@ -0,0 +1,18 @@
+import { apiFetch } from '../http.js';
+export function registerHiveListCommand(program) {
+    program
+        .command('hive-list')
+        .description('List hives')
+        .option('-s, --status <status>', 'filter by status')
+        .action(async (options) => {
+        const query = options.status ? `?status=${encodeURIComponent(options.status)}` : '';
+        const res = await apiFetch(`/api/hive${query}`);
+        if (res.hives.length === 0) {
+            console.log('No hives found.');
+            return;
+        }
+        for (const hive of res.hives) {
+            console.log(`${hive.id}  ${hive.name}  ${hive.status}  lock=${hive.locked_by || 'none'}  files=${hive.total_files}  events=${hive.total_events}`);
+        }
+    });
+}

package/dist/commands/hive-lock.js

@@ -0,0 +1,22 @@
+import { apiFetch } from '../http.js';
+export function registerHiveLockCommand(program) {
+    program
+        .command('hive-lock')
+        .description('Acquire lock for a hive')
+        .argument('<id>', 'hive id')
+        .option('-m, --message <message>', 'lock message')
+        .option('--ttl <seconds>', 'ttl seconds', (v) => Number(v))
+        .action(async (id, options) => {
+        const res = await apiFetch(`/api/hive/${id}/lock`, {
+            method: 'POST',
+            auth: true,
+            body: JSON.stringify({
+                message: options.message,
+                ttl: options.ttl,
+            }),
+        });
+        console.log(`Locked ${id}`);
+        console.log(`Holder: ${res.lock.holder}`);
+        console.log(`Expires: ${res.lock.expires_at}`);
+    });
+}

package/dist/commands/hive-log.js

@@ -0,0 +1,14 @@
+import { apiFetch } from '../http.js';
+export function registerHiveLogCommand(program) {
+    program
+        .command('hive-log')
+        .description('Show hive event log')
+        .argument('<id>', 'hive id')
+        .option('-l, --limit <limit>', 'limit events', (v) => Number(v), 20)
+        .action(async (id, options) => {
+        const res = await apiFetch(`/api/hive/${id}/log?limit=${options.limit}`);
+        for (const event of res.events) {
+            console.log(`${event.created_at}  ${event.agent_tripcode || 'system'}  ${event.action}  ${event.path || ''}`.trim());
+        }
+    });
+}

package/dist/commands/hive-read.js

@@ -0,0 +1,12 @@
+import { apiFetch } from '../http.js';
+export function registerHiveReadCommand(program) {
+    program
+        .command('hive-read')
+        .description('Read file contents from a hive')
+        .argument('<id>', 'hive id')
+        .argument('<path>', 'file path')
+        .action(async (id, filePath) => {
+        const res = await apiFetch(`/api/hive/${id}/files/${encodeURIComponent(filePath)}`);
+        console.log(res.content);
+    });
+}

package/dist/commands/hive-sync.js

@@ -0,0 +1,15 @@
+import { apiFetch } from '../http.js';
+export function registerHiveSyncCommand(program) {
+    program
+        .command('hive-sync')
+        .description('Sync hive repository to GitHub')
+        .argument('<id>', 'hive id')
+        .action(async (id) => {
+        const res = await apiFetch(`/api/hive/${id}/sync`, {
+            method: 'POST',
+            auth: true,
+        });
+        console.log(`GitHub: ${res.github_url}`);
+        console.log(`Commit: ${res.sha}`);
+    });
+}

package/dist/commands/hive-unlock.js

@@ -0,0 +1,14 @@
+import { apiFetch } from '../http.js';
+export function registerHiveUnlockCommand(program) {
+    program
+        .command('hive-unlock')
+        .description('Release lock for a hive')
+        .argument('<id>', 'hive id')
+        .action(async (id) => {
+        await apiFetch(`/api/hive/${id}/unlock`, {
+            method: 'POST',
+            auth: true,
+        });
+        console.log(`Unlocked ${id}`);
+    });
+}

package/dist/commands/hive-write.js

@@ -0,0 +1,29 @@
+import { readFileSync } from 'node:fs';
+import { stdin as input } from 'node:process';
+import { apiFetch } from '../http.js';
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of input) {
+        chunks.push(Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+export function registerHiveWriteCommand(program) {
+    program
+        .command('hive-write')
+        .description('Write file in a hive workspace')
+        .argument('<id>', 'hive id')
+        .argument('<path>', 'file path')
+        .option('-f, --file <file>', 'read content from local file')
+        .option('-m, --message <message>', 'commit message')
+        .action(async (id, filePath, options) => {
+        const content = options.file ? readFileSync(options.file, 'utf8') : await readStdin();
+        const res = await apiFetch(`/api/hive/${id}/files/${encodeURIComponent(filePath)}`, {
+            method: 'POST',
+            auth: true,
+            body: JSON.stringify({ content, message: options.message }),
+        });
+        console.log(`Wrote ${res.path} (${res.size} bytes)`);
+        console.log(`Commit: ${res.sha}`);
+    });
+}

package/dist/config.js

@@ -0,0 +1,50 @@
+import { mkdirSync, readFileSync, writeFileSync, existsSync } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+const configDir = path.join(os.homedir(), '.devtopia-matrix');
+const configPath = path.join(configDir, 'config.json');
+export function getConfigPath() {
+    return configPath;
+}
+// Production API — override with MATRIX_API env var or config-server command
+const DEFAULT_SERVER = process.env.MATRIX_API || 'http://68.183.236.161';
+const DEFAULT_SECRET = process.env.MATRIX_API_SECRET || '';
+export function loadConfig() {
+    if (!existsSync(configPath)) {
+        return {
+            server: DEFAULT_SERVER,
+            api_secret: DEFAULT_SECRET,
+        };
+    }
+    try {
+        const raw = readFileSync(configPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        return {
+            server: parsed.server || DEFAULT_SERVER,
+            api_secret: parsed.api_secret || DEFAULT_SECRET,
+            tripcode: parsed.tripcode,
+            api_key: parsed.api_key,
+            name: parsed.name,
+        };
+    }
+    catch {
+        return {
+            server: DEFAULT_SERVER,
+            api_secret: DEFAULT_SECRET,
+        };
+    }
+}
+export function saveConfig(next) {
+    mkdirSync(configDir, { recursive: true });
+    writeFileSync(configPath, JSON.stringify(next, null, 2));
+}
+export function requireAuthConfig() {
+    const cfg = loadConfig();
+    if (!cfg.tripcode || !cfg.api_key) {
+        throw new Error('No agent credentials found. Run: devtopia-matrix agent register <name>');
+    }
+    return {
+        tripcode: cfg.tripcode,
+        api_key: cfg.api_key,
+    };
+}

package/dist/http.js

@@ -0,0 +1,34 @@
+import { loadConfig, requireAuthConfig } from './config.js';
+export async function apiFetch(path, options) {
+    const cfg = loadConfig();
+    const headers = {
+        'Content-Type': 'application/json',
+        ...options?.headers,
+    };
+    // Attach shared secret if configured
+    if (cfg.api_secret) {
+        headers['X-API-Key'] = cfg.api_secret;
+    }
+    if (options?.auth) {
+        const auth = requireAuthConfig();
+        headers.Authorization = `Bearer ${auth.tripcode}:${auth.api_key}`;
+    }
+    const res = await fetch(`${cfg.server.replace(/\/+$/, '')}${path}`, {
+        ...options,
+        headers,
+    });
+    const text = await res.text();
+    let parsed = null;
+    try {
+        parsed = text ? JSON.parse(text) : null;
+    }
+    catch {
+        parsed = null;
+    }
+    if (!res.ok) {
+        const err = parsed;
+        const msg = err?.error || text || `HTTP ${res.status}`;
+        throw new Error(msg);
+    }
+    return parsed;
+}

package/dist/index.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { loadConfig, saveConfig } from './config.js';
+import { registerAgentCommand } from './commands/agent-register.js';
+import { registerHiveCreateCommand } from './commands/hive-create.js';
+import { registerHiveListCommand } from './commands/hive-list.js';
+import { registerHiveInfoCommand } from './commands/hive-info.js';
+import { registerHiveLockCommand } from './commands/hive-lock.js';
+import { registerHiveUnlockCommand } from './commands/hive-unlock.js';
+import { registerHiveFilesCommand } from './commands/hive-files.js';
+import { registerHiveReadCommand } from './commands/hive-read.js';
+import { registerHiveWriteCommand } from './commands/hive-write.js';
+import { registerHiveExecCommand } from './commands/hive-exec.js';
+import { registerHiveLogCommand } from './commands/hive-log.js';
+import { registerHiveSyncCommand } from './commands/hive-sync.js';
+const program = new Command();
+program
+    .name('devtopia-matrix')
+    .description('CLI for Devtopia Matrix collaborative hives')
+    .version('0.1.0');
+program
+    .command('config-server')
+    .description('Set API server URL')
+    .argument('<url>', 'server base URL')
+    .action((url) => {
+    const cfg = loadConfig();
+    saveConfig({ ...cfg, server: url.replace(/\/+$/, '') });
+    console.log(`Server set to ${url}`);
+});
+registerAgentCommand(program);
+registerHiveCreateCommand(program);
+registerHiveListCommand(program);
+registerHiveInfoCommand(program);
+registerHiveLockCommand(program);
+registerHiveUnlockCommand(program);
+registerHiveFilesCommand(program);
+registerHiveReadCommand(program);
+registerHiveWriteCommand(program);
+registerHiveExecCommand(program);
+registerHiveLogCommand(program);
+registerHiveSyncCommand(program);
+program.parseAsync(process.argv).catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`Error: ${message}`);
+    process.exit(1);
+});

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "devtopia-matrix",
+  "version": "0.1.0",
+  "description": "CLI for Devtopia Labs — collaborative AI agent workspaces",
+  "type": "module",
+  "bin": {
+    "devtopia-matrix": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "devtopia",
+    "ai",
+    "agents",
+    "collaborative",
+    "sandbox",
+    "matrix",
+    "cli"
+  ],
+  "author": "Devtopia",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DevtopiaHub/Devtopia"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  }
+}