@jaggerxtrm/specialists 2.0.2 → 2.1.1

package/dist/index.js

@@ -24568,12 +24568,12 @@ class StdioServerTransport {
 }
 
 // src/server.ts
-import { join as join2 } from "node:path";
+import { join as join3 } from "node:path";
 
 // src/constants.ts
-var LOG_PREFIX = "[UAI-MCP]";
+var LOG_PREFIX = "[specialists]";
 var MCP_CONFIG = {
-  SERVER_NAME: "unitAI",
+  SERVER_NAME: "specialists",
   VERSION: "1.0.0",
   CAPABILITIES: {
     tools: {},
@@ -24748,6 +24748,7 @@ var SpecialistSchema = objectType({
     capabilities: CapabilitiesSchema,
     communication: CommunicationSchema,
     validation: ValidationSchema,
+    beads_integration: enumType(["auto", "always", "never"]).default("auto"),
     heartbeat: unknownType().optional()
   })
 });
@@ -25078,6 +25079,66 @@ class PiAgentSession {
   }
 }
 
+// src/specialist/beads.ts
+import { spawnSync } from "node:child_process";
+
+class BeadsClient {
+  available;
+  constructor() {
+    this.available = BeadsClient.checkAvailable();
+    if (!this.available) {
+      console.warn("[specialists] bd CLI not found — beads tracking disabled");
+    }
+  }
+  static checkAvailable() {
+    const result = spawnSync("bd", ["--version"], { stdio: "ignore" });
+    return result.status === 0;
+  }
+  isAvailable() {
+    return this.available;
+  }
+  createBead(specialistName) {
+    if (!this.available)
+      return null;
+    const result = spawnSync("bd", ["q", `specialist:${specialistName}`, "--type", "task", "--labels", "specialist"], { encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"] });
+    if (result.status !== 0)
+      return null;
+    const id = result.stdout?.trim();
+    return id || null;
+  }
+  closeBead(id, status, durationMs, model) {
+    if (!this.available || !id)
+      return;
+    const reason = `${status}, ${Math.round(durationMs)}ms, ${model}`;
+    spawnSync("bd", ["close", id, "-r", reason], { stdio: "ignore" });
+  }
+  auditBead(id, toolName, model, exitCode) {
+    if (!this.available || !id)
+      return;
+    spawnSync("bd", [
+      "audit",
+      "record",
+      "--kind",
+      "tool_call",
+      "--tool-name",
+      toolName,
+      "--model",
+      model,
+      "--issue-id",
+      id,
+      "--exit-code",
+      String(exitCode)
+    ], { stdio: "ignore" });
+  }
+}
+function shouldCreateBead(beadsIntegration, permissionRequired) {
+  if (beadsIntegration === "never")
+    return false;
+  if (beadsIntegration === "always")
+    return true;
+  return permissionRequired !== "READ_ONLY";
+}
+
 // src/specialist/runner.ts
 class SpecialistRunner {
   deps;
@@ -25086,8 +25147,8 @@ class SpecialistRunner {
     this.deps = deps;
     this.sessionFactory = deps.sessionFactory ?? PiAgentSession.create.bind(PiAgentSession);
   }
-  async run(options, onProgress, onEvent, onMeta, onKillRegistered) {
-    const { loader, hooks, circuitBreaker } = this.deps;
+  async run(options, onProgress, onEvent, onMeta, onKillRegistered, onBeadCreated) {
+    const { loader, hooks, circuitBreaker, beadsClient } = this.deps;
     const invocationId = crypto.randomUUID();
     const start = Date.now();
     const spec = await loader.get(options.name);
@@ -25142,6 +25203,13 @@ You have access via Bash:
       timeout_ms: execution.timeout_ms,
       permission_level: permissionLevel
     });
+    const beadsIntegration = spec.specialist.beads_integration ?? "auto";
+    let beadId;
+    if (beadsClient && shouldCreateBead(beadsIntegration, execution.permission_required)) {
+      beadId = beadsClient.createBead(metadata.name) ?? undefined;
+      if (beadId)
+        onBeadCreated?.(beadId);
+    }
     let output;
     let session;
     try {
@@ -25179,6 +25247,8 @@ You have access via Bash:
       circuitBreaker.recordSuccess(model);
     } catch (err) {
       circuitBreaker.recordFailure(model);
+      if (beadId)
+        beadsClient?.closeBead(beadId, "ERROR", Date.now() - start, model);
       await hooks.emit("post_execute", invocationId, metadata.name, metadata.version, {
         status: "ERROR",
         duration_ms: Date.now() - start,
@@ -25198,12 +25268,17 @@ You have access via Bash:
       duration_ms: durationMs,
       output_valid: true
     });
+    if (beadId) {
+      beadsClient?.closeBead(beadId, "COMPLETE", durationMs, model);
+      beadsClient?.auditBead(beadId, metadata.name, model, 0);
+    }
     return {
       output,
       backend: session.meta.backend,
       model,
       durationMs,
-      specialistVersion: metadata.version
+      specialistVersion: metadata.version,
+      beadId
     };
   }
   async startAsync(options, registry2) {
@@ -25218,7 +25293,7 @@ You have access via Bash:
       model: "?",
       specialistVersion
     });
-    this.run(options, (text) => registry2.appendOutput(jobId, text), (eventType) => registry2.setCurrentEvent(jobId, eventType), (meta) => registry2.setMeta(jobId, meta), (killFn) => registry2.setKillFn(jobId, killFn)).then((result) => registry2.complete(jobId, result)).catch((err) => registry2.fail(jobId, err));
+    this.run(options, (text) => registry2.appendOutput(jobId, text), (eventType) => registry2.setCurrentEvent(jobId, eventType), (meta) => registry2.setMeta(jobId, meta), (killFn) => registry2.setKillFn(jobId, killFn), (beadId) => registry2.setBeadId(jobId, beadId)).then((result) => registry2.complete(jobId, result)).catch((err) => registry2.fail(jobId, err));
     return jobId;
   }
 }
