@plaited/acp-harness 0.2.5 → 0.3.1

package/scripts/bun-test-wrapper.sh

@@ -1,46 +0,0 @@
-#!/bin/bash
-# Wrapper for bun test that handles Bun's post-test cleanup crash
-# See: https://github.com/oven-sh/bun/issues/23643
-#
-# Bun 1.3.x has a known bug where the test runner crashes during cleanup
-# after all tests complete successfully. This wrapper catches that crash
-# (exit code 133 = SIGTRAP) and exits cleanly if tests actually passed.
-#
-# Usage:
-#   ./bun-test-wrapper.sh [args...]     # Run bun test with provided args
-#   ./bun-test-wrapper.sh               # (No args) Find and run all *.docker.ts files
-
-# Determine test files to run
-if [ $# -eq 0 ]; then
-  # No arguments: find all *.docker.ts files for Docker integration tests
-  docker_tests=$(find ./src ./bin -name "*.docker.ts" -type f 2>/dev/null)
-  if [ -z "$docker_tests" ]; then
-    echo "No *.docker.ts files found in ./src or ./bin"
-    exit 0
-  fi
-  echo "Found Docker integration tests:"
-  echo "$docker_tests" | sed 's/^/  /'
-  echo ""
-  # Convert newlines to arguments
-  set -- $docker_tests
-fi
-
-# Create temp file for output
-tmpfile=$(mktemp)
-trap "rm -f $tmpfile" EXIT
-
-# Run tests with output to both terminal and file
-bun test "$@" 2>&1 | tee "$tmpfile"
-exit_code=${PIPESTATUS[0]}
-
-# Check if tests passed (look for "X pass" and "0 fail" in output)
-if grep -q " pass" "$tmpfile" && grep -q "0 fail" "$tmpfile"; then
-  # Tests passed - exit 0 even if Bun crashed during cleanup
-  if [ $exit_code -eq 133 ]; then
-    echo ""
-    echo "Note: Bun crashed during cleanup (known bug), but all tests passed."
-    exit 0
-  fi
-fi
-
-exit $exit_code

package/src/acp.constants.ts

@@ -1,56 +0,0 @@
-/**
- * ACP protocol constants.
- *
- * @remarks
- * Contains all constant values used across the ACP client implementation:
- * - Protocol method names
- * - Protocol version
- * - JSON-RPC error codes
- */
-
-// ============================================================================
-// Protocol Methods
-// ============================================================================
-
-/** ACP method names */
-export const ACP_METHODS = {
-  // Lifecycle
-  INITIALIZE: 'initialize',
-  SHUTDOWN: 'shutdown',
-
-  // Sessions
-  CREATE_SESSION: 'session/new',
-  LOAD_SESSION: 'session/load',
-  PROMPT: 'session/prompt',
-  CANCEL: 'session/cancel',
-  UPDATE: 'session/update',
-  REQUEST_PERMISSION: 'session/request_permission',
-  SET_MODEL: 'session/set_model',
-
-  // Protocol-level
-  CANCEL_REQUEST: '$/cancel_request',
-} as const
-
-// ============================================================================
-// Protocol Version
-// ============================================================================
-
-/** Current protocol version - SDK uses number type */
-export const ACP_PROTOCOL_VERSION = 1 as const
-
-// ============================================================================
-// JSON-RPC Error Codes
-// ============================================================================
-
-/** Standard JSON-RPC error codes */
-export const JSON_RPC_ERRORS = {
-  PARSE_ERROR: -32700,
-  INVALID_REQUEST: -32600,
-  METHOD_NOT_FOUND: -32601,
-  INVALID_PARAMS: -32602,
-  INTERNAL_ERROR: -32603,
-  REQUEST_CANCELLED: -32800,
-} as const
-
-/** Default ACP Client Name */
-export const DEFAULT_ACP_CLIENT_NAME = 'plaited-acp-client'

package/src/acp.schemas.ts

@@ -1,161 +0,0 @@
-/**
- * JSON-RPC 2.0 Zod schemas with runtime validation.
- *
- * @remarks
- * These schemas provide runtime validation for JSON-RPC messages at the
- * transport boundary. While the ACP SDK handles protocol-level types,
- * the JSON-RPC framing layer is our responsibility since we implement
- * a custom stdio transport.
- *
- * The schemas follow JSON-RPC 2.0 specification:
- * - Requests have `id` and `method`
- * - Notifications have `method` but no `id`
- * - Responses have `id` and either `result` or `error`
- */
-
-import type { RequestPermissionRequest, SessionNotification } from '@agentclientprotocol/sdk'
-import { z } from 'zod'
-
-// ============================================================================
-// Inlined Type Utilities
-// ============================================================================
-
-/** Precise type detection beyond typeof operator */
-const trueTypeOf = (obj?: unknown): string => Object.prototype.toString.call(obj).slice(8, -1).toLowerCase()
-
-/** Type guard for precise type checking with TypeScript narrowing */
-const isTypeOf = <T>(obj: unknown, type: string): obj is T => trueTypeOf(obj) === type
-
-// ============================================================================
-// JSON-RPC Base Schemas
-// ============================================================================
-
-/** JSON-RPC version literal */
-const JsonRpcVersionSchema = z.literal('2.0')
-
-/** Request/response identifier */
-const RequestIdSchema = z.union([z.string(), z.number()])
-
-/**
- * JSON-RPC 2.0 error object schema.
- *
- * @remarks
- * Standard error codes:
- * - `-32700`: Parse error
- * - `-32600`: Invalid request
- * - `-32601`: Method not found
- * - `-32602`: Invalid params
- * - `-32603`: Internal error
- * - `-32800`: Request cancelled (ACP extension)
- */
-export const JsonRpcErrorSchema = z.object({
-  code: z.number(),
-  message: z.string(),
-  data: z.unknown().optional(),
-})
-
-/** JSON-RPC 2.0 request schema */
-export const JsonRpcRequestSchema = z.object({
-  jsonrpc: JsonRpcVersionSchema,
-  id: RequestIdSchema,
-  method: z.string(),
-  params: z.unknown().optional(),
-})
-
-/** JSON-RPC 2.0 notification schema (no id, no response expected) */
-export const JsonRpcNotificationSchema = z.object({
-  jsonrpc: JsonRpcVersionSchema,
-  method: z.string(),
-  params: z.unknown().optional(),
-})
-
-/** JSON-RPC 2.0 success response schema */
-export const JsonRpcSuccessResponseSchema = z.object({
-  jsonrpc: JsonRpcVersionSchema,
-  id: RequestIdSchema,
-  result: z.unknown(),
-})
-
-/** JSON-RPC 2.0 error response schema */
-export const JsonRpcErrorResponseSchema = z.object({
-  jsonrpc: JsonRpcVersionSchema,
-  id: z.union([RequestIdSchema, z.null()]),
-  error: JsonRpcErrorSchema,
-})
-
-/** Union of all JSON-RPC response types */
-export const JsonRpcResponseSchema = z.union([JsonRpcSuccessResponseSchema, JsonRpcErrorResponseSchema])
-
-/**
- * Union of all JSON-RPC message types.
- *
- * @remarks
- * Use `safeParse` at transport boundaries for runtime validation.
- * See transport tests for usage patterns.
- */
-export const JsonRpcMessageSchema = z.union([JsonRpcRequestSchema, JsonRpcNotificationSchema, JsonRpcResponseSchema])
-
-// ============================================================================
-// Inferred Types
-// ============================================================================
-
-/** JSON-RPC 2.0 error object */
-export type JsonRpcError = z.infer<typeof JsonRpcErrorSchema>
-
-/** JSON-RPC 2.0 request structure */
-export type JsonRpcRequest<T = unknown> = Omit<z.infer<typeof JsonRpcRequestSchema>, 'params'> & {
-  params?: T
-}
-
-/** JSON-RPC 2.0 notification structure (no id, no response expected) */
-export type JsonRpcNotification<T = unknown> = Omit<z.infer<typeof JsonRpcNotificationSchema>, 'params'> & {
-  params?: T
-}
-
-/** JSON-RPC 2.0 success response */
-export type JsonRpcSuccessResponse<T = unknown> = Omit<z.infer<typeof JsonRpcSuccessResponseSchema>, 'result'> & {
-  result: T
-}
-
-/** JSON-RPC 2.0 error response */
-export type JsonRpcErrorResponse = z.infer<typeof JsonRpcErrorResponseSchema>
-
-/** Union of all JSON-RPC response types */
-export type JsonRpcResponse<T = unknown> = JsonRpcSuccessResponse<T> | JsonRpcErrorResponse
-
-/** Union of all JSON-RPC message types */
-export type JsonRpcMessage<T = unknown> = JsonRpcRequest<T> | JsonRpcNotification<T> | JsonRpcResponse<T>
-
-// ============================================================================
-// ACP SDK Type Schemas
-// ============================================================================
-
-/**
- * These schemas use z.custom() to validate SDK types at runtime.
- * They validate only the fields we actually use, keeping SDK types
- * as the source of truth while adding runtime safety.
- */
-
-/** Type guard for object shape validation */
-const isRecord = (val: unknown): val is Record<string, unknown> => isTypeOf<Record<string, unknown>>(val, 'object')
-
-/**
- * Schema for session update notifications.
- *
- * @remarks
- * Validates `sessionId` and `update` fields used in notification handling.
- */
-export const SessionNotificationSchema = z.custom<SessionNotification>(
-  (val): val is SessionNotification =>
-    isRecord(val) && 'sessionId' in val && typeof val.sessionId === 'string' && 'update' in val && isRecord(val.update),
-)
-
-/**
- * Schema for permission requests from agent.
- *
- * @remarks
- * Validates `options` array used in permission handling.
- */
-export const RequestPermissionRequestSchema = z.custom<RequestPermissionRequest>(
-  (val): val is RequestPermissionRequest => isRecord(val) && 'options' in val && Array.isArray(val.options),
-)

package/src/acp.types.ts

@@ -1,28 +0,0 @@
-/**
- * ACP type definitions.
- *
- * @remarks
- * This module contains types specific to the ACP client implementation.
- * For SDK types (ToolCall, ContentBlock, SessionNotification, etc.), import
- * directly from `@agentclientprotocol/sdk`.
- *
- * For runtime validation of JSON-RPC messages, import Zod schemas from
- * `./acp.schemas.ts`.
- *
- * For protocol constants, import from `./acp.constants.ts`.
- */
-
-import type { SessionId } from '@agentclientprotocol/sdk'
-
-// ============================================================================
-// Session Types
-// ============================================================================
-
-/**
- * Session object returned from session creation.
- * Contains the session ID for subsequent operations.
- */
-export type Session = {
-  id: SessionId
-  _meta?: { [key: string]: unknown } | null
-}

package/src/tests/fixtures/.claude/settings.local.json

@@ -1,8 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Skill(greeting)",
-      "Skill(greeting:*)"
-    ]
-  }
-}

