vellum 0.2.12 → 0.2.14

package/src/tools/playbooks/playbook-create.ts

@@ -1,96 +0,0 @@
-import { and, eq } from 'drizzle-orm';
-import { v4 as uuid } from 'uuid';
-import type { ToolContext, ToolExecutionResult } from '../types.js';
-import { getDb } from '../../memory/db.js';
-import { computeMemoryFingerprint } from '../../memory/fingerprint.js';
-import { memoryItems } from '../../memory/schema.js';
-import { enqueueMemoryJob } from '../../memory/jobs-store.js';
-import type { Playbook, PlaybookAutonomyLevel } from '../../playbooks/types.js';
-import { truncate } from '../../util/truncate.js';
-
-const VALID_AUTONOMY_LEVELS = new Set<string>(['auto', 'draft', 'notify']);
-
-export async function executePlaybookCreate(input: Record<string, unknown>, context: ToolContext): Promise<ToolExecutionResult> {
-  const trigger = input.trigger as string;
-  const action = input.action as string;
-
-  if (!trigger || typeof trigger !== 'string') {
-    return { content: 'Error: trigger is required and must be a string', isError: true };
-  }
-  if (!action || typeof action !== 'string') {
-    return { content: 'Error: action is required and must be a string', isError: true };
-  }
-
-  const channel = typeof input.channel === 'string' ? input.channel : '*';
-  const category = typeof input.category === 'string' ? input.category : 'general';
-  const autonomyLevel: PlaybookAutonomyLevel =
-    typeof input.autonomy_level === 'string' && VALID_AUTONOMY_LEVELS.has(input.autonomy_level)
-      ? (input.autonomy_level as PlaybookAutonomyLevel)
-      : 'draft';
-  const priority = typeof input.priority === 'number' ? input.priority : 0;
-
-  const playbook: Playbook = { trigger, channel, category, action, autonomyLevel, priority };
-  const statement = JSON.stringify(playbook);
-  const subject = truncate(`Playbook: ${trigger}`, 80, '');
-  const scopeId = context.memoryScopeId ?? 'default';
-
-  const fingerprint = computeMemoryFingerprint(scopeId, 'playbook', subject, statement);
-
-  try {
-    const db = getDb();
-
-    const existing = db
-      .select()
-      .from(memoryItems)
-      .where(and(eq(memoryItems.fingerprint, fingerprint), eq(memoryItems.scopeId, scopeId)))
-      .get();
-
-    if (existing) {
-      return {
-        content: `A playbook with this exact configuration already exists (ID: ${existing.id}).`,
-        isError: false,
-      };
-    }
-
-    const id = uuid();
-    const now = Date.now();
-
-    db.insert(memoryItems).values({
-      id,
-      kind: 'playbook',
-      subject,
-      statement,
-      status: 'active',
-      confidence: 0.95,
-      importance: 0.8,
-      fingerprint,
-      verificationState: 'user_confirmed',
-      scopeId,
-      firstSeenAt: now,
-      lastSeenAt: now,
-      lastUsedAt: null,
-    }).run();
-
-    enqueueMemoryJob('embed_item', { itemId: id });
-
-    const autonomyLabel = autonomyLevel === 'auto' ? 'execute automatically'
-      : autonomyLevel === 'draft' ? 'draft for review' : 'notify only';
-
-    return {
-      content: [
-        'Playbook created successfully.',
-        `  ID: ${id}`,
-        `  Trigger: ${trigger}`,
-        `  Channel: ${channel}`,
-        `  Category: ${category}`,
-        `  Action: ${action}`,
-        `  Autonomy: ${autonomyLabel}`,
-        `  Priority: ${priority}`,
-      ].join('\n'),
-      isError: false,
-    };
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    return { content: `Error creating playbook: ${msg}`, isError: true };
-  }
-}

package/src/tools/playbooks/playbook-delete.ts

