experimental-ash 0.25.2 → 0.27.0

package/dist/src/compiler/compile-agent.js

@@ -1,76 +1,3 @@
-import { hasDiscoverErrors, summarizeDiscoverDiagnostics } from "#discover/diagnostics.js";
-import { discoverAgent } from "#discover/discover-agent.js";
-import { resolveDiscoveryProject } from "#discover/project.js";
-import { createDiskProjectSource } from "#discover/project-source.js";
-import { writeCompilerArtifacts, } from "#compiler/artifacts.js";
-/**
- * Error raised when discovery artifacts were written but discovery still
- * contained errors.
- */
-export class CompileAgentError extends Error {
-    result;
-    constructor(result) {
-        super(formatCompileAgentErrorMessage({
-            diagnostics: result.diagnostics,
-            diagnosticsPath: result.paths.diagnosticsPath,
-        }));
-        this.name = "CompileAgentError";
-        this.result = result;
-    }
-}
-/**
- * Runs discovery, writes compiler-owned artifacts, and throws when discovery
- * produced errors.
- */
-export async function compileAgent(input = {}) {
-    const source = input.source ?? createDiskProjectSource();
-    const project = await resolveDiscoveryProject(input.startPath, { source });
-    const discoveryResult = await discoverAgent({ ...project, source });
-    const writtenArtifacts = await writeCompilerArtifacts({
-        appRoot: project.appRoot,
-        diagnostics: discoveryResult.diagnostics,
-        manifest: discoveryResult.manifest,
-    });
-    const result = {
-        diagnostics: discoveryResult.diagnostics,
-        manifest: writtenArtifacts.compiledManifest,
-        metadata: writtenArtifacts.metadata,
-        paths: writtenArtifacts.paths,
-        project,
-    };
-    if (hasDiscoverErrors(discoveryResult.diagnostics)) {
-        throw new CompileAgentError(result);
-    }
-    reportDiscoverWarnings(discoveryResult.diagnostics);
-    return result;
-}
-function reportDiscoverWarnings(diagnostics) {
-    const warnings = diagnostics.filter((diagnostic) => diagnostic.severity === "warning");
-    if (warnings.length === 0) {
-        return;
-    }
-    for (const warning of warnings) {
-        console.warn(`Warning [${warning.code}]: ${warning.message}\n  source: ${warning.sourcePath}`);
-    }
-}
-function formatCompileAgentErrorMessage(input) {
-    const summary = summarizeDiscoverDiagnostics(input.diagnostics);
-    const lines = [
-        `Discovery failed with ${summary.errors} error(s) and ${summary.warnings} warning(s).`,
-    ];
-    if (input.diagnosticsPath !== undefined) {
-        lines.push(`Diagnostics artifact: ${input.diagnosticsPath}`);
-    }
-    if (input.diagnostics.length === 0) {
-        return lines.join("\n");
-    }
-    lines.push("Discovery diagnostics:");
-    for (const diagnostic of input.diagnostics) {
-        lines.push(`- ${formatDiagnosticSeverity(diagnostic.severity)}: ${diagnostic.message}`);
-        lines.push(`  source: ${diagnostic.sourcePath}`);
-    }
-    return lines.join("\n");
-}
-function formatDiagnosticSeverity(severity) {
-    return severity === "error" ? "Error" : "Warning";
-}
+import{hasDiscoverErrors,summarizeDiscoverDiagnostics}from"#discover/diagnostics.js";import{discoverAgent}from"#discover/discover-agent.js";import{resolveDiscoveryProject}from"#discover/project.js";import{createDiskProjectSource}from"#discover/project-source.js";import{writeCompilerArtifacts}from"#compiler/artifacts.js";var CompileAgentError=class extends Error{result;constructor(e){super(formatCompileAgentErrorMessage({diagnostics:e.diagnostics,diagnosticsPath:e.paths.diagnosticsPath})),this.name=`CompileAgentError`,this.result=e}};async function compileAgent(t={}){let i=t.source??createDiskProjectSource(),a=await resolveDiscoveryProject(t.startPath,{source:i}),o=await discoverAgent({...a,source:i}),s=await writeCompilerArtifacts({appRoot:a.appRoot,diagnostics:o.diagnostics,manifest:o.manifest}),c={diagnostics:o.diagnostics,manifest:s.compiledManifest,metadata:s.metadata,paths:s.paths,project:a};if(hasDiscoverErrors(o.diagnostics))throw new CompileAgentError(c);return reportDiscoverWarnings(o.diagnostics),c}function reportDiscoverWarnings(e){let t=e.filter(e=>e.severity===`warning`);if(t.length!==0)for(let e of t)console.warn(`Warning [${e.code}]: ${e.message}\n  source: ${e.sourcePath}`)}function formatCompileAgentErrorMessage(e){let n=summarizeDiscoverDiagnostics(e.diagnostics),r=[`Discovery failed with ${n.errors} error(s) and ${n.warnings} warning(s).`];if(e.diagnosticsPath!==void 0&&r.push(`Diagnostics artifact: ${e.diagnosticsPath}`),e.diagnostics.length===0)return r.join(`
+`);r.push(`Discovery diagnostics:`);for(let t of e.diagnostics)r.push(`- ${formatDiagnosticSeverity(t.severity)}: ${t.message}`),r.push(`  source: ${t.sourcePath}`);return r.join(`
+`)}function formatDiagnosticSeverity(e){return e===`error`?`Error`:`Warning`}export{CompileAgentError,compileAgent};

