ace-wake 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c70984a4740dce94a78731fd0852370b10a23a4b05e43286450ad83b7121bad3
-  data.tar.gz: 757c46a35a41081cfc85666681326a0275d127d8d2490c6470e6e8dbb1db4fc6
+  metadata.gz: c2dff41db21b22ff36dbe9d9dda962979e2598072dfba16a406b81cdb1fb0cbf
+  data.tar.gz: f303030a7487b009196d4a4f1ffe92ea90f4872e66b20a9549871c968c85eaa9
 SHA512:
-  metadata.gz: bd19ae88ac86295da911337b06c20aa07f6c282fc14cc5f900527b93fb3b2c6989083789863565f49af0d17e77faee14b543a90995c514a4236ab33710f9ba40
-  data.tar.gz: 41b39de4a48e8dfc036774424161bcbc416aa25f36090daa7d181bb021223e2b2a5e1d1b863c810f94309c5adb03760821400a6bea502bdc008729746ab11e02
+  metadata.gz: e3284df4db91ce0b48fa1714b00b818622d0df1c20ee7d5f4b7812683f545696bbeed3bb11089a066825726cd3d5a81d09836747c9ee276b503bae19028770e8
+  data.tar.gz: 9496ea0bc29040ce63e62c2be847a782b4b7c0237efa5982a9793dcc9b81de2d5e591bb3b33cc4d9b8e862b7fda6f0477b16a691e67ba2e2e3c5e33d9f77e358

