npm - @sulala/agent-os - Versions diffs - 0.1.23 → 0.1.24 - Mend

@sulala/agent-os 0.1.23 → 0.1.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (22) hide show

package/dashboard-dist/assets/index-CVI9FAmG.css +1 -0
package/dashboard-dist/assets/index-DdMu_Z6v.js +75 -0
package/dashboard-dist/index.html +2 -2
package/data/agents/crm_hubspot_agent.json +11 -0
package/data/agents/research_agent.json +1 -1
package/data/agents/social_media_agent.json +1 -1
package/data/agents/source_verify_agent.json +10 -0
package/data/agents/writer_agent.json +1 -1
package/data/skills/content-writing/SKILL.md +32 -0
package/dist/cli.js +123 -46
package/dist/index.js +113 -35
package/package.json +1 -1
package/data/skills/gmail/SKILL.md +0 -55
package/data/skills/gmail/references/send-email.md +0 -54
package/data/skills/gmail/scripts/send_email.py +0 -94
package/data/skills/youtube/SKILL.md +0 -91
package/data/skills/youtube/config.schema.json +0 -11
package/data/skills/youtube/package.json +0 -8
package/data/skills/youtube/references/youtube-upload.md +0 -65
package/data/skills/youtube/requirements.txt +0 -3
package/data/skills/youtube/scripts/youtube_upload.js +0 -200
package/data/skills/youtube/scripts/youtube_upload.py +0 -125

package/dashboard-dist/index.html CHANGED Viewed

@@ -5,8 +5,8 @@
     <link rel="icon" type="image/png" href="/logo_dark.png" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Sulala Agent Dashboard</title>
-    <script type="module" crossorigin src="/assets/index-DBbAuioJ.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-C2orVAIw.css">
+    <script type="module" crossorigin src="/assets/index-DdMu_Z6v.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-CVI9FAmG.css">
   </head>
   <body>
     <div id="root"></div>

package/data/agents/crm_hubspot_agent.json ADDED Viewed

@@ -0,0 +1,11 @@
+{
+  "id": "crm_hubspot_agent",
+  "name": "HubSpot CRM Agent",
+  "description": "Updates HubSpot from pipeline output: creates and updates contacts and deals using the crm-hubspot skill. Use as the last node in a sales graph to sync follow-up and lead status to HubSpot. Configure HUBSPOT_ACCESS_TOKEN in Skills → crm-hubspot.",
+  "model": "gpt-4o-mini",
+  "skills": ["memory", "crm-hubspot"],
+  "personality": "Concise and factual. Parse the input, call the crm-hubspot scripts via exec with skill_id 'crm-hubspot', then return only a short summary of what was created or updated in HubSpot.",
+  "limits": {
+    "max_turns": 15
+  }
+}

package/data/agents/research_agent.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "id": "research_agent",
   "name": "Research Assistant",
