@xemahq/contracts 0.1.0

package/dist/provisioning/lib/provisioning.js

@@ -0,0 +1,221 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProvisioningScaffoldDefinitionSchema = exports.ProvisioningRecipeSchema = exports.ProvisioningAgentInstructionTemplateSchema = exports.ProvisioningFileOpTemplateSchema = exports.ProvisioningCommandTemplateSchema = exports.DEFAULT_PROVISIONING_VARIANT = exports.ProvisioningContractParseError = exports.ProvisioningPlanResultSchema = exports.ProvisioningStepResultSchema = exports.ProvisioningPendingCacheWriteSchema = exports.ResolvedProvisioningPlanSchema = exports.ResolvedProvisioningStepSchema = exports.ProvisioningGuardArgsSchema = exports.ProvisioningCacheRefSchema = exports.ProvisioningAgentInstructionSchema = exports.ProvisioningFileOpSchema = exports.ProvisioningCommandSpecSchema = exports.ProvisioningStepStatusSchema = exports.ProvisioningFileOpKindSchema = exports.ProvisioningTriggerSchema = exports.ProvisioningGuardSchema = exports.ProvisioningStepKindSchema = exports.SCAFFOLD_SAFE_NOISE = exports.ProvisioningStepStatus = exports.ProvisioningFileOpKind = exports.ProvisioningTrigger = exports.ProvisioningGuard = exports.ProvisioningStepKind = void 0;
+exports.parseResolvedProvisioningPlan = parseResolvedProvisioningPlan;
+exports.parseProvisioningPlanResult = parseProvisioningPlanResult;
+exports.parseProvisioningScaffoldDefinition = parseProvisioningScaffoldDefinition;
+const zod_1 = require("zod");
+var ProvisioningStepKind;
+(function (ProvisioningStepKind) {
+    ProvisioningStepKind["SCAFFOLD"] = "scaffold";
+    ProvisioningStepKind["EQUIP"] = "equip";
+})(ProvisioningStepKind || (exports.ProvisioningStepKind = ProvisioningStepKind = {}));
+var ProvisioningGuard;
+(function (ProvisioningGuard) {
+    ProvisioningGuard["REPO_EMPTY"] = "repo_empty";
+    ProvisioningGuard["PATH_ABSENT"] = "path_absent";
+    ProvisioningGuard["MARKER_ABSENT"] = "marker_absent";
+    ProvisioningGuard["ALWAYS"] = "always";
+})(ProvisioningGuard || (exports.ProvisioningGuard = ProvisioningGuard = {}));
+var ProvisioningTrigger;
+(function (ProvisioningTrigger) {
+    ProvisioningTrigger["WORKSPACE_BOOT"] = "workspace-boot";
+    ProvisioningTrigger["RUNTIME_REQUEST"] = "runtime-request";
+})(ProvisioningTrigger || (exports.ProvisioningTrigger = ProvisioningTrigger = {}));
+var ProvisioningFileOpKind;
+(function (ProvisioningFileOpKind) {
+    ProvisioningFileOpKind["WRITE"] = "write";
+    ProvisioningFileOpKind["MERGE_JSON"] = "merge-json";
+    ProvisioningFileOpKind["MERGE_YAML"] = "merge-yaml";
+})(ProvisioningFileOpKind || (exports.ProvisioningFileOpKind = ProvisioningFileOpKind = {}));
+var ProvisioningStepStatus;
+(function (ProvisioningStepStatus) {
+    ProvisioningStepStatus["SKIPPED"] = "skipped";
+    ProvisioningStepStatus["CACHE_HIT"] = "cache_hit";
+    ProvisioningStepStatus["BUILT"] = "built";
+})(ProvisioningStepStatus || (exports.ProvisioningStepStatus = ProvisioningStepStatus = {}));
+exports.SCAFFOLD_SAFE_NOISE = [
+    '.git',
+    '.gitignore',
+    'README.md',
+    'LICENSE',
+    '.xema',
+];
+exports.ProvisioningStepKindSchema = zod_1.z.enum(ProvisioningStepKind);
+exports.ProvisioningGuardSchema = zod_1.z.enum(ProvisioningGuard);
+exports.ProvisioningTriggerSchema = zod_1.z.enum(ProvisioningTrigger);
+exports.ProvisioningFileOpKindSchema = zod_1.z.enum(ProvisioningFileOpKind);
+exports.ProvisioningStepStatusSchema = zod_1.z.enum(ProvisioningStepStatus);
+exports.ProvisioningCommandSpecSchema = zod_1.z
+    .object({
+    argv: zod_1.z.array(zod_1.z.string().min(1)).min(1),
+    cwd: zod_1.z.string().min(1),
+    env: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional(),
+    timeoutMs: zod_1.z.number().int().positive(),
+})
+    .strict();
+exports.ProvisioningFileOpSchema = zod_1.z
+    .object({
+    kind: exports.ProvisioningFileOpKindSchema,
+    path: zod_1.z.string().min(1),
+    contentBase64: zod_1.z.string().min(1),
+})
+    .strict();
+exports.ProvisioningAgentInstructionSchema = zod_1.z
+    .object({
+    agentSlug: zod_1.z.string().min(1),
+    promptBase64: zod_1.z.string().min(1),
+})
+    .strict();
+exports.ProvisioningCacheRefSchema = zod_1.z
+    .object({
+    getUrl: zod_1.z.string().min(1),
+    getHeaders: zod_1.z.record(zod_1.z.string(), zod_1.z.string()),
+    putUrl: zod_1.z.string().min(1),
+    putHeaders: zod_1.z.record(zod_1.z.string(), zod_1.z.string()),
+})
+    .strict();
+exports.ProvisioningGuardArgsSchema = zod_1.z
+    .object({
+    markerJsonPointer: zod_1.z.string().min(1).optional(),
+    markerFile: zod_1.z.string().min(1).optional(),
+})
+    .strict();
+exports.ResolvedProvisioningStepSchema = zod_1.z
+    .object({
+    id: zod_1.z.string().min(1),
+    version: zod_1.z.string().min(1),
+    kind: exports.ProvisioningStepKindSchema,
+    guard: exports.ProvisioningGuardSchema,
+    guardArgs: exports.ProvisioningGuardArgsSchema.optional(),
+    targetDir: zod_1.z.string().min(1),
+    cacheKey: zod_1.z.string().min(1).nullable(),
+    cache: exports.ProvisioningCacheRefSchema.optional(),
+    commands: zod_1.z.array(exports.ProvisioningCommandSpecSchema),
+    fileOps: zod_1.z.array(exports.ProvisioningFileOpSchema),
+    agentInstruction: exports.ProvisioningAgentInstructionSchema.optional(),
+})
+    .strict();
+exports.ResolvedProvisioningPlanSchema = zod_1.z
+    .object({
+    version: zod_1.z.literal(1),
+    sessionId: zod_1.z.string().min(1),
+    steps: zod_1.z.array(exports.ResolvedProvisioningStepSchema),
+})
+    .strict();
+exports.ProvisioningPendingCacheWriteSchema = zod_1.z
+    .object({
+    sourceDir: zod_1.z.string().min(1),
+    cacheRef: exports.ProvisioningCacheRefSchema,
+})
+    .strict();
+exports.ProvisioningStepResultSchema = zod_1.z
+    .object({
+    id: zod_1.z.string().min(1),
+    status: exports.ProvisioningStepStatusSchema,
+    pendingAgentInstruction: exports.ProvisioningAgentInstructionSchema.optional(),
+    pendingCacheWrite: exports.ProvisioningPendingCacheWriteSchema.optional(),
+})
+    .strict();
+exports.ProvisioningPlanResultSchema = zod_1.z
+    .object({
+    version: zod_1.z.literal(1),
+    sessionId: zod_1.z.string().min(1),
+    steps: zod_1.z.array(exports.ProvisioningStepResultSchema),
+    pendingAgentInstructions: zod_1.z.array(exports.ProvisioningAgentInstructionSchema),
+})
+    .strict();
+class ProvisioningContractParseError extends Error {
+    issues;
+    constructor(what, issues) {
+        super(`Invalid ${what}: ${issues
+            .map((i) => `[${i.path.join('.')}] ${i.message}`)
+            .join('; ')}`);
+        this.name = 'ProvisioningContractParseError';
+        this.issues = issues;
+    }
+}
+exports.ProvisioningContractParseError = ProvisioningContractParseError;
+function parseResolvedProvisioningPlan(raw) {
+    const result = exports.ResolvedProvisioningPlanSchema.safeParse(raw);
+    if (!result.success) {
+        throw new ProvisioningContractParseError('ResolvedProvisioningPlan', result.error.issues);
+    }
+    return result.data;
+}
+function parseProvisioningPlanResult(raw) {
+    const result = exports.ProvisioningPlanResultSchema.safeParse(raw);
+    if (!result.success) {
+        throw new ProvisioningContractParseError('ProvisioningPlanResult', result.error.issues);
+    }
+    return result.data;
+}
+exports.DEFAULT_PROVISIONING_VARIANT = 'default';
+exports.ProvisioningCommandTemplateSchema = zod_1.z
+    .object({
+    argv: zod_1.z.array(zod_1.z.string().min(1)).min(1),
+    cwd: zod_1.z.string().min(1),
+    env: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional(),
+    timeoutMs: zod_1.z.number().int().positive(),
+})
+    .strict();
+exports.ProvisioningFileOpTemplateSchema = zod_1.z
+    .object({
+    kind: exports.ProvisioningFileOpKindSchema,
+    path: zod_1.z.string().min(1),
+    templateRef: zod_1.z.string().min(1),
+})
+    .strict();
+exports.ProvisioningAgentInstructionTemplateSchema = zod_1.z
+    .object({
+    agentSlug: zod_1.z.string().min(1),
+    promptTemplateRef: zod_1.z.string().min(1),
+})
+    .strict();
+exports.ProvisioningRecipeSchema = zod_1.z
+    .object({
+    commands: zod_1.z.array(exports.ProvisioningCommandTemplateSchema),
+    fileOps: zod_1.z.array(exports.ProvisioningFileOpTemplateSchema).default([]),
+    agentInstruction: exports.ProvisioningAgentInstructionTemplateSchema.optional(),
+})
+    .strict();
+exports.ProvisioningScaffoldDefinitionSchema = zod_1.z
+    .object({
+    id: zod_1.z
+        .string()
+        .min(1)
+        .regex(/^[a-z][a-z0-9-]*$/, 'scaffold id must be lowercase kebab-case and match the provisioning/<id>.yaml basename'),
+    scaffoldVersion: zod_1.z.string().min(1),
+    targetDir: zod_1.z.string().min(1),
+    variantField: zod_1.z.string().min(1).optional(),
+    variants: zod_1.z.record(zod_1.z.string().min(1), exports.ProvisioningRecipeSchema),
+})
+    .strict()
+    .superRefine((value, ctx) => {
+    const variantKeys = Object.keys(value.variants);
+    if (variantKeys.length === 0) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['variants'],
+            message: 'a scaffold must declare at least one variant',
+        });
+        return;
+    }
+    if (!value.variantField &&
+        (variantKeys.length !== 1 ||
+            variantKeys[0] !== exports.DEFAULT_PROVISIONING_VARIANT)) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['variants'],
+            message: `a scaffold with no \`variantField\` must declare exactly one variant under the "${exports.DEFAULT_PROVISIONING_VARIANT}" key`,
+        });
+    }
+});
+function parseProvisioningScaffoldDefinition(raw) {
+    const result = exports.ProvisioningScaffoldDefinitionSchema.safeParse(raw);
+    if (!result.success) {
+        throw new ProvisioningContractParseError('ProvisioningScaffoldDefinition', result.error.issues);
+    }
+    return result.data;
+}
+//# sourceMappingURL=provisioning.js.map

