@accomplish_ai/agent-core 0.2.0 → 0.2.2

package/mcp-tools/dev-browser-mcp/src/snapshot/priority.ts

@@ -1,84 +0,0 @@
-export interface TruncatableElement {
-  ref: string;
-  role: string;
-  name: string;
-  inViewport: boolean;
-  [key: string]: unknown;
-}
-
-export interface TruncateOptions {
-  maxElements?: number;
-}
-
-export interface TruncateResult<T extends TruncatableElement> {
-  elements: T[];
-  totalElements: number;
-  includedElements: number;
-  truncated: boolean;
-}
-
-export const ROLE_PRIORITIES: Record<string, number> = {
-  button: 100,
-  textbox: 95,
-  searchbox: 95,
-  checkbox: 90,
-  radio: 90,
-  switch: 90,
-  combobox: 85,
-  listbox: 85,
-  slider: 85,
-  spinbutton: 85,
-  link: 80,
-  tab: 75,
-  menuitem: 70,
-  menuitemcheckbox: 70,
-  menuitemradio: 70,
-  option: 70,
-  navigation: 60,
-  menu: 60,
-  tablist: 55,
-  form: 50,
-  dialog: 50,
-  alertdialog: 50,
-};
-
-const VIEWPORT_BONUS = 50;
-const DEFAULT_PRIORITY = 50;
-
-export function getElementPriority(role: string, inViewport: boolean): number {
-  const basePriority = ROLE_PRIORITIES[role] ?? DEFAULT_PRIORITY;
-  return inViewport ? basePriority + VIEWPORT_BONUS : basePriority;
-}
-
-export function truncateElements<T extends TruncatableElement>(
-  elements: T[],
-  options: TruncateOptions
-): TruncateResult<T> {
-  const maxElements = options.maxElements ?? 300;
-  const totalElements = elements.length;
-
-  if (totalElements <= maxElements) {
-    return {
-      elements,
-      totalElements,
-      includedElements: totalElements,
-      truncated: false,
-    };
-  }
-
-  const scored = elements.map(element => ({
-    element,
-    score: getElementPriority(element.role, element.inViewport),
-  }));
-
-  scored.sort((a, b) => b.score - a.score);
-
-  const truncatedElements = scored.slice(0, maxElements).map(s => s.element);
-
-  return {
-    elements: truncatedElements,
-    totalElements,
-    includedElements: maxElements,
-    truncated: true,
-  };
-}

package/mcp-tools/dev-browser-mcp/src/snapshot/tokens.test.ts

@@ -1,64 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { estimateTokens, estimateElementTokens } from './tokens';
-
-describe('token estimation', () => {
-  describe('estimateElementTokens', () => {
-    it('should estimate basic element at ~15 tokens', () => {
-      const tokens = estimateElementTokens({
-        role: 'button',
-        name: 'Submit',
-        ref: 'e1',
-      });
-      // role (1) + name (2) + ref (2) + yaml overhead (5) + attributes (2-5)
-      expect(tokens).toBeGreaterThanOrEqual(10);
-      expect(tokens).toBeLessThanOrEqual(20);
-    });
-
-    it('should cap long names at 50 token contribution', () => {
-      const shortName = estimateElementTokens({
-        role: 'button',
-        name: 'OK',
-        ref: 'e1',
-      });
-      const longName = estimateElementTokens({
-        role: 'button',
-        name: 'A'.repeat(1000), // Very long name
-        ref: 'e2',
-      });
-      // Difference should be at most 50 (capped)
-      expect(longName - shortName).toBeLessThanOrEqual(50);
-    });
-
-    it('should add tokens for extra attributes', () => {
-      const basic = estimateElementTokens({
-        role: 'checkbox',
-        name: 'Accept',
-        ref: 'e1',
-      });
-      const withAttrs = estimateElementTokens({
-        role: 'checkbox',
-        name: 'Accept',
-        ref: 'e1',
-        checked: true,
-        disabled: true,
-      });
-      expect(withAttrs).toBeGreaterThan(basic);
-    });
-  });
-
-  describe('estimateTokens', () => {
-    it('should estimate YAML string tokens', () => {
-      const yaml = `- button "Submit" [ref=e1]
-- textbox "Email" [ref=e2]
-- link "Home" [ref=e3]`;
-      const tokens = estimateTokens(yaml);
-      // ~15 tokens per element * 3 = ~45
-      expect(tokens).toBeGreaterThanOrEqual(30);
-      expect(tokens).toBeLessThanOrEqual(60);
-    });
-
-    it('should handle empty string', () => {
-      expect(estimateTokens('')).toBe(0);
-    });
-  });
-});