-  "description": "Search the web, fetch and summarize URLs, and follow RSS feeds. Use when the user asks to search for something, read a page, or get updates from a feed. Configure web-search API key in the skill if required.",
+  "description": "Search the web, fetch and summarize URLs, and follow RSS feeds. Use when the user asks to search for something, read a page, or get updates from a feed. In a graph/pipeline, only output your finding (e.g. the news summary); do not post to social media or delegate to other agents. Configure web-search API key in the skill if required.",
   "model": "gpt-4o-mini",
   "skills": ["memory", "web-search", "fetch", "rss"],
   "limits": {

package/data/agents/social_media_agent.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "id": "social_media_agent",
   "name": "Social Media Assistant",
-  "description": "Post to social networks (e.g. Bluesky), read your timeline, and reply to posts. Configure credentials in the skill (Agents → Edit → Skills, or Settings). Currently supports Bluesky.",
+  "description": "Post to social networks (e.g. Bluesky), read your timeline, and reply to posts. When used as the last node in a graph, post the text you receive to Bluesky. Configure credentials in the skill (Agents → Edit → Skills, or Settings). Currently supports Bluesky.",
   "model": "gpt-4o-mini",
   "skills": ["memory", "bluesky"],
   "limits": {

package/data/agents/source_verify_agent.json ADDED Viewed

@@ -0,0 +1,10 @@
+{
+  "id": "source_verify_agent",
+  "name": "Source Verify Agent",
+  "description": "Verify and summarize sources for news or claims. Use when the user or a pipeline asks to verify a source or fact-check. In a graph/pipeline, only output your verification result; do not post to social media or delegate to other agents.",
+  "model": "gpt-4o-mini",
+  "skills": ["memory", "web-search", "fetch"],
+  "limits": {
+    "max_turns": 15
+  }
+}

package/data/agents/writer_agent.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "id": "writer_agent",
   "name": "Writer Assistant",
-  "description": "Draft and send email (Gmail) and translate text. Use when the user wants to send an email or translate content. Gmail requires connection via Portal or skill config.",
+  "description": "Draft and send email (Gmail) and translate text. Use when the user wants to send an email or translate content. In a graph/pipeline, only rewrite or draft the content you are given; do not post to social media or delegate to other agents. Gmail requires connection via Portal or skill config.",
   "model": "gpt-4o-mini",
   "skills": ["memory", "gmail", "translate"],
   "limits": {

package/data/skills/content-writing/SKILL.md ADDED Viewed

@@ -0,0 +1,32 @@
+---
+name: content-writing
+description: Guidelines for writing articles and summaries. Use when the agent is the Writer in a newsroom pipeline, or when the user asks for an article, summary, or post draft.
+metadata:
+  clawdbot:
+    emoji: "✍️"
+---
+# Content writing
+Use this when you are the **Writer** agent: you receive topics, claims, or bullet points from other agents (e.g. News, Fact) and produce an article or summary.
+## Output types
+- **Summary** — Short (2–4 sentences or bullets). Key facts only, neutral tone.
+- **Article** — Headline + 2–5 short paragraphs. Clear structure: lead, key points, closing.
+- **Social post** — One short paragraph or 1–3 sentences, ready for Bluesky or similar (e.g. under 300 characters if needed).
+## Guidelines
+1. **Tone:** Neutral and factual for news; avoid speculation unless labeled as such.
+2. **Structure:** Lead with the main point; then supporting details; end with implication or next step if relevant.
+3. **Attribution:** When facts come from a specific source, mention it (e.g. "According to …", "Source: …").
+4. **Length:** Match the requested format (summary vs article vs post). If not specified, default to a short article (3–5 paragraphs).
+5. **No fabrication:** Only state facts that were provided or that you can infer from the given context; do not invent quotes or statistics.
+## Workflow
+1. Take the input (topic, verified facts, headlines, or bullet points).
+2. Choose the right output type (summary / article / post).
+3. Draft the content following the guidelines above.
+4. Optionally output in Markdown; if the pipeline needs HTML, the next step can use markdown-to-html.

package/dist/cli.js CHANGED Viewed

@@ -23180,8 +23180,8 @@ function formatLLMErrorForUser(err) {
 }
 function runAgentInner(options) {
   return (async () => {
-    const { task, agent, conversationHistory = [] } = options;
-    const maxTurns = agent.limits?.max_turns ?? 10;
+    const { task, agent, conversationHistory = [], maxTurnsOverride } = options;
+    const maxTurns = maxTurnsOverride ?? agent.limits?.max_turns ?? 10;
     const maxTokens = agent.limits?.max_tokens;
     await ensureWorkspace(agent.id);
     await loadSkillsForAgent(agent);
@@ -23415,8 +23415,8 @@ async function runAgent(options) {
   return runAgentInner(options);
 }
 async function runAgentStream(options, onEvent) {
-  const { task, agent, conversationHistory = [] } = options;
-  const maxTurns = agent.limits?.max_turns ?? 10;
+  const { task, agent, conversationHistory = [], maxTurnsOverride } = options;
+  const maxTurns = maxTurnsOverride ?? agent.limits?.max_turns ?? 10;
   const maxTokens = agent.limits?.max_tokens;
   await ensureWorkspace(agent.id);
   await loadSkillsForAgent(agent);
@@ -25375,44 +25375,87 @@ var require_node_cron = __commonJS((exports) => {
 });
 // src/core/graphs.ts
-import { readFile as readFile7, readdir as readdir4, writeFile as writeFile4, mkdir as mkdir5 } from "fs/promises";
+import { readFile as readFile7, readdir as readdir4, writeFile as writeFile4, mkdir as mkdir5, copyFile, unlink as unlink2 } from "fs/promises";
 import { join as join9 } from "path";
+import { existsSync as existsSync3 } from "fs";
 function getGraphsDir() {
   return process.env.AGENT_OS_GRAPHS_DIR || DEFAULT_GRAPHS_DIR;
 }
+function getSeedGraphsDir() {
+  if (process.env.AGENT_OS_SEED_GRAPHS_DIR)
+    return process.env.AGENT_OS_SEED_GRAPHS_DIR;
+  const fromDist = join9(import.meta.dir, "..", "data", "graphs");
+  const fromSrc = join9(import.meta.dir, "..", "..", "data", "graphs");
+  if (existsSync3(fromDist))
+    return fromDist;
+  if (existsSync3(fromSrc))
+    return fromSrc;
+  return join9(process.cwd(), "data", "graphs");
+}
 async function listGraphs() {
   const dir = getGraphsDir();
+  let entries;
   try {
-    const entries = await readdir4(dir);
-    const summaries = [];
-    for (const name of entries) {
-      if (name.endsWith(".json")) {
-        const id = name.replace(/\.graph\.json$/, "").replace(/\.json$/, "");
-        if (id)
-          summaries.push({ id });
+    entries = await readdir4(dir);
+  } catch (err) {
+    if (err.code !== "ENOENT")
+      throw err;
+    entries = [];
+  }
+  if (entries.length === 0) {
+    const seedDir = getSeedGraphsDir();
+    try {
+      const seedEntries = await readdir4(seedDir);
+      await mkdir5(dir, { recursive: true });
+      for (const name of seedEntries) {
+        if (name.endsWith(".json")) {
+          await copyFile(join9(seedDir, name), join9(dir, name));
+        }
       }
+      entries = await readdir4(dir);
+    } catch {}
+  }
+  const summaries = [];
+  for (const name of entries) {
+    if (name.endsWith(".json")) {
+      const id = name.replace(/\.graph\.json$/, "").replace(/\.json$/, "");
+      if (id)
+        summaries.push({ id });
     }
-    return summaries;
-  } catch (err) {
-    if (err.code === "ENOENT")
-      return [];
-    throw err;
   }
+  return summaries;
 }
 async function loadGraph(id) {
   const dir = getGraphsDir();
   try {
-    const entries = await readdir4(dir);
+    let entries;
+    try {
+      entries = await readdir4(dir);
+    } catch (e) {
+      if (e.code !== "ENOENT")
+        throw e;
+      entries = [];
+    }
     const file = entries.find((name) => name === `${id}.json` || name === `${id}.graph.json`);
-    if (!file)
+    if (file) {
+      const raw = await readFile7(join9(dir, file), "utf-8");
+      const parsed = JSON.parse(raw);
+      validateGraph(parsed);
+      return parsed;
+    }
+    const seedDir = getSeedGraphsDir();
+    const seedFile = `${id}.json`;
+    try {
+      const raw = await readFile7(join9(seedDir, seedFile), "utf-8");
+      const parsed = JSON.parse(raw);
+      validateGraph(parsed);
+      await mkdir5(dir, { recursive: true });
+      await writeFile4(join9(dir, seedFile), raw, "utf-8");
+      return parsed;
+    } catch {
       return null;
-    const raw = await readFile7(join9(dir, file), "utf-8");
-    const parsed = JSON.parse(raw);
-    validateGraph(parsed);
-    return parsed;
+    }
   } catch (err) {
-    if (err.code === "ENOENT")
-      return null;
     console.error("[graphs] Failed to load graph:", err);
     return null;
   }
@@ -25424,6 +25467,22 @@ async function saveGraph(graph) {
   const path = join9(dir, `${graph.id}.json`);
   await writeFile4(path, JSON.stringify(graph, null, 2), "utf-8");
 }
+async function deleteGraph(id) {
+  if (!id || typeof id !== "string")
+    throw new Error("Graph id required");
+  const dir = getGraphsDir();
+  let entries;
+  try {
+    entries = await readdir4(dir);
+  } catch (err) {
+    if (err.code !== "ENOENT")
+      throw err;
+    return;
+  }
+  const file = entries.find((name) => name === `${id}.json` || name === `${id}.graph.json`);
+  if (file)
+    await unlink2(join9(dir, file));
+}
 function validateGraph(graph) {
   if (!graph || typeof graph !== "object") {
     throw new Error("Graph must be an object");
@@ -25490,7 +25549,7 @@ function getPredecessors(graph) {
   return pred;
 }
 async function runGraph(options) {
-  const { graph, input } = options;
+  const { graph, input, max_turns_per_node = DEFAULT_GRAPH_MAX_TURNS_PER_NODE } = options;
   const levels = topologicalLevels(graph);
   const predecessors = getPredecessors(graph);
   const outputs = new Map;
@@ -25515,7 +25574,11 @@ async function runGraph(options) {
       const taskInput = preds.length === 0 ? input : preds.map((p) => outputs.get(p) ?? "").filter(Boolean).join(`
 `) || input;
-      const result = await runAgent({ agent, task: taskInput });
+      const result = await runAgent({
+        agent,
+        task: taskInput,
+        maxTurnsOverride: max_turns_per_node
+      });
       outputs.set(node.id, result.output || "");
       return {
         node_id: node.id,
@@ -25538,7 +25601,7 @@ async function runGraph(options) {
   };
 }
 async function runGraphStream(options, onEvent) {
-  const { graph, input } = options;
+  const { graph, input, max_turns_per_node = DEFAULT_GRAPH_MAX_TURNS_PER_NODE } = options;
   const levels = topologicalLevels(graph);
   const predecessors = getPredecessors(graph);
   const outputs = new Map;
@@ -25564,7 +25627,11 @@ async function runGraphStream(options, onEvent) {
         const taskInput = preds.length === 0 ? input : preds.map((p) => outputs.get(p) ?? "").filter(Boolean).join(`
 `) || input;
-        const result = await runAgent({ agent, task: taskInput });
+        const result = await runAgent({
+          agent,
+          task: taskInput,
+          maxTurnsOverride: max_turns_per_node
+        });
         outputs.set(node.id, result.output || "");
         const payload = {
           node_id: node.id,
@@ -25592,7 +25659,7 @@ async function runGraphStream(options, onEvent) {
     throw err;
   }
 }
-var DEFAULT_GRAPHS_DIR;
+var DEFAULT_GRAPHS_DIR, DEFAULT_GRAPH_MAX_TURNS_PER_NODE = 5;
 var init_graphs = __esm(() => {
   init_agent_registry();
   init_runtime();
@@ -29609,7 +29676,7 @@ __export(exports_server, {
   startServer: () => startServer
 });
 import { join as join13, dirname as dirname2, resolve as resolve4 } from "path";
-import { mkdirSync, existsSync as existsSync3 } from "fs";
+import { mkdirSync, existsSync as existsSync4 } from "fs";
 import { mkdir as mkdir7 } from "fs/promises";
 function isAuthExempt(pathname, method) {
   if (method === "OPTIONS")
@@ -29683,7 +29750,7 @@ function broadcastEvent(event) {
   }
 }
 function serveDashboard(pathname) {
-  if (!existsSync3(DASHBOARD_DIST) || !existsSync3(join13(DASHBOARD_DIST, "index.html"))) {
+  if (!existsSync4(DASHBOARD_DIST) || !existsSync4(join13(DASHBOARD_DIST, "index.html"))) {
     return null;
   }
   const decoded = decodeURIComponent(pathname);
@@ -29692,7 +29759,7 @@ function serveDashboard(pathname) {
   }
   const subpath = decoded === "/" ? "index.html" : decoded.slice(1);
   const filePath = join13(DASHBOARD_DIST, subpath);
-  if (existsSync3(filePath)) {
+  if (existsSync4(filePath)) {
     const file = Bun.file(filePath);
     const ext = subpath.split(".").pop() ?? "";
     const mime = {
@@ -29713,7 +29780,7 @@ function serveDashboard(pathname) {
     });
   }
   const indexPath = join13(DASHBOARD_DIST, "index.html");
-  if (existsSync3(indexPath)) {
+  if (existsSync4(indexPath)) {
     return new Response(Bun.file(indexPath), {
       headers: { "Content-Type": "text/html" }
     });
@@ -29930,6 +29997,16 @@ function createRoutes() {
           const msg = e instanceof Error ? e.message : String(e);
           return jsonResponse({ error: msg }, 400);
         }
+      },
+      DELETE: async (req) => {
+        const id = decodeURIComponent(req.params.id);
+        try {
+          await deleteGraph(id);
+          return Response.json({ ok: true }, { headers: CORS_HEADERS });
+        } catch (e) {
+          const msg = e instanceof Error ? e.message : String(e);
+          return jsonResponse({ error: msg }, 400);
+        }
       }
     },
     "/api/memory/write": {
@@ -30150,7 +30227,7 @@ async function startServer() {
   await loadPlugins();
   await seedAgentsIfEmpty();
   const dashboardSecret = await getDashboardSecret();
-  const dashboardMissing = !existsSync3(DASHBOARD_DIST) || !existsSync3(join13(DASHBOARD_DIST, "index.html"));
+  const dashboardMissing = !existsSync4(DASHBOARD_DIST) || !existsSync4(join13(DASHBOARD_DIST, "index.html"));
   if (dashboardMissing) {
     console.warn(`[sulala] Dashboard not found at ${DASHBOARD_DIST}. From package root run: cd dashboard && npm run build. If using a global install, reinstall: bun install -g @sulala/agent-os@latest`);
   }
@@ -30239,7 +30316,7 @@ var init_server = __esm(() => {
     const root = join13(import.meta.dir, "..");
     const a = resolve4(join13(root, "dashboard-dist"));
     const b = resolve4(join13(root, "dashboard", "dist"));
-    if (existsSync3(a) && existsSync3(join13(a, "index.html")))
+    if (existsSync4(a) && existsSync4(join13(a, "index.html")))
       return a;
     return b;
   })();
@@ -30272,8 +30349,8 @@ init_loader();
 init_agent_registry();
 init_runtime();
 import { join as join14, dirname as dirname3 } from "path";
-import { readFile as readFile10, writeFile as writeFile6, mkdir as mkdir8, unlink as unlink2 } from "fs/promises";
-import { existsSync as existsSync4, readFileSync } from "fs";
+import { readFile as readFile10, writeFile as writeFile6, mkdir as mkdir8, unlink as unlink3 } from "fs/promises";
+import { existsSync as existsSync5, readFileSync } from "fs";
 var PID_FILE = join14(getAgentOsHome(), "sulala.pid");
 var DEFAULT_PORT = 3010;
 function openDashboard() {
@@ -30336,7 +30413,7 @@ async function cmdStart(args) {
     await mkdir8(getAgentOsHome(), { recursive: true });
     const projectRoot = join14(import.meta.dir, "..");
     const distEntry = join14(projectRoot, "dist", "index.js");
-    const serverEntry = existsSync4(distEntry) ? "dist/index.js" : "src/index.ts";
+    const serverEntry = existsSync5(distEntry) ? "dist/index.js" : "src/index.ts";
     const child = Bun.spawn(["bun", "run", serverEntry], {
       cwd: projectRoot,
       stdout: "ignore",
@@ -30353,7 +30430,7 @@ async function cmdStart(args) {
   await startServer2();
 }
 async function cmdStop() {
-  if (!existsSync4(PID_FILE)) {
+  if (!existsSync5(PID_FILE)) {
     console.error("No PID file found. Is the server running with 'sulala start --daemon'?");
     process.exit(1);
   }
@@ -30374,11 +30451,11 @@ async function cmdStop() {
       process.exit(1);
     }
   }
-  await unlink2(PID_FILE).catch(() => {});
+  await unlink3(PID_FILE).catch(() => {});
   console.log("Sulala server stopped.");
 }
 async function startServerDaemonIfNeeded() {
-  if (existsSync4(PID_FILE)) {
+  if (existsSync5(PID_FILE)) {
     try {
       const pidStr = await readFile10(PID_FILE, "utf-8");
       const pid = parseInt(pidStr.trim(), 10);
@@ -30391,7 +30468,7 @@ async function startServerDaemonIfNeeded() {
   await mkdir8(getAgentOsHome(), { recursive: true });
   const projectRoot = join14(import.meta.dir, "..");
   const distEntry = join14(projectRoot, "dist", "index.js");
-  const serverEntry = existsSync4(distEntry) ? "dist/index.js" : "src/index.ts";
+  const serverEntry = existsSync5(distEntry) ? "dist/index.js" : "src/index.ts";
   const child = Bun.spawn(["bun", "run", serverEntry], {
     cwd: projectRoot,
     stdout: "ignore",
@@ -30408,7 +30485,7 @@ async function cmdOnboard() {
   await mkdir8(home, { recursive: true });
   await mkdir8(dirname3(getMemoryDbPath()), { recursive: true });
   const configPath = join14(home, "config.json");
-  if (!existsSync4(configPath)) {
+  if (!existsSync5(configPath)) {
     const dashboardSecret = generateDashboardSecret();
     await writeFile6(configPath, JSON.stringify({
       provider: null,
@@ -30471,7 +30548,7 @@ async function cmdUpdate() {
     console.warn("Could not update package from npm (run 'bun install -g @sulala/agent-os@latest' manually):", err.trim() || out.trim());
   }
   const dbPath = getMemoryDbPath();
-  if (!existsSync4(dbPath)) {
+  if (!existsSync5(dbPath)) {
     console.log("No database found. Run 'sulala onboard' to set up agents and skills.");
     return;
   }
@@ -30511,7 +30588,7 @@ async function cmdRun(args) {
     process.exit(1);
   }
   const dbPath = getMemoryDbPath();
-  if (existsSync4(dbPath)) {
+  if (existsSync5(dbPath)) {
     setAgentStore(new MemoryStore(dbPath));
   }
   const agent = await getAgent(agentId);