simple-agent-extension 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9ab373fc18955bd0baacc40937dcb56758ef1868b628761e9f718c0f92b85f8f
-  data.tar.gz: e059df069d89a8097aa6f08acc9f2dff02c32ebd2adce5b083e34fe0fcd722a3
+  metadata.gz: 404e535b96de550ec739358155e62a38ec0d9a07a2ec2f78e7607eb3a98930d7
+  data.tar.gz: e17a63f61c78d8b9f30631d52ff212ba890e71ccc0ab17e8a9e1a9b56d919060
 SHA512:
-  metadata.gz: a88591dbccfda4b2e5abf84fcb2861cd35151dea90574e93b081d0c568a3eb11e6357df7726c3dd857fd4de6bf49f0eaf5651ad1c24bee910120ac32794647a3
-  data.tar.gz: 4df63619203ce861896717301521835f0261a38b97b466ed4f4ee1a3a4cb2c0ffc3a3993b6b8d75d8e5482e4f9c376ed973f1045252dd9c8a9cacc3f327dd516
+  metadata.gz: b9d622f95994d3f6abcfa23cb3bce94b92316250ad9c3a24ca0b83092be5f05628fa73a10ca5093b60b86cb27753e903566c4a38e248c200518a2d7bb99ef3d7
+  data.tar.gz: 963497aacd95ec19efa3157202dc547dacccd2c71567be762d7a8c8ba347efd6a65894c3501b1c0f5ab5794622ba3ff26db682eda2d73fe68cf1c3dbe4f54e63

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [0.2.3] 2026-10-12
+
+- feat: add version option
+- feat: add clean subcommand
+- feat: support `disable-model-invocation' field for very heavy skills
+
 ## [0.2.2] 2026-10-04
 
 - fix: make the causes of errors easier to read

data/README.md

@@ -115,9 +115,16 @@ entrypoint frontmatter
   < static.agents.<agent>
 ```
 
-#### Adaptation across Agents
+#### Supported adaptive fields
 
-One `adaptive` fragment becomes different artifact metadata per Agent. The `permissions` fragment above compiles to:
+| Field | Applies to | Value | Meaning |
+|---|---|---|---|
+| `permissions` | agent, skill | map of tool name to `allow`, `ask`, or `deny` | Which tools the extension may use, and how. |
+| `disable-model-invocation` | skill | boolean | `true` keeps the skill out of model auto-selection; `/name` still works. |
+
+Each Agent decides how a field appears in its artifact; see the `MetadataTranslator` in `lib/simple_agent_extension/agents/`. A field an Agent has no rule for, listed here or not, passes through unchanged, so it takes effect only on an Agent that recognizes it.
+
+The `permissions` fragment above (`read: allow`, `edit: ask`) compiles to:
 
 | Agent | Artifact metadata |
 |---|---|
@@ -127,6 +134,8 @@ One `adaptive` fragment becomes different artifact metadata per Agent. The `perm
 
 `claude` maps known lowercase tool names such as `read` and `webfetch` to Claude Code's names (`Read`, `WebFetch`) and passes any other name through unchanged. `deny` becomes `disallowedTools` on an agent and `disallowed-tools` on a skill. An agent's `tools` lists both `allow` and `ask` tools, because Claude Code's `tools` limits which tools exist rather than pre-approving them.
 
+`disable-model-invocation` is not part of the Agent Skills specification, but Claude Code, Copilot, and OpenCode v2 ( 2.0.23+ ) read it as written. Older OpenCode versions read only their own `metadata` keys, so `opencode` translates the field for them.
+
 A skill whose metadata is left unchanged by adaptation and carries no Agent-specific static fragments is written once to the shared skill directory. Otherwise it is written into that Agent's own configuration tree ( written with Ruby ). An agent extension is always Agent-specific. `claude` does not read the shared skill directory, so its skills are always written to `~/.claude/skills`.
 
 ### Commands
@@ -137,11 +146,14 @@ snapshot as below:
 
 ```sh
 simple-agent-extension packages
+simple-agent-extension clean
 simple-agent-extension build
 simple-agent-extension deploy
 simple-agent-extension agents
 ```
 
+`build` (and therefore `deploy`) runs `clean` first, so an artifact whose source package was removed is not deployed again. `clean` removes `<build-root>/<agent>/` for each targeted Agent only. It does not remove anything already deployed.
+
 All commands resolve `--source-root` from `./packages` and `--build-root` from `./build` by default. Either root may be outside the repository.
 
 ```sh

data/lib/simple_agent_extension/agents/opencode.rb

@@ -10,6 +10,22 @@ module SimpleAgentExtension
           {"permission" => permissions}
         end
 