package/dist/src/compiler/compile-from-memory.js

@@ -1,59 +1 @@
-import { createCompiledAgentManifest, ROOT_COMPILED_AGENT_NODE_ID, } from "#compiler/manifest.js";
-/**
- * Builds a compiled manifest and matching module map directly from an
- * in-memory descriptor, bypassing discovery and bundling entirely.
- *
- * Intended for integration tests that want to exercise runtime behaviour
- * without the cost of real compilation. Production code must continue to
- * use {@link compileAgent}.
- */
-export function compileFromMemory(input) {
-    const appRoot = input.appRoot ?? "/virtual/ash-memory-app";
-    const agentRoot = input.agentRoot ?? `${appRoot}/agent`;
-    const agentName = input.name ?? "memory-agent";
-    const config = {
-        metadata: {},
-        model: { id: input.model },
-        name: agentName,
-    };
-    const tools = (input.tools ?? []).map((toolInput) => ({
-        description: toolInput.description ?? `${toolInput.name} test tool.`,
-        inputSchema: toolInput.inputSchema ?? null,
-        logicalPath: `tools/${toolInput.name}.ts`,
-        name: toolInput.name,
-        sourceId: createMemorySourceId(`tools/${toolInput.name}.ts`),
-        sourceKind: "module",
-    }));
-    const skills = (input.skills ?? []).map((skillInput) => ({
-        description: skillInput.description,
-        logicalPath: `skills/${skillInput.name}.md`,
-        markdown: skillInput.markdown ?? `# ${skillInput.name}\n`,
-        name: skillInput.name,
-        sourceId: createMemorySourceId(`skills/${skillInput.name}.md`),
-        sourceKind: "markdown",
-    }));
-    const manifest = createCompiledAgentManifest({
-        agentRoot,
-        appRoot,
-        config,
-        skills,
-        tools,
-    });
-    const moduleMap = {
-        nodes: {
-            [ROOT_COMPILED_AGENT_NODE_ID]: {
-                modules: Object.fromEntries(tools.map((tool) => [tool.sourceId, Object.freeze({})])),
-            },
-        },
-    };
-    return {
-        manifest,
-        moduleMap,
-    };
-}
-function createMemorySourceId(logicalPath) {
-    // A deterministic, stable id per logical path. The runtime only requires
-    // these to be unique within the module map, so a prefix + the path is
-    // sufficient — no hashing needed.
-    return `memory::${logicalPath}`;
-}
+import{ROOT_COMPILED_AGENT_NODE_ID,createCompiledAgentManifest}from"#compiler/manifest.js";function compileFromMemory(t){let n=t.appRoot??`/virtual/ash-memory-app`,r=t.agentRoot??`${n}/agent`,i=t.name??`memory-agent`,a={metadata:{},model:{id:t.model},name:i},o=(t.tools??[]).map(e=>({description:e.description??`${e.name} test tool.`,inputSchema:e.inputSchema??null,logicalPath:`tools/${e.name}.ts`,name:e.name,sourceId:createMemorySourceId(`tools/${e.name}.ts`),sourceKind:`module`}));return{manifest:createCompiledAgentManifest({agentRoot:r,appRoot:n,config:a,skills:(t.skills??[]).map(e=>({description:e.description,logicalPath:`skills/${e.name}.md`,markdown:e.markdown??`# ${e.name}\n`,name:e.name,sourceId:createMemorySourceId(`skills/${e.name}.md`),sourceKind:`markdown`})),tools:o}),moduleMap:{nodes:{[ROOT_COMPILED_AGENT_NODE_ID]:{modules:Object.fromEntries(o.map(e=>[e.sourceId,Object.freeze({})]))}}}}}function createMemorySourceId(e){return`memory::${e}`}export{compileFromMemory};

