@sourcegraph/amp-sdk 0.1.0-20251014160341-g7c5de51 → 0.1.0-20251021152627-g8658f12

package/dist/types.d.ts

@@ -91,7 +91,9 @@ export interface ErrorResultMessage extends BaseResultMessage {
     is_error: true;
     error: string;
 }
+/** Union of all possible stream messages */
 export type StreamMessage = SystemMessage | AssistantMessage | UserMessage | ResultMessage | ErrorResultMessage;
+/** User input message schema */
 export declare const UserInputMessageSchema: z.ZodObject<{
     type: z.ZodLiteral<"user">;
     message: z.ZodObject<{
@@ -138,6 +140,51 @@ export declare const UserInputMessageSchema: z.ZodObject<{
     };
     type: "user";
 }>;
+/** User input message for streaming conversations */
+export type UserInputMessage = z.infer<typeof UserInputMessageSchema>;
+/** Recursive type for permission match conditions */
+export type PermissionMatchCondition = string | PermissionMatchCondition[] | {
+    [key in string]: PermissionMatchCondition;
+} | boolean | number | null | undefined;
+/** Permission match condition for tool arguments schema */
+export declare const PermissionMatchConditionSchema: z.ZodType<PermissionMatchCondition>;
+/** Individual permission schema */
+export declare const PermissionSchema: z.ZodEffects<z.ZodObject<{
+    tool: z.ZodString;
+    matches: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<PermissionMatchCondition, z.ZodTypeDef, PermissionMatchCondition>>>;
+    action: z.ZodEnum<["allow", "reject", "ask", "delegate"]>;
+    context: z.ZodOptional<z.ZodEnum<["thread", "subagent"]>>;
+    to: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    tool: string;
+    action: "allow" | "reject" | "ask" | "delegate";
+    matches?: Record<string, PermissionMatchCondition> | undefined;
+    context?: "thread" | "subagent" | undefined;
+    to?: string | undefined;
+}, {
+    tool: string;
+    action: "allow" | "reject" | "ask" | "delegate";
+    matches?: Record<string, PermissionMatchCondition> | undefined;
+    context?: "thread" | "subagent" | undefined;
+    to?: string | undefined;
+}>, {
+    tool: string;
+    action: "allow" | "reject" | "ask" | "delegate";
+    matches?: Record<string, PermissionMatchCondition> | undefined;
+    context?: "thread" | "subagent" | undefined;
+    to?: string | undefined;
+}, {
+    tool: string;
+    action: "allow" | "reject" | "ask" | "delegate";
+    matches?: Record<string, PermissionMatchCondition> | undefined;
+    context?: "thread" | "subagent" | undefined;
+    to?: string | undefined;
+}>;
+/** Permission */
+export type Permission = z.infer<typeof PermissionSchema>;
+/** Permissions list */
+export type PermissionsList = Permission[];
+/** MCP server configuration schema */
 export declare const MCPServerSchema: z.ZodObject<{
     command: z.ZodString;
     args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -151,6 +198,7 @@ export declare const MCPServerSchema: z.ZodObject<{
     args?: string[] | undefined;
     env?: Record<string, string> | undefined;
 }>;
+/** MCP configuration schema */
 export declare const MCPConfigSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
     command: z.ZodString;
     args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -164,6 +212,11 @@ export declare const MCPConfigSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
     args?: string[] | undefined;
     env?: Record<string, string> | undefined;
 }>>;
+/** MCP server configuration */
+export type MCPServer = z.infer<typeof MCPServerSchema>;
+/** MCP configuration object */
+export type MCPConfig = z.infer<typeof MCPConfigSchema>;
+/** Configuration options for Amp execution schema */
 export declare const AmpOptionsSchema: z.ZodObject<{
     cwd: z.ZodOptional<z.ZodString>;
     dangerouslyAllowAll: z.ZodOptional<z.ZodBoolean>;
@@ -187,6 +240,37 @@ export declare const AmpOptionsSchema: z.ZodObject<{
     env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     continue: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodString]>>;
     toolbox: z.ZodOptional<z.ZodString>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
+        tool: z.ZodString;
+        matches: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<PermissionMatchCondition, z.ZodTypeDef, PermissionMatchCondition>>>;
+        action: z.ZodEnum<["allow", "reject", "ask", "delegate"]>;
+        context: z.ZodOptional<z.ZodEnum<["thread", "subagent"]>>;
+        to: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        tool: string;
+        action: "allow" | "reject" | "ask" | "delegate";
+        matches?: Record<string, PermissionMatchCondition> | undefined;
+        context?: "thread" | "subagent" | undefined;
+        to?: string | undefined;
+    }, {
+        tool: string;
+        action: "allow" | "reject" | "ask" | "delegate";
+        matches?: Record<string, PermissionMatchCondition> | undefined;
+        context?: "thread" | "subagent" | undefined;
+        to?: string | undefined;
+    }>, {
+        tool: string;
+        action: "allow" | "reject" | "ask" | "delegate";
+        matches?: Record<string, PermissionMatchCondition> | undefined;
+        context?: "thread" | "subagent" | undefined;
+        to?: string | undefined;
+    }, {
+        tool: string;
+        action: "allow" | "reject" | "ask" | "delegate";
+        matches?: Record<string, PermissionMatchCondition> | undefined;
+        context?: "thread" | "subagent" | undefined;
+        to?: string | undefined;
+    }>, "many">>;
 }, "strict", z.ZodTypeAny, {
     env?: Record<string, string> | undefined;
     cwd?: string | undefined;
@@ -202,6 +286,13 @@ export declare const AmpOptionsSchema: z.ZodObject<{
     }> | undefined;
     continue?: string | boolean | undefined;
     toolbox?: string | undefined;
+    permissions?: {
+        tool: string;
+        action: "allow" | "reject" | "ask" | "delegate";
+        matches?: Record<string, PermissionMatchCondition> | undefined;
+        context?: "thread" | "subagent" | undefined;
+        to?: string | undefined;
+    }[] | undefined;
 }, {
     env?: Record<string, string> | undefined;
     cwd?: string | undefined;
@@ -217,18 +308,19 @@ export declare const AmpOptionsSchema: z.ZodObject<{
     }> | undefined;
     continue?: string | boolean | undefined;
     toolbox?: string | undefined;
+    permissions?: {
+        tool: string;
+        action: "allow" | "reject" | "ask" | "delegate";
+        matches?: Record<string, PermissionMatchCondition> | undefined;
+        context?: "thread" | "subagent" | undefined;
+        to?: string | undefined;
+    }[] | 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 */
+/** Configuration options for Amp 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 */
+/** Options for executing Amp commands */
 export interface ExecuteOptions {
     prompt: PromptInput;
     options?: AmpOptions;

package/package.json

@@ -4,7 +4,7 @@
     "email": "amp-devs@sourcegraph.com"
   },
   "dependencies": {
-    "@sourcegraph/amp": "0.0.1760457121-ge7f0f2",
+    "@sourcegraph/amp": "latest",
     "zod": "^3.23.8"
   },
   "description": "TypeScript SDK for Amp CLI - Build custom AI agents with Amp's capabilities",
@@ -44,12 +44,12 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "0.1.0-20251014160341-g7c5de51",
+  "version": "0.1.0-20251021152627-g8658f12",
   "scripts": {
-    "build": "pnpm exec tsc -b",
+    "build": "bun run scripts/build.ts",
     "dev": "pnpm exec tsc -b --watch",
     "clean": "rm -rf dist tsconfig.tsbuildinfo",
-    "examples:basic": "pnpm run build && bun run examples/basic-usage.ts",
+    "examples:basic": "pnpm run build && bun run examples/basic.ts",
     "test": "vitest run",
     "test:watch": "vitest",
     "pin-cli-version": "bun run scripts/pin-cli-version.ts"

package/dist/types.js

@@ -1,64 +0,0 @@
-/**
- * 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(),
-});
-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