npm - @sentropic/h2a - Versions diffs - 0.81.0 → 0.82.0 - Mend

@sentropic/h2a 0.81.0 → 0.82.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (82) hide show

package/README.md +5 -0
package/dist/bin-routing.d.ts +13 -0
package/dist/bin-routing.d.ts.map +1 -0
package/dist/bin-routing.js +46 -0
package/dist/bin-routing.js.map +1 -0
package/dist/bin.js +40 -11
package/dist/bin.js.map +1 -1
package/dist/cli-contract.d.ts.map +1 -1
package/dist/cli-contract.js +22 -6
package/dist/cli-contract.js.map +1 -1
package/dist/cli.d.ts +16 -0
package/dist/cli.d.ts.map +1 -1
package/dist/cli.js +197 -11
package/dist/cli.js.map +1 -1
package/dist/index.d.ts +1 -1
package/dist/mcp.d.ts +1 -1
package/dist/mcp.d.ts.map +1 -1
package/dist/mcp.js +3 -1
package/dist/mcp.js.map +1 -1
package/dist/runtime/canevas/adapter.d.ts +11 -0
package/dist/runtime/canevas/adapter.d.ts.map +1 -0
package/dist/runtime/canevas/adapter.js +22 -0
package/dist/runtime/canevas/adapter.js.map +1 -0
package/dist/runtime/canevas/aggregate.d.ts +56 -0
package/dist/runtime/canevas/aggregate.d.ts.map +1 -0
package/dist/runtime/canevas/aggregate.js +84 -0
package/dist/runtime/canevas/aggregate.js.map +1 -0
package/dist/runtime/canevas/answer.d.ts +21 -0
package/dist/runtime/canevas/answer.d.ts.map +1 -0
package/dist/runtime/canevas/answer.js +62 -0
package/dist/runtime/canevas/answer.js.map +1 -0
package/dist/runtime/canevas/app.d.ts +19 -0
package/dist/runtime/canevas/app.d.ts.map +1 -0
package/dist/runtime/canevas/app.js +49 -0
package/dist/runtime/canevas/app.js.map +1 -0
package/dist/runtime/canevas/gather.d.ts +3 -0
package/dist/runtime/canevas/gather.d.ts.map +1 -0
package/dist/runtime/canevas/gather.js +39 -0
package/dist/runtime/canevas/gather.js.map +1 -0
package/dist/runtime/canevas/reply.d.ts +27 -0
package/dist/runtime/canevas/reply.d.ts.map +1 -0
package/dist/runtime/canevas/reply.js +31 -0
package/dist/runtime/canevas/reply.js.map +1 -0
package/dist/runtime/canevas/serve.d.ts +11 -0
package/dist/runtime/canevas/serve.d.ts.map +1 -0
package/dist/runtime/canevas/serve.js +42 -0
package/dist/runtime/canevas/serve.js.map +1 -0
package/dist/runtime/canevas/ui.d.ts +2 -0
package/dist/runtime/canevas/ui.d.ts.map +1 -0
package/dist/runtime/canevas/ui.js +124 -0
package/dist/runtime/canevas/ui.js.map +1 -0
package/dist/runtime/loop/engine/adapters.d.ts +91 -0
package/dist/runtime/loop/engine/adapters.d.ts.map +1 -0
package/dist/runtime/loop/engine/adapters.js +292 -0
package/dist/runtime/loop/engine/adapters.js.map +1 -0
package/dist/runtime/loop/engine/decision.d.ts +71 -0
package/dist/runtime/loop/engine/decision.d.ts.map +1 -0
package/dist/runtime/loop/engine/decision.js +141 -0
package/dist/runtime/loop/engine/decision.js.map +1 -0
package/dist/runtime/loop/engine/execute.d.ts +33 -0
package/dist/runtime/loop/engine/execute.d.ts.map +1 -0
package/dist/runtime/loop/engine/execute.js +69 -0
package/dist/runtime/loop/engine/execute.js.map +1 -0
package/dist/runtime/loop/engine/tick.d.ts +27 -0
package/dist/runtime/loop/engine/tick.d.ts.map +1 -0
package/dist/runtime/loop/engine/tick.js +72 -0
package/dist/runtime/loop/engine/tick.js.map +1 -0
package/dist/runtime/loop/index.d.ts +14 -0
package/dist/runtime/loop/index.d.ts.map +1 -1
package/dist/runtime/loop/index.js +23 -0
package/dist/runtime/loop/index.js.map +1 -1
package/dist/runtime/mcp/handlers.d.ts +12 -0
package/dist/runtime/mcp/handlers.d.ts.map +1 -1
package/dist/runtime/mcp/handlers.js +42 -0
package/dist/runtime/mcp/handlers.js.map +1 -1
package/dist/runtime/mcp/server.d.ts.map +1 -1
package/dist/runtime/mcp/server.js +5 -1
package/dist/runtime/mcp/server.js.map +1 -1
package/dist/runtime/mcp/tools.d.ts.map +1 -1
package/dist/runtime/mcp/tools.js +22 -0
package/dist/runtime/mcp/tools.js.map +1 -1
package/package.json +3 -3

