@tianshu-ai/tianshu 0.3.0

package/plugins/workboard/dist/effective-skills.js

@@ -0,0 +1,126 @@
+// Compute the "effective skills" list for a worker agent — what
+// `<available_skills>` will actually contain when the worker
+// runs. Mirrors the merge order used by the host's chat handler /
+// agent-loop:
+//
+//   1. host self-shipped skills     (via `host.skillCatalog`,
+//                                    pluginId === "host")
+//   2. plugin skills                (via `host.skillCatalog`)
+//   3. tenant shared skills         (`_tenant/config/skills/`)
+//   4. tenant per-worker skills     (`_tenant/config/workers/<slug>/skills/`)
+//
+// Then, if `agent.skills` is non-null, we narrow to that allow-list.
+// The `null` semantics is "no restriction" — the agent loop applies
+// the same rule (PR #98).
+//
+// Returns names only; the UI doesn't need bodies. The result feeds
+// the read-only worker-agents listing so the user can see what
+// each worker effectively has access to without spinning a real
+// run.
+import fs from "node:fs";
+import path from "node:path";
+export function computeEffectiveSkillsFor(args) {
+    const names = new Set();
+    // Layer 1+2: host + plugin skills via the catalog capability.
+    // We're rendering a worker's effective view, so drop entries
+    // marked `scope: main` (those are documentation aimed at the
+    // chat agent, not workers). Tenant skills aren't filtered —
+    // they go through their own scope mechanism via tenant skill
+    // loader, which we mirror here by directory layout.
+    if (args.hostSkillCatalog) {
+        try {
+            for (const e of args.hostSkillCatalog.list()) {
+                if (!e?.name)
+                    continue;
+                if (e.scope === "main")
+                    continue;
+                names.add(e.name);
+            }
+        }
+        catch {
+            // Catalog hiccup is non-fatal; we still have the tenant
+            // layers below.
+        }
+    }
+    // Layer 3: tenant shared skills.
+    for (const n of scanSkillsRoot(path.join(args.tenantConfigDir, "skills"))) {
+        names.add(n);
+    }
+    // Layer 4: per-worker skills under `workers/<slug>/skills/`.
+    // Slug is the runtime id (= directory name); `builtinKey` is
+    // the same value for builtin workers (see fs-worker-agents.ts).
+    const slug = args.agent.id;
+    if (slug) {
+        for (const n of scanSkillsRoot(path.join(args.tenantConfigDir, "workers", slug, "skills"))) {
+            names.add(n);
+        }
+    }
+    // Apply the agent's allow-list, if any.
+    let out;
+    if (args.agent.skills) {
+        const allow = new Set(args.agent.skills);
+        out = [...names].filter((n) => allow.has(n));
+    }
+    else {
+        out = [...names];
+    }
+    return out.sort();
+}
+/** Walk `<root>/<name>/SKILL.md` and pull `name:` from the
+ *  frontmatter. We don't need the body. Match the loader's
+ *  rules: directory-style only, frontmatter-required. */
+function scanSkillsRoot(root) {
+    if (!fs.existsSync(root))
+        return [];
+    const out = [];
+    let entries;
+    try {
+        entries = fs.readdirSync(root, { withFileTypes: true });
+    }
+    catch {
+        return out;
+    }
+    for (const e of entries) {
+        if (!e.isDirectory())
+            continue;
+        if (e.name.startsWith("."))
+            continue;
+        const skillMd = path.join(root, e.name, "SKILL.md");
+        if (!fs.existsSync(skillMd))
+            continue;
+        const name = readSkillName(skillMd);
+        if (name)
+            out.push(name);
+    }
+    return out;
+}
+function readSkillName(filePath) {
+    let raw;
+    try {
+        raw = fs.readFileSync(filePath, "utf8");
+    }
+    catch {
+        return null;
+    }
+    // Cheap frontmatter parser: just enough to pull `name:`.
+    if (!raw.startsWith("---"))
+        return null;
+    const end = raw.indexOf("\n---", 3);
+    if (end < 0)
+        return null;
+    const head = raw.slice(3, end);
+    for (const line of head.split("\n")) {
+        const m = line.match(/^\s*name\s*:\s*(.+?)\s*$/);
+        if (m) {
+            // Strip surrounding quotes if any.
+            let v = m[1];
+            if ((v.startsWith('"') && v.endsWith('"')) ||
+                (v.startsWith("'") && v.endsWith("'"))) {
+                v = v.slice(1, -1);
+            }
+            return v;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=effective-skills.js.map

package/plugins/workboard/dist/effective-skills.js.map

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

package/plugins/workboard/dist/fs-worker-agents.d.ts

@@ -0,0 +1,35 @@
+import type { WorkerAgent } from "./types.js";
+export interface LoadResult {
+    agents: WorkerAgent[];
+    /** Slugs whose fs record had errors — surfaced for logging. */
+    fsErrors: Array<{
+        slug: string;
+        reasons: string[];
+    }>;
+}
+export declare function loadWorkerAgents(args: {
+    tenantId: string;
+    tenantHomeDir: string;
+}): LoadResult;
+/**
+ * Toggle `enabled` on a worker's agent.json. Used by the admin
+ * route that backs the enable/disable button on the worker-agents
+ * page. Returns the new enabled state on success, or null when the
+ * slug doesn't exist on disk.
+ *
+ * The fs watcher in workboard's server.ts picks up the write and
+ * triggers a pool rebuild, so the change takes effect on the next
+ * task pickup without a process restart.
+ */
+export declare function setAgentEnabled(args: {
+    tenantHomeDir: string;
+    slug: string;
+    enabled: boolean;
+}): {
+    ok: true;
+    enabled: boolean;
+} | {
+    ok: false;
+    error: string;
+};
+//# sourceMappingURL=fs-worker-agents.d.ts.map

package/plugins/workboard/dist/fs-worker-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-worker-agents.d.ts","sourceRoot":"","sources":["../src/fs-worker-agents.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAqB9C,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CACtD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,UAAU,CAcb;AAcD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA0ChE"}

package/plugins/workboard/dist/fs-worker-agents.js

@@ -0,0 +1,199 @@
+// Filesystem-backed worker-agent loader.
+//
+// Post-PR-C2 the legacy `worker_agents` SQLite table is gone;
+// `<tenant>/_tenant/config/workers/<slug>/` is the only source.
+// Each subdirectory is one worker:
+//
+//   <slug>/
+//     agent.json    (required)
+//     SOUL.md       (optional; system prompt)
+//     skills/...    (optional; picked up by tenant-skills loader)
+//
+// The loader is plugin-local on purpose — plugins shouldn't reach
+// into server internals.
+import fs from "node:fs";
+import path from "node:path";
+export function loadWorkerAgents(args) {
+    const fsRecords = scanFsWorkers(args.tenantHomeDir);
+    const agents = [];
+    const fsErrors = [];
+    for (const r of fsRecords) {
+        if (r.errors.length > 0) {
+            fsErrors.push({ slug: r.slug, reasons: r.errors });
+            if (!r.spec.kind)
+                continue;
+        }
+        agents.push(toWorkerAgent(args.tenantId, r));
+    }
+    agents.sort((a, b) => a.name.localeCompare(b.name));
+    return { agents, fsErrors };
+}
+/**
+ * Locate the workers root that scanFsWorkers would use. Returns
+ * null when no workers dir exists yet.
+ */
+function findWorkersRoot(tenantHomeDir) {
+    const candidates = [
+        path.join(tenantHomeDir, "workspace", "_tenant", "config", "workers"),
+        path.join(tenantHomeDir, "_tenant", "config", "workers"),
+    ];
+    return candidates.find((p) => fs.existsSync(p)) ?? null;
+}
+/**
+ * Toggle `enabled` on a worker's agent.json. Used by the admin
+ * route that backs the enable/disable button on the worker-agents
+ * page. Returns the new enabled state on success, or null when the
+ * slug doesn't exist on disk.
+ *
+ * The fs watcher in workboard's server.ts picks up the write and
+ * triggers a pool rebuild, so the change takes effect on the next
+ * task pickup without a process restart.
+ */
+export function setAgentEnabled(args) {
+    if (!/^[a-zA-Z0-9_-]+$/.test(args.slug)) {
+        return { ok: false, error: "invalid slug" };
+    }
+    const root = findWorkersRoot(args.tenantHomeDir);
+    if (!root)
+        return { ok: false, error: "workers dir does not exist" };
+    const dir = path.join(root, args.slug);
+    const file = path.join(dir, "agent.json");
+    if (!fs.existsSync(file)) {
+        return { ok: false, error: `agent.json not found for slug ${args.slug}` };
+    }
+    let raw;
+    try {
+        raw = fs.readFileSync(file, "utf8");
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: `read agent.json failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    let spec;
+    try {
+        spec = JSON.parse(raw);
+        if (typeof spec !== "object" || spec === null || Array.isArray(spec)) {
+            return { ok: false, error: "agent.json must be an object" };
+        }
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: `agent.json is not valid JSON: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    spec.enabled = args.enabled;
+    try {
+        fs.writeFileSync(file, JSON.stringify(spec, null, 2) + "\n", "utf8");
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: `write agent.json failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    return { ok: true, enabled: args.enabled };
+}
+function scanFsWorkers(tenantHomeDir) {
+    // Caller passes either the tenant root (`<...>/tenants/<id>`) or
+    // its workspace dir (`<...>/tenants/<id>/workspace`). Both shapes
+    // resolve to the same workers root so we accept either.
+    const candidates = [
+        path.join(tenantHomeDir, "workspace", "_tenant", "config", "workers"),
+        path.join(tenantHomeDir, "_tenant", "config", "workers"),
+    ];
+    const root = candidates.find((p) => fs.existsSync(p));
+    if (!root)
+        return [];
+    let entries;
+    try {
+        entries = fs.readdirSync(root, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const e of entries) {
+        if (!e.isDirectory())
+            continue;
+        if (e.name.startsWith("."))
+            continue;
+        const dir = path.join(root, e.name);
+        out.push(loadOne(e.name, dir));
+    }
+    return out;
+}
+function loadOne(slug, dir) {
+    const errors = [];
+    let spec = {};
+    let updatedMs = 0;
+    const agentJson = path.join(dir, "agent.json");
+    if (fs.existsSync(agentJson)) {
+        try {
+            const raw = fs.readFileSync(agentJson, "utf8");
+            const parsed = JSON.parse(raw);
+            if (parsed && typeof parsed === "object") {
+                spec = parsed;
+            }
+            else {
+                errors.push("agent.json is not an object");
+            }
+        }
+        catch (err) {
+            errors.push(`agent.json parse failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        try {
+            updatedMs = fs.statSync(agentJson).mtimeMs;
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    else {
+        errors.push("agent.json missing");
+    }
+    if (!spec.kind || typeof spec.kind !== "string") {
+        errors.push("agent.json missing required field: kind");
+    }
+    let systemPrompt = null;
+    const soulPath = path.join(dir, "SOUL.md");
+    if (fs.existsSync(soulPath)) {
+        try {
+            systemPrompt = fs.readFileSync(soulPath, "utf8").trim();
+            if (!systemPrompt)
+                systemPrompt = null;
+        }
+        catch (err) {
+            errors.push(`SOUL.md read failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    return { slug, spec, systemPrompt, updatedMs, errors };
+}
+function toWorkerAgent(tenantId, r) {
+    const spec = r.spec;
+    const kind = typeof spec.kind === "string" ? spec.kind : "unknown";
+    const enabled = spec.enabled !== false;
+    const source = spec.source === "user" ? "user" : "builtin";
+    const builtinKey = source === "builtin" ? r.slug : null;
+    return {
+        id: r.slug,
+        tenantId,
+        kind,
+        name: spec.displayName ?? r.slug,
+        description: spec.description ?? null,
+        modelId: spec.modelId ?? null,
+        systemPrompt: r.systemPrompt,
+        toolsAllow: spec.toolsAllow ?? null,
+        skills: spec.skillsAllow ?? null,
+        source,
+        builtinKey,
+        ownerUserId: null,
+        enabled,
+        overridesAt: null,
+        createdAt: r.updatedMs || Date.now(),
+        updatedAt: r.updatedMs || Date.now(),
+    };
+}
+//# sourceMappingURL=fs-worker-agents.js.map

package/plugins/workboard/dist/fs-worker-agents.js.map

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

package/plugins/workboard/dist/migrate-worker-agents.d.ts

@@ -0,0 +1,11 @@
+import type { WorkerAgent } from "./db/agents.js";
+export interface MigrateResult {
+    migrated: string[];
+    preserved: string[];
+}
+export declare function migrateWorkerAgentsToFs(args: {
+    tenantHomeDir: string;
+    dbAgents: readonly WorkerAgent[];
+    onWarn?: (msg: string) => void;
+}): MigrateResult;
+//# sourceMappingURL=migrate-worker-agents.d.ts.map

package/plugins/workboard/dist/migrate-worker-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-worker-agents.d.ts","sourceRoot":"","sources":["../src/migrate-worker-agents.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IACjC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,GAAG,aAAa,CAsEhB"}

package/plugins/workboard/dist/migrate-worker-agents.js

@@ -0,0 +1,89 @@
+// One-shot migration: dump every row in `worker_agents` that
+// doesn't have a matching `_tenant/config/workers/<slug>/` slot to
+// disk, in the format the new fs loader expects.
+//
+// Runs on every workboard activation. Idempotent — once a row's
+// slot exists, this is a no-op for that row. Safe to remove in
+// PR-C after the table itself is dropped.
+//
+// Slug rules:
+//   * builtin row    → builtin_key (already a kebab-case slug)
+//   * user row       → slugify(name) + dedup with -2 / -3 / ...
+//
+// We never delete the DB row here; the merger (fs-worker-agents.ts)
+// shadows the DB row by slug as long as the fs slot exists. PR-C
+// drops the table after we're confident the migration is settled.
+import fs from "node:fs";
+import path from "node:path";
+export function migrateWorkerAgentsToFs(args) {
+    // Caller passes either `<tenantHome>` or `<tenantHome>/workspace`.
+    // PluginContext.workspaceDir is the workspace dir, so the second
+    // candidate is the common case.
+    const candidates = [
+        path.join(args.tenantHomeDir, "workspace", "_tenant", "config", "workers"),
+        path.join(args.tenantHomeDir, "_tenant", "config", "workers"),
+    ];
+    const targetRoot = candidates.find((p) => fs.existsSync(p)) ?? candidates[0];
+    fs.mkdirSync(targetRoot, { recursive: true });
+    const warn = args.onWarn ?? ((m) => console.warn(m));
+    const existing = new Set(fs
+        .readdirSync(targetRoot, { withFileTypes: true })
+        .filter((d) => d.isDirectory())
+        .map((d) => d.name));
+    const migrated = [];
+    const preserved = [];
+    for (const a of args.dbAgents) {
+        const baseSlug = a.builtinKey || slugify(a.name) || a.id;
+        let slug = baseSlug;
+        let n = 2;
+        while (existing.has(slug)) {
+            // Same slug already on disk — assume the fs slot wins, mark
+            // the DB row as preserved (not migrated) and move on. We do
+            // NOT try to dedup-and-still-migrate; if the user wants both
+            // rows they can rename one in-DB and re-run.
+            preserved.push(slug);
+            slug = "";
+            break;
+        }
+        void n; // (kept for readability — see dedup branch removed)
+        if (!slug)
+            continue;
+        const dir = path.join(targetRoot, slug);
+        try {
+            fs.mkdirSync(dir, { recursive: true });
+            const agentJson = {
+                kind: a.kind,
+                displayName: a.name,
+                enabled: a.enabled,
+                source: a.source,
+            };
+            if (a.description)
+                agentJson.description = a.description;
+            if (a.modelId)
+                agentJson.modelId = a.modelId;
+            if (a.toolsAllow)
+                agentJson.toolsAllow = a.toolsAllow;
+            if (a.skills)
+                agentJson.skillsAllow = a.skills;
+            fs.writeFileSync(path.join(dir, "agent.json"), JSON.stringify(agentJson, null, 2) + "\n", "utf8");
+            if (a.systemPrompt && a.systemPrompt.trim().length > 0) {
+                fs.writeFileSync(path.join(dir, "SOUL.md"), a.systemPrompt, "utf8");
+            }
+            existing.add(slug);
+            migrated.push(slug);
+        }
+        catch (err) {
+            warn(`[migrate-workers] failed to migrate "${a.name}" → ${slug}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    return { migrated, preserved };
+}
+function slugify(s) {
+    return s
+        .toLowerCase()
+        .normalize("NFKD")
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 60);
+}
+//# sourceMappingURL=migrate-worker-agents.js.map

package/plugins/workboard/dist/migrate-worker-agents.js.map

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

package/plugins/workboard/dist/routes/handlers.d.ts

@@ -0,0 +1,106 @@
+import type { PluginRouteHandler, TenantDbHandle, PluginLogger } from "@tianshu/plugin-sdk";
+import type { WorkerAgent } from "../types.js";
+/**
+ * Validate that a task's worker assignment can actually be picked
+ * up by some live worker, before we let it land in the DB.
+ *
+ * Without this check a task could be created against an agent the
+ * user disabled (or that never existed), or with a worker_role no
+ * enabled agent matches — the pool would silently never claim
+ * it. The user sees a forever-`ready` card with no explanation.
+ *
+ * Returns null when the assignment is fine (or absent), and an
+ * `{ code, message }` envelope when it isn't. Caller maps that
+ * to a 400 + JSON.
+ *
+ * Rules:
+ *   - workerAgentId set: must exist for this tenant AND be enabled.
+ *     If both are set, workerRole is ignored (the pool uses agent
+ *     pinning when present), so we don't enforce role-match here.
+ *   - workerRole set, workerAgentId absent: at least one enabled
+ *     agent in this tenant must have `kind === workerRole`.
+ *   - both absent: any enabled agent (regardless of role) can pick
+ *     the task up. The pool only fails closed if there are zero
+ *     enabled agents at all — we surface that case as a warning,
+ *     not an error, since the user can fix it later by enabling
+ *     a worker.
+ */
+export declare function validateAssignableWorker(agents: WorkerAgent[], args: {
+    workerAgentId: string | null;
+    workerRole: string | null;
+}): {
+    code: string;
+    message: string;
+} | null;
+import type { WorkerPool } from "../worker/pool.js";
+/** Optional fields a worker kind can store on its agents. Every
+ *  kind always exposes `name` + `description`; the rest opt in.
+ *  The same set is used by the UI to decide which form rows to
+ *  render and by the REST handlers to reject fields a kind
+ *  hasn't opted into (so no stray system prompt sneaks onto an
+ *  echo agent). */
+export type WorkerKindField = "description" | "modelId" | "systemPrompt" | "toolsAllow" | "skills";
+export interface WorkerKindDef {
+    id: string;
+    displayName: string;
+    description?: string;
+    /** Default true. When false, hidden from the "new agent" picker;
+     *  used for demo runtimes that should only ever exist as seeds. */
+    userCreatable?: boolean;
+    /** Which optional fields this kind exposes in CRUD. `name` is
+     *  always allowed and isn't listed here. Default for backwards
+     *  compat is the full set ("description", "modelId",
+     *  "systemPrompt", "toolsAllow", "skills") so existing UI
+     *  doesn't lose anything; future kinds tighten the list. */
+    fields?: WorkerKindField[];
+}
+export declare const ALL_WORKER_KIND_FIELDS: readonly WorkerKindField[];
+export declare function allowedFieldsFor(kind: string, defs: WorkerKindDef[]): Set<WorkerKindField>;
+export interface RoutesDeps {
+    db: TenantDbHandle;
+    tenantId: string;
+    log: PluginLogger;
+    pool: WorkerPool;
+    /** Notify the worker pool that a task changed. */
+    onTaskWrite(): void;
+    /** Workboard-internal kind catalogue. Surfaced to the admin UI
+     *  so the picker only offers kinds the runtime can staff. */
+    workerKinds: WorkerKindDef[];
+    /**
+     * Returns the merged worker-agent inventory (fs first, DB
+     *  fallback) for the GET /agents endpoint. The plugin owns the
+     *  merge logic in `fs-worker-agents.ts`; this is just a
+     *  pluggable accessor so tests can inject a deterministic list.
+     */
+    listMergedAgents(): WorkerAgent[];
+    /**
+     * Per-agent effective skill list — what `<available_skills>`
+     * will actually contain when the worker runs. Combines:
+     *   - host self-shipped skills (`packages/server/skills/`)
+     *   - plugin skills via `host.skillCatalog`
+     *   - tenant shared skills (`_tenant/config/skills/`)
+     *   - tenant per-worker skills (`_tenant/config/workers/<slug>/skills/`)
+     *  Then narrows by the agent's `skillsAllow` (null = no
+     *  restriction; non-null = explicit allow-list — same rule
+     *  the agent loop applies).
+     *  Returns names only; the UI doesn't need bodies.
+     */
+    computeEffectiveSkills(agent: WorkerAgent): string[];
+    /**
+     * Flip the `enabled` field on a worker bundle's agent.json. The
+     * route layer wraps this; the deps callback exists so tests can
+     * stub the filesystem write.
+     */
+    setAgentEnabled(args: {
+        slug: string;
+        enabled: boolean;
+    }): {
+        ok: true;
+        enabled: boolean;
+    } | {
+        ok: false;
+        error: string;
+    };
+}
+export declare function buildRoutes(deps: RoutesDeps): Record<string, PluginRouteHandler>;
+//# sourceMappingURL=handlers.d.ts.map

package/plugins/workboard/dist/routes/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/routes/handlers.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,YAAY,EACb,MAAM,qBAAqB,CAAC;AAa7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,WAAW,EAAE,EACrB,IAAI,EAAE;IAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA+B1C;AACD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;mBAKmB;AACnB,MAAM,MAAM,eAAe,GACvB,aAAa,GACb,SAAS,GACT,cAAc,GACd,YAAY,GACZ,QAAQ,CAAC;AAEb,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;uEACmE;IACnE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;gEAI4D;IAC5D,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B;AAUD,eAAO,MAAM,sBAAsB,EAAE,SAAS,eAAe,EAM5D,CAAC;AAMF,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,aAAa,EAAE,GACpB,GAAG,CAAC,eAAe,CAAC,CAGtB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,cAAc,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,YAAY,CAAC;IAClB,IAAI,EAAE,UAAU,CAAC;IACjB,kDAAkD;IAClD,WAAW,IAAI,IAAI,CAAC;IACpB;iEAC6D;IAC7D,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B;;;;;OAKG;IACH,gBAAgB,IAAI,WAAW,EAAE,CAAC;IAClC;;;;;;;;;;;OAWG;IACH,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,EAAE,CAAC;IACrD;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,OAAO,CAAC;KAClB,GAAG;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACnE;AAyFD,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CA2iBhF"}