opencodev2-agentswitch 0.0.0-stage → 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Christian Loehnert
+
+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

@@ -1,3 +1,66 @@
-# Temporary Holding Version
+# Figma
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+An opt-in OpenCode plugin that registers Figma's remote MCP server and official Figma skills. It uses OpenCode's existing OAuth/DCR flow and credential storage, without a shared client secret.
+
+## Install
+
+Install directly from Git:
+
+```sh
+opencode plugin add 'git+https://github.com/anomalyco/opencode.git#path:packages/plugins/figma'
+```
+
+The URL selects the Figma directory and uses the repository's default branch, so no explicit branch name is needed. Installation is Git-only.
+
+The plugin exports `index.ts` directly. There is no build step or installation hook.
+
+For local development, add the directory to `plugins` in the project's `opencode.jsonc`:
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugins": ["./packages/plugins/figma"],
+}
+```
+
+The plugin is not activated merely by being present in the repository. Installing it adds it to the user's configuration.
+
+## Sign in and test
+
+1. Open `/mcps`, select `figma`, and sign in.
+2. Confirm that the server is connected.
+3. Ask the agent to call Figma's `whoami` tool.
+
+The connection uses Figma's public endpoint with dynamic client registration (DCR). OAuth discovery supplies the scope, and OpenCode chooses an available loopback callback port; no client credentials or explicit OAuth settings are needed.
+
+Existing `mcp.servers.figma` configuration takes precedence, including disabled servers and custom endpoints.
+
+## Official skills
+
+`skills/` contains the complete skill bundle copied unchanged from the pinned revision of [Figma's official plugin](https://github.com/figma/mcp-server-guide/tree/main/skills). [skills-source.json](skills-source.json) records the exact upstream revision and the discovered skill IDs; it is not an allowlist.
+
+The bundle covers design-to-code, canvas editing, screen and library generation, Code Connect, file creation, diagrams, FigJam, Slides, motion, SwiftUI, shaders, and generative plugins. Supporting references and scripts are included. No replacement instructions are authored by OpenCode. Existing skills with the same IDs are preserved.
+
+The vendored Figma materials remain Figma's materials, not OpenCode-authored MIT code. See [skills/NOTICE.md](skills/NOTICE.md) for attribution and the Figma Developer Terms.
+
+## Manually sync skills
+
+From `packages/plugins/figma`, explicitly run:
+
+```sh
+bun run sync:skills
+```
+
+This fetches upstream `main`, discovers every skill directory containing `SKILL.md`, copies all of them with their supporting files, removes previously bundled skills that no longer exist upstream, and records the resolved commit and skill IDs. No skill names are filtered or hardcoded in the sync script. To use a particular branch, tag, or commit, pass it as an argument. To reproduce the current bundle, pass the revision in `skills-source.json`.
+
+Review and commit `skills/` and `skills-source.json` together. Sync replaces local edits within bundled skill directories, so keep the upstream files unchanged and review updates before releasing them.
+
+Sync never runs automatically during installation, plugin startup, typechecking, or CI. The plugin loads only the checked-in files. Supporting Figma scripts are guidance assets; the plugin does not execute them.
+
+## Remove
+
+```sh
+opencode plugin remove 'git+https://github.com/anomalyco/opencode.git#path:packages/plugins/figma'
+```
+
+If you installed with a different Git specification, pass that same specification to remove it. An independently configured `mcp.servers.figma` entry remains unaffected.

package/index.ts

@@ -0,0 +1,54 @@
+import {Plugin} from "@opencode/plugin"
+
+export default Plugin.define({
+    id: "switch-agent",
+    async setup(ctx) {
+        const agents = new Set<string>()
+        await ctx.agent.transform(editor => {
+            editor.list()
+                .map((e => e.name))
+                .forEach(name => agents.add(name.trim().toString()));
+        });
+        await ctx.tool.transform((editor) => {
+            if (editor.get("switch-agent")) return
+            editor.namespace({
+                name: "sks",
+                description: "sks tools",
+            })
+            editor.add({
+                name: "switch-agent",
+                description: "Allows the currently active agent to change the sessions agent. Use to switch the agent instead of launching a single sub agent. Use the compact tool when the new agent does not need the full context history.",
+                input: {
+                    type: "object",
+                    properties: {agent_name: {type: "string"}, compact: {type: "bool"}},
+                    required: ["agent_name"],
+                    additionalProperties: false,
+                },
+                options: {namespace: "sks", codemode: true},
+                execute: async (input, context) => {
+                    if (input == null || typeof input != 'object') {
+                        throw new Error(`Unexpected input ${JSON.stringify(input)}`);
+                    }
+                    const sessionID = context.sessionID;
+
+                    const possibleAgentName = 'agent_name' in input
+                    && typeof input.agent_name == 'string'
+                    && input.agent_name.trim().length > 0
+                        ? input.agent_name
+                        : null;
+
+                    if (!agents.has(possibleAgentName?.trim() || '')) {
+                        throw new Error(`Agent ${possibleAgentName} is not known to opencode`);
+                    }
+                    const compact = 'compact' in input && typeof input.compact === 'boolean' ? input.compact:false;
+                    if (compact) {
+                            await ctx.session.compact({sessionID});
+
+                    }
+                    await ctx.session.switchAgent({sessionID, agent: possibleAgentName!});
+                    return {content:`Switch to agent ${possibleAgentName!}${compact? ' and compacted' : ''}`};
+                },
+            })
+        });
+    },
+})

package/package.json

@@ -1,6 +1,33 @@
 {
+  "$schema": "https://json.schemastore.org/package.json",
   "name": "opencodev2-agentswitch",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1",
+  "description": "Agent switch tool",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/krampenschiesser/opencodev2-agentswitch.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": "./index.ts",
+    "./server": "./index.ts"
+  },
+  "files": [
+    "index.ts"
+  ],
+  "scripts": {
+    "typecheck": "tsgo --noEmit"
+  },
+  "dependencies": {
+    "@opencode/plugin": "^2.0.29"
+  },
+  "devDependencies": {
+    "@tsconfig/bun": "1.0.9",
+    "@types/bun": "1.4.0",
+    "@typescript/native-preview": "7.0.0-dev.20260707.2"
+  }
+}