package/dist/runtime/canevas/ui.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export declare const CANEVAS_HTML = "<!doctype html>\n<html lang=\"fr\">\n<head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n<title>h2a canevas \u2014 d\u00E9cisions</title>\n<style>\n :root{--bg:#0d1117;--panel:#161b22;--border:#30363d;--fg:#e6edf3;--muted:#8b949e;--accent:#3b82f6;--alert:#f85149;--decide:#d29922;--advise:#3fb950}\n *{box-sizing:border-box}\n body{margin:0;font:14px/1.5 -apple-system,BlinkMacSystemFont,\"Segoe UI\",Roboto,sans-serif;background:var(--bg);color:var(--fg)}\n header{padding:14px 20px;border-bottom:1px solid var(--border);display:flex;align-items:center;gap:12px}\n header h1{font-size:15px;margin:0;font-weight:600}\n .count{color:var(--muted);font-size:13px}\n main{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,1.2fr);gap:16px;padding:16px 20px;height:calc(100vh - 52px)}\n .col{min-width:0;display:flex;flex-direction:column}\n .card{background:var(--panel);border:1px solid var(--border);border-radius:10px;padding:18px}\n .chan{display:inline-block;font-size:11px;font-weight:700;text-transform:uppercase;letter-spacing:.05em;padding:2px 8px;border-radius:999px}\n .chan.alert{background:rgba(248,81,73,.15);color:var(--alert)}\n .chan.decide{background:rgba(210,153,34,.15);color:var(--decide)}\n .chan.advise{background:rgba(63,185,80,.15);color:var(--advise)}\n .q{font-size:18px;font-weight:600;margin:14px 0}\n .meta{color:var(--muted);font-size:12px;display:flex;flex-wrap:wrap;gap:12px}\n .nav{display:flex;align-items:center;gap:10px;margin-top:auto;padding-top:16px}\n button{font:inherit;background:var(--panel);color:var(--fg);border:1px solid var(--border);border-radius:8px;padding:8px 14px;cursor:pointer}\n button:hover:not(:disabled){border-color:var(--accent)}\n button:disabled{opacity:.5;cursor:not-allowed}\n .answers{display:flex;gap:8px;margin-top:16px;flex-wrap:wrap}\n .answers button{border-color:var(--accent)}\n .answerStatus{margin-top:10px;font-size:13px;min-height:18px}\n .answerStatus.ok{color:var(--advise)}\n .answerStatus.err{color:var(--alert)}\n .pane{background:#010409;border:1px solid var(--border);border-radius:10px;padding:12px;overflow:auto;flex:1;display:flex;flex-direction:column}\n .pane .label{color:var(--muted);font-size:11px;margin-bottom:8px;text-transform:uppercase;letter-spacing:.05em}\n .pane pre{margin:0;font:12px/1.45 ui-monospace,SFMono-Regular,Menlo,monospace;white-space:pre-wrap;word-break:break-word;color:#c9d1d9}\n .empty{color:var(--muted);text-align:center;margin-top:40px}\n</style>\n</head>\n<body>\n<header>\n <h1>h2a canevas \u2462</h1>\n <span class=\"count\" id=\"count\">\u2026</span>\n <span style=\"margin-left:auto;color:var(--muted);font-size:12px\">\u2190 \u2192 pour naviguer</span>\n</header>\n<main>\n <section class=\"col\">\n <div id=\"card\" class=\"card\"><div class=\"empty\">Chargement\u2026</div></div>\n <div class=\"nav\">\n <button id=\"prev\">\u2190 Pr\u00E9c\u00E9dent</button>\n <button id=\"next\">Suivant \u2192</button>\n <span class=\"count\" id=\"pos\"></span>\n </div>\n <div class=\"answerStatus\" id=\"answerStatus\" role=\"status\" aria-live=\"polite\"></div>\n </section>\n <section class=\"col\">\n <div class=\"pane\"><div class=\"label\" id=\"paneLabel\">Session CLI</div><pre id=\"pane\">\u2014</pre></div>\n </section>\n</main>\n<script>\n(function(){\n // Per-run write token, injected same-origin at GET /. A cross-origin page can\n // neither read it nor (CORS-closed) reach /api \u2014 so only this page can POST.\n var TOKEN=\"__CANEVAS_TOKEN__\";\n var decisions=[],idx=0,paneTimer=null;\n function esc(s){return String(s==null?\"\":s).replace(/[&<>]/g,function(c){return{\"&\":\"&\",\"<\":\"<\",\">\":\">\"}[c]})}\n function setStatus(msg,ok){var s=document.getElementById(\"answerStatus\");s.textContent=msg;s.className=\"answerStatus\"+(msg?(ok?\" ok\":\" err\"):\"\")}\n async function answer(decisionId,answerId,btn){\n setStatus(\"Envoi de la r\u00E9ponse\u2026\",true);\n if(btn){btn.disabled=true}\n try{\n var r=await fetch(\"/api/decisions/\"+encodeURIComponent(decisionId)+\"/answer\",{method:\"POST\",headers:{\"content-type\":\"application/json\",\"x-canevas-token\":TOKEN},body:JSON.stringify({answerId:answerId})});\n var j={};try{j=await r.json()}catch(e){}\n if(r.ok){setStatus(\"\u2713 R\u00E9ponse \u00AB \"+answerId+\" \u00BB transmise \u00E0 l'agent.\",true)}\n else{setStatus(\"\u2717 \"+(j&&j.error?j.error:(\"\u00E9chec (\"+r.status+\")\")),false)}\n }catch(e){setStatus(\"\u2717 erreur r\u00E9seau \u2014 r\u00E9essayez.\",false)}\n load();\n }\n async function load(){\n try{var r=await fetch(\"/api/decisions\");var j=await r.json();decisions=(j.decisions\|\|[])}catch(e){decisions=[]}\n if(idx>=decisions.length)idx=Math.max(0,decisions.length-1);\n render();\n }\n function render(){\n document.getElementById(\"count\").textContent=decisions.length+\" d\u00E9cision\"+(decisions.length>1?\"s\":\"\")+\" en attente\";\n var card=document.getElementById(\"card\");\n if(!decisions.length){card.innerHTML='<div class=\"empty\">Aucune d\u00E9cision en attente \uD83C\uDF89</div>';document.getElementById(\"pos\").textContent=\"\";setPane(null);return}\n var d=decisions[idx];\n var opts=(d.options&&d.options.length)?d.options:[{id:\"go\",label:\"Valider\"},{id:\"veto\",label:\"Refuser\"},{id:\"defer\",label:\"Diff\u00E9rer\"}];\n card.innerHTML=\n '<span class=\"chan '+esc(d.channel\|\|\"\")+'\">'+esc(d.channel\|\|\"d\u00E9cision\")+'</span>'+\n '<div class=\"q\">'+esc(d.question)+'</div>'+\n '<div class=\"meta\"><span>agent: '+esc(d.instance)+'</span>'+(d.workspace?'<span>ws: '+esc(d.workspace)+'</span>':'')+(d.createdAt?'<span>'+esc(d.createdAt)+'</span>':'')+'</div>'+\n '<div class=\"answers\">'+opts.map(function(o){return '<button class=\"ans\" data-a=\"'+esc(o.id)+'\">'+esc(o.label)+'</button>'}).join(\"\")+'</div>';\n Array.prototype.forEach.call(card.querySelectorAll(\".ans\"),function(btn){\n btn.onclick=function(){answer(d.id,btn.getAttribute(\"data-a\"),btn)};\n });\n document.getElementById(\"pos\").textContent=(idx+1)+\" / \"+decisions.length;\n setPane(d.sessionRef&&d.sessionRef.tmuxName?d.sessionRef.tmuxName:null);\n }\n function setPane(tmuxName){\n if(paneTimer){clearInterval(paneTimer);paneTimer=null}\n var pre=document.getElementById(\"pane\"),label=document.getElementById(\"paneLabel\");\n if(!tmuxName){pre.textContent=\"\u2014 (pas de session tmux li\u00E9e)\";label.textContent=\"Session CLI\";return}\n label.textContent=\"Session CLI \u00B7 \"+tmuxName;\n async function poll(){\n try{var r=await fetch(\"/api/sessions/\"+encodeURIComponent(tmuxName)+\"/pane?lines=200\");var j=await r.json();\n pre.textContent=j.degraded?\"(runtime indisponible \u2014 capturePane degraded)\":(j.text\|\|\"(pane vide)\")}catch(e){pre.textContent=\"(erreur de lecture du pane)\"}\n }\n poll();paneTimer=setInterval(poll,2000);\n }\n function go(delta){if(!decisions.length)return;idx=(idx+delta+decisions.length)%decisions.length;render()}\n document.getElementById(\"prev\").onclick=function(){go(-1)};\n document.getElementById(\"next\").onclick=function(){go(1)};\n document.addEventListener(\"keydown\",function(e){if(e.key===\"ArrowLeft\")go(-1);else if(e.key===\"ArrowRight\")go(1)});\n load();setInterval(load,5000);\n})();\n</script>\n</body>\n</html>";
2	+ //# sourceMappingURL=ui.d.ts.map

