agent-bundle 0.1.0

package/dist/schema/bundle.js

@@ -0,0 +1,203 @@
+import { z } from "zod";
+const BUNDLE_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const GITHUB_REPO_PATTERN = /^[^\s/]+\/[^\s/]+$/;
+const PROMPT_VARIABLE_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+const modelProviderSchema = z.enum([
+    "anthropic",
+    "openai",
+    "gemini",
+    "ollama",
+    "openrouter",
+]);
+const ollamaModelSchema = z
+    .object({
+    baseUrl: z.string().url().optional(),
+    contextWindow: z.number().int().positive().optional(),
+    maxTokens: z.number().int().positive().optional(),
+})
+    .strict();
+const sandboxProviderSchema = z.enum(["e2b", "kubernetes"]);
+const promptVariableSchema = z
+    .string()
+    .min(1, "Prompt variable names cannot be empty.")
+    .regex(PROMPT_VARIABLE_PATTERN, "Prompt variable names must start with a letter or underscore and contain only letters, numbers, or underscores.");
+const resourcesSchema = z
+    .object({
+    cpu: z.number().positive(),
+    memory: z.string().min(1),
+})
+    .strict()
+    .default({
+    cpu: 2,
+    memory: "512MB",
+});
+const sandboxBuildSchema = z
+    .object({
+    dockerfile: z.string().min(1),
+    context: z.string().min(1).optional(),
+})
+    .strict();
+const sandboxSchema = z
+    .object({
+    provider: sandboxProviderSchema,
+    timeout: z.number().int().positive().default(900),
+    resources: resourcesSchema,
+    e2b: z
+        .object({
+        template: z.string().min(1).optional(),
+        build: sandboxBuildSchema.optional(),
+    })
+        .strict()
+        .optional(),
+    kubernetes: z
+        .object({
+        namespace: z.string().min(1).optional(),
+        kubeconfig: z.string().min(1).optional(),
+        nodeSelector: z.record(z.string(), z.string()).optional(),
+        registry: z.string().min(1).optional(),
+        image: z.string().min(1).optional(),
+        build: sandboxBuildSchema.optional(),
+    })
+        .strict()
+        .optional(),
+    serve: z
+        .object({
+        provider: sandboxProviderSchema,
+    })
+        .strict()
+        .optional(),
+})
+    .strict();
+const awsDeploySchema = z
+    .object({
+    region: z.string().min(1).default("us-east-1"),
+    cpu: z.string().default("256"),
+    memory: z.string().default("512"),
+    desiredCount: z.number().int().positive().default(1),
+    containerPort: z.number().int().positive().default(3000),
+})
+    .strict();
+const deploySchema = z
+    .object({
+    target: z.enum(["aws"]),
+    aws: awsDeploySchema.optional(),
+})
+    .strict();
+const localSkillSchema = z
+    .object({
+    path: z.string().min(1),
+})
+    .strict();
+const githubSkillSchema = z
+    .object({
+    github: z
+        .string()
+        .regex(GITHUB_REPO_PATTERN, "GitHub skill source must be in owner/repo format."),
+    skill: z.string().min(1).optional(),
+    ref: z.string().min(1).default("main"),
+})
+    .strict();
+const urlSkillSchema = z
+    .object({
+    url: z.string().url(),
+    version: z.string().min(1).optional(),
+})
+    .strict();
+const skillEntrySchema = z.union([localSkillSchema, githubSkillSchema, urlSkillSchema]);
+const localCommandSchema = z
+    .object({
+    path: z.string().min(1),
+})
+    .strict();
+const githubCommandSchema = z
+    .object({
+    github: z
+        .string()
+        .regex(GITHUB_REPO_PATTERN, "GitHub command source must be in owner/repo format."),
+    command: z.string().min(1).optional(),
+    ref: z.string().min(1).default("main"),
+})
+    .strict();
+const urlCommandSchema = z
+    .object({
+    url: z.string().url(),
+    version: z.string().min(1).optional(),
+})
+    .strict();
+const commandEntrySchema = z.union([localCommandSchema, githubCommandSchema, urlCommandSchema]);
+const mcpServerHttpSchema = z
+    .object({
+    transport: z.literal("http"),
+    name: z.string().min(1),
+    url: z.string().url(),
+    auth: z.enum(["bearer"]),
+})
+    .strict();
+const mcpServerStdioSchema = z
+    .object({
+    transport: z.literal("stdio"),
+    name: z.string().min(1),
+    command: z.string().min(1),
+    args: z.array(z.string()).optional(),
+    env: z.record(z.string(), z.string()).optional(),
+})
+    .strict();
+const mcpServerSseSchema = z
+    .object({
+    transport: z.literal("sse"),
+    name: z.string().min(1),
+    url: z.string().url(),
+    auth: z.enum(["bearer"]).optional(),
+})
+    .strict();
+const mcpServerSchema = z.discriminatedUnion("transport", [
+    mcpServerHttpSchema,
+    mcpServerStdioSchema,
+    mcpServerSseSchema,
+]);
+const mcpSchema = z
+    .object({
+    servers: z.array(mcpServerSchema).min(1),
+})
+    .strict();
+const pluginEntrySchema = z
+    .object({
+    marketplace: z
+        .string()
+        .regex(GITHUB_REPO_PATTERN, "Plugin marketplace source must be in owner/repo format."),
+    name: z.string().min(1),
+    ref: z.string().min(1).default("main"),
+    skills: z.array(z.string().min(1)).optional(),
+    commands: z.array(z.string().min(1)).optional(),
+})
+    .strict();
+export const bundleSchema = z
+    .object({
+    name: z
+        .string()
+        .regex(BUNDLE_NAME_PATTERN, "Bundle name must be kebab-case."),
+    model: z
+        .object({
+        provider: modelProviderSchema,
+        model: z.string().min(1),
+        ollama: ollamaModelSchema.optional(),
+    })
+        .strict(),
+    prompt: z
+        .object({
+        system: z.string().min(1),
+        variables: z.array(promptVariableSchema).default([]),
+    })
+        .strict(),
+    sandbox: sandboxSchema,
+    deploy: deploySchema.optional(),
+    skills: z.array(skillEntrySchema).min(1),
+    commands: z.array(commandEntrySchema).optional(),
+    mcp: mcpSchema.optional(),
+    plugins: z.array(pluginEntrySchema).min(1).optional(),
+})
+    .strict();
+export function parseBundleConfig(raw) {
+    return bundleSchema.parse(raw);
+}
+//# sourceMappingURL=bundle.js.map

