@passioncode-ai/fabric-agent-adapter 0.4.2 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,75 @@
 # Changelog
 
+## 0.5.0 - 2026-09-30
+
+### Added
+
+- **`fabric-interop/0.1` in the kits** (Fabric Agent Contract DEC-0016).
+  `building-fabric-services/scripts/fabric_interop.py` and its Node twin
+  `fabric-interop.mjs`: W3C trace context (`child_traceparent`, `trace_ids`), a
+  capability served as the MCP tool of its name with annotations from its effect,
+  durable jobs (`JobStore`: ids survive a restart, terminal states never change,
+  `unknown-job` for an unknown id), the result envelope with `usage`, and elicitations
+  (a titled single-select in form mode, URL mode for secrets; form mode refuses a
+  secret field). Python also ships `McpToolServer`, a minimal `tools/list` /
+  `tools/call` dispatcher with `fabric.job.get` and `fabric.job.cancel` built in.
+- Events carry `traceId` and `spanId` as a pair (`make_event`, `makeEvent`).
+- The sample service serves MCP at `/mcp`: `sample.echo`, and `sample.draft`, a job
+  that stops for a title choice and completes with a traced result. `register` writes
+  its manifest and schemas and points the descriptor's `fabricManifest` at it.
+- The probe `check_service.py` gains seven `interop.*` rules: manifest link (G-07),
+  capability list, tools equal to the manifest (FAC-SEM-017), job tools, unknown job,
+  trace propagation and event trace pairs. It calls only `tools/list` and
+  `fabric.job.get` for a made-up id.
+- `adapting-projects-to-fabric/scripts/fabric_provider.py`: writes, validates and
+  removes `fabric-provider/0.1` entries for agents that are not services — argv only,
+  env values as `secret-ref:` references, never the id of an existing service.
+- `adapt_project.py scaffold --job` writes the capability's interop block; an `mcp`
+  capability now requires the tool of its own name instead of `tool:replace-me`, and
+  `check` refuses a malformed interop block.
+- Skills teach it: `building-fabric-services` gains `references/interop.md`,
+  `adapting-projects-to-fabric` gains `references/provider-entry.md` and step 4b, and
+  `creating-fabric-agents` starts new agents on it. Trigger and scenario evals added
+  first.
+
+### Changed
+
+- **Contract pin** moves from `a5a2709` to `a22dea3` (fabric-agent-contract `main`,
+  AR-1: interop, provider entries, runner catalogue, pipelines). The provider profiles
+  and every existing schema field are unchanged; the contract added schemas and
+  optional fields only (DEC-0016). **One pin**: `fabric-contract.lock.json`, and
+  `test/validate.py` fails any live file that names another contract revision (G-11).
+- The README has a newcomer path that starts the sample service and probes it.
+
+## 0.4.3 - 2026-09-29
+
+### Changed
+
+- **License.** The adapter is now source-available under
+  `PolyForm-Noncommercial-1.0.0 OR LicenseRef-PolyForm-Internal-Use-1.0.0`, with a
+  commercial license on request (contact@passioncode.ai). Versions up to and including
+  v0.4.2, on GitHub and on npm, were released under MIT and remain available under it. The manifests, the three skills' `license:` and the README say the
+  same; contributions come in under `CLA.md`, which the new PR template asks for.
+  `test/validate.py` fails a tree that slips back to MIT.
+- Author and marketplace owner are PassionCode.ai (`https://passioncode.ai/`).
+- **Contract pin** moves from `20a818e` to `a5a2709` (fabric-agent-contract `main`), the
+  commit `building-fabric-services` already pinned. Between the two the provider
+  profiles are unchanged — only the `fabric-service/0.1` extension was added — and
+  `adapt_project.py check --contract` gives the same verdicts for an MCP, an A2A and a
+  local-runner bundle at both commits (declaration shape PASS). One pin for all three
+  skills.
+- `creating-fabric-agents` hands the agent's own loop to `agent-orchestrator`, its
+  eval suite to `agent-evals` (agent-stack) and plugin packaging to `make-skill`;
+  `adapting-projects-to-fabric` sends wire-level MCP/A2A questions to `agent-interop`.
+
+### Fixed
+
+- The installer's help names the launcher by its npm org name,
+  `npx @passioncode-ai/passioncode@latest update`; the bare `passioncode` is not ours.
+- A distributed eval named a personal agent as its example service; the
+  `building-fabric-services` evals use `example-agent`, and its description says "a
+  macOS machine" instead of naming whose.
+
 ## 0.4.2 - 2026-09-29
 
 - Kit: `LoopbackHTTPServer`, a `ThreadingHTTPServer` whose bind asks no resolver.

