blun-king-cli 9.1.587 → 9.1.588

package/bin/agent-resume-snapshot.cjs

@@ -1,241 +0,0 @@
-'use strict';
-
-const AGENT_RESUME_SNAPSHOT_SCHEMA_VERSION = 1;
-const MAX_TODO_PROGRESS_EVIDENCE = 8;
-const MAX_TODO_PROGRESS_EVIDENCE_CHARS = 200;
-
-function copyJsonObject(value, fallback) {
-  if (value === undefined) return fallback;
-  return JSON.parse(JSON.stringify(value));
-}
-
-function normalizeTodoProgressState(value) {
-  if (value === null || typeof value !== 'object' || Array.isArray(value)) return undefined;
-  const nonNegativeInteger = (candidate, maximum) => Number.isSafeInteger(candidate)
-    ? Math.max(0, Math.min(candidate, maximum))
-    : 0;
-  const evidenceRevision = nonNegativeInteger(value.evidenceRevision, Number.MAX_SAFE_INTEGER);
-  return {
-    workCallsSinceRefresh: nonNegativeInteger(value.workCallsSinceRefresh, 64),
-    refreshRequired: value.refreshRequired === true,
-    unchangedRefreshStreak: nonNegativeInteger(value.unchangedRefreshStreak, 3),
-    recentEvidence: Array.isArray(value.recentEvidence)
-      ? value.recentEvidence
-        .filter((entry) => typeof entry === 'string')
-        .slice(-MAX_TODO_PROGRESS_EVIDENCE)
-        .map((entry) => entry.slice(0, MAX_TODO_PROGRESS_EVIDENCE_CHARS))
-      : [],
-    evidenceRevision,
-    lastMaintenanceEvidenceRevision: Math.min(
-      nonNegativeInteger(value.lastMaintenanceEvidenceRevision, Number.MAX_SAFE_INTEGER),
-      evidenceRevision,
-    ),
-    allVisibleWorkCompleted: value.allVisibleWorkCompleted === true,
-  };
-}
-
-function captureMessageTimes(agent) {
-  const replayTimes = new Map();
-  for (const record of agent.replayBuilder.records) {
-    if (record?.type === 'message' && Number.isFinite(record.time)) {
-      replayTimes.set(record.message, record.time);
-    }
-  }
-  return agent.context.history.map((message) => {
-    const time = agent.records.messageTimes?.get(message) ?? replayTimes.get(message);
-    return Number.isFinite(time) ? time : null;
-  });
-}
-
-function createAgentResumeSnapshot(agent) {
-  const userTools = [...agent.tools.userTools.values()].map((tool) => ({
-    name: tool.name,
-    description: tool.description,
-    parameters: tool.parameters,
-  }));
-  return {
-    schemaVersion: AGENT_RESUME_SNAPSHOT_SCHEMA_VERSION,
-    context: {
-      history: agent.context.history,
-      tokenCount: agent.context.tokenCount,
-      tokenCountCoveredMessageCount: agent.context.tokenCountCoveredMessageCount,
-      lastAssistantAt: agent.context._lastAssistantAt,
-      messageTimes: captureMessageTimes(agent),
-    },
-    config: {
-      cwd: agent.config._cwd,
-      modelAlias: agent.config._modelAlias,
-      profileName: agent.config._profileName,
-      thinkingEffort: agent.config._thinkingEffort,
-      actionStyle: agent.config._actionStyle,
-      systemPrompt: agent.config._systemPrompt,
-    },
-    permission: {
-      hasModeOverride: agent.permission.modeOverride !== undefined,
-      modeOverride: agent.permission.modeOverride,
-      sessionApprovalRulePatterns: [...agent.permission.localSessionApprovalRulePatterns],
-    },
-    plan: {
-      active: agent.planMode._isActive,
-      id: agent.planMode._planId,
-      filePath: agent.planMode._planFilePath,
-    },
-    swarm: { active: agent.swarmMode.active },
-    usage: { byModel: agent.usage.byModel },
-    tools: {
-      userTools,
-      enabledTools: [...agent.tools.enabledTools],
-      mcpAccessPatterns: [...agent.tools.mcpAccessPatterns],
-      store: agent.tools.store,
-      allowedTools: agent.tools.allowedTools,
-      excludedTools: [...agent.tools.excludedTools],
-    },
-    todoProgress: normalizeTodoProgressState(agent.goalTodoPolicyState) ?? null,
-    goal: agent.goal.state ?? null,
-    turn: {
-      turnId: agent.turn.turnId,
-      telegramDeliveryIdentities: agent.turn.telegramDeliveryLedger?.snapshot?.() ?? [],
-    },
-    microCompaction: { cutoff: agent.microCompaction.cutoff },
-  };
-}
-
-function isValidSnapshot(snapshot) {
-  return snapshot !== null
-    && typeof snapshot === 'object'
-    && snapshot.schemaVersion === AGENT_RESUME_SNAPSHOT_SCHEMA_VERSION
-    && snapshot.context !== null
-    && typeof snapshot.context === 'object'
-    && Array.isArray(snapshot.context.history)
-    && snapshot.config !== null
-    && typeof snapshot.config === 'object'
-    && typeof snapshot.config.cwd === 'string'
-    && snapshot.permission !== null
-    && typeof snapshot.permission === 'object'
-    && snapshot.tools !== null
-    && typeof snapshot.tools === 'object'
-    && Array.isArray(snapshot.tools.userTools)
-    && snapshot.turn !== null
-    && typeof snapshot.turn === 'object';
-}
-
-function restoreAgentResumeSnapshot(agent, snapshot) {
-  if (!isValidSnapshot(snapshot)) return false;
-
-  const previousRestoring = agent.records._restoring;
-  agent.records._restoring = { time: Date.now() };
-  try {
-    agent.config._cwd = snapshot.config.cwd;
-    agent.config._modelAlias = snapshot.config.modelAlias;
-    agent.config._profileName = snapshot.config.profileName;
-    agent.config._thinkingEffort = snapshot.config.thinkingEffort ?? 'off';
-    agent.config._actionStyle = snapshot.config.actionStyle ?? 'default';
-    agent.config._systemPrompt = snapshot.config.systemPrompt ?? '';
-    agent.kaos.chdir(snapshot.config.cwd);
-
-    agent.context._history = snapshot.context.history;
-    agent.context._tokenCount = Number.isFinite(snapshot.context.tokenCount)
-      ? snapshot.context.tokenCount
-      : 0;
-    agent.context.tokenCountCoveredMessageCount = Number.isInteger(
-      snapshot.context.tokenCountCoveredMessageCount,
-    ) ? Math.max(
-      0,
-      Math.min(snapshot.context.history.length, snapshot.context.tokenCountCoveredMessageCount),
-    ) : 0;
-    agent.context._lastAssistantAt = Number.isFinite(snapshot.context.lastAssistantAt)
-      ? snapshot.context.lastAssistantAt
-      : null;
-    const messageTimes = Array.isArray(snapshot.context.messageTimes)
-      ? snapshot.context.messageTimes
-      : [];
-    if (agent.records.messageTimes?.set) {
-      snapshot.context.history.forEach((message, index) => {
-        const time = messageTimes[index];
-        if (Number.isFinite(time)) agent.records.messageTimes.set(message, time);
-      });
-    }
-    agent.context.openSteps.clear();
-    agent.context.pendingToolResultIds.clear();
-    agent.context.deferredMessages = [];
-    agent.context.markPendingTokenEstimateDirty();
-    agent.injection.onContextClear();
-
-    agent.permission.modeOverride = snapshot.permission.hasModeOverride === true
-      ? snapshot.permission.modeOverride
-      : undefined;
-    agent.permission.localSessionApprovalRulePatterns = new Set(
-      Array.isArray(snapshot.permission.sessionApprovalRulePatterns)
-        ? snapshot.permission.sessionApprovalRulePatterns
-        : [],
-    );
-
-    agent.planMode._isActive = snapshot.plan?.active === true;
-    agent.planMode._planId = agent.planMode._isActive ? snapshot.plan?.id ?? null : null;
-    agent.planMode._planFilePath = agent.planMode._isActive
-      ? snapshot.plan?.filePath ?? null
-      : null;
-    agent.swarmMode.active = snapshot.swarm?.active ?? null;
-    agent.usage.byModel = copyJsonObject(snapshot.usage?.byModel, {});
-    agent.usage.currentTurn = undefined;
-
-    agent.tools.userTools.clear();
-    for (const tool of snapshot.tools.userTools) {
-      if (!tool || typeof tool.name !== 'string' || !tool.name) continue;
-      agent.tools.registerUserTool({
-        name: tool.name,
-        description: typeof tool.description === 'string' ? tool.description : '',
-        parameters: tool.parameters ?? { type: 'object' },
-      });
-    }
-    agent.tools.enabledTools = new Set(
-      Array.isArray(snapshot.tools.enabledTools) ? snapshot.tools.enabledTools : [],
-    );
-    agent.tools.mcpAccessPatterns = Array.isArray(snapshot.tools.mcpAccessPatterns)
-      ? [...snapshot.tools.mcpAccessPatterns]
-      : [];
-    agent.tools.store = copyJsonObject(snapshot.tools.store, {});
-    agent.tools.allowedTools = Array.isArray(snapshot.tools.allowedTools)
-      ? [...snapshot.tools.allowedTools]
-      : undefined;
-    agent.tools.excludedTools = Array.isArray(snapshot.tools.excludedTools)
-      ? [...snapshot.tools.excludedTools]
-      : [];
-    if (agent.config.hasProvider) agent.tools.initializeBuiltinTools();
-
-    agent.goalTodoPolicyState = normalizeTodoProgressState(snapshot.todoProgress);
-
-    agent.goal.state = snapshot.goal === null
-      ? undefined
-      : copyJsonObject(snapshot.goal, undefined);
-    agent.turn.turnId = Number.isInteger(snapshot.turn.turnId) ? snapshot.turn.turnId : -1;
-    agent.turn.activeTurn = 'resuming';
-    agent.turn.steerBuffer.length = 0;
-    agent.turn.telegramDeliveryLedger?.restore?.(snapshot.turn.telegramDeliveryIdentities);
-    agent.microCompaction.cutoff = Number.isInteger(snapshot.microCompaction?.cutoff)
-      ? Math.max(0, Math.min(snapshot.context.history.length, snapshot.microCompaction.cutoff))
-      : 0;
-
-    agent.toolResultBatchOffload.reset(agent.context._history);
-    agent.userMessageOffload.reset(agent.context._history);
-    agent.assistantMessageOffload.reset(agent.context._history);
-    agent.replayBuilder.records = agent.context._history.map((message, index) => {
-      const time = messageTimes[index];
-      return Number.isFinite(time)
-        ? { type: 'message', message, time }
-        : { type: 'message', message };
-    });
-    agent.replayBuilder.frozen = false;
-    agent.replayBuilder.segmentStart = 0;
-    return true;
-  } finally {
-    agent.records._restoring = previousRestoring;
-  }
-}
-
-module.exports = {
-  AGENT_RESUME_SNAPSHOT_SCHEMA_VERSION,
-  createAgentResumeSnapshot,
-  normalizeTodoProgressState,
-  restoreAgentResumeSnapshot,
-};