package/dist/provisioning/lib/provisioning.js.map

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

package/dist/reference-resolution/index.d.ts

@@ -0,0 +1,2 @@
+export * from './lib/reference-resolution';
+//# sourceMappingURL=index.d.ts.map

package/dist/reference-resolution/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reference-resolution/index.ts"],"names":[],"mappings":"AASA,cAAc,4BAA4B,CAAC"}

package/dist/reference-resolution/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./lib/reference-resolution"), exports);
+//# sourceMappingURL=index.js.map

package/dist/reference-resolution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/reference-resolution/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AASA,6DAA2C"}

package/dist/reference-resolution/lib/reference-resolution.d.ts

@@ -0,0 +1,40 @@
+export declare enum MissingReferencePolicy {
+    Required = "required",
+    Optional = "optional"
+}
+export declare enum ReferenceResolutionState {
+    Present = "present",
+    DeclaredButUnavailable = "declared-but-unavailable",
+    OptionalSkipped = "optional-skipped",
+    Denied = "denied"
+}
+export declare enum ReferenceKind {
+    Agent = "agent",
+    Skill = "skill",
+    Tool = "tool",
+    Capability = "capability",
+    Action = "action",
+    Workflow = "workflow"
+}
+export declare enum ReferenceVerification {
+    Verified = "verified",
+    RegistryOnly = "registry-only",
+    GatewayOnly = "gateway-only",
+    Unavailable = "unavailable"
+}
+export interface ReferenceOwner {
+    readonly biomeId?: string;
+    readonly biomeVersion?: string;
+}
+export interface ResolvedReferenceDecision {
+    readonly kind: ReferenceKind;
+    readonly ref: string;
+    readonly version?: string;
+    readonly policy: MissingReferencePolicy;
+    readonly state: ReferenceResolutionState;
+    readonly verification?: ReferenceVerification;
+    readonly owner?: ReferenceOwner;
+    readonly reason: string;
+}
+export declare function isFatalReferenceDecision(decision: ResolvedReferenceDecision): boolean;
+//# sourceMappingURL=reference-resolution.d.ts.map

