daemora 1.0.0-alpha.0

package/dist/costs/CostTracker.js

@@ -0,0 +1,176 @@
+/**
+ * CostTracker — per-task token cost tracking.
+ *
+ * Records input/output token counts per model invocation and computes
+ * USD cost from a static price map. Unknown models estimate at $0 —
+ * the record is still stored for token auditing.
+ *
+ * Table: cost_entries (one row per LLM call)
+ */
+import { randomUUID } from "node:crypto";
+import { createLogger } from "../util/logger.js";
+const log = createLogger("cost-tracker");
+const PRICE_MAP = {
+    // Anthropic
+    "anthropic:claude-opus-4-0-20250514": { input: 15.0, output: 75.0 },
+    "anthropic:claude-sonnet-4-20250514": { input: 3.0, output: 15.0 },
+    "anthropic:claude-3-5-sonnet-20241022": { input: 3.0, output: 15.0 },
+    "anthropic:claude-3-5-haiku-20241022": { input: 0.8, output: 4.0 },
+    "anthropic:claude-3-haiku-20240307": { input: 0.25, output: 1.25 },
+    // OpenAI
+    "openai:gpt-4o": { input: 2.5, output: 10.0 },
+    "openai:gpt-4o-mini": { input: 0.15, output: 0.6 },
+    "openai:gpt-4-turbo": { input: 10.0, output: 30.0 },
+    "openai:o1": { input: 15.0, output: 60.0 },
+    "openai:o1-mini": { input: 3.0, output: 12.0 },
+    "openai:o3-mini": { input: 1.1, output: 4.4 },
+    // Google
+    "google:gemini-2.0-flash": { input: 0.1, output: 0.4 },
+    "google:gemini-2.0-pro": { input: 1.25, output: 10.0 },
+    "google:gemini-1.5-pro": { input: 1.25, output: 5.0 },
+    "google:gemini-1.5-flash": { input: 0.075, output: 0.3 },
+};
+// ── Tracker ────────────────────────────────────────────────────────
+export class CostTracker {
+    db;
+    stmts;
+    constructor(db) {
+        this.db = db;
+        this.createTable();
+        this.stmts = this.prepareStatements();
+        log.debug("cost tracker initialized");
+    }
+    /**
+     * Record a single LLM invocation's token usage.
+     * Cost is auto-calculated from the static price map.
+     */
+    record(taskId, model, provider, inputTokens, outputTokens) {
+        const id = randomUUID();
+        const now = Date.now();
+        const costUsd = CostTracker.calculateCost(provider, model, inputTokens, outputTokens);
+        this.stmts.insert.run(id, taskId, model, provider, inputTokens, outputTokens, costUsd, now);
+        log.debug({ taskId, model, provider, inputTokens, outputTokens, costUsd }, "cost recorded");
+        return { id, taskId, model, provider, inputTokens, outputTokens, costUsd, createdAt: now };
+    }
+    /**
+     * Total cost in USD for today (UTC).
+     */
+    todayCost() {
+        const startOfDay = todayStartEpoch();
+        const row = this.stmts.sumSince.get(startOfDay);
+        return row?.total ?? 0;
+    }
+    /**
+     * Per-day cost breakdown for the last N days (default 30).
+     * Ordered most recent first.
+     */
+    dailyBreakdown(days = 30) {
+        const since = Date.now() - days * 24 * 60 * 60_000;
+        const rows = this.stmts.dailyBreakdown.all(since);
+        return rows.map((r) => ({
+            date: r.date,
+            totalCostUsd: r.total_cost,
+            totalInputTokens: r.total_input,
+            totalOutputTokens: r.total_output,
+            calls: r.calls,
+        }));
+    }
+    /**
+     * Full cost summary for a specific task.
+     */
+    taskCost(taskId) {
+        const rows = this.stmts.byTask.all(taskId);
+        const entries = rows.map(rowToEntry);
+        let totalCost = 0;
+        let totalInput = 0;
+        let totalOutput = 0;
+        for (const e of entries) {
+            totalCost += e.costUsd;
+            totalInput += e.inputTokens;
+            totalOutput += e.outputTokens;
+        }
+        return {
+            taskId,
+            totalCostUsd: totalCost,
+            totalInputTokens: totalInput,
+            totalOutputTokens: totalOutput,
+            calls: entries.length,
+            entries,
+        };
+    }
+    /**
+     * Calculate cost for a provider:model pair. Public so callers can
+     * preview cost without recording.
+     */
+    static calculateCost(provider, model, inputTokens, outputTokens) {
+        const key = `${provider}:${model}`;
+        const price = PRICE_MAP[key];
+        if (!price)
+            return 0;
+        const inputCost = (inputTokens / 1_000_000) * price.input;
+        const outputCost = (outputTokens / 1_000_000) * price.output;
+        // Round to 8 decimal places to avoid floating-point noise.
+        return Math.round((inputCost + outputCost) * 1e8) / 1e8;
+    }
+    /**
+     * Check if a model has pricing data.
+     */
+    static hasPricing(provider, model) {
+        return `${provider}:${model}` in PRICE_MAP;
+    }
+    // ── Internals ───────────────────────────────────────────────────
+    createTable() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS cost_entries (
+        id            TEXT PRIMARY KEY,
+        task_id       TEXT NOT NULL,
+        model         TEXT NOT NULL,
+        provider      TEXT NOT NULL,
+        input_tokens  INTEGER NOT NULL,
+        output_tokens INTEGER NOT NULL,
+        cost_usd      REAL NOT NULL,
+        created_at    INTEGER NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_cost_task ON cost_entries(task_id);
+      CREATE INDEX IF NOT EXISTS idx_cost_created ON cost_entries(created_at);
+    `);
+    }
+    prepareStatements() {
+        return {
+            insert: this.db.prepare(`INSERT INTO cost_entries (id, task_id, model, provider, input_tokens, output_tokens, cost_usd, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?)`),
+            sumSince: this.db.prepare("SELECT COALESCE(SUM(cost_usd), 0) AS total FROM cost_entries WHERE created_at >= ?"),
+            dailyBreakdown: this.db.prepare(`SELECT
+           date(created_at / 1000, 'unixepoch') AS date,
+           SUM(cost_usd)        AS total_cost,
+           SUM(input_tokens)    AS total_input,
+           SUM(output_tokens)   AS total_output,
+           COUNT(*)             AS calls
+         FROM cost_entries
+         WHERE created_at >= ?
+         GROUP BY date(created_at / 1000, 'unixepoch')
+         ORDER BY date DESC`),
+            byTask: this.db.prepare("SELECT * FROM cost_entries WHERE task_id = ? ORDER BY created_at ASC"),
+        };
+    }
+}
+// ── Helpers ────────────────────────────────────────────────────────
+function todayStartEpoch() {
+    const now = new Date();
+    const utcMidnight = Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate());
+    return utcMidnight;
+}
+function rowToEntry(row) {
+    return {
+        id: row.id,
+        taskId: row.task_id,
+        model: row.model,
+        provider: row.provider,
+        inputTokens: row.input_tokens,
+        outputTokens: row.output_tokens,
+        costUsd: row.cost_usd,
+        createdAt: row.created_at,
+    };
+}
+//# sourceMappingURL=CostTracker.js.map

package/dist/costs/CostTracker.js.map

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

package/dist/crew/CrewAgentRunner.d.ts

@@ -0,0 +1,55 @@
+/**
+ * CrewAgentRunner — executes one `useCrew(crewId, task)` call.
+ *
+ * Sub-agent execution model:
+ *   - A fresh AI SDK streamText run with a scoped tool set — only the
+ *     tools the crew manifest actually whitelists (and that exist in
+ *     the host ToolRegistry).
+ *   - Persistent session id `crew:<crewId>` so the crew accumulates its
+ *     own working memory across calls in the same workday.
+ *   - Blocking — the runner returns only after the crew finishes. That
+ *     keeps the main agent's tool call semantics simple: one call in,
+ *     one result out, tool errors propagate as DaemoraError.
+ *
+ * What this deliberately does NOT do:
+ *   - Stream deltas to the outer SSE — the main agent gets the final
+ *     answer, not the crew's thought process. Crew internals stay inside
+ *     the crew's session.
+ *   - Spawn nested crews. A crew calling useCrew() would recurse
+ *     unbounded; the tool is filtered out of the crew's toolset.
+ */
+import type { ModelRouter } from "../models/ModelRouter.js";
+import type { SessionStore } from "../memory/SessionStore.js";
+import type { SkillRegistry } from "../skills/SkillRegistry.js";
+import type { ToolRegistry } from "../tools/registry.js";
+import type { CrewRegistry } from "./CrewRegistry.js";
+export interface CrewRunInput {
+    readonly crewId: string;
+    readonly task: string;
+    readonly parentTaskId: string;
+    readonly parentModelId: string;
+    readonly maxSteps?: number;
+    readonly abortSignal: AbortSignal;
+}
+export interface CrewRunResult {
+    readonly crewId: string;
+    readonly sessionId: string;
+    readonly text: string;
+    readonly toolCalls: number;
+    readonly steps: number;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+}
+export declare class CrewAgentRunner {
+    private readonly crews;
+    private readonly tools;
+    private readonly models;
+    private readonly sessions;
+    private readonly skills?;
+    /** Process-lifetime map: crewId → sessionId. Sessions persist in SQL regardless. */
+    private readonly crewSessionIds;
+    constructor(crews: CrewRegistry, tools: ToolRegistry, models: ModelRouter, sessions: SessionStore, skills?: SkillRegistry | undefined);
+    run(input: CrewRunInput): Promise<CrewRunResult>;
+    private buildCrewTools;
+}
+//# sourceMappingURL=CrewAgentRunner.d.ts.map

package/dist/crew/CrewAgentRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CrewAgentRunner.d.ts","sourceRoot":"","sources":["../../src/crew/CrewAgentRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAKzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAsBtD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,qBAAa,eAAe;IAKxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAR1B,oFAAoF;IACpF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;gBAGzC,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,YAAY,EACtB,MAAM,CAAC,EAAE,aAAa,YAAA;IAGnC,GAAG,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAoHtD,OAAO,CAAC,cAAc;CA+BvB"}

package/dist/crew/CrewAgentRunner.js

@@ -0,0 +1,208 @@
+/**
+ * CrewAgentRunner — executes one `useCrew(crewId, task)` call.
+ *
+ * Sub-agent execution model:
+ *   - A fresh AI SDK streamText run with a scoped tool set — only the
+ *     tools the crew manifest actually whitelists (and that exist in
+ *     the host ToolRegistry).
+ *   - Persistent session id `crew:<crewId>` so the crew accumulates its
+ *     own working memory across calls in the same workday.
+ *   - Blocking — the runner returns only after the crew finishes. That
+ *     keeps the main agent's tool call semantics simple: one call in,
+ *     one result out, tool errors propagate as DaemoraError.
+ *
+ * What this deliberately does NOT do:
+ *   - Stream deltas to the outer SSE — the main agent gets the final
+ *     answer, not the crew's thought process. Crew internals stay inside
+ *     the crew's session.
+ *   - Spawn nested crews. A crew calling useCrew() would recurse
+ *     unbounded; the tool is filtered out of the crew's toolset.
+ */
+import { stepCountIs, streamText } from "ai";
+import { toAiTool } from "../tools/types.js";
+import { NotFoundError, toDaemoraError } from "../util/errors.js";
+import { createLogger } from "../util/logger.js";
+import { estimateMessageTokens } from "../util/tokenEstimate.js";
+const log = createLogger("crew.runner");
+/** Max tool-call iterations inside a crew. Bounded to keep spawns cheap. */
+const DEFAULT_CREW_MAX_STEPS = 15;
+/** Tools a crew may NEVER see, regardless of manifest. Prevents recursion. */
+const NEVER_ALLOWED = new Set(["use_crew", "parallel_crew"]);
+/**
+ * Tools every crew gets, regardless of manifest — the learning substrate.
+ * skill_view lets sub-agents read the same skill library the main agent
+ * has; skill_manage lets a specialist crew save or patch a skill it just
+ * perfected (hermes pattern). Memory tools are additive — a crew that
+ * discovers a user preference should persist it.
+ */
+const ALWAYS_CREW_TOOLS = new Set([
+    "skill_view", "skill_manage", "memory_save", "memory_recall",
+]);
+export class CrewAgentRunner {
+    crews;
+    tools;
+    models;
+    sessions;
+    skills;
+    /** Process-lifetime map: crewId → sessionId. Sessions persist in SQL regardless. */
+    crewSessionIds = new Map();
+    constructor(crews, tools, models, sessions, skills) {
+        this.crews = crews;
+        this.tools = tools;
+        this.models = models;
+        this.sessions = sessions;
+        this.skills = skills;
+    }
+    async run(input) {
+        const crew = this.crews.tryGet(input.crewId);
+        if (!crew) {
+            throw new NotFoundError(`Unknown crew: ${input.crewId}`, {
+                knownCrews: this.crews.list().map((c) => c.manifest.id),
+            });
+        }
+        // Same crew should reuse its session across calls AND across
+        // server restarts so it accumulates context instead of being
+        // orphaned on every process boot. Lookup strategy:
+        //   1. Process-lifetime cache (hot path — same server run).
+        //   2. DB lookup by stable `source = "crew:<id>"` tag under the
+        //      main parent session (survives restarts).
+        //   3. Fall through to creating a fresh row.
+        // The crew session is always parented under "main" so the Logs /
+        // Chat UI can thread a crew run back to the top-level conversation
+        // instead of it floating as an orphan.
+        const sourceTag = `crew:${crew.manifest.id}`;
+        const parentSessionId = "main";
+        const cached = this.crewSessionIds.get(crew.manifest.id);
+        let reused = cached ? this.sessions.getSession(cached) : null;
+        if (!reused) {
+            reused = this.sessions.findLatestSessionBySource(sourceTag, parentSessionId);
+        }
+        const session = reused ?? this.sessions.createSession({
+            title: `Crew: ${crew.manifest.name}`,
+            parentSessionId,
+            source: sourceTag,
+            ...(crew.manifest.profile.model ? { modelHint: crew.manifest.profile.model } : {}),
+        });
+        this.crewSessionIds.set(crew.manifest.id, session.id);
+        const history = this.sessions.getHistory(session.id, { limit: 40 });
+        // Persist the delegating task up front so a mid-stream disconnect
+        // still leaves the user-visible delegation recorded.
+        const userMsg = { role: "user", content: input.task };
+        this.sessions.appendMessage(session.id, userMsg, estimateMessageTokens(userMsg));
+        const crewToolset = this.buildCrewTools(crew, input);
+        const resolved = await this.models.resolve(crew.manifest.profile.model ?? input.parentModelId);
+        const skillsIndex = this.skills
+            ? this.skills.renderIndexForPrompt({
+                availableTools: new Set(Object.keys(crewToolset)),
+                enabledIntegrations: new Set(),
+            })
+            : "";
+        const systemPrompt = buildCrewSystemPrompt(crew, skillsIndex);
+        log.info({
+            crewId: crew.manifest.id,
+            sessionId: session.id,
+            modelId: resolved.id,
+            toolCount: Object.keys(crewToolset).length,
+            dropped: crew.droppedTools,
+            historyMessages: history.length,
+        }, "crew run starting");
+        const stream = streamText({
+            model: resolved.model,
+            system: systemPrompt,
+            messages: [...history, userMsg],
+            tools: crewToolset,
+            temperature: crew.manifest.profile.temperature,
+            stopWhen: stepCountIs(input.maxSteps ?? DEFAULT_CREW_MAX_STEPS),
+            abortSignal: input.abortSignal,
+        });
+        // Exhaust the stream. We don't forward deltas — the main agent gets
+        // the final answer via the tool result only. Iteration still drives
+        // streamText's internal tool-call loop.
+        let toolCalls = 0;
+        let steps = 0;
+        let streamError = null;
+        try {
+            for await (const part of stream.fullStream) {
+                if (part.type === "tool-call")
+                    toolCalls++;
+                if (part.type === "finish-step")
+                    steps++;
+                if (part.type === "error") {
+                    streamError = part.error?.message ?? "stream error";
+                }
+            }
+        }
+        catch (e) {
+            streamError = toDaemoraError(e).message;
+        }
+        if (streamError !== null) {
+            log.error({ crewId: crew.manifest.id, error: streamError }, "crew run failed");
+            throw toDaemoraError(new Error(streamError));
+        }
+        const resp = await stream.response;
+        for (const msg of resp.messages) {
+            const m = msg;
+            this.sessions.appendMessage(session.id, m, estimateMessageTokens(m));
+        }
+        const text = await stream.text;
+        const usage = await stream.totalUsage;
+        return {
+            crewId: crew.manifest.id,
+            sessionId: session.id,
+            text,
+            toolCalls,
+            steps,
+            inputTokens: usage.inputTokens ?? 0,
+            outputTokens: usage.outputTokens ?? 0,
+        };
+    }
+    buildCrewTools(crew, input) {
+        const ctxFactory = (signal) => ({
+            abortSignal: signal,
+            taskId: `${input.parentTaskId}/crew:${crew.manifest.id}`,
+            logger: {
+                info: (msg, ctx) => log.info({ crew: crew.manifest.id, ...ctx }, msg),
+                warn: (msg, ctx) => log.warn({ crew: crew.manifest.id, ...ctx }, msg),
+                error: (msg, ctx) => log.error({ crew: crew.manifest.id, ...ctx }, msg),
+            },
+        });
+        const entries = [];
+        const included = new Set();
+        for (const name of crew.resolvedTools) {
+            if (NEVER_ALLOWED.has(name))
+                continue;
+            const def = this.tools.get(name);
+            if (!def)
+                continue; // Tool was unregistered since load — skip silently.
+            entries.push([name, toAiTool(def, ctxFactory)]);
+            included.add(name);
+        }
+        // Always include the learning substrate (skill_view, skill_manage,
+        // memory tools) so crews can read/write the shared skill + memory
+        // library — hermes pattern where every agent fork has full access.
+        for (const name of ALWAYS_CREW_TOOLS) {
+            if (included.has(name) || NEVER_ALLOWED.has(name))
+                continue;
+            const def = this.tools.get(name);
+            if (!def)
+                continue;
+            entries.push([name, toAiTool(def, ctxFactory)]);
+        }
+        return Object.fromEntries(entries);
+    }
+}
+function buildCrewSystemPrompt(crew, skillsIndex) {
+    const lines = [
+        crew.manifest.profile.systemPrompt,
+        "",
+        "— You are being called as a specialist by the main Daemora agent.",
+        "— Do the requested work and return a concise, structured result.",
+        "— You DO NOT have access to delegate further. Complete the task with the tools you have.",
+        "— If you lack a tool required for the task, say so explicitly and return what partial result you can.",
+    ];
+    if (skillsIndex) {
+        lines.push("", skillsIndex);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=CrewAgentRunner.js.map

package/dist/crew/CrewAgentRunner.js.map

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

package/dist/crew/CrewLoader.d.ts

@@ -0,0 +1,43 @@
+/**
+ * CrewLoader — scans `<crewRoot>/*\/plugin.json`, validates manifests,
+ * resolves tool names against the active ToolRegistry, and returns the
+ * set of crews the host process can actually run right now.
+ *
+ * Philosophy: fail LOUD on structural problems (malformed JSON, missing
+ * id, invalid schema) — those are bugs. Fail SOFT on per-tool misses —
+ * tools come and go with integrations, and we'd rather ship a crew with
+ * 6/8 tools than refuse to load it entirely.
+ */
+import type { ToolRegistry } from "../tools/registry.js";
+import { type CrewManifest, type LoadedCrew } from "./types.js";
+export interface CrewLoadResult {
+    readonly loaded: readonly LoadedCrew[];
+    readonly skipped: readonly {
+        dir: string;
+        reason: string;
+    }[];
+}
+export declare class CrewLoader {
+    private readonly root;
+    constructor(root: string);
+    /** Root directory crews live in — exposed so callers can resolve
+     *  a crew's manifest file path for in-place edits. */
+    get rootDir(): string;
+    /**
+     * Re-scan disk and return the single crew whose manifest id matches.
+     * Used by the `PUT /api/crew/:id/profile` path to hot-reload a crew
+     * after its plugin.json has been rewritten, without doing a full
+     * crew directory rescan.
+     */
+    loadOne(id: string, registry: ToolRegistry): Promise<LoadedCrew | null>;
+    loadAll(registry: ToolRegistry): Promise<CrewLoadResult>;
+}
+/** Convenience: reveal manifest fields in a uniform shape for the CrewRegistry. */
+export declare function crewManifestDigest(m: CrewManifest): {
+    id: string;
+    name: string;
+    description: string;
+    model: string | null;
+    temperature: number;
+};
+//# sourceMappingURL=CrewLoader.d.ts.map

package/dist/crew/CrewLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CrewLoader.d.ts","sourceRoot":"","sources":["../../src/crew/CrewLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EAAsB,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAIpF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC9D;AAED,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,MAAM;IAEzC;0DACsD;IACtD,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;;;;OAKG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAKvE,OAAO,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;CAoF/D;AAED,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,YAAY,GAAG;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,CAQA"}

package/dist/crew/CrewLoader.js

@@ -0,0 +1,122 @@
+/**
+ * CrewLoader — scans `<crewRoot>/*\/plugin.json`, validates manifests,
+ * resolves tool names against the active ToolRegistry, and returns the
+ * set of crews the host process can actually run right now.
+ *
+ * Philosophy: fail LOUD on structural problems (malformed JSON, missing
+ * id, invalid schema) — those are bugs. Fail SOFT on per-tool misses —
+ * tools come and go with integrations, and we'd rather ship a crew with
+ * 6/8 tools than refuse to load it entirely.
+ */
+import { readdir, readFile, stat } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { createLogger } from "../util/logger.js";
+import { crewManifestSchema } from "./types.js";
+const log = createLogger("crew.loader");
+export class CrewLoader {
+    root;
+    constructor(root) {
+        this.root = root;
+    }
+    /** Root directory crews live in — exposed so callers can resolve
+     *  a crew's manifest file path for in-place edits. */
+    get rootDir() {
+        return resolve(this.root);
+    }
+    /**
+     * Re-scan disk and return the single crew whose manifest id matches.
+     * Used by the `PUT /api/crew/:id/profile` path to hot-reload a crew
+     * after its plugin.json has been rewritten, without doing a full
+     * crew directory rescan.
+     */
+    async loadOne(id, registry) {
+        const { loaded } = await this.loadAll(registry);
+        return loaded.find((c) => c.manifest.id === id) ?? null;
+    }
+    async loadAll(registry) {
+        const root = resolve(this.root);
+        const registered = new Set(registry.list().map((t) => t.name));
+        let entries;
+        try {
+            entries = await readdir(root);
+        }
+        catch (e) {
+            const err = e;
+            if (err.code === "ENOENT") {
+                log.warn({ root }, "crew root missing — no crews loaded");
+                return { loaded: [], skipped: [] };
+            }
+            throw e;
+        }
+        const loaded = [];
+        const skipped = [];
+        for (const entry of entries) {
+            if (entry.startsWith(".") || entry.startsWith("_"))
+                continue;
+            const dir = join(root, entry);
+            const manifestPath = join(dir, "plugin.json");
+            let s;
+            try {
+                s = await stat(dir);
+            }
+            catch {
+                continue;
+            }
+            if (!s.isDirectory())
+                continue;
+            let raw;
+            try {
+                raw = await readFile(manifestPath, "utf-8");
+            }
+            catch {
+                skipped.push({ dir, reason: "no plugin.json" });
+                continue;
+            }
+            let json;
+            try {
+                json = JSON.parse(raw);
+            }
+            catch (e) {
+                skipped.push({ dir, reason: `invalid JSON: ${e.message}` });
+                continue;
+            }
+            // Soft-fix common overflow: a too-long description shouldn't drop
+            // the whole crew. Truncate to the schema max and warn so users see
+            // the issue at startup instead of getting a silently-missing crew.
+            if (typeof json.description === "string") {
+                const desc = json.description;
+                if (desc.length > 2000) {
+                    json.description = `${desc.slice(0, 1997)}...`;
+                    log.warn({ dir, originalLength: desc.length }, "crew description over 2000 chars — auto-truncated");
+                }
+            }
+            const parsed = crewManifestSchema.safeParse(json);
+            if (!parsed.success) {
+                skipped.push({ dir, reason: `invalid schema: ${parsed.error.message.slice(0, 200)}` });
+                continue;
+            }
+            const resolvedTools = [];
+            const droppedTools = [];
+            for (const t of parsed.data.tools) {
+                (registered.has(t) ? resolvedTools : droppedTools).push(t);
+            }
+            if (droppedTools.length > 0) {
+                log.warn({ crew: parsed.data.id, dropped: droppedTools }, "crew references unavailable tools — loading with reduced tool set");
+            }
+            loaded.push({ manifest: parsed.data, dir, resolvedTools, droppedTools });
+        }
+        log.info({ root, loaded: loaded.length, skipped: skipped.length }, "crew scan complete");
+        return { loaded, skipped };
+    }
+}
+/** Convenience: reveal manifest fields in a uniform shape for the CrewRegistry. */
+export function crewManifestDigest(m) {
+    return {
+        id: m.id,
+        name: m.name,
+        description: m.description,
+        model: m.profile.model ?? null,
+        temperature: m.profile.temperature,
+    };
+}
+//# sourceMappingURL=CrewLoader.js.map

package/dist/crew/CrewLoader.js.map

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