@scotthuang/agent-knock-knock 0.13.2 → 0.13.4

package/dist/src/openclaw-plugin-value-helpers.d.ts

@@ -0,0 +1,2 @@
+/** @deprecated OpenClaw compatibility facade; use semantic-tool-value-helpers. */
+export * from "./semantic-tool-value-helpers.js";

package/dist/src/openclaw-plugin-value-helpers.js

@@ -0,0 +1,3 @@
+/** @deprecated OpenClaw compatibility facade; use semantic-tool-value-helpers. */
+export * from "./semantic-tool-value-helpers.js";
+//# sourceMappingURL=openclaw-plugin-value-helpers.js.map

package/dist/src/openclaw-plugin-value-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-plugin-value-helpers.js","sourceRoot":"","sources":["../../src/openclaw-plugin-value-helpers.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,cAAc,kCAAkC,CAAC"}

package/dist/src/openclaw-private-authority-offers.d.ts

@@ -1,41 +1,6 @@
-export declare const OPENCLAW_PRIVATE_AUTHORITY_OFFER_TTL_MS: number;
-export declare const OPENCLAW_PRIVATE_AUTHORITY_OFFER_LIMIT = 512;
-export declare const OPENCLAW_APPROVAL_AUTHORITY_KIND = "approval";
-export declare const OPENCLAW_INTERACTION_AUTHORITY_KIND = "interaction";
-export declare const OPENCLAW_INTERACTION_AUTHORITY_SUBJECT_KINDS: readonly ["managed_turn", "terminal_watch"];
-export type OpenClawInteractionAuthoritySubjectKind = typeof OPENCLAW_INTERACTION_AUTHORITY_SUBJECT_KINDS[number];
-export interface OpenClawPrivateAuthorityTarget {
-    type: string;
-    id: string;
-}
-export interface OpenClawPrivateAuthorityOfferKey {
-    sessionKey: string;
-    sessionId: string;
-    kind: string;
-    target: OpenClawPrivateAuthorityTarget;
-}
-export interface OpenClawPrivateAuthorityOfferPayload extends Readonly<Record<string, unknown>> {
-    readonly args?: Readonly<Record<string, unknown>>;
-    readonly fingerprint?: string;
-    readonly invalidated?: boolean;
-}
-export declare function openClawApprovalAuthorityOfferKey(sessionKey: string, sessionId: string, target: OpenClawPrivateAuthorityTarget): OpenClawPrivateAuthorityOfferKey;
 /**
- * Legacy managed-Turn overload retained while callers migrate to the explicit
- * subject-aware form below.
+ * OpenClaw compatibility names for the Host-neutral private authority store.
+ * New core code must import semantic-private-authority-offers directly.
  */
