@yansirplus/cli 0.5.17

package/PUBLIC_API.md

@@ -0,0 +1,22 @@
+<!-- generated by packages/cli/src/generate/generate-docs.mjs; edit docs/surface.json and exported TSDoc in packages/cli/src -->
+
+# @yansirplus/cli Public API
+
+Status: 0.5.x active development. CLI root exports are the supported developer API; command internals remain implementation details.
+
+## Public exports
+
+- `.:compileAgentTree` - Compile an authored `agent/` tree into one normalized manifest plus provenance. Runtime facts and provider material are rejected before they can become manifest truth.
+- `.:linkWorkspaceStaticTarget` - Link normalized workspace authoring intent to a closed-target residual program. Implementation wiring is static imports and factory composition; manifest and deployment JSON remain semantic/provenance data only.
+
+## Experimental exports
+
+None.
+
+## Deprecated exports
+
+None.
+
+## Internal-only exports
+
+Any package file or symbol not listed above.

package/README.md

@@ -0,0 +1,34 @@
+<!-- generated by packages/cli/src/generate/generate-docs.mjs; edit docs/surface.json and docs/packages/cli.md -->
+
+# @yansirplus/cli
+
+## Purpose
+
+`@yansirplus/cli` is the developer command package for generated projections,
+authored agent builds, structural checks, and distribution gates.
+
+## Public API Status
+
+0.5.x active development. CLI commands are the supported developer surface; generated projections remain owned by their source facts.
+
+## Invariant
+
+The CLI consumes source facts and executes gates. It does not own package
+facts, public API intent, carrier declarations, ledger identity, or substrate
+runtime behavior.
+
+## Minimal Usage
+
+```sh
+bun run agentos -- check all
+bun run agentos -- check guard public-api
+bun run agentos -- build --cwd /path/to/app
+bun run agentos -- generate docs
+```
+
+## Verification
+
+```sh
+bun run agentos -- --help
+bun run agentos -- check guard ag-ui-sse-axis
+```

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