package/dist/runtime/canevas/ui.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../../src/runtime/canevas/ui.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,YAAY,02OAqHjB,CAAC"}

package/dist/runtime/canevas/ui.js ADDED Viewed

@@ -0,0 +1,124 @@
+// Canevas ③ — self-hosted UI (served at GET / by the local Hono server, NOT a
+// claude.ai Artifact: an Artifact cannot reach localhost/api). Self-contained:
+// inline CSS + vanilla JS, no CDN. tranche-3b — the answer buttons are LIVE: they
+// POST the human decision through the guarded reply-bridge, carrying the per-run
+// write token injected same-origin at GET / (`__CANEVAS_TOKEN__`).
+export const CANEVAS_HTML = `<!doctype html>
+<html lang="fr">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>h2a canevas — décisions</title>
+<style>
+  :root{--bg:#0d1117;--panel:#161b22;--border:#30363d;--fg:#e6edf3;--muted:#8b949e;--accent:#3b82f6;--alert:#f85149;--decide:#d29922;--advise:#3fb950}
+  *{box-sizing:border-box}
+  body{margin:0;font:14px/1.5 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serif;background:var(--bg);color:var(--fg)}
+  header{padding:14px 20px;border-bottom:1px solid var(--border);display:flex;align-items:center;gap:12px}
+  header h1{font-size:15px;margin:0;font-weight:600}
+  .count{color:var(--muted);font-size:13px}
+  main{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,1.2fr);gap:16px;padding:16px 20px;height:calc(100vh - 52px)}
+  .col{min-width:0;display:flex;flex-direction:column}
+  .card{background:var(--panel);border:1px solid var(--border);border-radius:10px;padding:18px}
+  .chan{display:inline-block;font-size:11px;font-weight:700;text-transform:uppercase;letter-spacing:.05em;padding:2px 8px;border-radius:999px}
+  .chan.alert{background:rgba(248,81,73,.15);color:var(--alert)}
+  .chan.decide{background:rgba(210,153,34,.15);color:var(--decide)}
+  .chan.advise{background:rgba(63,185,80,.15);color:var(--advise)}
+  .q{font-size:18px;font-weight:600;margin:14px 0}
+  .meta{color:var(--muted);font-size:12px;display:flex;flex-wrap:wrap;gap:12px}
+  .nav{display:flex;align-items:center;gap:10px;margin-top:auto;padding-top:16px}
+  button{font:inherit;background:var(--panel);color:var(--fg);border:1px solid var(--border);border-radius:8px;padding:8px 14px;cursor:pointer}
+  button:hover:not(:disabled){border-color:var(--accent)}
+  button:disabled{opacity:.5;cursor:not-allowed}
+  .answers{display:flex;gap:8px;margin-top:16px;flex-wrap:wrap}
+  .answers button{border-color:var(--accent)}
+  .answerStatus{margin-top:10px;font-size:13px;min-height:18px}
+  .answerStatus.ok{color:var(--advise)}
+  .answerStatus.err{color:var(--alert)}
+  .pane{background:#010409;border:1px solid var(--border);border-radius:10px;padding:12px;overflow:auto;flex:1;display:flex;flex-direction:column}
+  .pane .label{color:var(--muted);font-size:11px;margin-bottom:8px;text-transform:uppercase;letter-spacing:.05em}
+  .pane pre{margin:0;font:12px/1.45 ui-monospace,SFMono-Regular,Menlo,monospace;white-space:pre-wrap;word-break:break-word;color:#c9d1d9}
+  .empty{color:var(--muted);text-align:center;margin-top:40px}
+</style>
+</head>
+<body>
+<header>
+  <h1>h2a canevas ③</h1>
+  <span class="count" id="count">…</span>
+  <span style="margin-left:auto;color:var(--muted);font-size:12px">← → pour naviguer</span>
+</header>
+<main>
+  <section class="col">
+    <div id="card" class="card"><div class="empty">Chargement…</div></div>
+    <div class="nav">
+      <button id="prev">← Précédent</button>
+      <button id="next">Suivant →</button>
+      <span class="count" id="pos"></span>
+    </div>
+    <div class="answerStatus" id="answerStatus" role="status" aria-live="polite"></div>
+  </section>
+  <section class="col">
+    <div class="pane"><div class="label" id="paneLabel">Session CLI</div><pre id="pane">—</pre></div>
+  </section>
+</main>
+<script>
+(function(){
+  // Per-run write token, injected same-origin at GET /. A cross-origin page can
+  // neither read it nor (CORS-closed) reach /api — so only this page can POST.
+  var TOKEN="__CANEVAS_TOKEN__";
+  var decisions=[],idx=0,paneTimer=null;
+  function esc(s){return String(s==null?"":s).replace(/[&<>]/g,function(c){return{"&":"&amp;","<":"&lt;",">":"&gt;"}[c]})}
+  function setStatus(msg,ok){var s=document.getElementById("answerStatus");s.textContent=msg;s.className="answerStatus"+(msg?(ok?" ok":" err"):"")}
+  async function answer(decisionId,answerId,btn){
+    setStatus("Envoi de la réponse…",true);
+    if(btn){btn.disabled=true}
+    try{
+      var r=await fetch("/api/decisions/"+encodeURIComponent(decisionId)+"/answer",{method:"POST",headers:{"content-type":"application/json","x-canevas-token":TOKEN},body:JSON.stringify({answerId:answerId})});
+      var j={};try{j=await r.json()}catch(e){}
+      if(r.ok){setStatus("✓ Réponse « "+answerId+" » transmise à l'agent.",true)}
+      else{setStatus("✗ "+(j&&j.error?j.error:("échec ("+r.status+")")),false)}
+    }catch(e){setStatus("✗ erreur réseau — réessayez.",false)}
+    load();
+  }
+  async function load(){
+    try{var r=await fetch("/api/decisions");var j=await r.json();decisions=(j.decisions||[])}catch(e){decisions=[]}
+    if(idx>=decisions.length)idx=Math.max(0,decisions.length-1);
+    render();
+  }
+  function render(){
+    document.getElementById("count").textContent=decisions.length+" décision"+(decisions.length>1?"s":"")+" en attente";
+    var card=document.getElementById("card");
+    if(!decisions.length){card.innerHTML='<div class="empty">Aucune décision en attente 🎉</div>';document.getElementById("pos").textContent="";setPane(null);return}
+    var d=decisions[idx];
+    var opts=(d.options&&d.options.length)?d.options:[{id:"go",label:"Valider"},{id:"veto",label:"Refuser"},{id:"defer",label:"Différer"}];
+    card.innerHTML=
+      '<span class="chan '+esc(d.channel||"")+'">'+esc(d.channel||"décision")+'</span>'+
+      '<div class="q">'+esc(d.question)+'</div>'+
+      '<div class="meta"><span>agent: '+esc(d.instance)+'</span>'+(d.workspace?'<span>ws: '+esc(d.workspace)+'</span>':'')+(d.createdAt?'<span>'+esc(d.createdAt)+'</span>':'')+'</div>'+
+      '<div class="answers">'+opts.map(function(o){return '<button class="ans" data-a="'+esc(o.id)+'">'+esc(o.label)+'</button>'}).join("")+'</div>';
+    Array.prototype.forEach.call(card.querySelectorAll(".ans"),function(btn){
+      btn.onclick=function(){answer(d.id,btn.getAttribute("data-a"),btn)};
+    });
+    document.getElementById("pos").textContent=(idx+1)+" / "+decisions.length;
+    setPane(d.sessionRef&&d.sessionRef.tmuxName?d.sessionRef.tmuxName:null);
+  }
+  function setPane(tmuxName){
+    if(paneTimer){clearInterval(paneTimer);paneTimer=null}
+    var pre=document.getElementById("pane"),label=document.getElementById("paneLabel");
+    if(!tmuxName){pre.textContent="— (pas de session tmux liée)";label.textContent="Session CLI";return}
+    label.textContent="Session CLI · "+tmuxName;
+    async function poll(){
+      try{var r=await fetch("/api/sessions/"+encodeURIComponent(tmuxName)+"/pane?lines=200");var j=await r.json();
+        pre.textContent=j.degraded?"(runtime indisponible — capturePane degraded)":(j.text||"(pane vide)")}catch(e){pre.textContent="(erreur de lecture du pane)"}
+    }
+    poll();paneTimer=setInterval(poll,2000);
+  }
+  function go(delta){if(!decisions.length)return;idx=(idx+delta+decisions.length)%decisions.length;render()}
+  document.getElementById("prev").onclick=function(){go(-1)};
+  document.getElementById("next").onclick=function(){go(1)};
+  document.addEventListener("keydown",function(e){if(e.key==="ArrowLeft")go(-1);else if(e.key==="ArrowRight")go(1)});
+  load();setInterval(load,5000);
+})();
+</script>
+</body>
+</html>`;
+//# sourceMappingURL=ui.js.map

