@tenphi/akno 0.1.0

package/dist/serve/socket.js

@@ -0,0 +1,311 @@
+import fs from 'node:fs';
+import net from 'node:net';
+import path from 'node:path';
+import { AknoError, COMMAND_NAMES, isCommandName, OPS, WireRequest, createLineDecoder, encodeLine, isOpName, PROTOCOL_VERSION, } from '@tenphi/akno-protocol';
+import { MAINTENANCE_TRANSFORMS, MAINTENANCE_PLAN_STATUSES, } from '@tenphi/akno-core';
+import { AKNO_VERSION } from "../version.js";
+/**
+ * The default door: no port, filesystem permissions are the auth, and it is
+ * the fastest. Newline-delimited JSON over a unix socket, framed by the protocol
+ * package so this file and the client cannot disagree about the wire.
+ */
+export async function serveSocket(akno, socketPath, options = {}) {
+    fs.mkdirSync(path.dirname(socketPath), { recursive: true });
+    // A socket file left behind by a crash blocks bind. The write lock is what
+    // actually prevents two servers, so removing a dead socket is safe here.
+    if (fs.existsSync(socketPath)) {
+        if (await isLive(socketPath)) {
+            throw new AknoError('read_only', `another Akno is already listening on ${socketPath}`);
+        }
+        fs.rmSync(socketPath, { force: true });
+    }
+    const server = net.createServer((socket) => {
+        socket.setNoDelay(true);
+        socket.setEncoding('utf8');
+        const hello = {
+            hello: 'akno',
+            protocol: PROTOCOL_VERSION,
+            version: AKNO_VERSION,
+            writable: akno.writable,
+            akno_path: akno.config.aknoPath,
+            ops: options.allow ?? Object.keys(OPS),
+            commands: [...COMMAND_NAMES],
+        };
+        socket.write(encodeLine(hello));
+        const decode = createLineDecoder();
+        socket.on('data', (chunk) => {
+            for (const raw of decode(chunk)) {
+                void handle(raw, socket, akno, options);
+            }
+        });
+        socket.on('error', () => socket.destroy());
+    });
+    // macOS allows 104 bytes for a socket path, including the terminator. Past that the bind
+    // *succeeds* on a silently truncated name and the chmod below fails with a bare ENOENT stack
+    // trace — which is what a deep `state_dir` produced. Said plainly and up front instead.
+    const pathBytes = Buffer.byteLength(socketPath) + 1;
+    if (pathBytes > 104) {
+        throw new AknoError('invalid', `the socket path is ${pathBytes} bytes and macOS allows 104: ${socketPath}. ` +
+            'Set `server.socket` to an absolute path somewhere shorter, or move `state_dir`.');
+    }
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(socketPath, () => {
+            server.off('error', reject);
+            try {
+                // Owner-only: the socket *is* the authentication boundary. If it cannot be locked
+                // down, the door does not open — a world-readable socket is worse than no socket.
+                fs.chmodSync(socketPath, 0o600);
+            }
+            catch (err) {
+                reject(new AknoError('unavailable', `the socket could not be secured at ${socketPath}: ${err instanceof Error ? err.message : String(err)}`));
+                return;
+            }
+            resolve();
+        });
+    });
+    return {
+        path: socketPath,
+        async close() {
+            await new Promise((resolve) => server.close(() => resolve()));
+            fs.rmSync(socketPath, { force: true });
+        },
+    };
+}
+/**
+ * Operator commands, run by the process that holds the write handle. Input is
+ * shaped by the CLI that sends it; each of these is a small, named bag of options rather than
+ * an op with a schema, which is why they are not in the registry.
+ */
+async function runCommand(akno, command, input) {
+    const options = (input ?? {});
+    switch (command) {
+        case 'index':
+            return akno.index(options);
+        case 'inbox':
+            return akno.inbox(options);
+        case 'dream':
+            return akno.dream(options);
+        case 'approve': {
+            const slug = input?.slug;
+            return akno.approve(idFrom(input, 'proposal_id'), typeof slug === 'string' && slug.length > 0 ? { slug } : {});
+        }
+        case 'decline':
+            return akno.decline(idFrom(input, 'proposal_id'));
+        case 'changes':
+            return akno.changes(limitFrom(input));
+        case 'proposals':
+            return akno.proposals();
+        case 'plan': {
+            const action = stringFrom(input, 'action');
+            switch (action) {
+                case 'list':
+                    return akno.plans(limitFrom(input), planStatusesFrom(input));
+                case 'show':
+                    return akno.plan(idFrom(input, 'plan_id'));
+                case 'diff': {
+                    const item = input?.item_id;
+                    const revision = optionalPositiveInteger(input, 'revision');
+                    return akno.maintenanceDiff(idFrom(input, 'plan_id'), typeof item === 'string' && item.length > 0 ? item : undefined, revision);
+                }
+                case 'revise': {
+                    const relPath = input?.rel_path;
+                    const reason = input?.reason;
+                    if (relPath !== undefined && (typeof relPath !== 'string' || relPath.length === 0)) {
+                        throw new AknoError('invalid', 'rel_path must be a non-empty string');
+                    }
+                    if (reason !== undefined && typeof reason !== 'string') {
+                        throw new AknoError('invalid', 'reason must be a string');
+                    }
+                    return akno.revisePlan(idFrom(input, 'plan_id'), idFrom(input, 'item_id'), {
+                        after: stringFrom(input, 'after'),
+                        ...(typeof relPath === 'string' ? { relPath } : {}),
+                        ...(typeof reason === 'string' ? { reason } : {}),
+                    });
+                }
+                case 'decide': {
+                    const outcome = stringFrom(input, 'outcome');
+                    if (outcome !== 'approve' && outcome !== 'reject') {
+                        throw new AknoError('invalid', 'outcome must be approve or reject');
+                    }
+                    const reason = input?.reason;
+                    const idempotencyKey = optionalStringFrom(input, 'idempotency_key');
+                    return akno.decidePlan(idFrom(input, 'plan_id'), idFrom(input, 'item_id'), outcome, typeof reason === 'string' ? reason : '', idempotencyKey ? { idempotencyKey } : {});
+                }
+                case 'apply': {
+                    const idempotencyKey = optionalStringFrom(input, 'idempotency_key');
+                    return akno.applyPlan(idFrom(input, 'plan_id'), idempotencyKey ? { idempotencyKey } : {});
+                }
+                case 'supersede': {
+                    const reason = input?.reason;
+                    return akno.supersedePlan(idFrom(input, 'plan_id'), typeof reason === 'string' ? reason : undefined);
+                }
+                case 'prune':
+                    return akno.prunePlans({ apply: booleanFrom(input, 'apply', false) });
+                case 'status':
+                    return akno.maintenanceStatus(statusQueryFrom(input));
+                case 'resume': {
+                    const scope = stringFrom(input, 'scope');
+                    if (scope === 'profile')
+                        return akno.resumeMaintenance({ profile: true });
+                    if (!MAINTENANCE_TRANSFORMS.includes(scope)) {
+                        throw new AknoError('invalid', `resume scope must be profile or one of: ${MAINTENANCE_TRANSFORMS.join(', ')}`);
+                    }
+                    return akno.resumeMaintenance({
+                        transform: scope,
+                    });
+                }
+                case 'policy': {
+                    const mode = optionalMaintenanceMode(input);
+                    return akno.maintenancePolicy(stringFrom(input, 'path'), mode);
+                }
+                default:
+                    throw new AknoError('invalid', `unknown plan action: ${action}`);
+            }
+        }
+    }
+}
+function optionalMaintenanceMode(input) {
+    const value = input?.mode;
+    if (value === undefined)
+        return undefined;
+    if (value === 'audit' || value === 'review' || value === 'auto')
+        return value;
+    throw new AknoError('invalid', 'mode must be audit, review, or auto');
+}
+function idFrom(input, key) {
+    const value = input?.[key];
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new AknoError('invalid', `${key} is required`);
+    }
+    return value;
+}
+function stringFrom(input, key) {
+    const value = input?.[key];
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new AknoError('invalid', `${key} is required`);
+    }
+    return value;
+}
+function optionalStringFrom(input, key) {
+    const value = input?.[key];
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new AknoError('invalid', `${key} must be a non-empty string`);
+    }
+    return value;
+}
+function booleanFrom(input, key, fallback) {
+    const value = input?.[key];
+    if (value === undefined)
+        return fallback;
+    if (typeof value !== 'boolean')
+        throw new AknoError('invalid', `${key} must be boolean`);
+    return value;
+}
+function optionalPositiveInteger(input, key) {
+    const value = input?.[key];
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'number' || !Number.isInteger(value) || value < 1) {
+        throw new AknoError('invalid', `${key} must be a positive integer`);
+    }
+    return value;
+}
+function limitFrom(input) {
+    const value = input?.limit;
+    return typeof value === 'number' && Number.isFinite(value) && value > 0 ? Math.floor(value) : 20;
+}
+function planStatusesFrom(input) {
+    const value = input?.status;
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value) ||
+        value.length === 0 ||
+        value.some((status) => typeof status !== 'string' || !MAINTENANCE_PLAN_STATUSES.includes(status))) {
+        throw new AknoError('invalid', `plan status must contain: ${MAINTENANCE_PLAN_STATUSES.join(', ')}`);
+    }
+    return [...new Set(value)];
+}
+function statusQueryFrom(input) {
+    const values = input ?? {};
+    const runId = values.run_id;
+    const last = values.last;
+    const pending = values.pending;
+    const selected = Number(runId !== undefined) + Number(last !== undefined) + Number(pending === true);
+    if (selected > 1)
+        throw new AknoError('invalid', 'choose only one of run_id, last, or pending');
+    if (runId !== undefined && (typeof runId !== 'string' || runId.length === 0)) {
+        throw new AknoError('invalid', 'run_id must be a non-empty string');
+    }
+    if (last !== undefined && (typeof last !== 'number' || !Number.isInteger(last) || last < 1 || last > 100)) {
+        throw new AknoError('invalid', 'last must be an integer from 1 to 100');
+    }
+    if (pending !== undefined && typeof pending !== 'boolean') {
+        throw new AknoError('invalid', 'pending must be boolean');
+    }
+    return {
+        ...(typeof runId === 'string' ? { runId } : {}),
+        ...(typeof last === 'number' ? { last } : {}),
+        ...(pending === true ? { pending: true } : {}),
+    };
+}
+async function handle(raw, socket, akno, options) {
+    let request;
+    try {
+        request = WireRequest.parse(JSON.parse(raw));
+    }
+    catch {
+        socket.write(encodeLine({ id: 0, ok: false, error: { code: 'invalid', message: 'malformed request line' } }));
+        return;
+    }
+    const started = performance.now();
+    try {
+        if (request.kind === 'command') {
+            // Exactly one process holds the write handle, so maintenance that writes has to be
+            // reachable *through* the service rather than racing it.
+            if (!isCommandName(request.op)) {
+                throw new AknoError('invalid', `unknown command: ${request.op}`);
+            }
+            const result = await runCommand(akno, request.op, request.input);
+            options.log?.(`${request.op} ${(performance.now() - started).toFixed(1)}ms`);
+            socket.write(encodeLine({ id: request.id, ok: true, result }));
+            return;
+        }
+        if (!isOpName(request.op)) {
+            throw new AknoError('invalid', `unknown op: ${request.op}`);
+        }
+        // Trust is a parameter, not a property of the transport: the same code
+        // runs with different permissions, so an MCP caller can be denied `forget`
+        // without a second code path that grows its own bugs.
+        if (options.allow && !options.allow.includes(request.op)) {
+            throw new AknoError('forbidden', `${request.op} is not allowed on this door`);
+        }
+        // Honoured because this door is trusted: filesystem permissions are its authentication, and
+        // without it a host mediating for an agent could never answer a gated proposal on the owner's
+        // behalf — the gate would be unanswerable through the door the service is reached by.
+        const result = await akno.call(request.op, request.input, request.actor ? { actor: request.actor } : {});
+        options.log?.(`${request.op} ${(performance.now() - started).toFixed(1)}ms`);
+        socket.write(encodeLine({ id: request.id, ok: true, result }));
+    }
+    catch (err) {
+        const error = AknoError.from(err);
+        options.log?.(`${request.op} ${error.code}: ${error.message}`);
+        socket.write(encodeLine({ id: request.id, ok: false, error: error.toJSON() }));
+    }
+}
+/** A socket nobody is listening on refuses the connection immediately. */
+async function isLive(socketPath) {
+    return new Promise((resolve) => {
+        const probe = net.createConnection(socketPath);
+        const done = (live) => {
+            probe.destroy();
+            resolve(live);
+        };
+        probe.once('connect', () => done(true));
+        probe.once('error', () => done(false));
+        setTimeout(() => done(false), 500);
+    });
+}
+//# sourceMappingURL=socket.js.map

