@sulala/agent-os 0.1.23 → 0.1.24

package/dist/index.js

@@ -26537,8 +26537,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);
@@ -26772,8 +26772,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);
@@ -27214,45 +27214,88 @@ import { readFile as readFile8, appendFile as appendFile2, mkdir as mkdir6 } fro
 import { join as join10 } from "path";
 
 // 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";
 var DEFAULT_GRAPHS_DIR = join9(process.env.HOME || process.env.USERPROFILE || "~", ".agent-os", "graphs");
 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;
   }
@@ -27264,6 +27307,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");
@@ -27278,6 +27337,7 @@ function validateGraph(graph) {
     throw new Error("Graph.edges must be an array");
   }
 }
+var DEFAULT_GRAPH_MAX_TURNS_PER_NODE = 5;
 function topologicalLevels(graph) {
   const nodes = graph.nodes.map((n) => n.id);
   const incoming = new Map;
@@ -27330,7 +27390,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;
@@ -27355,7 +27415,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,
@@ -27378,7 +27442,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;
@@ -27404,7 +27468,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,
@@ -29099,14 +29167,14 @@ async function loadPlugins() {
 // src/server.ts
 init_config();
 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";
 var PORT = parseInt(process.env.PORT ?? "3010", 10);
 var DASHBOARD_DIST = (() => {
   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;
 })();
@@ -29198,7 +29266,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);
@@ -29207,7 +29275,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 = {
@@ -29228,7 +29296,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" }
     });