package/dist/reference-resolution/lib/reference-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-resolution.d.ts","sourceRoot":"","sources":["../../../src/reference-resolution/lib/reference-resolution.ts"],"names":[],"mappings":"AAqCA,oBAAY,sBAAsB;IAKhC,QAAQ,aAAa;IAMrB,QAAQ,aAAa;CACtB;AAMD,oBAAY,wBAAwB;IAElC,OAAO,YAAY;IAOnB,sBAAsB,6BAA6B;IAMnD,eAAe,qBAAqB;IAMpC,MAAM,WAAW;CAClB;AAOD,oBAAY,aAAa;IAEvB,KAAK,UAAU;IAEf,KAAK,UAAU;IAEf,IAAI,SAAS;IAEb,UAAU,eAAe;IAEzB,MAAM,WAAW;IAEjB,QAAQ,aAAa;CACtB;AASD,oBAAY,qBAAqB;IAE/B,QAAQ,aAAa;IAErB,YAAY,kBAAkB;IAE9B,WAAW,iBAAiB;IAE5B,WAAW,gBAAgB;CAC5B;AAWD,MAAM,WAAW,cAAc;IAE7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAQD,MAAM,WAAW,yBAAyB;IAExC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAE7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IAExC,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;IAEzC,QAAQ,CAAC,YAAY,CAAC,EAAE,qBAAqB,CAAC;IAE9C,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;IAEhC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAUD,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,yBAAyB,GAClC,OAAO,CAQT"}