package/bin/agentspine-king-goal-inbox.mjs

@@ -1,111 +0,0 @@
-import { open, lstat, mkdir, readFile, rename, writeFile } from 'node:fs/promises';
-import path from 'node:path';
-
-import { ingestGoalInstruction, parseGoalInstruction } from './agentspine-king-goal-intake.mjs';
-
-const CHECKPOINT_SCHEMA = 'blun.king-goal-queue-checkpoint/v1';
-const MAX_READ_BYTES = 4 * 1024 * 1024;
-
-function queueIdentity(metadata) {
-  return `${metadata.dev}:${metadata.ino}:${metadata.birthtimeMs}`;
-}
-
-async function readCheckpoint(filePath) {
-  try {
-    const value = JSON.parse(await readFile(filePath, 'utf8'));
-    if (value?.schema === CHECKPOINT_SCHEMA && typeof value.fileId === 'string'
-      && Number.isSafeInteger(value.offset) && value.offset >= 0 && Array.isArray(value.accepted)) return value;
-  } catch (error) {
-    if (error?.code !== 'ENOENT') throw error;
-  }
-  return { schema: CHECKPOINT_SCHEMA, fileId: '', offset: 0, lastMessageId: null, accepted: [] };
-}
-
-async function writeCheckpoint(filePath, value) {
-  await mkdir(path.dirname(filePath), { recursive: true });
-  const temporary = `${filePath}.${process.pid}.${Date.now()}.tmp`;
-  await writeFile(temporary, `${JSON.stringify(value, null, 2)}\n`, {
-    encoding: 'utf8', flag: 'wx', mode: 0o600,
-  });
-  await rename(temporary, filePath);
-}
-
-function parseQueueLine(line) {
-  let envelope;
-  try { envelope = JSON.parse(line); } catch { return null; }
-  if (!envelope || typeof envelope.text !== 'string' || typeof envelope.meta !== 'object') return null;
-  return envelope;
-}
-
-function isAuthorizedInstruction(envelope, input) {
-  const addressed = envelope.meta.addressed === true || envelope.meta.addressed === 'true';
-  return addressed && String(envelope.meta.user_id) === String(input.instructionSenderId)
-    && String(envelope.meta.chat_id) === String(input.instructionChatId);
-}
-
-async function queueChunk(filePath, checkpoint) {
-  const metadata = await lstat(filePath);
-  if (!metadata.isFile() || metadata.isSymbolicLink()) throw new Error('GOAL_QUEUE_NOT_REGULAR');
-  const fileId = queueIdentity(metadata);
-  const offset = checkpoint.fileId === fileId && metadata.size >= checkpoint.offset ? checkpoint.offset : 0;
-  const bytes = Math.min(MAX_READ_BYTES, metadata.size - offset);
-  if (bytes <= 0) return { fileId, offset, lines: [] };
-  const handle = await open(filePath, 'r');
-  try {
-    const buffer = Buffer.alloc(bytes);
-    const { bytesRead } = await handle.read(buffer, 0, bytes, offset);
-    const content = buffer.subarray(0, bytesRead);
-    const lastNewline = content.lastIndexOf(10);
-    if (lastNewline < 0) return { fileId, offset, lines: [] };
-    const complete = content.subarray(0, lastNewline + 1);
-    return { fileId, offset, lines: complete.toString('utf8').split('\n').slice(0, -1) };
-  } finally { await handle.close(); }
-}
-
-async function ingestGoalInbox(input) {
-  const checkpoint = await readCheckpoint(input.checkpointFile);
-  let cursor = checkpoint.offset;
-  const results = [];
-  const chunk = await queueChunk(input.queueFile, checkpoint);
-  if (chunk.offset !== checkpoint.offset || chunk.fileId !== checkpoint.fileId) cursor = chunk.offset;
-  for (const line of chunk.lines) {
-    cursor += Buffer.byteLength(line, 'utf8') + 1;
-    const envelope = parseQueueLine(line);
-    if (!envelope || !isAuthorizedInstruction(envelope, input)
-      || !/\bZIEL-[A-Za-z0-9._-]+\.json\b/u.test(envelope.text)) continue;
-    try {
-      const instruction = parseGoalInstruction(envelope.text);
-      const accepted = checkpoint.accepted.find((item) => item.sha256 === instruction.sha256);
-      if (accepted) {
-        results.push({ status: 'duplicate', messageId: String(envelope.meta.message_id),
-          sha256: instruction.sha256, goal: { goalId: accepted.goalId } });
-        continue;
-      }
-      const ingested = await ingestGoalInstruction({ ...input, instructionText: envelope.text });
-      results.push({ status: ingested.duplicate ? 'duplicate' : 'ingested',
-        messageId: String(envelope.meta.message_id), ...ingested });
-      checkpoint.accepted.push({ sha256: ingested.sha256, goalId: ingested.goal.goalId });
-      checkpoint.accepted = checkpoint.accepted.slice(-512);
-    } catch (error) {
-      results.push({ status: 'rejected', messageId: String(envelope.meta.message_id),
-        error: String(error?.message || error).slice(0, 200) });
-    }
-  }
-  await writeCheckpoint(input.checkpointFile, {
-    schema: CHECKPOINT_SCHEMA,
-    fileId: chunk.fileId,
-    offset: cursor,
-    lastMessageId: results.at(-1)?.messageId || checkpoint.lastMessageId || null,
-    accepted: checkpoint.accepted,
-    updatedAt: new Date().toISOString(),
-  });
-  return results;
-}
-
-export {
-  CHECKPOINT_SCHEMA,
-  ingestGoalInbox,
-  isAuthorizedInstruction,
-  parseQueueLine,
-  queueIdentity,
-};