package/dist/schema/bundle.js.map

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

package/dist/service/command-routes.d.ts

@@ -0,0 +1,8 @@
+import { Hono } from "hono";
+import type { Agent } from "../agent/types.js";
+import type { Command } from "../commands/types.js";
+export type CommandRegistry = {
+    commands: readonly Command[];
+};
+export declare function substituteArguments(content: string, args: string): string;
+export declare function createCommandRoutes(agent: Agent, registry: CommandRegistry): Hono;

package/dist/service/command-routes.js

@@ -0,0 +1,44 @@
+import { Hono } from "hono";
+import { findCommand, toCommandSummary } from "../commands/find.js";
+const ARGUMENTS_PLACEHOLDER = /\$ARGUMENTS/g;
+export function substituteArguments(content, args) {
+    return content.replace(ARGUMENTS_PLACEHOLDER, args);
+}
+export function createCommandRoutes(agent, registry) {
+    const routes = new Hono();
+    routes.get("/commands", (c) => {
+        const summaries = registry.commands.map(toCommandSummary);
+        return c.json(summaries);
+    });
+    routes.post("/commands/:name", async (c) => {
+        const name = c.req.param("name");
+        const command = findCommand(registry.commands, name);
+        if (!command) {
+            return c.json({ error: { message: `Command not found: ${name}` } }, 404);
+        }
+        let args = "";
+        const contentType = c.req.header("content-type") ?? "";
+        const hasBody = contentType.includes("application/json");
+        if (hasBody) {
+            try {
+                const body = await c.req.json();
+                args = typeof body.args === "string" ? body.args : "";
+            }
+            catch {
+                return c.json({ error: { message: "Invalid JSON in request body." } }, 400);
+            }
+        }
+        const userMessage = substituteArguments(command.content, args);
+        const input = [{ role: "user", content: userMessage }];
+        try {
+            const output = await agent.respond(input);
+            return c.json(output);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return c.json({ error: { message } }, 500);
+        }
+    });
+    return routes;
+}
+//# sourceMappingURL=command-routes.js.map

