dsh-env-manager-plugin 0.0.0-stage → 0.1.0

package/lib/storage/records.js

@@ -0,0 +1,112 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import YAML from 'yaml';
+import { LIMITS } from '../domain/constants.js';
+import { EnvManagerError } from '../domain/errors.js';
+import { backupDir, kindDir, resolveRecordPath } from './paths.js';
+import { rotateBackup, serialize, writeTextAtomic } from './atomic.js';
+export function parseYamlText(text, file) {
+    let document;
+    try {
+        document = YAML.parseDocument(text, { strict: true, uniqueKeys: true });
+    }
+    catch (error) {
+        throw new EnvManagerError('RECORD_INVALID', `Invalid YAML${file ? ` in ${file}` : ''}`, {
+            file,
+            reason: error instanceof Error ? error.message : String(error),
+        });
+    }
+    if (document.errors.length > 0) {
+        throw new EnvManagerError('RECORD_INVALID', `Invalid YAML${file ? ` in ${file}` : ''}`, {
+            file,
+            issues: document.errors.map((issue) => issue.message),
+        });
+    }
+    let value;
+    try {
+        value = document.toJS({ maxAliasCount: 100 });
+    }
+    catch (error) {
+        throw new EnvManagerError('RECORD_INVALID', `Invalid YAML${file ? ` in ${file}` : ''}`, {
+            file,
+            reason: error instanceof Error ? error.message : String(error),
+        });
+    }
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw new EnvManagerError('RECORD_INVALID', 'Record document must be an object', { file });
+    }
+    return value;
+}
+export function stringifyRecord(record) {
+    return YAML.stringify(record, { lineWidth: 0, sortMapEntries: false });
+}
+export async function readRecordRaw(dataDir, kind, id) {
+    const target = resolveRecordPath(dataDir, kind, id);
+    let text;
+    try {
+        text = await fs.readFile(target, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return { found: false };
+        throw error;
+    }
+    return { found: true, text, raw: parseYamlText(text, target), bytes: Buffer.byteLength(text) };
+}
+export async function writeRecordFile(dataDir, kind, record) {
+    const target = resolveRecordPath(dataDir, kind, record.id);
+    const text = stringifyRecord(record);
+    const bytes = Buffer.byteLength(text, 'utf8');
+    if (bytes > LIMITS.recordBytes) {
+        throw new EnvManagerError('RECORD_TOO_LARGE', `Record ${record.id} is ${bytes} bytes; the limit is ${LIMITS.recordBytes}`, { kind, id: record.id, bytes });
+    }
+    await serialize(target, async () => {
+        await rotateBackup(target, backupDir(dataDir, kind, record.id), 'yaml');
+        await writeTextAtomic(target, text);
+    });
+}
+export async function deleteRecordFile(dataDir, kind, id) {
+    const target = resolveRecordPath(dataDir, kind, id);
+    await serialize(target, async () => {
+        await rotateBackup(target, backupDir(dataDir, kind, id), 'yaml');
+        try {
+            await fs.unlink(target);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                throw error;
+        }
+    });
+}
+export async function listRecordIds(dataDir, kind) {
+    let entries;
+    try {
+        entries = await fs.readdir(kindDir(dataDir, kind));
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return [];
+        throw error;
+    }
+    return entries
+        .filter((entry) => entry.endsWith('.yaml'))
+        .map((entry) => entry.slice(0, -'.yaml'.length))
+        .filter((id) => /^[a-z0-9][a-z0-9-]{0,62}$/.test(id))
+        .sort();
+}
+export function fileForRecord(dataDir, kind, id) {
+    return resolveRecordPath(dataDir, kind, id);
+}
+export async function recordExists(dataDir, kind, id) {
+    try {
+        await fs.access(resolveRecordPath(dataDir, kind, id));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function relativeFile(dataDir, target) {
+    return path.relative(dataDir, target).replaceAll(path.sep, '/');
+}
+//# sourceMappingURL=records.js.map

package/lib/storage/records.js.map

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

package/lib/storage/sessions.d.ts

@@ -0,0 +1,17 @@
+export interface StoredSession {
+    schemaVersion: 1;
+    sessionId: string;
+    defaultEnvironmentId: string | null;
+    updatedAt: string;
+}
+export type SessionRead = {
+    status: 'missing';
+} | {
+    status: 'ok';
+    value: StoredSession;
+} | {
+    status: 'corrupt';
+    reason: string;
+};
+export declare function readSessionFile(dataDir: string, sessionId: string): Promise<SessionRead>;
+export declare function writeSessionFile(dataDir: string, sessionId: string, defaultEnvironmentId: string | null): Promise<StoredSession>;

package/lib/storage/sessions.js

@@ -0,0 +1,65 @@
+import { promises as fs } from 'node:fs';
+import { LIMITS } from '../domain/constants.js';
+import { sessionBackupDir, sessionPath } from './paths.js';
+import { rotateBackup, serialize, writeTextAtomic } from './atomic.js';
+export async function readSessionFile(dataDir, sessionId) {
+    const target = sessionPath(dataDir, sessionId);
+    let text;
+    try {
+        text = await fs.readFile(target, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return { status: 'missing' };
+        return { status: 'corrupt', reason: error.message };
+    }
+    if (Buffer.byteLength(text, 'utf8') > LIMITS.sessionBytes) {
+        return { status: 'corrupt', reason: 'session file exceeds 64 KiB' };
+    }
+    try {
+        const value = JSON.parse(text);
+        if (value.schemaVersion !== 1 || typeof value.sessionId !== 'string') {
+            return { status: 'corrupt', reason: 'unsupported session schema' };
+        }
+        const defaultEnvironmentId = value.defaultEnvironmentId === null || typeof value.defaultEnvironmentId === 'string'
+            ? value.defaultEnvironmentId
+            : undefined;
+        if (defaultEnvironmentId === undefined) {
+            return { status: 'corrupt', reason: 'defaultEnvironmentId must be string or null' };
+        }
+        if (value.sessionId !== sessionId) {
+            return { status: 'corrupt', reason: 'sessionId does not match the file name' };
+        }
+        return {
+            status: 'ok',
+            value: {
+                schemaVersion: 1,
+                sessionId,
+                defaultEnvironmentId,
+                updatedAt: typeof value.updatedAt === 'string' ? value.updatedAt : new Date().toISOString(),
+            },
+        };
+    }
+    catch (error) {
+        return { status: 'corrupt', reason: error.message };
+    }
+}
+export async function writeSessionFile(dataDir, sessionId, defaultEnvironmentId) {
+    const value = {
+        schemaVersion: 1,
+        sessionId,
+        defaultEnvironmentId,
+        updatedAt: new Date().toISOString(),
+    };
+    const text = JSON.stringify(value, null, 2) + '\n';
+    if (Buffer.byteLength(text, 'utf8') > LIMITS.sessionBytes) {
+        throw new Error('session context exceeds 64 KiB');
+    }
+    const target = sessionPath(dataDir, sessionId);
+    await serialize(target, async () => {
+        await rotateBackup(target, sessionBackupDir(dataDir, sessionId), 'json');
+        await writeTextAtomic(target, text);
+    });
+    return value;
+}
+//# sourceMappingURL=sessions.js.map

package/lib/storage/sessions.js.map

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

package/lib/tools/tools.d.ts

@@ -0,0 +1,14 @@
+import { type ToolDefinition } from '@deepseek-ai/dsh-tools';
+import { App } from '../app/app.js';
+export interface ToolRuntimeOptions {
+    ctx: any;
+    app: App;
+    defaults: {
+        environmentId?: string;
+    };
+    writePolicy: {
+        requireApprovalForDelete: boolean;
+        requireApprovalForProductionSave: boolean;
+    };
+}
+export declare function createToolDefinitions(options: ToolRuntimeOptions): ToolDefinition[];