@yansirplus/cli 0.5.17

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

@@ -0,0 +1,159 @@
+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 HandlerKind } from "@yansirplus/core/runtime-protocol";
+import { type WorkspaceToolInteractionFloor, type WorkspaceToolName } from "@yansirplus/runtime";
+import { AUTHORING_DEFAULTS_VERSION } from "./shared.js";
+export type AgentManifestFactKey = `/${string}`;
+export type AgentManifestOrigin = `path:${string}` | `author:${string}#${string}` | `scaffold:${string}@${string}#${string}` | `default:${typeof AUTHORING_DEFAULTS_VERSION}#${string}` | `macro(workspace@1)#${string}`;
+export interface AuthoredAgentTree {
+    readonly files: ReadonlyArray<AuthoredAgentTreeFile>;
+}
+export type AuthoredAgentTreeFile = AuthoredMarkdownFile | AuthoredJsonFile | AuthoredToolFile;
+export interface AuthoredMarkdownFile {
+    readonly path: string;
+    readonly kind: "markdown";
+    readonly text: string;
+}
+export interface AuthoredJsonFile {
+    readonly path: string;
+    readonly kind: "json";
+    readonly value: unknown;
+}
+export type AuthoredToolEffect = "material" | "workspace_mutation" | "network" | "dispatch" | "provider_call" | (string & {});
+export interface AuthoredToolDeclaration {
+    readonly bindingRef?: string;
+    readonly executionDomain?: string;
+    readonly interaction?: string;
+    readonly materialRefs?: ReadonlyArray<string>;
+    readonly effects?: ReadonlyArray<AuthoredToolEffect>;
+    readonly receiptPolicy?: string;
+}
+export interface AuthoredToolFile {
+    readonly path: string;
+    readonly kind: "tool";
+    readonly declaration?: AuthoredToolDeclaration;
+}
+export interface AuthoredWorkspaceDefaultToolOverride {
+    readonly interaction?: WorkspaceToolInteractionFloor;
+}
+export type AuthoredWorkspaceDefaultToolControl = false | AuthoredWorkspaceDefaultToolOverride;
+export interface AuthoredAgentJson {
+    readonly agentId?: string;
+    readonly version?: string;
+    readonly scope?: AgentScopeIdentityPolicy;
+    readonly effectAuthorityRef?: AuthorityRef;
+    readonly handlers?: ReadonlyArray<HandlerKind>;
+    readonly llmRoutes?: Readonly<Record<string, AgentLlmRouteBindingRef>>;
+    readonly tools?: Readonly<Record<string, AuthoredWorkspaceDefaultToolControl>>;
+    readonly materials?: Readonly<Record<string, MaterialRef>>;
+    readonly executionDomains?: Readonly<Record<string, AgentExecutionDomainRef>>;
+    readonly interactions?: Readonly<Record<string, AgentInteractionRef>>;
+    readonly outputSchema?: AgentSchemaSpec;
+}
+export type AuthoredAgentManifest<K extends HandlerKind = HandlerKind> = AgentManifest<K> & Authored<AgentManifest<K>>;
+export interface CompiledAgentManifest<K extends HandlerKind = HandlerKind> {
+    readonly manifest: AuthoredAgentManifest<K>;
+    readonly provenance: Readonly<Record<AgentManifestFactKey, AgentManifestOrigin>>;
+    readonly workspaceToolControls: Readonly<Partial<Record<WorkspaceToolName, WorkspaceDefaultToolControl>>>;
+    readonly toolFilePaths: Readonly<Record<string, string>>;
+}
+export type CompileAgentTreeIssue = {
+    readonly kind: "unsupported_path";
+    readonly path: string;
+    readonly reason: string;
+} | {
+    readonly kind: "duplicate_path";
+    readonly path: string;
+    readonly existingPath: string;
+} | {
+    readonly kind: "duplicate_fact";
+    readonly factKey: AgentManifestFactKey;
+    readonly origins: readonly [AgentManifestOrigin, AgentManifestOrigin];
+} | {
+    readonly kind: "non_overrideable_fact";
+    readonly factKey: AgentManifestFactKey;
+    readonly origins: readonly [AgentManifestOrigin, AgentManifestOrigin];
+} | {
+    readonly kind: "missing_required_file";
+    readonly path: "agent/instructions.md";
+} | {
+    readonly kind: "empty_instructions";
+    readonly path: string;
+} | {
+    readonly kind: "invalid_json_file";
+    readonly path: string;
+    readonly reason: string;
+} | {
+    readonly kind: "invalid_authored_value";
+    readonly path: string;
+    readonly field: string;
+    readonly reason: string;
+} | {
+    readonly kind: "unknown_field";
+    readonly path: string;
+    readonly field: string;
+} | {
+    readonly kind: "identity_field_forbidden";
+    readonly path: string;
+    readonly field: "id" | "name" | "kind";
+} | {
+    readonly kind: "effectful_tool_missing_material";
+    readonly toolId: string;
+} | {
+    readonly kind: "effectful_tool_missing_execution_domain";
+    readonly toolId: string;
+} | {
+    readonly kind: "effectful_tool_missing_interaction";
+    readonly toolId: string;
+} | {
+    readonly kind: "effectful_tool_missing_receipt_policy";
+    readonly toolId: string;
+} | {
+    readonly kind: "unknown_workspace_default_tool_control";
+    readonly path: string;
+    readonly toolId: string;
+} | {
+    readonly kind: "workspace_default_tool_control_field_forbidden";
+    readonly path: string;
+    readonly toolId: string;
+    readonly field: string;
+} | {
+    readonly kind: "workspace_default_tool_interaction_weakened";
+    readonly path: string;
+    readonly toolId: string;
+    readonly floor: WorkspaceToolInteractionFloor;
+    readonly attempted: WorkspaceToolInteractionFloor;
+} | {
+    readonly kind: "workspace_default_tool_shadowed";
+    readonly path: string;
+    readonly toolId: string;
+} | {
+    readonly kind: "runtime_fact_forbidden";
+    readonly path: string;
+    readonly field: string;
+} | {
+    readonly kind: "function_in_manifest";
+    readonly path: string;
+};
+export type CompileAgentTreeResult<K extends HandlerKind = HandlerKind> = {
+    readonly ok: true;
+    readonly value: CompiledAgentManifest<K>;
+} | {
+    readonly ok: false;
+    readonly issues: ReadonlyArray<CompileAgentTreeIssue>;
+};
+export type WorkspaceDefaultToolControl = {
+    readonly kind: "disabled";
+    readonly origin: AgentManifestOrigin;
+} | {
+    readonly kind: "override";
+    readonly interaction?: {
+        readonly value: WorkspaceToolInteractionFloor;
+        readonly origin: AgentManifestOrigin;
+    };
+};
+export declare const workspaceManifestMacroOrigin: (factKey: AgentManifestFactKey) => AgentManifestOrigin;
+export declare const compileAgentTree: <K extends HandlerKind = HandlerKind>(tree: AuthoredAgentTree) => CompileAgentTreeResult<K>;