package/dist/src/compiler/manifest.js

@@ -1,424 +1 @@
-import { z } from "#compiled/zod/index.js";
-import { discoverDiagnosticsSummarySchema, } from "#discover/diagnostics.js";
-import { compiledRemoteAgentNodeSchema, } from "#compiler/remote-agent-node.js";
-import { jsonObjectSchema } from "#shared/json-schemas.js";
-/**
- * Stable manifest kind emitted by the compiler for runtime loading.
- */
-export const COMPILED_AGENT_MANIFEST_KIND = "ash-agent-compiled-manifest";
-/**
- * Stable node id used by compiled artifacts for the root authored agent.
- */
-export const ROOT_COMPILED_AGENT_NODE_ID = "__root__";
-/**
- * Current compiled manifest schema version.
- */
-export const COMPILED_AGENT_MANIFEST_VERSION = 24;
-const moduleSourceRefSchema = z
-    .object({
-    exportName: z.string().optional(),
-    sourceKind: z.literal("module"),
-    logicalPath: z.string(),
-    sourceId: z.string(),
-})
-    .strict();
-const channelMethodSchema = z.union([
-    z.literal("GET"),
-    z.literal("POST"),
-    z.literal("PUT"),
-    z.literal("PATCH"),
-    z.literal("DELETE"),
-]);
-const compiledChannelDefinitionSchema = z
-    .object({
-    kind: z.literal("channel"),
-    name: z.string(),
-    logicalPath: z.string(),
-    method: channelMethodSchema,
-    urlPath: z.string(),
-    sourceId: z.string(),
-    sourceKind: z.literal("module"),
-    exportName: z.string().optional(),
-    adapterKind: z.string().optional(),
-})
-    .strict();
-const disabledCompiledChannelEntrySchema = z
-    .object({
-    kind: z.literal("disabled"),
-    name: z.string(),
-    logicalPath: z.string(),
-})
-    .strict();
-const compiledChannelEntrySchema = z.union([
-    compiledChannelDefinitionSchema,
-    disabledCompiledChannelEntrySchema,
-]);
-const compiledRuntimeModelReferenceSchema = z
-    .object({
-    contextWindowTokens: z.number().int().positive().optional(),
-    id: z.string(),
-    source: moduleSourceRefSchema.optional(),
-    providerOptions: z.record(z.string(), jsonObjectSchema).optional(),
-})
-    .strict();
-const compiledAgentBuildDefinitionSchema = z
-    .object({
-    externalDependencies: z.array(z.string()).optional(),
-})
-    .strict();
-const compiledAgentCompactionDefinitionSchema = z
-    .object({
-    model: compiledRuntimeModelReferenceSchema.optional(),
-    thresholdPercent: z.number().finite().min(0).max(1).optional(),
-})
-    .strict();
-const compiledAgentConfigSchema = z
-    .object({
-    build: compiledAgentBuildDefinitionSchema.optional(),
-    compaction: compiledAgentCompactionDefinitionSchema.optional(),
-    description: z.string().optional(),
-    metadata: z.record(z.string(), z.string()),
-    model: compiledRuntimeModelReferenceSchema,
-    name: z.string(),
-    source: moduleSourceRefSchema.optional(),
-})
-    .strict();
-const compiledInstructionsSchema = z
-    .object({
-    name: z.string(),
-    logicalPath: z.string(),
-    markdown: z.string(),
-    sourceId: z.string(),
-    sourceKind: z.union([z.literal("markdown"), z.literal("module")]),
-})
-    .strict();
-const compiledSkillBaseFields = {
-    name: z.string(),
-    description: z.string(),
-    license: z.string().optional(),
-    markdown: z.string(),
-    metadata: z.record(z.string(), z.string()).optional(),
-    sourceId: z.string(),
-    logicalPath: z.string(),
-};
-const compiledSkillSourceSchema = z.discriminatedUnion("sourceKind", [
-    z
-        .object({
-        ...compiledSkillBaseFields,
-        sourceKind: z.literal("markdown"),
-    })
-        .strict(),
-    z
-        .object({
-        ...compiledSkillBaseFields,
-        sourceKind: z.literal("module"),
-        exportName: z.string().optional(),
-    })
-        .strict(),
-    z
-        .object({
-        ...compiledSkillBaseFields,
-        sourceKind: z.literal("skill-package"),
-        skillId: z.string(),
-        skillFilePath: z.string(),
-        rootPath: z.string(),
-        assetsPath: z.string().optional(),
-        referencesPath: z.string().optional(),
-        scriptsPath: z.string().optional(),
-    })
-        .strict(),
-]);
-const compiledScheduleDefinitionSchema = z
-    .object({
-    cron: z.string(),
-    hasRun: z.boolean(),
-    name: z.string(),
-    logicalPath: z.string(),
-    markdown: z.string().optional(),
-    sourceId: z.string(),
-    sourceKind: z.union([z.literal("markdown"), z.literal("module")]),
-})
-    .strict();
-const compiledSandboxDefinitionSchema = z
-    .object({
-    description: z.string().optional(),
-    exportName: z.string().optional(),
-    logicalPath: z.string(),
-    sourceId: z.string(),
-    sourceKind: z.literal("module"),
-})
-    .strict();
-const compiledSandboxWorkspaceSchema = z
-    .object({
-    logicalPath: z.string(),
-    rootEntries: z.array(z.string()).readonly(),
-    sourceId: z.string(),
-    sourcePath: z.string(),
-})
-    .strict();
-const compiledWorkspaceResourceRootSchema = z
-    .object({
-    logicalPath: z.string(),
-    rootEntries: z.array(z.string()).readonly(),
-})
-    .strict();
-const compiledConnectionDefinitionSchema = z
-    .object({
-    connectionName: z.string(),
-    description: z.string(),
-    exportName: z.string().optional(),
-    logicalPath: z.string(),
-    sourceId: z.string(),
-    sourceKind: z.literal("module"),
-    url: z.string(),
-    /**
-     * Marker the compiler captures when the connection's `auth` is built
-     * by `connect()` from `@vercel/connect/ash`. The `connector` field
-     * carries whatever the author wrote — UID (`"oauth/mcp-linear-app"`)
-     * or opaque service-connector key (`"scl_..."`); both forms address
-     * the same connector on the Vercel Connect side.
-     */
-    vercelConnect: z
-        .object({
-        connector: z.string(),
-    })
-        .strict()
-        .optional(),
-})
-    .strict();
-const compiledToolDefinitionSchema = z
-    .object({
-    description: z.string(),
-    exportName: z.string().optional(),
-    inputSchema: jsonObjectSchema.nullable(),
-    logicalPath: z.string(),
-    name: z.string(),
-    sourceId: z.string(),
-    sourceKind: z.literal("module"),
-})
-    .strict();
-const compiledHookDefinitionSchema = z
-    .object({
-    exportName: z.string().optional(),
-    logicalPath: z.string(),
-    slug: z.string(),
-    sourceId: z.string(),
-    sourceKind: z.literal("module"),
-})
-    .strict();
-/**
- * Zod schema for one non-recursive compiled authored agent payload.
- */
-const compiledAgentNodeManifestSchema = z
-    .object({
-    agentRoot: z.string(),
-    appRoot: z.string(),
-    channels: z.array(compiledChannelEntrySchema),
-    config: compiledAgentConfigSchema,
-    connections: z.array(compiledConnectionDefinitionSchema),
-    diagnosticsSummary: discoverDiagnosticsSummarySchema,
-    disabledFrameworkTools: z.array(z.string()).readonly(),
-    hooks: z.array(compiledHookDefinitionSchema),
-    sandbox: compiledSandboxDefinitionSchema.nullable(),
-    sandboxWorkspaces: z.array(compiledSandboxWorkspaceSchema),
-    schedules: z.array(compiledScheduleDefinitionSchema),
-    remoteAgents: z.array(compiledRemoteAgentNodeSchema),
-    skills: z.array(compiledSkillSourceSchema).readonly(),
-    instructions: compiledInstructionsSchema.optional(),
-    tools: z.array(compiledToolDefinitionSchema),
-    workspaceResourceRoot: compiledWorkspaceResourceRootSchema,
-})
-    .strict();
-const compiledSubagentNodeSchema = z
-    .object({
-    agent: compiledAgentNodeManifestSchema,
-    description: z.string(),
-    entryPath: z.string(),
-    logicalPath: z.string(),
-    name: z.string(),
-    nodeId: z.string(),
-    rootPath: z.string(),
-    sourceId: z.string(),
-    sourceKind: z.literal("module"),
-    exportName: z.string().optional(),
-})
-    .strict();
-const compiledSubagentEdgeSchema = z
-    .object({
-    childNodeId: z.string(),
-    parentNodeId: z.string(),
-})
-    .strict();
-/**
- * Zod schema for the versioned compiled manifest emitted by the compiler.
- */
-export const compiledAgentManifestSchema = z
-    .object({
-    agentRoot: z.string(),
-    appRoot: z.string(),
-    channels: z.array(compiledChannelEntrySchema),
-    config: compiledAgentConfigSchema,
-    connections: z.array(compiledConnectionDefinitionSchema),
-    diagnosticsSummary: discoverDiagnosticsSummarySchema,
-    disabledFrameworkTools: z.array(z.string()).readonly(),
-    hooks: z.array(compiledHookDefinitionSchema),
-    kind: z.literal(COMPILED_AGENT_MANIFEST_KIND),
-    remoteAgents: z.array(compiledRemoteAgentNodeSchema),
-    sandbox: compiledSandboxDefinitionSchema.nullable(),
-    sandboxWorkspaces: z.array(compiledSandboxWorkspaceSchema),
-    schedules: z.array(compiledScheduleDefinitionSchema),
-    skills: z.array(compiledSkillSourceSchema).readonly(),
-    subagentEdges: z.array(compiledSubagentEdgeSchema),
-    subagents: z.array(compiledSubagentNodeSchema),
-    instructions: compiledInstructionsSchema.optional(),
-    tools: z.array(compiledToolDefinitionSchema),
-    version: z.literal(COMPILED_AGENT_MANIFEST_VERSION),
-    workspaceResourceRoot: compiledWorkspaceResourceRootSchema,
-})
-    .strict();
-/**
- * Creates a compiled authored agent payload with stable defaults.
- */
-export function createCompiledAgentNodeManifest(input) {
-    const node = {
-        agentRoot: input.agentRoot,
-        appRoot: input.appRoot,
-        channels: [...(input.channels ?? [])],
-        connections: [...(input.connections ?? [])],
-        config: {
-            build: input.config.build === undefined
-                ? undefined
-                : {
-                    externalDependencies: input.config.build.externalDependencies === undefined
-                        ? undefined
-                        : [...input.config.build.externalDependencies],
-                },
-            compaction: {
-                model: input.config.compaction?.model === undefined
-                    ? undefined
-                    : cloneCompiledRuntimeModelReference(input.config.compaction.model),
-                thresholdPercent: input.config.compaction?.thresholdPercent,
-            },
-            description: input.config.description,
-            metadata: {
-                ...input.config.metadata,
-            },
-            model: cloneCompiledRuntimeModelReference(input.config.model),
-            name: input.config.name,
-            source: input.config.source === undefined
-                ? undefined
-                : {
-                    ...input.config.source,
-                },
-        },
-        diagnosticsSummary: input.diagnosticsSummary ?? {
-            errors: 0,
-            warnings: 0,
-        },
-        disabledFrameworkTools: [...(input.disabledFrameworkTools ?? [])],
-        hooks: [...(input.hooks ?? [])],
-        remoteAgents: [...(input.remoteAgents ?? [])],
-        sandbox: input.sandbox ?? null,
-        sandboxWorkspaces: [...(input.sandboxWorkspaces ?? [])],
-        schedules: [...(input.schedules ?? [])],
-        skills: [...(input.skills ?? [])],
-        tools: [...(input.tools ?? [])],
-        workspaceResourceRoot: input.workspaceResourceRoot ?? {
-            logicalPath: "",
-            rootEntries: deriveResourceRootEntries({
-                sandboxWorkspaces: input.sandboxWorkspaces,
-                skills: input.skills,
-            }),
-        },
-    };
-    if (input.instructions !== undefined) {
-        node.instructions = input.instructions;
-    }
-    return node;
-}
-/**
- * Computes the sorted `rootEntries` advertised by the workspace resource
- * tree for one graph node.
- *
- * Shared by the synthetic manifest factory (used in tests and the
- * in-memory compile path) and by `materializeWorkspaceResources` so both
- * paths emit identical descriptors.
- */
-export function deriveResourceRootEntries(input) {
-    const rootEntries = new Set();
-    if ((input.skills ?? []).length > 0) {
-        rootEntries.add("skills/");
-    }
-    for (const workspace of input.sandboxWorkspaces ?? []) {
-        for (const entry of workspace.rootEntries) {
-            rootEntries.add(entry);
-        }
-    }
-    return [...rootEntries].sort((left, right) => left.localeCompare(right));
-}
-/**
- * Creates one stable compiled subagent node id from the parent node id and the
- * source entry discovered in that parent package.
- */
-export function createCompiledSubagentNodeId(parentNodeId, sourceId) {
-    if (parentNodeId === ROOT_COMPILED_AGENT_NODE_ID) {
-        return sourceId;
-    }
-    return `${parentNodeId}::${sourceId}`;
-}
-/**
- * Creates a compiled manifest with stable defaults.
- */
-export function createCompiledAgentManifest(input) {
-    return {
-        ...createCompiledAgentNodeManifest(input),
-        kind: COMPILED_AGENT_MANIFEST_KIND,
-        subagentEdges: [...(input.subagentEdges ?? [])],
-        subagents: [...(input.subagents ?? [])],
-        version: COMPILED_AGENT_MANIFEST_VERSION,
-    };
-}
-function cloneCompiledRuntimeModelReference(model) {
-    if (model.contextWindowTokens === undefined &&
-        model.source === undefined &&
-        model.providerOptions === undefined) {
-        return {
-            id: model.id,
-        };
-    }
-    if (model.source === undefined) {
-        if (model.providerOptions === undefined) {
-            return {
-                contextWindowTokens: model.contextWindowTokens,
-                id: model.id,
-            };
-        }
-        return {
-            contextWindowTokens: model.contextWindowTokens,
-            id: model.id,
-            providerOptions: {
-                ...model.providerOptions,
-            },
-        };
-    }
-    if (model.contextWindowTokens === undefined && model.providerOptions === undefined) {
-        return {
-            id: model.id,
-            source: {
-                ...model.source,
-            },
-        };
-    }
-    return {
-        contextWindowTokens: model.contextWindowTokens,
-        id: model.id,
-        providerOptions: model.providerOptions === undefined
-            ? undefined
-            : {
-                ...model.providerOptions,
-            },
-        source: {
-            ...model.source,
-        },
-    };
-}
+import{z}from"#compiled/zod/index.js";import{discoverDiagnosticsSummarySchema}from"#discover/diagnostics.js";import{compiledRemoteAgentNodeSchema}from"#compiler/remote-agent-node.js";import{jsonObjectSchema}from"#shared/json-schemas.js";var COMPILED_AGENT_MANIFEST_KIND=`ash-agent-compiled-manifest`,ROOT_COMPILED_AGENT_NODE_ID=`__root__`,COMPILED_AGENT_MANIFEST_VERSION=24,moduleSourceRefSchema=z.object({exportName:z.string().optional(),sourceKind:z.literal(`module`),logicalPath:z.string(),sourceId:z.string()}).strict(),channelMethodSchema=z.union([z.literal(`GET`),z.literal(`POST`),z.literal(`PUT`),z.literal(`PATCH`),z.literal(`DELETE`)]),compiledChannelDefinitionSchema=z.object({kind:z.literal(`channel`),name:z.string(),logicalPath:z.string(),method:channelMethodSchema,urlPath:z.string(),sourceId:z.string(),sourceKind:z.literal(`module`),exportName:z.string().optional(),adapterKind:z.string().optional()}).strict(),disabledCompiledChannelEntrySchema=z.object({kind:z.literal(`disabled`),name:z.string(),logicalPath:z.string()}).strict(),compiledChannelEntrySchema=z.union([compiledChannelDefinitionSchema,disabledCompiledChannelEntrySchema]),compiledRuntimeModelReferenceSchema=z.object({contextWindowTokens:z.number().int().positive().optional(),id:z.string(),source:moduleSourceRefSchema.optional(),providerOptions:z.record(z.string(),jsonObjectSchema).optional()}).strict(),compiledAgentBuildDefinitionSchema=z.object({externalDependencies:z.array(z.string()).optional()}).strict(),compiledAgentCompactionDefinitionSchema=z.object({model:compiledRuntimeModelReferenceSchema.optional(),thresholdPercent:z.number().finite().min(0).max(1).optional()}).strict(),compiledAgentConfigSchema=z.object({build:compiledAgentBuildDefinitionSchema.optional(),compaction:compiledAgentCompactionDefinitionSchema.optional(),description:z.string().optional(),metadata:z.record(z.string(),z.string()),model:compiledRuntimeModelReferenceSchema,name:z.string(),source:moduleSourceRefSchema.optional()}).strict(),compiledInstructionsSchema=z.object({name:z.string(),logicalPath:z.string(),markdown:z.string(),sourceId:z.string(),sourceKind:z.union([z.literal(`markdown`),z.literal(`module`)])}).strict(),compiledSkillBaseFields={name:z.string(),description:z.string(),license:z.string().optional(),markdown:z.string(),metadata:z.record(z.string(),z.string()).optional(),sourceId:z.string(),logicalPath:z.string()},compiledSkillSourceSchema=z.discriminatedUnion(`sourceKind`,[z.object({...compiledSkillBaseFields,sourceKind:z.literal(`markdown`)}).strict(),z.object({...compiledSkillBaseFields,sourceKind:z.literal(`module`),exportName:z.string().optional()}).strict(),z.object({...compiledSkillBaseFields,sourceKind:z.literal(`skill-package`),skillId:z.string(),skillFilePath:z.string(),rootPath:z.string(),assetsPath:z.string().optional(),referencesPath:z.string().optional(),scriptsPath:z.string().optional()}).strict()]),compiledScheduleDefinitionSchema=z.object({cron:z.string(),hasRun:z.boolean(),name:z.string(),logicalPath:z.string(),markdown:z.string().optional(),sourceId:z.string(),sourceKind:z.union([z.literal(`markdown`),z.literal(`module`)])}).strict(),compiledSandboxDefinitionSchema=z.object({description:z.string().optional(),exportName:z.string().optional(),logicalPath:z.string(),sourceId:z.string(),sourceKind:z.literal(`module`)}).strict(),compiledSandboxWorkspaceSchema=z.object({logicalPath:z.string(),rootEntries:z.array(z.string()).readonly(),sourceId:z.string(),sourcePath:z.string()}).strict(),compiledWorkspaceResourceRootSchema=z.object({logicalPath:z.string(),rootEntries:z.array(z.string()).readonly()}).strict(),compiledConnectionDefinitionSchema=z.object({connectionName:z.string(),description:z.string(),exportName:z.string().optional(),logicalPath:z.string(),sourceId:z.string(),sourceKind:z.literal(`module`),url:z.string(),vercelConnect:z.object({connector:z.string()}).strict().optional()}).strict(),compiledToolDefinitionSchema=z.object({description:z.string(),exportName:z.string().optional(),inputSchema:jsonObjectSchema.nullable(),logicalPath:z.string(),name:z.string(),sourceId:z.string(),sourceKind:z.literal(`module`)}).strict(),compiledHookDefinitionSchema=z.object({exportName:z.string().optional(),logicalPath:z.string(),slug:z.string(),sourceId:z.string(),sourceKind:z.literal(`module`)}).strict(),compiledAgentNodeManifestSchema=z.object({agentRoot:z.string(),appRoot:z.string(),channels:z.array(compiledChannelEntrySchema),config:compiledAgentConfigSchema,connections:z.array(compiledConnectionDefinitionSchema),diagnosticsSummary:discoverDiagnosticsSummarySchema,disabledFrameworkTools:z.array(z.string()).readonly(),hooks:z.array(compiledHookDefinitionSchema),sandbox:compiledSandboxDefinitionSchema.nullable(),sandboxWorkspaces:z.array(compiledSandboxWorkspaceSchema),schedules:z.array(compiledScheduleDefinitionSchema),remoteAgents:z.array(compiledRemoteAgentNodeSchema),skills:z.array(compiledSkillSourceSchema).readonly(),instructions:compiledInstructionsSchema.optional(),tools:z.array(compiledToolDefinitionSchema),workspaceResourceRoot:compiledWorkspaceResourceRootSchema}).strict(),compiledSubagentNodeSchema=z.object({agent:compiledAgentNodeManifestSchema,description:z.string(),entryPath:z.string(),logicalPath:z.string(),name:z.string(),nodeId:z.string(),rootPath:z.string(),sourceId:z.string(),sourceKind:z.literal(`module`),exportName:z.string().optional()}).strict(),compiledSubagentEdgeSchema=z.object({childNodeId:z.string(),parentNodeId:z.string()}).strict(),compiledAgentManifestSchema=z.object({agentRoot:z.string(),appRoot:z.string(),channels:z.array(compiledChannelEntrySchema),config:compiledAgentConfigSchema,connections:z.array(compiledConnectionDefinitionSchema),diagnosticsSummary:discoverDiagnosticsSummarySchema,disabledFrameworkTools:z.array(z.string()).readonly(),hooks:z.array(compiledHookDefinitionSchema),kind:z.literal(COMPILED_AGENT_MANIFEST_KIND),remoteAgents:z.array(compiledRemoteAgentNodeSchema),sandbox:compiledSandboxDefinitionSchema.nullable(),sandboxWorkspaces:z.array(compiledSandboxWorkspaceSchema),schedules:z.array(compiledScheduleDefinitionSchema),skills:z.array(compiledSkillSourceSchema).readonly(),subagentEdges:z.array(compiledSubagentEdgeSchema),subagents:z.array(compiledSubagentNodeSchema),instructions:compiledInstructionsSchema.optional(),tools:z.array(compiledToolDefinitionSchema),version:z.literal(24),workspaceResourceRoot:compiledWorkspaceResourceRootSchema}).strict();function createCompiledAgentNodeManifest(e){let t={agentRoot:e.agentRoot,appRoot:e.appRoot,channels:[...e.channels??[]],connections:[...e.connections??[]],config:{build:e.config.build===void 0?void 0:{externalDependencies:e.config.build.externalDependencies===void 0?void 0:[...e.config.build.externalDependencies]},compaction:{model:e.config.compaction?.model===void 0?void 0:cloneCompiledRuntimeModelReference(e.config.compaction.model),thresholdPercent:e.config.compaction?.thresholdPercent},description:e.config.description,metadata:{...e.config.metadata},model:cloneCompiledRuntimeModelReference(e.config.model),name:e.config.name,source:e.config.source===void 0?void 0:{...e.config.source}},diagnosticsSummary:e.diagnosticsSummary??{errors:0,warnings:0},disabledFrameworkTools:[...e.disabledFrameworkTools??[]],hooks:[...e.hooks??[]],remoteAgents:[...e.remoteAgents??[]],sandbox:e.sandbox??null,sandboxWorkspaces:[...e.sandboxWorkspaces??[]],schedules:[...e.schedules??[]],skills:[...e.skills??[]],tools:[...e.tools??[]],workspaceResourceRoot:e.workspaceResourceRoot??{logicalPath:``,rootEntries:deriveResourceRootEntries({sandboxWorkspaces:e.sandboxWorkspaces,skills:e.skills})}};return e.instructions!==void 0&&(t.instructions=e.instructions),t}function deriveResourceRootEntries(e){let t=new Set;(e.skills??[]).length>0&&t.add(`skills/`);for(let n of e.sandboxWorkspaces??[])for(let e of n.rootEntries)t.add(e);return[...t].sort((e,t)=>e.localeCompare(t))}function createCompiledSubagentNodeId(e,t){return e===`__root__`?t:`${e}::${t}`}function createCompiledAgentManifest(e){return{...createCompiledAgentNodeManifest(e),kind:COMPILED_AGENT_MANIFEST_KIND,subagentEdges:[...e.subagentEdges??[]],subagents:[...e.subagents??[]],version:24}}function cloneCompiledRuntimeModelReference(e){return e.contextWindowTokens===void 0&&e.source===void 0&&e.providerOptions===void 0?{id:e.id}:e.source===void 0?e.providerOptions===void 0?{contextWindowTokens:e.contextWindowTokens,id:e.id}:{contextWindowTokens:e.contextWindowTokens,id:e.id,providerOptions:{...e.providerOptions}}:e.contextWindowTokens===void 0&&e.providerOptions===void 0?{id:e.id,source:{...e.source}}:{contextWindowTokens:e.contextWindowTokens,id:e.id,providerOptions:e.providerOptions===void 0?void 0:{...e.providerOptions},source:{...e.source}}}export{COMPILED_AGENT_MANIFEST_KIND,COMPILED_AGENT_MANIFEST_VERSION,ROOT_COMPILED_AGENT_NODE_ID,compiledAgentManifestSchema,createCompiledAgentManifest,createCompiledAgentNodeManifest,createCompiledSubagentNodeId,deriveResourceRootEntries};