@passioncode-ai/fabric-agent-adapter 0.35.3 → 0.35.4

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.35.4 - 2026-10-19
+
+### Changed
+
+- **The session hooks rejoin a session at most once a minute** (FAA-53). Every `fabric-mcp --rejoin-only` spends the
+  agent's Fabric request budget, which every session on the machine shares; with about forty Claude Code sessions,
+  agents waited minutes on "Fabric is rate limited". The worker marks a successful rejoin in the session's folder; a
+  turn within 60 s of it is spooled and delivered by the next worker, and the end of a session always starts one.
+  Fabric fixed its side in CO-334 (per-session charging, jitter after `Retry-After`) and advised this skip.
+- **`creating-fabric-agents` → resilience reference follows contract DEC-0087** (FAA-56, guidance part): the codes
+  are `quota-exhausted` and `outcome-unknown`; a job a limit only paused stays `working` with the pause grammar in its
+  `statusMessage`; a job its provider will not resume ends `failed` with `data: {retryable, resetsAt?}`; a caller acts
+  as `jobCallerAction` does. The kits' rules and vectors come with the repin (FAA-54).
+
 ## 0.35.3 - 2026-10-19
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@passioncode-ai/fabric-agent-adapter",
-  "version": "0.35.3",
+  "version": "0.35.4",
   "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; and teach a coding agent to work in a project through Fabric (fabric-mcp, fabric_whoami, claim and release), with Claude Code session hooks.",