package/dist/reference-resolution/lib/reference-resolution.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReferenceVerification = exports.ReferenceKind = exports.ReferenceResolutionState = exports.MissingReferencePolicy = void 0;
+exports.isFatalReferenceDecision = isFatalReferenceDecision;
+var MissingReferencePolicy;
+(function (MissingReferencePolicy) {
+    MissingReferencePolicy["Required"] = "required";
+    MissingReferencePolicy["Optional"] = "optional";
+})(MissingReferencePolicy || (exports.MissingReferencePolicy = MissingReferencePolicy = {}));
+var ReferenceResolutionState;
+(function (ReferenceResolutionState) {
+    ReferenceResolutionState["Present"] = "present";
+    ReferenceResolutionState["DeclaredButUnavailable"] = "declared-but-unavailable";
+    ReferenceResolutionState["OptionalSkipped"] = "optional-skipped";
+    ReferenceResolutionState["Denied"] = "denied";
+})(ReferenceResolutionState || (exports.ReferenceResolutionState = ReferenceResolutionState = {}));
+var ReferenceKind;
+(function (ReferenceKind) {
+    ReferenceKind["Agent"] = "agent";
+    ReferenceKind["Skill"] = "skill";
+    ReferenceKind["Tool"] = "tool";
+    ReferenceKind["Capability"] = "capability";
+    ReferenceKind["Action"] = "action";
+    ReferenceKind["Workflow"] = "workflow";
+})(ReferenceKind || (exports.ReferenceKind = ReferenceKind = {}));
+var ReferenceVerification;
+(function (ReferenceVerification) {
+    ReferenceVerification["Verified"] = "verified";
+    ReferenceVerification["RegistryOnly"] = "registry-only";
+    ReferenceVerification["GatewayOnly"] = "gateway-only";
+    ReferenceVerification["Unavailable"] = "unavailable";
+})(ReferenceVerification || (exports.ReferenceVerification = ReferenceVerification = {}));
+function isFatalReferenceDecision(decision) {
+    if (decision.state === ReferenceResolutionState.Denied) {
+        return true;
+    }
+    if (decision.state === ReferenceResolutionState.DeclaredButUnavailable) {
+        return decision.policy !== MissingReferencePolicy.Optional;
+    }
+    return false;
+}
+//# sourceMappingURL=reference-resolution.js.map

