@cockpit-ai/agents 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,67 @@
+import { ResolvedAgent, AgentStatus } from '@cockpit-ai/core';
+
+/**
+ * Load a single agent from a YAML file and resolve it to ResolvedAgent.
+ * Throws ConfigLoadError or ConfigValidationError on failure.
+ */
+declare function loadAgentFromFile(filePath: string): ResolvedAgent;
+/**
+ * Load all agents from a directory (*.yaml, *.yml files).
+ * Skips files that fail to load, collecting errors separately.
+ */
+declare function loadAgentsFromDir(dirPath: string): {
+    agents: ResolvedAgent[];
+    errors: Array<{
+        file: string;
+        error: unknown;
+    }>;
+};
+
+declare class AgentRegistry {
+    private agents;
+    add(agent: ResolvedAgent): void;
+    get(name: string): ResolvedAgent | undefined;
+    has(name: string): boolean;
+    list(): ResolvedAgent[];
+    remove(name: string): boolean;
+    size(): number;
+    /**
+     * Load all agents from one or more directories into the registry.
+     * Returns any load errors encountered.
+     */
+    loadFromDirs(dirs: string[]): Array<{
+        file: string;
+        error: unknown;
+    }>;
+}
+
+interface AgentStateEntry {
+    status: AgentStatus;
+    startedAt?: string;
+    stoppedAt?: string;
+    pid?: number;
+}
+interface AgentState {
+    agents: Record<string, AgentStateEntry>;
+}
+/**
+ * Read the agent state from disk.
+ * Returns an empty state if the file does not exist.
+ */
+declare function readAgentState(): AgentState;
+/**
+ * Write the agent state to disk.
+ * Creates the ~/.cockpit directory if it does not exist.
+ */
+declare function writeAgentState(state: AgentState): void;
+/**
+ * Set the status for a named agent, updating timestamps as appropriate.
+ */
+declare function setAgentStatus(name: string, status: AgentStatus): void;
+/**
+ * Get the current status for a named agent.
+ * Returns "idle" if no state has been recorded.
+ */
+declare function getAgentStatus(name: string): AgentStatus;
+
+export { AgentRegistry, getAgentStatus, loadAgentFromFile, loadAgentsFromDir, readAgentState, setAgentStatus, writeAgentState };

package/dist/index.js

