@vellumai/assistant 0.7.0 → 0.7.2

package/src/context/microcompact.ts

@@ -1,443 +0,0 @@
-import type {
-  ContentBlock,
-  Message,
-  ToolResultContent,
-} from "../providers/types.js";
-import { estimateTextTokens } from "./token-estimator.js";
-
-// ---------------------------------------------------------------------------
-// Constants
-// ---------------------------------------------------------------------------
-
-/** Default number of recent user-assistant exchanges to keep untouched. */
-const DEFAULT_PROTECT_RECENT_TURNS = 4;
-
-/** Default minimum reclaimable tokens required before we commit a pass. */
-const DEFAULT_MIN_GAIN_TOKENS = 2_000;
-
-/**
- * Default list of tool names whose results are never wholesale-cleared.
- * Matches opencode's `PRUNE_PROTECTED_TOOLS` and Claude Code's equivalent —
- * protects subagent outputs and curated skill results, which are expensive
- * to regenerate and usually load-bearing for the rest of the conversation.
- *
- * Note: ax-tree stripping still applies to protected tool results. Only the
- * full-body replacement is skipped.
- */
-const DEFAULT_PROTECTED_TOOLS: readonly string[] = [
-  "Task",
-  "subagent",
-  "skill",
-];
-
-/** Replacement body for cleared tool-result content. */
-const CLEARED_TOOL_RESULT_TEXT = "[Old tool result content cleared]";
-
-/** Replacement text for stubbed image blocks. */
-const CLEARED_IMAGE_TEXT = "[image omitted]";
-
-/** Replacement text for stubbed file blocks. */
-const CLEARED_FILE_TEXT = "[file omitted]";
-
-/**
- * Regex that matches `<ax-tree>...</ax-tree>` blocks (non-greedy).
- * Kept in sync with `AX_TREE_PATTERN` in `assistant/src/agent/loop.ts`; this
- * module subsumes that function's responsibility for stale tool results.
- */
-const AX_TREE_PATTERN = /<ax-tree>[\s\S]*?<\/ax-tree>/g;
-
-/** Placeholder inserted in place of a stripped ax-tree block. */
-const AX_TREE_PLACEHOLDER = "<ax_tree_omitted />";
-
-// ---------------------------------------------------------------------------
-// Types
-// ---------------------------------------------------------------------------
-
-export interface MicrocompactOptions {
-  /** Preserve the last N user-assistant exchanges verbatim. Default 4. */
-  protectRecentTurns?: number;
-  /** Tool names whose results are never microcompacted (e.g. "Task", sub-agents). */
-  protectedTools?: string[];
-  /** Minimum reclaimable tokens required to bother — skip no-op passes. Default 2000. */
-  minGainTokens?: number;
-}
-
-export interface MicrocompactResult {
-  messages: Message[];
-  reclaimedTokens: number;
-  clearedToolResults: number;
-  /** Count of image + file blocks that were replaced with text stubs. */
-  clearedMedia: number;
-}
-
-// ---------------------------------------------------------------------------
-// Public API
-// ---------------------------------------------------------------------------
-
-/**
- * Deterministically compact stale content in the message history.
- *
- * Walks `messages` from newest to oldest. The most recent
- * `protectRecentTurns` user-assistant exchanges are left untouched. In the
- * older region:
- *
- *  - Each `tool_result` whose owning tool is NOT in `protectedTools` has its
- *    `content` replaced with a short placeholder.
- *  - Every `image` / `file` block is replaced with a text stub.
- *  - `<ax-tree>...</ax-tree>` blocks inside any tool_result (including
- *    protected ones) are collapsed to a placeholder, subsuming the old
- *    `compactAxTreeHistory` in `assistant/src/agent/loop.ts`.
- *
- * The `tool_use` / `tool_result` block structure is preserved — we only
- * mutate block bodies, never the block types or their pairing — so provider
- * serialization remains valid after compaction.
- *
- * If the estimated savings (`reclaimedTokens`) is below `minGainTokens`, the
- * original `messages` reference is returned unchanged. The pass is
- * idempotent: re-invoking on a previously compacted history produces zero
- * incremental reclaim.
- */
-export function microcompact(
-  messages: Message[],
-  options?: MicrocompactOptions,
-): MicrocompactResult {
-  const protectRecentTurns =
-    options?.protectRecentTurns ?? DEFAULT_PROTECT_RECENT_TURNS;
-  const minGainTokens = options?.minGainTokens ?? DEFAULT_MIN_GAIN_TOKENS;
-  const protectedToolSet = new Set(
-    options?.protectedTools ?? DEFAULT_PROTECTED_TOOLS,
-  );
-
-  if (messages.length === 0) {
-    return {
-      messages,
-      reclaimedTokens: 0,
-      clearedToolResults: 0,
-      clearedMedia: 0,
-    };
-  }
-
-  // Build a lookup of tool_use_id -> tool name by scanning every assistant
-  // message. Tool_use_ids are globally unique within a conversation so a
-  // single map is valid for the whole history.
-  const toolNameById = buildToolNameLookup(messages);
-
-  // Determine the index up to which messages are "protected" (left alone).
-  // Anything at index >= firstProtectedIdx is in the protected tail; the
-  // older region (indices < firstProtectedIdx) is where we clear.
-  const firstProtectedIdx = computeProtectedBoundary(
-    messages,
-    protectRecentTurns,
-  );
-
-  if (firstProtectedIdx <= 0) {
-    // Every message is protected — nothing to clear.
-    return {
-      messages,
-      reclaimedTokens: 0,
-      clearedToolResults: 0,
-      clearedMedia: 0,
-    };
-  }
-
-  let reclaimedTokens = 0;
-  let clearedToolResults = 0;
-  let clearedMedia = 0;
-  let anyChange = false;
-
-  const nextMessages: Message[] = messages.map((msg, idx) => {
-    if (idx >= firstProtectedIdx) return msg;
-
-    let changed = false;
-    const nextContent: ContentBlock[] = msg.content.map((block) => {
-      // guard:allow-tool-result-only — compaction here operates on locally-
-      // executed `tool_result` bodies (string `.content`, possible
-      // `.contentBlocks` media). `web_search_tool_result` has an opaque
-      // encrypted content shape and is never microcompacted; it's treated as
-      // a tool-response only in `isToolResultOnlyUserMessage` above.
-      if (block.type === "tool_result") {
-        const tr = block as ToolResultContent;
-        const toolName = toolNameById.get(tr.tool_use_id);
-        const isProtected = toolName != null && protectedToolSet.has(toolName);
-
-        const { replacement, tokensSaved, didChange, cleared } =
-          compactToolResult(tr, isProtected);
-        if (didChange) {
-          reclaimedTokens += tokensSaved;
-          if (cleared) clearedToolResults += 1;
-          changed = true;
-          return replacement;
-        }
-        return block;
-      }
-
-      if (block.type === "image") {
-        const saved = estimateImageReclaim(block);
-        // Only count a reclaim if stubbing actually shrinks the block.
-        // The stub is always valid, but avoid double-counting no-op cases.
-        reclaimedTokens += saved;
-        clearedMedia += 1;
-        changed = true;
-        return { type: "text", text: CLEARED_IMAGE_TEXT };
-      }
-
-      if (block.type === "file") {
-        const saved = estimateFileReclaim(block);
-        reclaimedTokens += saved;
-        clearedMedia += 1;
-        changed = true;
-        return { type: "text", text: CLEARED_FILE_TEXT };
-      }
-
-      return block;
-    });
-
-    if (!changed) return msg;
-    anyChange = true;
-    return { ...msg, content: nextContent };
-  });
-
-  if (!anyChange || reclaimedTokens < minGainTokens) {
-    return {
-      messages,
-      reclaimedTokens: 0,
-      clearedToolResults: 0,
-      clearedMedia: 0,
-    };
-  }
-
-  return {
-    messages: nextMessages,
-    reclaimedTokens,
-    clearedToolResults,
-    clearedMedia,
-  };
-}
-
-// ---------------------------------------------------------------------------
-// Internals
-// ---------------------------------------------------------------------------
-
-function buildToolNameLookup(messages: Message[]): Map<string, string> {
-  const map = new Map<string, string>();
-  for (const msg of messages) {
-    if (msg.role !== "assistant") continue;
-    for (const block of msg.content) {
-      if (block.type === "tool_use") {
-        map.set(block.id, block.name);
-      }
-    }
-  }
-  return map;
-}
-
-/**
- * Return the index of the first message that is inside the "protected tail".
- *
- * A user-assistant exchange begins at a user message that carries real user
- * content (i.e. not a tool_result-only follow-up, which is how the provider
- * encodes the tool response turn). We walk newest-to-oldest and, once we've
- * seen `protectRecentTurns` such user-turn starts, return the index of the
- * oldest such start. Everything at or after that index is protected.
- *
- * If the history has fewer than `protectRecentTurns` user turns, protect the
- * entire history by returning 0.
- */
-function computeProtectedBoundary(
-  messages: Message[],
-  protectRecentTurns: number,
-): number {
-  if (protectRecentTurns <= 0) return messages.length;
-
-  let seen = 0;
-  for (let i = messages.length - 1; i >= 0; i--) {
-    const msg = messages[i];
-    if (msg.role !== "user") continue;
-    if (isToolResultOnlyUserMessage(msg)) continue;
-    seen += 1;
-    if (seen >= protectRecentTurns) {
-      return i;
-    }
-  }
-  // Fewer user turns than the protection budget — protect everything.
-  return 0;
-}
-
-/**
- * A user message that contains only tool-response blocks (or system-injected
- * metadata) represents the response side of a tool call rather than a fresh
- * user turn.
- *
- * Qualifying blocks:
- *  - `tool_result` — locally-executed tool responses.
- *  - `web_search_tool_result` — server-side web-search responses. Same
- *    semantic as `tool_result` (paired with a prior `server_tool_use`), just
- *    a distinct discriminant. Missing this variant would cause these
- *    messages to masquerade as real user turns and eat `protectRecentTurns`
- *    budget on tool churn.
- *  - `text` blocks whose body is wholly inside `<system_notice>...</system_notice>`.
- *    Those are system-injected reminders/progress checks, not user-authored.
- */
-function isToolResultOnlyUserMessage(message: Message): boolean {
-  if (message.content.length === 0) return false;
-  return message.content.every(isToolResponseOrSystemNoticeBlock);
-}
-
-function isToolResponseOrSystemNoticeBlock(block: ContentBlock): boolean {
-  if (block.type === "tool_result" || block.type === "web_search_tool_result") {
-    return true;
-  }
-  if (block.type === "text") {
-    const text = block.text;
-    return (
-      text.startsWith("<system_notice>") && text.endsWith("</system_notice>")
-    );
-  }
-  return false;
-}
-
-/**
- * Compact a single tool_result block in the stripped region.
- *
- *  - If `isProtected` is true, we keep the body but strip `<ax-tree>` blocks
- *    and drop media (image/file) entries from `contentBlocks`, preserving
- *    any text entries so meaningful tool output isn't silently removed.
- *  - Otherwise we replace the body with a short placeholder and drop
- *    `contentBlocks` entirely.
- *
- * `tokensSaved` is the delta between the original and the replacement as
- * measured by `estimateTextTokens`, floored at 0. `cleared` is true only when
- * we fully replaced the body (i.e. counted against `clearedToolResults`).
- */
-function compactToolResult(
-  block: ToolResultContent,
-  isProtected: boolean,
-): {
-  replacement: ToolResultContent;
-  tokensSaved: number;
-  didChange: boolean;
-  cleared: boolean;
-} {
-  const originalContent = block.content;
-  const originalContentTokens = estimateTextTokens(originalContent);
-
-  // Rich contentBlocks may include text (meaningful tool output) alongside
-  // media (images/files). For UNPROTECTED results we drop the entire array
-  // (the body is being wholesale-replaced). For PROTECTED results we keep
-  // text entries but strip media — images aren't the expensive part of a
-  // subagent result and are rarely load-bearing once the turn is stale, but
-  // text entries can carry real content we must not silently erase.
-  const originalContentBlocks = block.contentBlocks;
-  const hadContentBlocks =
-    originalContentBlocks != null && originalContentBlocks.length > 0;
-
-  let preservedContentBlocks: ContentBlock[] | undefined;
-  let droppedBlocksTokens = 0;
-  if (hadContentBlocks) {
-    if (isProtected) {
-      const kept: ContentBlock[] = [];
-      for (const cb of originalContentBlocks) {
-        if (cb.type === "text") {
-          kept.push(cb);
-        } else {
-          droppedBlocksTokens += estimateContentBlockTokenCost(cb);
-        }
-      }
-      preservedContentBlocks = kept;
-    } else {
-      for (const cb of originalContentBlocks) {
-        droppedBlocksTokens += estimateContentBlockTokenCost(cb);
-      }
-      preservedContentBlocks = undefined;
-    }
-  }
-
-  let newContent: string;
-  let cleared: boolean;
-  if (isProtected) {
-    // Strip ax-tree blocks but keep the rest of the text body.
-    newContent = originalContent.replace(AX_TREE_PATTERN, AX_TREE_PLACEHOLDER);
-    cleared = false;
-  } else {
-    newContent = CLEARED_TOOL_RESULT_TEXT;
-    cleared = true;
-  }
-
-  const newContentTokens = estimateTextTokens(newContent);
-  const bodyTokensSaved = originalContentTokens - newContentTokens;
-
-  const bodyChanged = newContent !== originalContent;
-  // A protected result with only text contentBlocks would be a no-op — nothing
-  // meaningful would be dropped. Only count contentBlocks as a "change" when
-  // we actually drop at least one entry.
-  const contentBlocksChanged = hadContentBlocks && droppedBlocksTokens > 0;
-  const didChange = bodyChanged || contentBlocksChanged;
-
-  if (!didChange) {
-    return {
-      replacement: block,
-      tokensSaved: 0,
-      didChange: false,
-      cleared: false,
-    };
-  }
-
-  const tokensSaved = Math.max(0, bodyTokensSaved + droppedBlocksTokens);
-
-  const replacement: ToolResultContent = {
-    type: "tool_result",
-    tool_use_id: block.tool_use_id,
-    content: newContent,
-  };
-  if (block.is_error != null) {
-    replacement.is_error = block.is_error;
-  }
-  if (preservedContentBlocks != null && preservedContentBlocks.length > 0) {
-    replacement.contentBlocks = preservedContentBlocks;
-  }
-
-  return {
-    replacement,
-    tokensSaved,
-    didChange,
-    cleared: cleared && bodyChanged,
-  };
-}
-
-function estimateImageReclaim(
-  block: Extract<ContentBlock, { type: "image" }>,
-): number {
-  // Base64 payloads are the expensive part of image blocks for our naive
-  // char/4 heuristic. The Anthropic-aware estimator in `token-estimator.ts`
-  // charges per-pixel — we deliberately use the simpler heuristic here so
-  // the reclaim number is a conservative lower bound on actual savings.
-  const payloadTokens = estimateTextTokens(block.source.data);
-  const stubTokens = estimateTextTokens(CLEARED_IMAGE_TEXT);
-  return Math.max(0, payloadTokens - stubTokens);
-}
-
-function estimateFileReclaim(
-  block: Extract<ContentBlock, { type: "file" }>,
-): number {
-  const payloadTokens =
-    estimateTextTokens(block.source.data) +
-    estimateTextTokens(block.extracted_text ?? "");
-  const stubTokens = estimateTextTokens(CLEARED_FILE_TEXT);
-  return Math.max(0, payloadTokens - stubTokens);
-}
-
-function estimateContentBlockTokenCost(block: ContentBlock): number {
-  switch (block.type) {
-    case "text":
-      return estimateTextTokens(block.text);
-    case "image":
-      return estimateTextTokens(block.source.data);
-    case "file":
-      return (
-        estimateTextTokens(block.source.data) +
-        estimateTextTokens(block.extracted_text ?? "")
-      );
-    default:
-      return 0;
-  }
-}