@@ -1,52 +0,0 @@
-import { and, eq } from 'drizzle-orm';
-import type { ToolContext, ToolExecutionResult } from '../types.js';
-import { getDb } from '../../memory/db.js';
-import { memoryItems } from '../../memory/schema.js';
-import { parsePlaybookStatement } from '../../playbooks/types.js';
-
-export async function executePlaybookDelete(input: Record<string, unknown>, context: ToolContext): Promise<ToolExecutionResult> {
-  const playbookId = input.playbook_id as string;
-  if (!playbookId || typeof playbookId !== 'string') {
-    return { content: 'Error: playbook_id is required and must be a string', isError: true };
-  }
-
-  const scopeId = context.memoryScopeId ?? 'default';
-
-  try {
-    const db = getDb();
-
-    const existing = db
-      .select()
-      .from(memoryItems)
-      .where(and(
-        eq(memoryItems.id, playbookId),
-        eq(memoryItems.kind, 'playbook'),
-        eq(memoryItems.scopeId, scopeId),
-      ))
-      .get();
-
-    if (!existing) {
-      return { content: `Error: Playbook with ID "${playbookId}" not found`, isError: true };
-    }
-
-    const playbook = parsePlaybookStatement(existing.statement);
-    const triggerLabel = playbook?.trigger ?? existing.subject;
-
-    // Soft-delete by marking as superseded rather than hard-deleting,
-    // consistent with how other memory items are retired.
-    // Setting invalidAt so the cleanup job can eventually hard-delete it.
-    const now = Date.now();
-    db.update(memoryItems)
-      .set({ status: 'superseded', invalidAt: now })
-      .where(eq(memoryItems.id, existing.id))
-      .run();
-
-    return {
-      content: `Playbook deleted (ID: ${existing.id}, trigger: "${triggerLabel}").`,
-      isError: false,
-    };
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    return { content: `Error deleting playbook: ${msg}`, isError: true };
-  }
-}

package/src/tools/playbooks/playbook-list.ts

@@ -1,74 +0,0 @@
-import { and, desc, eq, isNull } from 'drizzle-orm';
-import type { ToolContext, ToolExecutionResult } from '../types.js';
-import { getDb } from '../../memory/db.js';
-import { memoryItems } from '../../memory/schema.js';
-import { parsePlaybookStatement } from '../../playbooks/types.js';
-
-export async function executePlaybookList(input: Record<string, unknown>, context: ToolContext): Promise<ToolExecutionResult> {
-  const scopeId = context.memoryScopeId ?? 'default';
-  const channelFilter = typeof input.channel === 'string' ? input.channel : null;
-  const categoryFilter = typeof input.category === 'string' ? input.category : null;
-
-  try {
-    const db = getDb();
-
-    const rows = db
-      .select({
-        id: memoryItems.id,
-        subject: memoryItems.subject,
-        statement: memoryItems.statement,
-        importance: memoryItems.importance,
-        lastSeenAt: memoryItems.lastSeenAt,
-      })
-      .from(memoryItems)
-      .where(and(
-        eq(memoryItems.kind, 'playbook'),
-        eq(memoryItems.status, 'active'),
-        eq(memoryItems.scopeId, scopeId),
-        isNull(memoryItems.invalidAt),
-      ))
-      .orderBy(desc(memoryItems.importance))
-      .all();
-
-    if (rows.length === 0) {
-      return { content: 'No playbooks found.', isError: false };
-    }
-
-    const entries: Array<{ id: string; subject: string; statement: string; playbook: NonNullable<ReturnType<typeof parsePlaybookStatement>> }> = [];
-    for (const row of rows) {
-      const playbook = parsePlaybookStatement(row.statement);
-      if (!playbook) continue;
-
-      // Apply filters
-      if (channelFilter && playbook.channel !== channelFilter && playbook.channel !== '*') continue;
-      if (categoryFilter && playbook.category !== categoryFilter) continue;
-
-      entries.push({ id: row.id, subject: row.subject, statement: row.statement, playbook });
-    }
-
-    if (entries.length === 0) {
-      const filters = [
-        channelFilter ? `channel="${channelFilter}"` : null,
-        categoryFilter ? `category="${categoryFilter}"` : null,
-      ].filter(Boolean).join(', ');
-      return { content: `No playbooks found matching ${filters}.`, isError: false };
-    }
-
-    // Sort by priority descending
-    entries.sort((a, b) => b.playbook.priority - a.playbook.priority);
-
-    const lines: string[] = [`Found ${entries.length} playbook(s):\n`];
-    for (const { id, playbook } of entries) {
-      const channelLabel = playbook.channel === '*' ? 'all channels' : playbook.channel;
-      const autonomyLabel = playbook.autonomyLevel === 'auto' ? 'auto'
-        : playbook.autonomyLevel === 'draft' ? 'draft' : 'notify';
-      lines.push(`- **${playbook.trigger}** (${channelLabel}) → ${playbook.action}`);
-      lines.push(`  _ID: ${id} | category: ${playbook.category} | autonomy: ${autonomyLabel} | priority: ${playbook.priority}_`);
-    }
-
-    return { content: lines.join('\n'), isError: false };
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    return { content: `Error listing playbooks: ${msg}`, isError: true };
-  }
-}