@@ -29448,6 +29516,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": {
@@ -29668,7 +29746,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`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sulala/agent-os",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "publishConfig": {
     "access": "public"
   },

package/data/skills/gmail/SKILL.md

@@ -1,55 +0,0 @@
----
-name: gmail
-description: Send email via Gmail using your connected account. Uses Sulala Portal for the access token; includes a script to send email from the command line or automation. Requires the Sulala Portal skill for token. Use when the user wants to send email, compose mail, or automate Gmail sending.
-metadata:
-  sulala:
-    requires:
-      skills:
-        - sulala-portal
----
-
-# Gmail (Sulala Portal)
-
-Send email using your **Gmail account connected in the Sulala Portal**. This skill provides a **script**; use the **exec** tool to run it. No static send-email code in the loader; the skill is script + docs like YouTube Shorts automation.
-
-## Overview
-
-1. **Get an access token** from the Portal (list connections, then `POST connections/{connection_id}/use` for Gmail).
-2. **Send email** by running the script via **exec** (see below).
-
-## Getting the token (Portal)
-
-- **Tool**: `sulala-portal_request`
-- **List connections**: `GET` path `connections` (filter by `provider === "gmail"` in the response).
-- **Get token**: `POST` path `connections/{id}/use`. Use the connection’s `connection_id` from the list (e.g. `conn_gmail_...`). If you get 404, use `connection_id` in the path instead of `id`. Response: `{ connectionId, provider, accessToken, scopes }`.
-
-## Sending email (use exec tool + script — preferred)
-
-Use the **exec** tool to run the skill script. No need to build RFC 2822 or base64url by hand.
-
-1. Get **accessToken** from the Portal (`sulala-portal_request`: list connections, then `POST connections/{connection_id}/use` with the Gmail connection’s `connection_id`).
-2. Call **exec** with:
-   - **skill_id**: `"gmail"` (so the command runs in this skill’s directory).
-   - **command**: `python3 scripts/send_email.py --token "<accessToken>" --to "recipient@example.com" --subject "Subject line" --body "Email body text."`
-
-Example exec call:
-
-```json
-{
-  "skill_id": "gmail",
-  "command": "python3 scripts/send_email.py --token \"<paste accessToken from Portal>\" --to \"sai.ko@mothernode.com\" --subject \"test title\" --body \"test body\""
-}
-```
-
-- **Token**: from `POST connections/{connection_id}/use` (see above).
-- **To**, **Subject**, **Body**: recipient email, subject line, and body text. Escape quotes inside the command string as needed.
-
-Full script options: [references/send-email.md](references/send-email.md).
-
-## Skill layout (like YouTube Shorts automation)
-
-- **scripts/send_email.py** — runnable script: `--token`, `--to`, `--subject`, `--body` or `--body-file`.
-- **references/send-email.md** — how to run the script and get the token.
-- **SKILL.md** — this file: overview, get token, send via exec + script.
-
-No separate config: the Sulala Portal skill provides the gateway and token; this skill adds the script and docs.

package/data/skills/gmail/references/send-email.md

@@ -1,54 +0,0 @@
-# Send email script
-
-The Gmail skill includes a script that sends email using the Gmail API with an OAuth2 access token. Use it when you have a token (e.g. from Sulala Portal) and want to send from the command line or from automation.
-
-## Prerequisites
-
-- **Access token**: Obtain from Sulala Portal (`POST connections/{connection_id}/use` with your Gmail connection), or from your own OAuth flow. Token must have `https://www.googleapis.com/auth/gmail.send` scope.
-- **Python 3.6+**: No extra pip packages; script uses only the standard library.
-
-## Usage
-
-From the skill directory (or with paths adjusted):
-
-```bash
-python3 scripts/send_email.py \
-  --token "YOUR_ACCESS_TOKEN" \
-  --to "recipient@example.com" \
-  --subject "Subject line" \
-  --body "Email body text."
-```
-
-With body from a file:
-
-```bash
-python3 scripts/send_email.py \
-  --token "YOUR_ACCESS_TOKEN" \
-  --to "recipient@example.com" \
-  --subject "Subject" \
-  --body-file path/to/body.txt
-```
-
-## Options
-
-| Option       | Required | Description                          |
-|-------------|----------|--------------------------------------|
-| `--token`   | Yes      | OAuth2 access token (Bearer).        |
-| `--to`      | Yes      | Recipient email address.             |
-| `--subject` | Yes      | Email subject line.                  |
-| `--body`    | One of   | Email body as a string.              |
-| `--body-file` | One of | Path to file containing body text.  |
-
-## Getting the token (Sulala Portal)
-
-1. Call the Portal API to list connections: `GET connections` (filter for `provider === "gmail"`).
-2. Call `POST connections/{connection_id}/use` with the Gmail connection’s `connection_id` (e.g. `conn_gmail_...`; use `connection_id` if `id` returns 404).
-3. Use the `accessToken` from the response as `--token`.
-
-## Troubleshooting
-
-| Problem              | Cause                    | Action                          |
-|----------------------|--------------------------|---------------------------------|
-| 401 Unauthorized      | Token expired or invalid | Refresh or re-issue token.      |
-| Recipient required   | Missing/invalid To       | Ensure `--to` is a valid email. |
-| Invalid To header    | Bad To format            | Use plain email, no extra text. |

package/data/skills/gmail/scripts/send_email.py

