@superblocksteam/shared 0.9603.3 → 0.9604.1

package/dist/database-lifecycle/capacityPolicy.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Agent tag key for proactive physical-instance capacity thresholds.
+ * Each value encodes one pool policy (see {@link encodeCapacityPolicyTag} /
+ * {@link parseCapacityPolicyTags}).
+ *
+ * Versioned wire format (pipe-delimited, one tag value per pool):
+ *   `v2|{encodedAgentName}|{engine}|{thresholdType}|{thresholdValue}`
+ *
+ * Example:
+ *   `v2|customer-opa|postgres|minAvailableCapacityPercent|20`
+ */
+export declare const DATABASE_LIFECYCLE_TAG_CAPACITY_POLICIES = "databaseLifecycle:capacityPolicies";
+export declare const DATABASE_ENGINES: readonly ["postgres", "snowflake", "snowflake_postgres", "lakebase"];
+export type DatabaseEngine = (typeof DATABASE_ENGINES)[number];
+export declare const PHYSICAL_DATABASE_CAPACITY_THRESHOLD_TYPES: readonly ["minAvailableCapacityPercent"];
+export type PhysicalDatabaseCapacityThresholdType = (typeof PHYSICAL_DATABASE_CAPACITY_THRESHOLD_TYPES)[number];
+export type PhysicalDatabaseCapacityPolicy = {
+    agentName: string;
+    engine: DatabaseEngine;
+    thresholdType: 'minAvailableCapacityPercent';
+    thresholdValue: number;
+};
+export type PhysicalDatabasePoolKey = {
+    organizationId: string;
+    agentName: string;
+    engine: DatabaseEngine;
+};
+export declare class CapacityPolicyValidationError extends Error {
+    readonly details: string[];
+    readonly code = "capacity_policy_invalid";
+    constructor(message: string, details?: string[]);
+}
+/** Stable idempotency and identity key for an organization physical pool. */
+export declare function computePhysicalDatabasePoolKey(pool: PhysicalDatabasePoolKey): string;
+export declare function encodeCapacityPolicyTag(policy: PhysicalDatabaseCapacityPolicy): string;
+/**
+ * Parse and validate capacity-policy tags. Fail closed: any malformed value
+ * throws {@link CapacityPolicyValidationError}. Missing tag key ⇒ empty list
+ * (no proactive provisioning for that agent).
+ */
+export declare function parseCapacityPolicyTags(published: string[] | undefined): PhysicalDatabaseCapacityPolicy[];
+/**
+ * Detect threshold disagreements for the same physical pool.
+ * Profile tags are routing metadata and do not participate in identity.
+ *
+ * Registration callers soft-skip peer conflicts (rolling threshold updates);
+ * the registering agent's own invalid tags still fail closed.
+ */
+export declare function validateCapacityPolicyCompatibility(candidatePolicies: readonly PhysicalDatabaseCapacityPolicy[], existingPolicies: readonly PhysicalDatabaseCapacityPolicy[]): void;
+export declare function parseCapacityPolicyTag(raw: string): PhysicalDatabaseCapacityPolicy;
+//# sourceMappingURL=capacityPolicy.d.ts.map

package/dist/database-lifecycle/capacityPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacityPolicy.d.ts","sourceRoot":"","sources":["../../src/database-lifecycle/capacityPolicy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,wCAAwC,uCAAuC,CAAC;AAE7F,eAAO,MAAM,gBAAgB,sEAAuE,CAAC;AACrG,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,eAAO,MAAM,0CAA0C,0CAA2C,CAAC;AACnG,MAAM,MAAM,qCAAqC,GAAG,CAAC,OAAO,0CAA0C,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC;IACvB,aAAa,EAAE,6BAA6B,CAAC;IAC7C,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF,qBAAa,6BAA8B,SAAQ,KAAK;IAKpD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE;IAJ5B,QAAQ,CAAC,IAAI,6BAA6B;gBAGxC,OAAO,EAAE,MAAM,EACN,OAAO,GAAE,MAAM,EAAO;CAKlC;AAED,6EAA6E;AAC7E,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,CAGpF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,8BAA8B,GAAG,MAAM,CAGtF;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,8BAA8B,EAAE,CAuCzG;AAED;;;;;;GAMG;AACH,wBAAgB,mCAAmC,CACjD,iBAAiB,EAAE,SAAS,8BAA8B,EAAE,EAC5D,gBAAgB,EAAE,SAAS,8BAA8B,EAAE,GAC1D,IAAI,CAsBN;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,8BAA8B,CAgDlF"}