package/src/daemon/handlers/slack-channel-oauth-install.ts

@@ -1,197 +0,0 @@
-/**
- * Runs an OAuth2 loopback flow to install the user's Slack app and capture
- * bot + user tokens in a single exchange.
- *
- * Prerequisites: client_id, client_secret, and app_token must already be
- * stored in the credential vault (service: slack_channel).
- *
- * The handler reads client credentials from secure storage, starts a
- * loopback OAuth server on port 17322, opens the browser to Slack's
- * authorize URL, and waits for the user to click "Allow". Slack's
- * oauth.v2.access response contains both the bot token (access_token)
- * and user token (authed_user.access_token). Both are stored via
- * setSlackChannelConfig.
- */
-
-import { credentialKey } from "../../security/credential-key.js";
-import { startOAuth2Flow } from "../../security/oauth2.js";
-import { getSecureKeyAsync } from "../../security/secure-keys.js";
-import { openInHostBrowser } from "../../util/browser.js";
-import { getLogger } from "../../util/logger.js";
-import { setSlackChannelConfig } from "./config-slack-channel.js";
-
-const log = getLogger("slack-channel-oauth-install");
-
-/** Port pre-registered for Slack in seed-providers.ts. */
-const SLACK_LOOPBACK_PORT = 17322;
-
-/** Bot scopes matching the manifest in SKILL.md. */
-const BOT_SCOPES = [
-  "app_mentions:read",
-  "assistant:write",
-  "channels:history",
-  "channels:join",
-  "channels:read",
-  "chat:write",
-  "files:read",
-  "files:write",
-  "groups:history",
-  "groups:read",
-  "im:history",
-  "im:read",
-  "im:write",
-  "mpim:history",
-  "mpim:read",
-  "reactions:read",
-  "reactions:write",
-  "users:read",
-];
-
-/** User scopes matching the manifest in SKILL.md. */
-const USER_SCOPES = [
-  "channels:history",
-  "channels:read",
-  "groups:history",
-  "groups:read",
-  "im:history",
-  "im:read",
-  "mpim:history",
-  "mpim:read",
-  "users:read",
-  "search:read",
-  "reactions:read",
-];
-
-export interface SlackOAuthInstallResult {
-  success: boolean;
-  hasBotToken: boolean;
-  hasUserToken: boolean;
-  error?: string;
-}
-
-export async function runSlackChannelOAuthInstall(): Promise<SlackOAuthInstallResult> {
-  // Read client credentials from secure storage
-  const clientId = await getSecureKeyAsync(
-    credentialKey("slack_channel", "client_id"),
-  );
-  if (!clientId) {
-    return {
-      success: false,
-      hasBotToken: false,
-      hasUserToken: false,
-      error:
-        "Client ID not found in credential store. Store it first via credential_store prompt (service: slack_channel, field: client_id).",
-    };
-  }
-
-  const clientSecret = await getSecureKeyAsync(
-    credentialKey("slack_channel", "client_secret"),
-  );
-  if (!clientSecret) {
-    return {
-      success: false,
-      hasBotToken: false,
-      hasUserToken: false,
-      error:
-        "Client Secret not found in credential store. Store it first via credential_store prompt (service: slack_channel, field: client_secret).",
-    };
-  }
-
-  const appToken = await getSecureKeyAsync(
-    credentialKey("slack_channel", "app_token"),
-  );
-  if (!appToken) {
-    return {
-      success: false,
-      hasBotToken: false,
-      hasUserToken: false,
-      error:
-        "App Token not found in credential store. Store it first via credential_store prompt (service: slack_channel, field: app_token).",
-    };
-  }
-
-  log.info("Starting Slack OAuth install flow via loopback");
-
-  let result;
-  try {
-    result = await startOAuth2Flow(
-      {
-        authorizeUrl: "https://slack.com/oauth/v2/authorize",
-        tokenExchangeUrl: "https://slack.com/api/oauth.v2.access",
-        scopes: BOT_SCOPES,
-        clientId,
-        clientSecret,
-        scopeSeparator: ",",
-        authorizeParams: {
-          user_scope: USER_SCOPES.join(","),
-        },
-      },
-      {
-        openUrl: (url) => openInHostBrowser(url),
-      },
-      {
-        callbackTransport: "loopback",
-        loopbackPort: SLACK_LOOPBACK_PORT,
-      },
-    );
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    log.error({ err: msg }, "Slack OAuth install flow failed");
-    return {
-      success: false,
-      hasBotToken: false,
-      hasUserToken: false,
-      error: `OAuth flow failed: ${msg}`,
-    };
-  }
-
-  // Slack's oauth.v2.access returns:
-  //   access_token: "xoxb-..." (bot token)
-  //   authed_user: { access_token: "xoxp-..." } (user token)
-  const raw = result.rawTokenResponse;
-  const botToken = raw.access_token as string | undefined;
-  const authedUser = raw.authed_user as { access_token?: string } | undefined;
-  const userToken = authedUser?.access_token as string | undefined;
-
-  if (!botToken) {
-    log.error(
-      { rawKeys: Object.keys(raw) },
-      "Slack OAuth response missing bot access_token",
-    );
-    return {
-      success: false,
-      hasBotToken: false,
-      hasUserToken: false,
-      error:
-        "Slack OAuth response did not include a bot token (access_token). The app may not have bot scopes configured.",
-    };
-  }
-
-  log.info(
-    { hasBotToken: true, hasUserToken: !!userToken },
-    "Slack OAuth tokens received, storing via setSlackChannelConfig",
-  );
-
-  // Store bot token (and user token if present) via the Slack channel handler,
-  // which validates tokens and persists workspace metadata.
-  const configResult = await setSlackChannelConfig(
-    botToken,
-    appToken,
-    userToken,
-  );
-
-  if (!configResult.success) {
-    return {
-      success: false,
-      hasBotToken: false,
-      hasUserToken: false,
-      error: configResult.error ?? "Failed to store Slack tokens",
-    };
-  }
-
-  return {
-    success: true,
-    hasBotToken: true,
-    hasUserToken: !!userToken,
-  };
-}