@@ -1,94 +0,0 @@
-#!/usr/bin/env python3
-"""Send email via Gmail API using an OAuth access token.
-
-Use when you have a token from Sulala Portal (connections/:id/use) or another source.
-No local OAuth files required; pass the token on the command line.
-
-Usage:
-  python3 send_email.py --token TOKEN --to recipient@example.com --subject "Subject" --body "Body text"
-  python3 send_email.py --token TOKEN --to recipient@example.com --subject "Subject" --body-file body.txt
-
-Requires: Python 3.6+. No extra pip packages (uses urllib and base64 from stdlib).
-"""
-
-import argparse
-import base64
-import json
-import sys
-import urllib.request
-import urllib.error
-
-GMAIL_SEND_URL = "https://gmail.googleapis.com/gmail/v1/users/me/messages/send"
-
-
-def base64url_encode(data: bytes) -> str:
-    """Encode bytes to base64url (RFC 4648): no +/ padding, use -_."""
-    b64 = base64.b64encode(data).decode("ascii")
-    return b64.replace("+", "-").replace("/", "_").rstrip("=")
-
-
-def build_rfc2822(to: str, subject: str, body: str) -> str:
-    """Build a minimal RFC 2822 message (CRLF line endings)."""
-    lines = [
-        f"To: {to}",
-        f"Subject: {subject}",
-        "Content-Type: text/plain; charset=UTF-8",
-        "",
-        body,
-    ]
-    return "\r\n".join(lines)
-
-
-def send(token: str, to: str, subject: str, body: str) -> None:
-    rfc2822 = build_rfc2822(to, subject, body)
-    raw = base64url_encode(rfc2822.encode("utf-8"))
-    body_json = json.dumps({"raw": raw}).encode("utf-8")
-
-    req = urllib.request.Request(
-        GMAIL_SEND_URL,
-        data=body_json,
-        headers={
-            "Authorization": f"Bearer {token}",
-            "Content-Type": "application/json",
-        },
-        method="POST",
-    )
-    try:
-        with urllib.request.urlopen(req) as resp:
-            if resp.status != 200:
-                sys.stderr.write(f"Unexpected status: {resp.status}\n")
-                sys.exit(1)
-            print("Email sent successfully.")
-    except urllib.error.HTTPError as e:
-        sys.stderr.write(f"Gmail API error: {e.code} {e.reason}\n")
-        if e.fp:
-            body = e.fp.read().decode("utf-8", errors="replace")
-            sys.stderr.write(body)
-            sys.stderr.write("\n")
-        sys.exit(1)
-    except OSError as e:
-        sys.stderr.write(f"Request failed: {e}\n")
-        sys.exit(1)
-
-
-def main() -> None:
-    ap = argparse.ArgumentParser(description="Send email via Gmail API with an access token.")
-    ap.add_argument("--token", required=True, help="OAuth2 access token (e.g. from Sulala Portal)")
-    ap.add_argument("--to", required=True, help="Recipient email address")
-    ap.add_argument("--subject", required=True, help="Email subject")
-    group = ap.add_mutually_exclusive_group(required=True)
-    group.add_argument("--body", help="Email body (plain text)")
-    group.add_argument("--body-file", help="Path to file containing email body")
-    args = ap.parse_args()
-
-    if args.body is not None:
-        body = args.body
-    else:
-        with open(args.body_file, "r", encoding="utf-8") as f:
-            body = f.read()
-
-    send(args.token, args.to, args.subject, body)
-
-
-if __name__ == "__main__":
-    main()

package/data/skills/youtube/SKILL.md

