@xrkseek/harness 0.5.10 → 0.5.11

package/node_modules/@xrkseek/server-face/dist/adapt/index.d.ts

@@ -1,5 +1,5 @@
 export { EVENT_ISOMORPHISM, toFaceWireSessionEvent, toMuxSessionEvent, toWireHistoryEntry, wireNumericId, type FaceWireSessionEvent, type WireAdaptContext, type WireHistoryEntry, } from "./wire-event.js";
-export { assistantMessageSource, FACE_ASSISTANT_SOURCE_PLACEHOLDER, FACE_USAGE_ROUTE_PLACEHOLDER, providerModelKey, routeFromRequestHeader, type FaceModelRoute, } from "./model-route.js";
+export { assistantMessageSource, FACE_ASSISTANT_SOURCE_PLACEHOLDER, FACE_USAGE_ROUTE_PLACEHOLDER, providerModelKey, routeFromRequestHeader, lastRequestHeaderSelection, type FaceModelRoute, } from "./model-route.js";
 export { FaceInboxWireMaps, FaceInboxWireProjector, type FaceInboxSplice, type FaceWireUserMessage, type InboxTarget, } from "./inbox-wire.js";
 export { FaceWireIdMaps } from "./wire-ids.js";
 export { presentToolView, collectToolCallArgs, collectToolCallArgsForPage, FaceToolArgMaps, faceToolLookup, type PresentToolLookup, type ToolCallPairing, type ToolEventView, } from "./tool-view.js";

package/node_modules/@xrkseek/server-face/dist/adapt/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapt/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,sBAAsB,EACtB,iCAAiC,EACjC,4BAA4B,EAC5B,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,0BAA0B,EAC1B,eAAe,EACf,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,QAAQ,EACR,yBAAyB,EACzB,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,cAAc,EACnB,KAAK,OAAO,EACZ,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,8BAA8B,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EACL,gBAAgB,EAChB,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapt/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,sBAAsB,EACtB,iCAAiC,EACjC,4BAA4B,EAC5B,gBAAgB,EAChB,sBAAsB,EACtB,0BAA0B,EAC1B,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,0BAA0B,EAC1B,eAAe,EACf,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,QAAQ,EACR,yBAAyB,EACzB,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,cAAc,EACnB,KAAK,OAAO,EACZ,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,8BAA8B,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EACL,gBAAgB,EAChB,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC"}

package/node_modules/@xrkseek/server-face/dist/adapt/index.js

@@ -1,5 +1,5 @@
 export { EVENT_ISOMORPHISM, toFaceWireSessionEvent, toMuxSessionEvent, toWireHistoryEntry, wireNumericId, } from "./wire-event.js";
-export { assistantMessageSource, FACE_ASSISTANT_SOURCE_PLACEHOLDER, FACE_USAGE_ROUTE_PLACEHOLDER, providerModelKey, routeFromRequestHeader, } from "./model-route.js";
+export { assistantMessageSource, FACE_ASSISTANT_SOURCE_PLACEHOLDER, FACE_USAGE_ROUTE_PLACEHOLDER, providerModelKey, routeFromRequestHeader, lastRequestHeaderSelection, } from "./model-route.js";
 export { FaceInboxWireMaps, FaceInboxWireProjector, } from "./inbox-wire.js";
 export { FaceWireIdMaps } from "./wire-ids.js";
 export { presentToolView, collectToolCallArgs, collectToolCallArgsForPage, FaceToolArgMaps, faceToolLookup, } from "./tool-view.js";