package/src/daemon/message-types/pairing.ts

@@ -1,58 +0,0 @@
-// Pairing approval and approved-device management types.
-
-// === Client → Server ===
-
-export interface PairingApprovalResponse {
-  type: "pairing_approval_response";
-  pairingRequestId: string;
-  decision: "approve_once" | "always_allow" | "deny";
-}
-
-export interface ApprovedDevicesList {
-  type: "approved_devices_list";
-}
-
-export interface ApprovedDeviceRemove {
-  type: "approved_device_remove";
-  hashedDeviceId: string;
-}
-
-export interface ApprovedDevicesClear {
-  type: "approved_devices_clear";
-}
-
-// === Server → Client ===
-
-export interface PairingApprovalRequest {
-  type: "pairing_approval_request";
-  pairingRequestId: string;
-  deviceId: string;
-  deviceName: string;
-}
-
-export interface ApprovedDevicesListResponse {
-  type: "approved_devices_list_response";
-  devices: Array<{
-    hashedDeviceId: string;
-    deviceName: string;
-    lastPairedAt: number;
-  }>;
-}
-
-export interface ApprovedDeviceRemoveResponse {
-  type: "approved_device_remove_response";
-  success: boolean;
-}
-
-// --- Domain-level union aliases (consumed by the barrel file) ---
-
-export type _PairingClientMessages =
-  | PairingApprovalResponse
-  | ApprovedDevicesList
-  | ApprovedDeviceRemove
-  | ApprovedDevicesClear;
-
-export type _PairingServerMessages =
-  | PairingApprovalRequest
-  | ApprovedDevicesListResponse
-  | ApprovedDeviceRemoveResponse;