package/dist/service/command-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-routes.js","sourceRoot":"","sources":["../../src/service/command-routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAOpE,MAAM,qBAAqB,GAAG,cAAc,CAAC;AAE7C,MAAM,UAAU,mBAAmB,CAAC,OAAe,EAAE,IAAY;IAC/D,OAAO,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAY,EAAE,QAAyB;IACzE,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;IAE1B,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,EAAY,EAAE;QACtC,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC1D,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,EAAE,CAAC,EAAqB,EAAE;QAC5D,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,sBAAsB,IAAI,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3E,CAAC;QAED,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,MAAM,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QACvD,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;QACzD,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAqB,CAAC;gBACnD,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,+BAA+B,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;QAED,MAAM,WAAW,GAAG,mBAAmB,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAkB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;QAEtE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC1C,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/service/create-server.d.ts

@@ -0,0 +1,9 @@
+import { Hono } from "hono";
+import type { Agent } from "../agent/types.js";
+import type { Command } from "../commands/types.js";
+import type { ObservabilityProvider } from "../observability/types.js";
+export type CreateServerOptions = {
+    commands?: readonly Command[];
+    observability?: ObservabilityProvider;
+};
+export declare function createServer(agent: Agent, options?: CreateServerOptions): Hono;

package/dist/service/create-server.js

@@ -0,0 +1,113 @@
+import { Hono } from "hono";
+import { streamSSE } from "hono/streaming";
+import { z } from "zod";
+import { observabilityMiddleware } from "../observability/middleware.js";
+import { createCommandRoutes } from "./command-routes.js";
+function createErrorResponse(c, message, status) {
+    const payload = {
+        error: { message },
+    };
+    return c.json(payload, status);
+}
+const toolCallSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    input: z.record(z.string(), z.unknown()),
+});
+const toolResultSchema = z.object({
+    toolCallId: z.string(),
+    output: z.unknown(),
+    isError: z.boolean().optional(),
+});
+const responseInputMessageSchema = z.union([
+    z.object({
+        role: z.literal("system"),
+        content: z.string(),
+    }),
+    z.object({
+        role: z.literal("user"),
+        content: z.string(),
+    }),
+    z.object({
+        role: z.literal("assistant"),
+        content: z.string(),
+        tool_calls: z.array(toolCallSchema).optional(),
+    }),
+    z.object({
+        role: z.literal("tool"),
+        content: z.string(),
+        tool_results: z.array(toolResultSchema),
+    }),
+]);
+const responsesRequestSchema = z.object({
+    input: z.array(responseInputMessageSchema).min(1),
+    stream: z.boolean().optional(),
+});
+function parseResponsesRequest(body) {
+    const parsedRequest = responsesRequestSchema.safeParse(body);
+    if (!parsedRequest.success) {
+        return null;
+    }
+    return {
+        input: parsedRequest.data.input,
+        stream: parsedRequest.data.stream === true,
+    };
+}
+function createEventStreamResponse(c, agent, input) {
+    return streamSSE(c, async (stream) => {
+        try {
+            for await (const event of agent.respondStream(input)) {
+                await stream.writeSSE({ data: JSON.stringify(event) });
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            await stream.writeSSE({
+                data: JSON.stringify({
+                    type: "response.error",
+                    error: message,
+                }),
+            });
+        }
+    });
+}
+export function createServer(agent, options) {
+    const app = new Hono();
+    if (options?.observability) {
+        app.use("*", observabilityMiddleware(options.observability));
+    }
+    if (options?.commands && options.commands.length > 0) {
+        const registry = { commands: options.commands };
+        const commandRoutes = createCommandRoutes(agent, registry);
+        app.route("/", commandRoutes);
+    }
+    app.get("/health", (c) => {
+        return c.json({ status: "ok" });
+    });
+    app.post("/v1/responses", async (c) => {
+        let body;
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            return createErrorResponse(c, "Request body must be valid JSON.", 400);
+        }
+        const parsedRequest = parseResponsesRequest(body);
+        if (!parsedRequest) {
+            return createErrorResponse(c, "Invalid request body. Expected { input: ResponseInput, stream?: boolean }.", 400);
+        }
+        if (parsedRequest.stream) {
+            return createEventStreamResponse(c, agent, parsedRequest.input);
+        }
+        try {
+            const output = await agent.respond(parsedRequest.input);
+            return c.json(output);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return createErrorResponse(c, message, 500);
+        }
+    });
+    return app;
+}
+//# sourceMappingURL=create-server.js.map