data/CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [0.2.0] - 2026-10-31
+
+### Added
+
+- Agent-callable eyes start with configPath, returning initial pending revisions
+  without a redundant wake; quota breakers and retirement remain protected.
+
 ## [0.1.0] - 2026-10-30
 
 First publishable release of the ace-wake asset package (task family

data/handbook/extensions/ace-wake/wake/eyes-runtime.js

@@ -25,7 +25,7 @@ export async function observeHitl(cwd, config) {
 
 export function registerEyes(pi, { observe = observeHitl, now = Date.now,
   schedule = (fn, ms) => setInterval(fn, ms), cancel = clearInterval } = {}) {
-  let eyes, timer, attempt, compacting = false, running = false;
+  let eyes, timer, attempt, observedSources, bindingGeneration = 0, compacting = false, running = false, arming = false;
   const stopTimer = () => { if (timer !== undefined) cancel(timer); timer = undefined; };
   function arm() {
     stopTimer();
@@ -35,7 +35,8 @@ export function registerEyes(pi, { observe = observeHitl, now = Date.now,
     }
   }
   const bind = (ctx) => {
-    stopTimer(); eyes?.dispose(); attempt = undefined; compacting = false; running = false;
+    const generation = ++bindingGeneration;
+    stopTimer(); eyes?.dispose(); attempt = undefined; observedSources = undefined; compacting = false; running = false;
     const entries = ctx.sessionManager.getBranch();
     const snapshot = [...entries].reverse().find((e) => e.type === "custom" && e.customType === EYES_ENTRY)?.data;
     const ownerCwd = path.resolve(ctx.cwd);
@@ -50,8 +51,14 @@ export function registerEyes(pi, { observe = observeHitl, now = Date.now,
         ctx.ui?.setStatus?.("ace-eyes", `eyes ${state.retired ? "retired" : state.breaker?.reason || (state.enabled ? "observing" : "off")} pending:${state.pending}`);
         if (state.breaker || state.retired) stopTimer();
       },
-      observe: (config) => observe(ctx.cwd, config),
-      canDeliver: () => !compacting && (ctx.isIdle() || running),
+      observe: async (config) => {
+        const result = await observe(ctx.cwd, config);
+        // A disposed binding can still finish its asynchronous owner read.
+        // Its source health is never evidence for the current session binding.
+        if (generation === bindingGeneration) observedSources = result.sources;
+        return result;
+      },
+      canDeliver: () => !arming && !compacting && (ctx.isIdle() || running),
       deliveryStatus: () => {
         if (attempt?.accepted) return "accepted";
         // sendUserMessage is a void wrapper. Busy/queued is uncertain, not
@@ -61,8 +68,8 @@ export function registerEyes(pi, { observe = observeHitl, now = Date.now,
       },
       deliver: async (batch) => {
         if (!ctx.model) return false;
-        const text = `[ace-eyes] Pending canonical HITL/deadline revisions: ${JSON.stringify(batch)}. ` +
-          "Read original events; adopt reports through ace-overseer process-reports and existing task/assignment gates. " +
+        const text = `[ace-eyes] Pending task/assignment/HITL/deadline revisions: ${JSON.stringify(batch)}. ` +
+          "Read ace-overseer observe and the original state owners; adopt reports through ace-overseer process-reports and existing task/assignment gates. " +
           "Reconcile uncertain effects; never repeat external actions on wake alone. After handling each exact revision, " +
           "acknowledge with the ace_eyes tool (action ack, key, revision). Settlement alone is not acknowledgement.";
         attempt = { text, accepted: false };
@@ -94,9 +101,10 @@ export function registerEyes(pi, { observe = observeHitl, now = Date.now,
     if (message?.role === "assistant" && message.stopReason === "error") eyes?.quota(message.errorMessage);
   });
   pi.registerTool?.({
-    name: "ace_eyes", label: "Eyes acknowledgement", description: "Read pending semantic events or acknowledge an exact handled revision. Does not accept reports, authorize effects, start actors or reset quota. Use existing report/assignment owners first. Deadlines require an operation identity and revision; cancel when no longer active.",
+    name: "ace_eyes", label: "Eyes observation", description: "Start standing observation with an existing config file, read pending semantic events or acknowledge an exact handled revision. Does not accept reports, authorize effects, start actors or reset quota. Use existing report/assignment owners first. Deadlines require an operation identity and revision; cancel when no longer active.",
     parameters: { type: "object", properties: {
-      action: { type: "string", enum: ["status", "ack", "deadline", "cancel"] },
+      action: { type: "string", enum: ["start", "status", "ack", "deadline", "cancel"] },
+      configPath: { type: "string" },
       key: { type: "string" }, revision: { type: "string" }, at: { type: "integer" }
     }, required: ["action"], additionalProperties: false },
     execute: async (_id, args, _signal, _onUpdate, ctx) => {
@@ -104,13 +112,24 @@ export function registerEyes(pi, { observe = observeHitl, now = Date.now,
         if (!ctx) throw new Error("Eyes session not initialized");
         bind(ctx);
       }
-      if (args.action === "ack") eyes.ack(args.key, args.revision);
+      if (args.action === "start") {
+        if (!ctx || typeof args.configPath !== "string" || !args.configPath.trim()) {
+          throw new Error("Eyes start requires configPath and the current session context");
+        }
+        const config = JSON.parse(fs.readFileSync(path.resolve(ctx.cwd, args.configPath), "utf8"));
+        eyes.start(config); arm();
+        // Observe now, but do not enqueue a redundant model turn inside the
+        // caller's turn. Pending revisions are returned to the caller below.
+        arming = true;
+        try { await eyes.tick(); } finally { arming = false; }
+      }
+      else if (args.action === "ack") eyes.ack(args.key, args.revision);
       else if (args.action === "deadline") eyes.deadline(args.key, args.at, args.revision);
       else if (args.action === "cancel") eyes.cancelDeadline(args.key);
       else if (args.action !== "status") throw new Error("Unknown eyes action");
       // Do not send a second wake from inside the running model turn. The next
       // observation delivers remaining coalesced revisions through the same owner.
-      const details = { ...eyes.summary(), pending: eyes.s.pending, deadlines: eyes.s.deadlines };
+      const details = { ...eyes.summary(), sources: observedSources, pending: eyes.s.pending, deadlines: eyes.s.deadlines };
       return { content: [{ type: "text", text: JSON.stringify(details) }], details };
     }
   });

data/lib/ace/wake/version.rb

@@ -2,6 +2,6 @@
 
 module Ace
   module Wake
-    VERSION = "0.1.0"
+    VERSION = "0.2.0"
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-wake
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-10-30 00:00:00.000000000 Z
+date: 2026-10-31 00:00:00.000000000 Z
 dependencies: []
 description: 'Publishable asset package for the ace-wake Pi harness extension: /loop
   timers and /watch file subscriptions that wake idle agents. Ships the extension