package/src/tools/playbooks/playbook-update.ts

@@ -1,111 +0,0 @@
-import { and, eq } from 'drizzle-orm';
-import type { ToolContext, ToolExecutionResult } from '../types.js';
-import { getDb } from '../../memory/db.js';
-import { computeMemoryFingerprint } from '../../memory/fingerprint.js';
-import { memoryItems } from '../../memory/schema.js';
-import { enqueueMemoryJob } from '../../memory/jobs-store.js';
-import { parsePlaybookStatement } from '../../playbooks/types.js';
-import type { Playbook, PlaybookAutonomyLevel } from '../../playbooks/types.js';
-import { truncate } from '../../util/truncate.js';
-
-const VALID_AUTONOMY_LEVELS = new Set<string>(['auto', 'draft', 'notify']);
-
-export async function executePlaybookUpdate(input: Record<string, unknown>, context: ToolContext): Promise<ToolExecutionResult> {
-  const playbookId = input.playbook_id as string;
-  if (!playbookId || typeof playbookId !== 'string') {
-    return { content: 'Error: playbook_id is required and must be a string', isError: true };
-  }
-
-  const scopeId = context.memoryScopeId ?? 'default';
-
-  try {
-    const db = getDb();
-
-    const existing = db
-      .select()
-      .from(memoryItems)
-      .where(and(
-        eq(memoryItems.id, playbookId),
-        eq(memoryItems.kind, 'playbook'),
-        eq(memoryItems.scopeId, scopeId),
-      ))
-      .get();
-
-    if (!existing) {
-      return { content: `Error: Playbook with ID "${playbookId}" not found`, isError: true };
-    }
-
-    const currentPlaybook = parsePlaybookStatement(existing.statement);
-    if (!currentPlaybook) {
-      return { content: `Error: Playbook data is corrupted for ID "${playbookId}"`, isError: true };
-    }
-
-    // Merge updates onto existing playbook
-    const updated: Playbook = {
-      trigger: typeof input.trigger === 'string' ? input.trigger : currentPlaybook.trigger,
-      channel: typeof input.channel === 'string' ? input.channel : currentPlaybook.channel,
-      category: typeof input.category === 'string' ? input.category : currentPlaybook.category,
-      action: typeof input.action === 'string' ? input.action : currentPlaybook.action,
-      autonomyLevel:
-        typeof input.autonomy_level === 'string' && VALID_AUTONOMY_LEVELS.has(input.autonomy_level)
-          ? (input.autonomy_level as PlaybookAutonomyLevel)
-          : currentPlaybook.autonomyLevel,
-      priority: typeof input.priority === 'number' ? input.priority : currentPlaybook.priority,
-    };
-
-    const statement = JSON.stringify(updated);
-    const subject = truncate(`Playbook: ${updated.trigger}`, 80, '');
-    const now = Date.now();
-
-    const fingerprint = computeMemoryFingerprint(scopeId, 'playbook', subject, statement);
-
-    // Check if another playbook already has this fingerprint
-    const collision = db
-      .select({ id: memoryItems.id })
-      .from(memoryItems)
-      .where(and(
-        eq(memoryItems.fingerprint, fingerprint),
-        eq(memoryItems.scopeId, scopeId),
-      ))
-      .get();
-    if (collision && collision.id !== existing.id) {
-      return {
-        content: `Error: Another playbook with this exact configuration already exists (ID: ${collision.id}).`,
-        isError: true,
-      };
-    }
-
-    db.update(memoryItems)
-      .set({
-        subject,
-        statement,
-        fingerprint,
-        lastSeenAt: now,
-        verificationState: 'user_confirmed',
-      })
-      .where(eq(memoryItems.id, existing.id))
-      .run();
-
-    enqueueMemoryJob('embed_item', { itemId: existing.id });
-
-    const autonomyLabel = updated.autonomyLevel === 'auto' ? 'execute automatically'
-      : updated.autonomyLevel === 'draft' ? 'draft for review' : 'notify only';
-
-    return {
-      content: [
-        'Playbook updated successfully.',
-        `  ID: ${existing.id}`,
-        `  Trigger: ${updated.trigger}`,
-        `  Channel: ${updated.channel}`,
-        `  Category: ${updated.category}`,
-        `  Action: ${updated.action}`,
-        `  Autonomy: ${autonomyLabel}`,
-        `  Priority: ${updated.priority}`,
-      ].join('\n'),
-      isError: false,
-    };
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    return { content: `Error updating playbook: ${msg}`, isError: true };
-  }
-}