-export declare function openClawInteractionAuthorityOfferKey(sessionKey: string, sessionId: string, turnId: string, interactionId: string): OpenClawPrivateAuthorityOfferKey;
-export declare function openClawInteractionAuthorityOfferKey(sessionKey: string, sessionId: string, subjectKind: OpenClawInteractionAuthoritySubjectKind, subjectId: string, interactionId: string): OpenClawPrivateAuthorityOfferKey;
-export declare function openClawManagedTurnInteractionAuthorityOfferKey(sessionKey: string, sessionId: string, turnId: string, interactionId: string): OpenClawPrivateAuthorityOfferKey;
-export declare function openClawTerminalWatchInteractionAuthorityOfferKey(sessionKey: string, sessionId: string, watchId: string, interactionId: string): OpenClawPrivateAuthorityOfferKey;
-/**
- * Invalidates every interaction response offer previously displayed for one
- * exact subject in one exact controller conversation. Status uses this as a
- * refresh boundary before it publishes at most one offer from the new
- * snapshot, so an old interaction id cannot remain actionable for the rest of
- * its TTL after the terminal UI disappears or changes.
- */
-export declare function invalidateOpenClawInteractionAuthorityOffersForSubject(api: object, sessionKey: string, sessionId: string, subjectKind: OpenClawInteractionAuthoritySubjectKind, subjectId: string, nowMs?: number): number;
-export declare function rememberOpenClawPrivateAuthorityOffer(api: object, key: OpenClawPrivateAuthorityOfferKey, payload: Record<string, unknown>, nowMs?: number): void;
-export declare function peekOpenClawPrivateAuthorityOffer<Payload extends OpenClawPrivateAuthorityOfferPayload = OpenClawPrivateAuthorityOfferPayload>(api: object, key: OpenClawPrivateAuthorityOfferKey, nowMs?: number): Payload | undefined;
-export declare function consumeOpenClawPrivateAuthorityOffer<Payload extends OpenClawPrivateAuthorityOfferPayload = OpenClawPrivateAuthorityOfferPayload>(api: object, key: OpenClawPrivateAuthorityOfferKey, nowMs?: number): Payload | undefined;
+export { SEMANTIC_APPROVAL_AUTHORITY_KIND as OPENCLAW_APPROVAL_AUTHORITY_KIND, SEMANTIC_INTERACTION_AUTHORITY_KIND as OPENCLAW_INTERACTION_AUTHORITY_KIND, SEMANTIC_INTERACTION_AUTHORITY_SUBJECT_KINDS as OPENCLAW_INTERACTION_AUTHORITY_SUBJECT_KINDS, SEMANTIC_PRIVATE_AUTHORITY_OFFER_LIMIT as OPENCLAW_PRIVATE_AUTHORITY_OFFER_LIMIT, SEMANTIC_PRIVATE_AUTHORITY_OFFER_TTL_MS as OPENCLAW_PRIVATE_AUTHORITY_OFFER_TTL_MS, consumeSemanticPrivateAuthorityOffer as consumeOpenClawPrivateAuthorityOffer, invalidateSemanticInteractionAuthorityOffersForSubject as invalidateOpenClawInteractionAuthorityOffersForSubject, peekSemanticPrivateAuthorityOffer as peekOpenClawPrivateAuthorityOffer, rememberSemanticPrivateAuthorityOffer as rememberOpenClawPrivateAuthorityOffer, semanticApprovalAuthorityOfferKey as openClawApprovalAuthorityOfferKey, semanticInteractionAuthorityOfferKey as openClawInteractionAuthorityOfferKey, semanticManagedTurnInteractionAuthorityOfferKey as openClawManagedTurnInteractionAuthorityOfferKey, semanticTerminalWatchInteractionAuthorityOfferKey as openClawTerminalWatchInteractionAuthorityOfferKey } from "./semantic-private-authority-offers.js";
+export type { SemanticInteractionAuthoritySubjectKind as OpenClawInteractionAuthoritySubjectKind, SemanticPrivateAuthorityOfferKey as OpenClawPrivateAuthorityOfferKey, SemanticPrivateAuthorityOfferPayload as OpenClawPrivateAuthorityOfferPayload, SemanticPrivateAuthorityTarget as OpenClawPrivateAuthorityTarget } from "./semantic-private-authority-offers.js";

package/dist/src/openclaw-private-authority-offers.js

@@ -1,261 +1,6 @@
-export const OPENCLAW_PRIVATE_AUTHORITY_OFFER_TTL_MS = 10 * 60 * 1000;
-export const OPENCLAW_PRIVATE_AUTHORITY_OFFER_LIMIT = 512;
-export const OPENCLAW_APPROVAL_AUTHORITY_KIND = "approval";
-export const OPENCLAW_INTERACTION_AUTHORITY_KIND = "interaction";
-export const OPENCLAW_INTERACTION_AUTHORITY_SUBJECT_KINDS = [
-    "managed_turn",
-    "terminal_watch"
-];
-const storesByApi = new WeakMap();
-export function openClawApprovalAuthorityOfferKey(sessionKey, sessionId, target) {
-    return {
-        sessionKey,
-        sessionId,
-        kind: OPENCLAW_APPROVAL_AUTHORITY_KIND,
-        target
-    };
-}
-export function openClawInteractionAuthorityOfferKey(sessionKey, sessionId, subjectKindOrTurnId, subjectIdOrInteractionId, explicitInteractionId) {
-    const legacyManagedTurn = explicitInteractionId === undefined;
-    const subjectKind = legacyManagedTurn
-        ? "managed_turn"
-        : interactionAuthoritySubjectKind(subjectKindOrTurnId);
-    const subjectId = exactNonBlank(legacyManagedTurn ? subjectKindOrTurnId : subjectIdOrInteractionId, "interaction subject id");
-    const interactionId = exactNonBlank(legacyManagedTurn ? subjectIdOrInteractionId : explicitInteractionId, "interaction id");
-    return {
-        sessionKey,
-        sessionId,
-        kind: OPENCLAW_INTERACTION_AUTHORITY_KIND,
-        target: {
-            type: "interaction_subject",
-            id: JSON.stringify([subjectKind, subjectId, interactionId])
-        }
-    };
-}
-export function openClawManagedTurnInteractionAuthorityOfferKey(sessionKey, sessionId, turnId, interactionId) {
-    return openClawInteractionAuthorityOfferKey(sessionKey, sessionId, "managed_turn", turnId, interactionId);
-}
-export function openClawTerminalWatchInteractionAuthorityOfferKey(sessionKey, sessionId, watchId, interactionId) {
-    return openClawInteractionAuthorityOfferKey(sessionKey, sessionId, "terminal_watch", watchId, interactionId);
-}
 /**
- * Invalidates every interaction response offer previously displayed for one
- * exact subject in one exact controller conversation. Status uses this as a
- * refresh boundary before it publishes at most one offer from the new
- * snapshot, so an old interaction id cannot remain actionable for the rest of
- * its TTL after the terminal UI disappears or changes.
+ * OpenClaw compatibility names for the Host-neutral private authority store.
+ * New core code must import semantic-private-authority-offers directly.
  */