package/mcp-tools/dev-browser-mcp/src/snapshot/tokens.ts

@@ -1,36 +0,0 @@
-import type { SnapshotElement } from './types';
-
-const CHARS_PER_TOKEN = 2;
-const YAML_OVERHEAD = 5;
-const ATTRIBUTE_TOKENS = 2;
-const MAX_NAME_TOKENS = 50;
-
-export function estimateElementTokens(element: Partial<SnapshotElement>): number {
-  let tokens = YAML_OVERHEAD;
-
-  tokens += Math.ceil((element.role?.length ?? 0) / CHARS_PER_TOKEN);
-
-  const nameLength = element.name?.length ?? 0;
-  const nameTokens = Math.ceil(nameLength / CHARS_PER_TOKEN);
-  tokens += Math.min(nameTokens, MAX_NAME_TOKENS);
-
-  tokens += 2;
-
-  if (element.checked !== undefined) tokens += ATTRIBUTE_TOKENS;
-  if (element.disabled !== undefined) tokens += ATTRIBUTE_TOKENS;
-  if (element.expanded !== undefined) tokens += ATTRIBUTE_TOKENS;
-  if (element.selected !== undefined) tokens += ATTRIBUTE_TOKENS;
-  if (element.pressed !== undefined) tokens += ATTRIBUTE_TOKENS;
-
-  if (element.value) {
-    const valueTokens = Math.ceil(element.value.length / CHARS_PER_TOKEN);
-    tokens += Math.min(valueTokens, MAX_NAME_TOKENS);
-  }
-
-  return tokens;
-}
-
-export function estimateTokens(yaml: string): number {
-  if (!yaml) return 0;
-  return Math.ceil(yaml.length / CHARS_PER_TOKEN);
-}

package/mcp-tools/dev-browser-mcp/src/snapshot/types.ts

@@ -1,89 +0,0 @@
-export interface SnapshotElement {
-  ref: string;
-  role: string;
-  name: string;
-  value?: string;
-  checked?: boolean | 'mixed';
-  disabled?: boolean;
-  expanded?: boolean;
-  selected?: boolean;
-  level?: number;
-  pressed?: boolean | 'mixed';
-  url?: string;
-  placeholder?: string;
-}
-
-export interface ElementPriority {
-  ref: string;
-  score: number;
-  inViewport: boolean;
-}
-
-export interface SnapshotMetadata {
-  totalElements: number;
-  includedElements: number;
-  truncated: boolean;
-  estimatedTokens: number;
-}
-
-export interface ParsedSnapshot {
-  url: string;
-  title: string;
-  timestamp: number;
-  elements: Map<string, SnapshotElement>;
-  rawYaml: string;
-  metadata?: SnapshotMetadata;
-}
-
-export interface SnapshotOptions {
-  fullSnapshot?: boolean;
-  interactiveOnly?: boolean;
-  maxElements?: number;
-  viewportOnly?: boolean;
-  maxTokens?: number;
-  includeHistory?: boolean;
-}
-
-export const DEFAULT_SNAPSHOT_OPTIONS: Required<SnapshotOptions> = {
-  fullSnapshot: false,
-  interactiveOnly: true,
-  maxElements: 300,
-  viewportOnly: false,
-  maxTokens: 8000,
-  includeHistory: true,
-};
-
-export interface ElementChange {
-  ref: string;
-  element: SnapshotElement;
-  previousValue?: string;
-  previousChecked?: boolean | 'mixed';
-  previousDisabled?: boolean;
-  previousExpanded?: boolean;
-  previousSelected?: boolean;
-  changeType: 'added' | 'modified' | 'removed';
-}
-
-export interface SnapshotDiff {
-  unchangedRefs: string[];
-  changes: ElementChange[];
-  addedRefs: string[];
-  removedRefs: string[];
-}
-
-export type SnapshotResult =
-  | { type: 'full'; content: string }
-  | { type: 'diff'; content: string; unchangedRefs: string[] };
-
-export interface SessionHistoryEntry {
-  url: string;
-  title: string;
-  timestamp: number;
-  actionsTaken: string[];
-}
-
-export interface SessionSummary {
-  history: string;
-  pagesVisited: number;
-  navigationPatternHash?: string;
-}