package/src/tests/fixtures/.claude/skills/greeting/SKILL.md

@@ -1,17 +0,0 @@
----
-name: greeting
-description: Use this skill when asked to greet someone or say hello
----
-
-# Greeting Skill
-
-When the user asks you to greet someone, follow these rules:
-
-1. Always start with "Hello from the greeting skill!"
-2. Include the phrase "skill-test-marker" somewhere in your response
-3. Be friendly and welcoming
-
-## Example Responses
-
-- "Hello from the greeting skill! skill-test-marker Welcome to our test!"
-- "Hello from the greeting skill! I hope you're having a great day. skill-test-marker"

package/tsconfig.json

@@ -1,32 +0,0 @@
-{
-  "include": ["src", "skills", "bin"],
-  "compilerOptions": {
-    // Enable latest features
-    "lib": ["ESNext"],
-    "target": "ESNext",
-    "module": "Preserve",
-    "moduleDetection": "force",
-    "allowJs": true,
-
-    // IDE may need this to properly show type errors
-    "rootDir": ".",
-
-    // Bundler mode
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "verbatimModuleSyntax": true,
-    "noEmit": true,
-
-    // Best practices
-    "strict": true,
-    "skipLibCheck": true,
-    "noFallthroughCasesInSwitch": true,
-    "noUncheckedIndexedAccess": true,
-    "noImplicitOverride": true,
-
-    // Some stricter flags (disabled by default)
-    "noUnusedLocals": false,
-    "noUnusedParameters": false,
-    "noPropertyAccessFromIndexSignature": false
-  }
-}