package/dist/runtime/canevas/ui.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"ui.js","sourceRoot":"","sources":["../../../src/runtime/canevas/ui.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+EAA+E;AAC/E,kFAAkF;AAClF,iFAAiF;AACjF,mEAAmE;AAEnE,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAqHpB,CAAC"}

package/dist/runtime/loop/engine/adapters.d.ts ADDED Viewed

@@ -0,0 +1,91 @@
+import type { H2ALaunchContext } from "../../../session.js";
+import { type H2AObjectiveLoop } from "../index.js";
+import { type AgentsSnapshot, type InboxSnapshot, type PendingDecision, type RefsRollup, type RefStatus } from "./decision.js";
+import type { ActionSink } from "./execute.js";
+export declare function readAgents(): Promise<AgentsSnapshot>;
+/** Shape of a `track query --format json` row we consume. */
+interface TrackQueryRow {
+    readonly id?: string;
+    readonly bucket?: string;
+    readonly realization?: string;
+    readonly acceptance?: string;
+}
+/**
+ * PURE mapping: a track item's (bucket, realization, acceptance) → loop RefStatus.
+ * Buckets: AWAITED | DROPPED | DONE | TO-DO. Conservative + unit-tested so the
+ * semantics stay explicit and easy to tune. Unknown/missing → "unknown" (the
+ * core treats that as NOT satisfied → never auto-closes on it).
+ */
+export declare function mapTrackAggregateToRefStatus(item: TrackQueryRow | undefined): RefStatus;
+export declare function readRefsRollup(loop: H2AObjectiveLoop): RefsRollup;
+/** PURE: escalations in an inbox → pending decisions for `agentId`. */
+export declare function pendingDecisionsFromInbox(envelopes: readonly {
+    readonly id: string;
+    readonly type: string;
+}[], agentId: string): PendingDecision[];
+export declare function readInbox(loop: H2AObjectiveLoop, root: string): InboxSnapshot;
+export type WakePlan = {
+    readonly kind: "wake";
+    readonly instance: string;
+    readonly host?: string;
+    readonly launchContext: H2ALaunchContext;
+    readonly instructionLine: string;
+} | {
+    readonly kind: "skip";
+    readonly reason: string;
+};
+/**
+ * PURE: given the loop, a target agent id, the FRESH sessions (already
+ * expiry-filtered by listPresence) and prior wake timestamps, decide whether to
+ * wake (and with what launchContext/line) or skip (and why). No IO. Freshness +
+ * cooldown are the safety gates BEFORE the driver's own human-typing guard.
+ */
+export declare function planWakeTarget(input: {
+    readonly loop: H2AObjectiveLoop;
+    readonly agentId: string;
+    readonly freshSessions: readonly {
+        readonly instance: string;
+        readonly launchContext?: H2ALaunchContext;
+    }[];
+    readonly priorWakeAtByAgent: ReadonlyMap<string, number>;
+    readonly now: number;
+}): WakePlan;
+/** PURE: latest applied-wake epoch ms per agent, from the loop event journal. */
+export declare function priorWakeAtByAgent(events: readonly {
+    readonly type: string;
+    readonly at: string;
+    readonly payload?: unknown;
+}[]): Map<string, number>;
+export type LaunchPlan = {
+    readonly kind: "emit";
+    readonly host?: string;
+    readonly reason: string;
+} | {
+    readonly kind: "skip";
+    readonly reason: string;
+};
+/**
+ * PURE: decide whether to ASK for a launch of a missing enrolled agent. Bounded
+ * by `policy.maxRelaunches` (stop asking after N) + a per-agent cooldown. h2a
+ * ASKS (records in the loop journal / — later — an envelope to a remote); it
+ * NEVER spawns arbitrary agents itself (spec objective-loop §Non-goals).
+ */
+export declare function planLaunchTarget(input: {
+    readonly loop: H2AObjectiveLoop;
+    readonly agentId: string;
+    readonly priorCount: number;
+    readonly priorLatestAt?: number;
+    readonly now: number;
+}): LaunchPlan;
+/** PURE: prior launch-request count + latest epoch ms per agent, from the journal. */
+export declare function priorLaunchByAgent(events: readonly {
+    readonly type: string;
+    readonly at: string;
+    readonly payload?: unknown;
+}[]): Map<string, {
+    count: number;
+    latestAt?: number;
+}>;
+export declare function buildActionSink(): ActionSink;
+export {};
+//# sourceMappingURL=adapters.d.ts.map