package/bin/agentspine-king-goal-intake.mjs

@@ -1,106 +0,0 @@
-import { createHash } from 'node:crypto';
-import { lstat, readFile, realpath } from 'node:fs/promises';
-import path from 'node:path';
-
-const ASSIGNMENT_SCHEMA = 'blun.king-goal-assignment/v1';
-const INSTRUCTION_RE = /(ZIEL-[A-Za-z0-9._-]+\.json)\b[^\r\n]{0,200}?\bsha256\b\s*[=:]?\s*([a-f0-9]{64})(?:\s|[),.;]|$)/iu;
-
-function digest(value) {
-  return createHash('sha256').update(value).digest('hex');
-}
-
-function parseGoalInstruction(text) {
-  const match = String(text || '').match(INSTRUCTION_RE);
-  if (!match) throw new Error('GOAL_INSTRUCTION_REQUIRES_FILE_AND_SHA256');
-  return Object.freeze({ fileName: match[1], sha256: match[2].toLowerCase() });
-}
-
-function assignmentInput(value) {
-  if (!value || value.schema !== ASSIGNMENT_SCHEMA || typeof value.goalId !== 'string'
-    || typeof value.logicalPersonaId !== 'string' || typeof value.successCriterion !== 'string'
-    || !Array.isArray(value.steps) || value.steps.length === 0) {
-    throw new Error('GOAL_ASSIGNMENT_INVALID');
-  }
-  assertTerminalGoalGate(value.steps);
-  return value;
-}
-
-function assertTerminalGoalGate(steps) {
-  const ids = new Set(steps.map((step) => step?.stepId));
-  if (ids.size !== steps.length || ids.has(undefined)) throw new Error('GOAL_PLAN_STEP_IDS_INVALID');
-  const dependedOn = new Set(steps.flatMap((step) => Array.isArray(step.dependsOn) ? step.dependsOn : []));
-  const terminalSteps = steps.filter((step) => !dependedOn.has(step.stepId));
-  if (terminalSteps.length !== 1 || !terminalSteps[0].execution?.verification) {
-    throw new Error('GOAL_PLAN_TERMINAL_GATE_REQUIRED');
-  }
-  const terminalId = terminalSteps[0].stepId;
-  const byId = new Map(steps.map((step) => [step.stepId, step]));
-  const reachesGate = (stepId, seen = new Set()) => {
-    if (stepId === terminalId) return true;
-    if (seen.has(stepId)) return false;
-    seen.add(stepId);
-    return steps.some((candidate) => Array.isArray(candidate.dependsOn)
-      && candidate.dependsOn.includes(stepId) && reachesGate(candidate.stepId, new Set(seen)));
-  };
-  if ([...byId.keys()].some((stepId) => !reachesGate(stepId))) {
-    throw new Error('GOAL_PLAN_TERMINAL_GATE_MUST_DEPEND_ON_ALL_STEPS');
-  }
-}
-
-function inside(directory, candidate) {
-  const relative = path.relative(directory, candidate);
-  return relative !== '..' && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative);
-}
-
-async function readVerifiedGoalFile(exchangeDirectory, instruction) {
-  const exchange = await realpath(path.resolve(exchangeDirectory));
-  const candidate = path.resolve(exchange, instruction.fileName);
-  if (!inside(exchange, candidate)) throw new Error('GOAL_FILE_OUTSIDE_EXCHANGE');
-  const metadata = await lstat(candidate);
-  if (!metadata.isFile() || metadata.isSymbolicLink() || metadata.size > 1024 * 1024) {
-    throw new Error('GOAL_FILE_NOT_REGULAR');
-  }
-  const canonical = await realpath(candidate);
-  if (!inside(exchange, canonical)) throw new Error('GOAL_FILE_OUTSIDE_EXCHANGE');
-  const payload = await readFile(canonical);
-  if (digest(payload) !== instruction.sha256) throw new Error('GOAL_FILE_SHA256_MISMATCH');
-  let value;
-  try { value = JSON.parse(payload.toString('utf8')); }
-  catch { throw new Error('GOAL_FILE_INVALID_JSON'); }
-  return { assignment: assignmentInput(value), filePath: canonical, sha256: instruction.sha256 };
-}
-
-async function ingestGoalInstruction(input) {
-  const instruction = parseGoalInstruction(input.instructionText);
-  const verified = await readVerifiedGoalFile(input.exchangeDirectory, instruction);
-  const value = verified.assignment;
-  if (value.logicalPersonaId !== input.logicalPersonaId) throw new Error('GOAL_PERSONA_MISMATCH');
-  if (value.projectId !== input.projectId) throw new Error('GOAL_PROJECT_MISMATCH');
-  if (value.groupId !== input.groupId || value.ownerSubjectId !== input.ownerSubjectId) {
-    throw new Error('GOAL_AUTHORITY_MISMATCH');
-  }
-  if (value.snapshotSha256 !== input.snapshot.snapshotSha256) throw new Error('GOAL_SNAPSHOT_MISMATCH');
-  const result = await input.assignGoal({
-    root: input.snapshot.root,
-    goalId: value.goalId,
-    agentId: input.runtimePersonaId,
-    ownerSubjectId: value.ownerSubjectId,
-    projectId: value.projectId,
-    groupId: value.groupId,
-    priority: value.priority ?? 70,
-    successCriterion: value.successCriterion,
-    nextSafeStep: value.nextSafeStep ?? null,
-    steps: value.steps,
-    deadline: value.deadline ?? null,
-    confirmation: 'local-owner-confirmed',
-  });
-  return Object.freeze({ ...verified, duplicate: result.duplicate === true, goal: result.goal });
-}
-
-export {
-  ASSIGNMENT_SCHEMA,
-  assertTerminalGoalGate,
-  ingestGoalInstruction,
-  parseGoalInstruction,
-  readVerifiedGoalFile,
-};

package/bin/approval-rejection-stop.cjs

@@ -1,15 +0,0 @@
-'use strict';
-
-function buildApprovalRejectionStop(output) {
-  return {
-    syntheticResult: {
-      output,
-      isError: true,
-      stopTurn: true,
-    },
-  };
-}
-
-module.exports = {
-  buildApprovalRejectionStop,
-};