package/node_modules/@xrkseek/server-face/dist/adapt/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapt/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,GAId,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,sBAAsB,EACtB,iCAAiC,EACjC,4BAA4B,EAC5B,gBAAgB,EAChB,sBAAsB,GAEvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,sBAAsB,GAIvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,0BAA0B,EAC1B,eAAe,EACf,cAAc,GAIf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,QAAQ,EACR,yBAAyB,EACzB,kBAAkB,EAClB,wBAAwB,GAIzB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,8BAA8B,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EACL,gBAAgB,EAChB,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapt/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,GAId,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,sBAAsB,EACtB,iCAAiC,EACjC,4BAA4B,EAC5B,gBAAgB,EAChB,sBAAsB,EACtB,0BAA0B,GAE3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,sBAAsB,GAIvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,0BAA0B,EAC1B,eAAe,EACf,cAAc,GAIf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,QAAQ,EACR,yBAAyB,EACzB,kBAAkB,EAClB,wBAAwB,GAIzB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,8BAA8B,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EACL,gBAAgB,EAChB,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC"}

package/node_modules/@xrkseek/server-face/dist/adapt/model-route.d.ts

@@ -31,7 +31,12 @@ export declare function routeFromRequestHeader(event: {
         readonly config?: {
             readonly provider?: string;
             readonly model?: string;
+            readonly reasoningEffort?: string;
         };
     };
 }): FaceModelRoute | undefined;
+/** Latest `request/header` route in a log prefix (ignores live Face maps). */
+export declare function lastRequestHeaderSelection(events: readonly Parameters<typeof routeFromRequestHeader>[0][]): (FaceModelRoute & {
+    reasoningEffort?: string;
+}) | undefined;
 //# sourceMappingURL=model-route.d.ts.map