package/dist/database-lifecycle/capacityPolicy.js

@@ -0,0 +1,159 @@
+"use strict";
+/**
+ * Agent tag key for proactive physical-instance capacity thresholds.
+ * Each value encodes one pool policy (see {@link encodeCapacityPolicyTag} /
+ * {@link parseCapacityPolicyTags}).
+ *
+ * Versioned wire format (pipe-delimited, one tag value per pool):
+ *   `v2|{encodedAgentName}|{engine}|{thresholdType}|{thresholdValue}`
+ *
+ * Example:
+ *   `v2|customer-opa|postgres|minAvailableCapacityPercent|20`
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CapacityPolicyValidationError = exports.PHYSICAL_DATABASE_CAPACITY_THRESHOLD_TYPES = exports.DATABASE_ENGINES = exports.DATABASE_LIFECYCLE_TAG_CAPACITY_POLICIES = void 0;
+exports.computePhysicalDatabasePoolKey = computePhysicalDatabasePoolKey;
+exports.encodeCapacityPolicyTag = encodeCapacityPolicyTag;
+exports.parseCapacityPolicyTags = parseCapacityPolicyTags;
+exports.validateCapacityPolicyCompatibility = validateCapacityPolicyCompatibility;
+exports.parseCapacityPolicyTag = parseCapacityPolicyTag;
+exports.DATABASE_LIFECYCLE_TAG_CAPACITY_POLICIES = 'databaseLifecycle:capacityPolicies';
+exports.DATABASE_ENGINES = ['postgres', 'snowflake', 'snowflake_postgres', 'lakebase'];
+exports.PHYSICAL_DATABASE_CAPACITY_THRESHOLD_TYPES = ['minAvailableCapacityPercent'];
+class CapacityPolicyValidationError extends Error {
+    details;
+    code = 'capacity_policy_invalid';
+    constructor(message, details = []) {
+        super(message);
+        this.details = details;
+        this.name = 'CapacityPolicyValidationError';
+    }
+}
+exports.CapacityPolicyValidationError = CapacityPolicyValidationError;
+/** Stable idempotency and identity key for an organization physical pool. */
+function computePhysicalDatabasePoolKey(pool) {
+    const agentName = normalizeCapacityPolicyAgentName(pool.agentName);
+    return ['provision_physical_database', encodeURIComponent(pool.organizationId), encodeURIComponent(agentName), pool.engine].join(':');
+}
+function encodeCapacityPolicyTag(policy) {
+    const agentName = normalizeCapacityPolicyAgentName(policy.agentName);
+    return ['v2', encodeURIComponent(agentName), policy.engine, policy.thresholdType, String(policy.thresholdValue)].join('|');
+}
+/**
+ * Parse and validate capacity-policy tags. Fail closed: any malformed value
+ * throws {@link CapacityPolicyValidationError}. Missing tag key ⇒ empty list
+ * (no proactive provisioning for that agent).
+ */
+function parseCapacityPolicyTags(published) {
+    if (published === undefined) {
+        return [];
+    }
+    if (!Array.isArray(published)) {
+        throw new CapacityPolicyValidationError('databaseLifecycle:capacityPolicies must be an array of policy strings.');
+    }
+    const policies = [];
+    const errors = [];
+    const seen = new Set();
+    for (const raw of published) {
+        if (typeof raw !== 'string' || raw.trim() === '') {
+            errors.push('capacity policy value must be a non-empty string');
+            continue;
+        }
+        try {
+            const policy = parseCapacityPolicyTag(raw);
+            const identity = JSON.stringify([policy.agentName, policy.engine]);
+            if (seen.has(identity)) {
+                errors.push(`duplicate capacity policy for pool ${identity}`);
+                continue;
+            }
+            seen.add(identity);
+            policies.push(policy);
+        }
+        catch (error) {
+            errors.push(error instanceof Error ? error.message : String(error));
+        }
+    }
+    if (errors.length > 0) {
+        throw new CapacityPolicyValidationError(`Invalid databaseLifecycle:capacityPolicies (${errors.length} error${errors.length === 1 ? '' : 's'}).`, errors);
+    }
+    return policies;
+}
+/**
+ * Detect threshold disagreements for the same physical pool.
+ * Profile tags are routing metadata and do not participate in identity.
+ *
+ * Registration callers soft-skip peer conflicts (rolling threshold updates);
+ * the registering agent's own invalid tags still fail closed.
+ */
+function validateCapacityPolicyCompatibility(candidatePolicies, existingPolicies) {
+    const errors = [];
+    for (const candidate of candidatePolicies) {
+        const candidateAgentName = normalizeCapacityPolicyAgentName(candidate.agentName);
+        for (const existing of existingPolicies) {
+            const existingAgentName = normalizeCapacityPolicyAgentName(existing.agentName);
+            if (candidate.engine !== existing.engine || candidateAgentName !== existingAgentName) {
+                continue;
+            }
+            if (candidate.thresholdValue !== existing.thresholdValue) {
+                errors.push(`different thresholds for pool ${JSON.stringify([candidateAgentName, candidate.engine])}: ${candidate.thresholdValue} and ${existing.thresholdValue}`);
+            }
+        }
+    }
+    if (errors.length > 0) {
+        throw new CapacityPolicyValidationError(`Conflicting databaseLifecycle:capacityPolicies (${errors.length} conflict${errors.length === 1 ? '' : 's'}): ${errors.join('; ')}`, errors);
+    }
+}
+function parseCapacityPolicyTag(raw) {
+    const parts = raw.split('|');
+    if (parts.length !== 5) {
+        throw new Error(`expected 5 pipe-delimited fields (version|agentName|engine|thresholdType|value), got ${parts.length} in ${JSON.stringify(raw)}`);
+    }
+    const [version, agentNameEncoded, engineRaw, thresholdTypeRaw, thresholdValueRaw] = parts;
+    if (version !== 'v2') {
+        throw new Error(`unsupported version ${JSON.stringify(version)}`);
+    }
+    if (!isKnownValue(engineRaw, exports.DATABASE_ENGINES)) {
+        throw new Error(`unknown engine ${JSON.stringify(engineRaw)}`);
+    }
+    if (!isKnownValue(thresholdTypeRaw, exports.PHYSICAL_DATABASE_CAPACITY_THRESHOLD_TYPES)) {
+        throw new Error(`unknown thresholdType ${JSON.stringify(thresholdTypeRaw)}`);
+    }
+    let decodedAgentName;
+    try {
+        decodedAgentName = decodeURIComponent(agentNameEncoded);
+    }
+    catch {
+        throw new Error(`agentName is not valid URI encoding: ${JSON.stringify(agentNameEncoded)}`);
+    }
+    const agentName = normalizeCapacityPolicyAgentName(decodedAgentName);
+    if (thresholdValueRaw.trim() === '' || !/^-?\d+$/.test(thresholdValueRaw)) {
+        throw new Error('thresholdValue must be a non-empty integer');
+    }
+    const thresholdValue = Number(thresholdValueRaw);
+    if (!Number.isSafeInteger(thresholdValue)) {
+        throw new Error(`thresholdValue must be an integer, got ${JSON.stringify(thresholdValueRaw)}`);
+    }
+    if (thresholdValue < 0) {
+        throw new Error(`thresholdValue must be >= 0, got ${thresholdValue}`);
+    }
+    if (thresholdValue > 100) {
+        throw new Error(`minAvailableCapacityPercent must be <= 100, got ${thresholdValue}`);
+    }
+    return {
+        agentName,
+        engine: engineRaw,
+        thresholdType: 'minAvailableCapacityPercent',
+        thresholdValue
+    };
+}
+function isKnownValue(value, known) {
+    return known.some((candidate) => candidate === value);
+}
+function normalizeCapacityPolicyAgentName(agentName) {
+    const normalized = agentName.trim();
+    if (normalized.length === 0) {
+        throw new CapacityPolicyValidationError('agentName must be non-empty after trimming.');
+    }
+    return normalized;
+}
+//# sourceMappingURL=capacityPolicy.js.map

