@passioncode-ai/fabric-agent-adapter 0.62.0 → 0.64.0

package/plugins/fabric-agent-adapter/skills/building-fabric-services/recipes/support-agent/support_agent.py

@@ -39,8 +39,9 @@ import re
 import secrets
 import sys
 import threading
+import time
 from pathlib import Path
-from typing import Any, Callable, Dict, List, Mapping, Optional
+from typing import Any, Callable, Dict, List, Mapping, Optional, Tuple, Union
 
 if str(Path(__file__).resolve().parent) not in sys.path:  # the kit installed beside it, under `python3 -I` too
     sys.path.insert(0, str(Path(__file__).resolve().parent))
@@ -128,6 +129,25 @@ def words(text: str) -> set:
     return {w for w in (m.lower() for m in _WORD.findall(text)) if len(w) > 1 and w not in STOPWORDS}
 
 
+#: How deep the knowledge file may nest (the file, its entries list, an entry, a member): far past any real entry.
+MAX_KNOWLEDGE_DEPTH = 32
+
+
+def _depth(value: Any) -> int:
+    """How deep a parsed JSON value nests, walked without recursion."""
+    deepest, stack = 0, [(value, 1)]
+    while stack:
+        item, level = stack.pop()
+        deepest = max(deepest, level)
+        if level > MAX_KNOWLEDGE_DEPTH:
+            return level
+        if isinstance(item, dict):
+            stack.extend((child, level + 1) for child in item.values())
+        elif isinstance(item, list):
+            stack.extend((child, level + 1) for child in item)
+    return deepest
+
+
 class Knowledge:
     """Entries `{id, question, answer, tags?}` from a JSON file (`{"entries": [...]}`); ids are unique."""
 
@@ -138,14 +158,28 @@ class Knowledge:
                 raise RecipeError("every knowledge entry has an id of letters, digits, '.', '_', ':' or '-'")
             if not isinstance(entry.get("answer"), str) or not entry["answer"].strip():
                 raise RecipeError("knowledge entry %s has no answer" % entry["id"])
+            if "question" in entry and not isinstance(entry["question"], str):
+                raise RecipeError("knowledge entry %s has a question that is not text" % entry["id"])
+            tags = entry.get("tags", [])
+            if not isinstance(tags, list) or not all(isinstance(tag, str) for tag in tags):
+                raise RecipeError("knowledge entry %s has tags that are not a list of text" % entry["id"])
             if entry["id"] in self.entries:
                 raise RecipeError("knowledge entry %s appears twice" % entry["id"])
             self.entries[entry["id"]] = dict(entry)
 
     @classmethod
     def load(cls, path: Path) -> "Knowledge":
