@aitne/daemon 0.1.0

package/dist/api/routes/commands.js

@@ -0,0 +1,251 @@
+import { existsSync, readdirSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { Hono } from "hono";
+import { z } from "zod";
+import { isBackendId } from "@aitne/shared";
+import { createDefaultBangCommandRegistry, createUserBangCommand, DEFAULT_USER_BANG_COMMAND_SKILLS, deleteUserBangCommand, getUserBangCommandByCommand, getUserBangCommandById, listUserBangCommands, normalizeBangCommandName, updateUserBangCommand, USER_BANG_COMMAND_NAME_PATTERN, } from "../../core/bang-commands/index.js";
+import { getModelsForBackend } from "../../core/backends/model-registry.js";
+const SKILL_SLUG_PATTERN = /^[a-z][a-z0-9-]*$/;
+const MAX_INSTRUCTION_MD_LENGTH = 32_000;
+const userCommandSchema = z.object({
+    name: z.string().min(1).max(33),
+    description: z.string().max(160).optional().default(""),
+    prompt: z.string().trim().min(1).max(8000),
+    backendId: z.string().refine(isBackendId),
+    modelId: z.string().trim().min(1).max(200),
+    enabled: z.boolean().optional().default(true),
+    // Per-command skill selection. `null` keeps the legacy default (notify).
+    // An empty array means "no skills" — the agent runs with safety + character
+    // + custom instructions only. Undefined is treated the same as null for
+    // backward-compatible PUT requests from older clients.
+    enabledSkills: z
+        .array(z.string().regex(SKILL_SLUG_PATTERN))
+        .nullable()
+        .optional(),
+    // Custom CLAUDE.md / AGENTS.md / GEMINI.md profile body. Empty/whitespace
+    // is normalised to null at the storage layer.
+    instructionMd: z
+        .string()
+        .max(MAX_INSTRUCTION_MD_LENGTH)
+        .nullable()
+        .optional(),
+});
+/**
+ * Enumerate the daemon's built-in skill slugs from disk. A directory only
+ * counts when it both:
+ *  - matches the strict-kebab slug pattern (defends against accidental
+ *    dotfiles, scratch dirs, or path-traversal-shaped names), AND
+ *  - contains a `SKILL.md` (the file the SDK actually loads).
+ *
+ * The materializer skips dirs without `SKILL.md` silently, so without
+ * this filter a half-authored skill would show up in the dashboard's
+ * checkbox grid and the user could "enable" something that has no
+ * effect at runtime.
+ */
+function listAvailableBuiltinSkillSlugs(workspaceDir) {
+    const root = resolve(workspaceDir, "agent-assets", "skills");
+    if (!existsSync(root))
+        return new Set();
+    const slugs = new Set();
+    for (const entry of readdirSync(root, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        if (!SKILL_SLUG_PATTERN.test(entry.name))
+            continue;
+        if (!existsSync(join(root, entry.name, "SKILL.md")))
+            continue;
+        slugs.add(entry.name);
+    }
+    return slugs;
+}
+export function createCommandsRoutes(deps) {
+    const app = new Hono();
+    const { db, config } = deps;
+    const builtInRegistry = createDefaultBangCommandRegistry();
+    const reservedCommands = new Set(builtInRegistry.list().map((cmd) => cmd.name));
+    const workspaceDir = config.workspaceDir ?? process.cwd();
+    // Capture the available skill slug list once at server boot — this set
+    // ships with the daemon and never changes at runtime, so we don't need
+    // a per-request stat. The validator below rejects unknown slugs so the
+    // dashboard can surface "skill X doesn't exist" before saving.
+    const availableSkillSlugs = listAvailableBuiltinSkillSlugs(workspaceDir);
+    function serialize() {
+        return {
+            builtInCommands: builtInRegistry.list().map((cmd) => ({
+                command: cmd.name,
+                name: cmd.name.startsWith("!") ? cmd.name.slice(1) : cmd.name,
+                title: cmd.title ?? cmd.name,
+                description: cmd.describe,
+                details: cmd.details ?? [],
+                kind: "built_in",
+                enabled: true,
+                runsBackend: false,
+                availableWhilePaused: true,
+            })),
+            userCommands: listUserBangCommands(db),
+            constraints: {
+                namePattern: USER_BANG_COMMAND_NAME_PATTERN.source,
+                maxPromptLength: 8000,
+                maxInstructionMdLength: MAX_INSTRUCTION_MD_LENGTH,
+                reservedCommands: [...reservedCommands],
+                availableSkills: [...availableSkillSlugs].sort(),
+                defaultSkills: [...DEFAULT_USER_BANG_COMMAND_SKILLS],
+            },
+        };
+    }
+    function parseId(raw) {
+        const id = Number(raw);
+        return Number.isInteger(id) && id > 0 ? id : null;
+    }
+    function validateInput(body, options = {}) {
+        const parsed = userCommandSchema.safeParse(body);
+        if (!parsed.success) {
+            return {
+                ok: false,
+                status: 400,
+                body: { error: "validation_error", details: parsed.error.flatten() },
+            };
+        }
+        const normalized = normalizeBangCommandName(parsed.data.name);
+        if (!normalized.ok) {
+            return {
+                ok: false,
+                status: 400,
+                body: {
+                    error: "invalid_command_name",
+                    message: "Command names may contain lowercase letters, numbers, hyphens, and underscores.",
+                },
+            };
+        }
+        if (reservedCommands.has(normalized.command)) {
+            return {
+                ok: false,
+                status: 409,
+                body: {
+                    error: "reserved_command",
+                    message: `${normalized.command} is a built-in command.`,
+                },
+            };
+        }
+        const existing = getUserBangCommandByCommand(db, normalized.command);
+        if (existing && existing.id !== options.existingId) {
+            return {
+                ok: false,
+                status: 409,
+                body: {
+                    error: "duplicate_command",
+                    message: `${normalized.command} is already configured.`,
+                },
+            };
+        }
+        const backendId = parsed.data.backendId;
+        const modelKnown = getModelsForBackend(backendId).some((model) => model.modelId === parsed.data.modelId && model.available);
+        if (!modelKnown) {
+            return {
+                ok: false,
+                status: 400,
+                body: {
+                    error: "invalid_model",
+                    message: `Model ${parsed.data.modelId} is not available for ${backendId}.`,
+                },
+            };
+        }
+        // Skill slugs are optional — undefined / null both leave the column at
+        // SQL NULL (legacy default). When the array is provided, every slug must
+        // resolve to a real skill on disk; otherwise the materializer would
+        // silently drop it and the user would have no signal that their pick
+        // didn't take effect.
+        let normalizedSkills;
+        if (parsed.data.enabledSkills === undefined) {
+            normalizedSkills = undefined;
+        }
+        else if (parsed.data.enabledSkills === null) {
+            normalizedSkills = null;
+        }
+        else {
+            const cleaned = parsed.data.enabledSkills.map((slug) => slug.trim());
+            const unknown = cleaned.filter((slug) => !availableSkillSlugs.has(slug));
+            if (unknown.length > 0) {
+                return {
+                    ok: false,
+                    status: 400,
+                    body: {
+                        error: "invalid_skill_slug",
+                        message: `Unknown skill slug(s): ${unknown.join(", ")}.`,
+                    },
+                };
+            }
+            normalizedSkills = Array.from(new Set(cleaned));
+        }
+        return {
+            ok: true,
+            input: {
+                name: normalized.name,
+                description: parsed.data.description,
+                prompt: parsed.data.prompt,
+                backendId,
+                modelId: parsed.data.modelId,
+                enabled: parsed.data.enabled,
+                enabledSkills: normalizedSkills,
+                instructionMd: parsed.data.instructionMd ?? null,
+            },
+        };
+    }
+    app.get("/commands", (c) => c.json(serialize()));
+    app.post("/commands", async (c) => {
+        const body = await c.req.json().catch(() => null);
+        const validated = validateInput(body);
+        if (!validated.ok) {
+            return c.json(validated.body, validated.status);
+        }
+        try {
+            createUserBangCommand(db, validated.input);
+        }
+        catch (err) {
+            if (err instanceof Error && /UNIQUE/.test(err.message)) {
+                return c.json({ error: "duplicate_command" }, 409);
+            }
+            throw err;
+        }
+        return c.json(serialize(), 201);
+    });
+    app.put("/commands/:id", async (c) => {
+        const id = parseId(c.req.param("id"));
+        if (id === null) {
+            return c.json({ error: "invalid_id" }, 400);
+        }
+        if (!getUserBangCommandById(db, id)) {
+            return c.json({ error: "not_found" }, 404);
+        }
+        const body = await c.req.json().catch(() => null);
+        const validated = validateInput(body, { existingId: id });
+        if (!validated.ok) {
+            return c.json(validated.body, validated.status);
+        }
+        try {
+            const updated = updateUserBangCommand(db, id, validated.input);
+            if (!updated) {
+                return c.json({ error: "not_found" }, 404);
+            }
+        }
+        catch (err) {
+            if (err instanceof Error && /UNIQUE/.test(err.message)) {
+                return c.json({ error: "duplicate_command" }, 409);
+            }
+            throw err;
+        }
+        return c.json(serialize());
+    });
+    app.delete("/commands/:id", (c) => {
+        const id = parseId(c.req.param("id"));
+        if (id === null) {
+            return c.json({ error: "invalid_id" }, 400);
+        }
+        if (!deleteUserBangCommand(db, id)) {
+            return c.json({ error: "not_found" }, 404);
+        }
+        return c.json(serialize());
+    });
+    return app;
+}
+//# sourceMappingURL=commands.js.map

package/dist/api/routes/commands.js.map

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

package/dist/api/routes/context.d.ts

@@ -0,0 +1,57 @@
+import { Hono } from "hono";
+import type { ApiDependencies } from "../server.js";
+interface ResolvedContextTarget {
+    base: string;
+    ext: ".md" | ".base";
+}
+declare function resolveContextTarget(userPath: string): ResolvedContextTarget;
+/**
+ * Resolve a user-supplied path safely within contextDir.
+ * Accepts paths with or without the trailing `.md` / `.base` extension.
+ * Returns null if the resolved path escapes contextDir (path traversal),
+ * targets a reserved `.base` stem with the wrong extension, or is on the
+ * deny list.
+ */
+declare function safePath(contextDir: string, userPath: string): string | null;
+declare function isWriteAllowed(path: string, method: string): boolean;
+/**
+ * Normalize a section name for matching:
+ * lowercase, spaces → underscores, strip leading ##
+ */
+declare function normalizeSection(name: string): string;
+/**
+ * Find a section in markdown content and return its boundaries.
+ * Returns [startOfBody, endOfBody] where body is between this ## and next ##.
+ */
+declare function findSection(content: string, sectionName: string): {
+    start: number;
+    end: number;
+    headerEnd: number;
+} | null;
+declare function parseEntryTimestamp(line: string): string | null;
+/**
+ * Remove entries whose `- [YYYY-MM-DD HH:MM:SS]` timestamp is ≤ cutoff.
+ * Non-matching lines (blank lines, continuation lines) are preserved.
+ * Returns the remaining section body and the count of removed entries.
+ */
+declare function clearEntriesBefore(sectionBody: string, cutoff: string): {
+    remaining: string;
+    removedCount: number;
+};
+/**
+ * Trim oldest bullet entries (`- ...` lines) from the top of a section
+ * body to keep at most `maxEntries` entries. Non-bullet lines (blank
+ * lines, non-`- ` prefixed lines) are preserved.
+ */
+declare function trimBulletEntries(body: string, maxEntries: number): {
+    body: string;
+    trimmed: number;
+};
+export declare function createContextRoutes(deps: ApiDependencies): Hono;
+declare function validateTodayContent(content: string, options?: {
+    allowLegacyToday?: boolean;
+    expectedAgentDay?: string;
+}): string | null;
+declare function validateBaseYamlSyntax(content: string): string | null;
+export { normalizeSection, findSection, isWriteAllowed, safePath, resolveContextTarget, validateBaseYamlSyntax, validateTodayContent, clearEntriesBefore, trimBulletEntries, parseEntryTimestamp, };
+//# sourceMappingURL=context.d.ts.map

package/dist/api/routes/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/api/routes/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAqB5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAsDpD,UAAU,qBAAqB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC;CACtB;AA2BD,iBAAS,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,CAUrE;AA4DD;;;;;;GAMG;AACH,iBAAS,QAAQ,CACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAiCf;AA4FD,iBAAS,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAwC7D;AA2ED;;;GAGG;AACH,iBAAS,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK9C;AAED;;;GAGG;AACH,iBAAS,WAAW,CAClB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAgC1D;AAuBD,iBAAS,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGxD;AAED;;;;GAIG;AACH,iBAAS,kBAAkB,CACzB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CA2B7C;AAED;;;;GAIG;AACH,iBAAS,iBAAiB,CACxB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAgCnC;AA6BD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CA4tC/D;AA0ED,iBAAS,oBAAoB,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAO,GACtE,MAAM,GAAG,IAAI,CAsDf;AAiND,iBAAS,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoC9D;AAGD,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,QAAQ,EACR,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GACpB,CAAC"}