noumen 0.1.0 → 0.2.0

package/dist/types-DwdzmXfs.d.ts

@@ -0,0 +1,107 @@
+type PermissionMode = "default" | "plan" | "acceptEdits" | "auto" | "bypassPermissions" | "dontAsk";
+type PermissionBehavior = "allow" | "deny" | "ask";
+type PermissionRuleSource = "user" | "project" | "session" | "policy";
+/** Precedence order: policy > project > user > session. */
+declare const RULE_SOURCE_PRECEDENCE: PermissionRuleSource[];
+interface PermissionRule {
+    toolName: string;
+    ruleContent?: string;
+    behavior: PermissionBehavior;
+    /** Where this rule came from. Higher-precedence sources override lower ones. */
+    source?: PermissionRuleSource;
+}
+type PermissionUpdate = {
+    type: "addRules";
+    rules: PermissionRule[];
+} | {
+    type: "removeRules";
+    toolName: string;
+    behavior?: PermissionBehavior;
+} | {
+    type: "setMode";
+    mode: PermissionMode;
+} | {
+    type: "addDirectories";
+    directories: string[];
+} | {
+    type: "removeDirectories";
+    directories: string[];
+};
+interface PermissionAllowResult<Input extends Record<string, unknown> = Record<string, unknown>> {
+    behavior: "allow";
+    updatedInput?: Input;
+    reason?: string;
+}
+interface PermissionDenyResult {
+    behavior: "deny";
+    message: string;
+    reason?: string;
+}
+interface PermissionAskResult {
+    behavior: "ask";
+    message: string;
+    reason?: string;
+    suggestions?: PermissionRule[];
+}
+interface PermissionPassthroughResult {
+    behavior: "passthrough";
+    message: string;
+    reason?: string;
+    suggestions?: PermissionRule[];
+}
+/**
+ * What `Tool.checkPermissions` returns. Includes `passthrough` for tools that
+ * have no opinion and want the global pipeline to decide.
+ */
+type PermissionResult<Input extends Record<string, unknown> = Record<string, unknown>> = PermissionAllowResult<Input> | PermissionDenyResult | PermissionAskResult | PermissionPassthroughResult;
+/**
+ * Final decision after the pipeline resolves. No `passthrough` — always
+ * one of allow / deny / ask.
+ */
+type PermissionDecision<Input extends Record<string, unknown> = Record<string, unknown>> = PermissionAllowResult<Input> | PermissionDenyResult | PermissionAskResult;
+interface PermissionRequest {
+    toolName: string;
+    input: Record<string, unknown>;
+    message: string;
+    suggestions?: PermissionRule[];
+    isReadOnly: boolean;
+    isDestructive: boolean;
+}
+interface PermissionResponse {
+    allow: boolean;
+    updatedInput?: Record<string, unknown>;
+    feedback?: string;
+    addRules?: PermissionRule[];
+}
+type PermissionHandler = (request: PermissionRequest) => Promise<PermissionResponse>;
+interface AutoModeConfig {
+    /** Custom system prompt for the classifier. When omitted, uses a default. */
+    classifierPrompt?: string;
+    /** Model to use for classification. When omitted, uses the thread's model. */
+    classifierModel?: string;
+}
+interface DenialTrackingConfig {
+    /** Max consecutive denials before fallback (default: 3). */
+    maxConsecutive?: number;
+    /** Max total denials before fallback (default: 20). */
+    maxTotal?: number;
+}
+interface PermissionConfig {
+    mode?: PermissionMode;
+    rules?: PermissionRule[];
+    handler?: PermissionHandler;
+    workingDirectories?: string[];
+    /** Called when a permission update is applied (for host-side persistence). */
+    onPermissionUpdate?: (update: PermissionUpdate) => void;
+    /** Configuration for auto mode classifier. */
+    autoMode?: AutoModeConfig;
+    /** Configuration for denial tracking limits. */
+    denialTracking?: DenialTrackingConfig;
+}
+interface PermissionContext {
+    mode: PermissionMode;
+    rules: PermissionRule[];
+    workingDirectories: string[];
+}
+
+export { type AutoModeConfig as A, type DenialTrackingConfig as D, type PermissionResponse as P, RULE_SOURCE_PRECEDENCE as R, type PermissionMode as a, type PermissionResult as b, type PermissionHandler as c, type PermissionConfig as d, type PermissionContext as e, type PermissionBehavior as f, type PermissionRule as g, type PermissionDecision as h, type PermissionUpdate as i, type PermissionAllowResult as j, type PermissionAskResult as k, type PermissionDenyResult as l, type PermissionPassthroughResult as m, type PermissionRequest as n, type PermissionRuleSource as o };

