goatchain 0.0.2 → 0.0.4

package/dist/types/snapshot.d.ts

@@ -0,0 +1,329 @@
+import type { ToolCallWithResult } from '../agent/types';
+import type { ModelStopReason } from '../model/types';
+import type { Usage } from './common';
+import type { Message } from './message';
+/**
+ * Model configuration for snapshots (serializable)
+ */
+export interface ModelConfig {
+    /**
+     * Model identifier (e.g., "gpt-4o", "claude-3-opus")
+     */
+    modelId: string;
+    /**
+     * Provider name (e.g., "openai", "anthropic")
+     */
+    provider?: string;
+    /**
+     * Model-specific configuration
+     */
+    config?: Record<string, unknown>;
+}
+/**
+ * Agent configuration (mutable settings)
+ */
+export interface AgentConfig {
+    /**
+     * System prompt that defines the agent's behavior
+     */
+    systemPrompt: string;
+    /**
+     * Current model configuration
+     */
+    model: ModelConfig;
+    /**
+     * List of registered tool names
+     */
+    tools: string[];
+}
+/**
+ * Agent runtime statistics
+ */
+export interface AgentStats {
+    /**
+     * Last update timestamp (ms)
+     */
+    updatedAt: number;
+    /**
+     * Total number of sessions ever created
+     */
+    totalSessions: number;
+    /**
+     * Number of currently active sessions
+     */
+    activeSessions: number;
+}
+/**
+ * Complete Agent snapshot for serialization/persistence
+ */
+export interface AgentSnapshot {
+    /**
+     * Unique agent identifier
+     */
+    id: string;
+    /**
+     * Human-readable name
+     */
+    name: string;
+    /**
+     * Creation timestamp (ms)
+     */
+    createdAt: number;
+    /**
+     * Agent configuration
+     */
+    config: AgentConfig;
+    /**
+     * Runtime statistics
+     */
+    stats: AgentStats;
+    /**
+     * User-defined metadata
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Session status
+ */
+export type SessionStatus = 'active' | 'paused' | 'completed' | 'error' | 'archived';
+/**
+ * Session state information
+ */
+export interface SessionState {
+    /**
+     * Current session status
+     */
+    status: SessionStatus;
+    /**
+     * Last update timestamp (ms)
+     */
+    updatedAt: number;
+    /**
+     * Last activity timestamp (ms)
+     */
+    lastActiveAt: number;
+    /**
+     * User-defined session title
+     */
+    title?: string;
+    /**
+     * Error message if status is 'error'
+     */
+    errorMessage?: string;
+}
+/**
+ * Session-level configuration overrides
+ * These override the parent agent's configuration for this session only
+ */
+export interface SessionConfigOverride {
+    /**
+     * Override model for this session
+     */
+    model?: ModelConfig;
+    /**
+     * Override system prompt for this session
+     */
+    systemPromptOverride?: string;
+    /**
+     * Tools to disable for this session
+     */
+    disabledTools?: string[];
+}
+/**
+ * Conversation context containing message history
+ */
+export interface ConversationContext {
+    /**
+     * Full message history
+     */
+    messages: Message[];
+    /**
+     * Total message count
+     */
+    messageCount: number;
+    /**
+     * Preview of the last message (for list display)
+     */
+    lastMessagePreview?: string;
+    /**
+     * Number of tool calls made in this session
+     */
+    toolCallCount: number;
+}
+/**
+ * Session usage statistics
+ */
+export interface SessionStats {
+    /**
+     * Token usage for this session
+     */
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    /**
+     * Number of assistant responses
+     */
+    responseCount: number;
+    /**
+     * Average response time in milliseconds
+     */
+    avgResponseTime?: number;
+}
+/**
+ * Complete Session snapshot for serialization/persistence
+ */
+export interface SessionSnapshot {
+    /**
+     * Unique session identifier
+     */
+    id: string;
+    /**
+     * Creation timestamp (ms)
+     */
+    createdAt: number;
+    /**
+     * Session state information
+     */
+    state: SessionState;
+    /**
+     * Session-level configuration overrides
+     */
+    configOverride?: SessionConfigOverride;
+    /**
+     * Conversation context with message history
+     */
+    context: ConversationContext;
+    /**
+     * Usage statistics
+     */
+    stats: SessionStats;
+    /**
+     * User-defined metadata
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Model configuration stored in checkpoint (serializable)
+ */
+export interface CheckpointModelConfig {
+    /**
+     * Model identifier (e.g., "gpt-4o", "claude-3-opus")
+     */
+    modelId: string;
+    /**
+     * Provider name (e.g., "openai", "anthropic")
+     */
+    provider?: string;
+    /**
+     * Model-specific configuration
+     */
+    config?: Record<string, unknown>;
+}
+/**
+ * Request parameters stored in checkpoint
+ */
+export interface CheckpointRequestParams {
+    /**
+     * Temperature for response randomness
+     */
+    temperature?: number;
+    /**
+     * Maximum tokens to generate
+     */
+    maxTokens?: number;
+    /**
+     * Stop sequences
+     */
+    stop?: string[];
+    /**
+     * Additional model-specific parameters
+     */
+    [key: string]: unknown;
+}
+/**
+ * Checkpoint of AgentLoopState for persistence and resumption.
+ *
+ * This captures the complete runtime state of an agent loop execution,
+ * allowing it to be saved and restored for:
+ * - Resuming interrupted executions
+ * - Debugging and inspection
+ * - Audit logging
+ */
+export interface AgentLoopCheckpoint {
+    /**
+     * Schema version for this checkpoint payload.
+     *
+     * When absent, treat as version 1 (legacy checkpoints).
+     */
+    schemaVersion?: number;
+    /**
+     * Session ID for this execution
+     */
+    sessionId: string;
+    /**
+     * Agent name (for display purposes)
+     */
+    agentName?: string;
+    /**
+     * Current loop iteration (0-indexed)
+     */
+    iteration: number;
+    /**
+     * Current phase of execution
+     */
+    phase?: 'llm_call' | 'tool_execution' | 'approval_pending' | 'completed';
+    /**
+     * Current status description (human readable)
+     */
+    status?: string;
+    /**
+     * Model configuration at checkpoint time
+     */
+    modelConfig?: CheckpointModelConfig;
+    /**
+     * Model request parameters at checkpoint time
+     */
+    requestParams?: CheckpointRequestParams;
+    /**
+     * Full message history
+     */
+    messages: Message[];
+    /**
+     * Pending tool calls (serialized)
+     */
+    pendingToolCalls: ToolCallWithResult[];
+    /**
+     * Text response accumulated so far
+     */
+    currentResponse: string;
+    /**
+     * Thinking/reasoning content (if any)
+     */
+    currentThinking?: string;
+    /**
+     * Whether the loop should continue
+     */
+    shouldContinue: boolean;
+    /**
+     * Stop reason (if stopped)
+     */
+    stopReason?: 'max_iterations' | 'final_response' | 'error' | 'cancelled' | 'approval_required';
+    /**
+     * Stop reason reported by the last model call (if available).
+     */
+    lastModelStopReason?: ModelStopReason;
+    /**
+     * Cumulative token usage
+     */
+    usage: Usage;
+    /**
+     * Custom metadata
+     */
+    metadata: Record<string, unknown>;
+    /**
+     * Timestamp when this checkpoint was saved (ms)
+     */
+    savedAt: number;
+}

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "goatchain",
   "type": "module",
-  "version": "0.0.2",
+  "version": "0.0.4",
+  "workspaces": [
+    "packages/*"
+  ],
   "description": "",
   "author": "Simon He",
   "license": "MIT",
@@ -14,10 +17,36 @@
   "engines": {
     "node": ">=18"
   },
+  "scripts": {
+    "build": "rm -rf dist && bun build src/index.ts --outdir dist --target bun --format esm --minify --external @ast-grep/napi && tsc --project tsconfig.build.json",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint --no-error-on-unmatched-pattern src/**/*.ts examples/**/*.ts test/**/*.ts packages/cli/src/**/*.ts",
+    "lint:fix": "eslint --no-error-on-unmatched-pattern src/**/*.ts examples/**/*.ts test/**/*.ts packages/cli/src/**/*.ts --fix",
+    "format": "eslint --fix --no-error-on-unmatched-pattern \"src/**/*.ts\" \"test/**/*.ts\" \"scripts/**/*.ts\" \"examples/**/*.ts\" && prettier --cache --write \"**/*.{json,md,yaml,yml}\"",
+    "prettier": "prettier --write \"src/**/*.{ts,js,json,md}\" \"examples/**/*.{ts,js,json,md}\" \"packages/cli/src/**/*.{ts,js,json,md}\"",
+    "prettier:check": "prettier --check \"src/**/*.{ts,js,json,md}\" \"examples/**/*.{ts,js,json,md}\" \"packages/cli/src/**/*.{ts,js,json,md}\"",
+    "test": "bun test",
+    "test:serial": "bun run --filter '*' build && bun test",
+    "test:integration": "GOATCHAIN_RUN_INTEGRATION=1 bun run --filter '*' build && bun test",
+    "start": "bun run dist/index.js",
+    "prepack": "bun run build",
+    "build:all": "bun run build && bun run --filter '*' build && bun run --filter '*' build --binary",
+    "cli": "cd packages/cli && bun run cli",
+    "cli:smoke": "cd packages/cli && bun run smoke",
+    "cli:publish": "cd packages/cli && bun publish",
+    "acp-server": "bun run src/acp-server.ts",
+    "release": "bumpp --commit --no-tag --no-push && bun run build && bun publish"
+  },
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.1.76",
+    "@agentclientprotocol/sdk": "^0.12.0",
+    "@ast-grep/cli": "^0.40.4",
+    "@ast-grep/napi": "^0.40.4",
     "@modelcontextprotocol/sdk": "^1.17.3",
+    "@types/picomatch": "^4.0.2",
+    "fast-glob": "^3.3.3",
     "openai": "^6.9.1",
+    "picomatch": "^4.0.3",
     "tiktoken": "^1.0.22"
   },
   "devDependencies": {
@@ -28,38 +57,16 @@
     "@sxzz/prettier-config": "^2.2.6",
     "@tsconfig/recommended": "^1.0.10",
     "@types/node": "^22.13.5",
-    "@vitest/ui": "^2.1.8",
     "bumpp": "^10.3.2",
+    "bun-types": "latest",
     "chokidar": "^4.0.1",
     "dotenv": "^17.2.1",
     "eslint": "^9.19.0",
     "picocolors": "^1.1.1",
     "prettier": "^3.6.2",
-    "tsdown": "^0.15.12",
     "tsx": "^4.20.5",
     "typescript": "^5.9.2",
-    "typescript-eslint": "^8.22.0",
-    "vitest": "^4.0.16"
+    "typescript-eslint": "^8.22.0"
   },
-  "prettier": "@sxzz/prettier-config",
-  "scripts": {
-    "build": "tsdown --minify --format esm",
-    "dev": "tsc --watch",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint --no-error-on-unmatched-pattern src/**/*.ts examples/**/*.ts test/**/*.ts",
-    "lint:fix": "eslint --no-error-on-unmatched-pattern src/**/*.ts examples/**/*.ts test/**/*.ts --fix",
-    "format": "eslint --fix --no-error-on-unmatched-pattern \"src/**/*.ts\" \"test/**/*.ts\" \"scripts/**/*.ts\" \"examples/**/*.ts\" && prettier --cache --write \"**/*.{json,md,yaml,yml}\"",
-    "prettier": "prettier --write \"src/**/*.{ts,js,json,md}\" \"examples/**/*.{ts,js,json,md}\" \"packages/cli/src/**/*.{ts,js,json,md}\"",
-    "prettier:check": "prettier --check \"src/**/*.{ts,js,json,md}\" \"examples/**/*.{ts,js,json,md}\" \"packages/cli/src/**/*.{ts,js,json,md}\"",
-    "test": "pnpm -r -s build && vitest run",
-    "start": "node dist/index.js",
-    "build:all": "pnpm -r -s build",
-    "cli": "pnpm -C packages/cli -s cli",
-    "cli:smoke": "pnpm -C packages/cli -s smoke",
-    "cli:publish": "pnpm -C packages/cli publish",
-    "slides:gen": "node scripts/gen-slidev-readme.mjs",
-    "slides:dev": "pnpm -s slides:gen && slidev slides/README.slides.md",
-    "slides:build": "pnpm -s slides:gen && slidev build slides/README.slides.md --out dist/slides",
-    "slides:export": "pnpm -s slides:gen && slidev export slides/README.slides.md --output dist/agent-loop-readme.pdf"
-  }
-}
+  "prettier": "@sxzz/prettier-config"
+}