@sourcegraph/amp-sdk 0.1.0-3e67faf1b0e66cf0d3bf2985979efbcac0554a79

package/LICENSE.md

@@ -0,0 +1 @@
+© Sourcegraph Inc. All rights reserved. Use of Amp is subject to Amp's [Terms of Service](https://ampcode.com/terms).

package/README.md

@@ -0,0 +1,367 @@
+# Amp TypeScript SDK
+
+Use the Amp SDK to programmatically deploy the Amp agent anywhere you run TypeScript. Execute Amp CLI commands programmatically with full type safety, streaming responses, and complete control over your AI coding agent workflows.
+
+## Why use the Amp SDK?
+
+The Amp TypeScript SDK brings the Amp agent directly into your applications with simple, reliable functionality:
+
+- **Stream Inputs**: Send prompts and messages incrementally to the Amp agent
+- **Stream Outputs**: Receive structured JSON responses (system, assistant, result) as the agent executes tasks
+- **Multi-turn Conversations**: Maintain back-and-forth interactions across multiple executions
+- **Thread Continuity**: Continue an existing thread (latest or by ID) to build stateful agent workflows
+- **Programmatic Settings**: Configure working directories, settings, and tools without user prompts — ideal for automation
+- **MCP Integration**: Extend Amp with custom Model Context Protocol servers and tools
+- **Custom Tools**: Define and use custom tools to extend Amp's functionality with Toolboxes
+
+## What can you build?
+
+The Amp SDK enables a wide range of AI-powered applications:
+
+### Development Tools
+
+- **Code Review Agent**: Automated pull request analysis and feedback
+- **Documentation Generator**: Create and maintain project documentation
+- **Test Automation**: Generate and execute test suites
+- **Migration Assistant**: Help upgrade codebases and refactor legacy code
+
+### Workflow Automation
+
+- **CI/CD Integration**: Smart build and deployment pipelines
+- **Issue Triage**: Automatically categorize and prioritize bug reports
+- **Code Quality Monitoring**: Continuous analysis of code health metrics
+- **Release Management**: Automated changelog generation and version bumping
+
+## Quick Start
+
+### Installation
+
+Install the Amp SDK using `npm` or `yarn`:
+
+```bash
+# npm
+npm install @sourcegraph/amp-sdk
+
+# yarn
+yarn add @sourcegraph/amp-sdk
+```
+
+Once installed, add your API key to the environment. You can access your API key at [ampcode.com/settings](https://ampcode.com/settings).
+
+```bash
+export AMP_API_KEY=sgamp_your_api_key_here
+```
+
+### Your First Amp Command
+
+Now that you have the SDK installed and your API key set up, you can start using Amp with the `execute()` function:
+
+```typescript
+import { execute } from '@sourcegraph/amp-sdk'
+
+// Simple execution - get the final result
+for await (const message of execute({ prompt: 'What files are in this directory?' })) {
+	if (message.type === 'result' && !message.is_error) {
+		console.log('Result:', message.result)
+		break
+	}
+}
+```
+
+The `execute()` function only requires that you provide a `prompt` to get started. The SDK streams messages as the agent works, letting you handle responses and integrate them directly into your application.
+
+## Core Concepts
+
+### Message Streaming
+
+The SDK streams different types of messages as your agent executes:
+
+```typescript
+for await (const message of execute({ prompt: 'Run tests' })) {
+	if (message.type === 'system') {
+		// Session info, available tools, MCP servers
+		console.log('Available tools:', message.tools)
+	} else if (message.type === 'assistant') {
+		// AI responses and tool usage
+		console.log('Assistant is working...')
+	} else if (message.type === 'result') {
+		// Final result (success or error)
+		console.log('Done:', message.result)
+	}
+}
+```
+
+### Simple Result Extraction
+
+When you just need the final result without handling streaming:
+
+```typescript
+async function getResult(prompt: string): Promise<string> {
+	for await (const message of execute({ prompt, options: { dangerouslyAllowAll: true } })) {
+		if (message.type === 'result') {
+			if (message.is_error) {
+				throw new Error(message.error)
+			}
+			return message.result
+		}
+	}
+	throw new Error('No result received')
+}
+
+// Usage
+try {
+	const result = await getResult('List all TypeScript files in this project')
+	console.log('Found files:', result)
+} catch (error) {
+	console.error('Failed:', error.message)
+}
+```
+
+### Thread Continuity
+
+Continue conversations across multiple interactions:
+
+```typescript
+// Continue the most recent conversation
+for await (const message of execute({
+	prompt: 'What was the last error you found?',
+	options: { continue: true },
+})) {
+	if (message.type === 'result') {
+		console.log(message.result)
+	}
+}
+
+// Continue a specific thread by ID
+for await (const message of execute({
+	prompt: 'Can you update that code we discussed?',
+	options: { continue: 'T-abc123-def456' },
+})) {
+	if (message.type === 'result') {
+		console.log(message.result)
+	}
+}
+```
+
+## Common Configuration
+
+### Skip Permission Prompts
+
+For automation scenarios, bypass permission prompts:
+
+```typescript
+const options = {
+	dangerouslyAllowAll: true, // Skip permission prompts
+}
+
+for await (const message of execute({
+	prompt: 'Make changes without asking for permission',
+	options,
+})) {
+	// Handle messages...
+}
+```
+
+### Working Directory
+
+Specify where Amp should run:
+
+```typescript
+for await (const message of execute({
+	prompt: 'Refactor the auth module',
+	options: { cwd: './my-project' },
+})) {
+	// Process messages...
+}
+```
+
+### Enable Debug Logging
+
+See what's happening under the hood:
+
+```typescript
+for await (const message of execute({
+	prompt: 'Analyze this project',
+	options: {
+		logLevel: 'debug', // Shows CLI command in console
+		logFile: './amp-debug.log', // Optional: write logs to file
+	},
+})) {
+	// Process messages
+}
+```
+
+## Advanced Usage
+
+### Interactive Progress Tracking
+
+For building user interfaces that show real-time progress:
+
+```typescript
+async function executeWithProgress(prompt: string) {
+	console.log('Starting task...')
+
+	for await (const message of execute({ prompt })) {
+		if (message.type === 'system' && message.subtype === 'init') {
+			console.log('Tools available:', message.tools.join(', '))
+		} else if (message.type === 'assistant') {
+			// Show tool usage or assistant responses
+			const content = message.message.content[0]
+			if (content.type === 'tool_use') {
+				console.log(`Using ${content.name}...`)
+			} else if (content.type === 'text') {
+				console.log('Assistant:', content.text.slice(0, 100) + '...')
+			}
+		} else if (message.type === 'result') {
+			if (message.is_error) {
+				console.log('Failed:', message.error)
+			} else {
+				console.log('Completed successfully!')
+				console.log(message.result)
+			}
+		}
+	}
+}
+```
+
+### Cancellation and Timeouts
+
+Handle long-running operations gracefully:
+
+```typescript
+async function executeWithTimeout(prompt: string, timeoutMs = 30000) {
+	const signal = AbortSignal.timeout(timeoutMs)
+
+	try {
+		for await (const message of execute({
+			prompt,
+			signal,
+			options: { dangerouslyAllowAll: true },
+		})) {
+			if (message.type === 'result') {
+				return message.result
+			}
+		}
+	} catch (error) {
+		if (error.message.includes('aborted')) {
+			throw new Error(`Operation timed out after ${timeoutMs}ms`)
+		}
+		throw error
+	}
+}
+```
+
+### MCP (Model Context Protocol) Integration
+
+Extend Amp's capabilities with custom tools and data sources:
+
+```typescript
+import { execute, type MCPConfig } from '@sourcegraph/amp-sdk'
+
+const mcpConfig: MCPConfig = {
+	playwright: {
+		command: 'npx',
+		args: ['-y', '@playwright/mcp@latest', '--headless'],
+		env: { NODE_ENV: 'production' },
+	},
+	database: {
+		command: 'node',
+		args: ['./custom-mcp-server.js'],
+		env: { DB_CONNECTION_STRING: process.env.DATABASE_URL },
+	},
+}
+
+for await (const message of execute({
+	prompt: 'Test the login flow on staging environment',
+	options: { mcpConfig, dangerouslyAllowAll: true },
+})) {
+	if (message.type === 'system') {
+		console.log(
+			'MCP Servers:',
+			message.mcp_servers.map((s) => `${s.name}: ${s.status}`),
+		)
+	}
+	// Handle other messages...
+}
+```
+
+To find out more about extending Amp with MCP servers, visit the [MCP Configuration](https://ampcode.com/manual#mcp) section of the manual.
+
+### Multi-turn Conversations
+
+Build streaming conversations using async generators:
+
+```typescript
+import { execute, createUserMessage } from '@sourcegraph/amp-sdk'
+
+async function* generateMessages() {
+	yield createUserMessage('Start analyzing the codebase')
+
+	// Wait for some condition or user input
+	await new Promise((resolve) => setTimeout(resolve, 1000))
+
+	yield createUserMessage('Now focus on the authentication module')
+}
+
+for await (const message of execute({
+	prompt: generateMessages(),
+})) {
+	if (message.type === 'result') {
+		console.log(message.result)
+	}
+}
+```
+
+### Settings File Configuration
+
+Configure Amp's behavior with a settings file, like the `settings.json`. You can provide Amp with a custom settings file you have saved in your project:
+
+```typescript
+import { execute } from '@sourcegraph/amp-sdk'
+
+// Use a custom settings file
+for await (const message of execute({
+	prompt: 'Deploy the application',
+	options: {
+		settingsFile: './settings.json',
+		logLevel: 'debug',
+	},
+})) {
+	// Handle messages...
+}
+```
+
+Example `settings.json`:
+
+```json
+{
+	"amp.mcpServers": {
+		"playwright": {
+			"command": "npx",
+			"args": ["-y", "@playwright/mcp@latest", "--headless", "--isolated"]
+		}
+	},
+	"amp.todos.enabled": false,
+	"amp.commands.allowlist": ["npx", "node", "npm"],
+	"amp.tools.disable": ["mermaid", "mcp__playwright__browser_resize"]
+}
+```
+
+To find all available settings, see the [Configuration Settings](https://ampcode.com/manual#configuration).
+
+### Custom Tools
+
+Extend Amp's capabilities with custom toolbox scripts:
+
+```typescript
+for await (const message of execute({
+	prompt: 'Use my custom deployment scripts',
+	options: {
+		toolbox: '/usr/repository-path/toolbox', // Path to toolbox scripts
+	},
+})) {
+	// Handle messages...
+}
+```
+
+To find out more about Amp Toolboxes, see the [Toolboxes](https://ampcode.com/manual#toolboxes) section of the Amp documentation.

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Amp TypeScript SDK
+ *
+ * This SDK provides a TypeScript interface to the Amp CLI, allowing you to
+ * run Amp programmatically in Node.js applications. It wraps the Amp CLI
+ * with the --stream-json flag to provide structured output.
+ */
+import { type ExecuteOptions, type StreamMessage, type UserInputMessage } from './types.js';
+/**
+ * Execute a command with Amp CLI and return an async iterator of messages
+ *
+ * @param options Execute configuration including prompt and options
+ * @returns Async iterator of stream messages from Amp CLI
+ */
+export declare function execute(options: ExecuteOptions): AsyncIterable<StreamMessage>;
+/**
+ * Helper function to create streaming input messages
+ */
+export declare function createUserMessage(text: string): UserInputMessage;
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EAGN,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EAErB,MAAM,YAAY,CAAA;AASnB;;;;;GAKG;AACH,wBAAuB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CAAC,aAAa,CAAC,CA0EpF;AAmRD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAQhE;AAMD,cAAc,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,325 @@
+/**
+ * Amp TypeScript SDK
+ *
+ * This SDK provides a TypeScript interface to the Amp CLI, allowing you to
+ * run Amp programmatically in Node.js applications. It wraps the Amp CLI
+ * with the --stream-json flag to provide structured output.
+ */
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { createInterface } from 'node:readline';
+import { AmpOptionsSchema, UserInputMessageSchema, } from './types.js';
+// Platform detection
+const isWindows = process.platform === 'win32';
+// ============================================================================
+// Main Execute Function
+// ============================================================================
+/**
+ * Execute a command with Amp CLI and return an async iterator of messages
+ *
+ * @param options Execute configuration including prompt and options
+ * @returns Async iterator of stream messages from Amp CLI
+ */
+export async function* execute(options) {
+    const { prompt, options: ampOptions = {}, signal } = options;
+    // Validate options
+    const validatedOptions = AmpOptionsSchema.parse(ampOptions);
+    // Handle different prompt types
+    const isStreamingInput = typeof prompt !== 'string' && Symbol.asyncIterator in prompt;
+    // Build CLI arguments
+    const args = buildCliArgs(validatedOptions);
+    // Add flag for streaming input if needed
+    if (isStreamingInput) {
+        args.push('--stream-json-input');
+    }
+    // Log the full CLI command for debugging (only in debug mode)
+    if (process.env.AMP_DEBUG || validatedOptions.logLevel === 'debug') {
+        const ampCommand = findAmpCommand();
+        console.debug(`Executing Amp CLI: ${ampCommand.command} ${[...ampCommand.args, ...args].join(' ')}`);
+    }
+    // Build environment variables
+    const env = buildEnvironmentVariables(validatedOptions);
+    // Spawn Amp CLI process
+    const ampProcess = spawnAmpCli(args, {
+        env,
+        cwd: validatedOptions.cwd,
+        signal,
+    });
+    try {
+        // Handle input via stdin
+        if (isStreamingInput) {
+            handleStreamingInput(ampProcess, prompt);
+        }
+        else if (typeof prompt === 'string' && prompt) {
+            handleStringInput(ampProcess, prompt);
+        }
+        // Process output stream
+        yield* processOutputStream(ampProcess.stdout);
+        // Wait for process to complete and check exit code
+        const { exitCode, stderr, signal: processSignal } = await waitForProcess(ampProcess, signal);
+        // Handle exit code properly - null indicates signal termination
+        if (exitCode === null) {
+            // Process was killed by signal
+            if (signal?.aborted) {
+                // Expected termination due to AbortController
+                throw new Error('Amp CLI process was aborted');
+            }
+            else if (processSignal) {
+                // Killed by system signal
+                throw new Error(`Amp CLI process was killed by signal ${processSignal}`);
+            }
+            else {
+                // Unexpected null exit code
+                throw new Error('Amp CLI process terminated unexpectedly');
+            }
+        }
+        else if (exitCode !== 0) {
+            // Normal exit with error code
+            const errorDetails = stderr ? `: ${stderr}` : '';
+            throw new Error(`Amp CLI process exited with code ${exitCode}${errorDetails}`);
+        }
+    }
+    catch (error) {
+        // Clean up process on error
+        if (!ampProcess.killed) {
+            ampProcess.kill(isWindows ? 'SIGKILL' : 'SIGTERM');
+        }
+        throw error;
+    }
+}
+// ============================================================================
+// Environment Variable Management
+// ============================================================================
+/**
+ * Build environment variables for the Amp CLI process
+ * Combines system environment variables with user-provided options
+ */
+function buildEnvironmentVariables(options) {
+    const env = {
+        ...process.env,
+    };
+    // Set AMP_TOOLBOX if toolbox option is provided
+    if (options.toolbox) {
+        env.AMP_TOOLBOX = options.toolbox;
+    }
+    // User-provided env variables override system ones
+    if (options.env) {
+        Object.assign(env, options.env);
+    }
+    return env;
+}
+// ============================================================================
+// CLI Process Management
+// ============================================================================
+function spawnAmpCli(args, options) {
+    const { env, cwd, signal } = options;
+    // Find amp executable
+    const ampCommand = findAmpCommand();
+    const childProcess = spawn(ampCommand.command, [...ampCommand.args, ...args], {
+        cwd: cwd || process.cwd(),
+        env: env || process.env,
+        stdio: ['pipe', 'pipe', 'pipe'],
+        signal,
+    });
+    // Add error handler immediately to prevent unhandled error events
+    childProcess.on('error', () => {
+        // Error will be handled by waitForProcess
+    });
+    return childProcess;
+}
+function findAmpCommand() {
+    // Try to find the local CLI (npm already resolved the correct version)
+    try {
+        const require = createRequire(import.meta.url);
+        const pkgJsonPath = require.resolve('@sourcegraph/amp/package.json');
+        const pkgJsonRaw = fs.readFileSync(pkgJsonPath, 'utf8');
+        const pkgJson = JSON.parse(pkgJsonRaw);
+        if (pkgJson.bin?.amp) {
+            const binPath = path.join(path.dirname(pkgJsonPath), pkgJson.bin.amp);
+            return {
+                command: 'node',
+                args: [binPath],
+            };
+        }
+        throw new Error('Local @sourcegraph/amp package found but no bin entry for Amp CLI');
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('Local @sourcegraph/amp')) {
+            throw error;
+        }
+        throw new Error('Could not find local @sourcegraph/amp package. Make sure it is installed.');
+    }
+}
+function buildCliArgs(options) {
+    const args = [];
+    // Handle continue option first as it changes the base command structure
+    if (typeof options.continue === 'string') {
+        args.push('threads', 'continue', options.continue);
+    }
+    else if (options.continue === true) {
+        args.push('threads', 'continue');
+    }
+    // Add execute and stream-json flags
+    args.push('--execute', '--stream-json');
+    // Optional flags
+    if (options.dangerouslyAllowAll) {
+        args.push('--dangerously-allow-all');
+    }
+    if (options.visibility) {
+        args.push('--visibility', options.visibility);
+    }
+    if (options.settingsFile) {
+        args.push('--settings-file', options.settingsFile);
+    }
+    if (options.logLevel) {
+        args.push('--log-level', options.logLevel);
+    }
+    if (options.logFile) {
+        args.push('--log-file', options.logFile);
+    }
+    if (options.mcpConfig) {
+        const mcpConfigValue = typeof options.mcpConfig === 'string'
+            ? options.mcpConfig
+            : JSON.stringify(options.mcpConfig);
+        args.push('--mcp-config', mcpConfigValue);
+    }
+    return args;
+}
+// ============================================================================
+// Stream Processing
+// ============================================================================
+async function* processOutputStream(stdout) {
+    if (!stdout) {
+        throw new Error('No stdout stream available from Amp CLI process');
+    }
+    const readline = createInterface({
+        input: stdout,
+        crlfDelay: Number.POSITIVE_INFINITY,
+    });
+    try {
+        for await (const line of readline) {
+            if (!line.trim())
+                continue;
+            try {
+                const message = JSON.parse(line);
+                yield message;
+            }
+            catch (parseError) {
+                throw new Error(`Failed to parse JSON response, raw line: ${line}`);
+            }
+        }
+    }
+    finally {
+        readline.close();
+    }
+}
+async function handleStreamingInput(process, prompt, signal) {
+    if (!process.stdin) {
+        throw new Error('No stdin stream available for Amp CLI process');
+    }
+    // Check if already aborted before starting
+    signal?.throwIfAborted();
+    try {
+        for await (const message of prompt) {
+            // Check for abort before processing each message
+            signal?.throwIfAborted();
+            // Validate message format
+            const validatedMessage = UserInputMessageSchema.parse(message);
+            // Send the complete JSON message
+            const jsonMessage = JSON.stringify(validatedMessage) + '\n';
+            if (!process.stdin.write(jsonMessage)) {
+                // Wait for drain if buffer is full, but allow cancellation during wait
+                await new Promise((resolve, reject) => {
+                    const onAbort = () => reject(signal?.reason || new Error('Aborted'));
+                    signal?.addEventListener('abort', onAbort, { once: true });
+                    process.stdin.once('drain', () => {
+                        // Clean up abort listener when drain completes
+                        signal?.removeEventListener('abort', onAbort);
+                        resolve();
+                    });
+                });
+            }
+        }
+    }
+    finally {
+        // Close stdin to signal end of input
+        process.stdin.end();
+    }
+}
+function handleStringInput(process, prompt) {
+    if (!process.stdin) {
+        throw new Error('No stdin stream available for Amp CLI process');
+    }
+    // Write the prompt to stdin and close it
+    process.stdin.write(prompt + '\n');
+    process.stdin.end();
+}
+function waitForProcess(process, signal) {
+    return new Promise((resolve, reject) => {
+        let resolved = false;
+        let stderrData = '';
+        const cleanup = () => {
+            resolved = true;
+        };
+        // Capture stderr output
+        if (process.stderr) {
+            process.stderr.on('data', (data) => {
+                stderrData += data.toString();
+            });
+        }
+        process.on('exit', (code, processSignal) => {
+            if (!resolved) {
+                cleanup();
+                resolve({ exitCode: code, stderr: stderrData, signal: processSignal });
+            }
+        });
+        process.on('error', (error) => {
+            if (!resolved) {
+                cleanup();
+                reject(error);
+            }
+        });
+        // Handle abort signal
+        if (signal?.aborted) {
+            if (!resolved) {
+                cleanup();
+                reject(new Error('Operation was aborted'));
+            }
+        }
+        else if (signal) {
+            const abortHandler = () => {
+                if (!resolved) {
+                    cleanup();
+                    reject(new Error('Operation was aborted'));
+                }
+            };
+            signal.addEventListener('abort', abortHandler);
+            // Clean up listener
+            process.on('exit', () => {
+                signal.removeEventListener('abort', abortHandler);
+            });
+        }
+    });
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Helper function to create streaming input messages
+ */
+export function createUserMessage(text) {
+    return {
+        type: 'user',
+        message: {
+            role: 'user',
+            content: [{ type: 'text', text }],
+        },
+    };
+}
+// ============================================================================
+// Re-export types for convenience
+// ============================================================================
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,249 @@
+/**
+ * TypeScript SDK types for Amp CLI
+ *
+ * These types are compatible with the Amp CLI --stream-json output.
+ */
+import { z } from 'zod';
+/** Text content block containing plain text */
+export interface TextContent {
+    type: 'text';
+    text: string;
+}
+/** Tool use content block representing a tool call request */
+export interface ToolUseContent {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+/** Tool result content block containing the result of a tool execution */
+export interface ToolResultContent {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string;
+    is_error: boolean;
+}
+/** Token usage information for API calls */
+export interface Usage {
+    input_tokens: number;
+    cache_creation_input_tokens?: number;
+    cache_read_input_tokens?: number;
+    output_tokens: number;
+    service_tier?: string;
+}
+/** Base interface for all message types */
+interface BaseMessage {
+    type: 'system' | 'assistant' | 'user' | 'result';
+    session_id: string;
+}
+/** System initialization message containing session info and available tools */
+export interface SystemMessage extends BaseMessage {
+    type: 'system';
+    subtype: 'init';
+    cwd: string;
+    tools: string[];
+    mcp_servers: {
+        name: string;
+        status: 'connected' | 'connecting' | 'connection-failed' | 'disabled';
+    }[];
+}
+/** AI assistant response message with text and tool usage */
+export interface AssistantMessage extends BaseMessage {
+    type: 'assistant';
+    message: {
+        id: string;
+        type: 'message';
+        role: 'assistant';
+        model: string;
+        content: Array<TextContent | ToolUseContent>;
+        stop_reason: 'end_turn' | 'tool_use' | 'max_tokens' | null;
+        stop_sequence: string | null;
+        usage?: Usage;
+    };
+    parent_tool_use_id: string | null;
+}
+/** User input message containing text or tool results */
+export interface UserMessage extends BaseMessage {
+    type: 'user';
+    message: {
+        role: 'user';
+        content: Array<TextContent | ToolResultContent>;
+    };
+    parent_tool_use_id: string | null;
+}
+/** Base interface for result messages */
+interface BaseResultMessage extends BaseMessage {
+    type: 'result';
+    duration_ms: number;
+    num_turns: number;
+    usage?: Usage;
+    permission_denials?: string[];
+}
+/** Successful execution result message */
+export interface ResultMessage extends BaseResultMessage {
+    subtype: 'success';
+    is_error: false;
+    result: string;
+}
+/** Error result message indicating execution failure */
+export interface ErrorResultMessage extends BaseResultMessage {
+    subtype: 'error_during_execution' | 'error_max_turns';
+    is_error: true;
+    error: string;
+}
+export type StreamMessage = SystemMessage | AssistantMessage | UserMessage | ResultMessage | ErrorResultMessage;
+export declare const UserInputMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"user">;
+    message: z.ZodObject<{
+        role: z.ZodLiteral<"user">;
+        content: z.ZodArray<z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            text: string;
+            type: "text";
+        }, {
+            text: string;
+            type: "text";
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        role: "user";
+        content: {
+            text: string;
+            type: "text";
+        }[];
+    }, {
+        role: "user";
+        content: {
+            text: string;
+            type: "text";
+        }[];
+    }>;
+}, "strip", z.ZodTypeAny, {
+    message: {
+        role: "user";
+        content: {
+            text: string;
+            type: "text";
+        }[];
+    };
+    type: "user";
+}, {
+    message: {
+        role: "user";
+        content: {
+            text: string;
+            type: "text";
+        }[];
+    };
+    type: "user";
+}>;
+export declare const MCPServerSchema: z.ZodObject<{
+    command: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    disabled?: boolean | undefined;
+    args?: string[] | undefined;
+    env?: Record<string, string> | undefined;
+}, {
+    command: string;
+    disabled?: boolean | undefined;
+    args?: string[] | undefined;
+    env?: Record<string, string> | undefined;
+}>;
+export declare const MCPConfigSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    command: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    disabled?: boolean | undefined;
+    args?: string[] | undefined;
+    env?: Record<string, string> | undefined;
+}, {
+    command: string;
+    disabled?: boolean | undefined;
+    args?: string[] | undefined;
+    env?: Record<string, string> | undefined;
+}>>;
+export declare const AmpOptionsSchema: z.ZodObject<{
+    cwd: z.ZodOptional<z.ZodString>;
+    dangerouslyAllowAll: z.ZodOptional<z.ZodBoolean>;
+    visibility: z.ZodOptional<z.ZodDefault<z.ZodEnum<["private", "public", "workspace", "group"]>>>;
+    settingsFile: z.ZodOptional<z.ZodString>;
+    logLevel: z.ZodOptional<z.ZodEnum<["debug", "info", "warn", "error", "audit"]>>;
+    logFile: z.ZodOptional<z.ZodString>;
+    mcpConfig: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodObject<{
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        disabled?: boolean | undefined;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    }, {
+        command: string;
+        disabled?: boolean | undefined;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    }>>]>>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    continue: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodString]>>;
+    toolbox: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    env?: Record<string, string> | undefined;
+    cwd?: string | undefined;
+    dangerouslyAllowAll?: boolean | undefined;
+    visibility?: "private" | "public" | "workspace" | "group" | undefined;
+    settingsFile?: string | undefined;
+    logLevel?: "debug" | "info" | "warn" | "error" | "audit" | undefined;
+    logFile?: string | undefined;
+    mcpConfig?: string | Record<string, {
+        command: string;
+        disabled?: boolean | undefined;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    }> | undefined;
+    continue?: string | boolean | undefined;
+    toolbox?: string | undefined;
+}, {
+    env?: Record<string, string> | undefined;
+    cwd?: string | undefined;
+    dangerouslyAllowAll?: boolean | undefined;
+    visibility?: "private" | "public" | "workspace" | "group" | undefined;
+    settingsFile?: string | undefined;
+    logLevel?: "debug" | "info" | "warn" | "error" | "audit" | undefined;
+    logFile?: string | undefined;
+    mcpConfig?: string | Record<string, {
+        command: string;
+        disabled?: boolean | undefined;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    }> | undefined;
+    continue?: string | boolean | undefined;
+    toolbox?: string | undefined;
+}>;
+/** User input message for streaming conversations */
+export type UserInputMessage = z.infer<typeof UserInputMessageSchema>;
+/** MCP server configuration */
+export type MCPServer = z.infer<typeof MCPServerSchema>;
+/** MCP configuration object */
+export type MCPConfig = z.infer<typeof MCPConfigSchema>;
+/** Configuration options for Amp CLI execution */
+export type AmpOptions = z.infer<typeof AmpOptionsSchema>;
+/** Input type for prompts - either a string or streaming user messages */
+type PromptInput = string | AsyncIterable<UserInputMessage>;
+/** Options for executing Amp CLI commands */
+export interface ExecuteOptions {
+    prompt: PromptInput;
+    options?: AmpOptions;
+    signal?: AbortSignal;
+}
+export {};
+//# 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":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,+CAA+C;AAC/C,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACZ;AAED,8DAA8D;AAC9D,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,UAAU,CAAA;IAChB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B;AAED,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,aAAa,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;CACjB;AAMD,4CAA4C;AAC5C,MAAM,WAAW,KAAK;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,2BAA2B,CAAC,EAAE,MAAM,CAAA;IACpC,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB;AAMD,2CAA2C;AAC3C,UAAU,WAAW;IACpB,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAA;IAChD,UAAU,EAAE,MAAM,CAAA;CAClB;AAED,gFAAgF;AAChF,MAAM,WAAW,aAAc,SAAQ,WAAW;IACjD,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,WAAW,EAAE;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,EAAE,WAAW,GAAG,YAAY,GAAG,mBAAmB,GAAG,UAAU,CAAA;KACrE,EAAE,CAAA;CACH;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACpD,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE;QACR,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,EAAE,SAAS,CAAA;QACf,IAAI,EAAE,WAAW,CAAA;QACjB,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,KAAK,CAAC,WAAW,GAAG,cAAc,CAAC,CAAA;QAC5C,WAAW,EAAE,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,IAAI,CAAA;QAC1D,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;QAC5B,KAAK,CAAC,EAAE,KAAK,CAAA;KACb,CAAA;IACD,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;CACjC;AAED,yDAAyD;AACzD,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE;QACR,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,KAAK,CAAC,WAAW,GAAG,iBAAiB,CAAC,CAAA;KAC/C,CAAA;IACD,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;CACjC;AAED,yCAAyC;AACzC,UAAU,iBAAkB,SAAQ,WAAW;IAC9C,IAAI,EAAE,QAAQ,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC7B;AAED,0CAA0C;AAC1C,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACvD,OAAO,EAAE,SAAS,CAAA;IAClB,QAAQ,EAAE,KAAK,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACd;AAED,wDAAwD;AACxD,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC5D,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAAA;IACrD,QAAQ,EAAE,IAAI,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACb;AAED,MAAM,MAAM,aAAa,GACtB,aAAa,GACb,gBAAgB,GAChB,WAAW,GACX,aAAa,GACb,kBAAkB,CAAA;AAMrB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWjC,CAAA;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;EAQ1B,CAAA;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;GAEgC,CAAA;AAE5D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCnB,CAAA;AAMV,qDAAqD;AACrD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAErE,+BAA+B;AAC/B,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAEvD,+BAA+B;AAC/B,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAEvD,kDAAkD;AAClD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAMzD,0EAA0E;AAC1E,KAAK,WAAW,GAAG,MAAM,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAA;AAE3D,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,WAAW,CAAA;IACnB,OAAO,CAAC,EAAE,UAAU,CAAA;IACpB,MAAM,CAAC,EAAE,WAAW,CAAA;CACpB"}

package/dist/types.js

@@ -0,0 +1,65 @@
+/**
+ * TypeScript SDK types for Amp CLI
+ *
+ * These types are compatible with the Amp CLI --stream-json output.
+ */
+import { z } from 'zod';
+// ============================================================================
+// Validation Schemas (defined to derive interfaces from)
+// ============================================================================
+export const UserInputMessageSchema = z.object({
+    type: z.literal('user'),
+    message: z.object({
+        role: z.literal('user'),
+        content: z.array(z.object({
+            type: z.literal('text'),
+            text: z.string(),
+        })),
+    }),
+});
+export const MCPServerSchema = z.object({
+    command: z.string().describe('Command to run the MCP server'),
+    args: z.array(z.string()).describe('Arguments for the MCP server command').optional(),
+    env: z
+        .record(z.string(), z.string())
+        .describe('Environment variables for the server')
+        .optional(),
+    disabled: z.boolean().describe('Whether the server is disabled').optional(),
+});
+export const MCPConfigSchema = z
+    .record(z.string(), MCPServerSchema)
+    .describe('MCP server configurations keyed by server name');
+export const AmpOptionsSchema = z
+    .object({
+    cwd: z.string().describe('Current working directory').optional(),
+    dangerouslyAllowAll: z
+        .boolean()
+        .describe('Allow all tool usage without asking for permission')
+        .optional(),
+    visibility: z
+        .enum(['private', 'public', 'workspace', 'group'])
+        .describe('Visibility level for new threads')
+        .default('workspace')
+        .optional(),
+    settingsFile: z.string().describe('Settings file path').optional(),
+    logLevel: z
+        .enum(['debug', 'info', 'warn', 'error', 'audit'])
+        .describe('Log level')
+        .optional(),
+    logFile: z.string().describe('Log file path').optional(),
+    mcpConfig: z
+        .union([z.string(), MCPConfigSchema])
+        .describe('MCP server configuration as JSON string, path to JSON file, or config object')
+        .optional(),
+    env: z
+        .record(z.string(), z.string())
+        .describe('Additional environment variables')
+        .optional(),
+    continue: z
+        .union([z.boolean(), z.string()])
+        .describe('Continue the most recent thread (true) or a specific thread by ID (string)')
+        .optional(),
+    toolbox: z.string().describe('Folder path with toolbox scripts').optional(),
+})
+    .strict();
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,59 @@
+{
+	"name": "@sourcegraph/amp-sdk",
+	"version": "0.1.0-3e67faf1b0e66cf0d3bf2985979efbcac0554a79",
+	"description": "TypeScript SDK for Amp CLI - Build custom AI agents with Amp's capabilities",
+	"type": "module",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md"
+	],
+	"scripts": {
+		"build": "pnpm exec tsc -b",
+		"dev": "pnpm exec tsc -b --watch",
+		"clean": "rm -rf dist tsconfig.tsbuildinfo",
+		"examples:basic": "pnpm run build && bun run examples/basic-usage.ts",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"prepack": "bun run scripts/pre-pack.ts",
+		"postpack": "bun run scripts/post-pack.ts"
+	},
+	"keywords": [
+		"ai",
+		"agent",
+		"amp",
+		"sourcegraph",
+		"cli",
+		"typescript",
+		"sdk",
+		"automation"
+	],
+	"author": {
+		"name": "The Amp Team at Sourcegraph",
+		"email": "amp-devs@sourcegraph.com"
+	},
+	"license": "SEE LICENSE IN LICENSE.md",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/sourcegraph/amp.git",
+		"directory": "sdk/typescript"
+	},
+	"homepage": "https://ampcode.com/",
+	"publishConfig": {
+		"access": "public"
+	},
+	"engines": {
+		"node": ">=18"
+	},
+	"dependencies": {
+		"@sourcegraph/amp": "0.0.1759502872-g3e67fa",
+		"zod": "^3.23.8"
+	}
+}