package/dist/reference-resolution/lib/reference-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-resolution.js","sourceRoot":"","sources":["../../../src/reference-resolution/lib/reference-resolution.ts"],"names":[],"mappings":";;;AAsKA,4DAUC;AA3ID,IAAY,sBAYX;AAZD,WAAY,sBAAsB;IAKhC,+CAAqB,CAAA;IAMrB,+CAAqB,CAAA;AACvB,CAAC,EAZW,sBAAsB,sCAAtB,sBAAsB,QAYjC;AAMD,IAAY,wBAsBX;AAtBD,WAAY,wBAAwB;IAElC,+CAAmB,CAAA;IAOnB,+EAAmD,CAAA;IAMnD,gEAAoC,CAAA;IAMpC,6CAAiB,CAAA;AACnB,CAAC,EAtBW,wBAAwB,wCAAxB,wBAAwB,QAsBnC;AAOD,IAAY,aAaX;AAbD,WAAY,aAAa;IAEvB,gCAAe,CAAA;IAEf,gCAAe,CAAA;IAEf,8BAAa,CAAA;IAEb,0CAAyB,CAAA;IAEzB,kCAAiB,CAAA;IAEjB,sCAAqB,CAAA;AACvB,CAAC,EAbW,aAAa,6BAAb,aAAa,QAaxB;AASD,IAAY,qBASX;AATD,WAAY,qBAAqB;IAE/B,8CAAqB,CAAA;IAErB,uDAA8B,CAAA;IAE9B,qDAA4B,CAAA;IAE5B,oDAA2B,CAAA;AAC7B,CAAC,EATW,qBAAqB,qCAArB,qBAAqB,QAShC;AAmDD,SAAgB,wBAAwB,CACtC,QAAmC;IAEnC,IAAI,QAAQ,CAAC,KAAK,KAAK,wBAAwB,CAAC,MAAM,EAAE,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,KAAK,wBAAwB,CAAC,sBAAsB,EAAE,CAAC;QACvE,OAAO,QAAQ,CAAC,MAAM,KAAK,sBAAsB,CAAC,QAAQ,CAAC;IAC7D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/resource/index.d.ts

@@ -0,0 +1,11 @@
+export * from './lib/resource-kind';
+export * from './lib/resource-managed-by';
+export * from './lib/resource-declaration';
+export * from './lib/xema-manifest';
+export * from './lib/stack';
+export * from './lib/plan';
+export * from './lib/resource-ownership-contribution';
+export * from './lib/resource-ref';
+export * from './lib/resource-kind-descriptor';
+export * from './lib/resource-kind-registry';
+//# sourceMappingURL=index.d.ts.map

package/dist/resource/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resource/index.ts"],"names":[],"mappings":"AA2BA,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,uCAAuC,CAAC;AACtD,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC"}

package/dist/resource/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./lib/resource-kind"), exports);
+__exportStar(require("./lib/resource-managed-by"), exports);
+__exportStar(require("./lib/resource-declaration"), exports);
+__exportStar(require("./lib/xema-manifest"), exports);
+__exportStar(require("./lib/stack"), exports);
+__exportStar(require("./lib/plan"), exports);
+__exportStar(require("./lib/resource-ownership-contribution"), exports);
+__exportStar(require("./lib/resource-ref"), exports);
+__exportStar(require("./lib/resource-kind-descriptor"), exports);
+__exportStar(require("./lib/resource-kind-registry"), exports);
+//# sourceMappingURL=index.js.map

package/dist/resource/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resource/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AA2BA,sDAAoC;AACpC,4DAA0C;AAC1C,6DAA2C;AAC3C,sDAAoC;AACpC,8CAA4B;AAC5B,6CAA2B;AAC3B,wEAAsD;AACtD,qDAAmC;AACnC,iEAA+C;AAC/C,+DAA6C"}