@@ -25478,6 +25553,12 @@ class JobRegistry {
     if (meta.model)
       job.model = meta.model;
   }
+  setBeadId(id, beadId) {
+    const job = this.jobs.get(id);
+    if (!job)
+      return;
+    job.beadId = beadId;
+  }
   setKillFn(id, killFn) {
     const job = this.jobs.get(id);
     if (!job)
@@ -25499,6 +25580,8 @@ class JobRegistry {
     job.model = result.model;
     job.specialistVersion = result.specialistVersion;
     job.endedAtMs = Date.now();
+    if (result.beadId)
+      job.beadId = result.beadId;
   }
   fail(id, err) {
     const job = this.jobs.get(id);
@@ -25535,7 +25618,8 @@ class JobRegistry {
       model: job.model,
       specialist_version: job.specialistVersion,
       duration_ms: (job.endedAtMs ?? Date.now()) - job.startedAtMs,
-      error: job.error
+      error: job.error,
+      beadId: job.beadId
     };
   }
   delete(id) {
@@ -25606,17 +25690,53 @@ function createStopSpecialistTool(registry2) {
   };
 }
 
+// src/tools/specialist/specialist_init.tool.ts
+import { spawnSync as spawnSync2 } from "node:child_process";
+import { existsSync as existsSync2 } from "node:fs";
+import { join as join2 } from "node:path";
+var specialistInitSchema = objectType({});
+function createSpecialistInitTool(loader, deps) {
+  const resolved = deps ?? {
+    bdAvailable: () => spawnSync2("bd", ["--version"], { stdio: "ignore" }).status === 0,
+    beadsExists: () => existsSync2(join2(process.cwd(), ".beads")),
+    bdInit: () => spawnSync2("bd", ["init"], { stdio: "ignore" })
+  };
+  return {
+    name: "specialist_init",
+    description: "Session bootstrap: initializes beads in the project if not already set up, " + "then returns available specialists. Call at session start for orientation.",
+    inputSchema: specialistInitSchema,
+    async execute(_input) {
+      const available = resolved.bdAvailable();
+      let initialized = false;
+      if (available) {
+        if (resolved.beadsExists()) {
+          initialized = true;
+        } else {
+          const result = resolved.bdInit();
+          initialized = result.status === 0;
+        }
+      }
+      const specialists = await loader.list();
+      return {
+        specialists,
+        beads: { available, initialized }
+      };
+    }
+  };
+}
+
 // src/server.ts
-class UnitAIServer {
+class SpecialistsServer {
   server;
   tools;
   constructor() {
     const circuitBreaker = new CircuitBreaker;
     const loader = new SpecialistLoader;
     const hooks = new HookEmitter({
-      tracePath: join2(process.cwd(), ".unitai", "trace.jsonl")
+      tracePath: join3(process.cwd(), ".specialists", "trace.jsonl")
     });
-    const runner = new SpecialistRunner({ loader, hooks, circuitBreaker });
+    const beadsClient = new BeadsClient;
+    const runner = new SpecialistRunner({ loader, hooks, circuitBreaker, beadsClient });
     const registry2 = new JobRegistry;
     this.tools = [
       createListSpecialistsTool(loader),
@@ -25625,7 +25745,8 @@ class UnitAIServer {
       createSpecialistStatusTool(loader, circuitBreaker),
       createStartSpecialistTool(runner, registry2),
       createPollSpecialistTool(registry2),
-      createStopSpecialistTool(registry2)
+      createStopSpecialistTool(registry2),
+      createSpecialistInitTool(loader)
     ];
     this.server = new Server({ name: MCP_CONFIG.SERVER_NAME, version: MCP_CONFIG.VERSION }, { capabilities: MCP_CONFIG.CAPABILITIES });
     this.setupHandlers();
@@ -25639,7 +25760,8 @@ class UnitAIServer {
       specialist_status: exports_external.object({}),
       start_specialist: startSpecialistSchema,
       poll_specialist: pollSpecialistSchema,
-      stop_specialist: stopSpecialistSchema
+      stop_specialist: stopSpecialistSchema,
+      specialist_init: specialistInitSchema
     };
     this.toolSchemas = schemaMap;
     this.server.setRequestHandler(ListToolsRequestSchema, async () => {
@@ -25665,7 +25787,7 @@ class UnitAIServer {
       const onProgress = (msg) => {
         this.server.notification({
           method: "notifications/message",
-          params: { level: "info", logger: "unitai", data: msg }
+          params: { level: "info", logger: "specialists", data: msg }
         }).catch(() => {});
       };
       try {
@@ -25689,7 +25811,7 @@ class UnitAIServer {
     try {
       const transport = new StdioServerTransport;
       await this.server.connect(transport);
-      logger.info(`UnitAI MCP Server v2 started — ${this.tools.length} tools registered`);
+      logger.info(`Specialists MCP Server v2 started — ${this.tools.length} tools registered`);
     } catch (error2) {
       logger.error("Failed to start server", error2);
       process.exit(1);
@@ -25702,8 +25824,8 @@ class UnitAIServer {
 
 // src/index.ts
 async function main() {
-  logger.info("Starting Unified AI MCP Tool server...");
-  const server = new UnitAIServer;
+  logger.info("Starting Specialists MCP Server...");
+  const server = new SpecialistsServer;
   await server.start();
 }
 main().catch((error2) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaggerxtrm/specialists",
-  "version": "2.0.2",
+  "version": "2.1.1",
   "description": "OmniSpecialist — 7-tool MCP orchestration layer powered by the Specialist System. Discover and execute .specialist.yaml files across project/user/system scopes via pi.",
   "main": "dist/index.js",
   "type": "module",