package/dist/database-lifecycle/capacityPolicy.js.map

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

package/dist/database-lifecycle/capacityPolicy.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=capacityPolicy.test.d.ts.map

package/dist/database-lifecycle/capacityPolicy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacityPolicy.test.d.ts","sourceRoot":"","sources":["../../src/database-lifecycle/capacityPolicy.test.ts"],"names":[],"mappings":""}

package/dist/database-lifecycle/capacityPolicy.test.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const capacityPolicy_js_1 = require("./capacityPolicy.js");
+(0, vitest_1.describe)('capacity policy tags', () => {
+    (0, vitest_1.test)('round-trips percentage policies with trimmed case-sensitive agent names', () => {
+        const shared = {
+            agentName: 'Customer OPA',
+            engine: 'postgres',
+            thresholdType: 'minAvailableCapacityPercent',
+            thresholdValue: 20
+        };
+        (0, vitest_1.expect)((0, capacityPolicy_js_1.parseCapacityPolicyTag)((0, capacityPolicy_js_1.encodeCapacityPolicyTag)({
+            ...shared,
+            agentName: '  Customer OPA  '
+        }))).toEqual(shared);
+        (0, vitest_1.expect)((0, capacityPolicy_js_1.encodeCapacityPolicyTag)(shared)).toBe('v2|Customer%20OPA|postgres|minAvailableCapacityPercent|20');
+        (0, vitest_1.expect)((0, capacityPolicy_js_1.encodeCapacityPolicyTag)({ ...shared, agentName: 'customer opa' })).not.toBe((0, capacityPolicy_js_1.encodeCapacityPolicyTag)(shared));
+    });
+    (0, vitest_1.test)('parseCapacityPolicyTags returns empty when the tag is omitted', () => {
+        (0, vitest_1.expect)((0, capacityPolicy_js_1.parseCapacityPolicyTags)(undefined)).toEqual([]);
+    });
+    (0, vitest_1.test)('rejects unsupported versions, empty agent names, blank values, and out-of-range thresholds', () => {
+        const agentName = encodeURIComponent('customer-opa');
+        (0, vitest_1.expect)(() => (0, capacityPolicy_js_1.parseCapacityPolicyTag)(`v1|${agentName}|postgres|minAvailableCapacityPercent|20`)).toThrow(/unsupported version/);
+        (0, vitest_1.expect)(() => (0, capacityPolicy_js_1.parseCapacityPolicyTag)(`v2|%20%20|postgres|minAvailableCapacityPercent|20`)).toThrow(/agentName must be non-empty/);
+        (0, vitest_1.expect)(() => (0, capacityPolicy_js_1.parseCapacityPolicyTag)(`v2|${agentName}|postgres|minAvailableCapacityPercent|`)).toThrow(/thresholdValue must be a non-empty integer/);
+        (0, vitest_1.expect)(() => (0, capacityPolicy_js_1.parseCapacityPolicyTag)(`v2|${agentName}|postgres|minAvailableCapacityPercent|101`)).toThrow(/<= 100/);
+        (0, vitest_1.expect)(() => (0, capacityPolicy_js_1.parseCapacityPolicyTag)(`v2|${agentName}|postgres|minAvailableCapacityPercent|-1`)).toThrow(/>= 0/);
+        (0, vitest_1.expect)(() => (0, capacityPolicy_js_1.parseCapacityPolicyTag)(`v2|${agentName}|postgres|minEmptyPhysicalInstances|1`)).toThrow(/unknown thresholdType/);
+    });
+    (0, vitest_1.test)('parseCapacityPolicyTags fails closed on any invalid value', () => {
+        const valid = (0, capacityPolicy_js_1.encodeCapacityPolicyTag)({
+            agentName: 'customer-opa',
+            engine: 'postgres',
+            thresholdType: 'minAvailableCapacityPercent',
+            thresholdValue: 20
+        });
+        (0, vitest_1.expect)(() => (0, capacityPolicy_js_1.parseCapacityPolicyTags)([valid, 'not-a-policy'])).toThrow(capacityPolicy_js_1.CapacityPolicyValidationError);
+    });
+    (0, vitest_1.test)('rejects duplicate policies for the same agent name and engine', () => {
+        const first = (0, capacityPolicy_js_1.encodeCapacityPolicyTag)({
+            agentName: 'Customer OPA',
+            engine: 'postgres',
+            thresholdType: 'minAvailableCapacityPercent',
+            thresholdValue: 20
+        });
+        const duplicate = (0, capacityPolicy_js_1.encodeCapacityPolicyTag)({
+            agentName: ' Customer OPA ',
+            engine: 'postgres',
+            thresholdType: 'minAvailableCapacityPercent',
+            thresholdValue: 10
+        });
+        try {
+            (0, capacityPolicy_js_1.parseCapacityPolicyTags)([first, duplicate]);
+            vitest_1.expect.fail('Expected duplicate capacity policy validation to fail');
+        }
+        catch (error) {
+            (0, vitest_1.expect)(error).toBeInstanceOf(capacityPolicy_js_1.CapacityPolicyValidationError);
+            if (!(error instanceof capacityPolicy_js_1.CapacityPolicyValidationError)) {
+                throw error;
+            }
+            (0, vitest_1.expect)(error.details).toEqual([vitest_1.expect.stringContaining('duplicate capacity policy')]);
+        }
+    });
+    (0, vitest_1.test)('allows distinct agent names for the same engine', () => {
+        const first = (0, capacityPolicy_js_1.encodeCapacityPolicyTag)({
+            agentName: 'customer-opa-a',
+            engine: 'postgres',
+            thresholdType: 'minAvailableCapacityPercent',
+            thresholdValue: 20
+        });
+        const second = (0, capacityPolicy_js_1.encodeCapacityPolicyTag)({
+            agentName: 'customer-opa-b',
+            engine: 'postgres',
+            thresholdType: 'minAvailableCapacityPercent',
+            thresholdValue: 10
+        });
+        (0, vitest_1.expect)((0, capacityPolicy_js_1.parseCapacityPolicyTags)([first, second])).toHaveLength(2);
+    });
+    (0, vitest_1.test)('computePhysicalDatabasePoolKey is trimmed, case-sensitive, and delimiter-safe', () => {
+        (0, vitest_1.expect)((0, capacityPolicy_js_1.computePhysicalDatabasePoolKey)({
+            organizationId: 'org:1',
+            agentName: ' customer:opa ',
+            engine: 'postgres'
+        })).toBe((0, capacityPolicy_js_1.computePhysicalDatabasePoolKey)({
+            organizationId: 'org:1',
+            agentName: 'customer:opa',
+            engine: 'postgres'
+        }));
+        (0, vitest_1.expect)((0, capacityPolicy_js_1.computePhysicalDatabasePoolKey)({
+            organizationId: 'org:1',
+            agentName: 'customer:opa',
+            engine: 'postgres'
+        })).not.toBe((0, capacityPolicy_js_1.computePhysicalDatabasePoolKey)({
+            organizationId: 'org',
+            agentName: '1:customer:opa',
+            engine: 'postgres'
+        }));
+        (0, vitest_1.expect)((0, capacityPolicy_js_1.computePhysicalDatabasePoolKey)({
+            organizationId: 'org:1',
+            agentName: 'Customer:OPA',
+            engine: 'postgres'
+        })).not.toBe((0, capacityPolicy_js_1.computePhysicalDatabasePoolKey)({
+            organizationId: 'org:1',
+            agentName: 'customer:opa',
+            engine: 'postgres'
+        }));
+        (0, vitest_1.expect)(() => (0, capacityPolicy_js_1.computePhysicalDatabasePoolKey)({
+            organizationId: 'org:1',
+            agentName: '  ',
+            engine: 'postgres'
+        })).toThrow(/agentName must be non-empty/);
+    });
+    (0, vitest_1.test)('allows replicas to publish the same pool and threshold', () => {
+        const policy = {
+            agentName: 'customer-opa',
+            engine: 'postgres',
+            thresholdType: 'minAvailableCapacityPercent',
+            thresholdValue: 20
+        };
+        (0, vitest_1.expect)(() => (0, capacityPolicy_js_1.validateCapacityPolicyCompatibility)([policy], [{ ...policy }])).not.toThrow();
+    });
+    (0, vitest_1.test)('rejects different thresholds for the same pool', () => {
+        (0, vitest_1.expect)(() => (0, capacityPolicy_js_1.validateCapacityPolicyCompatibility)([
+            {
+                agentName: 'customer-opa',
+                engine: 'postgres',
+                thresholdType: 'minAvailableCapacityPercent',
+                thresholdValue: 20
+            }
+        ], [
+            {
+                agentName: 'customer-opa',
+                engine: 'postgres',
+                thresholdType: 'minAvailableCapacityPercent',
+                thresholdValue: 10
+            }
+        ])).toThrow(/different thresholds/);
+    });
+    (0, vitest_1.test)('allows different agent names and case-distinct agent names for the same engine', () => {
+        (0, vitest_1.expect)(() => (0, capacityPolicy_js_1.validateCapacityPolicyCompatibility)([
+            {
+                agentName: 'Customer OPA',
+                engine: 'postgres',
+                thresholdType: 'minAvailableCapacityPercent',
+                thresholdValue: 20
+            }
+        ], [
+            {
+                agentName: 'customer opa',
+                engine: 'postgres',
+                thresholdType: 'minAvailableCapacityPercent',
+                thresholdValue: 10
+            }
+        ])).not.toThrow();
+    });
+});
+//# sourceMappingURL=capacityPolicy.test.js.map