-        data = json.loads(Path(path).read_text(encoding="utf-8"))
-        return cls(data.get("entries", []) if isinstance(data, dict) else [])
+        try:
+            data = json.loads(Path(path).read_text(encoding="utf-8"))
+        except RecursionError:
+            raise RecipeError("the knowledge file is nested too deep to read") from None
+        except ValueError:  # not JSON at all: refused like every other wrong shape, its content never quoted
+            raise RecipeError("the knowledge file %s is not JSON" % Path(path).name) from None
+        if not isinstance(data, dict) or not isinstance(data.get("entries"), list):
+            raise RecipeError("the knowledge file is an object with an `entries` list")  # never an empty set by mistake
+        if _depth(data) > MAX_KNOWLEDGE_DEPTH:  # the same verdict on every Python, whatever its parser's own limit
+            raise RecipeError("the knowledge file is nested too deep to read")
+        return cls(data["entries"])
 
     def lookup(self, question: str, limit: int = 3) -> List[Dict[str, Any]]:
         """The entries sharing the most words with the question (its words against each entry's question, tags and
@@ -161,6 +195,52 @@ class Knowledge:
         return [entry for _, _, entry in sorted(scored)[:limit]]
 
 
+class KnowledgeSource:
+    """The knowledge file as a declared source (the channel-agent standard's 7.1 and 7.4, FAA-197): read again when the
+    file changes, the last good version kept when a read fails (`degraded` until a good one), and `stale` past
+    `max_age_s`. The age is the last good version's: from its file's modification time, so a file nobody rebuilt ages
+    however often it is looked at, and a restart does not make old content new. The calling service shows `state()`
+    and opens one alert when it is stale."""
+
+    def __init__(self, path: Path, *, max_age_s: int, clock: Callable[[], float] = time.time):
+        if isinstance(max_age_s, bool) or not isinstance(max_age_s, int) or max_age_s < 1:
+            raise RecipeError("max_age_s is a whole number of seconds, at least 1")
+        self.path, self.max_age_s, self._clock = Path(path), max_age_s, clock
+        self._knowledge: Optional[Knowledge] = None
+        self._good_mtime = 0.0
+        self._seen: Optional[Tuple[int, int, int, int]] = None
+        self._degraded = False
+
+    def current(self) -> Knowledge:
+        try:  # the time, the size, the inode and the status-change time, which no copy or `touch -r` can set back: a
+            # rewrite in one coarse tick, a copy that kept the time, or (on POSIX with fine timestamps) one in place
+            # with the same size still shows; on Windows st_ctime is the creation time and catches no such rewrite
+            stat = self.path.stat()
+            seen: Optional[Tuple[int, int, int, int]] = (stat.st_mtime_ns, stat.st_size, stat.st_ino, stat.st_ctime_ns)
+        except OSError:
+            seen = None
+        if self._knowledge is not None and seen is not None and seen == self._seen:
+            return self._knowledge  # unchanged since this version was read (or failed to read)
+        try:
+            knowledge = Knowledge.load(self.path)
+        except (OSError, ValueError, RecursionError, RecipeError) as err:  # RecursionError: JSON nested too deep
+            if self._knowledge is None:
+                if isinstance(err, RecipeError):  # read, and refused: its message names the entry (ids are safe text)
+                    raise
+                raise RecipeError("the knowledge file %s could not be read (%s)" % (self.path.name,
+                                                                                   err.__class__.__name__))
+            self._seen, self._degraded = seen, True
+        else:
+            self._knowledge, self._seen, self._degraded = knowledge, seen, False
+            self._good_mtime = seen[0] / 1e9 if seen is not None else self._clock()
+        return self._knowledge
+
+    def state(self) -> Dict[str, Any]:
+        age = max(0, int(self._clock() - self._good_mtime)) if self._knowledge is not None else None
+        return {"id": "knowledge", "age_s": age, "max_age_s": self.max_age_s,
+                "stale": age is None or age > self.max_age_s, "degraded": self._degraded}
+
+
 def _currency(unit: str) -> str:
     unit = unit.lower()
     return "rub" if unit.startswith("руб") else _CURRENCY.get(unit, unit)
@@ -241,6 +321,22 @@ SYSTEM = (
 )
 
 
+#: The channel-agent standard's 4.4 (FAA-197): a draft the checks refused is rewritten once with the refusal's reason.
+REPAIR_NOTE = ("Your reply was refused by the checks: {reasons}. Write it again from the same entries only, keeping "
+               "every rule above, or answer exactly HANDOFF.")
+
+
+def repairable(decision: Any) -> bool:
+    """A hand-off the code checks made, with the draft they refused: no-knowledge, model-unsure and model:* are not."""
+    if not isinstance(decision, Mapping) or decision.get("action", "handoff") != "handoff" or decision.get("fallback"):
+        return False  # a fallback already had its one repair
+    reasons = decision.get("reasons")
+    draft = decision.get("draft")
+    return (isinstance(draft, str) and bool(draft.strip()) and isinstance(reasons, list) and bool(reasons)
+            and all(isinstance(r, str) and r != "no-knowledge" and r != "model-unsure" and not r.startswith("model:")
+                    for r in reasons))
+
+
 def entry_text(entry: Mapping[str, Any]) -> str:
     return "\n".join([str(entry.get("question", "")), str(entry["answer"]), " ".join(map(str, entry.get("tags", [])))])
 
@@ -357,7 +453,7 @@ def prune(state_dir: Path, keep_days: int, *, now: Optional[datetime] = None) ->
 
 
 class SupportAgent:
-    def __init__(self, *, knowledge: Knowledge, client: Any, model: str, fallback: str, state_dir: Path,
+    def __init__(self, *, knowledge: Union[Knowledge, "KnowledgeSource"], client: Any, model: str, fallback: str, state_dir: Path,
                  max_tokens: int = 600, max_chars: int = 1200, lookup_limit: int = 3,
                  on_handoff: Optional[Callable[[Dict[str, Any]], None]] = None):
         self.knowledge, self.client = knowledge, client
@@ -395,7 +491,8 @@ class SupportAgent:
     def _outbox(self, decision: Dict[str, Any]) -> None:
         # The outbox keeps the customer's own text until it is pruned: see `prune` and the README's retention note.
         fabric_paths.ensure_private_dir(self.state_dir)
-        line = json.dumps(decision, ensure_ascii=False, separators=(",", ":")) + "\n"
+        kept = {k: v for k, v in decision.items() if k != "draft"}  # a person reads the question and the reasons
+        line = json.dumps(kept, ensure_ascii=False, separators=(",", ":")) + "\n"
         _append_line(self.state_dir / "handoffs.jsonl", line.encode("utf-8"))
 
     def prune(self, keep_days: int, *, now: Optional[datetime] = None) -> Dict[str, int]:
@@ -405,12 +502,22 @@ class SupportAgent:
             self._log = DecisionLog(self.state_dir)
         return removed
 
-    def answer(self, message_id: str, text: str, *, task_run_id: Optional[str] = None) -> Dict[str, Any]:
-        """The decision for one message: `{messageId, action: reply|handoff, reply?, citations, reasons, costUsd}`."""
+    def answer(self, message_id: str, text: str, *, task_run_id: Optional[str] = None,
+               repair: Optional[Mapping[str, Any]] = None) -> Dict[str, Any]:
+        """The decision for one message: `{messageId, action: reply|handoff, reply?, citations, reasons, costUsd}`; a
+        hand-off the checks made also carries the refused `draft`. `repair=` that decision (under a new message id)
+        rewrites the draft once with the refusal's reasons: a pass is a reply with `repaired: true`, and a repair that
+        does not end in a reply (a second refusal, a model `HANDOFF`, no knowledge on the retry; not a `model:*`
+        outage) a hand-off with `fallback: true` (the channel-agent standard's 4.4 and 13.2, FAA-197)."""
         if not isinstance(message_id, str) or not _ID.fullmatch(message_id):
             raise RecipeError("message id: letters, digits, '.', '_', ':' or '-', up to 128")
         if not isinstance(text, str) or not text.strip():
             raise RecipeError("the message has no text")
+        if repair is not None and not repairable(repair):
+            raise RecipeError("repair= takes a hand-off the checks made, with its draft and reasons: the first call's "
+                              "decision or the on_handoff copy (a repeat returns no draft, and a fallback had its repair)")
+        if repair is not None and repair.get("messageId") == message_id:
+            raise RecipeError("repair= runs under a new message id: the refused one returns its stored decision")
         if getattr(self._local, "in_handoff", False):
             raise ReentryError("answer() was called from on_handoff: queue the hand-off and call answer() again after "
                               "this call returns")
@@ -419,7 +526,7 @@ class SupportAgent:
             done = self._log.get(message_id)
             if done is not None:
                 return dict(done, repeated=True)
-            decision = self._decide(message_id, text, task_run_id)
+            decision = self._decide(message_id, text, task_run_id, repair)
             at = _now()
             if decision["action"] == "handoff":  # before the decision is saved: a crash repeats a handoff, never loses one
                 self._local.in_handoff = True
@@ -427,27 +534,38 @@ class SupportAgent:
                     self.on_handoff(dict(decision, question=text, at=_stamp(at)))
                 finally:
                     self._local.in_handoff = False
-            self._log.append(decision, at)
+            self._log.append({k: v for k, v in decision.items() if k != "draft"}, at)  # the draft is never stored
         return dict(decision, repeated=False)
 
-    def _decide(self, message_id: str, text: str, task_run_id: Optional[str]) -> Dict[str, Any]:
+    def _decide(self, message_id: str, text: str, task_run_id: Optional[str],
+                repair: Optional[Mapping[str, Any]] = None) -> Dict[str, Any]:
         base = {"messageId": message_id, "citations": [], "costUsd": None}
-        entries = self.knowledge.lookup(text, self.lookup_limit)
+        knowledge = self.knowledge.current() if isinstance(self.knowledge, KnowledgeSource) else self.knowledge
+        entries = knowledge.lookup(text, self.lookup_limit)
         if not entries:
-            return dict(base, action="handoff", reasons=["no-knowledge"])
+            gone = dict(base, action="handoff", reasons=["no-knowledge"])
+            return dict(gone, fallback=True) if repair is not None else gone
+        messages = build_messages(text, entries)
+        if repair is not None:
+            messages += [{"role": "assistant", "content": repair["draft"]},
+                         {"role": "user", "content": REPAIR_NOTE.format(reasons=", ".join(repair["reasons"]))}]
         try:
-            got = self.client.chat(build_messages(text, entries), model=self.model, fallback=self.fallback,
+            got = self.client.chat(messages, model=self.model, fallback=self.fallback,
                                    max_tokens=self.max_tokens, temperature=0, task_run_id=task_run_id)
         except fabric_openrouter.OpenRouterError as err:
             return dict(base, action="handoff", reasons=["model:" + err.kind])
         base["costUsd"] = got["receipt"].get("costUsd")
         if got["content"].strip() == "HANDOFF":
-            return dict(base, action="handoff", reasons=["model-unsure"])
+            unsure = dict(base, action="handoff", reasons=["model-unsure"])
+            return dict(unsure, fallback=True) if repair is not None else unsure  # the repair was spent
         checked = check_reply(got["content"], text, [e["id"] for e in entries], max_chars=self.max_chars,
                               sources={e["id"]: entry_text(e) for e in entries})
         if not checked["ok"]:
-            return dict(base, action="handoff", reasons=checked["problems"], citations=checked["citations"])
-        return dict(base, action="reply", reply=checked["reply"], citations=checked["citations"], reasons=[])
+            refused = dict(base, action="handoff", reasons=checked["problems"], citations=checked["citations"],
+                           draft=got["content"])
+            return dict(refused, fallback=True) if repair is not None else refused
+        replied = dict(base, action="reply", reply=checked["reply"], citations=checked["citations"], reasons=[])
+        return dict(replied, repaired=True) if repair is not None else replied
 
 
 def from_config(config_path: Path, *, on_handoff: Optional[Callable[[Dict[str, Any]], None]] = None,
@@ -467,7 +585,13 @@ def from_config(config_path: Path, *, on_handoff: Optional[Callable[[Dict[str, A
                                       ledger=fabric_usage.JsonlUsageLedger(state / "usage.jsonl"), prices=prices,
                                       key_env=config.get("keyEnv", "OPENROUTER_API_KEY"),
                                       project_id=config.get("projectId"), **overrides)
-    return SupportAgent(knowledge=Knowledge.load(home / config["knowledge"]), client=client, model=config["model"],
+    knowledge: Union[Knowledge, KnowledgeSource]
+    if config.get("knowledgeMaxAgeSeconds") is not None:  # the file as a source with an age (FAA-197)
+        knowledge = KnowledgeSource(home / config["knowledge"], max_age_s=config["knowledgeMaxAgeSeconds"])
+        knowledge.current()  # read once, now: a bad file fails here as a RecipeError
+    else:
+        knowledge = Knowledge.load(home / config["knowledge"])
+    return SupportAgent(knowledge=knowledge, client=client, model=config["model"],
                         fallback=config["fallback"], state_dir=state, max_tokens=int(config.get("maxTokens", 600)),
                         max_chars=int(config.get("maxChars", 1200)), on_handoff=on_handoff)
 

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

@@ -141,8 +141,8 @@ key, the partner and the organization contexts, and `placement_trust` / `placeme
 one of those contexts and to no other (FAC-SEM-122, [the estate record reference](estate-record.md)). The partner's own
 agents call the company's agents with the partner innermost in the delegation chain ([delegation](delegation.md)).
 
-Still to come, each waiting on its owner: a partner's own space in a catalog and publishing to it (FAA-44, Vesta
-PA-03).
+Still to come, each waiting on its owner: a partner's own space in a catalog and publishing to it (FAA-44, the organization
+edition's PA-03).
 
 ## What this version does not do
 

package/plugins/fabric-agent-adapter/skills/building-fabric-services/scripts/dashboard_kit.py

@@ -395,6 +395,8 @@ def notice() -> int:
     nothing else, when it owns none; every git call and the tree walk share NOTICE_BUDGET_S, and a notice that runs
     out of it says nothing rather than a half-measured line (FAA-69)."""
     until = time.monotonic() + NOTICE_BUDGET_S
+    if re.fullmatch(r"wf_[0-9a-f]{16}", os.environ.get("FABRIC_DISPATCH_WORKFLOW") or ""):
+        return 0  # a session started on a board request does that request only (FAA-201): no invitation to upgrade
     try:
         stdin_text = "" if sys.stdin is None or sys.stdin.isatty() else sys.stdin.read(65536)
         root = repo_root(hook_cwd(stdin_text), until=until)

package/plugins/fabric-agent-adapter/skills/building-fabric-services/scripts/fabric_auth.py

@@ -15,7 +15,7 @@ import threading
 import time
 import urllib.parse
 from pathlib import Path
-from typing import Any, Callable, Dict, List, Optional, Tuple
+from typing import Any, Callable, Dict, List, Optional, Tuple, Union
 
 import sys as _sys  # noqa: E402
 from pathlib import Path as _Path  # noqa: E402
@@ -136,7 +136,7 @@ class LoginCodes:
 
     def __init__(self, state_dir: Optional[Path], ttl: int = LOGIN_CODE_TTL_SECONDS, *,
                  store: Optional["MemoryCodeStore"] = None, key: Optional[bytes] = None,
-                 token: "Optional[str | Callable[[], str]]" = None,
+                 token: "Optional[Union[str, Callable[[], str]]]" = None,
                  idle_seconds: int = OPERATOR_SESSION_IDLE_SECONDS,
                  max_seconds: int = OPERATOR_SESSION_MAX_SECONDS,
                  clock: Callable[[], float] = time.time):

package/plugins/fabric-agent-adapter/skills/building-fabric-services/scripts/fabric_estate.py

@@ -32,7 +32,7 @@ import math
 import re
 import sys
 from pathlib import Path
-from typing import Any, Dict, List
+from typing import Any, Dict, List, Optional
 
 sys.path.insert(0, str(Path(__file__).resolve().parent))
 from fabric_crypto import ed25519_verify, is_small_order_key  # noqa: E402,F401 - beside this file (FAA-65)

package/plugins/fabric-agent-adapter/skills/building-fabric-services/scripts/kit.json

@@ -1,6 +1,6 @@
 {
  "name": "fabric-service-kit",
- "version": "0.62.0",
+ "version": "0.64.0",
  "about": "The service kit's modules in dependency order: a module imports only modules listed before it. Written by fabric_kit.py build; edit the order and layers by hand, never the digests.",
  "python": [
   {
@@ -89,7 +89,7 @@
     "fabric_jsvalue",
     "fabric_time"
    ],
-   "sha256": "b3cd56dcb86e04d252980322ac8054da1aaef24ac64690f7aa80e7c765ee6f60"
+   "sha256": "0737ae1d1bb12586bae49de1f15ef1348bc207b5007cced9dad4c55bb5870874"
   },
   {
    "module": "fabric_mandate",
@@ -297,7 +297,7 @@
     "fabric_paths",
     "fabric_platform"
    ],
-   "sha256": "a7028fa6f8b1c24bc9e2c89adbce8ecb0ae01579d27b1ec4f625ae635e3f17b9"
+   "sha256": "74ccc10239b65a3567cec5213a7b344cbd88d6eee1fd1c5f7be1d6daf985993c"
   },
   {
    "module": "fabric_events",
@@ -4776,6 +4776,186 @@
    "fabric-openrouter.mjs": "6041f3ab30f516658e1dbab4897a651cc8509b2136cfa8e769802c6b40ec2f35",
    "fabric-package.schema.json": "2ba799f576fad0f608029223c4ccccd122152f1c5dbfa8ce8b31cd63ac92ad44",
    "share-registration.schema.json": "34b3997eeaf936ebc861342a23045634a7c18c19f01d7ed4198310d81989f5b0"
+  },
+  "0.63.0": {
+   "fabric_jsvalue.py": "052f1b40bab18600b3731dbdca27cbff17588c21d9458fa6241efd1340d0e09a",
+   "fabric_time.py": "588f383da4ac6a243ea95b6ffc3a0aa99ca94245732dc4937734f190b7af4ae9",
+   "fabric_identifiers.py": "0fd814d521ac3aa39907458265870753046a73f48af3d8581ab864b93b211607",
+   "fabric_secrets.py": "3939aa8658a92ca387e9f0259538c4849fc407e429355ef9b4829460107a8597",
+   "fabric_crypto.py": "9c34aee20dbe4d6742e4fdbaab68ceb934bbe7dbd3a904c0010824ace16cdeaa",
+   "fabric_base.py": "f62bcc2ed9912660fa875d27a09f60867260cc4925f79873501fd9620be59611",
+   "fabric_platform.py": "a9350dff55ef0fb3a23cdb4d0320a15868b15a8deb10d2eb74d72c58740c284b",
+   "fabric_paths.py": "8a1ee742f80f436e9f28c61b4f049a9545de2a9e0d66bfc61faa6ee5d1ba3734",
+   "fabric_estate_rules.py": "8b36a7f4108d9c2b1fb38c8bff344778c807bed631a99b4a563ecb0a49c10b1c",
+   "fabric_estate.py": "0737ae1d1bb12586bae49de1f15ef1348bc207b5007cced9dad4c55bb5870874",
+   "fabric_mandate.py": "fb19ce5359606bd6e3352ab02b2a12f49605ec6e5c49b55cce1f79c831325044",
+   "fabric_delegation.py": "716f0ff7ac01095f54b24970beac1962128e8ff33026b243fc0467876142ab03",
+   "fabric_share.py": "da36a466426fc29dd7dd40013167f3959a18375f8fedd228bf64f298cec1040c",
+   "fabric_ceremonies.py": "a59e83cf4adb2669a9b98008e3d3a0cba991a35cbff97bc604fc82fe81cfd49f",
+   "fabric_package_schema.py": "e623f0408d38e3343ed66222fb812907c6c52e1a286eb1c1176ab2e64640c9ad",
+   "fabric_package.py": "1f2b9e73b2b32a7e1e887d4b69f87c6e21b4d1227ad924a235334223e6dd51ca",
+   "fabric_protocols.py": "42529a7df4d753544d2e37a18ec81266d6e1e80477cb8558a3ab521416d45791",
+   "fabric_actions.py": "ae21d1199614c4f74d1dcd1e0a87107a9d52434cd9e2d64aa24a7b1e196fb723",
+   "fabric_connections.py": "7de55cb7d808f756d650effabfaa12027d40a5bd5d2f6d448c32969d47529ecb",
+   "fabric_a2a.py": "8b01502131215bb4de1c01866187c56e99b791543923ed8577535573db33b919",
+   "fabric_page_links.py": "1b57ea573c550e2f90d1ec3edcc655917ceaa0db9dd1635fccf422ec3024d25e",
+   "fabric_lock.py": "dfaf92a7086cbb097d832a305869b7964e2d2a9da0e3365c8ec1685a7bb4fef9",
+   "fabric_usage.py": "5cc2e03ccc5b06e81987ed7bc3eead7a7e6cbf1a7cb8e05c6c64315eed9d91b6",
+   "fabric_backups.py": "1f3f0d7ecf361b29e9101e07f1c53e5dc304d598bf26fd59ec89f16b9fed2420",
+   "fabric_descriptor.py": "0e7b44eef7983c2dffc433173c4e376facb181279d4bfdffa9ae8028216984c0",
+   "fabric_context.py": "6ae311ddc7217a4aff915e7ce2646486931acd128462b7bebe4a52bbb5fbb6c7",
+   "fabric_auth.py": "74ccc10239b65a3567cec5213a7b344cbd88d6eee1fd1c5f7be1d6daf985993c",
+   "fabric_events.py": "cd94b186e2a8f8cb4ad2b6bd44d83ec5021933075e28c5d655f387f16dff42b8",
+   "fabric_logs.py": "86dc55bfafa2a57264722e2403510a249b95de0e4a722b2e4bc3948e3bd93da9",
+   "fabric_supervisors.py": "3c5b2e8c310738720b1c1b779be4710e90251013d9be4c68f9952edc0bf55d5f",
+   "fabric_service.py": "4b13f90aa26881fbfe0d9f3077fbb3552f3ce0a3c59279d6baa92df872867d8d",
+   "fabric_profiles.py": "26e21ec29c016000f8ca8053b7b489184854a73be1b7fdc0a18d12990203db9b",
+   "fabric_interop_rules.py": "9bdb7989e57b9d0b0d15eb9982d396499823a5e2c528230b71c67866c736e0f5",
+   "fabric_interop.py": "d27e31834611a37cf2a117746f2f60fc187ccc48718eb546ff923c5d0fce7dea",
+   "fabric_hub.py": "b9ac852e601b1d54cf61351677a628afc69faeed7d1fc74ebe541c1cf38e0c2a",
+   "fabric_board_shapes.py": "0a0e8d3d40e33dfd8c457aedb85330b2ff25f8c49a33eb6cbd5a5cc8a5007f7e",
+   "fabric_board_link.py": "052bc3c474ece835bb428c37ca864810d04e394d991ddb9c93989a7a825073a5",
+   "fabric_board_slots.py": "92b065e3df935547cf46653245f1129e4a1f8b59b0a41e8fa9ffdc41596ee592",
+   "fabric_board_session.py": "1fd3c3884f3044b56a40f78b33ff88dcac9272284f6681ea359c662879826f7e",
+   "fabric_board_fixture.py": "69761ce205ec640762ec9b591c6903e5a87f844e8d423b041681924027e39d1e",
+   "fabric_board.py": "f86c40b8291f8c818f6924910f4022b013d5fd107abaf8825dd0aa6c5e418638",
+   "fabric_http.py": "861e8e0978e303455dd6ff4a1b98a8b258600320f2870af0644384196fb03679",
+   "fabric_openrouter.py": "d06a40f83f2fb8bd441ab3485ae882f1fbdd9cd7a9c1ec175eb47cb8ae2cce81",
+   "fabric-jsvalue.mjs": "dfbdb8c41584972c9389750a41719374a1cfc5652ed438dd1623025190b0106e",
+   "fabric-time.mjs": "3ff932069038a720df1c68c6492976906737b2e67e5c12d9c81c418597f661de",
+   "fabric-identifiers.mjs": "a18c2a501a4aa170bfd3d99e571ad6b7662649b4d3b9d2a540c002ea42811bbf",
+   "fabric-secrets.mjs": "5822a7e25ecf2e87b5bab4f99c1074af7379d8b49e2784283b5d7d8c25022cde",
+   "fabric-crypto.mjs": "038e03689701e3c9721a1e7f8e0a4d02a52d6a5d1661b0dc84035edc3ebbfcf6",
+   "fabric-base.mjs": "7804b2df7715dbbf9702a9b61b6b8cef2110f9a52b04cabd8fb0a66458d87512",
+   "fabric-platform.mjs": "a8119d95ebba4d589a9e401f5d6fc8dda62d59d44e4c1ff811d97fac3771ac0c",
+   "fabric-paths.mjs": "aa630d611e748a899e7043480f4a4e46b444f2e15ff945f30c2fbef21c1ceea5",
+   "fabric-estate-rules.mjs": "7476be71174aa5b1026134f2b335abf647feaa55584e2f9de8618e3054aa8e1e",
+   "fabric-estate.mjs": "e8a2e62d2313121e6cb502f6e6abad94d1d546a44b4d9b3ce2be29e7808e8cf3",
+   "fabric-mandate.mjs": "b70f3de03a659e60bba7b5a0580b3582825cd7b8a8e30a28c79621919ec5b7bb",
+   "fabric-delegation.mjs": "f1b6d156d050f8ceb9a21daaad8d39ab5de5d32e4cfe03817909388fca8ad27e",
+   "fabric-share.mjs": "bfb26581c21ad984c2a337da02429f9f3a165cc582f8ba48de4d3dfb7d163a59",
+   "fabric-ceremonies.mjs": "117d4374c9e95c930a38de7adbd4323774798f4fe6ec6f24afcd6f2c7298ca44",
+   "fabric-package-schema.mjs": "cd28092375db0fc21ffab1f0bb7794f7f8979ee08c64d3b9faf4b3845357caa6",
+   "fabric-package.mjs": "8cfb32eebbd4e1bcf28a6e4437344ae2dd54479b0e7c820f002e9f94ab9ecaad",
+   "fabric-protocols.mjs": "5fd8765fdd3e507cc85c108492682bf5cbb4ae08873245c50374fb01d33c75e4",
+   "fabric-actions.mjs": "06e42f5e24c96311d5417d0d1effa93479ef7128a7ab139903b2bcf59253f6be",
+   "fabric-connections.mjs": "303432e547ce563e90ca9ffcd827f5612f51d3582929834e1add0fdaf6485dcc",
+   "fabric-a2a.mjs": "51b72fe1d80649d659fcad3a8f96370db3476c4a7b30cbabd8522c138be69346",
+   "fabric-page-links.mjs": "a8834926e9d4bbf7c4857f551451d2ebf6ac8873bbccaaf89c5e30cf45b17ee6",
+   "fabric-lock.mjs": "02cf833c97a07a8b3c788f9c93f70c4b9c9066efa25318dccf0038e0fc79717f",
+   "fabric-usage.mjs": "1c4d18004639409624ac3516a02f2b60bbf55abdb612e9a96c37e83666eb87a7",
+   "fabric-backups.mjs": "cfd8c9085e3d597a783099c2bd2ffe2f3faa0daaadab46dedd30523894cfeb06",
+   "fabric-descriptor.mjs": "7c0ef7d245c037eb9e859ab481f6e66fb3e5ef2cf6d1e0a8d32b6d303097ca43",
+   "fabric-context.mjs": "1112d695e872f9825cbc94f08484974bff3880087bc29b8be59f885f03e8f7be",
+   "fabric-auth.mjs": "10ff37a39f9e3adb4d0f05db66c45f49b10eef582e9220c213907964109d7e52",
+   "fabric-events.mjs": "c463d6ffcae24229a5c608d8fcea4268d2ccc5024b19fa10e5a452284068fa71",
+   "fabric-logs.mjs": "58467e5719c16e099d05bbedec47a95712506ab03c33f3cd4be1252e8498a946",
+   "fabric-supervisors.mjs": "d45c38de0cb3ed85e083496c2d3c51dab004454accdd87f4762a512a6d442573",
+   "fabric-service.mjs": "297fef11ac76dc831d12d24c5581b7a93587c300c20664db703b3f924c0f9f1a",
+   "fabric-profiles.mjs": "314376cf2deb87f235fb18b11d3b532e211f585b9af0a9302b5f4cc39971b532",
+   "fabric-interop-rules.mjs": "b4e386c359a48e49ffff8a842215760c18a7c98a0af4754a808a35fb2820d458",
+   "fabric-interop.mjs": "989040aed33b2712a258244192bdf70e811a51076aa1b62f2adc2a6db051dbed",
+   "fabric-hub.mjs": "c005115a864cfd67daa4862097bb14acfe5a60bf653897e5bf8a570dd80f1070",
+   "fabric-board-shapes.mjs": "c1db7b7bd0d58d82bb6d8dfbc3cd1547a256a333052d367e82ff1b3edf2804d7",
+   "fabric-board-link.mjs": "6e7d51f4fd9730d93455f50dd30e97907b8b9e1ca65a1d69f036f2e8ec05cc0d",
+   "fabric-board-slots.mjs": "fc77a3c6e62aa18575568bef4f703cce2edaba8cef648813ebcdbb21bdc27a11",
+   "fabric-board-session.mjs": "18555962e5f6d18080a3e7971c4c6640452542f6042d07917e7ebc073721c415",
+   "fabric-board-fixture.mjs": "83c4b7e33ee47b68385faf2569d38d5c8a0c5cb0f8656090f41e1b0eed2f436e",
+   "fabric-board.mjs": "15fbb4441fcf7d2f285375b75de64ad6cffea129c515084c110245376b07775f",
+   "fabric-http.mjs": "96aa1730c79cb9a68dcc94642513eb1e88f0c2d99a45ca505c042e8c601d0436",
+   "fabric-openrouter.mjs": "6041f3ab30f516658e1dbab4897a651cc8509b2136cfa8e769802c6b40ec2f35",
+   "fabric-package.schema.json": "2ba799f576fad0f608029223c4ccccd122152f1c5dbfa8ce8b31cd63ac92ad44",
+   "share-registration.schema.json": "34b3997eeaf936ebc861342a23045634a7c18c19f01d7ed4198310d81989f5b0"
+  },
+  "0.64.0": {
+   "fabric_jsvalue.py": "052f1b40bab18600b3731dbdca27cbff17588c21d9458fa6241efd1340d0e09a",
+   "fabric_time.py": "588f383da4ac6a243ea95b6ffc3a0aa99ca94245732dc4937734f190b7af4ae9",
+   "fabric_identifiers.py": "0fd814d521ac3aa39907458265870753046a73f48af3d8581ab864b93b211607",
+   "fabric_secrets.py": "3939aa8658a92ca387e9f0259538c4849fc407e429355ef9b4829460107a8597",
+   "fabric_crypto.py": "9c34aee20dbe4d6742e4fdbaab68ceb934bbe7dbd3a904c0010824ace16cdeaa",
+   "fabric_base.py": "f62bcc2ed9912660fa875d27a09f60867260cc4925f79873501fd9620be59611",
+   "fabric_platform.py": "a9350dff55ef0fb3a23cdb4d0320a15868b15a8deb10d2eb74d72c58740c284b",
+   "fabric_paths.py": "8a1ee742f80f436e9f28c61b4f049a9545de2a9e0d66bfc61faa6ee5d1ba3734",
+   "fabric_estate_rules.py": "8b36a7f4108d9c2b1fb38c8bff344778c807bed631a99b4a563ecb0a49c10b1c",
+   "fabric_estate.py": "0737ae1d1bb12586bae49de1f15ef1348bc207b5007cced9dad4c55bb5870874",
+   "fabric_mandate.py": "fb19ce5359606bd6e3352ab02b2a12f49605ec6e5c49b55cce1f79c831325044",
+   "fabric_delegation.py": "716f0ff7ac01095f54b24970beac1962128e8ff33026b243fc0467876142ab03",
+   "fabric_share.py": "da36a466426fc29dd7dd40013167f3959a18375f8fedd228bf64f298cec1040c",
+   "fabric_ceremonies.py": "a59e83cf4adb2669a9b98008e3d3a0cba991a35cbff97bc604fc82fe81cfd49f",
+   "fabric_package_schema.py": "e623f0408d38e3343ed66222fb812907c6c52e1a286eb1c1176ab2e64640c9ad",
+   "fabric_package.py": "1f2b9e73b2b32a7e1e887d4b69f87c6e21b4d1227ad924a235334223e6dd51ca",
+   "fabric_protocols.py": "42529a7df4d753544d2e37a18ec81266d6e1e80477cb8558a3ab521416d45791",
+   "fabric_actions.py": "ae21d1199614c4f74d1dcd1e0a87107a9d52434cd9e2d64aa24a7b1e196fb723",
+   "fabric_connections.py": "7de55cb7d808f756d650effabfaa12027d40a5bd5d2f6d448c32969d47529ecb",
+   "fabric_a2a.py": "8b01502131215bb4de1c01866187c56e99b791543923ed8577535573db33b919",
+   "fabric_page_links.py": "1b57ea573c550e2f90d1ec3edcc655917ceaa0db9dd1635fccf422ec3024d25e",
+   "fabric_lock.py": "dfaf92a7086cbb097d832a305869b7964e2d2a9da0e3365c8ec1685a7bb4fef9",
+   "fabric_usage.py": "5cc2e03ccc5b06e81987ed7bc3eead7a7e6cbf1a7cb8e05c6c64315eed9d91b6",
+   "fabric_backups.py": "1f3f0d7ecf361b29e9101e07f1c53e5dc304d598bf26fd59ec89f16b9fed2420",
+   "fabric_descriptor.py": "0e7b44eef7983c2dffc433173c4e376facb181279d4bfdffa9ae8028216984c0",
+   "fabric_context.py": "6ae311ddc7217a4aff915e7ce2646486931acd128462b7bebe4a52bbb5fbb6c7",
+   "fabric_auth.py": "74ccc10239b65a3567cec5213a7b344cbd88d6eee1fd1c5f7be1d6daf985993c",
+   "fabric_events.py": "cd94b186e2a8f8cb4ad2b6bd44d83ec5021933075e28c5d655f387f16dff42b8",
+   "fabric_logs.py": "86dc55bfafa2a57264722e2403510a249b95de0e4a722b2e4bc3948e3bd93da9",
+   "fabric_supervisors.py": "3c5b2e8c310738720b1c1b779be4710e90251013d9be4c68f9952edc0bf55d5f",
+   "fabric_service.py": "4b13f90aa26881fbfe0d9f3077fbb3552f3ce0a3c59279d6baa92df872867d8d",
+   "fabric_profiles.py": "26e21ec29c016000f8ca8053b7b489184854a73be1b7fdc0a18d12990203db9b",
+   "fabric_interop_rules.py": "9bdb7989e57b9d0b0d15eb9982d396499823a5e2c528230b71c67866c736e0f5",
+   "fabric_interop.py": "d27e31834611a37cf2a117746f2f60fc187ccc48718eb546ff923c5d0fce7dea",
+   "fabric_hub.py": "b9ac852e601b1d54cf61351677a628afc69faeed7d1fc74ebe541c1cf38e0c2a",
+   "fabric_board_shapes.py": "0a0e8d3d40e33dfd8c457aedb85330b2ff25f8c49a33eb6cbd5a5cc8a5007f7e",
+   "fabric_board_link.py": "052bc3c474ece835bb428c37ca864810d04e394d991ddb9c93989a7a825073a5",
+   "fabric_board_slots.py": "92b065e3df935547cf46653245f1129e4a1f8b59b0a41e8fa9ffdc41596ee592",
+   "fabric_board_session.py": "1fd3c3884f3044b56a40f78b33ff88dcac9272284f6681ea359c662879826f7e",
+   "fabric_board_fixture.py": "69761ce205ec640762ec9b591c6903e5a87f844e8d423b041681924027e39d1e",
+   "fabric_board.py": "f86c40b8291f8c818f6924910f4022b013d5fd107abaf8825dd0aa6c5e418638",
+   "fabric_http.py": "861e8e0978e303455dd6ff4a1b98a8b258600320f2870af0644384196fb03679",
+   "fabric_openrouter.py": "d06a40f83f2fb8bd441ab3485ae882f1fbdd9cd7a9c1ec175eb47cb8ae2cce81",
+   "fabric-jsvalue.mjs": "dfbdb8c41584972c9389750a41719374a1cfc5652ed438dd1623025190b0106e",
+   "fabric-time.mjs": "3ff932069038a720df1c68c6492976906737b2e67e5c12d9c81c418597f661de",
+   "fabric-identifiers.mjs": "a18c2a501a4aa170bfd3d99e571ad6b7662649b4d3b9d2a540c002ea42811bbf",
+   "fabric-secrets.mjs": "5822a7e25ecf2e87b5bab4f99c1074af7379d8b49e2784283b5d7d8c25022cde",
+   "fabric-crypto.mjs": "038e03689701e3c9721a1e7f8e0a4d02a52d6a5d1661b0dc84035edc3ebbfcf6",
+   "fabric-base.mjs": "7804b2df7715dbbf9702a9b61b6b8cef2110f9a52b04cabd8fb0a66458d87512",
+   "fabric-platform.mjs": "a8119d95ebba4d589a9e401f5d6fc8dda62d59d44e4c1ff811d97fac3771ac0c",
+   "fabric-paths.mjs": "aa630d611e748a899e7043480f4a4e46b444f2e15ff945f30c2fbef21c1ceea5",
+   "fabric-estate-rules.mjs": "7476be71174aa5b1026134f2b335abf647feaa55584e2f9de8618e3054aa8e1e",
+   "fabric-estate.mjs": "e8a2e62d2313121e6cb502f6e6abad94d1d546a44b4d9b3ce2be29e7808e8cf3",
+   "fabric-mandate.mjs": "b70f3de03a659e60bba7b5a0580b3582825cd7b8a8e30a28c79621919ec5b7bb",
+   "fabric-delegation.mjs": "f1b6d156d050f8ceb9a21daaad8d39ab5de5d32e4cfe03817909388fca8ad27e",
+   "fabric-share.mjs": "bfb26581c21ad984c2a337da02429f9f3a165cc582f8ba48de4d3dfb7d163a59",
+   "fabric-ceremonies.mjs": "117d4374c9e95c930a38de7adbd4323774798f4fe6ec6f24afcd6f2c7298ca44",
+   "fabric-package-schema.mjs": "cd28092375db0fc21ffab1f0bb7794f7f8979ee08c64d3b9faf4b3845357caa6",
+   "fabric-package.mjs": "8cfb32eebbd4e1bcf28a6e4437344ae2dd54479b0e7c820f002e9f94ab9ecaad",
+   "fabric-protocols.mjs": "5fd8765fdd3e507cc85c108492682bf5cbb4ae08873245c50374fb01d33c75e4",
+   "fabric-actions.mjs": "06e42f5e24c96311d5417d0d1effa93479ef7128a7ab139903b2bcf59253f6be",
+   "fabric-connections.mjs": "303432e547ce563e90ca9ffcd827f5612f51d3582929834e1add0fdaf6485dcc",
+   "fabric-a2a.mjs": "51b72fe1d80649d659fcad3a8f96370db3476c4a7b30cbabd8522c138be69346",
+   "fabric-page-links.mjs": "a8834926e9d4bbf7c4857f551451d2ebf6ac8873bbccaaf89c5e30cf45b17ee6",
+   "fabric-lock.mjs": "02cf833c97a07a8b3c788f9c93f70c4b9c9066efa25318dccf0038e0fc79717f",
+   "fabric-usage.mjs": "1c4d18004639409624ac3516a02f2b60bbf55abdb612e9a96c37e83666eb87a7",
+   "fabric-backups.mjs": "cfd8c9085e3d597a783099c2bd2ffe2f3faa0daaadab46dedd30523894cfeb06",
+   "fabric-descriptor.mjs": "7c0ef7d245c037eb9e859ab481f6e66fb3e5ef2cf6d1e0a8d32b6d303097ca43",
+   "fabric-context.mjs": "1112d695e872f9825cbc94f08484974bff3880087bc29b8be59f885f03e8f7be",
+   "fabric-auth.mjs": "10ff37a39f9e3adb4d0f05db66c45f49b10eef582e9220c213907964109d7e52",
+   "fabric-events.mjs": "c463d6ffcae24229a5c608d8fcea4268d2ccc5024b19fa10e5a452284068fa71",
+   "fabric-logs.mjs": "58467e5719c16e099d05bbedec47a95712506ab03c33f3cd4be1252e8498a946",
+   "fabric-supervisors.mjs": "d45c38de0cb3ed85e083496c2d3c51dab004454accdd87f4762a512a6d442573",
+   "fabric-service.mjs": "297fef11ac76dc831d12d24c5581b7a93587c300c20664db703b3f924c0f9f1a",
+   "fabric-profiles.mjs": "314376cf2deb87f235fb18b11d3b532e211f585b9af0a9302b5f4cc39971b532",
+   "fabric-interop-rules.mjs": "b4e386c359a48e49ffff8a842215760c18a7c98a0af4754a808a35fb2820d458",
+   "fabric-interop.mjs": "989040aed33b2712a258244192bdf70e811a51076aa1b62f2adc2a6db051dbed",
+   "fabric-hub.mjs": "c005115a864cfd67daa4862097bb14acfe5a60bf653897e5bf8a570dd80f1070",
+   "fabric-board-shapes.mjs": "c1db7b7bd0d58d82bb6d8dfbc3cd1547a256a333052d367e82ff1b3edf2804d7",
+   "fabric-board-link.mjs": "6e7d51f4fd9730d93455f50dd30e97907b8b9e1ca65a1d69f036f2e8ec05cc0d",
+   "fabric-board-slots.mjs": "fc77a3c6e62aa18575568bef4f703cce2edaba8cef648813ebcdbb21bdc27a11",
+   "fabric-board-session.mjs": "18555962e5f6d18080a3e7971c4c6640452542f6042d07917e7ebc073721c415",
+   "fabric-board-fixture.mjs": "83c4b7e33ee47b68385faf2569d38d5c8a0c5cb0f8656090f41e1b0eed2f436e",
+   "fabric-board.mjs": "15fbb4441fcf7d2f285375b75de64ad6cffea129c515084c110245376b07775f",
+   "fabric-http.mjs": "96aa1730c79cb9a68dcc94642513eb1e88f0c2d99a45ca505c042e8c601d0436",
+   "fabric-openrouter.mjs": "6041f3ab30f516658e1dbab4897a651cc8509b2136cfa8e769802c6b40ec2f35",
+   "fabric-package.schema.json": "2ba799f576fad0f608029223c4ccccd122152f1c5dbfa8ce8b31cd63ac92ad44",
+   "share-registration.schema.json": "34b3997eeaf936ebc861342a23045634a7c18c19f01d7ed4198310d81989f5b0"
   }
  },
  "data": {

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.62.0"
+  version: "0.64.0"
   contract-version: "0.1.0"
   contract-commit: "3830a3353923e20f826d466610e1c479f120bec0"
 ---
@@ -91,7 +91,7 @@ prior art of its own:
 
 - [practices.md](references/practices.md): the rules production agents taught us, each with
   the check that catches it (judges and evals, numbers, money, people in the loop,
-  reliability, shipping). Organization members also read the knowledge base's
+  reliability, shipping, agents on a channel people write to). Organization members also read the knowledge base's
   `knowledge/agent-practices.md` and add to it what this agent learns.
 - [where-agents-run.md](references/where-agents-run.md): this machine, a personal cloud, an
   organization; contexts; connecting a machine; sharing into an organization; selling.
@@ -225,7 +225,8 @@ Before the first stage that calls a model or spends money, read
 a limit pauses and resumes, every model answer passes the call site's own acceptance, fallbacks
 and checkers cross vendors, spend is a persisted ledger with idempotency keys, open questions
 become recorded decisions, every fix has a test seen failing, and text a person reads carries no
-em dash (U+2014), held by its prompt and a test. Report its checklist with a
+em dash (U+2014), held by its prompt and a test; and each piece of work closes with a retro
+(`observatory_lesson` and insight/1 lines, practices.md *Reliability*). Report its checklist with a
 file and a test per line, or `NOT_RUN` where the agent has no such stage.
 
 ## Completion format

package/plugins/fabric-agent-adapter/skills/creating-fabric-agents/references/agents-that-answer-people.md

@@ -1,7 +1,8 @@
 # Agents that answer people: what they carry from the first release
 
 **Load this when the agent you are building answers people**: private chats, mail, store reviews, group chats, any
-channel where a person asks and the agent writes back. Every item below is a part of the agent, built and tested in its
+channel where a person asks and the agent writes back. An agent on such a channel also follows the channel-agent
+standard: [practices](practices.md#agents-on-a-channel-people-write-to). Every item below is a part of the agent, built and tested in its
 first release, not a later improvement. Each comes from the sources below: what the quality standard requires (A1,
 A5), and what an audit of five production agents found working or failing (P1 to P8). The practices are field
 evidence: one estate, five agents, no control; their numbers are that estate's, never a forecast.
@@ -18,7 +19,9 @@ per-channel targets, A3 (the rubric), A4 (the judge and its calibration), A6 (an
 default) and the rest of its checks that caught real defects, and the practices' other items of P1, P3, P5, P6, P7 and
 P8. Read both sources before you design the reply pipeline. The kit's support-agent recipe (building-fabric-services,
 `recipes/support-agent/`) is one draft-and-check step of such an agent, not the agent: used alone it hands the message
-to a person at the first refusal (the refused draft is not kept), where this page repairs, researches and holds.
+to a person at the first refusal; with a repairing `on_handoff` it rewrites a refused draft once (`repair=`, a
+spent repair being `fallback: true`: a second refusal, a declined repair or no knowledge on the retry; a `model:*`
+outage during the repair is a plain hand-off), and research and the hold stay this page's.
 
 ## Contents