package/dist/types-NIyVwQ4h.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Agent2Agent (A2A) protocol types per the Google A2A specification.
+ * https://google.github.io/A2A/specification/
+ */
+interface AgentCard {
+    name: string;
+    description?: string;
+    url: string;
+    provider?: {
+        organization: string;
+        url?: string;
+    };
+    version: string;
+    capabilities?: {
+        streaming?: boolean;
+        pushNotifications?: boolean;
+        stateTransitionHistory?: boolean;
+    };
+    authentication?: {
+        schemes: string[];
+        credentials?: string;
+    };
+    defaultInputModes?: string[];
+    defaultOutputModes?: string[];
+    skills?: AgentSkill[];
+}
+interface AgentSkill {
+    id: string;
+    name: string;
+    description?: string;
+    tags?: string[];
+    examples?: string[];
+    inputModes?: string[];
+    outputModes?: string[];
+}
+type TaskStatus = "submitted" | "working" | "input-required" | "completed" | "failed" | "canceled";
+interface Task {
+    id: string;
+    sessionId?: string;
+    status: TaskState;
+    history?: Message[];
+    artifacts?: Artifact[];
+    metadata?: Record<string, unknown>;
+}
+interface TaskState {
+    state: TaskStatus;
+    message?: Message;
+    timestamp?: string;
+}
+interface Message {
+    role: "user" | "agent";
+    parts: Part[];
+    metadata?: Record<string, unknown>;
+}
+type Part = TextPart | FilePart | DataPart;
+interface TextPart {
+    type: "text";
+    text: string;
+}
+interface FilePart {
+    type: "file";
+    file: {
+        name?: string;
+        mimeType?: string;
+        bytes?: string;
+        uri?: string;
+    };
+}
+interface DataPart {
+    type: "data";
+    data: Record<string, unknown>;
+}
+interface Artifact {
+    name?: string;
+    description?: string;
+    parts: Part[];
+    index?: number;
+    append?: boolean;
+    lastChunk?: boolean;
+    metadata?: Record<string, unknown>;
+}
+interface TaskSendParams {
+    id?: string;
+    sessionId?: string;
+    message: Message;
+    metadata?: Record<string, unknown>;
+}
+interface TaskStatusUpdateEvent {
+    type: "status";
+    taskId: string;
+    status: TaskState;
+    final: boolean;
+}
+interface TaskArtifactUpdateEvent {
+    type: "artifact";
+    taskId: string;
+    artifact: Artifact;
+}
+type TaskStreamEvent = TaskStatusUpdateEvent | TaskArtifactUpdateEvent;
+declare const A2A_METHODS: {
+    readonly TASKS_SEND: "tasks/send";
+    readonly TASKS_SEND_SUBSCRIBE: "tasks/sendSubscribe";
+    readonly TASKS_GET: "tasks/get";
+    readonly TASKS_CANCEL: "tasks/cancel";
+    readonly TASKS_PUSH_NOTIFICATION: "tasks/pushNotification";
+    readonly TASKS_RESUBSCRIBE: "tasks/resubscribe";
+};
+
+export { type AgentSkill as A, type DataPart as D, type FilePart as F, type Message as M, type Part as P, type TaskSendParams as T, type AgentCard as a, type Task as b, type TaskStreamEvent as c, A2A_METHODS as d, type Artifact as e, type TaskState as f, type TaskStatus as g, type TextPart as h };