package/mcp-tools/dev-browser-mcp/tsconfig.json

@@ -1,15 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "esModuleInterop": true,
-    "strict": true,
-    "skipLibCheck": true,
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "noEmit": true
-  },
-  "include": ["src/**/*.ts"],
-  "exclude": ["node_modules"]
-}

package/mcp-tools/file-permission/src/index.ts

@@ -1,125 +0,0 @@
-#!/usr/bin/env node
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema,
-  type CallToolResult,
-} from '@modelcontextprotocol/sdk/types.js';
-
-const PERMISSION_API_PORT = process.env.PERMISSION_API_PORT || '9226';
-const PERMISSION_API_URL = `http://localhost:${PERMISSION_API_PORT}/permission`;
-
-interface FilePermissionInput {
-  operation: 'create' | 'delete' | 'rename' | 'move' | 'modify' | 'overwrite';
-  filePath?: string;
-  filePaths?: string[];
-  targetPath?: string;
-  contentPreview?: string;
-}
-
-const server = new Server(
-  { name: 'file-permission', version: '1.0.0' },
-  { capabilities: { tools: {} } }
-);
-
-server.setRequestHandler(ListToolsRequestSchema, async () => ({
-  tools: [
-    {
-      name: 'request_file_permission',
-      description:
-        'Request user permission before performing file operations (create, delete, rename, move, modify, overwrite). Always call this tool BEFORE executing any file modification. Returns "allowed" or "denied".',
-      inputSchema: {
-        type: 'object',
-        properties: {
-          operation: {
-            type: 'string',
-            enum: ['create', 'delete', 'rename', 'move', 'modify', 'overwrite'],
-            description: 'The type of file operation to perform',
-          },
-          filePath: {
-            type: 'string',
-            description: 'Absolute path to the file being operated on',
-          },
-          filePaths: {
-            type: 'array',
-            items: { type: 'string' },
-            description: 'Array of absolute paths for batch operations (e.g., deleting multiple files)',
-          },
-          targetPath: {
-            type: 'string',
-            description: 'Target path for rename/move operations',
-          },
-          contentPreview: {
-            type: 'string',
-            description: 'Preview of file content for create/modify operations (first ~500 chars)',
-          },
-        },
-        required: ['operation'],
-      },
-    },
-  ],
-}));
-
-server.setRequestHandler(CallToolRequestSchema, async (request): Promise<CallToolResult> => {
-  if (request.params.name !== 'request_file_permission') {
-    return {
-      content: [{ type: 'text', text: `Error: Unknown tool: ${request.params.name}` }],
-      isError: true,
-    };
-  }
-
-  const args = request.params.arguments as FilePermissionInput;
-  const { operation, filePath, filePaths, targetPath, contentPreview } = args;
-
-  if (!operation || (!filePath && (!filePaths || filePaths.length === 0))) {
-    return {
-      content: [{ type: 'text', text: 'Error: operation and either filePath or filePaths are required' }],
-      isError: true,
-    };
-  }
-
-  try {
-    const response = await fetch(PERMISSION_API_URL, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({
-        operation,
-        filePath,
-        filePaths,
-        targetPath,
-        contentPreview: contentPreview?.substring(0, 500),
-      }),
-    });
-
-    if (!response.ok) {
-      const errorText = await response.text();
-      return {
-        content: [{ type: 'text', text: `Error: Permission API returned ${response.status}: ${errorText}` }],
-        isError: true,
-      };
-    }
-
-    const result = (await response.json()) as { allowed: boolean };
-    return {
-      content: [{ type: 'text', text: result.allowed ? 'allowed' : 'denied' }],
-    };
-  } catch (error) {
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    return {
-      content: [{ type: 'text', text: `Error: Failed to request permission: ${errorMessage}` }],
-      isError: true,
-    };
-  }
-});
-
-async function main() {
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-  console.error('File Permission MCP Server started');
-}
-
-main().catch((error) => {
-  console.error('Failed to start server:', error);
-  process.exit(1);
-});