+        # For OpenCode before 2.0.23, which reads only these `metadata` keys.
+        # 2.0.23+ reads top-level `disable-model-invocation` itself and ignores
+        # `opencode/slash`, so this rule can go once older versions are unsupported.
+        define_translation type: :skill, field: "disable-model-invocation" do |disabled|
+          if disabled == true
+            {
+              "metadata" => {
+                "opencode/autoinvoke" => "false",
+                "opencode/slash" => "true"
+              }
+            }
+          else # standard:disable Style/EmptyElse
+            nil
+          end
+        end
+
         define_translation type: :agent, field: "name" do |_name|
           nil
         end

data/lib/simple_agent_extension/cli.rb

@@ -15,7 +15,8 @@ module SimpleAgentExtension
 
     COMMANDS = {
       "packages" => "List package names under the source root",
-      "build" => "Compile artifacts into the build root",
+      "clean" => "Remove artifacts from the build root",
+      "build" => "Clean, then compile artifacts into the build root",
       "deploy" => "Build artifacts, then deploy them to Agents",
       "agents" => "List Agent names that can be targeted"
     }.freeze
@@ -42,6 +43,7 @@ module SimpleAgentExtension
       parser.parse!(arguments)
 
       return display_help(parser) if options[:help]
+      return display_version(parser) if options[:version]
 
       command = command(arguments)
       validate_options(command, options)
@@ -86,13 +88,16 @@ module SimpleAgentExtension
         agents: [],
         agent_directories: [],
         force: false,
-        help: false
+        help: false,
+        version: false
       }
     end
 
     def option_parser(options)
       OptionParser.new do |parser|
         parser.banner = banner
+        parser.program_name = "simple-agent-extension"
+        parser.version = VERSION
 
         parser.on("--source-root DIRECTORY", "Source package root (default: ./packages)") do |directory|
           options[:source_root] = File.expand_path(directory)
@@ -100,7 +105,7 @@ module SimpleAgentExtension
         parser.on("--build-root DIRECTORY", "Build artifact root (default: ./build)") do |directory|
           options[:build_root] = File.expand_path(directory)
         end
-        parser.on("--agent NAME", "Build or deploy only NAME (repeatable)") do |name|
+        parser.on("--agent NAME", "Clean, build, or deploy only NAME (repeatable)") do |name|
           options[:agents] << name
         end
         parser.on("--agent-dir DIRECTORY", "Load direct *.rb Agent registrations from DIRECTORY") do |directory|
@@ -112,6 +117,9 @@ module SimpleAgentExtension
         parser.on("-h", "--help", "Show this help") do
           options[:help] = true
         end
+        parser.on("-V", "--version", "Show version") do
+          options[:version] = true
+        end
       end
     end
 
@@ -123,7 +131,12 @@ module SimpleAgentExtension
     end
 
     def display_help(parser)
-      @output.puts parser
+      @output.puts parser.ver, "", parser
+      0
+    end
+
+    def display_version(parser)
+      @output.puts parser.ver
       0
     end
 
@@ -154,6 +167,8 @@ module SimpleAgentExtension
         @output.puts runner.packages
       when "agents"
         @output.puts agent_lines(runner.agents)
+      when "clean"
+        @output.puts runner.clean(agents: options[:agents])
       when "build"
         @output.puts runner.build(agents: options[:agents])
       when "deploy"

data/lib/simple_agent_extension/runner.rb

@@ -1,3 +1,5 @@
+require "fileutils"
+
 module SimpleAgentExtension
   # Coordinates source collection, compilation, and deployment for one
   # source and build roots. Entry points configure these boundaries explicitly.
@@ -25,12 +27,29 @@ module SimpleAgentExtension
       end
     end
 
+    # Removes each selected Agent's whole artifact subtree, so artifacts whose
+    # source package is gone cannot survive into the next deploy. Other
+    # Agents' subtrees are left alone.
+    #
+    # @param [Array<String>] agents target names; all targets when empty
+    # @return [Array<String>] Agent directories that existed and were removed
+    def clean(agents: [])
+      selected_agents(agents)
+        .map { |agent| File.join(@build_root, agent.name) }
+        .select { |dir| File.exist?(dir) }
+        .each { |dir| FileUtils.rm_rf(dir) }
+    end
+
+    # Cleans the selected Agents first, so the build tree mirrors the current
+    # source tree instead of accumulating every artifact ever compiled.
+    #
     # @param [Array<String>] agents target names; all targets when empty
     # @return [Array<String>] directories written to the build tree
     def build(agents: [])
       targets = selected_agents(agents)
       extensions = source_extensions
       warn_unknown_deploy_to_names(extensions)
+      clean(agents: agents)
 
       targets.flat_map { |agent|
         compiler = Compiler.new(agent: agent, build_root: @build_root)

data/lib/simple_agent_extension/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SimpleAgentExtension
-  VERSION = "0.2.2"
+  VERSION = "0.2.3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: simple-agent-extension
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.3
 platform: ruby
 authors:
 - ''
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-04 00:00:00.000000000 Z
+date: 2026-10-13 00:00:00.000000000 Z
 dependencies: []
 description: 'Coding Agent Extension Utility with Simple DSL and Rule Translating
   and Deploying '