package/LICENSE

@@ -1,22 +1,155 @@
-MIT License
+Copyright (c) 2026 Siarhei Sheleh
 
-Copyright (c) 2026 passioncode-ai
+This software is source-available, not open source. You may use it under
+either of the two licenses below, at your option:
 
-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:
+  1. PolyForm Noncommercial License 1.0.0
+     SPDX: PolyForm-Noncommercial-1.0.0
+  2. PolyForm Internal Use License 1.0.0
+     SPDX: LicenseRef-PolyForm-Internal-Use-1.0.0
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+In short: individuals and noncommercial organisations may use, change and
+share it for noncommercial purposes; any company may use it, and change it,
+for its own internal operations. Distributing it commercially, or building
+this software or its code into a product or service you provide to others,
+needs a separate commercial license: contact@passioncode.ai.
+This summary is not part of either license; the texts below govern.
 
-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.
+Versions up to and including v0.4.2 of this repository, and of its npm package, were
+released under the MIT License; those releases remain available under MIT.
 
+Required Notice: Copyright (c) 2026 Siarhei Sheleh (https://passioncode.ai)
+
+================================================================================
+
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose.  However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license to distribute copies of the software.  Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution is use for a permitted purpose regardless of the source of funding or obligations resulting from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else.  These terms do not imply any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice.  Otherwise, all your licenses end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
+
+**You** refers to the individual or entity agreeing to these terms.
+
+**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization.  **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the software under these terms.
+
+**Use** means anything you do with the software requiring one of your licenses.
+
+================================================================================
+
+# PolyForm Internal Use License 1.0.0
+
+<https://polyformproject.org/licenses/internal-use/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose.  However, you may only make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license), and you may not distribute the software.
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the law. These terms do not limit them.
+
+## Internal Business Use
+
+Use of the software for the internal business operations of you and your company is use for a permitted purpose.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else.  These terms do not imply any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice.  Otherwise, all your licenses end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
+
+**You** refers to the individual or entity agreeing to these terms.
+
+**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization.  **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the software under these terms.
+
+**Use** means anything you do with the software requiring one of your licenses.

package/README.md

@@ -15,9 +15,9 @@ without moving the Project onto one proprietary agent runtime.
 
 [![npm](https://img.shields.io/npm/v/%40passioncode-ai%2Ffabric-agent-adapter)](https://www.npmjs.com/package/@passioncode-ai/fabric-agent-adapter)
 [![validate](https://github.com/passioncode-ai/fabric-agent-adapter/actions/workflows/validate.yml/badge.svg)](https://github.com/passioncode-ai/fabric-agent-adapter/actions/workflows/validate.yml)
-[![license](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![license](https://img.shields.io/badge/license-source--available-blue.svg)](LICENSE)
 
-Private, portable Agent Skills for the
+Portable Agent Skills that make any agent Fabric-compatible, for the
 [Fabric Agent Contract](https://github.com/passioncode-ai/fabric-agent-contract):
 `adapting-projects-to-fabric`, `creating-fabric-agents` and
 `building-fabric-services`.
@@ -32,6 +32,14 @@ complete `scripts/sample_service.py`, and `scripts/check_service.py`, a live pro
 python3 plugins/fabric-agent-adapter/skills/building-fabric-services/scripts/check_service.py example-agent
 ```
 
+Services and agents that other agents call follow `fabric-interop/0.1`: each capability
+is the MCP tool of its name, long work is a job with a stable id (`fabric.job.get`,
+`fabric.job.cancel`), a question for a person is an elicitation, and every call carries
+one W3C trace. The kits ship the helpers (`scripts/fabric_interop.py`,
+`scripts/fabric-interop.mjs`), the sample service serves a job end to end, and the probe
+checks the interop rules. An agent that is not a service is announced with a provider
+entry: `adapting-projects-to-fabric/scripts/fabric_provider.py`.
+
 For provider bundles the adapting skill helps an agent author:
 
 - inspect the project's stable integration surfaces without executing it;
@@ -46,7 +54,7 @@ yet ship the host registry/runtime needed to connect and authorize a live provid
 
 ## Install
 
-The repository is private; the npm package is public. The npm path needs no GitHub access — the GitHub paths do.
+The repository and the npm package are public; neither path needs an account.
 
 npm — no GitHub access required:
 
@@ -110,6 +118,23 @@ python3 "$SKILL_DIR/scripts/adapt_project.py" check /path/to/project \
 Scaffolding is non-destructive by default. It writes only the paths declared in the
 [delivery brief](docs/evidence/specs/2026-08-27-brief.md) and refuses collisions.
 
+## Verify one service (newcomer path)
+
+After installing (above), with Python 3.9+ and no other dependency:
+
+```bash
+KIT=plugins/fabric-agent-adapter/skills/building-fabric-services/scripts   # or ~/.agents/skills/building-fabric-services/scripts
+DATA=$(mktemp -d); SERVICES=$(mktemp -d)
+python3 "$KIT/sample_service.py" serve --port 47190 --data-dir "$DATA" &
+python3 "$KIT/sample_service.py" register --port 47190 --data-dir "$DATA" --services-dir "$SERVICES"
+python3 "$KIT/check_service.py" sample --services-dir "$SERVICES"   # exit 0: no FAIL
+kill %1
+```
+
+The probe prints one line per rule — `PASS`, `FAIL` or `NOT_RUN` with its evidence — and
+exits 1 on any `FAIL`. Run it against your own service by its id once its installer has
+written the descriptor.
+
 ## Validate this repository
 
 ```bash
@@ -125,8 +150,21 @@ checks copies installed elsewhere, such as `~/.agents/skills/*/SKILL.md`.
 
 ## Contract pin
 
+The one pin is [`fabric-contract.lock.json`](fabric-contract.lock.json):
+
 - version: `0.1.0`
-- commit: `20a818e648a4c09a60df0126d11626922e8b9094`
+- commit: `a22dea359ba04b8fe549abe81a5131552cb90eff`
+
+Every other mention of the contract revision — this section, the skills' metadata, the
+skill card, `adapt_project.py` — must equal it; `python3 test/validate.py` fails a tree
+where one does not. The contract repository is normative. Updating the pin requires a
+new adapter release, fixture review, and a complete validation run.
+
+## License
 
-The contract repository is normative. Updating the pin requires a new adapter release,
-fixture review, and a complete validation run.
+Source-available under PolyForm Noncommercial or Internal Use; commercial license on
+request (contact@passioncode.ai). SPDX:
+`PolyForm-Noncommercial-1.0.0 OR LicenseRef-PolyForm-Internal-Use-1.0.0` — see
+[LICENSE](LICENSE). Versions up to and including v0.4.2 (on GitHub and on npm) were
+released under the MIT License and remain available under it. Contributions are accepted under
+[CLA.md](CLA.md) ([CONTRIBUTING.md](CONTRIBUTING.md)).

package/SECURITY.md

@@ -1,8 +1,7 @@
 # Security
 
-Report vulnerabilities privately to the maintainers of the `passioncode-ai`
-organization. Do not open a public issue containing credentials, private provider URLs,
-or customer project data.
+Report vulnerabilities privately to contact@passioncode.ai. Do not open a public issue
+containing credentials, private provider URLs, or customer project data.
 
 The adapter must not write secret values to manifests, fixtures, probes, logs, or command
 arguments. Generated and external provider outputs are untrusted. Live probes must be

package/bin/fabric-agent-adapter.js

@@ -35,7 +35,7 @@ Claude Code (recommended):
   claude plugin marketplace add ${REPO}
   claude plugin install ${PLUGIN_ID}
 Every PassionCode.ai skill for every agent at once:
-  npx passioncode@latest update`);
+  npx @passioncode-ai/passioncode@latest update`);
 }
 
 function copyDir(src, dest) {

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@passioncode-ai/fabric-agent-adapter",
-  "version": "0.4.2",
+  "version": "0.5.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": "python3 test/validate.py && python3 -m unittest discover -s test -q && node --test 'test/*.test.mjs'"
   },
   "bin": {
     "fabric-agent-adapter": "bin/fabric-agent-adapter.js"
@@ -23,10 +23,10 @@
   ],
   "repository": "github:passioncode-ai/fabric-agent-adapter",
   "homepage": "https://github.com/passioncode-ai/fabric-agent-adapter",
-  "license": "MIT",
+  "license": "PolyForm-Noncommercial-1.0.0 OR LicenseRef-PolyForm-Internal-Use-1.0.0",
   "author": {
-    "name": "passioncode-ai",
-    "url": "https://github.com/passioncode-ai"
+    "name": "PassionCode.ai",
+    "url": "https://passioncode.ai/"
   },
   "engines": {
     "node": ">=16"

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

@@ -3,14 +3,14 @@
   "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.4.2",
+  "version": "0.5.0",
   "author": {
-    "name": "passioncode-ai",
-    "url": "https://github.com/passioncode-ai"
+    "name": "PassionCode.ai",
+    "url": "https://passioncode.ai/"
   },
   "homepage": "https://github.com/passioncode-ai/fabric-agent-adapter",
   "repository": "https://github.com/passioncode-ai/fabric-agent-adapter",
-  "license": "MIT",
+  "license": "PolyForm-Noncommercial-1.0.0 OR LicenseRef-PolyForm-Internal-Use-1.0.0",
   "keywords": [
     "fabric",
     "agent",

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

@@ -1,13 +1,13 @@
 ---
 name: adapting-projects-to-fabric
 description: Use when adapting an existing agent, MCP server, A2A peer, HTTP service, or terminal CLI to the Fabric Agent Contract—choosing MCP/A2A/local-runner, scaffolding a provider bundle, or checking Fabric compatibility; also for «подключить проект к Fabric» or «сделать агента совместимым с Fabric». NOT for building the Fabric host/orchestrator, configuring an MCP client, or a brand-new agent — that is creating-fabric-agents.
-license: MIT
+license: PolyForm-Noncommercial-1.0.0 OR LicenseRef-PolyForm-Internal-Use-1.0.0
 compatibility: Requires filesystem access and Python 3.9+. Exact schema checks additionally need git, Node.js, pnpm, and the pinned private fabric-agent-contract checkout. Works without those tools in an explicitly degraded structural-check mode.
 metadata:
-  author: passioncode-ai
-  version: "0.4.2"
+  author: PassionCode.ai
+  version: "0.5.0"
   contract-version: "0.1.0"
-  contract-commit: "20a818e648a4c09a60df0126d11626922e8b9094"
+  contract-commit: "a22dea359ba04b8fe549abe81a5131552cb90eff"
 ---
 
 # Adapting projects to Fabric
@@ -22,6 +22,9 @@ Use this skill to adapt or assess a provider project. Do not use it to:
 
 - design the Fabric host, registry, scheduler, admission service, or project binding runtime;
 - add an MCP server to Claude Code, Codex, or an agent gateway;
+- answer wire-level MCP or A2A questions (transports, sessions, auth handshakes, task
+  states on the wire) — that is `agent-interop` (agent-stack); the pinned contract stays
+  normative for what Fabric requires;
 - design a new agent from scratch — that is the sibling skill creating-fabric-agents;
 - claim admission merely because generated files or a valid manifest exist.
 
@@ -67,7 +70,7 @@ Use exactly:
 
 - contract version `0.1.0`;
 - repository `https://github.com/passioncode-ai/fabric-agent-contract`;
-- commit `20a818e648a4c09a60df0126d11626922e8b9094`.
+- commit `a22dea359ba04b8fe549abe81a5131552cb90eff`.
 
 Read the pinned contract's guide
 `docs/guides/connecting-compatible-agents.md`, the selected profile specification, and
@@ -90,7 +93,10 @@ python3 <skill-dir>/scripts/adapt_project.py scaffold <project-root> \
   --schema-base https://agents.example/fabric
 ```
 
-Valid profiles are `mcp`, `a2a`, and `local-runner`. The helper creates only the locked
+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
 authorizes replacement after the exact conflicting files and diff are shown.
 
@@ -105,6 +111,11 @@ Preserve the chosen ownership boundary:
 - A2A maps the provider's remote task, progress, artifact, cancellation, and terminal
   states; Fabric does not take over its internal loop.
 - MCP exposes bounded tools/resources/prompts while Fabric owns planning and retries.
+  The served tool's name, input and output schemas equal the manifest's (FAC-SEM-017);
+  long work returns a job handle and serves `fabric.job.get` / `fabric.job.cancel`; a
+  question for a person is a form-mode choice, a secret goes through URL mode; every call
+  runs as a child span of `_meta.traceparent`. The kit for all of it is
+  `building-fabric-services`'s `scripts/fabric_interop.py`.
 - Local runner maps typed input, executable identity, result location, cancellation,
   heartbeat, and partial results without relying on ambient accounts.
 
@@ -112,6 +123,14 @@ Keep model selection and provider-internal reasoning outside the Fabric contract
 typed outcomes, evidence, artifacts, and protocol-visible state—not chain-of-thought.
 Treat all provider output as untrusted until schemas and semantic assertions pass.
 
+### 4b. Announce an agent that is not a service
+
+An agent Fabric reaches as a CLI or a stdio MCP server gets a provider entry, written by
+its installer with [`scripts/fabric_provider.py`](scripts/fabric_provider.py) and removed
+by its uninstaller — argv arrays only, env values as `secret-ref:` references, never the
+id of an existing service. Load [provider entries](references/provider-entry.md). An
+agent that runs as a service uses a descriptor instead (`building-fabric-services`).
+
 ### 5. Make probes safe and meaningful
 
 For each capability, create at least one bounded fixture that:

package/plugins/fabric-agent-adapter/skills/adapting-projects-to-fabric/references/provider-entry.md

@@ -0,0 +1,53 @@
+# Provider entries: agents that are not services
+
+Normative source: the Fabric Agent Contract's `docs/specification/provider.md`
+(`fabric-provider/0.1`, DEC-0016) at the commit this plugin pins.
+
+An agent Fabric reaches as a CLI or a stdio MCP server — not a long-running service —
+is announced by one entry, `providers/<id>.json`, in the same root as the services
+directory:
+
+| Platform | Directory |
+|---|---|
+| macOS | `~/Library/Application Support/ai.passioncode.fabric/providers/` |
+| Linux | `${XDG_DATA_HOME:-~/.local/share}/passioncode-fabric/providers/` |
+| any | `FABRIC_PROVIDERS_DIR` when set |
+
+A service uses a descriptor instead (the `building-fabric-services` skill). One id is a
+service or a provider, never both.
+
+## The writer
+
+`scripts/fabric_provider.py` is the installer's tool; it writes atomically, mode 0600,
+and refuses what the contract refuses.
+
+```bash
+python3 scripts/fabric_provider.py write --id example-agent --name "Example Agent" \
+  --manifest ~/.local/share/example-agent/fabric-agent.json --installed-by "example-agent 1.0.0" \
+  --env EXAMPLE_API_KEY=secret-ref:example-agent/EXAMPLE_API_KEY \
+  --stdio ~/.local/bin/example-agent mcp
+python3 scripts/fabric_provider.py write ... --url http://127.0.0.1:47201/mcp
+python3 scripts/fabric_provider.py validate ~/Library/Application\ Support/ai.passioncode.fabric/providers/example-agent.json
+python3 scripts/fabric_provider.py remove example-agent      # the uninstaller
+```
+
+`--stdio` takes the rest of the line as the argument array; there is no shell string.
+
+It refuses, with one sentence that never quotes a value:
+
+- an id that is already a service in `services/` (FAC-SEM-013);
+- an env value that is not `secret-ref:<name>`, or a reference that has the shape of a
+  credential itself — a token prefix, a private key, a JWT (FAC-SEM-015);
+- a URL other than `http://127.0.0.1:<port>/mcp`, a manifest path that is not an
+  absolute or `~/` path to `fabric-agent.json`, a shell-string command, unknown fields.
+
+From Python: `write_provider_entry(entry)`, `remove_provider_entry(id)`,
+`validate_provider_entry(entry)`, `providers_dir()`.
+
+## What the entry does not do
+
+It grants nothing: Fabric lists the agent, and admission (probes) and a project binding
+still decide what it may do. The manifest it points at is the authority for the
+agent's capabilities. The contract's rule that the manifest's `provider.id` "equals" the
+entry's id cannot hold as written — `provider.id` is a URI, the entry id a slug — so only
+"the manifest resolves" is checked until the contract answers OQ-0001.

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

@@ -16,7 +16,8 @@ from urllib.parse import urlparse
 
 CONTRACT_VERSION = "0.1.0"
 CONTRACT_REPOSITORY = "https://github.com/passioncode-ai/fabric-agent-contract"
-CONTRACT_COMMIT = "20a818e648a4c09a60df0126d11626922e8b9094"
+CONTRACT_COMMIT = "a22dea359ba04b8fe549abe81a5131552cb90eff"
+INTEROP_KEY = "https://fabric.passioncode.ai/agent-contract/extensions/interop/0.1"
 MCP_REVISION = "2026-07-28"
 A2A_VERSION = "1.0"
 LOCAL_VERSION = "fabric-local-runner/0.1"
@@ -167,7 +168,8 @@ def _profile(args: argparse.Namespace, schema_base: str) -> Dict[str, Any]:
             "kind": "mcp",
             "protocolRevision": MCP_REVISION,
             "connection": connection,
-            "requiredFeatures": ["tool:replace-me"],
+            # fabric-interop/0.1 C3.1: the capability is served as the MCP tool of its own name.
+            "requiredFeatures": ["tool:%s" % args.capability_name],
             "probes": [probe],
         }
     if profile == "a2a":
@@ -215,6 +217,8 @@ def _generated_files(args: argparse.Namespace) -> Dict[str, str]:
     _require_absolute_uri(args.agent_card_url, "Agent Card URL")
     if urlparse(args.agent_card_url).scheme != "https":
         raise AdaptationError("Agent Card URL must use HTTPS")
+    if getattr(args, "job", False) and args.profile != "mcp":
+        raise AdaptationError("--job marks an MCP capability as a job (fabric-interop/0.1); %s has no job handle" % args.profile)
     for runtime_arg in args.runtime_arg:
         lowered = runtime_arg.lower().replace("_", "").replace("-", "")
         if any(term in lowered for term in ("password", "apikey", "accesstoken", "clientsecret")):
@@ -249,6 +253,8 @@ def _generated_files(args: argparse.Namespace) -> Dict[str, str]:
             }
         ],
     }
+    if getattr(args, "job", False):
+        manifest["capabilities"][0]["extensions"] = {INTEROP_KEY: {"job": True}}
     lock = {
         "contract": "fabric-agent-contract",
         "version": CONTRACT_VERSION,
@@ -431,6 +437,12 @@ def check_project(root: Path, contract: Optional[Path]) -> Dict[str, Any]:
                     errors.append("capability[%d] must pin %s=%s" % (index, expected[0], expected[1]))
                 if not profile.get("probes"):
                     errors.append("capability[%d] must declare probes" % index)
+                block = (capability.get("extensions") or {}).get(INTEROP_KEY)
+                if block is not None:
+                    if not isinstance(block, dict) or set(block) - {"job"} or not isinstance(block.get("job", False), bool):
+                        errors.append("capability[%d] interop block must be {\"job\": true|false}" % index)
+                    elif kind != "mcp":
+                        errors.append("capability[%d] interop block is for an mcp capability, not %s" % (index, kind))
                 for field in ("inputSchema", "outputSchema"):
                     value = capability.get(field)
                     try:
@@ -503,6 +515,7 @@ 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("--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")