package/node_modules/@xrkseek/server-face/dist/adapt/model-route.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-route.d.ts","sourceRoot":"","sources":["../../src/adapt/model-route.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,2EAA2E;AAC3E,eAAO,MAAM,iCAAiC;;;;CAIpC,CAAC;AAEX,oEAAoE;AACpE,eAAO,MAAM,4BAA4B,EAAE,cAG1C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,CAAC,EAAE,cAAc,GAAG,IAAI,GAC5B;IACD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAKA;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAE9D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE;YAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CACjG,GAAG,cAAc,GAAG,SAAS,CAM7B"}
+{"version":3,"file":"model-route.d.ts","sourceRoot":"","sources":["../../src/adapt/model-route.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,2EAA2E;AAC3E,eAAO,MAAM,iCAAiC;;;;CAIpC,CAAC;AAEX,oEAAoE;AACpE,eAAO,MAAM,4BAA4B,EAAE,cAG1C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,CAAC,EAAE,cAAc,GAAG,IAAI,GAC5B;IACD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAKA;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAE9D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE;QAChB,QAAQ,CAAC,MAAM,CAAC,EAAE;YAChB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;YAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YACxB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;SACnC,CAAC;KACH,CAAC;CACH,GAAG,cAAc,GAAG,SAAS,CAM7B;AAED,8EAA8E;AAC9E,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC,EAAE,GAC9D,CAAC,cAAc,GAAG;IAAE,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAa7D"}

package/node_modules/@xrkseek/server-face/dist/adapt/model-route.js

@@ -37,4 +37,20 @@ export function routeFromRequestHeader(event) {
         return undefined;
     return { provider, model };
 }
+/** Latest `request/header` route in a log prefix (ignores live Face maps). */
+export function lastRequestHeaderSelection(events) {
+    let last;
+    for (const event of events) {
+        const route = routeFromRequestHeader(event);
+        if (!route)
+            continue;
+        const effort = event.header?.config?.reasoningEffort?.trim();
+        last = {
+            provider: route.provider,
+            model: route.model,
+            ...(effort ? { reasoningEffort: effort } : {}),
+        };
+    }
+    return last;
+}
 //# sourceMappingURL=model-route.js.map

package/node_modules/@xrkseek/server-face/dist/adapt/model-route.js.map

@@ -1 +1 @@
-{"version":3,"file":"model-route.js","sourceRoot":"","sources":["../../src/adapt/model-route.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,2EAA2E;AAC3E,MAAM,CAAC,MAAM,iCAAiC,GAAG;IAC/C,IAAI,EAAE,OAAO;IACb,QAAQ,EAAE,KAAK;IACf,KAAK,EAAE,SAAS;CACR,CAAC;AAEX,oEAAoE;AACpE,MAAM,CAAC,MAAM,4BAA4B,GAAmB;IAC1D,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,SAAS;CACjB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAA6B;IAM7B,MAAM,QAAQ,GAAG,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,GAAG,iCAAiC,EAAE,CAAC;IACzE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC5C,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,gBAAgB,CAAC,KAAqB;IACpD,OAAO,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAGtC;IACC,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB;QAAE,OAAO,SAAS,CAAC;IACtD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACxD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAClD,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"model-route.js","sourceRoot":"","sources":["../../src/adapt/model-route.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,2EAA2E;AAC3E,MAAM,CAAC,MAAM,iCAAiC,GAAG;IAC/C,IAAI,EAAE,OAAO;IACb,QAAQ,EAAE,KAAK;IACf,KAAK,EAAE,SAAS;CACR,CAAC;AAEX,oEAAoE;AACpE,MAAM,CAAC,MAAM,4BAA4B,GAAmB;IAC1D,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,SAAS;CACjB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAA6B;IAM7B,MAAM,QAAQ,GAAG,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,GAAG,iCAAiC,EAAE,CAAC;IACzE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC5C,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,gBAAgB,CAAC,KAAqB;IACpD,OAAO,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAStC;IACC,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB;QAAE,OAAO,SAAS,CAAC;IACtD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACxD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAClD,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,0BAA0B,CACxC,MAA+D;IAE/D,IAAI,IAAiE,CAAC;IACtE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;QAC7D,IAAI,GAAG;YACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/C,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/node_modules/@xrkseek/server-face/dist/adapt/subagent-notice.d.ts

@@ -11,6 +11,38 @@ import type { FaceSubagentLink } from "../subagent-registry.js";
 export declare function lastAssistantBodyText(events: readonly SessionEvent[]): string;
 /** Latest `turn/end.reason` on the child log (undefined when still open). */
 export declare function lastTurnEndReason(events: readonly SessionEvent[]): TurnEndReason | undefined;
+/**
+ * What the child's model request was doing when the parent gave up: mid
+ * provider retry (attempt n/max, code, backoff) or nothing at all. A parent
+ * reading only "timed out" cannot tell a rate-limited child from one wedged
+ * on a tool, and answers them differently. Undefined once the retry wait
+ * already elapsed — that is a completed retry, not a diagnosis.
+ */
+export declare function lastModelRetryNotice(events: readonly SessionEvent[]): string | undefined;
+export type ChildOutcomeKind = TurnEndReason["kind"] | "none";
+export type ChildAbortCause = "user" | "parent" | "disposed" | "hook" | "legacy";
+export interface ChildOutcome {
+    readonly kind: ChildOutcomeKind;
+    /** Set only for `kind: "aborted"` — who cut the turn off. */
+    readonly cause?: ChildAbortCause;
+    /** Ms since the child's last event; undefined for a session with no log. */
+    readonly quietMs?: number;
+}
+/**
+ * How a child's last turn ended, structurally. One source for both consumers:
+ * the model-facing `list_agents` row (see {@link formatChildOutcome}) and the
+ * catalog RPC the client renders.
+ */
+export declare function describeChildOutcome(events: readonly SessionEvent[], now?: number): ChildOutcome;
+/**
+ * How a child's last turn actually ended, plus how long it has been quiet.
+ *
+ * `activity: idle` alone cannot tell a finished child from one the parent's
+ * wait budget cut off — both read as "inactive" in the roster, so a parent
+ * reviewing its own tree reads a kill as a completion.
+ */
+export declare function formatDescribedChildOutcome(outcome: ChildOutcome): string;
+export declare function formatChildOutcome(events: readonly SessionEvent[], now?: number): string;
 /**
  * Parent inbox notice when a background (continuable) child drain goes idle.
  * Normal idle → "finished a turn". Abnormal `turn/end` (abort / error / …)

package/node_modules/@xrkseek/server-face/dist/adapt/subagent-notice.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-notice.d.ts","sourceRoot":"","sources":["../../src/adapt/subagent-notice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,YAAY,EAAE,GAC9B,MAAM,CAyBR;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,YAAY,EAAE,GAC9B,aAAa,GAAG,SAAS,CAM3B;AAmBD;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAaR"}
+{"version":3,"file":"subagent-notice.d.ts","sourceRoot":"","sources":["../../src/adapt/subagent-notice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,YAAY,EAAE,GAC9B,MAAM,CAyBR;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,YAAY,EAAE,GAC9B,aAAa,GAAG,SAAS,CAM3B;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,YAAY,EAAE,GAC9B,MAAM,GAAG,SAAS,CAkBpB;AAmBD,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;AAC9D,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,QAAQ,GACR,UAAU,GACV,MAAM,GACN,QAAQ,CAAC;AAEb,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC;IACjC,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,GAAG,GAAE,MAAmB,GACvB,YAAY,CAqBd;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAuBzE;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,GAAG,GAAE,MAAmB,GACvB,MAAM,CAER;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAaR"}

package/node_modules/@xrkseek/server-face/dist/adapt/subagent-notice.js

@@ -45,6 +45,34 @@ export function lastTurnEndReason(events) {
     }
     return undefined;
 }
+/**
+ * What the child's model request was doing when the parent gave up: mid
+ * provider retry (attempt n/max, code, backoff) or nothing at all. A parent
+ * reading only "timed out" cannot tell a rate-limited child from one wedged
+ * on a tool, and answers them differently. Undefined once the retry wait
+ * already elapsed — that is a completed retry, not a diagnosis.
+ */
+export function lastModelRetryNotice(events) {
+    for (let i = events.length - 1; i >= 0; i -= 1) {
+        const ev = events[i];
+        if (ev.type === "llm/retry-started")
+            return undefined;
+        if (ev.type !== "llm/retry")
+            continue;
+        const budget = ev.maxRetries !== undefined
+            ? `${ev.retry}/${ev.maxRetries}`
+            : `${ev.retry}`;
+        const status = ev.failure.status !== undefined
+            ? ` status ${ev.failure.status}`
+            : "";
+        const wait = Math.round(ev.delayMs / 1000);
+        const head = `Child was mid model-retry: attempt ${budget} (${ev.failure.code}${status})`;
+        const via = ev.provider !== undefined ? ` via ${ev.provider}` : "";
+        const backoff = wait >= 1 ? `, ${wait}s backoff` : `, ${ev.delayMs}ms backoff`;
+        return `${head}${via}${backoff}.`;
+    }
+    return undefined;
+}
 function abnormalHeadDetail(reason) {
     if (reason.kind === "aborted") {
         const cause = reason.reason;
@@ -70,6 +98,65 @@ function abnormalHeadDetail(reason) {
         return "blocked";
     return undefined;
 }
+/**
+ * How a child's last turn ended, structurally. One source for both consumers:
+ * the model-facing `list_agents` row (see {@link formatChildOutcome}) and the
+ * catalog RPC the client renders.
+ */
+export function describeChildOutcome(events, now = Date.now()) {
+    const last = events[events.length - 1];
+    const quietMs = last ? Math.max(0, now - last.ts) : undefined;
+    const quiet = quietMs !== undefined ? { quietMs } : {};
+    const reason = lastTurnEndReason(events);
+    if (reason === undefined)
+        return { kind: "none", ...quiet };
+    if (reason.kind === "aborted") {
+        const cause = reason.reason;
+        return {
+            kind: "aborted",
+            cause: cause.kind === "user" ||
+                cause.kind === "parent" ||
+                cause.kind === "disposed" ||
+                cause.kind === "hook"
+                ? cause.kind
+                : "legacy",
+            ...quiet,
+        };
+    }
+    return { kind: reason.kind, ...quiet };
+}
+/**
+ * How a child's last turn actually ended, plus how long it has been quiet.
+ *
+ * `activity: idle` alone cannot tell a finished child from one the parent's
+ * wait budget cut off — both read as "inactive" in the roster, so a parent
+ * reviewing its own tree reads a kill as a completion.
+ */
+export function formatDescribedChildOutcome(outcome) {
+    const { kind, cause, quietMs } = outcome;
+    const verdict = kind === "none"
+        ? "turn still open"
+        : kind === "aborted"
+            ? `aborted ${cause === "parent" ? "by parent" : cause === "user" ? "by user" : cause === "disposed" ? "(session disposed)" : cause === "hook" ? "(by hook)" : "(unknown source)"}`
+            : kind === "completed"
+                ? "finished"
+                : kind === "error"
+                    ? "ended with error"
+                    : kind === "interrupted"
+                        ? "interrupted mid-turn"
+                        : kind === "max-tokens"
+                            ? "stopped at max tokens"
+                            : "blocked";
+    const quiet = quietMs === undefined
+        ? "no events"
+        : quietMs < 90_000
+            ? `${Math.round(quietMs / 1000)}s ago`
+            : `${Math.round(quietMs / 60_000)}m ago`;
+    return `${verdict} · last event ${quiet}`;
+}
+export function formatChildOutcome(events, now = Date.now()) {
+    return formatDescribedChildOutcome(describeChildOutcome(events, now));
+}
 /**
  * Parent inbox notice when a background (continuable) child drain goes idle.
  * Normal idle → "finished a turn". Abnormal `turn/end` (abort / error / …)

package/node_modules/@xrkseek/server-face/dist/adapt/subagent-notice.js.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-notice.js","sourceRoot":"","sources":["../../src/adapt/subagent-notice.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"subagent-notice.js","sourceRoot":"","sources":["../../src/adapt/subagent-notice.ts"],"names":[],"mappings":"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"}

package/node_modules/@xrkseek/server-face/dist/agent-roster-store.d.ts

@@ -0,0 +1,102 @@
+import { type AgentTeamSpawnRole } from "./agent-team-roles.js";
+export declare const MEMBER_NAME_MAX = 40;
+export declare const MEMBER_PLAYBOOK_MAX = 8000;
+export declare const MEMBER_FACE_MAX = 80000;
+export declare const MEMBER_BRIEF_MAX = 160;
+export declare const GLOBAL_ROSTER_ID = "global";
+export declare const MEMBER_SHAPES: readonly ["blob", "wedge", "gem", "squircle", "drop", "pill", "petal", "loaf", "heart", "star", "hex", "egg", "cloud", "shield"];
+export declare const MEMBER_COLORS: readonly ["cream", "mist", "peach", "sage", "lilac", "slate", "coral", "butter", "mint", "sky", "rose", "cocoa", "honey", "ocean", "grape", "blush", "sand", "ink", "ice", "matcha"];
+export declare const MEMBER_KITS: readonly ["none", "bow", "cap", "beanie", "visor", "specs", "specs-rect", "specs-cat", "specs-sun", "halo"];
+export type MemberShape = (typeof MEMBER_SHAPES)[number];
+export type MemberColor = (typeof MEMBER_COLORS)[number];
+export type MemberKit = (typeof MEMBER_KITS)[number];
+export type RosterScope = "global" | "workspace";
+export type MemberInject = "subagent" | "minimal";
+export interface MemberAppearance {
+    readonly shape: MemberShape;
+    readonly color: MemberColor;
+    /** Optional overlay kit (`none` omitted). Face sticker is separate. */
+    readonly kit?: Exclude<MemberKit, "none">;
+    /** Optional `data:image/...;base64,...` face sticker. */
+    readonly face?: string;
+}
+export interface MemberToolPolicy {
+    readonly mode: "allow" | "deny";
+    readonly names: readonly string[];
+}
+export interface AgentRosterMember {
+    readonly id: string;
+    readonly name: string;
+    readonly playbook: string;
+    readonly role: AgentTeamSpawnRole;
+    readonly appearance: MemberAppearance;
+    readonly brief: string;
+    readonly inject: MemberInject;
+    readonly tools?: MemberToolPolicy;
+    /** True for catalog examples that ship with the file. */
+    readonly seed?: true;
+    readonly updatedAt: number;
+}
+export type ListedRosterMember = AgentRosterMember & {
+    readonly scope: RosterScope;
+};
+/** Default allow-list for a file-only 干员 (release / inspect). */
+export declare const MEMBER_FILE_TOOLS: readonly ["bash", "read", "grep", "glob"];
+export declare function parseRosterScope(raw: unknown): RosterScope;
+export declare function rosterRoot(productHome?: string): string;
+export declare function parseMemberAppearance(raw: unknown, fallback: MemberAppearance): MemberAppearance;
+export declare function parseMemberToolPolicy(raw: unknown): MemberToolPolicy | undefined;
+export declare function parseMemberInject(raw: unknown, fallback: MemberInject): MemberInject;
+/** Deny-only: a 干员 may weaken the parent preset, never add tools. */
+export declare function applyRosterToolPolicy(tools: {
+    list(): readonly {
+        readonly name: string;
+    }[];
+    unregister(name: string): boolean;
+}, role: AgentTeamSpawnRole | undefined, policy?: MemberToolPolicy): void;
+export declare function rosterPublicFields(row: ListedRosterMember): {
+    tools?: MemberToolPolicy;
+    id: string;
+    name: string;
+    role: AgentTeamSpawnRole;
+    scope: RosterScope;
+    brief: string;
+    inject: MemberInject;
+    seed: boolean;
+    appearance: MemberAppearance;
+};
+export declare function formatRosterCatalog(members: readonly ListedRosterMember[]): string;
+export declare function mergeGlobalSeedMembers(existing: readonly AgentRosterMember[], now?: number): {
+    readonly members: AgentRosterMember[];
+    readonly changed: boolean;
+};
+export declare function seedGlobalRosterMembers(now?: number): readonly AgentRosterMember[];
+export declare class FaceAgentRosterStore {
+    private readonly productHome;
+    private readonly cache;
+    constructor(productHome?: string);
+    private emptyOrSeed;
+    private load;
+    private save;
+    list(workspaceId: string): readonly AgentRosterMember[];
+    /** Global members first, then workspace; same id → workspace wins. */
+    listVisible(workspaceId: string): readonly ListedRosterMember[];
+    get(workspaceId: string, memberId: string): ListedRosterMember | undefined;
+    upsert(workspaceId: string, input: {
+        readonly id?: string;
+        readonly name: string;
+        readonly playbook: string;
+        readonly role?: AgentTeamSpawnRole;
+        readonly appearance?: Partial<MemberAppearance> | null;
+        readonly brief?: string;
+        readonly inject?: MemberInject;
+        readonly tools?: MemberToolPolicy | null;
+    }): AgentRosterMember | undefined;
+    /**
+     * Write into global.json or the canvas file. Promoting to global drops a
+     * same-id workspace overlay so the global record is visible again.
+     */
+    upsertAtScope(canvasWorkspaceId: string, scope: RosterScope, input: Parameters<FaceAgentRosterStore["upsert"]>[1]): AgentRosterMember | undefined;
+    remove(workspaceId: string, memberId: string): boolean;
+}
+//# sourceMappingURL=agent-roster-store.d.ts.map

package/node_modules/@xrkseek/server-face/dist/agent-roster-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-roster-store.d.ts","sourceRoot":"","sources":["../src/agent-roster-store.ts"],"names":[],"mappings":"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"}