@lumenflow/cli 5.5.0 → 5.7.14

package/packs/sidekick/tool-impl/memory-tools.ts

@@ -1,290 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: LicenseRef-LumenFlow-Proprietary
-
-import { getStoragePort, type MemoryRecord, type MemoryType } from './storage.js';
-import {
-  asInteger,
-  asNonEmptyString,
-  asStringArray,
-  buildAuditEvent,
-  createId,
-  failure,
-  includesText,
-  isDryRun,
-  matchesTags,
-  nowIso,
-  success,
-  toRecord,
-  type ToolContextLike,
-  type ToolOutput,
-} from './shared.js';
-import {
-  buildMemoryForgottenEvent,
-  buildMemoryRecalledEvent,
-  buildMemoryStoredEvent,
-  emitSidekickEvent,
-} from '../sidekick-events.js';
-
-// ---------------------------------------------------------------------------
-// Constants
-// ---------------------------------------------------------------------------
-
-const TOOL_NAMES = {
-  STORE: 'memory:store',
-  RECALL: 'memory:recall',
-  UPDATE: 'memory:update',
-  FORGET: 'memory:forget',
-} as const;
-
-const VALID_MEMORY_TYPES: MemoryType[] = ['fact', 'preference', 'note', 'snippet'];
-
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-
-function asMemoryType(value: unknown): MemoryType | null {
-  return VALID_MEMORY_TYPES.includes(value as MemoryType) ? (value as MemoryType) : null;
-}
-
-// ---------------------------------------------------------------------------
-// memory:store
-// ---------------------------------------------------------------------------
-
-async function memoryStoreTool(input: unknown, context?: ToolContextLike): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const type = asMemoryType(parsed.type);
-  const content = asNonEmptyString(parsed.content);
-
-  if (!type) {
-    return failure('INVALID_INPUT', 'type must be one of fact, preference, note.');
-  }
-  if (!content) {
-    return failure('INVALID_INPUT', 'content is required.');
-  }
-
-  const memory: MemoryRecord = {
-    id: createId('mem'),
-    type,
-    content,
-    tags: asStringArray(parsed.tags),
-    created_at: nowIso(),
-    updated_at: nowIso(),
-  };
-
-  if (isDryRun(parsed)) {
-    return success({
-      dry_run: true,
-      memory: memory as unknown as Record<string, unknown>,
-    });
-  }
-
-  const storage = getStoragePort();
-  await storage.withLock(async () => {
-    const memories = await storage.readStore('memories');
-    memories.push(memory);
-    await storage.writeStore('memories', memories);
-    await storage.appendAudit(
-      buildAuditEvent({
-        tool: TOOL_NAMES.STORE,
-        op: 'create',
-        context,
-        ids: [memory.id],
-      }),
-    );
-  });
-
-  await emitSidekickEvent(buildMemoryStoredEvent(memory));
-
-  return success({ memory: memory as unknown as Record<string, unknown> });
-}
-
-// ---------------------------------------------------------------------------
-// memory:recall
-// ---------------------------------------------------------------------------
-
-async function memoryRecallTool(input: unknown, _context?: ToolContextLike): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const query = asNonEmptyString(parsed.query);
-  const type = asMemoryType(parsed.type);
-  const tags = asStringArray(parsed.tags);
-  const limit = asInteger(parsed.limit);
-
-  const storage = getStoragePort();
-  const memories = await storage.readStore('memories');
-
-  const filtered = memories.filter((memory) => {
-    if (type && memory.type !== type) {
-      return false;
-    }
-    if (!matchesTags(tags, memory.tags)) {
-      return false;
-    }
-    if (!includesText(memory.content, query)) {
-      return false;
-    }
-    return true;
-  });
-
-  const sorted = filtered.toSorted((a, b) => Date.parse(b.updated_at) - Date.parse(a.updated_at));
-
-  const items = limit && limit > 0 ? sorted.slice(0, limit) : sorted;
-
-  await emitSidekickEvent(
-    buildMemoryRecalledEvent({
-      query,
-      memories: items,
-    }),
-  );
-
-  return success({
-    items: items as unknown as Record<string, unknown>,
-    count: items.length,
-  });
-}
-
-// ---------------------------------------------------------------------------
-// memory:update
-// ---------------------------------------------------------------------------
-
-async function memoryUpdateTool(input: unknown, context?: ToolContextLike): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const id = asNonEmptyString(parsed.id);
-
-  if (!id) {
-    return failure('INVALID_INPUT', 'id is required.');
-  }
-
-  const patch: Partial<MemoryRecord> = {};
-  if (parsed.type !== undefined) {
-    const type = asMemoryType(parsed.type);
-    if (!type) {
-      return failure('INVALID_INPUT', 'type must be one of fact, preference, note, snippet.');
-    }
-    patch.type = type;
-  }
-  if (parsed.content !== undefined) {
-    const content = asNonEmptyString(parsed.content);
-    if (!content) {
-      return failure('INVALID_INPUT', 'content must be a non-empty string when provided.');
-    }
-    patch.content = content;
-  }
-  if (parsed.tags !== undefined) {
-    patch.tags = asStringArray(parsed.tags);
-  }
-
-  if (Object.keys(patch).length === 0) {
-    return failure(
-      'INVALID_INPUT',
-      'memory:update requires at least one of type, content, or tags.',
-    );
-  }
-
-  const storage = getStoragePort();
-  const memories = await storage.readStore('memories');
-  const memory = memories.find((entry) => entry.id === id);
-
-  if (!memory) {
-    return failure('NOT_FOUND', `memory ${id} was not found.`);
-  }
-
-  const preview: MemoryRecord = {
-    ...memory,
-    ...patch,
-    updated_at: nowIso(),
-  };
-
-  if (isDryRun(parsed)) {
-    return success({
-      dry_run: true,
-      memory: preview as unknown as Record<string, unknown>,
-    });
-  }
-
-  await storage.withLock(async () => {
-    const latest = await storage.readStore('memories');
-    const target = latest.find((entry) => entry.id === id);
-    if (!target) {
-      return;
-    }
-    Object.assign(target, preview);
-    await storage.writeStore('memories', latest);
-    await storage.appendAudit(
-      buildAuditEvent({
-        tool: TOOL_NAMES.UPDATE,
-        op: 'update',
-        context,
-        ids: [id],
-      }),
-    );
-  });
-
-  const updated = await storage.readStore('memories');
-  const updatedMemory = updated.find((entry) => entry.id === id);
-  return success({ memory: updatedMemory as unknown as Record<string, unknown> });
-}
-
-// ---------------------------------------------------------------------------
-// memory:forget
-// ---------------------------------------------------------------------------
-
-async function memoryForgetTool(input: unknown, context?: ToolContextLike): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const id = asNonEmptyString(parsed.id);
-
-  if (!id) {
-    return failure('INVALID_INPUT', 'id is required.');
-  }
-
-  const storage = getStoragePort();
-  const memories = await storage.readStore('memories');
-  const exists = memories.some((memory) => memory.id === id);
-
-  if (!exists) {
-    return failure('NOT_FOUND', `memory ${id} was not found.`);
-  }
-
-  if (isDryRun(parsed)) {
-    return success({ dry_run: true, deleted_id: id });
-  }
-
-  await storage.withLock(async () => {
-    const latest = await storage.readStore('memories');
-    const remaining = latest.filter((memory) => memory.id !== id);
-    await storage.writeStore('memories', remaining);
-    await storage.appendAudit(
-      buildAuditEvent({
-        tool: TOOL_NAMES.FORGET,
-        op: 'delete',
-        context,
-        ids: [id],
-      }),
-    );
-  });
-
-  await emitSidekickEvent(buildMemoryForgottenEvent(id));
-
-  return success({ deleted_id: id });
-}
-
-// ---------------------------------------------------------------------------
-// Router (default export)
-// ---------------------------------------------------------------------------
-
-export default async function memoryTools(
-  input: unknown,
-  context?: ToolContextLike,
-): Promise<ToolOutput> {
-  switch (context?.tool_name) {
-    case TOOL_NAMES.STORE:
-      return memoryStoreTool(input, context);
-    case TOOL_NAMES.RECALL:
-      return memoryRecallTool(input, context);
-    case TOOL_NAMES.UPDATE:
-      return memoryUpdateTool(input, context);
-    case TOOL_NAMES.FORGET:
-      return memoryForgetTool(input, context);
-    default:
-      return failure('UNKNOWN_TOOL', `Unknown memory tool: ${context?.tool_name ?? 'unknown'}`);
-  }
-}

