@sulala/agent-os 0.1.23 → 0.1.25

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

package/data/skills/youtube/scripts/youtube_upload.js

@@ -1,200 +0,0 @@
-#!/usr/bin/env node
-/**
- * Upload a video to YouTube. Uses OAuth credentials from YOUTUBE_CLIENT_SECRET_JSON
- * (Skills config) or scripts/client_secret.json. Saves token.json in scripts/ for reuse.
- *
- * Usage: node scripts/youtube_upload.js --file VIDEO.mp4 --title "Title" [--description "..." ] [--tags "a,b"] [--privacy public|private|unlisted]
- *
- * Dependencies: npm install (in the skill directory). Agent can run: exec with skill_id "youtube", command "npm install".
- */
-
-const fs = require("fs");
-const path = require("path");
-const http = require("http");
-
-const SCRIPT_DIR = path.resolve(path.dirname(__filename));
-const SKILL_DIR = path.resolve(SCRIPT_DIR, "..");
-const TOKEN_PATH = path.join(SCRIPT_DIR, "token.json");
-const SCOPES = ["https://www.googleapis.com/auth/youtube.upload"];
-const REDIRECT_URI = "http://localhost:8090/";
-
-function parseArgs() {
-  const args = process.argv.slice(2);
-  const out = { file: null, title: null, description: "", tags: "", privacy: "public" };
-  for (let i = 0; i < args.length; i++) {
-    if (args[i] === "--file" && args[i + 1]) out.file = args[++i];
-    else if (args[i] === "--title" && args[i + 1]) out.title = args[++i];
-    else if (args[i] === "--description" && args[i + 1]) out.description = args[++i];
-    else if (args[i] === "--tags" && args[i + 1]) out.tags = args[++i];
-    else if (args[i] === "--privacy" && args[i + 1]) out.privacy = args[++i];
-  }
-  return out;
-}
-
-function getClientSecret() {
-  const fromEnv = process.env.YOUTUBE_CLIENT_SECRET_JSON;
-  if (fromEnv && fromEnv.trim()) {
-    try {
-      return JSON.parse(fromEnv.trim());
-    } catch (e) {
-      console.error("ERROR: YOUTUBE_CLIENT_SECRET_JSON is not valid JSON.", e.message);
-      process.exit(1);
-    }
-  }
-  const p = path.join(SCRIPT_DIR, "client_secret.json");
-  if (!fs.existsSync(p)) {
-    console.error("ERROR: client_secret.json not found and YOUTUBE_CLIENT_SECRET_JSON not set.");
-    console.error("Add via Skills → YouTube → Configure or place scripts/client_secret.json.");
-    process.exit(1);
-  }
-  return JSON.parse(fs.readFileSync(p, "utf8"));
-}
-
-function getOAuth2Client(credentials) {
-  const { google } = require("googleapis");
-  const client = credentials.installed || credentials.web;
-  if (!client) {
-    console.error("ERROR: client_secret JSON must have 'installed' or 'web' with client_id and client_secret.");
-    process.exit(1);
-  }
-  return new google.auth.OAuth2(client.client_id, client.client_secret, REDIRECT_URI);
-}
-
-function loadSavedToken() {
-  if (!fs.existsSync(TOKEN_PATH)) return null;
-  try {
-    return JSON.parse(fs.readFileSync(TOKEN_PATH, "utf8"));
-  } catch {
-    return null;
-  }
-}
-
-function saveToken(tokens) {
-  fs.writeFileSync(TOKEN_PATH, JSON.stringify(tokens, null, 2), "utf8");
-}
-
-function authorize(oauth2Client) {
-  return new Promise((resolve, reject) => {
-    const authUrl = oauth2Client.generateAuthUrl({
-      access_type: "offline",
-      scope: SCOPES,
-      prompt: "consent",
-    });
-    const server = http
-      .createServer(async (req, res) => {
-        const url = new URL(req.url || "", `http://localhost`);
-        const code = url.searchParams.get("code");
-        res.writeHead(200, { "Content-Type": "text/plain" });
-        if (code) {
-          res.end("Authorized. You can close this tab.");
-          server.close();
-          try {
-            const { tokens } = await oauth2Client.getToken(code);
-            oauth2Client.setCredentials(tokens);
-            saveToken(tokens);
-            resolve(oauth2Client);
-          } catch (e) {
-            reject(e);
-          }
-        } else {
-          res.end("Missing code. Try again.");
-        }
-      })
-      .listen(8090, "localhost", () => {
-        console.error("Open this URL in your browser to authorize:");
-        console.error(authUrl);
-        const op = require("child_process").spawn(
-          process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open",
-          [authUrl],
-          { stdio: "ignore" }
-        );
-        op.on("error", () => {});
-      });
-    server.on("error", reject);
-  });
-}
-
-async function getAuthenticatedClient() {
-  let credentials;
-  try {
-    credentials = getClientSecret();
-  } catch (e) {
-    console.error("ERROR:", e.message);
-    process.exit(1);
-  }
-  const oauth2Client = getOAuth2Client(credentials);
-  const token = loadSavedToken();
-  if (token) {
-    oauth2Client.setCredentials(token);
-    oauth2Client.on("tokens", (tokens) => {
-      const creds = oauth2Client.credentials;
-      if (tokens.refresh_token) creds.refresh_token = tokens.refresh_token;
-      saveToken(creds);
-    });
-    return oauth2Client;
-  }
-  return authorize(oauth2Client);
-}
-
-async function uploadVideo(oauth2Client, filePath, title, description, tagsList, privacy) {
-  const { google } = require("googleapis");
-  const youtube = google.youtube({ version: "v3", auth: oauth2Client });
-  const body = {
-    snippet: {
-      title,
-      description: description || "",
-      tags: tagsList,
-      categoryId: "22",
-    },
-    status: { privacyStatus: privacy },
-  };
-  const media = {
-    body: fs.createReadStream(filePath),
-  };
-  const res = await youtube.videos.insert({
-    part: "snippet,status",
-    requestBody: body,
-    media,
-  });
-  const videoId = res.data.id;
-  console.log("Uploaded: https://youtube.com/watch?v=" + videoId);
-  return videoId;
-}
-
-async function main() {
-  const args = parseArgs();
-  if (!args.file || !args.title) {
-    console.error("Usage: node youtube_upload.js --file <path> --title \"Title\" [--description \"...\"] [--tags \"a,b\"] [--privacy public|private|unlisted]");
-    process.exit(1);
-  }
-  if (!["public", "private", "unlisted"].includes(args.privacy)) {
-    console.error("ERROR: --privacy must be public, private, or unlisted");
-    process.exit(1);
-  }
-  let filePath = path.resolve(args.file);
-  if (!path.isAbsolute(args.file)) filePath = path.resolve(SCRIPT_DIR, args.file);
-  if (!fs.existsSync(filePath)) {
-    console.error("ERROR: File not found:", filePath);
-    process.exit(1);
-  }
-  const tagsList = args.tags ? args.tags.split(",").map((t) => t.trim()).filter(Boolean) : [];
-
-  try {
-    const auth = await getAuthenticatedClient();
-    await uploadVideo(auth, filePath, args.title, args.description, tagsList, args.privacy);
-    const creds = auth.credentials;
-    if (creds && (creds.access_token || creds.refresh_token)) saveToken(creds);
-    process.exit(0);
-  } catch (e) {
-    if (e.code === "MODULE_NOT_FOUND" && (e.message || "").includes("googleapis")) {
-      console.error("ERROR: Missing npm dependencies. Install with:");
-      console.error("  npm install");
-      console.error("Run that from the skill directory (exec with skill_id 'youtube', command 'npm install'), then retry.");
-      process.exit(1);
-    }
-    console.error("ERROR:", e.message || e);
-    process.exit(1);
-  }
-}
-
-main();

