blun-king-cli 9.1.363 → 9.1.364

package/bin/cognitive-turn-lifecycle.cjs

@@ -230,6 +230,94 @@ function createCognitiveTurnLifecycle({ home, tenantId, agentId, runtimeId, now
     return commitDurableStage(`focus-${input.snapshotId}`, observations);
   }
 
+  function commitExplicitFocusRevision(kind, input) {
+    const correction = kind === 'correction';
+    const allowed = correction
+      ? new Set(['requestId', 'targetObservationId', 'domain', 'key', 'value', 'scope', 'authority', 'confirmation', 'occurredAt', 'source'])
+      : new Set(['requestId', 'targetObservationId', 'domain', 'key', 'scope', 'authority', 'confirmation', 'occurredAt', 'source']);
+    if (!exactKeys(input, allowed)) fail('COGNITIVE_REVISION_INVALID');
+    const requestId = safeId(input.requestId);
+    const targetObservationId = safeId(input.targetObservationId);
+    const domain = String(input.domain ?? '');
+    const key = cleanLabel(input.key, 128);
+    const scope = cleanLabel(input.scope, 128);
+    const occurredAt = String(input.occurredAt ?? '').trim();
+    const source = input.source;
+    if (input.authority !== 'runtime_user_prompt_hook' || input.confirmation !== 'explicit_user_request') {
+      fail('COGNITIVE_REVISION_EXPLICIT_USER_REQUIRED');
+    }
+    if (!requestId || !targetObservationId || !FOCUS_DOMAINS.has(domain) || !key
+        || AUTHORITY_KEY_RE.test(key) || !scope || scope === 'runtime'
+        || Number.isNaN(Date.parse(occurredAt))
+        || !exactKeys(source, new Set(['provider', 'actorId', 'contextId', 'messageId']))) {
+      fail('COGNITIVE_REVISION_INVALID');
+    }
+    const normalizedSource = {
+      provider: safeId(source.provider),
+      actor_id: safeId(source.actorId),
+      context_id: safeId(source.contextId),
+      message_id: safeId(source.messageId),
+    };
+    if (Object.values(normalizedSource).some((value) => !value)) fail('COGNITIVE_REVISION_INVALID');
+    const value = correction ? cleanLabel(input.value, 512) : 'withdrawn';
+    if (!value) fail('COGNITIVE_REVISION_INVALID');
+    const eventId = digestId('revision', [tenant, agent, kind, requestId]);
+    const observationId = digestId('revisionobs', [eventId]);
+    const observation = {
+      observation_id: observationId,
+      domain,
+      key,
+      value,
+      confidence: 1,
+      scope,
+      ...(correction ? { supersedes: targetObservationId } : { withdraws: targetObservationId }),
+    };
+    const normalizedOccurredAt = new Date(occurredAt).toISOString();
+    for (let attempt = 0; attempt < 4; attempt += 1) {
+      const current = store.read({ tenantId: tenant, agentId: agent });
+      const existing = current.observations.find((item) => item.observation_id === observationId);
+      if (existing) {
+        const matches = existing.domain === observation.domain && existing.key === observation.key
+          && existing.value === observation.value && existing.confidence === 1
+          && existing.scope === observation.scope && existing.occurred_at === normalizedOccurredAt
+          && existing.supersedes === (observation.supersedes ?? null)
+          && existing.withdraws === (observation.withdraws ?? null)
+          && existing.source.provider === normalizedSource.provider
+          && existing.source.actor_id === normalizedSource.actor_id
+          && existing.source.context_id === normalizedSource.context_id
+          && existing.source.message_id === normalizedSource.message_id;
+        if (!matches) fail('COGNITIVE_REVISION_REQUEST_REUSE');
+        return { version: current.version, idempotent: true };
+      }
+      const target = current.observations.find((item) => item.observation_id === targetObservationId);
+      if (target && Date.parse(normalizedOccurredAt) < Date.parse(target.occurred_at)) {
+        fail('COGNITIVE_REVISION_TIME_ORDER');
+      }
+      try {
+        return store.commit({
+          tenantId: tenant,
+          agentId: agent,
+          eventId,
+          expectedVersion: current.version,
+          occurredAt: normalizedOccurredAt,
+          source: normalizedSource,
+          observations: [observation],
+        });
+      } catch (error) {
+        if (error?.code !== 'COGNITIVE_VERSION_CONFLICT' || attempt === 3) throw error;
+      }
+    }
+    fail('COGNITIVE_VERSION_CONFLICT');
+  }
+
+  function correctFocusObservation(input) {
+    return commitExplicitFocusRevision('correction', input);
+  }
+
+  function withdrawFocusObservation(input) {
+    return commitExplicitFocusRevision('withdrawal', input);
+  }
+
   function toolFields(input, allowedKeys) {
     if (!exactKeys(input, allowedKeys)) fail('COGNITIVE_LIFECYCLE_INVALID');
     const turnId = safeTurnId(input.turnId);
@@ -337,6 +425,8 @@ function createCognitiveTurnLifecycle({ home, tenantId, agentId, runtimeId, now
     recordToolResult,
     recordToolBatch,
     recordFocusSnapshot,
+    correctFocusObservation,
+    withdrawFocusObservation,
     authorizeAttention,
     projectForTurn,
     endTurn,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blun-king-cli",
-  "version": "9.1.363",
+  "version": "9.1.364",
   "description": "BLUN CLI - your own AI agent with a Telegram channel. Get it done. With BLUN.",
   "license": "MIT",
   "bin": {