package/dist/runtime/loop/engine/adapters.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../../../src/runtime/loop/engine/adapters.ts"],"names":[],"mappings":"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"}

package/dist/runtime/loop/engine/adapters.js ADDED Viewed

@@ -0,0 +1,292 @@
+// Objective-loop tick — IO ADAPTERS (imperative shell).
+//
+// This is the ONLY loop-engine file allowed to reach `@sentropic/h2a-runtime`
+// (lazy import). `decision.ts` and `tick.ts` stay runtime-free; the golden-rule
+// scan in `remote-facade.test.js` enforces it. Consuming the TYPED projection
+// (not parsed CLI stdout) is a double-consensus ruling (2026-07-02).
+import { spawnSync } from "node:child_process";
+import { localTmuxDriver } from "../../drive/index.js";
+import { createLocalStore } from "../../local-files/store.js";
+import { listPresence } from "../../local-files/presence.js";
+import { listLoopEvents, readObjectiveLoop, updateObjectiveLoopStatus } from "../index.js";
+import { loopRefLocator } from "./decision.js";
+// --- Agents adapter (lazy runtime; degraded-clean on absence/failure) ---------
+export async function readAgents() {
+    // Variable-typed specifier defeats tsc static resolution: `@sentropic/h2a`
+    // must NEVER hard-depend on the heavy runtime (same trick as bin.ts).
+    const RUNTIME_PKG = "@sentropic/h2a-runtime";
+    try {
+        const rt = (await import(RUNTIME_PKG));
+        if (typeof rt.projectAgentsForH2a !== "function") {
+            return { degraded: true, agents: [] };
+        }
+        const env = rt.projectAgentsForH2a();
+        const agents = Array.isArray(env.agents) ? env.agents : [];
+        return {
+            degraded: false,
+            ...(typeof env.version === "number" ? { version: env.version } : {}),
+            agents,
+        };
+    }
+    catch {
+        // Runtime not installed or failed → degraded; NEVER invent agent state.
+        return { degraded: true, agents: [] };
+    }
+}
+/**
+ * PURE mapping: a track item's (bucket, realization, acceptance) → loop RefStatus.
+ * Buckets: AWAITED | DROPPED | DONE | TO-DO. Conservative + unit-tested so the
+ * semantics stay explicit and easy to tune. Unknown/missing → "unknown" (the
+ * core treats that as NOT satisfied → never auto-closes on it).
+ */
+export function mapTrackAggregateToRefStatus(item) {
+    if (!item)
+        return "unknown";
+    const bucket = (item.bucket ?? "").toUpperCase();
+    const acceptance = (item.acceptance ?? "").toLowerCase();
+    const realization = (item.realization ?? "").toLowerCase();
+    if (bucket === "DONE") {
+        return acceptance === "accepted" || acceptance === "pass" ? "accepted" : "done";
+    }
+    if (bucket === "DROPPED" || realization === "cancelled")
+        return "rejected";
+    if (bucket === "AWAITED" || bucket === "TO-DO")
+        return "pending";
+    return "unknown";
+}
+export function readRefsRollup(loop) {
+    // No refs declared → nothing to resolve; not degraded (no track call).
+    if (loop.refs.length === 0)
+        return { degraded: false, refs: [] };
+    const cwds = loop.repos.map((r) => r.path).filter((p) => !!p);
+    if (cwds.length === 0)
+        cwds.push(process.cwd());
+    const itemsById = new Map();
+    let anyQueryOk = false;
+    for (const cwd of cwds) {
+        const res = spawnSync("track", ["query", "--format", "json"], { cwd, encoding: "utf8" });
+        if (res.error || res.status !== 0 || !res.stdout)
+            continue;
+        try {
+            const rows = JSON.parse(res.stdout);
+            if (Array.isArray(rows)) {
+                anyQueryOk = true;
+                for (const row of rows) {
+                    if (row && typeof row.id === "string")
+                        itemsById.set(row.id, row);
+                }
+            }
+        }
+        catch {
+            // non-JSON output → ignore this repo
+        }
+    }
+    // `track` unreachable in every repo → degraded (do not invent ref state).
+    if (!anyQueryOk)
+        return { degraded: true, refs: [] };
+    return {
+        degraded: false,
+        refs: loop.refs.map((r) => ({
+            locator: loopRefLocator(r),
+            status: mapTrackAggregateToRefStatus(itemsById.get(r.aggregateId)),
+        })),
+    };
+}
+// --- Inbox adapter (READ-ONLY) ------------------------------------------------
+// The h2a bus is a negotiation protocol (register/propose/accept/reject/counter/
+// withdraw/event/escalate). The clearest "needs a human/agent decision" signal is
+// an `escalate` envelope sitting in an enrolled agent's inbox. We surface those as
+// pending decisions so the loop reports `waiting-human` and routes them.
+// TODO(next): also correlate unresolved `propose` (no matching accept/reject).
+/** PURE: escalations in an inbox → pending decisions for `agentId`. */
+export function pendingDecisionsFromInbox(envelopes, agentId) {
+    return envelopes
+        .filter((e) => e.type === "escalate")
+        .map((e) => ({ id: e.id, forAgent: agentId }));
+}
+export function readInbox(loop, root) {
+    const enrolled = loop.agents
+        .map((a) => ({ agentId: a.id, instance: a.h2aInstance }))
+        .filter((x) => typeof x.instance === "string");
+    if (enrolled.length === 0)
+        return { pendingDecisions: [] };
+    let store;
+    try {
+        store = createLocalStore({ root });
+    }
+    catch {
+        return { pendingDecisions: [] };
+    }
+    const pending = [];
+    const seen = new Set();
+    for (const { agentId, instance } of enrolled) {
+        let envelopes;
+        try {
+            envelopes = store.readInbox(instance);
+        }
+        catch {
+            continue;
+        }
+        for (const d of pendingDecisionsFromInbox(envelopes, agentId)) {
+            if (!seen.has(d.id)) {
+                seen.add(d.id);
+                pending.push(d);
+            }
+        }
+    }
+    return { pendingDecisions: pending };
+}
+const WAKE_COOLDOWN_FLOOR_MS = 300_000; // 5 min
+/**
+ * PURE: given the loop, a target agent id, the FRESH sessions (already
+ * expiry-filtered by listPresence) and prior wake timestamps, decide whether to
+ * wake (and with what launchContext/line) or skip (and why). No IO. Freshness +
+ * cooldown are the safety gates BEFORE the driver's own human-typing guard.
+ */
+export function planWakeTarget(input) {
+    const agent = input.loop.agents.find((a) => a.id === input.agentId);
+    if (!agent || agent.h2aInstance === undefined)
+        return { kind: "skip", reason: "no-h2a-instance" };
+    const cooldownMs = Math.max(input.loop.policy.tickMs, WAKE_COOLDOWN_FLOOR_MS);
+    const last = input.priorWakeAtByAgent.get(input.agentId);
+    if (last !== undefined && input.now - last < cooldownMs)
+        return { kind: "skip", reason: "cooldown" };
+    const session = input.freshSessions.find((s) => s.instance === agent.h2aInstance);
+    if (!session || !session.launchContext || !session.launchContext.tmux) {
+        return { kind: "skip", reason: "no-fresh-tmux-session" };
+    }
+    const instructionLine = `[h2a-wake reason=loop loopId=${input.loop.id} at=${new Date(input.now).toISOString()}] ` +
+        `reprends l'objectif: ${input.loop.goal}`;
+    return {
+        kind: "wake",
+        instance: agent.h2aInstance,
+        ...(agent.host !== undefined ? { host: agent.host } : {}),
+        launchContext: session.launchContext,
+        instructionLine
+    };
+}
+/** PURE: latest applied-wake epoch ms per agent, from the loop event journal. */
+export function priorWakeAtByAgent(events) {
+    const out = new Map();
+    for (const e of events) {
+        if (e.type !== "loop.action.applied")
+            continue;
+        const p = e.payload;
+        if (!p || p.action !== "wake" || typeof p.key !== "string" || !p.key.startsWith("wake:"))
+            continue;
+        const agentId = p.key.slice("wake:".length);
+        const at = Date.parse(e.at);
+        if (Number.isNaN(at))
+            continue;
+        const prev = out.get(agentId);
+        if (prev === undefined || at > prev)
+            out.set(agentId, at);
+    }
+    return out;
+}
+/**
+ * PURE: decide whether to ASK for a launch of a missing enrolled agent. Bounded
+ * by `policy.maxRelaunches` (stop asking after N) + a per-agent cooldown. h2a
+ * ASKS (records in the loop journal / — later — an envelope to a remote); it
+ * NEVER spawns arbitrary agents itself (spec objective-loop §Non-goals).
+ */
+export function planLaunchTarget(input) {
+    const agent = input.loop.agents.find((a) => a.id === input.agentId);
+    if (!agent)
+        return { kind: "skip", reason: "unknown-agent" };
+    if (input.priorCount >= input.loop.policy.maxRelaunches)
+        return { kind: "skip", reason: "max-relaunches" };
+    const cooldownMs = Math.max(input.loop.policy.tickMs, WAKE_COOLDOWN_FLOOR_MS);
+    if (input.priorLatestAt !== undefined && input.now - input.priorLatestAt < cooldownMs) {
+        return { kind: "skip", reason: "cooldown" };
+    }
+    return {
+        kind: "emit",
+        ...(agent.host !== undefined ? { host: agent.host } : {}),
+        reason: "enrolled agent missing while work pending"
+    };
+}
+/** PURE: prior launch-request count + latest epoch ms per agent, from the journal. */
+export function priorLaunchByAgent(events) {
+    const out = new Map();
+    for (const e of events) {
+        if (e.type !== "loop.action.applied")
+            continue;
+        const p = e.payload;
+        if (!p || p.action !== "request-launch" || typeof p.key !== "string" || !p.key.startsWith("request-launch:")) {
+            continue;
+        }
+        const agentId = p.key.slice("request-launch:".length);
+        const at = Date.parse(e.at);
+        const cur = out.get(agentId) ?? { count: 0 };
+        cur.count += 1;
+        if (!Number.isNaN(at) && (cur.latestAt === undefined || at > cur.latestAt))
+            cur.latestAt = at;
+        out.set(agentId, cur);
+    }
+    return out;
+}
+// --- Action sink (effects for `--execute`) ------------------------------------
+// `close` = idempotent store status flip (ZERO injection). `wake` = fresh-session
+// + cooldown gated localTmuxDriver (which re-checks the human-typing guard at the
+// last moment; defer → "deferred", stays pending). request-launch / route-decision
+// still `skipped` (their guarded slices land next). NEVER chain/headless/auto — a
+// defer must not fall back to a headless injection (double-consensus RISK #1).
+export function buildActionSink() {
+    return {
+        async close(_action, ctx) {
+            const { changed } = updateObjectiveLoopStatus(ctx.root, ctx.loopId, "done", {
+                now: ctx.now,
+                reason: "objective-loop tick: all primary/target refs satisfied"
+            });
+            return changed ? "done" : "skipped";
+        },
+        async requestLaunch(action, ctx) {
+            const loop = readObjectiveLoop(ctx.root, ctx.loopId);
+            const prior = priorLaunchByAgent(listLoopEvents(ctx.root, ctx.loopId)).get(action.agentId ?? "") ?? { count: 0 };
+            const plan = planLaunchTarget({
+                loop,
+                agentId: action.agentId ?? "",
+                priorCount: prior.count,
+                ...(prior.latestAt !== undefined ? { priorLatestAt: prior.latestAt } : {}),
+                now: ctx.now
+            });
+            // ASK, never spawn (spec §Non-goals: "h2a asks remote/runtime to spawn").
+            // MVP: record the request in the loop journal (loop.action.applied
+            // {request-launch}) — a conductor/remote consumes it. TODO: also emit a
+            // conductor-launch-request envelope to a live remote (createEnvelope +
+            // putInboxMessage) once actor-instance + workspace resolution is settled.
+            return plan.kind === "emit" ? "done" : "skipped";
+        },
+        async wake(action, ctx) {
+            const loop = readObjectiveLoop(ctx.root, ctx.loopId);
+            const freshSessions = listPresence(ctx.root, { now: ctx.now }).map((s) => ({
+                instance: s.instance,
+                ...(s.launchContext !== undefined ? { launchContext: s.launchContext } : {})
+            }));
+            const plan = planWakeTarget({
+                loop,
+                agentId: action.agentId ?? "",
+                freshSessions,
+                priorWakeAtByAgent: priorWakeAtByAgent(listLoopEvents(ctx.root, ctx.loopId)),
+                now: ctx.now
+            });
+            if (plan.kind === "skip")
+                return "skipped";
+            // localTmuxDriver ONLY — never chain/headless/auto (RISK #1). It applies the
+            // human-typing guard at the last moment and DEFERS (false) if a human is
+            // active in the pane; a defer stays pending and re-fires next tick.
+            const ok = await localTmuxDriver().drive({
+                to: plan.instance,
+                ...(plan.host !== undefined ? { host: plan.host } : {}),
+                instructionLine: plan.instructionLine,
+                launchContext: plan.launchContext
+            });
+            return ok ? "done" : "deferred";
+        },
+        async routeDecision() {
+            return "skipped";
+        }
+    };
+}
+//# sourceMappingURL=adapters.js.map