-  "version": "0.35.3",
+  "version": "0.35.4",
   "author": {
     "name": "PassionCode.ai",
     "url": "https://passioncode.ai/"

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

@@ -5,7 +5,7 @@ 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.35.3"
+  version: "0.35.4"
   contract-version: "0.1.0"
   contract-commit: "d8146cfb0a1c74fc6432284c4356bb0c864b37b5"
 ---

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

@@ -18,7 +18,7 @@ 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 install a systemd user unit and Windows ones a per-user Scheduled Task with the kits' writers. 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.35.3"
+  version: "0.35.4"
   contract-version: "0.1.0"
   extension: "fabric-service/0.1"
   extension-commit: "d8146cfb0a1c74fc6432284c4356bb0c864b37b5"

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

@@ -5,7 +5,7 @@ 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.35.3"
+  version: "0.35.4"
   contract-version: "0.1.0"
   contract-commit: "d8146cfb0a1c74fc6432284c4356bb0c864b37b5"
 ---

package/plugins/fabric-agent-adapter/skills/creating-fabric-agents/references/resilience-and-autonomy.md

@@ -19,9 +19,14 @@ mechanism that held after the fix. Every rule is cheaper to build in than to ret
 
 ## Limits are pauses
 
-1. **A provider or subscription limit pauses the job; it never fails it.** Store a typed pause
-   (`quota_exhausted`, `retryable: true`, the reset time when known) and resume from the same
-   stage. Failing it cost callers whole jobs and resubmits.
+1. **A provider or subscription limit pauses the job; it never fails it.** Keep the job `working` and
+   write its `statusMessage` in the contract's pause grammar, `quota-exhausted` or
+   `quota-exhausted until <UTC instant>` (optionally `: <text>`, at most 500 characters), with
+   `pollIntervalMs` reaching the reset; resume from the same stage. Only a job its provider will not
+   resume ends `failed` with `error: {code: "quota-exhausted", message, data: {retryable, resetsAt?}}`:
+   `retryable: false` when a person must act, and `resetsAt` (UTC, `T` and `Z`, at most three
+   fraction digits) only when `retryable: true` (contract DEC-0087, `FAC-SEM-119`). Failing a job a
+   limit only paused cost callers whole jobs and resubmits.
 2. **Resume first.** Every worker reads its own state — checkpoint, worktree, branches, open
    pull requests, notes — before it acts, and continues from there. Relaunching from scratch
    after a limit recreated work over committed work and re-issued credentials already held.
@@ -88,7 +93,11 @@ mechanism that held after the fix. Every rule is cheaper to build in than to ret
 4. **A resend of an unknown outcome reuses its idempotency key — or does not happen.** Derive
    keys from the intent (action and entity, or run and step), never from a clock or a random
    value, and make them unique in storage: time-and-random keys let redelivered requests charge
-   again. A write whose effect is uncertain stops as `outcome_unknown`; a new key there pays twice.
+   again. A write whose effect is uncertain ends `failed` with the code `outcome-unknown`; only an
+   observed result settles it, and a new key there pays twice. A caller acts on each answer as the
+   contract's `jobCallerAction` does: wait out a pause, resend a retryable `quota-exhausted` under the
+   same key after `resetsAt`, hand a non-retryable one or `limit-reached` to a person, reconcile an
+   `outcome-unknown`, and never resend it.
 5. **A client error at submit is a rejection, not a lost task.** Settle it with known usage (zero
    if none), release the reserved money in the same transaction, and never resend the identical
    request; a 4xx while polling is still a lost task.

package/plugins/fabric-agent-adapter/skills/working-with-fabric/SKILL.md

@@ -19,7 +19,7 @@ compatibility: >-
   this plugin; Codex/Kimi use command hooks; Hermes/OpenCode/OpenClaw/Pi use native context plugins after opt-in.
 metadata:
   author: PassionCode.ai
-  version: "0.35.3"
+  version: "0.35.4"
 ---
 
 # Working with Fabric

package/plugins/fabric-agent-adapter/skills/working-with-fabric/references/session-hooks.md

@@ -87,6 +87,9 @@ only variable names are looked at, never a value (two of them carry the session'
 - **Start a second Fabric session.** A `fabric-mcp` started on its own would enroll a new session, and Fabric ends a
   binding's oldest live session past eight (ADR-0134 amendment 2) — the agent's own. The worker and `watch-mail` run
   `fabric-mcp --rejoin-only --runtime-session-id <id>`, and only when Fabric advertises `session-hooks/1`.
+- **Rejoin more than once a minute.** Every rejoin spends the agent's Fabric request budget, which every session of
+  the machine shares. A turn within 60 s of the session's last successful rejoin (the worker marks it as `rejoined`
+  in the session's folder) is spooled and waits for the next worker; the end of a session always starts one (FAA-53).
 - **Retry in a loop.** A refused call is logged by its error code and dropped; an answer that never came is logged
   as `outcome=unknown`. The calls carry an `idempotencyKey`, so a repeat is the same event.
 

package/plugins/fabric-agent-adapter/skills/working-with-fabric/scripts/fabric_session.py

@@ -56,6 +56,9 @@ LOCK_STALE_S = 30.0
 #: A session folder untouched this long belongs to a session that will not spool again: its worker failed, or the
 #: session ended without SessionEnd. Nothing retries it, so the next spooling hook removes it (FAA-50).
 SESSION_STALE_S = 7 * 86400
+#: A session rejoins at most once in this span (FAA-53): every rejoin spends Fabric's per-agent request budget, which
+#: every session of the machine shares; a turn inside it waits in the spool for the next worker, an end never waits.
+REJOIN_MIN_INTERVAL_S = 60.0
 READ_CAP = 64 * 1024
 CONFIG_CAP = 32 * 1024 * 1024
 WATCH_MIN_INTERVAL_S = 10
@@ -63,7 +66,7 @@ WATCH_MAX_BACKOFF_S = 900
 SESSION_ID = re.compile(r"[A-Za-z0-9._:-]{1,128}")
 LOOPBACK_ORIGIN = re.compile(r"http://127\.0\.0\.1:(\d{1,5})")
 LOCAL_ORIGIN = re.compile(r'"origin": "http://(?:127\.0\.0\.1|localhost)')
-VERSION = "0.35.3"
+VERSION = "0.35.4"
 HOSTS = {"claude": "Claude Code", "codex": "Codex", "kimi": "Kimi Code",
          "hermes": "Hermes", "opencode": "OpenCode", "openclaw": "OpenClaw", "pi": "Pi"}
 NATIVE_PLUGIN_HOSTS = frozenset(("hermes", "opencode", "openclaw", "pi"))
@@ -559,10 +562,21 @@ def hook_spool(payload: Dict[str, Any], event: str, env: Optional[Dict[str, str]
     if event == "end" and isinstance(payload.get("reason"), str):
         entry["reason"] = payload["reason"][:64]
     spool(directory, entry)
-    if event == "end" or not lock_held(directory):
-        spawn(directory)
-        return "spooled: worker started"
-    return "spooled: a worker is running"
+    if event != "end" and lock_held(directory):
+        return "spooled: a worker is running"
+    if event != "end" and rejoined_recently(directory):
+        return "spooled: rejoined recently"
+    spawn(directory)
+    return "spooled: worker started"
+
+
+def rejoined_recently(directory: Path, now: Optional[float] = None) -> bool:
+    """Whether this session's last rejoin succeeded within REJOIN_MIN_INTERVAL_S (the worker marks it)."""
+    try:
+        mark = (directory / "rejoined").stat().st_mtime
+    except OSError:
+        return False
+    return 0 <= (time.time() if now is None else now) - mark < REJOIN_MIN_INTERVAL_S
 
 
 def _remove_tree(directory: Path) -> None:
@@ -801,6 +815,7 @@ def deliver(directory: Path, env: Optional[Dict[str, str]] = None, deadline_s: f
                                       "clientInfo": {"name": "fabric-agent-adapter-hooks", "version": VERSION}})
         client.notify("notifications/initialized")
         names = _wait_for_session_tools(client, deadline)
+        _write_private(directory / "rejoined", "")
         while entries:
             for path in entries:
                 entry = json.loads(read_small(path) or "{}")