package/dist/database-lifecycle/capacityPolicy.test.js.map

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

package/dist/database-lifecycle/edit-lifecycle-capability.d.ts

@@ -0,0 +1,18 @@
+import { AgentStatus, type AgentTags } from '../types/organization/agent.js';
+export type AgentLifecycleTagSource = {
+    status?: AgentStatus | string;
+    tags?: AgentTags;
+};
+/**
+ * Whether an agent list shows Native DB opted in for provisioning.
+ *
+ * Coarse registration check for product advertising (Clark tools/prompts,
+ * UI Databases entry): an active agent must publish `ensure_database` and
+ * serve at least one profile. Profile-key resolution, engine support, and
+ * managed-IAM admission stay on the server at ensure/dispatch time — this
+ * helper does not re-encode that surface.
+ *
+ * Agents without a confirmed active status are excluded (fail closed).
+ */
+export declare function hasEditLifecycleCapability(agents: readonly AgentLifecycleTagSource[] | undefined): boolean;
+//# sourceMappingURL=edit-lifecycle-capability.d.ts.map

package/dist/database-lifecycle/edit-lifecycle-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-lifecycle-capability.d.ts","sourceRoot":"","sources":["../../src/database-lifecycle/edit-lifecycle-capability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAG7E,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAC9B,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,uBAAuB,EAAE,GAAG,SAAS,GAAG,OAAO,CAc1G"}

