@assemblyline-agents/soundcloud 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenEve contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,19 @@
+# @assemblyline-agents/soundcloud
+
+Official Assembly Line SoundCloud connection plugin.
+
+It connects agents to SoundCloud through its public API: the package exports `defineSoundCloudConnection(options)`, an OpenAPI-backed connection that turns SoundCloud API operations into agent tools, plus an `openevePlugin` module so the Assembly Line CLI and compiler can discover the plugin's connection metadata. A bundled skill under `skills/` teaches agents how to use the connection's tools.
+
+## Install
+
+```sh
+npm install @assemblyline-agents/soundcloud
+```
+
+## Part of Assembly Line
+
+This package is part of [Assembly Line](https://github.com/jasonbadeaux/openeve), a vendor-neutral, filesystem-first framework for durable AI agents. See the developer documentation in [docs/developers/](https://github.com/jasonbadeaux/openeve/tree/main/docs/developers) for setup, agent authoring, and deployment guides.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import { type ConnectionAuthDefinition, type OpenAPIPluginConnectionOptions } from "@assemblyline-agents/core";
+export interface SoundCloudConnectionOptions extends Omit<OpenAPIPluginConnectionOptions, "auth"> {
+    auth?: ConnectionAuthDefinition | false;
+}
+export declare function defineSoundCloudConnection(options: SoundCloudConnectionOptions): import("@assemblyline-agents/core").OpenAPIConnectionDefinition;
+export declare const openevePlugin: import("@assemblyline-agents/core").PluginModule;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,wBAAwB,EAC7B,KAAK,8BAA8B,EACpC,MAAM,2BAA2B,CAAC;AAInC,MAAM,WAAW,2BAA4B,SAAQ,IAAI,CAAC,8BAA8B,EAAE,MAAM,CAAC;IAC/F,IAAI,CAAC,EAAE,wBAAwB,GAAG,KAAK,CAAC;CACzC;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,2BAA2B,mEAM9E;AAED,eAAO,MAAM,aAAa,kDAA0C,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+import { connectionPluginMetadata, defineOAuthAuthorization, defineOpenAPIPluginConnection, definePlugin } from "@assemblyline-agents/core";
+const PLUGIN = connectionPluginMetadata("soundcloud");
+export function defineSoundCloudConnection(options) {
+    const { auth, ...connection } = options;
+    return defineOpenAPIPluginConnection(PLUGIN, {
+        ...connection,
+        auth: auth === false ? false : auth ?? soundCloudOAuth()
+    });
+}
+export const openevePlugin = definePlugin({ connections: [PLUGIN] });
+function soundCloudOAuth() {
+    return ({ env }) => {
+        const clientId = env.SOUNDCLOUD_CLIENT_ID?.trim();
+        const clientSecret = env.SOUNDCLOUD_CLIENT_SECRET?.trim();
+        const redirectUri = env.SOUNDCLOUD_REDIRECT_URI?.trim();
+        if (!clientId || !clientSecret) {
+            throw new Error("SoundCloud OAuth requires SOUNDCLOUD_CLIENT_ID and SOUNDCLOUD_CLIENT_SECRET.");
+        }
+        return defineOAuthAuthorization({
+            displayName: "SoundCloud",
+            authorizeUrl: "https://secure.soundcloud.com/authorize",
+            tokenUrl: "https://secure.soundcloud.com/oauth/token",
+            clientId,
+            clientSecret,
+            ...(redirectUri ? { redirectUri } : {}),
+            pkce: true,
+            tokenType: "OAuth"
+        });
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,6BAA6B,EAC7B,YAAY,EAGb,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,GAAG,wBAAwB,CAAC,YAAY,CAAE,CAAC;AAMvD,MAAM,UAAU,0BAA0B,CAAC,OAAoC;IAC7E,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;IACxC,OAAO,6BAA6B,CAAC,MAAM,EAAE;QAC3C,GAAG,UAAU;QACb,IAAI,EAAE,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,eAAe,EAAE;KACzD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAErE,SAAS,eAAe;IACtB,OAAO,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QACjB,MAAM,QAAQ,GAAG,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE,CAAC;QAClD,MAAM,YAAY,GAAG,GAAG,CAAC,wBAAwB,EAAE,IAAI,EAAE,CAAC;QAC1D,MAAM,WAAW,GAAG,GAAG,CAAC,uBAAuB,EAAE,IAAI,EAAE,CAAC;QACxD,IAAI,CAAC,QAAQ,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;QAClG,CAAC;QACD,OAAO,wBAAwB,CAAC;YAC9B,WAAW,EAAE,YAAY;YACzB,YAAY,EAAE,yCAAyC;YACvD,QAAQ,EAAE,2CAA2C;YACrD,QAAQ;YACR,YAAY;YACZ,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,IAAI,EAAE,IAAI;YACV,SAAS,EAAE,OAAO;SACnB,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@assemblyline-agents/soundcloud",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@assemblyline-agents/core": "0.1.0"
+  },
+  "description": "Official OpenEve SoundCloud connection plugin.",
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jasonbadeaux/openeve.git",
+    "directory": "packages/soundcloud"
+  },
+  "bugs": {
+    "url": "https://github.com/jasonbadeaux/openeve/issues"
+  },
+  "homepage": "https://github.com/jasonbadeaux/openeve#readme",
+  "author": "OpenEve contributors",
+  "keywords": [
+    "openeve",
+    "ai",
+    "agents",
+    "soundcloud",
+    "music",
+    "audio",
+    "plugin"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit"
+  }
+}

package/skills/soundcloud/SKILL.md

@@ -0,0 +1,11 @@
+---
+name: soundcloud
+description: Search and manage configured SoundCloud tracks, playlists, users, likes, follows, reposts, and comments.
+---
+# SoundCloud
+
+Use the `soundcloud` connection to search and inspect tracks, playlists, users, and the authenticated account. Resolve the current resource before proposing a mutation.
+
+The deployment owner registers the SoundCloud application and supplies its client ID, client secret, and exact redirect URI. OAuth tokens remain host-side. The scaffold starts read-only; playlist edits, likes, follows, reposts, comments, metadata changes, and deletes require write access with the configured approval gate.
+
+Direct track upload is not exposed by the initial plugin because SoundCloud requires multipart binary transfer. Do not work around that boundary by placing audio data or credentials in prompts.