package/dist/service/create-server.js.map

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

package/dist/service/index.d.ts

@@ -0,0 +1 @@
+export * from "./create-server.js";

package/dist/service/index.js

@@ -0,0 +1,2 @@
+export * from "./create-server.js";
+//# sourceMappingURL=index.js.map

package/dist/service/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/service/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/skills/index.d.ts

@@ -0,0 +1 @@
+export * from "./loader.js";

package/dist/skills/index.js

@@ -0,0 +1,2 @@
+export * from "./loader.js";
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/skills/loader.d.ts

@@ -0,0 +1,18 @@
+import type { SkillEntry } from "../schema/bundle.js";
+export type Skill = {
+    name: string;
+    description: string;
+    content: string;
+    sourcePath: string;
+};
+type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+export type LoadSkillOptions = {
+    basePath?: string;
+    cache?: boolean;
+    cacheDir?: string;
+    fetchImpl?: FetchLike;
+};
+export type LoadAllSkillsOptions = Omit<LoadSkillOptions, "basePath">;
+export declare function loadSkill(entry: SkillEntry, options?: LoadSkillOptions): Promise<Skill>;
+export declare function loadAllSkills(entries: SkillEntry[], basePath: string, options?: LoadAllSkillsOptions): Promise<Skill[]>;
+export {};

package/dist/skills/loader.js

