@yansirplus/cli 0.5.17 → 0.5.19

package/dist/build/agent-authoring/config.d.ts

@@ -1,7 +1,7 @@
 import type { AgentManifest, ProviderResourceId, WorkspaceBindingRef, WorkspaceTopology } from "@yansirplus/core/runtime-protocol";
 import { type DeploymentSpec, type HandlerKind } from "@yansirplus/core/runtime-protocol";
 import { type WorkspaceToolName } from "@yansirplus/runtime";
-import type { AgentManifestFactKey, AgentManifestOrigin, AuthoredAgentManifest, CompiledAgentManifest } from "./manifest-compiler.js";
+import type { AgentManifestFactKey, AgentManifestOrigin, AuthoredAgentManifest, CompiledAgentChannel, CompiledAgentSchedule, CompiledAgentSkill, CompiledAgentWorkflow, CompiledAgentManifest } from "./manifest-compiler.js";
 export declare const AGENTOS_CONFIG_PROFILE: {
     readonly WORKSPACE_V1: "workspace@1";
     readonly CHAT_V1: "chat@1";
@@ -9,6 +9,7 @@ export declare const AGENTOS_CONFIG_PROFILE: {
 export type AgentOsConfigProfile = (typeof AGENTOS_CONFIG_PROFILE)[keyof typeof AGENTOS_CONFIG_PROFILE];
 export declare const AGENTOS_CONFIG_TARGET: {
     readonly CLOUDFLARE_DO_V1: "cloudflare-do@1";
+    readonly NODE_V1: "node@1";
 };
 export type AgentOsConfigTargetKind = (typeof AGENTOS_CONFIG_TARGET)[keyof typeof AGENTOS_CONFIG_TARGET];
 export declare const AGENTOS_CONFIG_CLIENT: {
@@ -31,16 +32,22 @@ export interface AgentOsConfigCloudflareDoTarget {
         readonly binding: string;
     };
 }
-export type AgentOsConfigTarget = AgentOsConfigCloudflareDoTarget;
+export interface AgentOsConfigNodeTarget {
+    readonly kind: typeof AGENTOS_CONFIG_TARGET.NODE_V1;
+}
+export type AgentOsConfigTarget = AgentOsConfigCloudflareDoTarget | AgentOsConfigNodeTarget;
 export interface AgentOsConfigClient {
     readonly kind: AgentOsConfigClientKind;
 }
-export interface AgentOsConfigLlm {
+export interface AgentOsConfigLlmRouteBinding {
     readonly route: AgentOsConfigLlmRoute;
     readonly endpointRef: string;
     readonly credentialRef: string;
     readonly modelRef: string;
 }
+export interface AgentOsConfigLlm extends AgentOsConfigLlmRouteBinding {
+    readonly routes?: Readonly<Record<string, AgentOsConfigLlmRouteBinding>>;
+}
 export type AgentOsConfigWorkspaceTopology = WorkspaceTopology;
 export interface AgentOsConfigWorkspace {
     readonly binding: string;
@@ -130,9 +137,16 @@ export interface NormalizedAgentOsConfigBase<M extends AgentManifest = AgentMani
     readonly deployment: DeploymentSpec<M>;
     readonly deploymentVersion?: string;
     readonly authoredToolNames: ReadonlyArray<string>;
+    readonly channels: ReadonlyArray<CompiledAgentChannel>;
+    readonly workflows: ReadonlyArray<CompiledAgentWorkflow>;
+    readonly schedules: ReadonlyArray<CompiledAgentSchedule>;
+    readonly skills: ReadonlyArray<CompiledAgentSkill>;
+    readonly instructionFragments: CompiledAgentManifest["instructionFragments"];
+    readonly dynamicResolvers: CompiledAgentManifest["dynamicResolvers"];
     readonly target: AgentOsConfigTarget;
     readonly client: AgentOsConfigClient;
-    readonly llm: AgentOsConfigLlm;
+    readonly llm: AgentOsConfigLlmRouteBinding;
+    readonly llmRoutes: Readonly<Record<string, AgentOsConfigLlmRouteBinding>>;
     readonly origins: Readonly<Record<AgentOsConfigFactKey, AgentOsConfigOrigin>>;
     readonly provenance: StaticTargetProvenance;
 }
@@ -172,6 +186,7 @@ export declare const llmMaterialEnvBindingsForRefs: (refs: ReadonlyArray<{
 export declare const llmMaterialEnvNameCollisionIssues: (bindings: ReadonlyArray<LlmMaterialEnvBinding>) => ReadonlyArray<Extract<AgentOsConfigIssue, {
     readonly kind: "llm_material_env_name_collision";
 }>>;
-export declare const llmMaterialEnvBindings: (llm: AgentOsConfigLlm) => ReadonlyArray<LlmMaterialEnvBinding>;
+export declare const llmMaterialEnvBindings: (llm: AgentOsConfigLlmRouteBinding) => ReadonlyArray<LlmMaterialEnvBinding>;
+export declare const llmMaterialEnvBindingsForRoutes: (routes: Readonly<Record<string, AgentOsConfigLlmRouteBinding>>) => ReadonlyArray<LlmMaterialEnvBinding>;
 export declare const decodeAgentOsConfig: (value: unknown) => DecodeAgentOsConfigResult;
 export declare const normalizeAgentOsConfig: <K extends HandlerKind = HandlerKind>(config: AgentOsConfigV1, compiled: CompiledAgentManifest<K>) => NormalizeAgentOsConfigResult<AuthoredAgentManifest<K>>;

package/dist/build/agent-authoring/config.js

@@ -1,6 +1,6 @@
 import { authoredValue } from "@yansirplus/core/authored-value";
 import { WORKSPACE_TOPOLOGY, manifestScopeRefResult, workspaceBindingRef, workspaceProviderResourceId, } from "@yansirplus/core/runtime-protocol";
-import { WORKSPACE_TOOL_DEFAULT_DECLARATIONS, } from "@yansirplus/runtime";
+import { WORKSPACE_OP_FACT_OWNER, WORKSPACE_TOOL_DEFAULT_DECLARATIONS, } from "@yansirplus/runtime";
 import { digestHex64, isNonEmptyString, isRecord } from "./shared.js";
 import { workspaceManifestMacroOrigin } from "./manifest-compiler.js";
 export const AGENTOS_CONFIG_PROFILE = {
@@ -9,6 +9,7 @@ export const AGENTOS_CONFIG_PROFILE = {
 };
 export const AGENTOS_CONFIG_TARGET = {
     CLOUDFLARE_DO_V1: "cloudflare-do@1",
+    NODE_V1: "node@1",
 };
 export const AGENTOS_CONFIG_CLIENT = {
     SVELTE_KIT_REMOTE_V1: "svelte-kit-remote@1",
@@ -20,6 +21,17 @@ export const AGENTOS_CONFIG_LLM_ROUTE = {
 const configAuthorOrigin = (factKey) => `author:agentos.config.jsonc#${factKey}`;
 const workspaceMacroOrigin = (factKey) => `macro(${AGENTOS_CONFIG_PROFILE.WORKSPACE_V1})#${factKey}`;
 const chatMacroOrigin = (factKey) => `macro(${AGENTOS_CONFIG_PROFILE.CHAT_V1})#${factKey}`;
+const targetOriginFacts = (target) => ({
+    "/target/kind": configAuthorOrigin("/target/kind"),
+    ...(target.kind === AGENTOS_CONFIG_TARGET.CLOUDFLARE_DO_V1
+        ? {
+            "/target/durableObject/className": configAuthorOrigin("/target/durableObject/className"),
+            "/target/durableObject/binding": configAuthorOrigin("/target/durableObject/binding"),
+        }
+        : {}),
+});
+const targetDeploymentBackend = (target) => target.kind === AGENTOS_CONFIG_TARGET.NODE_V1 ? "node" : "cloudflare-do";
+const targetDeploymentAdapter = (target) => target.kind;
 const materialEnvPrefix = (kind) => kind === "endpoint"
     ? "AGENTOS_ENDPOINT"
     : kind === "credential"
@@ -56,6 +68,7 @@ export const llmMaterialEnvBindings = (llm) => llmMaterialEnvBindingsForRefs([
     { kind: "credential", ref: llm.credentialRef },
     { kind: "model", ref: llm.modelRef },
 ]);
+export const llmMaterialEnvBindingsForRoutes = (routes) => Object.values(routes).flatMap((route) => llmMaterialEnvBindings(route));
 const configAllowedFields = new Set([
     "$schema",
     "profile",
@@ -67,10 +80,12 @@ const configAllowedFields = new Set([
     "workspace",
 ]);
 const deploymentAllowedFields = new Set(["id", "version"]);
-const targetAllowedFields = new Set(["kind", "durableObject"]);
+const nodeTargetAllowedFields = new Set(["kind"]);
+const cloudflareTargetAllowedFields = new Set(["kind", "durableObject"]);
 const durableObjectAllowedFields = new Set(["className", "binding"]);
 const clientAllowedFields = new Set(["kind"]);
-const llmAllowedFields = new Set(["route", "endpointRef", "credentialRef", "modelRef"]);
+const llmAllowedFields = new Set(["route", "endpointRef", "credentialRef", "modelRef", "routes"]);
+const llmRouteAllowedFields = new Set(["route", "endpointRef", "credentialRef", "modelRef"]);
 const workspaceAllowedFields = new Set(["binding", "root", "topology"]);
 const topologyAllowedFields = new Set(["kind", "allocator"]);
 const configRuntimeFactFields = new Set([
@@ -150,11 +165,16 @@ const decodeTargetConfig = (issues, value) => {
     const record = configRequiredRecord(issues, "agentos.config.jsonc", "/target", value);
     if (record === null)
         return null;
-    assertConfigAllowedFields(issues, "/target", record, targetAllowedFields);
+    if (record.kind === AGENTOS_CONFIG_TARGET.NODE_V1) {
+        assertConfigAllowedFields(issues, "/target", record, nodeTargetAllowedFields);
+        return { kind: AGENTOS_CONFIG_TARGET.NODE_V1 };
+    }
     if (record.kind !== AGENTOS_CONFIG_TARGET.CLOUDFLARE_DO_V1) {
+        assertConfigAllowedFields(issues, "/target", record, nodeTargetAllowedFields);
         issueInvalidConfigValue(issues, "/target", "/target/kind", "target_kind_invalid");
         return null;
     }
+    assertConfigAllowedFields(issues, "/target", record, cloudflareTargetAllowedFields);
     const durableObject = configRequiredRecord(issues, "/target", "/target/durableObject", record.durableObject);
     if (durableObject === null)
         return null;
@@ -180,18 +200,20 @@ const decodeClientConfig = (issues, value) => {
     }
     return { kind: record.kind };
 };
-const decodeLlmConfig = (issues, value) => {
-    const record = configRequiredRecord(issues, "agentos.config.jsonc", "/llm", value);
+const decodeLlmRouteConfig = (issues, path, value, options = {}) => {
+    const record = configRequiredRecord(issues, "agentos.config.jsonc", path, value);
     if (record === null)
         return null;
-    assertConfigAllowedFields(issues, "/llm", record, llmAllowedFields);
+    if (options.checkAllowedFields !== false) {
+        assertConfigAllowedFields(issues, path, record, llmRouteAllowedFields);
+    }
     if (record.route !== AGENTOS_CONFIG_LLM_ROUTE.OPENAI_CHAT_COMPATIBLE) {
-        issueInvalidConfigValue(issues, "/llm", "/llm/route", "llm_route_invalid");
+        issueInvalidConfigValue(issues, path, `${path}/route`, "llm_route_invalid");
         return null;
     }
-    const endpointRef = configStringField(issues, "/llm", "/llm/endpointRef", record.endpointRef);
-    const credentialRef = configStringField(issues, "/llm", "/llm/credentialRef", record.credentialRef);
-    const modelRef = configStringField(issues, "/llm", "/llm/modelRef", record.modelRef);
+    const endpointRef = configStringField(issues, path, `${path}/endpointRef`, record.endpointRef);
+    const credentialRef = configStringField(issues, path, `${path}/credentialRef`, record.credentialRef);
+    const modelRef = configStringField(issues, path, `${path}/modelRef`, record.modelRef);
     return endpointRef === null || credentialRef === null || modelRef === null
         ? null
         : {
@@ -201,6 +223,46 @@ const decodeLlmConfig = (issues, value) => {
             modelRef,
         };
 };
+const routeBindingRefPattern = /^[A-Za-z0-9._:-]+$/u;
+const decodeLlmRoutesConfig = (issues, value) => {
+    if (value === undefined)
+        return undefined;
+    const record = configRequiredRecord(issues, "/llm", "/llm/routes", value);
+    if (record === null)
+        return undefined;
+    const routes = {};
+    for (const [bindingRef, routeValue] of Object.entries(record).sort(([left], [right]) => left.localeCompare(right))) {
+        const routePath = `/llm/routes/${bindingRef}`;
+        if (bindingRef === "default") {
+            issueInvalidConfigValue(issues, routePath, routePath, "llm_default_route_duplicate");
+            continue;
+        }
+        if (!routeBindingRefPattern.test(bindingRef)) {
+            issueInvalidConfigValue(issues, routePath, routePath, "llm_route_binding_ref_invalid");
+            continue;
+        }
+        const route = decodeLlmRouteConfig(issues, routePath, routeValue);
+        if (route !== null)
+            routes[bindingRef] = route;
+    }
+    return routes;
+};
+const decodeLlmConfig = (issues, value) => {
+    const record = configRequiredRecord(issues, "agentos.config.jsonc", "/llm", value);
+    if (record === null)
+        return null;
+    assertConfigAllowedFields(issues, "/llm", record, llmAllowedFields);
+    const defaultRoute = decodeLlmRouteConfig(issues, "/llm", record, {
+        checkAllowedFields: false,
+    });
+    const routes = decodeLlmRoutesConfig(issues, record.routes);
+    return defaultRoute === null
+        ? null
+        : {
+            ...defaultRoute,
+            ...(routes === undefined ? {} : { routes }),
+        };
+};
 const decodeWorkspaceTopologyConfig = (issues, value) => {
     const record = configRequiredRecord(issues, "/workspace", "/workspace/topology", value);
     if (record === null)
@@ -298,6 +360,7 @@ const workspaceMaterialRef = (providerResourceId) => ({
 const workspaceDefaultToolFactKey = (toolId, field) => `/tools/${toolId}/${field}`;
 const workspaceExecutionDomainFactKey = "/executionDomains/workspace/bindingRef";
 const workspaceMaterialFactKey = "/materials/workspace";
+const workspaceCapabilityFactKey = "/capabilities/workspaceOperations/bindingRef";
 const defaultWorkspaceToolEntry = (tool, control) => ({
     bindingRef: tool.name,
     executionDomain: tool.executionDomain,
@@ -324,6 +387,9 @@ const addDefaultWorkspaceToolProvenance = (provenance, tool, control) => {
 const applyWorkspaceDefaultTools = (compiled) => {
     const issues = [];
     const tools = { ...compiled.manifest.tools };
+    const capabilities = {
+        ...compiled.manifest.capabilities,
+    };
     const executionDomains = {
         ...compiled.manifest.executionDomains,
     };
@@ -335,6 +401,10 @@ const applyWorkspaceDefaultTools = (compiled) => {
         executionDomains.workspace = { bindingRef: "workspace" };
         provenance[workspaceExecutionDomainFactKey] = workspaceManifestMacroOrigin(workspaceExecutionDomainFactKey);
     }
+    if (capabilities.workspaceOperations === undefined) {
+        capabilities.workspaceOperations = { bindingRef: WORKSPACE_OP_FACT_OWNER };
+        provenance[workspaceCapabilityFactKey] = workspaceManifestMacroOrigin(workspaceCapabilityFactKey);
+    }
     for (const defaultTool of WORKSPACE_TOOL_DEFAULT_DECLARATIONS) {
         const control = compiled.workspaceToolControls[defaultTool.name];
         const existing = compiled.manifest.tools?.[defaultTool.name];
@@ -355,12 +425,15 @@ const applyWorkspaceDefaultTools = (compiled) => {
     }
     const manifestWithoutTools = { ...compiled.manifest };
     delete manifestWithoutTools.tools;
+    delete manifestWithoutTools.capabilities;
     delete manifestWithoutTools.executionDomains;
     const sortedTools = Object.fromEntries(Object.entries(tools).sort(([left], [right]) => left.localeCompare(right)));
+    const sortedCapabilities = Object.fromEntries(Object.entries(capabilities).sort(([left], [right]) => left.localeCompare(right)));
     const sortedExecutionDomains = Object.fromEntries(Object.entries(executionDomains).sort(([left], [right]) => left.localeCompare(right)));
     return {
         manifest: authoredValue({
             ...manifestWithoutTools,
+            ...(Object.keys(sortedCapabilities).length === 0 ? {} : { capabilities: sortedCapabilities }),
             ...(Object.keys(sortedTools).length === 0 ? {} : { tools: sortedTools }),
             ...(Object.keys(sortedExecutionDomains).length === 0
                 ? {}
@@ -431,12 +504,35 @@ const cloudflareWorkspaceSandboxId = (input) => {
     const shortenedPrefix = prefix.slice(0, prefixBudget).replace(/-+$/g, "") || "agentos-sandbox";
     return `${shortenedPrefix}${suffix}`;
 };
+const defaultLlmRoute = (llm) => ({
+    route: llm.route,
+    endpointRef: llm.endpointRef,
+    credentialRef: llm.credentialRef,
+    modelRef: llm.modelRef,
+});
+const normalizedLlmRoutes = (llm) => ({
+    default: defaultLlmRoute(llm),
+    ...(llm.routes ?? {}),
+});
+const addLlmRouteOrigins = (origins, llm) => {
+    origins["/llm/route"] = configAuthorOrigin("/llm/route");
+    origins["/llm/endpointRef"] = configAuthorOrigin("/llm/endpointRef");
+    origins["/llm/credentialRef"] = configAuthorOrigin("/llm/credentialRef");
+    origins["/llm/modelRef"] = configAuthorOrigin("/llm/modelRef");
+    for (const routeBindingRef of Object.keys(llm.routes ?? {}).sort()) {
+        origins[`/llm/routes/${routeBindingRef}/route`] = configAuthorOrigin(`/llm/routes/${routeBindingRef}/route`);
+        origins[`/llm/routes/${routeBindingRef}/endpointRef`] = configAuthorOrigin(`/llm/routes/${routeBindingRef}/endpointRef`);
+        origins[`/llm/routes/${routeBindingRef}/credentialRef`] = configAuthorOrigin(`/llm/routes/${routeBindingRef}/credentialRef`);
+        origins[`/llm/routes/${routeBindingRef}/modelRef`] = configAuthorOrigin(`/llm/routes/${routeBindingRef}/modelRef`);
+    }
+};
 export const normalizeAgentOsConfig = (config, compiled) => {
     const decoded = decodeAgentOsConfig(config);
     if (!decoded.ok)
         return decoded;
     const value = decoded.value;
-    const llmEnvIssues = llmMaterialEnvNameCollisionIssues(llmMaterialEnvBindings(value.llm));
+    const llmRoutes = normalizedLlmRoutes(value.llm);
+    const llmEnvIssues = llmMaterialEnvNameCollisionIssues(llmMaterialEnvBindingsForRoutes(llmRoutes));
     if (llmEnvIssues.length > 0) {
         return { ok: false, issues: llmEnvIssues };
     }
@@ -476,19 +572,14 @@ export const normalizeAgentOsConfig = (config, compiled) => {
             ...(value.deployment.version === undefined
                 ? {}
                 : { "/deployment/version": configAuthorOrigin("/deployment/version") }),
-            "/target/kind": configAuthorOrigin("/target/kind"),
-            "/target/durableObject/className": configAuthorOrigin("/target/durableObject/className"),
-            "/target/durableObject/binding": configAuthorOrigin("/target/durableObject/binding"),
+            ...targetOriginFacts(value.target),
             "/client/kind": configAuthorOrigin("/client/kind"),
-            "/llm/route": configAuthorOrigin("/llm/route"),
-            "/llm/endpointRef": configAuthorOrigin("/llm/endpointRef"),
-            "/llm/credentialRef": configAuthorOrigin("/llm/credentialRef"),
-            "/llm/modelRef": configAuthorOrigin("/llm/modelRef"),
             "/deployment/backend": `derived:/target/kind`,
             "/deployment/adapter": `derived:/target/kind`,
             "/deployment/codec": chatMacroOrigin("/deployment/codec"),
             "/deployment/providerStrategy": `derived:/llm/route`,
         };
+        addLlmRouteOrigins(origins, value.llm);
         return {
             ok: true,
             value: {
@@ -497,8 +588,8 @@ export const normalizeAgentOsConfig = (config, compiled) => {
                 deployment: {
                     deploymentId: value.deployment.id,
                     manifest: profileManifest.manifest,
-                    backend: "cloudflare-do",
-                    adapter: AGENTOS_CONFIG_TARGET.CLOUDFLARE_DO_V1,
+                    backend: targetDeploymentBackend(value.target),
+                    adapter: targetDeploymentAdapter(value.target),
                     codec: "agentos-json@1",
                     providerStrategy: value.llm.route,
                 },
@@ -506,9 +597,16 @@ export const normalizeAgentOsConfig = (config, compiled) => {
                     ? {}
                     : { deploymentVersion: value.deployment.version }),
                 authoredToolNames: Object.keys(compiled.toolFilePaths).sort(),
+                channels: compiled.channels,
+                workflows: compiled.workflows,
+                schedules: compiled.schedules,
+                skills: compiled.skills,
+                instructionFragments: compiled.instructionFragments,
+                dynamicResolvers: compiled.dynamicResolvers,
                 target: value.target,
                 client: value.client,
-                llm: value.llm,
+                llm: llmRoutes.default,
+                llmRoutes,
                 origins,
                 provenance: {
                     manifest: profileManifest.provenance,
@@ -544,14 +642,8 @@ export const normalizeAgentOsConfig = (config, compiled) => {
         ...(value.deployment.version === undefined
             ? {}
             : { "/deployment/version": configAuthorOrigin("/deployment/version") }),
-        "/target/kind": configAuthorOrigin("/target/kind"),
-        "/target/durableObject/className": configAuthorOrigin("/target/durableObject/className"),
-        "/target/durableObject/binding": configAuthorOrigin("/target/durableObject/binding"),
+        ...targetOriginFacts(value.target),
         "/client/kind": configAuthorOrigin("/client/kind"),
-        "/llm/route": configAuthorOrigin("/llm/route"),
-        "/llm/endpointRef": configAuthorOrigin("/llm/endpointRef"),
-        "/llm/credentialRef": configAuthorOrigin("/llm/credentialRef"),
-        "/llm/modelRef": configAuthorOrigin("/llm/modelRef"),
         "/workspace/binding": configAuthorOrigin("/workspace/binding"),
         "/workspace/bindingRef": `derived:/workspace/binding`,
         "/workspace/root": configAuthorOrigin("/workspace/root"),
@@ -568,6 +660,7 @@ export const normalizeAgentOsConfig = (config, compiled) => {
         "/workspace/providerResourceId": `derived:/deployment/id+/workspace/binding+/workspace/topology+/agent/scope`,
         "/workspace/cloudflareSandboxId": `derived:/workspace/providerResourceId`,
     };
+    addLlmRouteOrigins(origins, value.llm);
     return {
         ok: true,
         value: {
@@ -576,8 +669,8 @@ export const normalizeAgentOsConfig = (config, compiled) => {
             deployment: {
                 deploymentId: value.deployment.id,
                 manifest: manifestWithWorkspaceMaterial.manifest,
-                backend: "cloudflare-do",
-                adapter: AGENTOS_CONFIG_TARGET.CLOUDFLARE_DO_V1,
+                backend: targetDeploymentBackend(value.target),
+                adapter: targetDeploymentAdapter(value.target),
                 codec: "agentos-json@1",
                 providerStrategy: value.llm.route,
             },
@@ -585,9 +678,16 @@ export const normalizeAgentOsConfig = (config, compiled) => {
                 ? {}
                 : { deploymentVersion: value.deployment.version }),
             authoredToolNames: Object.keys(compiled.toolFilePaths).sort(),
+            channels: compiled.channels,
+            workflows: compiled.workflows,
+            schedules: compiled.schedules,
+            skills: compiled.skills,
+            instructionFragments: compiled.instructionFragments,
+            dynamicResolvers: compiled.dynamicResolvers,
             target: value.target,
             client: value.client,
-            llm: value.llm,
+            llm: llmRoutes.default,
+            llmRoutes,
             workspace: {
                 binding: value.workspace.binding,
                 bindingRef,

package/dist/build/agent-authoring/manifest-compiler.d.ts

@@ -2,7 +2,7 @@ import type { Authored } from "@yansirplus/core";
 import type { AgentSchemaSpec } from "@yansirplus/core/agent-schema";
 import { type AuthorityRef } from "@yansirplus/core/effect-claim";
 import { type MaterialRef } from "@yansirplus/core/material-ref";
-import type { AgentExecutionDomainRef, AgentInteractionRef, AgentLlmRouteBindingRef, AgentManifest, AgentScopeIdentityPolicy } from "@yansirplus/core/runtime-protocol";
+import type { AgentCapabilityBindingRef, AgentExecutionDomainRef, AgentInteractionRef, AgentLlmRouteBindingRef, AgentManifest, AgentScopeIdentityPolicy } from "@yansirplus/core/runtime-protocol";
 import { type HandlerKind } from "@yansirplus/core/runtime-protocol";
 import { type WorkspaceToolInteractionFloor, type WorkspaceToolName } from "@yansirplus/runtime";
 import { AUTHORING_DEFAULTS_VERSION } from "./shared.js";
@@ -11,11 +11,19 @@ export type AgentManifestOrigin = `path:${string}` | `author:${string}#${string}
 export interface AuthoredAgentTree {
     readonly files: ReadonlyArray<AuthoredAgentTreeFile>;
 }
-export type AuthoredAgentTreeFile = AuthoredMarkdownFile | AuthoredJsonFile | AuthoredToolFile;
+export type AuthoredAgentTreeFile = AuthoredMarkdownFile | AuthoredTextFile | AuthoredJsonFile | AuthoredToolFile | AuthoredDynamicResolverFile | AuthoredChannelFile | AuthoredWorkflowFile | AuthoredScheduleFile;
+export type AuthoredFileSourceKind = "regular" | "symlink" | "non_regular";
 export interface AuthoredMarkdownFile {
     readonly path: string;
     readonly kind: "markdown";
     readonly text: string;
+    readonly sourceKind?: AuthoredFileSourceKind;
+}
+export interface AuthoredTextFile {
+    readonly path: string;
+    readonly kind: "text";
+    readonly bytes: Uint8Array;
+    readonly sourceKind?: AuthoredFileSourceKind;
 }
 export interface AuthoredJsonFile {
     readonly path: string;
@@ -36,6 +44,85 @@ export interface AuthoredToolFile {
     readonly kind: "tool";
     readonly declaration?: AuthoredToolDeclaration;
 }
+export type DynamicCapabilitySlot = "tools" | "skills" | "instructions";
+export interface AuthoredDynamicResolverDeclaration {
+    readonly outputs?: unknown;
+    readonly id?: unknown;
+    readonly name?: unknown;
+}
+export interface AuthoredDynamicResolverFile {
+    readonly path: string;
+    readonly kind: "dynamic";
+    readonly declaration?: AuthoredDynamicResolverDeclaration;
+    readonly sourceKind?: AuthoredFileSourceKind;
+}
+export interface AuthoredChannelFile {
+    readonly path: string;
+    readonly kind: "channel";
+    readonly sourceKind?: AuthoredFileSourceKind;
+}
+export interface AuthoredWorkflowFile {
+    readonly path: string;
+    readonly kind: "workflow";
+    readonly sourceKind?: AuthoredFileSourceKind;
+}
+export interface AuthoredScheduleDeclaration {
+    readonly cron?: unknown;
+    readonly handler?: unknown;
+    readonly id?: unknown;
+    readonly name?: unknown;
+    readonly kind?: unknown;
+}
+export interface AuthoredScheduleFile {
+    readonly path: string;
+    readonly kind: "schedule";
+    readonly declaration?: AuthoredScheduleDeclaration;
+    readonly sourceKind?: AuthoredFileSourceKind;
+}
+export interface CompiledAgentChannel {
+    readonly name: string;
+    readonly path: string;
+    readonly origin: AgentManifestOrigin;
+}
+export interface CompiledAgentWorkflow {
+    readonly name: string;
+    readonly path: string;
+    readonly origin: AgentManifestOrigin;
+}
+export interface CompiledAgentSchedule {
+    readonly scheduleId: string;
+    readonly cron: string;
+    readonly path: string;
+    readonly origin: AgentManifestOrigin;
+}
+export interface CompiledAgentSkill {
+    readonly name: string;
+    readonly description: string;
+    readonly path: string;
+    readonly digest: string;
+    readonly text: string;
+    readonly files: ReadonlyArray<CompiledAgentSkillFile>;
+}
+export interface CompiledAgentSkillFile {
+    readonly path: string;
+    readonly digest: string;
+    readonly bytes: number;
+    readonly text: string;
+}
+export interface CompiledAgentInstructionFragment {
+    readonly fragmentId: string;
+    readonly path: string;
+    readonly digest: string;
+    readonly text: string;
+    readonly origin: AgentManifestOrigin;
+}
+export interface CompiledAgentDynamicResolver {
+    readonly resolverId: string;
+    readonly slot: DynamicCapabilitySlot;
+    readonly path: string;
+    readonly outputs: ReadonlyArray<string>;
+    readonly origin: AgentManifestOrigin;
+}
 export interface AuthoredWorkspaceDefaultToolOverride {
     readonly interaction?: WorkspaceToolInteractionFloor;
 }
@@ -46,6 +133,7 @@ export interface AuthoredAgentJson {
     readonly scope?: AgentScopeIdentityPolicy;
     readonly effectAuthorityRef?: AuthorityRef;
     readonly handlers?: ReadonlyArray<HandlerKind>;
+    readonly capabilities?: Readonly<Record<string, AgentCapabilityBindingRef>>;
     readonly llmRoutes?: Readonly<Record<string, AgentLlmRouteBindingRef>>;
     readonly tools?: Readonly<Record<string, AuthoredWorkspaceDefaultToolControl>>;
     readonly materials?: Readonly<Record<string, MaterialRef>>;
@@ -59,6 +147,12 @@ export interface CompiledAgentManifest<K extends HandlerKind = HandlerKind> {
     readonly provenance: Readonly<Record<AgentManifestFactKey, AgentManifestOrigin>>;
     readonly workspaceToolControls: Readonly<Partial<Record<WorkspaceToolName, WorkspaceDefaultToolControl>>>;
     readonly toolFilePaths: Readonly<Record<string, string>>;
+    readonly channels: ReadonlyArray<CompiledAgentChannel>;
+    readonly workflows: ReadonlyArray<CompiledAgentWorkflow>;
+    readonly schedules: ReadonlyArray<CompiledAgentSchedule>;
+    readonly skills: ReadonlyArray<CompiledAgentSkill>;
+    readonly instructionFragments: ReadonlyArray<CompiledAgentInstructionFragment>;
+    readonly dynamicResolvers: ReadonlyArray<CompiledAgentDynamicResolver>;
 }
 export type CompileAgentTreeIssue = {
     readonly kind: "unsupported_path";
@@ -130,6 +224,41 @@ export type CompileAgentTreeIssue = {
     readonly kind: "workspace_default_tool_shadowed";
     readonly path: string;
     readonly toolId: string;
+} | {
+    readonly kind: "skill_identity_mismatch";
+    readonly path: string;
+    readonly expectedName: string;
+    readonly actualName: string;
+} | {
+    readonly kind: "duplicate_skill";
+    readonly name: string;
+    readonly path: string;
+    readonly existingPath: string;
+} | {
+    readonly kind: "duplicate_instruction_fragment";
+    readonly fragmentId: string;
+    readonly path: string;
+    readonly existingPath: string;
+} | {
+    readonly kind: "duplicate_dynamic_resolver";
+    readonly slot: DynamicCapabilitySlot;
+    readonly resolverId: string;
+    readonly path: string;
+    readonly existingPath: string;
+} | {
+    readonly kind: "dynamic_resolver_cross_slot_output";
+    readonly path: string;
+    readonly slot: DynamicCapabilitySlot;
+    readonly outputSlot: DynamicCapabilitySlot;
+} | {
+    readonly kind: "dynamic_resolver_unknown_target";
+    readonly path: string;
+    readonly slot: DynamicCapabilitySlot;
+    readonly targetId: string;
+} | {
+    readonly kind: "reserved_tool_name";
+    readonly path: string;
+    readonly toolId: string;
 } | {
     readonly kind: "runtime_fact_forbidden";
     readonly path: string;