-export function invalidateOpenClawInteractionAuthorityOffersForSubject(api, sessionKey, sessionId, subjectKind, subjectId, nowMs = Date.now()) {
-    const exactApi = assertApi(api);
-    const exactSessionKey = exactNonBlank(sessionKey, "sessionKey");
-    const exactSessionId = exactNonBlank(sessionId, "sessionId");
-    const exactSubjectKind = interactionAuthoritySubjectKind(subjectKind);
-    const exactSubjectId = exactNonBlank(subjectId, "interaction subject id");
-    assertNow(nowMs);
-    const store = storesByApi.get(exactApi);
-    if (!store)
-        return 0;
-    pruneExpiredOffers(store, nowMs);
-    let invalidated = 0;
-    for (const normalizedKey of store.entries.keys()) {
-        if (normalizedInteractionOfferMatchesSubject(normalizedKey, exactSessionKey, exactSessionId, exactSubjectKind, exactSubjectId)) {
-            store.entries.delete(normalizedKey);
-            invalidated += 1;
-        }
-    }
-    return invalidated;
-}
-export function rememberOpenClawPrivateAuthorityOffer(api, key, payload, nowMs = Date.now()) {
-    const normalizedKey = privateAuthorityOfferKey(key);
-    const store = privateAuthorityOfferStore(api);
-    assertNow(nowMs);
-    pruneExpiredOffers(store, nowMs);
-    const previous = store.entries.get(normalizedKey)?.payload;
-    const authorityChanged = privateAuthorityPayloadChanged(previous, payload);
-    const merged = mergePrivateAuthorityPayload(previous, payload);
-    const invalidated = authorityChanged || (previous?.invalidated === true);
-    const storedPayload = {
-        ...merged,
-        ...(invalidated ? { invalidated: true } : {})
-    };
-    if (!invalidated)
-        delete storedPayload.invalidated;
-    store.entries.delete(normalizedKey);
-    while (store.entries.size >= OPENCLAW_PRIVATE_AUTHORITY_OFFER_LIMIT) {
-        const oldest = store.entries.keys().next().value;
-        if (typeof oldest !== "string")
-            break;
-        store.entries.delete(oldest);
-    }
-    store.entries.set(normalizedKey, {
-        expiresAtMs: nowMs + OPENCLAW_PRIVATE_AUTHORITY_OFFER_TTL_MS,
-        payload: cloneAndFreezePayload(storedPayload)
-    });
-}
-export function peekOpenClawPrivateAuthorityOffer(api, key, nowMs = Date.now()) {
-    return readPrivateAuthorityOffer(api, key, false, nowMs);
-}
-export function consumeOpenClawPrivateAuthorityOffer(api, key, nowMs = Date.now()) {
-    return readPrivateAuthorityOffer(api, key, true, nowMs);
-}
-function readPrivateAuthorityOffer(api, key, consume, nowMs) {
-    assertNow(nowMs);
-    const store = storesByApi.get(assertApi(api));
-    if (!store)
-        return undefined;
-    const normalizedKey = privateAuthorityOfferKey(key);
-    const offer = store.entries.get(normalizedKey);
-    if (!offer) {
-        pruneExpiredOffers(store, nowMs);
-        return undefined;
-    }
-    if (offer.expiresAtMs <= nowMs) {
-        store.entries.delete(normalizedKey);
-        pruneExpiredOffers(store, nowMs);
-        return undefined;
-    }
-    if (offer.payload.invalidated === true) {
-        if (consume)
-            store.entries.delete(normalizedKey);
-        return undefined;
-    }
-    if (consume)
-        store.entries.delete(normalizedKey);
-    return offer.payload;
-}
-function privateAuthorityOfferStore(api) {
-    const exactApi = assertApi(api);
-    const existing = storesByApi.get(exactApi);
-    if (existing)
-        return existing;
-    const created = { entries: new Map() };
-    storesByApi.set(exactApi, created);
-    return created;
-}
-function privateAuthorityOfferKey(key) {
-    const sessionKey = exactNonBlank(key?.sessionKey, "sessionKey");
-    const sessionId = exactNonBlank(key?.sessionId, "sessionId");
-    const kind = exactIdentifier(key?.kind, "kind");
-    const targetType = exactIdentifier(key?.target?.type, "target.type");
-    const targetId = exactNonBlank(key?.target?.id, "target.id");
-    return JSON.stringify([sessionKey, sessionId, kind, targetType, targetId]);
-}
-function normalizedInteractionOfferMatchesSubject(normalizedKey, sessionKey, sessionId, subjectKind, subjectId) {
-    try {
-        const key = JSON.parse(normalizedKey);
-        if (!Array.isArray(key) ||
-            key.length !== 5 ||
-            key[0] !== sessionKey ||
-            key[1] !== sessionId ||
-            key[2] !== OPENCLAW_INTERACTION_AUTHORITY_KIND ||
-            key[3] !== "interaction_subject" ||
-            typeof key[4] !== "string") {
-            return false;
-        }
-        const target = JSON.parse(key[4]);
-        return Array.isArray(target) &&
-            target.length === 3 &&
-            target[0] === subjectKind &&
-            target[1] === subjectId &&
-            typeof target[2] === "string";
-    }
-    catch {
-        return false;
-    }
-}
-function exactIdentifier(value, label) {
-    const text = exactNonBlank(value, label);
-    if (!/^[a-z][a-z0-9_.-]{0,63}$/u.test(text)) {
-        throw new Error(`private authority offer ${label} is invalid`);
-    }
-    return text;
-}
-function interactionAuthoritySubjectKind(value) {
-    if (!OPENCLAW_INTERACTION_AUTHORITY_SUBJECT_KINDS.includes(value)) {
-        throw new Error("private authority offer interaction subject kind is invalid");
-    }
-    return value;
-}
-function exactNonBlank(value, label) {
-    if (typeof value !== "string" ||
-        value.length === 0 ||
-        value.trim() !== value) {
-        throw new Error(`private authority offer ${label} must be exact and non-empty`);
-    }
-    return value;
-}
-function assertApi(api) {
-    if ((typeof api !== "object" || api === null) && typeof api !== "function") {
-        throw new Error("private authority offer api must be an object");
-    }
-    return api;
-}
-function assertNow(nowMs) {
-    if (!Number.isFinite(nowMs)) {
-        throw new Error("private authority offer clock must be finite");
-    }
-}
-function pruneExpiredOffers(store, nowMs) {
-    for (const [key, offer] of store.entries) {
-        if (offer.expiresAtMs <= nowMs)
-            store.entries.delete(key);
-    }
-}
-function cloneAndFreezePayload(payload) {
-    if (typeof payload !== "object" || payload === null || Array.isArray(payload)) {
-        throw new Error("private authority offer payload must be an object");
-    }
-    let cloned;
-    try {
-        cloned = structuredClone(payload);
-    }
-    catch {
-        throw new Error("private authority offer payload must be structured-cloneable");
-    }
-    return deepFreeze(cloned, new WeakSet());
-}
-function mergePrivateAuthorityPayload(previous, update) {
-    const definedUpdate = Object.fromEntries(Object.entries(update).filter(([, value]) => value !== undefined));
-    const previousArgs = isPlainRecord(previous?.args) ? previous.args : {};
-    const updateArgs = isPlainRecord(definedUpdate.args)
-        ? definedUpdate.args
-        : undefined;
-    return {
-        ...(previous ?? {}),
-        ...definedUpdate,
-        ...(updateArgs
-            ? { args: { ...previousArgs, ...updateArgs } }
-            : Object.keys(previousArgs).length > 0
-                ? { args: previousArgs }
-                : {})
-    };
-}
-function privateAuthorityPayloadChanged(previous, update) {
-    if (!previous)
-        return false;
-    const nextFingerprint = update.fingerprint;
-    if (nextFingerprint !== undefined &&
-        previous.fingerprint !== undefined &&
-        nextFingerprint !== previous.fingerprint) {
-        return true;
-    }
-    const previousArgs = isPlainRecord(previous.args) ? previous.args : {};
-    const updateArgs = isPlainRecord(update.args) ? update.args : undefined;
-    if (!updateArgs)
-        return false;
-    return Object.keys(previousArgs).length > 0 &&
-        JSON.stringify(previousArgs) !== JSON.stringify(updateArgs);
-}
-function isPlainRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function deepFreeze(value, seen) {
-    if (typeof value !== "object" || value === null || seen.has(value)) {
-        return value;
-    }
-    seen.add(value);
-    for (const nested of Object.values(value))
-        deepFreeze(nested, seen);
-    return Object.freeze(value);
-}
+export { SEMANTIC_APPROVAL_AUTHORITY_KIND as OPENCLAW_APPROVAL_AUTHORITY_KIND, SEMANTIC_INTERACTION_AUTHORITY_KIND as OPENCLAW_INTERACTION_AUTHORITY_KIND, SEMANTIC_INTERACTION_AUTHORITY_SUBJECT_KINDS as OPENCLAW_INTERACTION_AUTHORITY_SUBJECT_KINDS, SEMANTIC_PRIVATE_AUTHORITY_OFFER_LIMIT as OPENCLAW_PRIVATE_AUTHORITY_OFFER_LIMIT, SEMANTIC_PRIVATE_AUTHORITY_OFFER_TTL_MS as OPENCLAW_PRIVATE_AUTHORITY_OFFER_TTL_MS, consumeSemanticPrivateAuthorityOffer as consumeOpenClawPrivateAuthorityOffer, invalidateSemanticInteractionAuthorityOffersForSubject as invalidateOpenClawInteractionAuthorityOffersForSubject, peekSemanticPrivateAuthorityOffer as peekOpenClawPrivateAuthorityOffer, rememberSemanticPrivateAuthorityOffer as rememberOpenClawPrivateAuthorityOffer, semanticApprovalAuthorityOfferKey as openClawApprovalAuthorityOfferKey, semanticInteractionAuthorityOfferKey as openClawInteractionAuthorityOfferKey, semanticManagedTurnInteractionAuthorityOfferKey as openClawManagedTurnInteractionAuthorityOfferKey, semanticTerminalWatchInteractionAuthorityOfferKey as openClawTerminalWatchInteractionAuthorityOfferKey } from "./semantic-private-authority-offers.js";
 //# sourceMappingURL=openclaw-private-authority-offers.js.map