package/dist/types-QwfylltH.d.ts

@@ -0,0 +1,71 @@
+/**
+ * ACP (Agent Client Protocol) types.
+ *
+ * ACP is a JSON-RPC 2.0 protocol (like LSP) for communication between
+ * clients (editors, UIs) and AI coding agents over stdio or HTTP.
+ */
+interface AcpCapabilities {
+    streaming?: boolean;
+    permissions?: boolean;
+    tools?: string[];
+    sessions?: boolean;
+}
+interface AcpInitializeParams {
+    clientName: string;
+    clientVersion: string;
+    capabilities?: {
+        filesystem?: boolean;
+        terminal?: boolean;
+    };
+}
+interface AcpInitializeResult {
+    agentName: string;
+    agentVersion: string;
+    protocolVersion: string;
+    capabilities: AcpCapabilities;
+}
+interface AcpSessionNewParams {
+    sessionId?: string;
+}
+interface AcpSessionPromptParams {
+    sessionId: string;
+    prompt: string;
+}
+interface AcpTransport {
+    /** Send a JSON-RPC message to the peer. */
+    send(message: unknown): void;
+    /** Register a handler for incoming JSON-RPC messages. */
+    onMessage(handler: (message: unknown) => void): void;
+    /** Register a close handler. */
+    onClose(handler: () => void): void;
+    /** Close the transport. */
+    close(): void;
+}
+declare const ACP_METHODS: {
+    readonly INITIALIZE: "initialize";
+    readonly SESSION_NEW: "session/new";
+    readonly SESSION_PROMPT: "session/prompt";
+    readonly SESSION_LOAD: "session/load";
+    readonly SESSION_ABORT: "session/abort";
+    readonly FS_READ: "fs/read_text_file";
+    readonly FS_READ_BYTES: "fs/read_bytes";
+    readonly FS_WRITE: "fs/write_text_file";
+    readonly FS_STAT: "fs/stat";
+    readonly FS_EXISTS: "fs/exists";
+    readonly FS_READDIR: "fs/readdir";
+    readonly FS_MKDIR: "fs/mkdir";
+    readonly FS_DELETE: "fs/delete";
+    readonly TERMINAL_EXEC: "terminal/exec";
+    readonly STREAM_TEXT: "stream/text";
+    readonly STREAM_THINKING: "stream/thinking";
+    readonly STREAM_TOOL_USE: "stream/toolUse";
+    readonly STREAM_TOOL_RESULT: "stream/toolResult";
+    readonly STREAM_COMPLETE: "stream/complete";
+    readonly STREAM_ERROR: "stream/error";
+    readonly PERMISSION_REQUEST: "permission/request";
+    readonly PERMISSION_RESPONSE: "permission/response";
+    readonly USER_INPUT_REQUEST: "userInput/request";
+    readonly USER_INPUT_RESPONSE: "userInput/response";
+};
+
+export { type AcpTransport as A, ACP_METHODS as a, type AcpCapabilities as b, type AcpInitializeParams as c, type AcpInitializeResult as d, type AcpSessionNewParams as e, type AcpSessionPromptParams as f };

package/package.json