@@ -1,91 +0,0 @@
----
-name: youtube
-description: Upload videos (or Shorts) to YouTube using a local OAuth setup. Uses a script in the skill directory; run it via the exec tool. Use when the user wants to upload a video, publish to YouTube, or upload Shorts.
-credentials:
-  - YOUTUBE_CLIENT_SECRET_JSON
----
-
-
-# YouTube upload
-
-Upload videos to **YouTube** using a **script** in this skill. Credentials are stored in the skill directory (`client_secret.json` + `token.json`). Use the **exec** tool to run the script; no static upload code in the loader.
-
-## Overview
-
-1. **One-time setup**: Enable YouTube Data API v3, create an OAuth Desktop client, add the client JSON via Skills → Configure (or place `client_secret.json` in the skill). Install Node dependencies with **npm install** (see below). Run the upload script once to complete browser OAuth; `token.json` is saved for reuse.
-2. **Upload**: Use **exec** with `skill_id: "youtube"` and a `command` that runs **node scripts/youtube_upload.js** (recommended) or the Python script, with `--file`, `--title`, and optional `--description`, `--tags`, `--privacy`.
-
-## Setup
-
-Follow these steps so the skill can upload to your YouTube account. The **Skills → YouTube → Configure** dialog (Setup button) shows this section and a field for the client JSON.
-
-1. **Google Cloud project**  
-   Go to [Google Cloud Console](https://console.cloud.google.com/). Create or select a project.
-
-2. **Enable YouTube Data API v3**  
-   APIs & Services → Library → search “YouTube Data API v3” → Enable.
-
-3. **Create OAuth 2.0 credentials**  
-   APIs & Services → Credentials → Create Credentials → **OAuth client ID**.  
-   - If asked, configure the OAuth consent screen (e.g. External, add your email).  
-   - Application type: **Web application** (so you can set a redirect URI).  
-   - Name: e.g. “YouTube upload”.  
-   - Under **Authorized redirect URIs**, click Add URI and add exactly:  
-     **`http://localhost:8090/`**  
-     (If this is missing, you will get “Error 400: redirect_uri_mismatch” when signing in.)  
-   - Create. Copy or download the client JSON.
-
-4. **Add the client JSON to this skill**  
-   Paste the **full JSON** (the whole file content) into the **OAuth client JSON** field below (Skills → YouTube → Configure), then Save.  
-   Alternatively, save the file as `scripts/client_secret.json` in the YouTube skill directory.
-
-5. **Install Node dependencies**  
-   From the skill directory run: `npm install`. The agent can do this via exec with `skill_id: "youtube"`, `command: "npm install"`.
-
-6. **First sign-in**  
-   Run the upload script once (e.g. with a test video). A browser opens; sign in with your Google account and allow access. After that, `token.json` is saved and future uploads do not require signing in again.
-
-Details: [references/youtube-upload.md](references/youtube-upload.md).
-
-## Install dependencies (agent must do this when needed)
-
-**Preferred (Node):** If the Node script fails with "Missing npm dependencies", or before first upload, install with **exec** and `skill_id: "youtube"`, `command: "npm install"`. Then retry. No system Python or pip needed.
-
-**Optional (Python):** If using the Python script and it reports missing Google API packages, use a virtual environment; the agent cannot install into system Python on externally-managed systems (e.g. macOS).
-
-## Upload video (exec tool)
-
-Use **exec** with `skill_id: "youtube"` (command runs in the skill directory).
-
-**Recommended — Node script (no Python/pip):**  
-`node scripts/youtube_upload.js --file <path> --title "<title>" [--description "<desc>"] [--tags "tag1,tag2"] [--privacy public|private|unlisted]`
-
-Example:
-
-```json
-{
-  "skill_id": "youtube",
-  "command": "node scripts/youtube_upload.js --file /path/to/video.mp4 --title \"My video\" --description \"Optional\" --tags \"shorts,demo\" --privacy public"
-}
-```
-
-**Optional — Python script** (requires venv + pip): `python3 scripts/youtube_upload.py --file ... --title ...`
-
-- **--file**: Path to the video file (absolute or relative to skill dir). Must be reachable where the agent runs.
-- **--title**: Required. **--description**, **--tags**, **--privacy** optional (default: `public`).
-
-**Interpreting exec result:** After running the upload script, check **stdout**. If it contains a line like `Uploaded: https://youtube.com/watch?v=...`, the upload **succeeded**. Tell the user the video was uploaded and give them that URL. Do not say authorization is required when stdout shows a success URL. If exitCode is non-zero but stdout contains the upload URL, still report success (the script may have been interrupted after writing the URL). Only when stdout has no upload URL and stderr says "Open this URL in your browser" should you ask the user to authorize.
-
-Full script options: [references/youtube-upload.md](references/youtube-upload.md).
-
-## Skill layout
-
-- **scripts/youtube_upload.js** — Node upload script (recommended): `--file`, `--title`, `--description`, `--tags`, `--privacy`. No Python/pip required.
-- **scripts/youtube_upload.py** — Python upload script (optional; requires venv + pip install).
-- **package.json** — Node dependencies (googleapis). Run `npm install` in the skill dir.
-- **config.schema.json** — defines `YOUTUBE_CLIENT_SECRET_JSON` for the Skills config UI.
-- **scripts/client_secret.json** — (optional) OAuth client JSON if not set via Skills → Configure.
-- **scripts/token.json** — (created on first run) stored credentials; shared by both scripts.
-- **requirements.txt** — pip dependencies for the Python script only.
-- **references/youtube-upload.md** — setup, usage, and exec examples.
-- **SKILL.md** — this file.

package/data/skills/youtube/config.schema.json

@@ -1,11 +0,0 @@
-{
-  "type": "object",
-  "properties": {
-    "YOUTUBE_CLIENT_SECRET_JSON": {
-      "type": "string",
-      "format": "password",
-      "title": "OAuth client JSON",
-      "description": "Paste the full content of client_secret.json from Google Cloud Console (Desktop OAuth 2.0 client, YouTube Data API v3 enabled). Alternatively place the file as scripts/client_secret.json in this skill directory."
-    }
-  }
-}

package/data/skills/youtube/package.json

@@ -1,8 +0,0 @@
-{
-  "name": "youtube-skill",
-  "private": true,
-  "description": "YouTube upload script dependencies",
-  "dependencies": {
-    "googleapis": "^144.0.0"
-  }
-}

package/data/skills/youtube/references/youtube-upload.md

@@ -1,65 +0,0 @@
-# YouTube upload script
-
-Upload a video to YouTube using OAuth credentials. The script reads credentials from **Skills config** (env `YOUTUBE_CLIENT_SECRET_JSON`, set via Dashboard → Skills → YouTube → Configure) or from `scripts/client_secret.json`, and saves `token.json` after the first browser OAuth flow.
-
-## Prerequisites
-
-- **Google Cloud project** with YouTube Data API v3 enabled.
-- **OAuth 2.0 Client** (Desktop app): add the JSON via **Skills → YouTube → Configure** (paste full content), or save as `data/skills/youtube/scripts/client_secret.json`.
-- **Python 3** with pip packages from `data/skills/youtube/requirements.txt`:
-  ```bash
-  pip install -r data/skills/youtube/requirements.txt
-  ```
-  Or: `google-api-python-client`, `google-auth-oauthlib`, `google-auth-httplib2`.
-
-## One-time setup
-
-1. In [Google Cloud Console](https://console.cloud.google.com/): create or select a project → APIs & Services → Enable **YouTube Data API v3**.
-2. Create **OAuth 2.0 Client ID** (Application type: Desktop app). Download the JSON.
-3. Add the JSON via **Skills → YouTube → Configure** (paste the full content), or save as `client_secret.json` in the skill’s **scripts** directory.
-4. Run the script once with any test args; a browser will open to sign in. After authorizing, `token.json` is created in the same directory. Future runs use this token (refreshed automatically).
-
-## Usage
-
-From the skill directory (or use **exec** with `skill_id: "youtube"` so cwd is the skill dir):
-
-```bash
-python3 scripts/youtube_upload.py \
-  --file /path/to/video.mp4 \
-  --title "My video title" \
-  --description "Optional description" \
-  --tags "shorts,demo" \
-  --privacy public
-```
-
-## Options
-
-| Option         | Required | Description                                      |
-|----------------|----------|--------------------------------------------------|
-| `--file`       | Yes      | Path to video file (absolute or relative to script dir). |
-| `--title`      | Yes      | Video title.                                     |
-| `--description`| No       | Video description (default: empty).              |
-| `--tags`       | No       | Comma-separated tags (e.g. `shorts,demo`).       |
-| `--privacy`    | No       | `public`, `private`, or `unlisted` (default: public).    |
-
-## Agent usage (exec tool)
-
-Use the **exec** tool with `skill_id: "youtube"` so the command runs in the YouTube skill directory:
-
-```json
-{
-  "skill_id": "youtube",
-  "command": "python3 scripts/youtube_upload.py --file /path/to/video.mp4 --title \"My title\" --description \"Description\" --tags \"tag1,tag2\" --privacy public"
-}
-```
-
-Ensure the video file path is accessible from the environment where the agent runs (e.g. workspace path or absolute path). Quotes inside the command string must be escaped as required by the shell.
-
-## Troubleshooting
-
-| Problem                    | Cause                          | Action                                      |
-|----------------------------|---------------------------------|---------------------------------------------|
-| client_secret.json not found / YOUTUBE_CLIENT_SECRET_JSON not set | Credentials missing | Add via Skills → YouTube → Configure or place `scripts/client_secret.json`. |
-| Token expired / invalid    | First run or token revoked     | Delete `token.json` and run again to re-auth. |
-| File not found             | Wrong path for `--file`        | Use absolute path or path relative to script dir. |
-| Quota exceeded             | YouTube API quota              | Check quota in Cloud Console; wait or request increase. |

package/data/skills/youtube/requirements.txt

@@ -1,3 +0,0 @@
-google-api-python-client
-google-auth-oauthlib
-google-auth-httplib2