@nextclaw/x-harness 0.2.6 → 0.2.8

package/SOURCE.md

@@ -1,8 +1,8 @@
 # Corresponding source
 
-Version 0.2.6, commit 7f48fb11b07a0e043cfaccfc377183d71f23eef2.
+Version 0.2.8, commit 1470fe3c0a22c10b7e414209d1807ae5b9d8b62b.
 
-Complete source, build scripts and dependencies: https://github.com/Peiiii/x-harness/tree/7f48fb11b07a0e043cfaccfc377183d71f23eef2
+Complete source, build scripts and dependencies: https://github.com/Peiiii/x-harness/tree/1470fe3c0a22c10b7e414209d1807ae5b9d8b62b
 
 Clone this revision, run npm ci, npm run bootstrap and npm run release:build.
 

package/dist/api.d.ts

@@ -16,6 +16,7 @@ export declare class BusinessHarness implements XGrowthHarness {
     private single;
     readCreator(args: import("./types.js").CreatorOptions): Promise<ReadResult>;
     readBookmarks(args: import("./types.js").BookmarkOptions): Promise<ReadResult>;
+    readIncomingReplies(args?: import("./types.js").IncomingReplyOptions): Promise<ReadResult>;
     searchSources(args: import("./types.js").SearchOptions): Promise<ReadResult>;
     readPost({ target, mode, }: {
         target: import("./types.js").PostTarget;

package/dist/api.js

@@ -18,6 +18,7 @@ export class BusinessHarness {
         this.readFeedback = this.readFeedback.bind(this);
         this.readPerson = this.readPerson.bind(this);
         this.readPost = this.readPost.bind(this);
+        this.readIncomingReplies = this.readIncomingReplies.bind(this);
         this.searchSources = this.searchSources.bind(this);
         this.readBookmarks = this.readBookmarks.bind(this);
         this.readCreator = this.readCreator.bind(this);
@@ -276,6 +277,28 @@ export class BusinessHarness {
     readBookmarks(args) {
         return this.read("readBookmarks", args, args.mode);
     }
+    async readIncomingReplies(args = {}) {
+        const snapshot = await this.#store.load();
+        const handle = snapshot.state.accountHandle;
+        if (!/^[A-Za-z0-9_]{1,15}$/.test(handle ?? ""))
+            return {
+                status: "needsDecision",
+                complete: false,
+                reason: "account-identity-required",
+            };
+        const processedIds = new Set(args.processedIds ?? []);
+        for (const action of snapshot.state.actions ?? []) {
+            if (action.kind === "reply" &&
+                ["verified", "preexisting", "intent", "unknown"].includes(action.status))
+                processedIds.add(action.postId);
+        }
+        return this.read("searchSources", {
+            query: `to:${handle} filter:replies -from:${handle}`,
+            limit: args.limit ?? 5,
+            maxPages: args.maxPages ?? 3,
+            processedIds: [...processedIds],
+        }, args.mode);
+    }
     searchSources(args) {
         return this.read("searchSources", args, args.mode);
     }

package/dist/types.d.ts

@@ -103,6 +103,8 @@ export interface WindowOptions {
     maxPages?: number;
     processedIds?: string[];
 }
+export interface IncomingReplyOptions extends WindowOptions {
+}
 export interface BookmarkOptions extends WindowOptions {
     folder: string;
 }
@@ -360,6 +362,7 @@ export interface XGrowthHarness {
     readCreator(args: CreatorOptions): Promise<ReadResult>;
     readBookmarks(args: BookmarkOptions): Promise<ReadResult>;
     searchSources(args: SearchOptions): Promise<ReadResult>;
+    readIncomingReplies(args?: IncomingReplyOptions): Promise<ReadResult>;
     readPost(args: {
         target: PostTarget;
         mode?: ReadMode;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/x-harness",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "type": "module",
   "description": "Typed X task harness with compact business results and explicit diagnostics.",
   "main": "./dist/index.js",
@@ -42,5 +42,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "7f48fb11b07a0e043cfaccfc377183d71f23eef2"
+  "gitHead": "1470fe3c0a22c10b7e414209d1807ae5b9d8b62b"
 }

package/skill/references/reads.md

@@ -1,9 +1,10 @@
 # Read tasks
 
-Load for reading only. A valid root binding `x` with existing ledger/proof paths suffices; no write plan needed. `mode` defaults to `receipt`; use `decision` immediately when drafting/reviewing needs text. `delta` omits only unchanged evidence previously returned by this instance; after context loss use `decision`.
+Use bound root `x`. Default `receipt` is compact; use `decision` for complete drafting evidence or after context loss; `delta` omits only previously delivered unchanged evidence.
 
 | API | Required | Optional |
 | --- | --- | --- |
+| readIncomingReplies | none | processedIds, limit (5), maxPages (3), mode |
 | readCreator | handle | target (default 10, 1–50), maxScrolls, navigate, expand, mode |
 | readBookmarks | folder (observed name) | processedIds, limit, maxPages, mode |
 | searchSources | query | processedIds, limit, maxPages, mode |
@@ -21,3 +22,5 @@ var postResult = await x.readPost({ target: observedPost, mode: 'decision' });
 Targets/proof come from actual observations, never guessed URLs or made-up references. API owns navigation/expansion and bounded collection. Native creator collection supports an already selected profile with `navigate:false`; it keeps relative times unknown and stops with partial evidence if the active page changes. Native automatic creator navigation remains `needsCapability`; inspect that signal before changing adapter.
 
 Results include status/evidenceRef/missing/IDs/completeness. In `decision`, creator/bookmark/search use `sources`, post `post`, person `person`, feedback `feedback`; account includes accountHandle/accountURL. `observed` alone does not prove every requested field exists. `pageComplete:false` is a collection boundary, not proof of truncated target text. View media before describing it. Return complete chosen evidence; keep other observations local. Only on failure load recovery.
+
+`readIncomingReplies` searches replies to the ledger account; skips settled/intent/unknown targets and processedIds (carry across dates). Candidates still need full thread/public dedup; finite windows never prove inbox clearance.