package/dist/database-lifecycle/edit-lifecycle-capability.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasEditLifecycleCapability = hasEditLifecycleCapability;
+const agent_js_1 = require("../types/organization/agent.js");
+const index_js_1 = require("./index.js");
+/**
+ * Whether an agent list shows Native DB opted in for provisioning.
+ *
+ * Coarse registration check for product advertising (Clark tools/prompts,
+ * UI Databases entry): an active agent must publish `ensure_database` and
+ * serve at least one profile. Profile-key resolution, engine support, and
+ * managed-IAM admission stay on the server at ensure/dispatch time — this
+ * helper does not re-encode that surface.
+ *
+ * Agents without a confirmed active status are excluded (fail closed).
+ */
+function hasEditLifecycleCapability(agents) {
+    if (!agents || agents.length === 0) {
+        return false;
+    }
+    return agents.some((agent) => {
+        if (agent.status === undefined || (agent.status !== agent_js_1.AgentStatus.ACTIVE && agent.status !== 'Active')) {
+            return false;
+        }
+        const operations = agent.tags?.[index_js_1.DATABASE_LIFECYCLE_TAG_OPERATIONS] ?? [];
+        if (!operations.includes('ensure_database')) {
+            return false;
+        }
+        return (agent.tags?.profile ?? []).length > 0;
+    });
+}
+//# sourceMappingURL=edit-lifecycle-capability.js.map