@@ -0,0 +1,177 @@
+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";
+export declare const AGENTOS_CONFIG_PROFILE: {
+    readonly WORKSPACE_V1: "workspace@1";
+    readonly CHAT_V1: "chat@1";
+};
+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";
+};
+export type AgentOsConfigTargetKind = (typeof AGENTOS_CONFIG_TARGET)[keyof typeof AGENTOS_CONFIG_TARGET];
+export declare const AGENTOS_CONFIG_CLIENT: {
+    readonly SVELTE_KIT_REMOTE_V1: "svelte-kit-remote@1";
+    readonly BROWSER_DIRECT_V1: "browser-direct@1";
+};
+export type AgentOsConfigClientKind = (typeof AGENTOS_CONFIG_CLIENT)[keyof typeof AGENTOS_CONFIG_CLIENT];
+export declare const AGENTOS_CONFIG_LLM_ROUTE: {
+    readonly OPENAI_CHAT_COMPATIBLE: "openai-chat-compatible";
+};
+export type AgentOsConfigLlmRoute = (typeof AGENTOS_CONFIG_LLM_ROUTE)[keyof typeof AGENTOS_CONFIG_LLM_ROUTE];
+export interface AgentOsConfigDeployment {
+    readonly id: string;
+    readonly version?: string;
+}
+export interface AgentOsConfigCloudflareDoTarget {
+    readonly kind: typeof AGENTOS_CONFIG_TARGET.CLOUDFLARE_DO_V1;
+    readonly durableObject: {
+        readonly className: string;
+        readonly binding: string;
+    };
+}
+export type AgentOsConfigTarget = AgentOsConfigCloudflareDoTarget;
+export interface AgentOsConfigClient {
+    readonly kind: AgentOsConfigClientKind;
+}
+export interface AgentOsConfigLlm {
+    readonly route: AgentOsConfigLlmRoute;
+    readonly endpointRef: string;
+    readonly credentialRef: string;
+    readonly modelRef: string;
+}
+export type AgentOsConfigWorkspaceTopology = WorkspaceTopology;
+export interface AgentOsConfigWorkspace {
+    readonly binding: string;
+    readonly root: string;
+    readonly topology?: AgentOsConfigWorkspaceTopology;
+}
+export interface AgentOsConfigBase {
+    readonly $schema?: string;
+    readonly profile: AgentOsConfigProfile;
+    readonly agent: string;
+    readonly deployment: AgentOsConfigDeployment;
+    readonly target: AgentOsConfigTarget;
+    readonly client: AgentOsConfigClient;
+    readonly llm: AgentOsConfigLlm;
+}
+export interface AgentOsWorkspaceConfigV1 extends AgentOsConfigBase {
+    readonly profile: typeof AGENTOS_CONFIG_PROFILE.WORKSPACE_V1;
+    readonly workspace: AgentOsConfigWorkspace;
+}
+export interface AgentOsChatConfigV1 extends AgentOsConfigBase {
+    readonly profile: typeof AGENTOS_CONFIG_PROFILE.CHAT_V1;
+    readonly workspace?: never;
+}
+export type AgentOsConfigV1 = AgentOsWorkspaceConfigV1 | AgentOsChatConfigV1;
+export type AgentOsConfigFactKey = `/${string}`;
+export type AgentOsConfigOrigin = `author:agentos.config.jsonc#${AgentOsConfigFactKey}` | `macro(${typeof AGENTOS_CONFIG_PROFILE.WORKSPACE_V1})#${AgentOsConfigFactKey}` | `macro(${typeof AGENTOS_CONFIG_PROFILE.CHAT_V1})#${AgentOsConfigFactKey}` | `derived:${string}`;
+export type AgentOsConfigIssue = {
+    readonly kind: "config_not_object";
+    readonly path: "agentos.config.jsonc";
+} | {
+    readonly kind: "unknown_field";
+    readonly path: string;
+    readonly field: string;
+} | {
+    readonly kind: "invalid_config_value";
+    readonly path: string;
+    readonly field: string;
+    readonly reason: string;
+} | {
+    readonly kind: "runtime_fact_forbidden";
+    readonly path: string;
+    readonly field: string;
+} | {
+    readonly kind: "function_in_config";
+    readonly path: string;
+} | {
+    readonly kind: "workspace_scope_not_manifest_owned";
+    readonly path: "agent/agent.json#/scope";
+    readonly reason: "scope_not_manifest_owned" | "stable_scope_id_missing";
+} | {
+    readonly kind: "llm_material_env_name_collision";
+    readonly path: "agentos.config.jsonc#/llm";
+    readonly envName: string;
+    readonly refs: readonly [string, string];
+} | {
+    readonly kind: "workspace_default_tool_shadowed";
+    readonly path: string;
+    readonly toolId: WorkspaceToolName;
+} | {
+    readonly kind: "tool_material_ref_unresolved";
+    readonly toolId: string;
+    readonly materialRef: string;
+} | {
+    readonly kind: "tool_execution_domain_ref_unresolved";
+    readonly toolId: string;
+    readonly executionDomain: string;
+} | {
+    readonly kind: "tool_interaction_ref_unresolved";
+    readonly toolId: string;
+    readonly interaction: string;
+};
+export interface StaticTargetProvenance {
+    readonly manifest: Readonly<Record<AgentManifestFactKey, AgentManifestOrigin>>;
+    readonly deployment: Readonly<Record<AgentOsConfigFactKey, AgentOsConfigOrigin>>;
+    readonly exclusions: Readonly<Record<string, AgentManifestOrigin>>;
+}
+export type DecodeAgentOsConfigResult = {
+    readonly ok: true;
+    readonly value: AgentOsConfigV1;
+} | {
+    readonly ok: false;
+    readonly issues: ReadonlyArray<AgentOsConfigIssue>;
+};
+export interface NormalizedAgentOsConfigBase<M extends AgentManifest = AgentManifest> {
+    readonly profile: AgentOsConfigProfile;
+    readonly config: AgentOsConfigV1;
+    readonly deployment: DeploymentSpec<M>;
+    readonly deploymentVersion?: string;
+    readonly authoredToolNames: ReadonlyArray<string>;
+    readonly target: AgentOsConfigTarget;
+    readonly client: AgentOsConfigClient;
+    readonly llm: AgentOsConfigLlm;
+    readonly origins: Readonly<Record<AgentOsConfigFactKey, AgentOsConfigOrigin>>;
+    readonly provenance: StaticTargetProvenance;
+}
+export interface NormalizedWorkspaceAgentOsConfig<M extends AgentManifest = AgentManifest> extends NormalizedAgentOsConfigBase<M> {
+    readonly profile: typeof AGENTOS_CONFIG_PROFILE.WORKSPACE_V1;
+    readonly config: AgentOsWorkspaceConfigV1;
+    readonly workspace: AgentOsConfigWorkspace & {
+        readonly topology: AgentOsConfigWorkspaceTopology;
+        readonly bindingRef: WorkspaceBindingRef;
+        readonly providerResourceId: ProviderResourceId;
+        readonly cloudflareSandboxId: string;
+    };
+}
+export interface NormalizedChatAgentOsConfig<M extends AgentManifest = AgentManifest> extends NormalizedAgentOsConfigBase<M> {
+    readonly profile: typeof AGENTOS_CONFIG_PROFILE.CHAT_V1;
+    readonly config: AgentOsChatConfigV1;
+}
+export type NormalizedAgentOsConfig<M extends AgentManifest = AgentManifest> = NormalizedWorkspaceAgentOsConfig<M> | NormalizedChatAgentOsConfig<M>;
+export type NormalizeAgentOsConfigResult<M extends AgentManifest = AgentManifest> = {
+    readonly ok: true;
+    readonly value: NormalizedAgentOsConfig<M>;
+} | {
+    readonly ok: false;
+    readonly issues: ReadonlyArray<AgentOsConfigIssue>;
+};
+export type LlmMaterialEnvKind = "endpoint" | "credential" | "model";
+export interface LlmMaterialEnvBinding {
+    readonly kind: LlmMaterialEnvKind;
+    readonly ref: string;
+    readonly envName: string;
+}
+export declare const materialEnvNameForRef: (kind: LlmMaterialEnvKind, ref: string) => string;
+export declare const llmMaterialEnvBindingsForRefs: (refs: ReadonlyArray<{
+    readonly kind: LlmMaterialEnvKind;
+    readonly ref: string;
+}>) => ReadonlyArray<LlmMaterialEnvBinding>;
+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 decodeAgentOsConfig: (value: unknown) => DecodeAgentOsConfigResult;
+export declare const normalizeAgentOsConfig: <K extends HandlerKind = HandlerKind>(config: AgentOsConfigV1, compiled: CompiledAgentManifest<K>) => NormalizeAgentOsConfigResult<AuthoredAgentManifest<K>>;