package/dist/runtime/loop/engine/adapters.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../../../src/runtime/loop/engine/adapters.ts"],"names":[],"mappings":"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"}

package/dist/runtime/loop/engine/decision.d.ts ADDED Viewed

@@ -0,0 +1,71 @@
+import type { H2AObjectiveLoop, H2ALoopTrackRef } from "../index.js";
+export interface ProjectedAgent {
+    readonly id: string;
+    readonly tool: string;
+    readonly state: string;
+    readonly cwd: string;
+    readonly tmuxSession?: string;
+    readonly jobId?: string;
+    readonly h2aInstance?: string;
+    readonly capabilities: {
+        readonly attach: boolean;
+        readonly logs: boolean;
+        readonly remote: boolean;
+    };
+}
+export interface AgentsSnapshot {
+    readonly degraded: boolean;
+    readonly version?: number;
+    readonly agents: readonly ProjectedAgent[];
+}
+export type RefStatus = "accepted" | "done" | "pending" | "rejected" | "blocked" | "stale" | "unknown";
+export interface RolledRef {
+    readonly locator: string;
+    readonly status: RefStatus;
+}
+export interface RefsRollup {
+    readonly degraded: boolean;
+    readonly refs: readonly RolledRef[];
+}
+export interface PendingDecision {
+    readonly id: string;
+    readonly forAgent?: string;
+}
+export interface InboxSnapshot {
+    readonly pendingDecisions: readonly PendingDecision[];
+}
+export interface TickInput {
+    readonly loop: H2AObjectiveLoop;
+    readonly agents: AgentsSnapshot;
+    readonly refs: RefsRollup;
+    readonly inbox: InboxSnapshot;
+    readonly now: number;
+}
+export type TickActionType = "request-launch" | "wake" | "route-decision" | "close" | "noop";
+export interface TickAction {
+    readonly type: TickActionType;
+    readonly reason: string;
+    readonly agentId?: string;
+    readonly refLocator?: string;
+    readonly decisionId?: string;
+}
+export type TickOutcome = "running" | "waiting-human" | "waiting-agent" | "stalled" | "degraded" | "eligible-for-close" | "failed";
+export interface TickPlan {
+    readonly loopId: string;
+    readonly degraded: boolean;
+    readonly outcome: TickOutcome;
+    readonly close: boolean;
+    readonly actions: readonly TickAction[];
+    readonly reasons: readonly string[];
+}
+/** Stable join key for a declared loop track-ref. Adapters MUST use the same. */
+export declare function loopRefLocator(ref: H2ALoopTrackRef): string;
+/**
+ * Pure objective-loop tick decision. Deterministic; no IO. Implements the spec
+ * (2026-06-26 §Relaunch + §C completion) at MVP scope: degraded short-circuit,
+ * multi-ref completion rollup, and conservative launch/wake/route intents.
+ *
+ * The shell never auto-closes unless `close===true` (policy.closeWhenRefsSatisfied).
+ */
+export declare function planLoopTick(input: TickInput): TickPlan;
+//# sourceMappingURL=decision.d.ts.map

package/dist/runtime/loop/engine/decision.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../../../src/runtime/loop/engine/decision.ts"],"names":[],"mappings":"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"}