package/dist/database-lifecycle/edit-lifecycle-capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-lifecycle-capability.js","sourceRoot":"","sources":["../../src/database-lifecycle/edit-lifecycle-capability.ts"],"names":[],"mappings":";;AAmBA,gEAcC;AAjCD,6DAA6E;AAC7E,yCAA+D;AAO/D;;;;;;;;;;GAUG;AACH,SAAgB,0BAA0B,CAAC,MAAsD;IAC/F,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,sBAAW,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,EAAE,CAAC;YACrG,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,4CAAiC,CAAC,IAAI,EAAE,CAAC;QACzE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC5C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/database-lifecycle/edit-lifecycle-capability.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=edit-lifecycle-capability.test.d.ts.map

package/dist/database-lifecycle/edit-lifecycle-capability.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-lifecycle-capability.test.d.ts","sourceRoot":"","sources":["../../src/database-lifecycle/edit-lifecycle-capability.test.ts"],"names":[],"mappings":""}

package/dist/database-lifecycle/edit-lifecycle-capability.test.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const agent_js_1 = require("../types/organization/agent.js");
+const edit_lifecycle_capability_js_1 = require("./edit-lifecycle-capability.js");
+const index_js_1 = require("./index.js");
+(0, vitest_1.describe)('hasEditLifecycleCapability', () => {
+    (0, vitest_1.it)('is false when no agents are present', () => {
+        (0, vitest_1.expect)((0, edit_lifecycle_capability_js_1.hasEditLifecycleCapability)(undefined)).toBe(false);
+        (0, vitest_1.expect)((0, edit_lifecycle_capability_js_1.hasEditLifecycleCapability)([])).toBe(false);
+    });
+    (0, vitest_1.it)('is false when agents lack databaseLifecycle operations', () => {
+        (0, vitest_1.expect)((0, edit_lifecycle_capability_js_1.hasEditLifecycleCapability)([
+            {
+                status: agent_js_1.AgentStatus.ACTIVE,
+                tags: { profile: ['dev'] }
+            }
+        ])).toBe(false);
+    });
+    (0, vitest_1.it)('is false when the agent registers other operations but not ensure_database', () => {
+        (0, vitest_1.expect)((0, edit_lifecycle_capability_js_1.hasEditLifecycleCapability)([
+            {
+                status: agent_js_1.AgentStatus.ACTIVE,
+                tags: {
+                    [index_js_1.DATABASE_LIFECYCLE_TAG_OPERATIONS]: ['migrate_schema', 'retire_database'],
+                    profile: ['dev']
+                }
+            }
+        ])).toBe(false);
+    });
+    (0, vitest_1.it)('is false when ensure_database is registered but the agent serves no profile', () => {
+        (0, vitest_1.expect)((0, edit_lifecycle_capability_js_1.hasEditLifecycleCapability)([
+            {
+                status: agent_js_1.AgentStatus.ACTIVE,
+                tags: { [index_js_1.DATABASE_LIFECYCLE_TAG_OPERATIONS]: ['ensure_database', 'migrate_schema'] }
+            }
+        ])).toBe(false);
+        (0, vitest_1.expect)((0, edit_lifecycle_capability_js_1.hasEditLifecycleCapability)([
+            {
+                status: agent_js_1.AgentStatus.ACTIVE,
+                tags: { [index_js_1.DATABASE_LIFECYCLE_TAG_OPERATIONS]: ['ensure_database'], profile: [] }
+            }
+        ])).toBe(false);
+    });
+    (0, vitest_1.it)('is false when a disconnected agent has lifecycle tags', () => {
+        (0, vitest_1.expect)((0, edit_lifecycle_capability_js_1.hasEditLifecycleCapability)([
+            {
+                status: agent_js_1.AgentStatus.DISCONNECTED,
+                tags: { [index_js_1.DATABASE_LIFECYCLE_TAG_OPERATIONS]: ['ensure_database'], profile: ['dev'] }
+            }
+        ])).toBe(false);
+    });
+    (0, vitest_1.it)('is false when agent status is missing even if tags would otherwise qualify', () => {
+        (0, vitest_1.expect)((0, edit_lifecycle_capability_js_1.hasEditLifecycleCapability)([
+            {
+                tags: { [index_js_1.DATABASE_LIFECYCLE_TAG_OPERATIONS]: ['ensure_database'], profile: ['dev'] }
+            }
+        ])).toBe(false);
+    });
+    (0, vitest_1.it)('is true when an active agent registered ensure_database for any profile', () => {
+        (0, vitest_1.expect)((0, edit_lifecycle_capability_js_1.hasEditLifecycleCapability)([
+            {
+                status: agent_js_1.AgentStatus.ACTIVE,
+                tags: {
+                    [index_js_1.DATABASE_LIFECYCLE_TAG_OPERATIONS]: ['ensure_database', 'migrate_schema'],
+                    profile: ['staging', 'production']
+                }
+            }
+        ])).toBe(true);
+    });
+    // A production-only lifecycle agent still advertises Native DB. Editing is no
+    // longer a separate lifecycle axis, so there is no `edit:` pair to require —
+    // profile-key resolution stays on the server at ensure/dispatch time.
+    (0, vitest_1.it)('is true for an agent serving only production', () => {
+        (0, vitest_1.expect)((0, edit_lifecycle_capability_js_1.hasEditLifecycleCapability)([
+            {
+                status: agent_js_1.AgentStatus.ACTIVE,
+                tags: { [index_js_1.DATABASE_LIFECYCLE_TAG_OPERATIONS]: ['ensure_database'], profile: ['production'] }
+            }
+        ])).toBe(true);
+    });
+    (0, vitest_1.it)('is true when status is the string Active (CLI wire form)', () => {
+        (0, vitest_1.expect)((0, edit_lifecycle_capability_js_1.hasEditLifecycleCapability)([
+            {
+                status: 'Active',
+                tags: { [index_js_1.DATABASE_LIFECYCLE_TAG_OPERATIONS]: ['ensure_database'], profile: ['dev'] }
+            }
+        ])).toBe(true);
+    });
+});
+//# sourceMappingURL=edit-lifecycle-capability.test.js.map

package/dist/database-lifecycle/edit-lifecycle-capability.test.js.map

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