package/packs/sidekick/tool-impl/routine-commit.ts

@@ -1,102 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: LicenseRef-LumenFlow-Proprietary
-
-/**
- * WU-2738 (INIT-060, ADR-013 §6 governance): `sidekick:routine:commit_plan`
- * is the only path from a planned routine to a committed one. It is
- * registered as a runtime-callable tool (not a top-level surface) so the
- * kernel's governed dispatch emits `agent-runtime:tool_called` inside a
- * turn, and the commit itself emits `sidekick:routine_committed` carrying
- * a content-hash of the commit envelope. No fast-path bypasses this tool.
- */
-
-import {
-  buildRoutineCommitEnvelope,
-  hashRoutineCommitEnvelope,
-  type RoutineCommitAttestation,
-} from '../src/routines/commit.js';
-import { buildRoutineCommittedEvent, emitSidekickEvent } from '../sidekick-events.js';
-import { getStoragePort } from './storage.js';
-import {
-  asNonEmptyString,
-  buildAuditEvent,
-  failure,
-  nowIso,
-  success,
-  toRecord,
-  type ToolContextLike,
-  type ToolOutput,
-} from './shared.js';
-
-const ROUTINE_COMMIT_PLAN_TOOL_NAME = 'sidekick:routine:commit_plan';
-
-function readAttestation(value: unknown): RoutineCommitAttestation | null {
-  if (!value || typeof value !== 'object' || Array.isArray(value)) {
-    return null;
-  }
-  const record = value as Record<string, unknown>;
-  const actor = asNonEmptyString(record.actor);
-  const reason = asNonEmptyString(record.reason);
-  if (!actor || !reason) {
-    return null;
-  }
-  return {
-    ...record,
-    actor,
-    reason,
-  };
-}
-
-export default async function routineCommitPlanTool(
-  input: unknown,
-  context?: ToolContextLike,
-): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const planId = asNonEmptyString(parsed.plan_id);
-  const attestation = readAttestation(parsed.attestation);
-
-  if (!planId) {
-    return failure('INVALID_INPUT', 'plan_id is required.');
-  }
-  if (!attestation) {
-    return failure(
-      'INVALID_INPUT',
-      'attestation must be an object with non-empty actor and reason fields.',
-    );
-  }
-
-  const storage = getStoragePort();
-  const routines = await storage.readStore('routines');
-  const routine = routines.find((entry) => entry.id === planId);
-  if (!routine) {
-    return failure('NOT_FOUND', `routine ${planId} was not found.`);
-  }
-
-  const committedAt = nowIso();
-  const envelope = buildRoutineCommitEnvelope({ routine, attestation, committedAt });
-  const envelopeContentHash = hashRoutineCommitEnvelope(envelope);
-
-  await storage.appendAudit(
-    buildAuditEvent({
-      tool: ROUTINE_COMMIT_PLAN_TOOL_NAME,
-      op: 'execute',
-      context,
-      ids: [routine.id],
-      details: {
-        plan_id: routine.id,
-        envelope_content_hash: envelopeContentHash,
-      },
-    }),
-  );
-
-  await emitSidekickEvent(
-    buildRoutineCommittedEvent(routine, { envelope_content_hash: envelopeContentHash }),
-  );
-
-  return success({
-    plan_id: routine.id,
-    routine_id: routine.id,
-    envelope_content_hash: envelopeContentHash,
-    committed_at: committedAt,
-  });
-}