@agentxm/client-core 0.11.1 → 0.11.3

package/dist/src/unstable/context-files/manifest-schema.d.ts

@@ -0,0 +1,269 @@
+/**
+ * Context files manifest schema definition.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+/**
+ * Filename for context files manifests.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const CONTEXT_FILES_MANIFEST_FILENAME = "context-files.json";
+/**
+ * Local directory segment for context files packages under `.axm/extensions`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const CONTEXT_FILES_EXTENSION_DIR = "context-files";
+/**
+ * URL for the context files manifest JSON Schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const CONTEXT_FILES_MANIFEST_SCHEMA_URL = "https://axm.sh/schemas/context-files.schema.json";
+/**
+ * Scalar values accepted by context files inputs and template substitution.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const FileInputValueSchema: Schema.Union<readonly [Schema.String, Schema.Number, Schema.Boolean]>;
+/** @experimental */
+export type FileInputValue = Schema.Schema.Type<typeof FileInputValueSchema>;
+/**
+ * Input declaration for values consumed by template file sources.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const FileInputDeclarationSchema: Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"string">;
+    readonly prompt: Schema.optional<Schema.String>;
+    readonly default: Schema.optional<Schema.String>;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"number">;
+    readonly prompt: Schema.optional<Schema.String>;
+    readonly default: Schema.optional<Schema.Number>;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"boolean">;
+    readonly prompt: Schema.optional<Schema.String>;
+    readonly default: Schema.optional<Schema.Boolean>;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"enum">;
+    readonly prompt: Schema.optional<Schema.String>;
+    readonly values: Schema.$Array<Schema.NonEmptyString>;
+    readonly default: Schema.optional<Schema.String>;
+}>]>;
+/** @experimental */
+export type FileInputDeclaration = Schema.Schema.Type<typeof FileInputDeclarationSchema>;
+/**
+ * Map of input names to input declarations.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const FileInputDeclarationsMapSchema: Schema.$Record<Schema.String, Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"string">;
+    readonly prompt: Schema.optional<Schema.String>;
+    readonly default: Schema.optional<Schema.String>;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"number">;
+    readonly prompt: Schema.optional<Schema.String>;
+    readonly default: Schema.optional<Schema.Number>;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"boolean">;
+    readonly prompt: Schema.optional<Schema.String>;
+    readonly default: Schema.optional<Schema.Boolean>;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"enum">;
+    readonly prompt: Schema.optional<Schema.String>;
+    readonly values: Schema.$Array<Schema.NonEmptyString>;
+    readonly default: Schema.optional<Schema.String>;
+}>]>>;
+/** @experimental */
+export type FileInputDeclarationsMap = Schema.Schema.Type<typeof FileInputDeclarationsMapSchema>;
+/**
+ * Generator spec used by generated file content sources.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const FileGeneratorSpecSchema: Schema.Struct<{
+    readonly name: Schema.Literals<readonly ["toc", "file-index"]>;
+    readonly options: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Number, Schema.Boolean]>>>;
+}>;
+/** @experimental */
+export type FileGeneratorSpec = Schema.Schema.Type<typeof FileGeneratorSpecSchema>;
+/**
+ * Content source for a context files contents entry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const FileContentSourceSchema: Schema.Union<readonly [Schema.Struct<{
+    readonly kind: Schema.Literal<"static">;
+    readonly path: Schema.Union<readonly [Schema.NonEmptyString, Schema.$Array<Schema.NonEmptyString>]>;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"template">;
+    readonly path: Schema.Union<readonly [Schema.NonEmptyString, Schema.$Array<Schema.NonEmptyString>]>;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"generated">;
+    readonly generator: Schema.Struct<{
+        readonly name: Schema.Literals<readonly ["toc", "file-index"]>;
+        readonly options: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Number, Schema.Boolean]>>>;
+    }>;
+}>]>;
+/** @experimental */
+export type FileContentSource = Schema.Schema.Type<typeof FileContentSourceSchema>;
+/**
+ * Materialization modes supported by context files packages.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const FileMaterializationModeSchema: Schema.Literals<readonly ["sync-once", "sync-always", "managed-region"]>;
+/** @experimental */
+export type FileMaterializationMode = Schema.Schema.Type<typeof FileMaterializationModeSchema>;
+/**
+ * One materialization target declared by context-files.json.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const FileContentsEntrySchema: Schema.Union<readonly [Schema.Struct<{
+    readonly source: Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"static">;
+        readonly path: Schema.Union<readonly [Schema.NonEmptyString, Schema.$Array<Schema.NonEmptyString>]>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"template">;
+        readonly path: Schema.Union<readonly [Schema.NonEmptyString, Schema.$Array<Schema.NonEmptyString>]>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"generated">;
+        readonly generator: Schema.Struct<{
+            readonly name: Schema.Literals<readonly ["toc", "file-index"]>;
+            readonly options: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Number, Schema.Boolean]>>>;
+        }>;
+    }>]>;
+    readonly target: Schema.NonEmptyString;
+    readonly mode: Schema.Literals<readonly ["sync-once", "sync-always"]>;
+}>, Schema.Struct<{
+    readonly source: Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"static">;
+        readonly path: Schema.Union<readonly [Schema.NonEmptyString, Schema.$Array<Schema.NonEmptyString>]>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"template">;
+        readonly path: Schema.Union<readonly [Schema.NonEmptyString, Schema.$Array<Schema.NonEmptyString>]>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"generated">;
+        readonly generator: Schema.Struct<{
+            readonly name: Schema.Literals<readonly ["toc", "file-index"]>;
+            readonly options: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Number, Schema.Boolean]>>>;
+        }>;
+    }>]>;
+    readonly target: Schema.NonEmptyString;
+    readonly mode: Schema.Literal<"managed-region">;
+    readonly region: Schema.NonEmptyString;
+    readonly anchor: Schema.optional<Schema.NonEmptyString>;
+}>]>;
+/** @experimental */
+export type FileContentsEntry = Schema.Schema.Type<typeof FileContentsEntrySchema>;
+/**
+ * Schema for context files manifest files (context-files.json).
+ *
+ * Context files packages distribute structural workspace files. They do not declare
+ * agent compatibility.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const ContextFilesManifestSchema: Schema.Struct<{
+    readonly type: Schema.Literal<"file">;
+    readonly name: Schema.brand<Schema.NonEmptyString, "ExtensionName">;
+    readonly inputs: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.Struct<{
+        readonly type: Schema.Literal<"string">;
+        readonly prompt: Schema.optional<Schema.String>;
+        readonly default: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"number">;
+        readonly prompt: Schema.optional<Schema.String>;
+        readonly default: Schema.optional<Schema.Number>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"boolean">;
+        readonly prompt: Schema.optional<Schema.String>;
+        readonly default: Schema.optional<Schema.Boolean>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"enum">;
+        readonly prompt: Schema.optional<Schema.String>;
+        readonly values: Schema.$Array<Schema.NonEmptyString>;
+        readonly default: Schema.optional<Schema.String>;
+    }>]>>>;
+    readonly contents: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+        readonly source: Schema.Union<readonly [Schema.Struct<{
+            readonly kind: Schema.Literal<"static">;
+            readonly path: Schema.Union<readonly [Schema.NonEmptyString, Schema.$Array<Schema.NonEmptyString>]>;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"template">;
+            readonly path: Schema.Union<readonly [Schema.NonEmptyString, Schema.$Array<Schema.NonEmptyString>]>;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"generated">;
+            readonly generator: Schema.Struct<{
+                readonly name: Schema.Literals<readonly ["toc", "file-index"]>;
+                readonly options: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Number, Schema.Boolean]>>>;
+            }>;
+        }>]>;
+        readonly target: Schema.NonEmptyString;
+        readonly mode: Schema.Literals<readonly ["sync-once", "sync-always"]>;
+    }>, Schema.Struct<{
+        readonly source: Schema.Union<readonly [Schema.Struct<{
+            readonly kind: Schema.Literal<"static">;
+            readonly path: Schema.Union<readonly [Schema.NonEmptyString, Schema.$Array<Schema.NonEmptyString>]>;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"template">;
+            readonly path: Schema.Union<readonly [Schema.NonEmptyString, Schema.$Array<Schema.NonEmptyString>]>;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"generated">;
+            readonly generator: Schema.Struct<{
+                readonly name: Schema.Literals<readonly ["toc", "file-index"]>;
+                readonly options: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Number, Schema.Boolean]>>>;
+            }>;
+        }>]>;
+        readonly target: Schema.NonEmptyString;
+        readonly mode: Schema.Literal<"managed-region">;
+        readonly region: Schema.NonEmptyString;
+        readonly anchor: Schema.optional<Schema.NonEmptyString>;
+    }>]>>;
+    readonly recommendedPacks: Schema.optional<Schema.$Array<Schema.brand<Schema.NonEmptyString, "PackSpec">>>;
+    readonly standalone: Schema.optional<Schema.Boolean>;
+    readonly owner: Schema.brand<Schema.String, "Handle">;
+    readonly version: Schema.brand<Schema.String, "Version">;
+    readonly description: Schema.optional<Schema.String>;
+    readonly keywords: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
+    readonly repository: Schema.optional<Schema.Union<readonly [Schema.String, Schema.Struct<{
+        readonly type: Schema.optional<Schema.NonEmptyString>;
+        readonly url: Schema.NonEmptyString;
+        readonly directory: Schema.optional<Schema.NonEmptyString>;
+    }>]>>;
+    readonly homepage: Schema.optional<Schema.String>;
+    readonly license: Schema.optional<Schema.String>;
+    readonly bugs: Schema.optional<Schema.Union<readonly [Schema.String, Schema.Struct<{
+        readonly url: Schema.optional<Schema.NonEmptyString>;
+        readonly email: Schema.optional<Schema.NonEmptyString>;
+    }>]>>;
+    readonly authors: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly email: Schema.optional<Schema.String>;
+        readonly url: Schema.optional<Schema.String>;
+    }>>>;
+    readonly packages: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly purl: Schema.brand<Schema.NonEmptyString, "PackageIdentityPurl">;
+        readonly versionRange: Schema.optional<Schema.brand<Schema.decodeTo<Schema.toType<Schema.Struct<{
+            readonly raw: Schema.NonEmptyString;
+            readonly scheme: Schema.NonEmptyString;
+            readonly constraints: Schema.$Array<Schema.Struct<{
+                readonly comparator: Schema.Literals<readonly ["=", "!=", "<", "<=", ">", ">="]>;
+                readonly version: Schema.NonEmptyString;
+            }>>;
+        }>>, Schema.NonEmptyString, never, never>, "VersRange">>;
+    }>>>;
+    readonly $schema: Schema.optional<Schema.String>;
+}>;
+/**
+ * Inferred type for ContextFilesManifest schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type ContextFilesManifest = Schema.Schema.Type<typeof ContextFilesManifestSchema>;
+//# sourceMappingURL=manifest-schema.d.ts.map

package/dist/src/unstable/context-files/manifest-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-schema.d.ts","sourceRoot":"","sources":["../../../../src/unstable/context-files/manifest-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAOxC;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,uBAAuB,CAAC;AAEpE;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,kBAAkB,CAAC;AAE3D;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,qDAAqD,CAAC;AAEpG;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,uEAQ/B,CAAC;AAEH,oBAAoB;AACpB,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAuC7E;;;;GAIG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;IASrC,CAAC;AAEH,oBAAoB;AACpB,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEzF;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;KAMzC,CAAC;AAEH,oBAAoB;AACpB,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEjG;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;EAOlC,CAAC;AAEH,oBAAoB;AACpB,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAmCnF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;IAQlC,CAAC;AAEH,oBAAoB;AACpB,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAEnF;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,0EAQxC,CAAC;AAEH,oBAAoB;AACpB,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAsB/F;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQlC,CAAC;AAEH,oBAAoB;AACpB,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAEnF;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBrC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/src/unstable/context-files/manifest-schema.js

@@ -0,0 +1,223 @@
+/**
+ * Context files manifest schema definition.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+import { CommonManifestBaseFields, ExtensionNameSchema, NonPackManifestFields, } from "../extensions/common.js";
+/**
+ * Filename for context files manifests.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const CONTEXT_FILES_MANIFEST_FILENAME = "context-files.json";
+/**
+ * Local directory segment for context files packages under `.axm/extensions`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const CONTEXT_FILES_EXTENSION_DIR = "context-files";
+/**
+ * URL for the context files manifest JSON Schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const CONTEXT_FILES_MANIFEST_SCHEMA_URL = "https://axm.sh/schemas/context-files.schema.json";
+/**
+ * Scalar values accepted by context files inputs and template substitution.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const FileInputValueSchema = Schema.Union([
+    Schema.String,
+    Schema.Number,
+    Schema.Boolean,
+]).annotate({
+    identifier: "ContextFilesInputValue",
+    title: "Context Files Input Value",
+    description: "Scalar value used to render context files templates.",
+});
+const FileInputStringDeclarationSchema = Schema.Struct({
+    type: Schema.Literal("string"),
+    prompt: Schema.optional(Schema.String),
+    default: Schema.optional(Schema.String),
+}).annotate({
+    identifier: "ContextFilesInputStringDeclaration",
+    title: "Context Files Input String Declaration",
+});
+const FileInputNumberDeclarationSchema = Schema.Struct({
+    type: Schema.Literal("number"),
+    prompt: Schema.optional(Schema.String),
+    default: Schema.optional(Schema.Number),
+}).annotate({
+    identifier: "ContextFilesInputNumberDeclaration",
+    title: "Context Files Input Number Declaration",
+});
+const FileInputBooleanDeclarationSchema = Schema.Struct({
+    type: Schema.Literal("boolean"),
+    prompt: Schema.optional(Schema.String),
+    default: Schema.optional(Schema.Boolean),
+}).annotate({
+    identifier: "ContextFilesInputBooleanDeclaration",
+    title: "Context Files Input Boolean Declaration",
+});
+const FileInputEnumDeclarationSchema = Schema.Struct({
+    type: Schema.Literal("enum"),
+    prompt: Schema.optional(Schema.String),
+    values: Schema.Array(Schema.NonEmptyString).check(Schema.isMinLength(1)),
+    default: Schema.optional(Schema.String),
+}).annotate({
+    identifier: "ContextFilesInputEnumDeclaration",
+    title: "Context Files Input Enum Declaration",
+});
+/**
+ * Input declaration for values consumed by template file sources.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const FileInputDeclarationSchema = Schema.Union([
+    FileInputStringDeclarationSchema,
+    FileInputNumberDeclarationSchema,
+    FileInputBooleanDeclarationSchema,
+    FileInputEnumDeclarationSchema,
+]).annotate({
+    identifier: "ContextFilesInputDeclaration",
+    title: "Context Files Input Declaration",
+    description: "A scalar input declaration for a context files template.",
+});
+/**
+ * Map of input names to input declarations.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const FileInputDeclarationsMapSchema = Schema.Record(Schema.String, FileInputDeclarationSchema).annotate({
+    identifier: "ContextFilesInputDeclarationsMap",
+    title: "Context Files Input Declarations Map",
+});
+/**
+ * Generator spec used by generated file content sources.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const FileGeneratorSpecSchema = Schema.Struct({
+    name: Schema.Literals(["toc", "file-index"]),
+    options: Schema.optional(Schema.Record(Schema.String, FileInputValueSchema)),
+}).annotate({
+    identifier: "ContextFilesGeneratorSpec",
+    title: "Context Files Generator Spec",
+    description: "A supported v1 generated content source and scalar options.",
+});
+const SourcePathSchema = Schema.Union([
+    Schema.NonEmptyString,
+    Schema.Array(Schema.NonEmptyString).check(Schema.isMinLength(1)),
+]).annotate({
+    identifier: "ContextFilesSourcePath",
+    title: "Context Files Source Path",
+    description: "A payload path within src/, or an ordered list of payload paths to concatenate.",
+});
+const StaticContentSourceSchema = Schema.Struct({
+    kind: Schema.Literal("static"),
+    path: SourcePathSchema,
+}).annotate({
+    identifier: "StaticContentSource",
+    title: "Static Content Source",
+});
+const TemplateContentSourceSchema = Schema.Struct({
+    kind: Schema.Literal("template"),
+    path: SourcePathSchema,
+}).annotate({
+    identifier: "TemplateContentSource",
+    title: "Template Content Source",
+});
+const GeneratedContentSourceSchema = Schema.Struct({
+    kind: Schema.Literal("generated"),
+    generator: FileGeneratorSpecSchema,
+}).annotate({
+    identifier: "GeneratedContentSource",
+    title: "Generated Content Source",
+});
+/**
+ * Content source for a context files contents entry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const FileContentSourceSchema = Schema.Union([
+    StaticContentSourceSchema,
+    TemplateContentSourceSchema,
+    GeneratedContentSourceSchema,
+]).annotate({
+    identifier: "ContextFilesContentSource",
+    title: "Context Files Content Source",
+    description: "Static, template, or generated source for a materialized file target.",
+});
+/**
+ * Materialization modes supported by context files packages.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const FileMaterializationModeSchema = Schema.Literals([
+    "sync-once",
+    "sync-always",
+    "managed-region",
+]).annotate({
+    identifier: "ContextFilesMaterializationMode",
+    title: "Context Files Materialization Mode",
+    description: "How AXM owns or preserves the materialized target.",
+});
+const WholeFileContentsEntrySchema = Schema.Struct({
+    source: FileContentSourceSchema,
+    target: Schema.NonEmptyString,
+    mode: Schema.Literals(["sync-once", "sync-always"]),
+}).annotate({
+    identifier: "WholeFileContentsEntry",
+    title: "Whole File Contents Entry",
+});
+const ManagedRegionContentsEntrySchema = Schema.Struct({
+    source: FileContentSourceSchema,
+    target: Schema.NonEmptyString,
+    mode: Schema.Literal("managed-region"),
+    region: Schema.NonEmptyString,
+    anchor: Schema.optional(Schema.NonEmptyString),
+}).annotate({
+    identifier: "ManagedRegionContentsEntry",
+    title: "Managed Region Contents Entry",
+});
+/**
+ * One materialization target declared by context-files.json.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const FileContentsEntrySchema = Schema.Union([
+    WholeFileContentsEntrySchema,
+    ManagedRegionContentsEntrySchema,
+]).annotate({
+    identifier: "ContextFilesContentsEntry",
+    title: "Context Files Contents Entry",
+    description: "A context files package content source and the workspace target it materializes into.",
+});
+/**
+ * Schema for context files manifest files (context-files.json).
+ *
+ * Context files packages distribute structural workspace files. They do not declare
+ * agent compatibility.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const ContextFilesManifestSchema = Schema.Struct({
+    $schema: Schema.optional(Schema.String),
+    ...CommonManifestBaseFields,
+    ...NonPackManifestFields,
+    type: Schema.Literal("file"),
+    name: ExtensionNameSchema.pipe(Schema.annotateKey({ messageMissingKey: "context files package name is required" }), Schema.annotate({
+        description: "Short name for this context files package within its owner namespace. Combined with owner, forms the FQN @owner/files/<name>.",
+    })),
+    inputs: Schema.optional(FileInputDeclarationsMapSchema),
+    contents: Schema.Array(FileContentsEntrySchema)
+        .check(Schema.isMinLength(1))
+        .pipe(Schema.annotateKey({ messageMissingKey: "context files contents are required" })),
+}).annotate({
+    identifier: "ContextFilesManifest",
+    title: "Context Files Manifest",
+    description: "Context files manifest for structural workspace file distribution. Declares payload sources, inputs, and materialization targets.",
+});
+//# sourceMappingURL=manifest-schema.js.map

package/dist/src/unstable/context-files/manifest-schema.js.map

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

package/dist/src/unstable/context-files/markers.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Managed-region marker helpers for context files packages.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Option from "effect/Option";
+export type FileCommentStyle = {
+    readonly kind: "line";
+    readonly prefix: string;
+} | {
+    readonly kind: "block";
+    readonly open: string;
+    readonly close: string;
+};
+export interface FileRegionMarkerIdentity {
+    readonly region: string;
+    readonly ext?: string | undefined;
+    readonly generator?: string | undefined;
+}
+export type FileRegionMarkerKind = "start" | "end";
+export interface FileRegionMarker extends FileRegionMarkerIdentity {
+    readonly kind: FileRegionMarkerKind;
+}
+export interface ReplaceManagedRegionArgs {
+    readonly content: string;
+    readonly marker: FileRegionMarkerIdentity;
+    readonly rendered: string;
+    readonly style: FileCommentStyle;
+}
+/**
+ * Resolve native comment style for a managed-region target.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const commentStyleForTarget: (target: string) => Option.Option<FileCommentStyle>;
+/**
+ * Serialize a region marker in native comment syntax.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const serializeRegionMarker: (marker: FileRegionMarker, style: FileCommentStyle) => string;
+/**
+ * Parse a single marker line.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const parseRegionMarker: (line: string, style: FileCommentStyle) => Option.Option<FileRegionMarker>;
+/**
+ * Replace an existing managed region, or append it if absent.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const replaceManagedRegion: ({ content, marker, rendered, style, }: ReplaceManagedRegionArgs) => string;
+/**
+ * Strip an existing managed region. Missing regions are left unchanged.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const stripManagedRegion: (content: string, marker: FileRegionMarkerIdentity, style: FileCommentStyle) => string;
+//# sourceMappingURL=markers.d.ts.map

package/dist/src/unstable/context-files/markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markers.d.ts","sourceRoot":"","sources":["../../../../src/unstable/context-files/markers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9E,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,KAAK,CAAC;AAEnD,MAAM,WAAW,gBAAiB,SAAQ,wBAAwB;IAChE,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;CACrC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;CAClC;AAsCD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAgBpF,CAAC;AAYF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,gBAAgB,EACxB,OAAO,gBAAgB,KACtB,MAQF,CAAC;AAgBF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,OAAO,gBAAgB,KACtB,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAuBhC,CAAC;AAgDF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,uCAKlC,wBAAwB,KAAG,MAY7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,SAAS,MAAM,EACf,QAAQ,wBAAwB,EAChC,OAAO,gBAAgB,KACtB,MAMF,CAAC"}