package/dist/serve/socket.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const AKNO_VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,YAAY,QAAmB,CAAC"}

package/dist/version.js

@@ -0,0 +1,15 @@
+import fs from 'node:fs';
+/**
+ * The package manifest is the release authority. Reading it at runtime keeps the CLI, socket/HTTP
+ * handshakes, and MCP server identity on the version that was actually installed; a release bump
+ * therefore has one editable value instead of four easy-to-miss string literals.
+ */
+function packageVersion() {
+    const manifest = JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+    if (typeof manifest.version !== 'string' || manifest.version.length === 0) {
+        throw new Error('the @tenphi/akno package manifest has no version');
+    }
+    return manifest.version;
+}
+export const AKNO_VERSION = packageVersion();
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAMzB;;;;GAIG;AACH,SAAS,cAAc;IACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CACzB,EAAE,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAClD,CAAC;IACrB,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1E,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@tenphi/akno",
+  "version": "0.1.0",
+  "description": "Akno — a two-way memory layer for agents over a Markdown knowledge base",
+  "license": "PolyForm-Noncommercial-1.0.0",
+  "type": "module",
+  "bin": {
+    "akno": "./dist/bin.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3",
+    "@tenphi/akno-client": "0.1.0",
+    "@tenphi/akno-core": "0.1.0",
+    "@tenphi/akno-protocol": "0.1.0"
+  },
+  "os": [
+    "darwin"
+  ],
+  "engines": {
+    "node": ">=22.18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tenphi/akno.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/tenphi/akno#readme",
+  "bugs": {
+    "url": "https://github.com/tenphi/akno/issues"
+  },
+  "author": "Andrey Yamanov",
+  "scripts": {}
+}