package/dist/resource/lib/plan.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { XemaResourceKind } from './resource-kind';
+export declare enum ResourceChangeAction {
+    Create = "create",
+    Update = "update",
+    Replace = "replace",
+    Delete = "delete",
+    NoOp = "noop"
+}
+export declare const ResourceChangeActionSchema: z.ZodEnum<typeof ResourceChangeAction>;
+export interface ResourceFieldDiff {
+    from: unknown;
+    to: unknown;
+}
+export declare const ResourceFieldDiffSchema: z.ZodType<ResourceFieldDiff>;
+export interface ResourceChange {
+    kind: XemaResourceKind;
+    logicalId: string;
+    action: ResourceChangeAction;
+    physicalId?: string;
+    driftFromActual?: boolean;
+    diff?: Record<string, ResourceFieldDiff>;
+}
+export declare const ResourceChangeSchema: z.ZodType<ResourceChange>;
+export interface ResourcePlan {
+    stackName: string;
+    changes: readonly ResourceChange[];
+    driftDetected: boolean;
+}
+export declare const ResourcePlanSchema: z.ZodType<ResourcePlan>;
+//# sourceMappingURL=plan.d.ts.map

package/dist/resource/lib/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/resource/lib/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAA0B,MAAM,iBAAiB,CAAC;AAa3E,oBAAY,oBAAoB;IAC9B,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AAED,eAAO,MAAM,0BAA0B,wCAAqC,CAAC;AAM7E,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,OAAO,CAAC;CACb;AAED,eAAO,MAAM,uBAAuB,EAG9B,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAWnC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,gBAAgB,CAAC;IAEvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,oBAAoB,CAAC;IAE7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC1C;AAED,eAAO,MAAM,oBAAoB,EAO3B,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;AAOhC,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,kBAAkB,EAIzB,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC"}

package/dist/resource/lib/plan.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourcePlanSchema = exports.ResourceChangeSchema = exports.ResourceFieldDiffSchema = exports.ResourceChangeActionSchema = exports.ResourceChangeAction = void 0;
+const zod_1 = require("zod");
+const resource_kind_1 = require("./resource-kind");
+var ResourceChangeAction;
+(function (ResourceChangeAction) {
+    ResourceChangeAction["Create"] = "create";
+    ResourceChangeAction["Update"] = "update";
+    ResourceChangeAction["Replace"] = "replace";
+    ResourceChangeAction["Delete"] = "delete";
+    ResourceChangeAction["NoOp"] = "noop";
+})(ResourceChangeAction || (exports.ResourceChangeAction = ResourceChangeAction = {}));
+exports.ResourceChangeActionSchema = zod_1.z.nativeEnum(ResourceChangeAction);
+exports.ResourceFieldDiffSchema = zod_1.z.object({
+    from: zod_1.z.unknown(),
+    to: zod_1.z.unknown(),
+});
+exports.ResourceChangeSchema = zod_1.z.object({
+    kind: resource_kind_1.XemaResourceKindSchema,
+    logicalId: zod_1.z.string().min(1),
+    action: exports.ResourceChangeActionSchema,
+    physicalId: zod_1.z.string().min(1).optional(),
+    driftFromActual: zod_1.z.boolean().optional(),
+    diff: zod_1.z.record(zod_1.z.string(), exports.ResourceFieldDiffSchema).optional(),
+});
+exports.ResourcePlanSchema = zod_1.z.object({
+    stackName: zod_1.z.string().min(1),
+    changes: zod_1.z.array(exports.ResourceChangeSchema).readonly(),
+    driftDetected: zod_1.z.boolean(),
+});
+//# sourceMappingURL=plan.js.map

package/dist/resource/lib/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../src/resource/lib/plan.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,mDAA2E;AAa3E,IAAY,oBAMX;AAND,WAAY,oBAAoB;IAC9B,yCAAiB,CAAA;IACjB,yCAAiB,CAAA;IACjB,2CAAmB,CAAA;IACnB,yCAAiB,CAAA;IACjB,qCAAa,CAAA;AACf,CAAC,EANW,oBAAoB,oCAApB,oBAAoB,QAM/B;AAEY,QAAA,0BAA0B,GAAG,OAAC,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;AAWhE,QAAA,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,OAAC,CAAC,OAAO,EAAE;IACjB,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE;CAChB,CAAiC,CAAC;AAsBtB,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,sCAAsB;IAC5B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,MAAM,EAAE,kCAA0B;IAClC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,eAAe,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACvC,IAAI,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,+BAAuB,CAAC,CAAC,QAAQ,EAAE;CAC/D,CAA8B,CAAC;AAanB,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,4BAAoB,CAAC,CAAC,QAAQ,EAAE;IACjD,aAAa,EAAE,OAAC,CAAC,OAAO,EAAE;CAC3B,CAA4B,CAAC"}