package/dist/src/openclaw-private-authority-offers.js.map

@@ -1 +1 @@
-{"version":3,"file":"openclaw-private-authority-offers.js","sourceRoot":"","sources":["../../src/openclaw-private-authority-offers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"openclaw-private-authority-offers.js","sourceRoot":"","sources":["../../src/openclaw-private-authority-offers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,gCAAgC,IAAI,gCAAgC,EACpE,mCAAmC,IAAI,mCAAmC,EAC1E,4CAA4C,IAAI,4CAA4C,EAC5F,sCAAsC,IAAI,sCAAsC,EAChF,uCAAuC,IAAI,uCAAuC,EAClF,oCAAoC,IAAI,oCAAoC,EAC5E,sDAAsD,IAAI,sDAAsD,EAChH,iCAAiC,IAAI,iCAAiC,EACtE,qCAAqC,IAAI,qCAAqC,EAC9E,iCAAiC,IAAI,iCAAiC,EACtE,oCAAoC,IAAI,oCAAoC,EAC5E,+CAA+C,IAAI,+CAA+C,EAClG,iDAAiD,IAAI,iDAAiD,EACvG,MAAM,wCAAwC,CAAC"}

package/dist/src/semantic-private-authority-offers.d.ts

@@ -0,0 +1,41 @@
+export declare const SEMANTIC_PRIVATE_AUTHORITY_OFFER_TTL_MS: number;
+export declare const SEMANTIC_PRIVATE_AUTHORITY_OFFER_LIMIT = 512;
+export declare const SEMANTIC_APPROVAL_AUTHORITY_KIND = "approval";
+export declare const SEMANTIC_INTERACTION_AUTHORITY_KIND = "interaction";
+export declare const SEMANTIC_INTERACTION_AUTHORITY_SUBJECT_KINDS: readonly ["managed_turn", "terminal_watch"];
+export type SemanticInteractionAuthoritySubjectKind = typeof SEMANTIC_INTERACTION_AUTHORITY_SUBJECT_KINDS[number];
+export interface SemanticPrivateAuthorityTarget {
+    type: string;
+    id: string;
+}
+export interface SemanticPrivateAuthorityOfferKey {
+    sessionKey: string;
+    sessionId: string;
+    kind: string;
+    target: SemanticPrivateAuthorityTarget;
+}
+export interface SemanticPrivateAuthorityOfferPayload extends Readonly<Record<string, unknown>> {
+    readonly args?: Readonly<Record<string, unknown>>;
+    readonly fingerprint?: string;
+    readonly invalidated?: boolean;
+}
+export declare function semanticApprovalAuthorityOfferKey(sessionKey: string, sessionId: string, target: SemanticPrivateAuthorityTarget): SemanticPrivateAuthorityOfferKey;
+/**
+ * Legacy managed-Turn overload retained while callers migrate to the explicit
+ * subject-aware form below.
+ */
+export declare function semanticInteractionAuthorityOfferKey(sessionKey: string, sessionId: string, turnId: string, interactionId: string): SemanticPrivateAuthorityOfferKey;
+export declare function semanticInteractionAuthorityOfferKey(sessionKey: string, sessionId: string, subjectKind: SemanticInteractionAuthoritySubjectKind, subjectId: string, interactionId: string): SemanticPrivateAuthorityOfferKey;
+export declare function semanticManagedTurnInteractionAuthorityOfferKey(sessionKey: string, sessionId: string, turnId: string, interactionId: string): SemanticPrivateAuthorityOfferKey;
+export declare function semanticTerminalWatchInteractionAuthorityOfferKey(sessionKey: string, sessionId: string, watchId: string, interactionId: string): SemanticPrivateAuthorityOfferKey;
+/**
+ * Invalidates every interaction response offer previously displayed for one
+ * exact subject in one exact controller conversation. Status uses this as a
+ * refresh boundary before it publishes at most one offer from the new
+ * snapshot, so an old interaction id cannot remain actionable for the rest of
+ * its TTL after the terminal UI disappears or changes.
+ */
+export declare function invalidateSemanticInteractionAuthorityOffersForSubject(api: object, sessionKey: string, sessionId: string, subjectKind: SemanticInteractionAuthoritySubjectKind, subjectId: string, nowMs?: number): number;
+export declare function rememberSemanticPrivateAuthorityOffer(api: object, key: SemanticPrivateAuthorityOfferKey, payload: Record<string, unknown>, nowMs?: number): void;
+export declare function peekSemanticPrivateAuthorityOffer<Payload extends SemanticPrivateAuthorityOfferPayload = SemanticPrivateAuthorityOfferPayload>(api: object, key: SemanticPrivateAuthorityOfferKey, nowMs?: number): Payload | undefined;
+export declare function consumeSemanticPrivateAuthorityOffer<Payload extends SemanticPrivateAuthorityOfferPayload = SemanticPrivateAuthorityOfferPayload>(api: object, key: SemanticPrivateAuthorityOfferKey, nowMs?: number): Payload | undefined;

package/dist/src/semantic-private-authority-offers.js

@@ -0,0 +1,261 @@
+export const SEMANTIC_PRIVATE_AUTHORITY_OFFER_TTL_MS = 10 * 60 * 1000;
+export const SEMANTIC_PRIVATE_AUTHORITY_OFFER_LIMIT = 512;
+export const SEMANTIC_APPROVAL_AUTHORITY_KIND = "approval";
+export const SEMANTIC_INTERACTION_AUTHORITY_KIND = "interaction";
+export const SEMANTIC_INTERACTION_AUTHORITY_SUBJECT_KINDS = [
+    "managed_turn",
+    "terminal_watch"
+];
+const storesByApi = new WeakMap();
+export function semanticApprovalAuthorityOfferKey(sessionKey, sessionId, target) {
+    return {
+        sessionKey,
+        sessionId,
+        kind: SEMANTIC_APPROVAL_AUTHORITY_KIND,
+        target
+    };
+}
+export function semanticInteractionAuthorityOfferKey(sessionKey, sessionId, subjectKindOrTurnId, subjectIdOrInteractionId, explicitInteractionId) {
+    const legacyManagedTurn = explicitInteractionId === undefined;
+    const subjectKind = legacyManagedTurn
+        ? "managed_turn"
+        : interactionAuthoritySubjectKind(subjectKindOrTurnId);
+    const subjectId = exactNonBlank(legacyManagedTurn ? subjectKindOrTurnId : subjectIdOrInteractionId, "interaction subject id");
+    const interactionId = exactNonBlank(legacyManagedTurn ? subjectIdOrInteractionId : explicitInteractionId, "interaction id");
+    return {
+        sessionKey,
+        sessionId,
+        kind: SEMANTIC_INTERACTION_AUTHORITY_KIND,
+        target: {
+            type: "interaction_subject",
+            id: JSON.stringify([subjectKind, subjectId, interactionId])
+        }
+    };
+}
+export function semanticManagedTurnInteractionAuthorityOfferKey(sessionKey, sessionId, turnId, interactionId) {
+    return semanticInteractionAuthorityOfferKey(sessionKey, sessionId, "managed_turn", turnId, interactionId);
+}
+export function semanticTerminalWatchInteractionAuthorityOfferKey(sessionKey, sessionId, watchId, interactionId) {
+    return semanticInteractionAuthorityOfferKey(sessionKey, sessionId, "terminal_watch", watchId, interactionId);
+}
+/**
+ * Invalidates every interaction response offer previously displayed for one
+ * exact subject in one exact controller conversation. Status uses this as a
+ * refresh boundary before it publishes at most one offer from the new
+ * snapshot, so an old interaction id cannot remain actionable for the rest of
+ * its TTL after the terminal UI disappears or changes.
+ */
+export function invalidateSemanticInteractionAuthorityOffersForSubject(api, sessionKey, sessionId, subjectKind, subjectId, nowMs = Date.now()) {
+    const exactApi = assertApi(api);
+    const exactSessionKey = exactNonBlank(sessionKey, "sessionKey");
+    const exactSessionId = exactNonBlank(sessionId, "sessionId");
+    const exactSubjectKind = interactionAuthoritySubjectKind(subjectKind);
+    const exactSubjectId = exactNonBlank(subjectId, "interaction subject id");
+    assertNow(nowMs);
+    const store = storesByApi.get(exactApi);
+    if (!store)
+        return 0;
+    pruneExpiredOffers(store, nowMs);
+    let invalidated = 0;
+    for (const normalizedKey of store.entries.keys()) {
+        if (normalizedInteractionOfferMatchesSubject(normalizedKey, exactSessionKey, exactSessionId, exactSubjectKind, exactSubjectId)) {
+            store.entries.delete(normalizedKey);
+            invalidated += 1;
+        }
+    }
+    return invalidated;
+}
+export function rememberSemanticPrivateAuthorityOffer(api, key, payload, nowMs = Date.now()) {
+    const normalizedKey = privateAuthorityOfferKey(key);
+    const store = privateAuthorityOfferStore(api);
+    assertNow(nowMs);
+    pruneExpiredOffers(store, nowMs);
+    const previous = store.entries.get(normalizedKey)?.payload;
+    const authorityChanged = privateAuthorityPayloadChanged(previous, payload);
+    const merged = mergePrivateAuthorityPayload(previous, payload);
+    const invalidated = authorityChanged || (previous?.invalidated === true);
+    const storedPayload = {
+        ...merged,
+        ...(invalidated ? { invalidated: true } : {})
+    };
+    if (!invalidated)
+        delete storedPayload.invalidated;
+    store.entries.delete(normalizedKey);
+    while (store.entries.size >= SEMANTIC_PRIVATE_AUTHORITY_OFFER_LIMIT) {
+        const oldest = store.entries.keys().next().value;
+        if (typeof oldest !== "string")
+            break;
+        store.entries.delete(oldest);
+    }
+    store.entries.set(normalizedKey, {
+        expiresAtMs: nowMs + SEMANTIC_PRIVATE_AUTHORITY_OFFER_TTL_MS,
+        payload: cloneAndFreezePayload(storedPayload)
+    });
+}
+export function peekSemanticPrivateAuthorityOffer(api, key, nowMs = Date.now()) {
+    return readPrivateAuthorityOffer(api, key, false, nowMs);
+}
+export function consumeSemanticPrivateAuthorityOffer(api, key, nowMs = Date.now()) {
+    return readPrivateAuthorityOffer(api, key, true, nowMs);
+}
+function readPrivateAuthorityOffer(api, key, consume, nowMs) {
+    assertNow(nowMs);
+    const store = storesByApi.get(assertApi(api));
+    if (!store)
+        return undefined;
+    const normalizedKey = privateAuthorityOfferKey(key);
+    const offer = store.entries.get(normalizedKey);
+    if (!offer) {
+        pruneExpiredOffers(store, nowMs);
+        return undefined;
+    }
+    if (offer.expiresAtMs <= nowMs) {
+        store.entries.delete(normalizedKey);
+        pruneExpiredOffers(store, nowMs);
+        return undefined;
+    }
+    if (offer.payload.invalidated === true) {
+        if (consume)
+            store.entries.delete(normalizedKey);
+        return undefined;
+    }
+    if (consume)
+        store.entries.delete(normalizedKey);
+    return offer.payload;
+}
+function privateAuthorityOfferStore(api) {
+    const exactApi = assertApi(api);
+    const existing = storesByApi.get(exactApi);
+    if (existing)
+        return existing;
+    const created = { entries: new Map() };
+    storesByApi.set(exactApi, created);
+    return created;
+}
+function privateAuthorityOfferKey(key) {
+    const sessionKey = exactNonBlank(key?.sessionKey, "sessionKey");
+    const sessionId = exactNonBlank(key?.sessionId, "sessionId");
+    const kind = exactIdentifier(key?.kind, "kind");
+    const targetType = exactIdentifier(key?.target?.type, "target.type");
+    const targetId = exactNonBlank(key?.target?.id, "target.id");
+    return JSON.stringify([sessionKey, sessionId, kind, targetType, targetId]);
+}
+function normalizedInteractionOfferMatchesSubject(normalizedKey, sessionKey, sessionId, subjectKind, subjectId) {
+    try {
+        const key = JSON.parse(normalizedKey);
+        if (!Array.isArray(key) ||
+            key.length !== 5 ||
+            key[0] !== sessionKey ||
+            key[1] !== sessionId ||
+            key[2] !== SEMANTIC_INTERACTION_AUTHORITY_KIND ||
+            key[3] !== "interaction_subject" ||
+            typeof key[4] !== "string") {
+            return false;
+        }
+        const target = JSON.parse(key[4]);
+        return Array.isArray(target) &&
+            target.length === 3 &&
+            target[0] === subjectKind &&
+            target[1] === subjectId &&
+            typeof target[2] === "string";
+    }
+    catch {
+        return false;
+    }
+}
+function exactIdentifier(value, label) {
+    const text = exactNonBlank(value, label);
+    if (!/^[a-z][a-z0-9_.-]{0,63}$/u.test(text)) {
+        throw new Error(`private authority offer ${label} is invalid`);
+    }
+    return text;
+}
+function interactionAuthoritySubjectKind(value) {
+    if (!SEMANTIC_INTERACTION_AUTHORITY_SUBJECT_KINDS.includes(value)) {
+        throw new Error("private authority offer interaction subject kind is invalid");
+    }
+    return value;
+}
+function exactNonBlank(value, label) {
+    if (typeof value !== "string" ||
+        value.length === 0 ||
+        value.trim() !== value) {
+        throw new Error(`private authority offer ${label} must be exact and non-empty`);
+    }
+    return value;
+}
+function assertApi(api) {
+    if ((typeof api !== "object" || api === null) && typeof api !== "function") {
+        throw new Error("private authority offer api must be an object");
+    }
+    return api;
+}
+function assertNow(nowMs) {
+    if (!Number.isFinite(nowMs)) {
+        throw new Error("private authority offer clock must be finite");
+    }
+}
+function pruneExpiredOffers(store, nowMs) {
+    for (const [key, offer] of store.entries) {
+        if (offer.expiresAtMs <= nowMs)
+            store.entries.delete(key);
+    }
+}
+function cloneAndFreezePayload(payload) {
+    if (typeof payload !== "object" || payload === null || Array.isArray(payload)) {
+        throw new Error("private authority offer payload must be an object");
+    }
+    let cloned;
+    try {
+        cloned = structuredClone(payload);
+    }
+    catch {
+        throw new Error("private authority offer payload must be structured-cloneable");
+    }
+    return deepFreeze(cloned, new WeakSet());
+}
+function mergePrivateAuthorityPayload(previous, update) {
+    const definedUpdate = Object.fromEntries(Object.entries(update).filter(([, value]) => value !== undefined));
+    const previousArgs = isPlainRecord(previous?.args) ? previous.args : {};
+    const updateArgs = isPlainRecord(definedUpdate.args)
+        ? definedUpdate.args
+        : undefined;
+    return {
+        ...(previous ?? {}),
+        ...definedUpdate,
+        ...(updateArgs
+            ? { args: { ...previousArgs, ...updateArgs } }
+            : Object.keys(previousArgs).length > 0
+                ? { args: previousArgs }
+                : {})
+    };
+}
+function privateAuthorityPayloadChanged(previous, update) {
+    if (!previous)
+        return false;
+    const nextFingerprint = update.fingerprint;
+    if (nextFingerprint !== undefined &&
+        previous.fingerprint !== undefined &&
+        nextFingerprint !== previous.fingerprint) {
+        return true;
+    }
+    const previousArgs = isPlainRecord(previous.args) ? previous.args : {};
+    const updateArgs = isPlainRecord(update.args) ? update.args : undefined;
+    if (!updateArgs)
+        return false;
+    return Object.keys(previousArgs).length > 0 &&
+        JSON.stringify(previousArgs) !== JSON.stringify(updateArgs);
+}
+function isPlainRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function deepFreeze(value, seen) {
+    if (typeof value !== "object" || value === null || seen.has(value)) {
+        return value;
+    }
+    seen.add(value);
+    for (const nested of Object.values(value))
+        deepFreeze(nested, seen);
+    return Object.freeze(value);
+}
+//# sourceMappingURL=semantic-private-authority-offers.js.map