@sourcegraph/amp-sdk 0.1.0-20260119121704-g1d8d764 → 0.1.0-20260119163454-ge1dfc84

package/README.md

@@ -12,7 +12,7 @@ The Amp TypeScript SDK brings the Amp agent directly into your applications with
 - **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
+- **Custom Skills**: Define and use custom agent skills to extend Amp's functionality
 
 ## What can you build?
 
@@ -416,6 +416,23 @@ for await (const message of execute({
 
 To find out more about Amp Toolboxes, see the [Toolboxes](https://ampcode.com/manual#toolboxes) section of the Amp documentation.
 
+### Custom Skills
+
+Load custom skills from a specified directory:
+
+```typescript
+for await (const message of execute({
+	prompt: 'Use my custom deployment skill',
+	options: {
+		skills: './my-skills', // Path to custom skills directory
+	},
+})) {
+	// Process messages
+}
+```
+
+To learn more about creating custom skills, see the [Agent Skills](https://ampcode.com/manual#agent-skills) section of the Amp documentation.
+
 ## Functions
 
 ### execute()
@@ -578,6 +595,7 @@ interface AmpOptions {
 	env?: Record<string, string>
 	continue?: boolean | string
 	toolbox?: string
+	skills?: string
 	permissions?: Permission[]
 }
 ```
@@ -597,6 +615,7 @@ interface AmpOptions {
 | `mcpConfig`           | `string \| MCPConfig`                               | -               | MCP server configuration as JSON string, or config object                |
 | `env`                 | `Record<string, string>`                            | -               | Additional environment variables                                         |
 | `toolbox`             | `string`                                            | -               | Folder path with toolbox scripts                                         |
+| `skills`              | `string`                                            | -               | Folder path with custom skills                                           |
 | `permissions`         | [`Permission[]`](#permission)                       | -               | Permission rules for tool usage                                          |
 
 ## Message Types

package/dist/index.js

@@ -4051,6 +4051,7 @@ var AmpOptionsSchema = exports_external.object({
   env: exports_external.record(exports_external.string(), exports_external.string()).describe("Additional environment variables").optional(),
   continue: exports_external.union([exports_external.boolean(), exports_external.string()]).describe("Continue the most recent thread (true) or a specific thread by ID (string)").optional(),
   toolbox: exports_external.string().describe("Folder path with toolbox scripts").optional(),
+  skills: exports_external.string().describe("Folder path with custom skills").optional(),
   permissions: exports_external.array(PermissionSchema).describe("Permission rules for tool usage").optional(),
   enabledTools: exports_external.array(exports_external.string()).describe('Array of tool name patterns to enable. Supports glob patterns (e.g., "mcp__metabase__*"). If not provided, all tools are enabled. If provided, only matching tools are enabled.').optional(),
   systemPrompt: exports_external.string().describe("Custom system prompt text to append to the base system prompt for integration-specific customizations").optional()
@@ -4115,7 +4116,14 @@ function generateSessionId() {
   return `sdk-${Date.now()}-${randomHex}`;
 }
 async function buildSettingsFile(options, sessionId) {
-  if (!options.permissions && !options.mode && !options.enabledTools && !options.systemPrompt) {
+  const settingsFields = [
+    options.permissions,
+    options.mode,
+    options.skills,
+    options.enabledTools,
+    options.systemPrompt
+  ];
+  if (!settingsFields.some(Boolean)) {
     return {
       settingsFilePath: null,
       cleanupTempFile: async () => {}
@@ -4127,8 +4135,8 @@ async function buildSettingsFile(options, sessionId) {
   let mergedSettings = {};
   if (options.settingsFile) {
     try {
-      const settingsContent2 = await readFile(options.settingsFile, "utf-8");
-      mergedSettings = JSON.parse(settingsContent2);
+      const settingsContent = await readFile(options.settingsFile, "utf-8");
+      mergedSettings = JSON.parse(settingsContent);
     } catch (error) {
       if (error.code !== "ENOENT") {
         throw new Error(`Failed to read settings file ${options.settingsFile}: ${error instanceof Error ? error.message : String(error)}`);
@@ -4147,10 +4155,12 @@ async function buildSettingsFile(options, sessionId) {
   if (options.mode === "large") {
     mergedSettings["amp.internal.visibleModes"] = (mergedSettings["amp.internal.visibleModes"] ?? []).concat("large");
   }
+  if (options.skills) {
+    mergedSettings["amp.skills.path"] = options.skills;
+  }
   await mkdir(tempDir, { recursive: true });
-  const settingsContent = JSON.stringify(mergedSettings, null, 2);
-  console.log("[SDK] Writing settings file:", tempSettingsPath, settingsContent);
-  await writeFile(tempSettingsPath, settingsContent, "utf-8");
+  console.log("[SDK] Writing settings file:", tempSettingsPath, mergedSettings);
+  await writeFile(tempSettingsPath, JSON.stringify(mergedSettings, null, 2), "utf-8");
   return {
     settingsFilePath: tempSettingsPath,
     cleanupTempFile: async () => {
@@ -4170,7 +4180,7 @@ function buildEnvironmentVariables(options) {
   if (options.env) {
     Object.assign(env, options.env);
   }
-  env.AMP_SDK_VERSION = "0.1.0-20260119121704-g1d8d764";
+  env.AMP_SDK_VERSION = "0.1.0-20260119163454-ge1dfc84";
   return env;
 }
 function spawnAmpCli(args, options) {
@@ -4374,4 +4384,4 @@ export {
   AmpOptionsSchema
 };
 
-//# debugId=C85BB482A02216E864756E2164756E21
+//# debugId=C0C631A5086DC23F64756E2164756E21

package/dist/types.d.ts

@@ -250,6 +250,7 @@ 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>;
+    skills: 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>>>;
@@ -300,6 +301,7 @@ export declare const AmpOptionsSchema: z.ZodObject<{
     }> | undefined;
     continue?: string | boolean | undefined;
     toolbox?: string | undefined;
+    skills?: string | undefined;
     permissions?: {
         tool: string;
         action: "allow" | "reject" | "ask" | "delegate";
@@ -326,6 +328,7 @@ export declare const AmpOptionsSchema: z.ZodObject<{
     }> | undefined;
     continue?: string | boolean | undefined;
     toolbox?: string | undefined;
+    skills?: string | undefined;
     permissions?: {
         tool: string;
         action: "allow" | "reject" | "ask" | "delegate";

package/package.json

@@ -44,7 +44,7 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "0.1.0-20260119121704-g1d8d764",
+  "version": "0.1.0-20260119163454-ge1dfc84",
   "scripts": {
     "build": "bun run scripts/build.ts",
     "dev": "pnpm exec tsc -b --watch",