agentbundle 0.2.0__tar.gz

agentbundle-0.2.0/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: agentbundle
+Version: 0.2.0
+Summary: Reference CLI and distribution pipeline for the agent-ready-repo adapter contract.
+Author-email: eugenelim <eugenelim@users.noreply.github.com>
+License: Apache-2.0 OR MIT
+Project-URL: Homepage, https://github.com/eugenelim/agent-ready-repo
+Project-URL: Source, https://github.com/eugenelim/agent-ready-repo
+Project-URL: Documentation, https://github.com/eugenelim/agent-ready-repo/blob/main/docs/guides/how-to/install-agentbundle-from-clone.md
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# agentbundle
+
+Runtime library and reference CLI for the
+[agent-ready-repo](https://github.com/eugenelim/agent-ready-repo) adapter
+contract. Ships the `agentbundle` console script — install, validate,
+adapt, and inspect packs — plus the build pipeline (`agentbundle.build`)
+that projects pack sources into adapter-shaped trees.
+
+As of 0.2.0, credential resolution lives in the build-projected
+`credentials_shim` sibling that the `credential-brokers` pack drops
+alongside each `auth: creds` consumer skill's `scripts/`. The
+`agentbundle.credentials` module that previous releases (0.1.x)
+exposed has been removed; consumers import `from .credentials_shim
+import …` against the projected sibling instead. See the
+`credential-broker-contract` spec and this package's `CHANGELOG.md`
+for the migration recipe.
+
+See the [top-level README](https://github.com/eugenelim/agent-ready-repo#readme)
+for install routes, the pack catalogue, and the adapter contract.

agentbundle-0.2.0/README.md

@@ -0,0 +1,19 @@
+# agentbundle
+
+Runtime library and reference CLI for the
+[agent-ready-repo](https://github.com/eugenelim/agent-ready-repo) adapter
+contract. Ships the `agentbundle` console script — install, validate,
+adapt, and inspect packs — plus the build pipeline (`agentbundle.build`)
+that projects pack sources into adapter-shaped trees.
+
+As of 0.2.0, credential resolution lives in the build-projected
+`credentials_shim` sibling that the `credential-brokers` pack drops
+alongside each `auth: creds` consumer skill's `scripts/`. The
+`agentbundle.credentials` module that previous releases (0.1.x)
+exposed has been removed; consumers import `from .credentials_shim
+import …` against the projected sibling instead. See the
+`credential-broker-contract` spec and this package's `CHANGELOG.md`
+for the migration recipe.
+
+See the [top-level README](https://github.com/eugenelim/agent-ready-repo#readme)
+for install routes, the pack catalogue, and the adapter contract.

agentbundle-0.2.0/agentbundle/__init__.py

@@ -0,0 +1,14 @@
+"""agentbundle — distribution machinery for the agent-ready-repo catalogue.
+
+The `build` submodule ships the adapter contract, the four reference
+adapters, the recipe-driven build pipeline, and the self-host gate.
+
+The CLI surface (RFC-0003 F-cli) lives in this package's top-level modules
+and imports `agentbundle.build` as a library — no `sys.path` tricks, no
+`subprocess` to `tools/build/build.py`.
+"""
+
+from agentbundle.version import CLI_VERSION as __version__
+from agentbundle.version import SPEC_VERSION
+
+__all__ = ["__version__", "SPEC_VERSION"]

agentbundle-0.2.0/agentbundle/__main__.py

@@ -0,0 +1,5 @@
+"""`python -m agentbundle` entrypoint."""
+
+from agentbundle.cli import main
+
+raise SystemExit(main())

agentbundle-0.2.0/agentbundle/_data/adapter.schema.json

@@ -0,0 +1,270 @@
+{
+  "type": "object",
+  "required": ["contract", "primitive", "adapter"],
+  "properties": {
+    "contract": {
+      "type": "object",
+      "required": ["version"],
+      "properties": {
+        "version": {"type": "string", "pattern": "^[0-9]+\\.[0-9]+$"}
+      }
+    },
+    "primitive": {
+      "type": "object",
+      "required": ["skill", "agent", "hook-body", "hook-wiring", "command"],
+      "additionalProperties": {
+        "type": "object",
+        "required": ["source-path"],
+        "properties": {
+          "source-path": {"type": "string"}
+        }
+      }
+    },
+    "adapter": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "projection": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["primitive", "mode"],
+              "properties": {
+                "primitive": {
+                  "type": "string",
+                  "enum": ["skill", "agent", "hook-body", "hook-wiring", "command"]
+                },
+                "mode": {
+                  "type": "string",
+                  "enum": [
+                    "direct-directory",
+                    "direct-file",
+                    "merge-json",
+                    "user-merge-json",
+                    "merge-into-agent-json",
+                    "instruction-file",
+                    "managed-block-inline",
+                    "degraded-info-log",
+                    "dropped",
+                    "codex-agent-toml",
+                    "copilot-agent-md",
+                    "copilot-hooks-json"
+                  ]
+                },
+                "target-path": {"type": "string"},
+                "on-conflict": {
+                  "type": "string",
+                  "enum": [
+                    "prompt-then-preserve",
+                    "prompt-then-overwrite",
+                    "preserve-outside-block",
+                    "merge-managed-key-only",
+                    "overwrite-without-prompt"
+                  ]
+                },
+                "managed-key": {"type": "string"},
+                "managed-block-delimiter-start": {"type": "string"},
+                "managed-block-delimiter-end": {"type": "string"},
+                "frontmatter-mapping": {"type": "string"},
+                "frontmatter-default": {"type": "string"},
+                "info-message": {"type": "string"}
+              }
+            }
+          },
+          "projections": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "object",
+              "required": ["mode"],
+              "properties": {
+                "mode": {
+                  "if": {"type": "string"},
+                  "then": {
+                    "enum": [
+                      "direct-directory",
+                      "direct-file",
+                      "merge-json",
+                      "user-merge-json",
+                      "merge-into-agent-json",
+                      "instruction-file",
+                      "managed-block-inline",
+                      "degraded-info-log",
+                      "dropped",
+                      "codex-agent-toml",
+                      "copilot-agent-md",
+                      "copilot-hooks-json"
+                    ]
+                  },
+                  "else": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                      "repo": {
+                        "enum": [
+                          "direct-directory",
+                          "direct-file",
+                          "merge-json",
+                          "user-merge-json",
+                          "merge-into-agent-json",
+                          "instruction-file",
+                          "managed-block-inline",
+                          "degraded-info-log",
+                          "dropped",
+                          "codex-agent-toml",
+                          "copilot-agent-md",
+                          "copilot-hooks-json"
+                        ]
+                      },
+                      "user": {
+                        "enum": [
+                          "direct-directory",
+                          "direct-file",
+                          "merge-json",
+                          "user-merge-json",
+                          "merge-into-agent-json",
+                          "instruction-file",
+                          "managed-block-inline",
+                          "degraded-info-log",
+                          "dropped",
+                          "codex-agent-toml",
+                          "copilot-agent-md",
+                          "copilot-hooks-json"
+                        ]
+                      }
+                    }
+                  }
+                },
+                "target": {
+                  "if": {"type": "string"},
+                  "then": {},
+                  "else": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                      "repo": {"type": "string"},
+                      "user": {"type": "string"}
+                    }
+                  }
+                },
+                "managed-key": {
+                  "if": {"type": "string"},
+                  "then": {},
+                  "else": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                      "repo": {"type": "string"},
+                      "user": {"type": "string"}
+                    }
+                  }
+                },
+                "agent-event-vocabulary": {
+                  "type": "array",
+                  "minItems": 1,
+                  "items": {"type": "string"}
+                },
+                "ide-event-vocabulary": {
+                  "type": "array",
+                  "minItems": 1,
+                  "items": {"type": "string"}
+                },
+                "ide-action-vocabulary": {
+                  "type": "array",
+                  "minItems": 1,
+                  "items": {"type": "string"}
+                },
+                "on-conflict": {
+                  "type": "string",
+                  "enum": [
+                    "prompt-then-preserve",
+                    "prompt-then-overwrite",
+                    "preserve-outside-block",
+                    "merge-managed-key-only",
+                    "overwrite-without-prompt"
+                  ]
+                },
+                "frontmatter-mapping": {"type": "string"},
+                "frontmatter-default": {"type": "string"},
+                "info-message": {"type": "string"}
+              }
+            }
+          },
+          "scope": {
+            "type": "object",
+            "required": ["repo", "allowed-prefixes"],
+            "properties": {
+              "repo": {"type": "string"},
+              "user": {"type": "string"},
+              "allowed-prefixes": {
+                "type": "object",
+                "required": ["repo"],
+                "properties": {
+                  "repo": {
+                    "type": "array",
+                    "minItems": 1,
+                    "items": {
+                      "type": "string",
+                      "pattern": "^((?!\\.\\.(\\/|$))[^/]+/)+$"
+                    }
+                  },
+                  "user": {
+                    "type": "array",
+                    "minItems": 1,
+                    "items": {
+                      "type": "string",
+                      "pattern": "^((?!\\.\\.(\\/|$))[^/]+/)+$"
+                    }
+                  }
+                },
+                "additionalProperties": {
+                  "type": "array",
+                  "minItems": 1,
+                  "items": {
+                    "type": "string",
+                    "pattern": "^((?!\\.\\.(\\/|$))[^/]+/)+$"
+                  }
+                }
+              }
+            }
+          },
+          "install-routes": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": ["cli", "claude-plugins", "apm"]
+            }
+          }
+        }
+      }
+    },
+    "frontmatter-mapping": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "object",
+          "properties": {
+            "rename": {"type": "string"},
+            "normalize": {
+              "type": "string",
+              "enum": ["to-list", "to-string", "lowercase"]
+            },
+            "default": {"type": "string"},
+            "values": {
+              "type": "object",
+              "additionalProperties": {"type": "string"}
+            }
+          }
+        }
+      }
+    },
+    "frontmatter-default": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": {"type": "string"}
+      }
+    }
+  }
+}