package/dist/resource/lib/resource-declaration.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import { XemaResourceKind } from './resource-kind';
+export type ResourceLogicalRef = string;
+export interface ResourceDeclaration {
+    kind: XemaResourceKind;
+    id: string;
+    managedKey?: string;
+    dependsOn?: readonly ResourceLogicalRef[];
+    spec: Record<string, unknown>;
+}
+export declare const ResourceLogicalRefSchema: z.ZodString;
+export declare const ResourceDeclarationSchema: z.ZodType<ResourceDeclaration>;
+export declare function logicalRefOf(decl: Pick<ResourceDeclaration, 'kind' | 'id'>): ResourceLogicalRef;
+export declare function managedKeyOf(decl: ResourceDeclaration): string;
+//# sourceMappingURL=resource-declaration.d.ts.map

package/dist/resource/lib/resource-declaration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-declaration.d.ts","sourceRoot":"","sources":["../../../src/resource/lib/resource-declaration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAA0B,MAAM,iBAAiB,CAAC;AAO3E,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAiBxC,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,gBAAgB,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAID,eAAO,MAAM,wBAAwB,aAEnC,CAAC;AAEH,eAAO,MAAM,yBAAyB,EAYhC,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAGrC,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC,GAC7C,kBAAkB,CAEpB;AAGD,wBAAgB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAE9D"}

package/dist/resource/lib/resource-declaration.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceDeclarationSchema = exports.ResourceLogicalRefSchema = void 0;
+exports.logicalRefOf = logicalRefOf;
+exports.managedKeyOf = managedKeyOf;
+const zod_1 = require("zod");
+const resource_kind_1 = require("./resource-kind");
+const LOGICAL_REF_RE = /^[a-z0-9-]+\.[A-Za-z0-9._-]+$/;
+exports.ResourceLogicalRefSchema = zod_1.z.string().regex(LOGICAL_REF_RE, {
+    message: 'A resource ref must be "<kind>.<id>" (e.g. "project.web-app").',
+});
+exports.ResourceDeclarationSchema = zod_1.z.object({
+    kind: resource_kind_1.XemaResourceKindSchema,
+    id: zod_1.z
+        .string()
+        .min(1)
+        .regex(/^[A-Za-z0-9._-]+$/, {
+        message: 'ResourceDeclaration.id must be a stable slug ([A-Za-z0-9._-]+).',
+    }),
+    managedKey: zod_1.z.string().min(1).optional(),
+    dependsOn: zod_1.z.array(exports.ResourceLogicalRefSchema).readonly().optional(),
+    spec: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
+});
+function logicalRefOf(decl) {
+    return `${decl.kind}.${decl.id}`;
+}
+function managedKeyOf(decl) {
+    return decl.managedKey ?? decl.id;
+}
+//# sourceMappingURL=resource-declaration.js.map

package/dist/resource/lib/resource-declaration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-declaration.js","sourceRoot":"","sources":["../../../src/resource/lib/resource-declaration.ts"],"names":[],"mappings":";;;AAsDA,oCAIC;AAGD,oCAEC;AA/DD,6BAAwB;AACxB,mDAA2E;AAgC3E,MAAM,cAAc,GAAG,+BAA+B,CAAC;AAE1C,QAAA,wBAAwB,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE;IACvE,OAAO,EAAE,gEAAgE;CAC1E,CAAC,CAAC;AAEU,QAAA,yBAAyB,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,sCAAsB;IAC5B,EAAE,EAAE,OAAC;SACF,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,KAAK,CAAC,mBAAmB,EAAE;QAC1B,OAAO,EACL,iEAAiE;KACpE,CAAC;IACJ,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,gCAAwB,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAClE,IAAI,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC;CACxC,CAAmC,CAAC;AAGrC,SAAgB,YAAY,CAC1B,IAA8C;IAE9C,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;AACnC,CAAC;AAGD,SAAgB,YAAY,CAAC,IAAyB;IACpD,OAAO,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,EAAE,CAAC;AACpC,CAAC"}