package/data/skills/youtube/scripts/youtube_upload.py

@@ -1,125 +0,0 @@
-#!/usr/bin/env python3
-"""Upload a video to YouTube using OAuth credentials in the skill directory.
-
-Usage:
-  python3 youtube_upload.py --file VIDEO.mp4 --title "Title" --description "Description" [--tags "a,b,c"] [--privacy public|private|unlisted]
-
-First run: place client_secret.json (from Google Cloud Console) in this script's directory.
-Browser OAuth will run once; token.json is saved for reuse.
-
-Requires: pip install google-api-python-client google-auth-oauthlib google-auth-httplib2
-"""
-
-import argparse
-import os
-import sys
-import tempfile
-from pathlib import Path
-
-SCRIPT_DIR = Path(__file__).resolve().parent
-SKILL_DIR = SCRIPT_DIR.parent
-TOKEN_FILE = SCRIPT_DIR / "token.json"
-SCOPES = ["https://www.googleapis.com/auth/youtube.upload"]
-
-REQUIREMENTS_MSG = (
-    "YouTube skill requires Google API packages. Install them with:\n"
-    f"  pip install -r \"{SKILL_DIR / 'requirements.txt'}\"\n"
-    "Or: pip install google-api-python-client google-auth-oauthlib google-auth-httplib2"
-)
-
-
-def _client_secret_path() -> Path:
-    """Path to client secrets: from env YOUTUBE_CLIENT_SECRET_JSON (Skills UI) or scripts/client_secret.json."""
-    raw = os.environ.get("YOUTUBE_CLIENT_SECRET_JSON", "").strip()
-    if raw:
-        try:
-            f = tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False)
-            f.write(raw)
-            f.close()
-            return Path(f.name)
-        except Exception:
-            pass
-    return SCRIPT_DIR / "client_secret.json"
-
-
-def get_authenticated_service():
-    try:
-        from google.auth.transport.requests import Request
-        from google.oauth2.credentials import Credentials
-        from google_auth_oauthlib.flow import InstalledAppFlow
-        from googleapiclient.discovery import build
-    except ModuleNotFoundError:
-        print("ERROR: Missing required Google API packages.", file=sys.stderr)
-        print(REQUIREMENTS_MSG, file=sys.stderr)
-        sys.exit(1)
-
-    client_secret_file = _client_secret_path()
-    creds = None
-    if TOKEN_FILE.exists():
-        creds = Credentials.from_authorized_user_file(str(TOKEN_FILE), SCOPES)
-    if not creds or not creds.valid:
-        if creds and creds.expired and creds.refresh_token:
-            creds.refresh(Request())
-        else:
-            if not client_secret_file.exists():
-                print("ERROR: client_secret.json not found and YOUTUBE_CLIENT_SECRET_JSON not set.", file=sys.stderr)
-                print("Add via Skills → YouTube → Configure (paste OAuth client JSON) or place scripts/client_secret.json.", file=sys.stderr)
-                sys.exit(1)
-            flow = InstalledAppFlow.from_client_secrets_file(str(client_secret_file), SCOPES)
-            creds = flow.run_local_server(port=8090, open_browser=True)
-            if client_secret_file != SCRIPT_DIR / "client_secret.json":
-                try:
-                    client_secret_file.unlink()
-                except Exception:
-                    pass
-        TOKEN_FILE.write_text(creds.to_json())
-    return build("youtube", "v3", credentials=creds)
-
-
-def upload(youtube, file_path: str, title: str, description: str, tags: list[str], privacy: str, category_id: str = "22"):
-    from googleapiclient.http import MediaFileUpload
-
-    body = {
-        "snippet": {
-            "title": title,
-            "description": description,
-            "tags": tags,
-            "categoryId": category_id,
-        },
-        "status": {"privacyStatus": privacy},
-    }
-    media = MediaFileUpload(file_path, chunksize=1024 * 1024, resumable=True)
-    request = youtube.videos().insert(part="snippet,status", body=body, media_body=media)
-    response = None
-    while response is None:
-        status, response = request.next_chunk()
-        if status:
-            print(f"  Progress: {int(status.progress() * 100)}%")
-    video_id = response["id"]
-    print(f"Uploaded: https://youtube.com/watch?v={video_id}")
-    return video_id
-
-
-def main():
-    ap = argparse.ArgumentParser(description="Upload a video to YouTube.")
-    ap.add_argument("--file", required=True, help="Path to video file (e.g. video.mp4)")
-    ap.add_argument("--title", required=True, help="Video title")
-    ap.add_argument("--description", default="", help="Video description")
-    ap.add_argument("--tags", default="", help="Comma-separated tags (e.g. shorts,demo)")
-    ap.add_argument("--privacy", default="public", choices=("public", "private", "unlisted"), help="Privacy status")
-    args = ap.parse_args()
-
-    file_path = Path(args.file)
-    if not file_path.is_absolute():
-        file_path = SCRIPT_DIR / file_path
-    if not file_path.exists():
-        print(f"ERROR: File not found: {file_path}", file=sys.stderr)
-        sys.exit(1)
-
-    tags_list = [t.strip() for t in args.tags.split(",") if t.strip()]
-    youtube = get_authenticated_service()
-    upload(youtube, str(file_path), args.title, args.description, tags_list, args.privacy)
-
-
-if __name__ == "__main__":
-    main()