@@ -0,0 +1,138 @@
+// src/loader.ts
+import { readdirSync, existsSync } from "fs";
+import { join, extname } from "path";
+import {
+  loadConfig,
+  ConfigLoadError,
+  ConfigValidationError,
+  AgentDefinitionSchema
+} from "@cockpit-ai/core";
+function loadAgentFromFile(filePath) {
+  const raw = loadConfig(filePath, AgentDefinitionSchema);
+  return {
+    name: raw.name,
+    role: raw.role,
+    model: raw.model,
+    skills: raw.skills ?? [],
+    contextIncludes: raw.context?.include ?? [],
+    contextRules: raw.context?.rules ?? [],
+    worktreeConfig: {
+      autoCreate: raw.worktree?.auto_create ?? false,
+      branchPrefix: raw.worktree?.branch_prefix
+    },
+    sourcePath: filePath,
+    status: "idle"
+  };
+}
+function loadAgentsFromDir(dirPath) {
+  if (!existsSync(dirPath)) {
+    return { agents: [], errors: [] };
+  }
+  const agents = [];
+  const errors = [];
+  for (const entry of readdirSync(dirPath, { withFileTypes: true })) {
+    if (!entry.isFile()) continue;
+    const ext = extname(entry.name);
+    if (ext !== ".yaml" && ext !== ".yml") continue;
+    const filePath = join(dirPath, entry.name);
+    try {
+      agents.push(loadAgentFromFile(filePath));
+    } catch (err) {
+      if (err instanceof ConfigLoadError || err instanceof ConfigValidationError) {
+        errors.push({ file: filePath, error: err });
+      } else {
+        throw err;
+      }
+    }
+  }
+  return { agents, errors };
+}
+
+// src/registry.ts
+var AgentRegistry = class {
+  agents = /* @__PURE__ */ new Map();
+  add(agent) {
+    this.agents.set(agent.name, agent);
+  }
+  get(name) {
+    return this.agents.get(name);
+  }
+  has(name) {
+    return this.agents.has(name);
+  }
+  list() {
+    return [...this.agents.values()];
+  }
+  remove(name) {
+    return this.agents.delete(name);
+  }
+  size() {
+    return this.agents.size;
+  }
+  /**
+   * Load all agents from one or more directories into the registry.
+   * Returns any load errors encountered.
+   */
+  loadFromDirs(dirs) {
+    const allErrors = [];
+    for (const dir of dirs) {
+      const { agents, errors } = loadAgentsFromDir(dir);
+      for (const agent of agents) {
+        this.add(agent);
+      }
+      allErrors.push(...errors);
+    }
+    return allErrors;
+  }
+};
+
+// src/state.ts
+import { readFileSync, writeFileSync, mkdirSync, existsSync as existsSync2 } from "fs";
+import { join as join2, dirname } from "path";
+import { homedir } from "os";
+var STATE_FILE = join2(homedir(), ".cockpit", "agent-state.json");
+function readAgentState() {
+  if (!existsSync2(STATE_FILE)) {
+    return { agents: {} };
+  }
+  try {
+    const raw = readFileSync(STATE_FILE, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return { agents: {} };
+  }
+}
+function writeAgentState(state) {
+  const dir = dirname(STATE_FILE);
+  if (!existsSync2(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  writeFileSync(STATE_FILE, JSON.stringify(state, null, 2), "utf-8");
+}
+function setAgentStatus(name, status) {
+  const state = readAgentState();
+  const existing = state.agents[name] ?? { status: "idle" };
+  const updated = { ...existing, status };
+  if (status === "running") {
+    updated.startedAt = (/* @__PURE__ */ new Date()).toISOString();
+    delete updated.stoppedAt;
+  } else if (status === "stopped" || status === "error") {
+    updated.stoppedAt = (/* @__PURE__ */ new Date()).toISOString();
+  }
+  state.agents[name] = updated;
+  writeAgentState(state);
+}
+function getAgentStatus(name) {
+  const state = readAgentState();
+  return state.agents[name]?.status ?? "idle";
+}
+export {
+  AgentRegistry,
+  getAgentStatus,
+  loadAgentFromFile,
+  loadAgentsFromDir,
+  readAgentState,
+  setAgentStatus,
+  writeAgentState
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/loader.ts","../src/registry.ts","../src/state.ts"],"sourcesContent":["import { readdirSync, existsSync } from \"node:fs\";\nimport { join, extname } from \"node:path\";\nimport {\n  loadConfig,\n  ConfigLoadError,\n  ConfigValidationError,\n  AgentDefinitionSchema,\n  type ResolvedAgent,\n} from \"@cockpit-ai/core\";\n\n// ─── Agent Loader ───────────────────────────────────────────────────────────\n\n/**\n * Load a single agent from a YAML file and resolve it to ResolvedAgent.\n * Throws ConfigLoadError or ConfigValidationError on failure.\n */\nexport function loadAgentFromFile(filePath: string): ResolvedAgent {\n  const raw = loadConfig(filePath, AgentDefinitionSchema);\n\n  return {\n    name: raw.name,\n    role: raw.role,\n    model: raw.model,\n    skills: raw.skills ?? [],\n    contextIncludes: raw.context?.include ?? [],\n    contextRules: raw.context?.rules ?? [],\n    worktreeConfig: {\n      autoCreate: raw.worktree?.auto_create ?? false,\n      branchPrefix: raw.worktree?.branch_prefix,\n    },\n    sourcePath: filePath,\n    status: \"idle\",\n  };\n}\n\n/**\n * Load all agents from a directory (*.yaml, *.yml files).\n * Skips files that fail to load, collecting errors separately.\n */\nexport function loadAgentsFromDir(dirPath: string): {\n  agents: ResolvedAgent[];\n  errors: Array<{ file: string; error: unknown }>;\n} {\n  if (!existsSync(dirPath)) {\n    return { agents: [], errors: [] };\n  }\n\n  const agents: ResolvedAgent[] = [];\n  const errors: Array<{ file: string; error: unknown }> = [];\n\n  for (const entry of readdirSync(dirPath, { withFileTypes: true })) {\n    if (!entry.isFile()) continue;\n    const ext = extname(entry.name);\n    if (ext !== \".yaml\" && ext !== \".yml\") continue;\n\n    const filePath = join(dirPath, entry.name);\n    try {\n      agents.push(loadAgentFromFile(filePath));\n    } catch (err) {\n      if (err instanceof ConfigLoadError || err instanceof ConfigValidationError) {\n        errors.push({ file: filePath, error: err });\n      } else {\n        throw err;\n      }\n    }\n  }\n\n  return { agents, errors };\n}\n","import { type ResolvedAgent } from \"@cockpit-ai/core\";\nimport { loadAgentsFromDir } from \"./loader.js\";\n\n// ─── Agent Registry ─────────────────────────────────────────────────────────\n\nexport class AgentRegistry {\n  private agents = new Map<string, ResolvedAgent>();\n\n  add(agent: ResolvedAgent): void {\n    this.agents.set(agent.name, agent);\n  }\n\n  get(name: string): ResolvedAgent | undefined {\n    return this.agents.get(name);\n  }\n\n  has(name: string): boolean {\n    return this.agents.has(name);\n  }\n\n  list(): ResolvedAgent[] {\n    return [...this.agents.values()];\n  }\n\n  remove(name: string): boolean {\n    return this.agents.delete(name);\n  }\n\n  size(): number {\n    return this.agents.size;\n  }\n\n  /**\n   * Load all agents from one or more directories into the registry.\n   * Returns any load errors encountered.\n   */\n  loadFromDirs(dirs: string[]): Array<{ file: string; error: unknown }> {\n    const allErrors: Array<{ file: string; error: unknown }> = [];\n\n    for (const dir of dirs) {\n      const { agents, errors } = loadAgentsFromDir(dir);\n      for (const agent of agents) {\n        this.add(agent);\n      }\n      allErrors.push(...errors);\n    }\n\n    return allErrors;\n  }\n}\n","import { readFileSync, writeFileSync, mkdirSync, existsSync } from \"node:fs\";\nimport { join, dirname } from \"node:path\";\nimport { homedir } from \"node:os\";\nimport { type AgentStatus } from \"@cockpit-ai/core\";\n\n// ─── Agent State ────────────────────────────────────────────────────────────\n\nconst STATE_FILE = join(homedir(), \".cockpit\", \"agent-state.json\");\n\ninterface AgentStateEntry {\n  status: AgentStatus;\n  startedAt?: string;\n  stoppedAt?: string;\n  pid?: number;\n}\n\ninterface AgentState {\n  agents: Record<string, AgentStateEntry>;\n}\n\n/**\n * Read the agent state from disk.\n * Returns an empty state if the file does not exist.\n */\nexport function readAgentState(): AgentState {\n  if (!existsSync(STATE_FILE)) {\n    return { agents: {} };\n  }\n\n  try {\n    const raw = readFileSync(STATE_FILE, \"utf-8\");\n    return JSON.parse(raw) as AgentState;\n  } catch {\n    return { agents: {} };\n  }\n}\n\n/**\n * Write the agent state to disk.\n * Creates the ~/.cockpit directory if it does not exist.\n */\nexport function writeAgentState(state: AgentState): void {\n  const dir = dirname(STATE_FILE);\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true });\n  }\n  writeFileSync(STATE_FILE, JSON.stringify(state, null, 2), \"utf-8\");\n}\n\n/**\n * Set the status for a named agent, updating timestamps as appropriate.\n */\nexport function setAgentStatus(name: string, status: AgentStatus): void {\n  const state = readAgentState();\n  const existing = state.agents[name] ?? { status: \"idle\" };\n\n  const updated: AgentStateEntry = { ...existing, status };\n\n  if (status === \"running\") {\n    updated.startedAt = new Date().toISOString();\n    delete updated.stoppedAt;\n  } else if (status === \"stopped\" || status === \"error\") {\n    updated.stoppedAt = new Date().toISOString();\n  }\n\n  state.agents[name] = updated;\n  writeAgentState(state);\n}\n\n/**\n * Get the current status for a named agent.\n * Returns \"idle\" if no state has been recorded.\n */\nexport function getAgentStatus(name: string): AgentStatus {\n  const state = readAgentState();\n  return state.agents[name]?.status ?? \"idle\";\n}\n"],"mappings":"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","names":["existsSync","join"]}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@cockpit-ai/agents",
+  "version": "0.1.0",
+  "description": "Cockpit agent loader and registry",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cockpit-ai/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  }
+}