@@ -0,0 +1,142 @@
+import { createHash } from "node:crypto";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { parse as parseYaml } from "yaml";
+const DEFAULT_CACHE_DIR = "node_modules/.cache/agent-bundle/skills";
+const FRONTMATTER_PATTERN = /^---\n([\s\S]*?)\n---\n?/;
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+function normalizeMarkdown(markdown) {
+    return markdown.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+}
+function parseFrontmatter(markdown) {
+    const normalized = normalizeMarkdown(markdown);
+    const match = normalized.match(FRONTMATTER_PATTERN);
+    if (!match) {
+        return { frontmatter: {}, content: normalized };
+    }
+    const parsed = parseYaml(match[1]);
+    return {
+        frontmatter: parsed && typeof parsed === "object" ? parsed : {},
+        content: normalized,
+    };
+}
+function getMetadataField(frontmatter, fieldName, sourcePath) {
+    const value = frontmatter[fieldName];
+    if (typeof value === "string" && value.trim().length > 0) {
+        return value.trim();
+    }
+    throw new Error(`Skill at ${sourcePath} must define a non-empty frontmatter field: ${fieldName}`);
+}
+function toLocalSkillFilePath(basePath, skillPath) {
+    const resolved = resolve(basePath, skillPath);
+    if (resolved.endsWith(".md")) {
+        return resolved;
+    }
+    return join(resolved, "SKILL.md");
+}
+function toGithubRawUrl(entry) {
+    const normalizedRef = encodeURIComponent(entry.ref);
+    const skillPath = entry.skill?.trim() ?? "";
+    const withSkillFile = skillPath.length === 0
+        ? "SKILL.md"
+        : skillPath.endsWith(".md")
+            ? skillPath
+            : `${skillPath}/SKILL.md`;
+    const encodedPath = withSkillFile
+        .split("/")
+        .filter((segment) => segment.length > 0)
+        .map((segment) => encodeURIComponent(segment))
+        .join("/");
+    return `https://raw.githubusercontent.com/${entry.github}/${normalizedRef}/${encodedPath}`;
+}
+function toUrlSkillMarkdownUrl(rawUrl) {
+    const parsed = new URL(rawUrl);
+    if (!parsed.pathname.endsWith(".md")) {
+        const trimmedPath = parsed.pathname.endsWith("/")
+            ? parsed.pathname.slice(0, -1)
+            : parsed.pathname;
+        parsed.pathname = `${trimmedPath}/SKILL.md`;
+    }
+    return parsed.toString();
+}
+function createCachePath(url, cacheDir) {
+    const hash = createHash("sha256").update(url).digest("hex");
+    return join(cacheDir, hash);
+}
+async function readCachedContent(cachePath) {
+    try {
+        return await readFile(cachePath, "utf8");
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return null;
+        }
+        throw error;
+    }
+}
+async function fetchRemoteSkillContent(url, options) {
+    const shouldUseCache = options.cache ?? true;
+    const cacheDir = options.cacheDir ?? DEFAULT_CACHE_DIR;
+    const cachePath = createCachePath(url, cacheDir);
+    if (shouldUseCache) {
+        const cachedContent = await readCachedContent(cachePath);
+        if (cachedContent !== null) {
+            return cachedContent;
+        }
+    }
+    const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+    const response = await fetchImpl(url);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch skill from ${url}: ${response.status} ${response.statusText}`.trim());
+    }
+    const content = await response.text();
+    if (shouldUseCache) {
+        await mkdir(dirname(cachePath), { recursive: true });
+        await writeFile(cachePath, content, "utf8");
+    }
+    return content;
+}
+function toSkill(markdown, sourcePath) {
+    const parsed = parseFrontmatter(markdown);
+    return {
+        name: getMetadataField(parsed.frontmatter, "name", sourcePath),
+        description: getMetadataField(parsed.frontmatter, "description", sourcePath),
+        content: parsed.content,
+        sourcePath,
+    };
+}
+async function loadLocalSkill(entry, options) {
+    if (!options.basePath) {
+        throw new Error("basePath is required to load local skills.");
+    }
+    const filePath = toLocalSkillFilePath(options.basePath, entry.path);
+    const content = await readFile(filePath, "utf8");
+    return toSkill(content, filePath);
+}
+async function loadGithubSkill(entry, options) {
+    const sourceUrl = toGithubRawUrl(entry);
+    const content = await fetchRemoteSkillContent(sourceUrl, options);
+    return toSkill(content, sourceUrl);
+}
+async function loadUrlSkill(entry, options) {
+    const sourceUrl = toUrlSkillMarkdownUrl(entry.url);
+    const content = await fetchRemoteSkillContent(sourceUrl, options);
+    return toSkill(content, sourceUrl);
+}
+export async function loadSkill(entry, options = {}) {
+    if ("path" in entry) {
+        return await loadLocalSkill(entry, options);
+    }
+    if ("github" in entry) {
+        return await loadGithubSkill(entry, options);
+    }
+    return await loadUrlSkill(entry, options);
+}
+export async function loadAllSkills(entries, basePath, options = {}) {
+    return await Promise.all(entries.map(async (entry) => {
+        return await loadSkill(entry, { ...options, basePath });
+    }));
+}
+//# sourceMappingURL=loader.js.map

package/dist/skills/loader.js.map

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

package/dist/skills/summaries.d.ts

@@ -0,0 +1,8 @@
+import type { SkillSummary } from "../agent-loop/system-prompt/generate.js";
+export type SkillSummarySource = {
+    name: string;
+    description: string;
+    sourcePath: string;
+    content?: string;
+};
+export declare function toSkillSummaries(skills: readonly SkillSummarySource[]): SkillSummary[];

package/dist/skills/summaries.js

@@ -0,0 +1,9 @@
+export function toSkillSummaries(skills) {
+    return skills.map((skill) => ({
+        name: skill.name,
+        description: skill.description,
+        sourcePath: skill.sourcePath,
+        content: skill.content,
+    }));
+}
+//# sourceMappingURL=summaries.js.map

package/dist/skills/summaries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summaries.js","sourceRoot":"","sources":["../../src/skills/summaries.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,gBAAgB,CAAC,MAAqC;IACpE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/test-helpers/env.d.ts

@@ -0,0 +1,2 @@
+export type EnvRestore = () => void;
+export declare function withTemporaryEnv(updates: Record<string, string | undefined>): EnvRestore;

package/dist/test-helpers/env.js

@@ -0,0 +1,20 @@
+export function withTemporaryEnv(updates) {
+    const previousValues = Object.fromEntries(Object.keys(updates).map((key) => [key, process.env[key]]));
+    Object.entries(updates).forEach(([key, value]) => {
+        if (value === undefined) {
+            delete process.env[key];
+            return;
+        }
+        process.env[key] = value;
+    });
+    return () => {
+        Object.entries(previousValues).forEach(([key, value]) => {
+            if (value === undefined) {
+                delete process.env[key];
+                return;
+            }
+            process.env[key] = value;
+        });
+    };
+}
+//# sourceMappingURL=env.js.map

package/dist/test-helpers/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/test-helpers/env.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAAC,OAA2C;IAC1E,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,CACvC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAC3D,CAAC;IAEF,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAC/C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACxB,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,EAAE;QACV,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YACtD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACxB,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}