@@ -1,15 +1,74 @@
 {
   "name": "noumen",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "description": "Programmatic AI coding agent library with pluggable providers and virtual infrastructure",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "bin": {
+    "noumen": "./dist/cli/index.js"
+  },
   "exports": {
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./openai": {
+      "import": "./dist/providers/openai.js",
+      "types": "./dist/providers/openai.d.ts"
+    },
+    "./anthropic": {
+      "import": "./dist/providers/anthropic.js",
+      "types": "./dist/providers/anthropic.d.ts"
+    },
+    "./gemini": {
+      "import": "./dist/providers/gemini.js",
+      "types": "./dist/providers/gemini.d.ts"
+    },
+    "./openrouter": {
+      "import": "./dist/providers/openrouter.js",
+      "types": "./dist/providers/openrouter.d.ts"
+    },
+    "./bedrock": {
+      "import": "./dist/providers/bedrock.js",
+      "types": "./dist/providers/bedrock.d.ts"
+    },
+    "./vertex": {
+      "import": "./dist/providers/vertex.js",
+      "types": "./dist/providers/vertex.d.ts"
+    },
+    "./ollama": {
+      "import": "./dist/providers/ollama.js",
+      "types": "./dist/providers/ollama.d.ts"
+    },
+    "./mcp": {
+      "import": "./dist/mcp/index.js",
+      "types": "./dist/mcp/index.d.ts"
+    },
+    "./lsp": {
+      "import": "./dist/lsp/index.js",
+      "types": "./dist/lsp/index.d.ts"
+    },
+    "./server": {
+      "import": "./dist/server/index.js",
+      "types": "./dist/server/index.d.ts"
+    },
+    "./client": {
+      "import": "./dist/client/index.js",
+      "types": "./dist/client/index.d.ts"
+    },
+    "./acp": {
+      "import": "./dist/acp/index.js",
+      "types": "./dist/acp/index.d.ts"
+    },
+    "./a2a": {
+      "import": "./dist/a2a/index.js",
+      "types": "./dist/a2a/index.d.ts"
+    },
+    "./jsonrpc": {
+      "import": "./dist/jsonrpc/index.js",
+      "types": "./dist/jsonrpc/index.d.ts"
     }
   },
   "files": [
@@ -19,23 +78,92 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "openai": "^4.85.0",
+    "@anthropic-ai/sandbox-runtime": "^0.0.49",
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "node-html-markdown": "^2.0.0",
+    "uuid": "^11.1.0"
+  },
+  "peerDependencies": {
     "@anthropic-ai/sdk": "^0.39.0",
     "@google/genai": "^1.48.0",
-    "uuid": "^11.1.0"
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "openai": "^4.85.0",
+    "vscode-jsonrpc": "^8.2.1",
+    "@opentelemetry/api": "^1.0.0",
+    "@anthropic-ai/bedrock-sdk": ">=0.10.0",
+    "@anthropic-ai/vertex-sdk": ">=0.4.0",
+    "google-auth-library": ">=9.0.0",
+    "dockerode": ">=4.0.0",
+    "e2b": ">=2.0.0",
+    "ws": ">=8.0.0",
+    "sharp": ">=0.33.0"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/sdk": {
+      "optional": true
+    },
+    "@google/genai": {
+      "optional": true
+    },
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    },
+    "openai": {
+      "optional": true
+    },
+    "vscode-jsonrpc": {
+      "optional": true
+    },
+    "@opentelemetry/api": {
+      "optional": true
+    },
+    "@anthropic-ai/bedrock-sdk": {
+      "optional": true
+    },
+    "@anthropic-ai/vertex-sdk": {
+      "optional": true
+    },
+    "google-auth-library": {
+      "optional": true
+    },
+    "dockerode": {
+      "optional": true
+    },
+    "e2b": {
+      "optional": true
+    },
+    "ws": {
+      "optional": true
+    },
+    "sharp": {
+      "optional": true
+    }
   },
   "devDependencies": {
-    "typescript": "^5.7.0",
+    "@anthropic-ai/sdk": "^0.39.0",
+    "@google/genai": "^1.48.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "openai": "^4.85.0",
+    "vscode-jsonrpc": "^8.2.1",
+    "@opentelemetry/api": "^1.9.1",
     "@types/node": "^22.0.0",
     "@types/uuid": "^10.0.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "concurrently": "^9.2.1",
     "tsup": "^8.4.0",
-    "vitest": "^3.0.0"
+    "tsx": "^4.21.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0",
+    "ws": "^8.18.0",
+    "@types/ws": "^8.5.0"
   },
   "scripts": {
     "build": "tsup",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
-    "dev": "tsup --watch",
+    "dev": "concurrently -n lib,web -c blue,magenta \"tsup --watch\" \"pnpm --filter noumen-docs dev\"",
+    "cli": "tsx src/cli/index.ts",
     "publish:lib": "pnpm publish --access public --no-git-checks"
   }
 }