package/dist/resource/lib/resource-kind-descriptor.d.ts

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+import { SpaceKind, type SpaceKindSubset } from '../../space';
+import { ResourceVisibilityPattern } from './resource-ownership-contribution';
+export declare const SHARE_LEVEL_SLOT_MIN = 1;
+export declare const SHARE_LEVEL_SLOT_MAX = 3;
+export declare const SHARE_SLUG_PATTERN: RegExp;
+export declare const RESOURCE_KIND_PATTERN: RegExp;
+export declare enum ShareChannel {
+    Direct = "direct",
+    Link = "link",
+    ExternalSubject = "external-subject"
+}
+export declare const ShareChannelSchema: z.ZodEnum<typeof ShareChannel>;
+export declare const SHARE_CHANNELS: readonly ShareChannel[];
+export declare enum ShareLevelErrorCode {
+    Unknown = "SHARE_LEVEL_UNKNOWN",
+    Amplified = "SHARE_LEVEL_AMPLIFIED",
+    ChannelCapped = "SHARE_LEVEL_CHANNEL_CAPPED",
+    ChannelRefused = "SHARE_LEVEL_CHANNEL_REFUSED",
+    ResharForbidden = "SHARE_LEVEL_RESHARE_FORBIDDEN"
+}
+export declare class ShareLevelError extends Error {
+    readonly code: ShareLevelErrorCode;
+    readonly kind: string;
+    constructor(code: ShareLevelErrorCode, kind: string, message: string);
+}
+export interface ShareLevel {
+    readonly name: string;
+    readonly slot: number;
+    readonly verbs: readonly string[];
+}
+export declare const ShareLevelSchema: z.ZodObject<{
+    name: z.ZodString;
+    slot: z.ZodNumber;
+    verbs: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export interface ResourceKindDescriptor {
+    readonly kind: string;
+    readonly ownerSpaceKinds: SpaceKindSubset;
+    readonly verbs: readonly string[];
+    readonly shareLevels: readonly ShareLevel[];
+    readonly maxLevelByChannel: Readonly<Record<ShareChannel, string | null>>;
+    readonly minReshareLevel: string | null;
+    readonly visibilityDefault: ResourceVisibilityPattern;
+}
+export interface ResourceKindDescriptorInput {
+    readonly kind: string;
+    readonly ownerSpaceKinds: readonly SpaceKind[];
+    readonly verbs: readonly string[];
+    readonly shareLevels: readonly ShareLevel[];
+    readonly maxLevelByChannel?: Readonly<Partial<Record<ShareChannel, string | null>>>;
+    readonly minReshareLevel?: string | null;
+    readonly visibilityDefault: ResourceVisibilityPattern;
+}
+export declare const ResourceKindDescriptorInputSchema: z.ZodObject<{
+    kind: z.ZodString;
+    ownerSpaceKinds: z.ZodArray<z.ZodEnum<typeof SpaceKind>>;
+    verbs: z.ZodArray<z.ZodString>;
+    shareLevels: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        slot: z.ZodNumber;
+        verbs: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    maxLevelByChannel: z.ZodOptional<z.ZodObject<{
+        direct: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        link: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        "external-subject": z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>;
+    minReshareLevel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    visibilityDefault: z.ZodEnum<typeof ResourceVisibilityPattern>;
+}, z.core.$strict>;
+export declare function defineResourceKind(input: ResourceKindDescriptorInput): ResourceKindDescriptor;
+export declare function shareLevelSlot(descriptor: ResourceKindDescriptor, name: string): number;
+export declare function lowestShareLevel(descriptor: ResourceKindDescriptor): ShareLevel;
+export declare function highestShareLevel(descriptor: ResourceKindDescriptor): ShareLevel;
+export declare function shareLevelVerbs(descriptor: ResourceKindDescriptor, name: string): readonly string[];
+export declare function shareLevelWithin(descriptor: ResourceKindDescriptor, candidate: string, ceiling: string): boolean;
+export declare function assertShareLevelDelegable(descriptor: ResourceKindDescriptor, grantorLevel: string | null, requestedLevel: string): void;
+export declare function assertShareLevelReshareable(descriptor: ResourceKindDescriptor, grantorLevel: string | null): void;
+export declare function assertShareLevelReachableByChannel(descriptor: ResourceKindDescriptor, requestedLevel: string, channel: ShareChannel): void;
+export declare function assertResourceKindOwnerSpace(descriptor: ResourceKindDescriptor, kind: SpaceKind): void;
+//# sourceMappingURL=resource-kind-descriptor.d.ts.map

package/dist/resource/lib/resource-kind-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-kind-descriptor.d.ts","sourceRoot":"","sources":["../../../src/resource/lib/resource-kind-descriptor.ts"],"names":[],"mappings":"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"}