@passioncode-ai/fabric-agent-adapter 0.28.0 → 0.29.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 0.29.0 - 2026-10-13
+
+`working-with-fabric` carries the limit-stop rule (fabric-workspace principle 10, item 6, operator 2026-10-13).
+
+### Added
+
+- **A lane stopped on a limit: restart it at once** (`working-with-fabric`, Step 5). Applies to a workflow lane,
+  subagent or session that stops on *You've hit your session / usage limit · resets <time>*, on a rate-limit error,
+  or after 15–20 minutes of silence with its task unfinished. The agent that started it restarts it at once and does
+  not wait for the reset:
+  - a workflow: `TaskStop`, then `Workflow` with `resumeFromRunId` and the same args;
+  - a subagent: `SendMessage` «resume»;
+  - a session: a re-prompt.
+
+  If a restart stops again at once, the next tries come after 2, 5, 10, then every 15 minutes. A spend, credit or
+  billing limit goes to the operator once and is not retried. A long command in flight is not a stall. Each restart
+  goes into a `fabric_task_note`.
+- The description gains the trigger "hit your limit, resets at".
+
+### Evidence
+
+- The scenario eval `limit-stop-restarts-at-once` and two trigger queries (English and Russian) were written before
+  the prose.
+
 ## 0.28.0 - 2026-10-13
 
 A service answers a Project's requests on Fabric's project board (`fabric-project-comms/0.1`; FAA-12b, contract

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@passioncode-ai/fabric-agent-adapter",
-  "version": "0.28.0",
+  "version": "0.29.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; 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.28.0",
+  "version": "0.29.0",
   "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.28.0"
+  version: "0.29.0"
   contract-version: "0.1.0"
   contract-commit: "f00a7685e3861c27f7899c033fb850a145a1708f"
 ---

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

@@ -17,7 +17,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.28.0"
+  version: "0.29.0"
   contract-version: "0.1.0"
   extension: "fabric-service/0.1"
   extension-commit: "f00a7685e3861c27f7899c033fb850a145a1708f"

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.28.0"
+  version: "0.29.0"
   contract-version: "0.1.0"
   contract-commit: "f00a7685e3861c27f7899c033fb850a145a1708f"
 ---

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

@@ -7,7 +7,8 @@ description: >-
   com.submit; unread-mail lines, watch-mail), claiming and releasing work (fabric_work_claim, fabric_work_release),
   reports, handoffs, refusals. Triggers - "connect to Fabric", "register fabric-mcp", "claim the task in Fabric",
   "check the project board", "ask the other project through Fabric", "Fabric is not running", «подключись к
-  Fabric», «возьми задачу в Fabric», «проверь доску проекта», «Fabric не запущен». Explains the plugin's session
+  Fabric», «возьми задачу в Fabric», «проверь доску проекта»,
+  «Fabric не запущен», "hit your limit, resets at". Explains the plugin's session
   hooks. NOT for building or adapting an agent or a board responder (creating-fabric-agents,
   adapting-projects-to-fabric, building-fabric-services), changing Fabric's own code, or messaging people.
 license: AGPL-3.0-only OR LicenseRef-PassionCode-Commercial
@@ -18,7 +19,7 @@ compatibility: >-
   this plugin; Codex and Kimi Code get the session-start preamble hook on the person's consent.
 metadata:
   author: PassionCode.ai
-  version: "0.28.0"
+  version: "0.29.0"
 ---
 
 # Working with Fabric
@@ -146,6 +147,23 @@ A Fabric older than 0.4.0 has no `fabric_work_*` tools: use `fabric_tasks_list`
 - `fabric_question_ask` for a decision you are not entitled to make; `fabric_effect_request` before spending,
   deleting or publishing — refused until a person agrees.
 
+### A lane stopped on a limit: restart it at once
+
+A workflow lane, subagent or session can stop on *You've hit your session / usage limit · resets <time>* or a
+rate-limit error. It can also go silent: no transcript write for 15–20 minutes, its task unfinished, and no command
+of its own still running. In each case, do not wait for the reset ([principle 10, item 6](https://github.com/passioncode-ai/fabric-workspace/blob/main/knowledge/principles.md#10-a-free-agent-takes-the-next-task)).
+Restart it from where it stopped:
+
+- a workflow: stop it (`TaskStop`), then call `Workflow` with `resumeFromRunId` and **the same args**. Finished
+  agents replay from the cache; the failed or stalled ones run again;
+- a subagent: `SendMessage` «resume» to its id, so it keeps its context;
+- a session: re-prompt it with «continue from where you stopped».
+
+The stop is usually stale by then. Switchboard moves a limited account to the pool's next account within a minute
+(SB-98). If a restart stops again at once, retry after 2, 5, 10, then every 15 minutes, and do other work meanwhile.
+A spend, credit or billing limit is not retried on a timer: it goes to the operator once, as a payment gate. A long
+build or test in flight is not a stall. Note each restart (what stopped, when, attempt) with `fabric_task_note`.
+
 ## Step 6 — tasks link to backlog rows, never copy them
 
 A backlog row in a repository stays the status source. File the Fabric task that runs it with the row's address:

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

@@ -60,7 +60,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.28.0"
+VERSION = "0.29.0"
 HOSTS = {"claude": "Claude Code", "codex": "Codex", "kimi": "Kimi Code"}
 # A session Fabric launched. FABRIC_LAUNCHED_SESSION=1 is the marker Fabric is asked to set (need D6); the others are
 # what Fabric already gives a launched session (fabric sessionBundle.ts): only their NAMES are looked at, never a value