package/mcp-tools/file-permission/tsconfig.json

@@ -1,17 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "esModuleInterop": true,
-    "strict": true,
-    "skipLibCheck": true,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "paths": {
-      "@/*": ["./src/*"]
-    }
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}

package/mcp-tools/report-checkpoint/src/index.ts

@@ -1,127 +0,0 @@
-#!/usr/bin/env node
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema,
-  type CallToolResult,
-} from '@modelcontextprotocol/sdk/types.js';
-
-const THOUGHT_STREAM_PORT = process.env.THOUGHT_STREAM_PORT || '9228';
-const CHECKPOINT_URL = `http://127.0.0.1:${THOUGHT_STREAM_PORT}/checkpoint`;
-const THOUGHT_STREAM_TASK_ID =
-  process.env.THOUGHT_STREAM_TASK_ID || process.env.ACCOMPLISH_TASK_ID || '';
-
-interface ReportCheckpointInput {
-  status: 'progress' | 'complete' | 'stuck';
-  summary: string;
-  nextPlanned?: string;
-  blocker?: string;
-}
-
-const server = new Server(
-  { name: 'report-checkpoint', version: '1.0.0' },
-  { capabilities: { tools: {} } }
-);
-
-server.setRequestHandler(ListToolsRequestSchema, async () => ({
-  tools: [
-    {
-      name: 'report_checkpoint',
-      description:
-        'Report a progress checkpoint to the UI. Use this to mark significant milestones, completion of subtasks, or when stuck and needing help.',
-      inputSchema: {
-        type: 'object',
-        properties: {
-          status: {
-            type: 'string',
-            enum: ['progress', 'complete', 'stuck'],
-            description:
-              'Status: progress (ongoing work), complete (task finished), stuck (blocked/need help)',
-          },
-          summary: {
-            type: 'string',
-            description: 'Brief summary of what was accomplished or the current state',
-          },
-          nextPlanned: {
-            type: 'string',
-            description: 'What you plan to do next (optional, for progress status)',
-          },
-          blocker: {
-            type: 'string',
-            description: 'Description of what is blocking progress (optional, for stuck status)',
-          },
-        },
-        required: ['status', 'summary'],
-      },
-    },
-  ],
-}));
-
-server.setRequestHandler(CallToolRequestSchema, async (request): Promise<CallToolResult> => {
-  if (request.params.name !== 'report_checkpoint') {
-    return {
-      content: [{ type: 'text', text: `Error: Unknown tool: ${request.params.name}` }],
-      isError: true,
-    };
-  }
-
-  const args = request.params.arguments as unknown as ReportCheckpointInput;
-  const { status, summary, nextPlanned, blocker } = args;
-
-  if (!status || !summary) {
-    return {
-      content: [{ type: 'text', text: 'Error: status and summary are required' }],
-      isError: true,
-    };
-  }
-
-  console.error(`[report-checkpoint] [${status}] ${summary}`);
-  if (nextPlanned) {
-    console.error(`[report-checkpoint] Next planned: ${nextPlanned}`);
-  }
-  if (blocker) {
-    console.error(`[report-checkpoint] Blocker: ${blocker}`);
-  }
-
-  if (THOUGHT_STREAM_TASK_ID) {
-    try {
-      const response = await fetch(CHECKPOINT_URL, {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({
-          taskId: THOUGHT_STREAM_TASK_ID,
-          status,
-          summary,
-          nextPlanned,
-          blocker,
-          agentName: process.env.ACCOMPLISH_AGENT_NAME || 'agent',
-          timestamp: Date.now(),
-        }),
-        signal: AbortSignal.timeout(1000),
-      });
-
-      if (!response.ok) {
-        console.error(`[report-checkpoint] HTTP error (non-fatal): ${response.status}`);
-      }
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : String(error);
-      console.error(`[report-checkpoint] HTTP error (non-fatal): ${errorMessage}`);
-    }
-  }
-
-  return {
-    content: [{ type: 'text', text: 'Checkpoint recorded.' }],
-  };
-});
-
-async function main() {
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-  console.error('[report-checkpoint] MCP server running');
-}
-
-main().catch((error) => {
-  console.error('[report-checkpoint] Fatal error:', error);
-  process.exit(1);
-});

