@thinkwell/acp 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,196 @@
+/**
+ * Types for MCP-over-ACP protocol messages
+ */
+import type { JsonValue } from "./json.js";
+/**
+ * JSON Schema type for tool input/output validation.
+ *
+ * This is a structural subset of JSON Schema, designed to be compatible
+ * with schemas produced by third-party libraries without requiring them
+ * as dependencies.
+ */
+export interface JsonSchema {
+    type?: string;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    description?: string;
+    enum?: JsonValue[];
+    oneOf?: JsonSchema[];
+    anyOf?: JsonSchema[];
+    allOf?: JsonSchema[];
+    $ref?: string;
+    additionalProperties?: boolean | JsonSchema;
+    [key: string]: unknown;
+}
+/**
+ * Interface for types that can provide a JSON Schema representation.
+ *
+ * This enables integration with various schema technologies:
+ * - Schema-first libraries (Zod, TypeBox)
+ * - Build-time type-to-schema generators (TypeSpec, ts-json-schema-transformer)
+ * - Hand-written schemas with type associations
+ *
+ * @typeParam T - The TypeScript type that this schema describes
+ */
+export interface SchemaProvider<T> {
+    /**
+     * Returns the JSON Schema that describes type T.
+     */
+    toJsonSchema(): JsonSchema;
+}
+/**
+ * MCP server configuration for session requests
+ */
+export interface McpServerConfig {
+    type: "http";
+    name: string;
+    url: string;
+}
+/**
+ * Context provided to tool handlers
+ */
+export interface McpContext {
+    /** The connection ID for this MCP session */
+    connectionId: string;
+    /** The session ID for the ACP session */
+    sessionId: string;
+}
+/**
+ * MCP connect request from conductor
+ */
+export interface McpConnectRequest {
+    method: "_mcp/connect";
+    params: {
+        connectionId: string;
+        url: string;
+    };
+}
+/**
+ * MCP connect response
+ */
+export interface McpConnectResponse {
+    connectionId: string;
+    serverInfo: {
+        name: string;
+        version: string;
+    };
+    capabilities: {
+        tools?: Record<string, unknown>;
+    };
+    /** Optional tool definitions - the bridge may use these to pre-populate tool info */
+    tools?: McpToolDefinition[];
+}
+/**
+ * MCP message request (tool call, etc.)
+ */
+export interface McpMessageRequest {
+    method: "_mcp/message";
+    params: {
+        connectionId: string;
+        method: string;
+        id?: string | number;
+        params?: unknown;
+    };
+}
+/**
+ * MCP message response
+ */
+export interface McpMessageResponse {
+    connectionId: string;
+    content?: McpContent[];
+    result?: unknown;
+    error?: McpError;
+}
+/**
+ * MCP content block
+ */
+export interface McpContent {
+    type: "text" | "image" | "resource";
+    text?: string;
+    data?: string;
+    mimeType?: string;
+}
+/**
+ * MCP error
+ */
+export interface McpError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+/**
+ * MCP disconnect notification
+ */
+export interface McpDisconnectNotification {
+    method: "_mcp/disconnect";
+    params: {
+        connectionId: string;
+    };
+}
+/**
+ * MCP tools/list response
+ */
+export interface McpToolsListResult {
+    tools: McpToolDefinition[];
+}
+/**
+ * MCP tool definition
+ */
+export interface McpToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: JsonSchema;
+}
+/**
+ * MCP tools/call request params
+ */
+export interface McpToolsCallParams {
+    name: string;
+    arguments: Record<string, unknown>;
+}
+/**
+ * MCP tools/call response
+ */
+export interface McpToolsCallResult {
+    content: McpContent[];
+    isError?: boolean;
+}
+/**
+ * Session message types
+ */
+export type SessionMessage = {
+    type: "text";
+    content: string;
+} | {
+    type: "tool_use";
+    id: string;
+    name: string;
+    input: unknown;
+} | {
+    type: "tool_result";
+    tool_use_id: string;
+    content: string;
+} | {
+    type: "stop";
+    reason: StopReason;
+};
+/**
+ * Reason for stopping
+ */
+export type StopReason = "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
+/**
+ * Tool handler function type
+ */
+export type ToolHandler<I = unknown, O = unknown> = (input: I, context: McpContext) => Promise<O>;
+/**
+ * Registered tool with metadata
+ */
+export interface RegisteredTool<I = unknown, O = unknown> {
+    name: string;
+    description: string;
+    inputSchema: JsonSchema;
+    outputSchema: JsonSchema;
+    handler: ToolHandler<I, O>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for MCP-over-ACP protocol messages
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@thinkwell/acp",
+  "version": "0.1.0",
+  "description": "TypeScript implementation of ACP (Agent Client Protocol) extensions for Thinkwell",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "node --test --import tsx src/**/*.test.ts"
+  },
+  "keywords": [
+    "acp",
+    "mcp",
+    "thinkwell",
+    "agent",
+    "llm"
+  ],
+  "author": "David Herman",
+  "license": "MIT",
+  "dependencies": {
+    "@agentclientprotocol/sdk": "^0.4.0",
+    "uuid": "^11.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.4",
+    "@types/uuid": "^10.0.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  }
+}