@passioncode-ai/fabric-agent-adapter 0.12.0 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # Changelog
 
+## 0.14.0 - 2026-10-12
+
+The contract pin moves to Fabric Agent Contract `main` `0cacd08`, which includes PR #46 (DEC-0046, runner and model
+profiles) and PR #47 (CT-31). Bundles issued under the DEC-0045 revision and every earlier supported one stay valid
+(FAA-30).
+
+### Changed
+
+- **Default contract pin `2eb91c0` → `0cacd08b0e95b6abf131eae1206b60792138bc3c`.** `2eb91c0` joins
+  `SUPPORTED_CONTRACT_COMMITS`. The revisions between add DEC-0046's model and runner profile schemas, a model
+  catalogue, an optional `configuration` on the well-known document and an optional `route` on usage receipts.
+  They also tighten `modelClasses` in a grant to the catalogue's closed vocabulary, which the kits do not write. Later
+  merges change fixtures and the contract's privacy check only. The provider manifest and the MCP, A2A and
+  local-runner profiles are unchanged. The compiled-schema arms at `2ce3922` and `0cacd08` agree.
+- **The shared delegation vectors are regenerated with the contract's verifier at the new pin.** The one case the
+  contract used to throw on, a signed token with no `act`, now carries the contract's own answer (`unauthenticated` /
+  `malformed-chain`), which is the answer the kits already gave. The other 81 delegation answers are unchanged. The
+  tests no longer have a `contractThrew` path; they require that the contract answers every case.
+- `references/protocol.md` names DEC-0046's `configuration` and `route`. The kits do not emit them yet (FAA-19).
+
+## 0.13.0 - 2026-10-12
+
+The scaffolder writes what a capability does outside itself, and what a run may cost (FAA-25; target architecture v4,
+Stage 0). The contract pin is unchanged (`2eb91c0`).
+
+### Changed
+
+- **`adapt_project.py scaffold` requires `--effect`.** It takes the capability's effect class (`none`, `draft`,
+  `publish`, `send`, `reply`, `charge`, `delete`, `merge`, `deploy`, `change-policy`) and writes it to the manifest.
+  Before, every capability was written as `effect: "none"`. A scaffold without an effect is refused: the class is
+  never defaulted. **This breaks every script that calls the scaffolder without `--effect`.**
+
+### Added
+
+- **`--idempotency required|supported|none`**, written to the capability.
+- **`--cost-preset ID MAX_USD LABEL`** (repeatable) and **`--default-cost-preset ID`** write the manifest's
+  `costPresets` (DEC-0037): fixed options a launcher offers for a run whose cost varies. The id grammar, the
+  amounts, the labels, duplicates and the default are checked.
+- `adapting-projects-to-fabric` and `creating-fabric-agents` show the flags and say the effect is read from the code
+  or asked of the author, and amounts are never invented. Scenario evals `effect-declared-not-defaulted` came first
+  in both skills.
+- A compiled-schema test shows the written effect, idempotency and presets are valid under the pin.
+
 ## 0.12.0 - 2026-10-12
 
 The contract pin moves to Fabric Agent Contract `main` `2eb91c0` (the merge of contract PR #45: DEC-0041…DEC-0045).

package/README.md

@@ -189,7 +189,8 @@ python3 "$SKILL_DIR/scripts/adapt_project.py" scaffold /path/to/project \
   --provider-name "Demo provider" \
   --capability-id https://agents.example/capabilities/demo \
   --capability-name demo.run \
-  --schema-base https://agents.example/fabric
+  --schema-base https://agents.example/fabric \
+  --effect none
 python3 "$SKILL_DIR/scripts/adapt_project.py" check /path/to/project \
   --contract /path/to/fabric-agent-contract --json
 ```
@@ -202,7 +203,7 @@ Scaffolding is non-destructive by default. It writes only the paths declared in
 The default pin for new bundles is [`fabric-contract.lock.json`](fabric-contract.lock.json):
 
 - version: `0.1.0`
-- commit: `2eb91c00e852d9c31d804310d38fad91589fcbac`
+- commit: `0cacd08b0e95b6abf131eae1206b60792138bc3c`
 
 Every other mention of the default contract revision — this section, the skills' metadata, the
 skill card, `adapt_project.py` — must equal it; `python3 test/validate.py` fails a tree
@@ -229,8 +230,8 @@ FABRIC_CONTRACT_OLD=/path/to/legacy-contract FABRIC_CONTRACT_NEW=/path/to/curren
 ```
 
 Without both environment variables, those tests explicitly skip as `NOT_RUN`.
-This source checkout is 0.12.0. 0.11.1 is the latest published GitHub/npm release (2026-10-12; 0.7.0 and 0.11.0
-were never released); 0.12.0 is published by its `v0.12.0` tag. Source delivery does not update installed skills or live sessions.
+This source checkout is 0.14.0. 0.13.0 is the latest published GitHub/npm release (2026-10-12; 0.7.0 and 0.11.0
+were never released); 0.14.0 is published by its `v0.14.0` tag. Source delivery does not update installed skills or live sessions.
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@passioncode-ai/fabric-agent-adapter",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "Create Fabric-compatible agents, run them as always-alive local services with dashboards (fabric-service/0.1), and adapt existing projects to the Fabric Agent Contract. This package is the installer CLI.",
   "scripts": {
     "test": "python3 test/validate.py && python3 -m unittest discover -s test -q && node --test 'test/*.test.mjs'"

package/plugins/fabric-agent-adapter/.claude-plugin/plugin.json

@@ -3,7 +3,7 @@
   "name": "fabric-agent-adapter",
   "displayName": "Fabric Agent Adapter",
   "description": "Create new Fabric-compatible agents, build them as always-alive local services with dashboards (fabric-service/0.1), and adapt existing projects to the Fabric Agent Contract through evidence-backed MCP, A2A, or local-runner provider bundles.",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "author": {
     "name": "PassionCode.ai",
     "url": "https://passioncode.ai/"

package/plugins/fabric-agent-adapter/skills/adapting-projects-to-fabric/SKILL.md

@@ -5,9 +5,9 @@ license: AGPL-3.0-only OR LicenseRef-PassionCode-Commercial
 compatibility: Requires filesystem access and Python 3.9+. Exact schema checks additionally need git, Node.js, pnpm, and the pinned fabric-agent-contract checkout (a public repository). Works without those tools in an explicitly degraded structural-check mode.
 metadata:
   author: PassionCode.ai
-  version: "0.12.0"
+  version: "0.14.0"
   contract-version: "0.1.0"
-  contract-commit: "2eb91c00e852d9c31d804310d38fad91589fcbac"
+  contract-commit: "0cacd08b0e95b6abf131eae1206b60792138bc3c"
 ---
 
 # Adapting projects to Fabric
@@ -70,7 +70,7 @@ Use exactly:
 
 - contract version `0.1.0`;
 - repository `https://github.com/passioncode-ai/fabric-agent-contract`;
-- commit `2eb91c00e852d9c31d804310d38fad91589fcbac`.
+- commit `0cacd08b0e95b6abf131eae1206b60792138bc3c`.
 
 This is the default for new bundles. When checking an issued legacy bundle, preserve its
 explicit supported lock and use that exact clean checkout. Never silently upgrade or
@@ -96,14 +96,21 @@ python3 <skill-dir>/scripts/adapt_project.py scaffold <project-root> \
   --provider-name "Example provider" \
   --capability-id https://agents.example/capabilities/example \
   --capability-name example.run \
-  --schema-base https://agents.example/fabric
+  --schema-base https://agents.example/fabric \
+  --effect draft
 ```
 
 Valid profiles are `mcp`, `a2a`, and `local-runner`. For `mcp` the capability is served
 as the MCP tool of its own name (`requiredFeatures: ["tool:<capability>"]`, contract
 `fabric-interop/0.1`); add `--job` when its work may outlive one request, which writes
 `"job": true` in the capability's interop block. The helper creates only the locked
-target paths. It refuses any collision. Do not use `--force` unless the user explicitly
+target paths. It refuses any collision.
+
+`--effect` is required and never defaulted: the capability's class (`none`, `draft`, `publish`, `send`, `reply`,
+`charge`, `delete`, `merge`, `deploy`, `change-policy`), read from what the code does or asked of the author. Choose
+`--idempotency required|supported|none` for an external effect on purpose. When a run's cost varies, give the
+launcher fixed options (DEC-0037): `--cost-preset ID MAX_USD LABEL` per option and `--default-cost-preset ID`; the
+amounts come from the author or measured runs, never invented. Do not use `--force` unless the user explicitly
 authorizes replacement after the exact conflicting files and diff are shown.
 
 The generated zero hash, `.invalid` endpoints, `replace-me` values, generic schemas, and

package/plugins/fabric-agent-adapter/skills/adapting-projects-to-fabric/scripts/adapt_project.py

@@ -6,8 +6,10 @@ from __future__ import annotations
 import argparse
 import datetime as dt
 import json
+import math
 import os
 from pathlib import Path
+import re
 import subprocess
 import sys
 from typing import Any, Dict, Iterable, List, Optional, Sequence, Tuple
@@ -16,10 +18,10 @@ from urllib.parse import urlparse
 
 CONTRACT_VERSION = "0.1.0"
 CONTRACT_REPOSITORY = "https://github.com/passioncode-ai/fabric-agent-contract"
-CONTRACT_COMMIT = "2eb91c00e852d9c31d804310d38fad91589fcbac"
+CONTRACT_COMMIT = "0cacd08b0e95b6abf131eae1206b60792138bc3c"
 # #region supported-contract-revisions — docs: README.md#contract-pin
 # Only this declaration may name a legacy revision in live files.
-SUPPORTED_CONTRACT_COMMITS = (CONTRACT_COMMIT, "8e49fbd5fbbf230e32c1969cd24ac3c22422f0a5", "a83bec6b47776af688402c18efec507143061f68", "52da526d7cc1e063d74c5b520dbc03d0ace15246", "78b2da018d2c4bd9ac1bde1dc3b7f1a110a175f5", "623bf61358c339cb10297807b3f024b5d9f1f327", "23f9fda4c05f8a3852246ee98d4f2adf74ed0875", "9091d3d6606b0c4b5591a38c3674356a01fd7f55", "df55c8c54a23251342a7ee57ba95642b7eb39e61", "2ce392291c6668598d12cd38327e24696b5ca15c")
+SUPPORTED_CONTRACT_COMMITS = (CONTRACT_COMMIT, "2eb91c00e852d9c31d804310d38fad91589fcbac", "8e49fbd5fbbf230e32c1969cd24ac3c22422f0a5", "a83bec6b47776af688402c18efec507143061f68", "52da526d7cc1e063d74c5b520dbc03d0ace15246", "78b2da018d2c4bd9ac1bde1dc3b7f1a110a175f5", "623bf61358c339cb10297807b3f024b5d9f1f327", "23f9fda4c05f8a3852246ee98d4f2adf74ed0875", "9091d3d6606b0c4b5591a38c3674356a01fd7f55", "df55c8c54a23251342a7ee57ba95642b7eb39e61", "2ce392291c6668598d12cd38327e24696b5ca15c")
 # #endregion supported-contract-revisions
 INTEROP_KEY = "https://fabric.passioncode.ai/agent-contract/extensions/interop/0.1"
 MCP_REVISION = "2026-07-28"
@@ -208,6 +210,7 @@ def _json_text(value: Any) -> str:
 
 
 def _generated_files(args: argparse.Namespace) -> Dict[str, str]:
+    effect, idempotency = _declared_effect(args)
     for value, label in (
         (args.provider_id, "provider ID"),
         (args.capability_id, "capability ID"),
@@ -250,8 +253,8 @@ def _generated_files(args: argparse.Namespace) -> Dict[str, str]:
                 "name": args.capability_name,
                 "inputSchema": _schema_uri(args.schema_base, "schemas/capability-input.schema.json"),
                 "outputSchema": _schema_uri(args.schema_base, "schemas/capability-output.schema.json"),
-                "effect": "none",
-                "idempotency": "none",
+                "effect": effect,
+                "idempotency": idempotency,
                 "dataClasses": ["public"],
                 "profile": _profile(args, args.schema_base),
             }
@@ -259,6 +262,9 @@ def _generated_files(args: argparse.Namespace) -> Dict[str, str]:
     }
     if getattr(args, "job", False):
         manifest["capabilities"][0]["extensions"] = {INTEROP_KEY: {"job": True}}
+    presets = _cost_presets(args)
+    if presets:
+        manifest["costPresets"] = presets
     lock = {
         "contract": "fabric-agent-contract",
         "version": CONTRACT_VERSION,
@@ -320,6 +326,51 @@ placeholders. Scaffolding is not admission and must not be presented as compatib
     }
 
 
+EFFECT_CLASSES = ("none", "draft", "publish", "send", "reply", "charge", "delete", "merge", "deploy", "change-policy")
+IDEMPOTENCY = ("required", "supported", "none")
+_PRESET_ID = re.compile(r"^[a-z][a-z0-9-]{0,39}$")
+
+
+def _cost_presets(args: argparse.Namespace) -> List[Dict[str, Any]]:
+    """DEC-0037: the fixed options a launcher offers for a task whose cost varies, each for this capability."""
+    presets: List[Dict[str, Any]] = []
+    seen = set()
+    for raw in getattr(args, "cost_preset", None) or []:
+        preset_id, max_usd, label = (list(raw) + ["", "", ""])[:3]
+        if not _PRESET_ID.match(preset_id or ""):
+            raise AdaptationError("cost preset id %r must match ^[a-z][a-z0-9-]{0,39}$" % preset_id)
+        if preset_id in seen:
+            raise AdaptationError("cost preset %s is named twice" % preset_id)
+        try:
+            amount = float(max_usd)
+        except ValueError:
+            raise AdaptationError("cost preset %s: maxUsd %r is not a number" % (preset_id, max_usd)) from None
+        if not math.isfinite(amount) or amount < 0:
+            raise AdaptationError("cost preset %s: maxUsd must be a finite amount of at least 0" % preset_id)
+        if not label.strip():
+            raise AdaptationError("cost preset %s needs a label a person reads at launch" % preset_id)
+        seen.add(preset_id)
+        presets.append({"id": preset_id, "capability": args.capability_name, "label": label.strip(), "maxUsd": amount})
+    default = getattr(args, "default_cost_preset", None)
+    if default:
+        if default not in seen:
+            raise AdaptationError("--default-cost-preset %s names no --cost-preset" % default)
+        next(p for p in presets if p["id"] == default)["default"] = True
+    return presets
+
+
+def _declared_effect(args: argparse.Namespace) -> Tuple[str, str]:
+    """The capability's effect class is declared by the author, never defaulted (target architecture v4, Stage 0)."""
+    effect = getattr(args, "effect", None)
+    if effect not in EFFECT_CLASSES:
+        raise AdaptationError("declare the capability's effect with --effect (%s); it is never defaulted"
+                              % ", ".join(EFFECT_CLASSES) if not effect else "unknown effect class %r (%s)" % (effect, ", ".join(EFFECT_CLASSES)))
+    idempotency = getattr(args, "idempotency", None) or "none"
+    if idempotency not in IDEMPOTENCY:
+        raise AdaptationError("unknown idempotency %r (%s)" % (idempotency, ", ".join(IDEMPOTENCY)))
+    return effect, idempotency
+
+
 def scaffold_project(root: Path, args: argparse.Namespace) -> Dict[str, Any]:
     if not root.is_dir():
         raise AdaptationError("project path is not a directory: %s" % root)
@@ -544,6 +595,12 @@ def build_parser() -> argparse.ArgumentParser:
     scaffold.add_argument("--runner-kind", default="replace-me")
     scaffold.add_argument("--executable-ref", default="urn:executable:replace-me")
     scaffold.add_argument("--runtime-arg", action="append", default=[])
+    scaffold.add_argument("--effect", required=True, choices=EFFECT_CLASSES,
+                          help="the capability's effect class (governance): what it does outside itself; never defaulted")
+    scaffold.add_argument("--idempotency", choices=IDEMPOTENCY, default="none")
+    scaffold.add_argument("--cost-preset", nargs=3, action="append", default=[], metavar=("ID", "MAX_USD", "LABEL"),
+                          help="a fixed cost option a launcher offers (DEC-0037 costPresets); repeat for each")
+    scaffold.add_argument("--default-cost-preset", metavar="ID", help="the preset preselected at launch")
     scaffold.add_argument("--job", action="store_true", help="the capability's work may outlive one request (fabric-interop/0.1 job)")
     scaffold.add_argument("--force", action="store_true")
     scaffold.add_argument("--json", action="store_true")

package/plugins/fabric-agent-adapter/skills/building-fabric-services/SKILL.md

@@ -16,10 +16,10 @@ license: AGPL-3.0-only OR LicenseRef-PassionCode-Commercial
 compatibility: Python 3.9+ or Node.js 20+ for the kits; the probe needs Python 3.9+. launchd steps are macOS-only (Linux services use lifecycle manager none until a systemd adapter exists). Dashboard handoff optionally uses Fabric Dashboards MCP link/host_status/open; without it, report unresolved host capability. The contract checkout is optional.
 metadata:
   author: PassionCode.ai
-  version: "0.12.0"
+  version: "0.14.0"
   contract-version: "0.1.0"
   extension: "fabric-service/0.1"
-  extension-commit: "2eb91c00e852d9c31d804310d38fad91589fcbac"
+  extension-commit: "0cacd08b0e95b6abf131eae1206b60792138bc3c"
 ---
 
 # Building Fabric services

package/plugins/fabric-agent-adapter/skills/building-fabric-services/references/protocol.md

@@ -1,11 +1,11 @@
 # fabric-service/0.1 — wire reference
 
-Pinned to `fabric-agent-contract` commit `2eb91c00e852d9c31d804310d38fad91589fcbac`
+Pinned to `fabric-agent-contract` commit `0cacd08b0e95b6abf131eae1206b60792138bc3c`
 (`docs/specification/service.md`, DEC-0015; the usage report DEC-0021; Windows and Linux supervision
 DEC-0032 and DEC-0033; the operator channel DEC-0034 and DEC-0035; the embedded dashboard DEC-0036;
 delegation and the operator session's lifetime DEC-0039; the meter's call window DEC-0041; session handoff DEC-0042;
 canonical forms DEC-0043; `degraded[].setup` and `run.mcp.stdio.scope` DEC-0044; delegation sealed and trust tiers
-DEC-0045). The contract's schemas are normative;
+DEC-0045; runner and model profiles DEC-0046). The contract's schemas are normative;
 this page is the working summary. Extension key:
 `https://fabric.passioncode.ai/agent-contract/extensions/service/0.1`.
 
@@ -61,6 +61,9 @@ No auth; the Host/Origin guard applies; answered from memory in under 100 ms.
 - A `degraded[]` entry may carry `setup: true` (DEC-0044): the source waits for a person to finish setting it up
   (a key not entered, a model not chosen). It is not an outage, and a watcher does not alert on it. The kits pass
   entries through unchanged.
+- `configuration` (DEC-0046) MAY say which runner and model profile the service resolved and from where
+  (`request`, `agent`, `binding`, `estate`); a usage receipt MAY carry the `route` (`subscription` or `key`). The kits
+  do not emit either yet (FAA-19).
 - `build` needs `commit` or `digest` (`sha256:<64 hex>`).
 - `summary`: at most six tiles; `attention: true` counts toward the host's badge.
 - `surfaces.events` is required; `dashboard` and `mcp` when the service has them; `usage`

package/plugins/fabric-agent-adapter/skills/creating-fabric-agents/SKILL.md

@@ -5,9 +5,9 @@ license: AGPL-3.0-only OR LicenseRef-PassionCode-Commercial
 compatibility: Requires filesystem access and Python 3.9+. Exact schema checks additionally need git, Node.js, pnpm, and the pinned fabric-agent-contract checkout (a public repository). Works without those tools in an explicitly degraded structural-check mode. Ships in one plugin with adapting-projects-to-fabric, whose scripts it reuses.
 metadata:
   author: PassionCode.ai
-  version: "0.12.0"
+  version: "0.14.0"
   contract-version: "0.1.0"
-  contract-commit: "2eb91c00e852d9c31d804310d38fad91589fcbac"
+  contract-commit: "0cacd08b0e95b6abf131eae1206b60792138bc3c"
 ---
 
 # Creating Fabric-compatible agents
@@ -116,10 +116,14 @@ python3 <plugin-dir>/skills/adapting-projects-to-fabric/scripts/adapt_project.py
   scaffold <project-root> --profile <mcp|a2a|local-runner> \
   --provider-id <stable-uri> --provider-name "<name>" \
   --capability-id <stable-uri> --capability-name <domain.action> \
-  --schema-base <immutable-base-uri>
+  --schema-base <immutable-base-uri> --effect <class> \
+  [--idempotency required|supported|none] [--cost-preset <id> <max-usd> "<label>" ... --default-cost-preset <id>]
 ```
 
-Pin exactly contract `0.1.0` at commit `2eb91c00e852d9c31d804310d38fad91589fcbac` and
+The effect class is declared, never defaulted: ask the author what the agent does outside itself when the request
+does not say. Cost presets are only for a run whose cost varies; their amounts come from the author or measured runs.
+
+Pin exactly contract `0.1.0` at commit `0cacd08b0e95b6abf131eae1206b60792138bc3c` and
 read the pinned guide before implementing protocol details. If this skill is installed
 without its sibling, the scaffolder is absent: create the bundle by hand from the pinned
 contract's `docs/guides/connecting-compatible-agents.md` and mark the structural check