package/mcp-tools/report-checkpoint/tsconfig.json

@@ -1,12 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "outDir": "dist",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true
-  },
-  "include": ["src/**/*"]
-}

package/mcp-tools/report-thought/src/index.ts

@@ -1,109 +0,0 @@
-#!/usr/bin/env node
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema,
-  type CallToolResult,
-} from '@modelcontextprotocol/sdk/types.js';
-
-const THOUGHT_STREAM_PORT = process.env.THOUGHT_STREAM_PORT || '9228';
-const THOUGHT_STREAM_URL = `http://127.0.0.1:${THOUGHT_STREAM_PORT}/thought`;
-const THOUGHT_STREAM_TASK_ID =
-  process.env.THOUGHT_STREAM_TASK_ID || process.env.ACCOMPLISH_TASK_ID || '';
-
-interface ReportThoughtInput {
-  content: string;
-  category: 'observation' | 'reasoning' | 'decision' | 'action';
-}
-
-const server = new Server(
-  { name: 'report-thought', version: '1.0.0' },
-  { capabilities: { tools: {} } }
-);
-
-server.setRequestHandler(ListToolsRequestSchema, async () => ({
-  tools: [
-    {
-      name: 'report_thought',
-      description:
-        'Stream a thought to the UI for real-time visibility into agent reasoning. Use frequently to narrate what you see and do.',
-      inputSchema: {
-        type: 'object',
-        properties: {
-          content: {
-            type: 'string',
-            description: 'The thought content to display',
-          },
-          category: {
-            type: 'string',
-            enum: ['observation', 'reasoning', 'decision', 'action'],
-            description:
-              'Category: observation (what you see), reasoning (why), decision (what you chose), action (what you are doing)',
-          },
-        },
-        required: ['content', 'category'],
-      },
-    },
-  ],
-}));
-
-server.setRequestHandler(CallToolRequestSchema, async (request): Promise<CallToolResult> => {
-  if (request.params.name !== 'report_thought') {
-    return {
-      content: [{ type: 'text', text: `Error: Unknown tool: ${request.params.name}` }],
-      isError: true,
-    };
-  }
-
-  const args = request.params.arguments as unknown as ReportThoughtInput;
-  const { content, category } = args;
-
-  if (!content || !category) {
-    return {
-      content: [{ type: 'text', text: 'Error: content and category are required' }],
-      isError: true,
-    };
-  }
-
-  console.error(`[report-thought] [${category}] ${content}`);
-
-  if (THOUGHT_STREAM_TASK_ID) {
-    try {
-      const response = await fetch(THOUGHT_STREAM_URL, {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({
-          taskId: THOUGHT_STREAM_TASK_ID,
-          content,
-          category,
-          agentName: process.env.ACCOMPLISH_AGENT_NAME || 'agent',
-          timestamp: Date.now(),
-        }),
-        signal: AbortSignal.timeout(1000),
-      });
-
-      if (!response.ok) {
-        console.error(`[report-thought] HTTP error (non-fatal): ${response.status}`);
-      }
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : String(error);
-      console.error(`[report-thought] HTTP error (non-fatal): ${errorMessage}`);
-    }
-  }
-
-  return {
-    content: [{ type: 'text', text: 'Thought recorded.' }],
-  };
-});
-
-async function main() {
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-  console.error('[report-thought] MCP server running');
-}
-
-main().catch((error) => {
-  console.error('[report-thought] Fatal error:', error);
-  process.exit(1);
-});

package/mcp-tools/report-thought/tsconfig.json

@@ -1,12 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "outDir": "dist",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true
-  },
-  "include": ["src/**/*"]
-}