jishushell 0.6.5 → 0.6.18

package/dist/services/app-common/instance-store.js

@@ -0,0 +1,495 @@
+import { createHash } from "node:crypto";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { parse } from "yaml";
+import { ensureDirHost } from "../../utils/fs.js";
+import { safeReadJson, safeWriteJson } from "../../utils/safe-json.js";
+import { normalizeSingleIntegrationRef, resolveIntegrationRefsFromMetadata, } from "./integration-refs.js";
+import { DEFINITION_FILENAME, INSTANCE_METADATA_FILENAME, MANIFEST_FILENAME, RESOLVED_SPEC_FILENAME, resolveAppDir, } from "./paths.js";
+export const APP_INSTANCE_SCHEMA_VERSION = 3;
+export const APP_INSTANCE_MIGRATION_ID = "canonical-instance-v3";
+export const APP_MANIFEST_SCHEMA_VERSION = 1;
+export class CanonicalManifestRequiredError extends Error {
+    code = "INSTANCE_MANIFEST_NEEDS_MIGRATION";
+    constructor(instanceId, reason) {
+        super(`Instance '${instanceId}' has no valid canonical manifest: ${reason}. `
+            + "Run the legacy migrator or repair flow before using normal lifecycle operations.");
+        this.name = "CanonicalManifestRequiredError";
+    }
+}
+export class CanonicalInstanceRequiredError extends Error {
+    code = "INSTANCE_METADATA_NEEDS_MIGRATION";
+    constructor(instanceId, reason) {
+        super(`Instance '${instanceId}' has no valid canonical instance metadata: ${reason}. `
+            + "Run the legacy migrator or repair flow before using normal lifecycle operations.");
+        this.name = "CanonicalInstanceRequiredError";
+    }
+}
+function sha256(text) {
+    return createHash("sha256").update(text).digest("hex");
+}
+function isObjectRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function cloneConnections(value) {
+    return isObjectRecord(value) ? { ...value } : {};
+}
+const CANONICAL_STATUS_PHASES = new Set([
+    "stopped",
+    "starting",
+    "ready",
+    "failed",
+    "unknown",
+]);
+function isCanonicalStatusPhase(value) {
+    return CANONICAL_STATUS_PHASES.has(value);
+}
+function normalizeDefinitionRef(raw, spec, definitionDigest, source) {
+    const current = isObjectRecord(raw.definition) ? raw.definition : {};
+    const id = typeof spec?.id === "string" && spec.id.trim()
+        ? spec.id.trim()
+        : typeof current.id === "string" && current.id.trim()
+            ? current.id.trim()
+            : "";
+    const version = typeof spec?.version === "string" && spec.version.trim()
+        ? spec.version.trim()
+        : typeof current.version === "string" && current.version.trim()
+            ? current.version.trim()
+            : "0.0.0";
+    const digest = definitionDigest
+        ?? (typeof current.digest === "string" && current.digest.trim() ? current.digest.trim() : "");
+    return {
+        id,
+        version,
+        digest,
+        ...(typeof current.source === "string" && current.source.trim()
+            ? { source: current.source.trim() }
+            : typeof source === "string" && source.trim()
+                ? { source: source.trim() }
+                : {}),
+    };
+}
+function readSpecFile(dir, fileName) {
+    const path = join(dir, fileName);
+    if (!existsSync(path))
+        return null;
+    try {
+        const yaml = readFileSync(path, "utf-8");
+        const spec = parse(yaml);
+        return spec && typeof spec.id === "string" && spec.id.trim()
+            ? { path, yaml, spec }
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function readCanonicalSpecSnapshotsFromDir(dir) {
+    const definition = readSpecFile(dir, DEFINITION_FILENAME);
+    const resolved = readSpecFile(dir, RESOLVED_SPEC_FILENAME);
+    return definition && resolved ? { definition, resolved } : null;
+}
+/**
+ * Return the install-time materialized snapshot used to compile workloads.
+ * Both canonical snapshots must exist; a one-file fallback is legacy input,
+ * not a valid normal-path instance.
+ */
+export function readSpecSnapshotFromDir(dir) {
+    return readCanonicalSpecSnapshotsFromDir(dir)?.resolved ?? null;
+}
+function normalizeStatus(raw, desiredState, createdAt) {
+    const current = isObjectRecord(raw.status) ? raw.status : {};
+    const rawPhase = typeof current.phase === "string" ? current.phase.trim() : "";
+    const phase = rawPhase === "needs-migration"
+        ? "failed"
+        : isCanonicalStatusPhase(rawPhase)
+            ? rawPhase
+            : desiredState === "running"
+                ? "unknown"
+                : "stopped";
+    const reason = typeof current.reason === "string" && current.reason.trim()
+        ? current.reason.trim()
+        : rawPhase === "needs-migration"
+            ? "needs-migration"
+            : phase === "stopped"
+                ? "desired-stopped"
+                : phase === "unknown"
+                    ? "not-observed-yet"
+                    : "unspecified";
+    return {
+        phase,
+        reason,
+        ...(typeof current.message === "string" && current.message.trim()
+            ? { message: current.message.trim() }
+            : {}),
+        lastObservedAt: typeof current.lastObservedAt === "string" && current.lastObservedAt.trim()
+            ? current.lastObservedAt
+            : createdAt,
+    };
+}
+export function buildCanonicalAppInstance(params) {
+    const raw = params.raw ?? {};
+    const createdAt = typeof raw.createdAt === "string" && raw.createdAt.trim()
+        ? raw.createdAt
+        : new Date().toISOString();
+    const updatedAt = typeof raw.updatedAt === "string" && raw.updatedAt.trim()
+        ? raw.updatedAt
+        : createdAt;
+    const desiredState = params.desiredState
+        ?? (raw.desiredState === "running" || raw.desiredState === "stopped" ? raw.desiredState : "stopped");
+    const integrations = params.materializedIntegrations !== undefined
+        ? normalizeSingleIntegrationRef(params.materializedIntegrations, "materialized integrations")
+        : resolveIntegrationRefsFromMetadata(raw);
+    const definition = normalizeDefinitionRef(raw, params.spec ?? null, params.definitionDigest, params.source);
+    return {
+        id: params.id,
+        instanceId: params.id,
+        ...(typeof params.name === "string" ? { name: params.name } : typeof raw.name === "string" ? { name: raw.name } : {}),
+        ...(typeof params.description === "string"
+            ? { description: params.description }
+            : typeof raw.description === "string"
+                ? { description: raw.description }
+                : {}),
+        definitionId: definition.id,
+        ...(typeof raw.derivedFromInstanceId === "string" && raw.derivedFromInstanceId.trim()
+            ? { derivedFromInstanceId: raw.derivedFromInstanceId.trim() }
+            : {}),
+        definition,
+        ...(integrations.length > 0 ? { integrations } : {}),
+        desiredState,
+        status: normalizeStatus(raw, desiredState, createdAt),
+        connections: cloneConnections(raw.connections),
+        ...(isObjectRecord(raw.operation) ? { operation: raw.operation } : {}),
+        ...(isObjectRecord(raw.needsAttention)
+            ? { needsAttention: raw.needsAttention }
+            : {}),
+        ...(isObjectRecord(raw.lastError) ? { lastError: raw.lastError } : {}),
+        createdAt,
+        updatedAt,
+        runtime: isObjectRecord(params.runtime) ? { ...params.runtime } : isObjectRecord(raw.runtime) ? { ...raw.runtime } : {},
+        ...(isObjectRecord(raw.paths)
+            && typeof raw.paths.instanceDir === "string"
+            && typeof raw.paths.integrationHome === "string"
+            ? {
+                paths: {
+                    instanceDir: raw.paths.instanceDir,
+                    integrationHome: raw.paths.integrationHome,
+                    ...(typeof raw.paths.primaryConfig === "string" ? { primaryConfig: raw.paths.primaryConfig } : {}),
+                    ...(typeof raw.paths.secretEnv === "string" ? { secretEnv: raw.paths.secretEnv } : {}),
+                },
+            }
+            : {}),
+        ...(isObjectRecord(raw["x-jishushell"])
+            ? { "x-jishushell": { ...raw["x-jishushell"] } }
+            : {}),
+        ...(isObjectRecord(raw["connections-env"])
+            ? {
+                "connections-env": Object.fromEntries(Object.entries(raw["connections-env"]).filter((entry) => typeof entry[1] === "string")),
+            }
+            : {}),
+        ...(isObjectRecord(raw.auto_backup) ? { auto_backup: { ...raw.auto_backup } } : {}),
+        schemaVersion: APP_INSTANCE_SCHEMA_VERSION,
+        migrationsApplied: Array.from(new Set([
+            ...(Array.isArray(raw.migrationsApplied) ? raw.migrationsApplied.filter((item) => typeof item === "string") : []),
+            APP_INSTANCE_MIGRATION_ID,
+        ])),
+    };
+}
+const CANONICAL_INSTANCE_FIELDS = new Set([
+    "id",
+    "instanceId",
+    "name",
+    "description",
+    "definitionId",
+    "derivedFromInstanceId",
+    "definition",
+    "integrations",
+    "desiredState",
+    "status",
+    "connections",
+    "operation",
+    "needsAttention",
+    "lastError",
+    "createdAt",
+    "updatedAt",
+    "runtime",
+    "paths",
+    "x-jishushell",
+    "connections-env",
+    "auto_backup",
+    "schemaVersion",
+    "migrationsApplied",
+]);
+function assertCanonicalInstanceShape(instanceId, raw, snapshots) {
+    if (!snapshots) {
+        throw new CanonicalInstanceRequiredError(instanceId, "definition.yaml or resolved-spec.yaml is missing/unreadable");
+    }
+    const unknownFields = Object.keys(raw).filter((field) => !CANONICAL_INSTANCE_FIELDS.has(field));
+    if (unknownFields.length > 0) {
+        throw new CanonicalInstanceRequiredError(instanceId, `unsupported or legacy fields are still persisted: ${unknownFields.sort().join(", ")}`);
+    }
+    if (raw.id !== instanceId || raw.instanceId !== instanceId) {
+        throw new CanonicalInstanceRequiredError(instanceId, "id/instanceId does not match the instance directory");
+    }
+    if (raw.schemaVersion !== APP_INSTANCE_SCHEMA_VERSION) {
+        throw new CanonicalInstanceRequiredError(instanceId, `schemaVersion must be ${APP_INSTANCE_SCHEMA_VERSION}`);
+    }
+    if (!Array.isArray(raw.migrationsApplied) || !raw.migrationsApplied.includes(APP_INSTANCE_MIGRATION_ID)) {
+        throw new CanonicalInstanceRequiredError(instanceId, `migration marker '${APP_INSTANCE_MIGRATION_ID}' is missing`);
+    }
+    if (raw.desiredState !== "running" && raw.desiredState !== "stopped") {
+        throw new CanonicalInstanceRequiredError(instanceId, "desiredState must be running or stopped");
+    }
+    if (!isObjectRecord(raw.status)
+        || typeof raw.status.phase !== "string"
+        || typeof raw.status.reason !== "string"
+        || typeof raw.status.lastObservedAt !== "string") {
+        throw new CanonicalInstanceRequiredError(instanceId, "status is missing required observed-state fields");
+    }
+    if (!isCanonicalStatusPhase(raw.status.phase)) {
+        throw new CanonicalInstanceRequiredError(instanceId, `status.phase '${raw.status.phase}' is not canonical; use failed/needs-migration for migration-required instances`);
+    }
+    if (!isObjectRecord(raw.connections)) {
+        throw new CanonicalInstanceRequiredError(instanceId, "connections must be an object");
+    }
+    if (!isObjectRecord(raw.runtime)) {
+        throw new CanonicalInstanceRequiredError(instanceId, "runtime must be an object");
+    }
+    if (typeof raw.createdAt !== "string" || !raw.createdAt.trim()) {
+        throw new CanonicalInstanceRequiredError(instanceId, "createdAt is missing");
+    }
+    if (typeof raw.updatedAt !== "string" || !raw.updatedAt.trim()) {
+        throw new CanonicalInstanceRequiredError(instanceId, "updatedAt is missing");
+    }
+    if (raw.paths !== undefined
+        && (!isObjectRecord(raw.paths)
+            || typeof raw.paths.instanceDir !== "string"
+            || typeof raw.paths.integrationHome !== "string")) {
+        throw new CanonicalInstanceRequiredError(instanceId, "paths must contain instanceDir and integrationHome");
+    }
+    if (!isObjectRecord(raw.definition) || raw.definition.id !== snapshots.definition.spec.id) {
+        throw new CanonicalInstanceRequiredError(instanceId, "definition.id does not match definition.yaml");
+    }
+    if (raw.definitionId !== raw.definition.id) {
+        throw new CanonicalInstanceRequiredError(instanceId, "definitionId does not match definition.id");
+    }
+    const expectedDefinitionVersion = snapshots.definition.spec.version ?? "0.0.0";
+    if (raw.definition.version !== expectedDefinitionVersion) {
+        throw new CanonicalInstanceRequiredError(instanceId, "definition.version does not match definition.yaml");
+    }
+    if (raw.definition.digest !== sha256(snapshots.definition.yaml)) {
+        throw new CanonicalInstanceRequiredError(instanceId, "definition.digest does not match definition.yaml");
+    }
+}
+export function buildCanonicalManifest(params) {
+    const installedAt = typeof params.installedAt === "string" && params.installedAt.trim()
+        ? params.installedAt.trim()
+        : new Date().toISOString();
+    const updatedAt = new Date().toISOString();
+    return {
+        schemaVersion: APP_MANIFEST_SCHEMA_VERSION,
+        instanceId: params.instanceId,
+        definitionId: params.spec.id,
+        definitionVersion: params.spec.version ?? "0.0.0",
+        definitionDigest: sha256(params.definitionYaml),
+        resolvedSpecDigest: sha256(params.resolvedSpecYaml),
+        installedAt,
+        updatedAt,
+        resources: params.resources ? [...params.resources] : [],
+        ownedResources: params.ownedResources ? [...params.ownedResources] : [],
+        ...(typeof params.source === "string" && params.source.trim() ? { source: params.source.trim() } : {}),
+    };
+}
+export function readCanonicalManifestFromDir(dir, instanceId) {
+    const snapshots = readCanonicalSpecSnapshotsFromDir(dir);
+    if (!snapshots) {
+        throw new CanonicalManifestRequiredError(instanceId, "definition.yaml or resolved-spec.yaml is missing/unreadable");
+    }
+    const raw = safeReadJson(join(dir, MANIFEST_FILENAME), `manifest:${instanceId}`);
+    if (!raw)
+        throw new CanonicalManifestRequiredError(instanceId, "manifest.json is missing/unreadable");
+    for (const legacyField of ["id", "installed_at", "spec_hash", "install_mode", "artifacts"]) {
+        if (legacyField in raw) {
+            throw new CanonicalManifestRequiredError(instanceId, `legacy field '${legacyField}' is still persisted`);
+        }
+    }
+    if (raw.schemaVersion !== APP_MANIFEST_SCHEMA_VERSION) {
+        throw new CanonicalManifestRequiredError(instanceId, `schemaVersion must be ${APP_MANIFEST_SCHEMA_VERSION}`);
+    }
+    if (raw.instanceId !== instanceId) {
+        throw new CanonicalManifestRequiredError(instanceId, "instanceId does not match the instance directory");
+    }
+    if (raw.definitionId !== snapshots.definition.spec.id) {
+        throw new CanonicalManifestRequiredError(instanceId, "definitionId does not match definition.yaml");
+    }
+    const expectedDefinitionVersion = snapshots.definition.spec.version ?? "0.0.0";
+    if (raw.definitionVersion !== expectedDefinitionVersion) {
+        throw new CanonicalManifestRequiredError(instanceId, "definitionVersion does not match definition.yaml");
+    }
+    const definitionDigest = sha256(snapshots.definition.yaml);
+    const resolvedSpecDigest = sha256(snapshots.resolved.yaml);
+    if (raw.definitionDigest !== definitionDigest) {
+        throw new CanonicalManifestRequiredError(instanceId, "definitionDigest does not match definition.yaml");
+    }
+    if (raw.resolvedSpecDigest !== resolvedSpecDigest) {
+        throw new CanonicalManifestRequiredError(instanceId, "resolvedSpecDigest does not match resolved-spec.yaml");
+    }
+    if (typeof raw.installedAt !== "string" || !raw.installedAt.trim()) {
+        throw new CanonicalManifestRequiredError(instanceId, "installedAt is missing");
+    }
+    if (typeof raw.updatedAt !== "string" || !raw.updatedAt.trim()) {
+        throw new CanonicalManifestRequiredError(instanceId, "updatedAt is missing");
+    }
+    if (!Array.isArray(raw.resources) || !Array.isArray(raw.ownedResources)) {
+        throw new CanonicalManifestRequiredError(instanceId, "resources and ownedResources must be arrays");
+    }
+    return {
+        schemaVersion: APP_MANIFEST_SCHEMA_VERSION,
+        instanceId,
+        definitionId: raw.definitionId,
+        definitionVersion: raw.definitionVersion,
+        definitionDigest,
+        resolvedSpecDigest,
+        installedAt: raw.installedAt,
+        updatedAt: raw.updatedAt,
+        resources: [...raw.resources],
+        ownedResources: [...raw.ownedResources],
+        ...(typeof raw.source === "string" && raw.source.trim() ? { source: raw.source.trim() } : {}),
+    };
+}
+export function readCanonicalInstance(instanceId) {
+    const dir = resolveAppDir(instanceId);
+    const path = join(dir, INSTANCE_METADATA_FILENAME);
+    const raw = safeReadJson(path, `instance:${instanceId}`);
+    if (!raw)
+        return null;
+    const snapshots = readCanonicalSpecSnapshotsFromDir(dir);
+    assertCanonicalInstanceShape(instanceId, raw, snapshots);
+    const definitionDigest = snapshots ? sha256(snapshots.definition.yaml) : undefined;
+    return buildCanonicalAppInstance({
+        raw,
+        id: instanceId,
+        spec: snapshots?.resolved.spec ?? null,
+        definitionDigest,
+    });
+}
+/**
+ * Resolve an instance's AppSpec from canonical on-disk snapshots only
+ * (`apps/<id>/resolved-spec.yaml`, then `definition.yaml`).
+ *
+ * Returns `null` when:
+ *   - The instance directory does not contain a usable spec snapshot.
+ *     This means the instance has not been migrated yet — runtime hot
+ *     path callers MUST treat this as "unsupported until migrator runs",
+ *     not as "use synthetic template fallback".
+ */
+export function readCanonicalSpecForInstance(instanceId) {
+    const dir = resolveAppDir(instanceId);
+    return readCanonicalSpecSnapshotsFromDir(dir)?.resolved.spec ?? null;
+}
+export function writeSpecSnapshots(dir, definitionYaml, resolvedSpecYaml) {
+    ensureDirHost(dir);
+    writeFileSync(join(dir, DEFINITION_FILENAME), definitionYaml, { mode: 0o644 });
+    writeFileSync(join(dir, RESOLVED_SPEC_FILENAME), resolvedSpecYaml, { mode: 0o644 });
+}
+function updateCanonicalInstance(instanceId, mutator) {
+    const dir = resolveAppDir(instanceId);
+    const path = join(dir, INSTANCE_METADATA_FILENAME);
+    const raw = safeReadJson(path, `instance:${instanceId}`);
+    if (!raw)
+        return null;
+    const snapshots = readCanonicalSpecSnapshotsFromDir(dir);
+    assertCanonicalInstanceShape(instanceId, raw, snapshots);
+    const current = buildCanonicalAppInstance({
+        raw,
+        id: instanceId,
+        spec: snapshots?.resolved.spec ?? null,
+        definitionDigest: snapshots ? sha256(snapshots.definition.yaml) : undefined,
+    });
+    const next = mutator(current);
+    const canonicalNext = buildCanonicalAppInstance({
+        raw: next,
+        id: instanceId,
+        name: next.name,
+        description: next.description,
+        spec: snapshots?.resolved.spec ?? null,
+        definitionDigest: snapshots ? sha256(snapshots.definition.yaml) : undefined,
+        desiredState: next.desiredState,
+        runtime: next.runtime,
+        materializedIntegrations: next.integrations ?? [],
+    });
+    safeWriteJson(path, canonicalNext, true);
+    return canonicalNext;
+}
+export function updateInstanceDesiredState(instanceId, desiredState) {
+    return updateCanonicalInstance(instanceId, (next) => ({
+        ...next,
+        desiredState,
+        updatedAt: new Date().toISOString(),
+    }));
+}
+export function updateInstanceStatus(instanceId, status) {
+    return updateCanonicalInstance(instanceId, (next) => ({
+        ...next,
+        status,
+        ...(status.phase === "ready" ? { lastError: undefined } : {}),
+        updatedAt: status.lastObservedAt,
+    }));
+}
+export function beginInstanceOperation(instanceId, type, phase) {
+    return updateCanonicalInstance(instanceId, (next) => {
+        const now = new Date().toISOString();
+        const previous = next.operation;
+        return {
+            ...next,
+            operation: {
+                id: previous?.type === type ? previous.id : `${type}:${Date.now()}`,
+                type,
+                phase,
+                startedAt: previous?.type === type ? previous.startedAt : now,
+                updatedAt: now,
+            },
+            updatedAt: now,
+            lastError: undefined,
+        };
+    });
+}
+export function advanceInstanceOperation(instanceId, phase) {
+    return updateCanonicalInstance(instanceId, (next) => {
+        if (!next.operation)
+            return next;
+        const updatedAt = new Date().toISOString();
+        return {
+            ...next,
+            operation: {
+                ...next.operation,
+                phase,
+                updatedAt,
+            },
+            updatedAt,
+        };
+    });
+}
+export function clearInstanceOperation(instanceId, options = {}) {
+    return updateCanonicalInstance(instanceId, (next) => {
+        const now = new Date().toISOString();
+        const operationId = next.operation?.id;
+        return {
+            ...next,
+            operation: undefined,
+            ...(options.lastError
+                ? {
+                    lastError: {
+                        operationId,
+                        phase: options.lastError.phase,
+                        message: options.lastError.message,
+                        at: now,
+                    },
+                }
+                : {}),
+            ...(options.status ? { status: options.status } : {}),
+            updatedAt: options.status?.lastObservedAt ?? now,
+        };
+    });
+}
+//# sourceMappingURL=instance-store.js.map

package/dist/services/app-common/instance-store.js.map

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

package/dist/services/app-common/integration-refs.d.ts

@@ -0,0 +1,17 @@
+import type { AppIntegrationRef, AppSpec } from "../../types.js";
+import type { AppIntegrationKind } from "../integrations/types.js";
+export declare const INVALID_INTEGRATION_REFS_CODE = "INVALID_INTEGRATION_REFS";
+export declare class InvalidIntegrationRefsError extends Error {
+    readonly code = "INVALID_INTEGRATION_REFS";
+    constructor(source: string, reason: string);
+}
+/**
+ * JishuShell currently supports at most one Core-native integration per app
+ * instance. The array remains in the persisted/API schema so the contract can
+ * grow later, but array order has no dispatch meaning and must never be used as
+ * an implicit "primary integration" rule.
+ */
+export declare function normalizeSingleIntegrationRef(items: unknown, source: string): AppIntegrationRef[];
+export declare function resolveIntegrationsFromSpec(spec: Partial<AppSpec> | null | undefined): AppIntegrationRef[];
+export declare function resolveIntegrationRefsFromMetadata(metadata: Record<string, unknown> | null | undefined): AppIntegrationRef[];
+export declare function resolveIntegrationKindFromMetadata(metadata: Record<string, unknown> | null | undefined): AppIntegrationKind | null;

package/dist/services/app-common/integration-refs.js

@@ -0,0 +1,47 @@
+export const INVALID_INTEGRATION_REFS_CODE = "INVALID_INTEGRATION_REFS";
+export class InvalidIntegrationRefsError extends Error {
+    code = INVALID_INTEGRATION_REFS_CODE;
+    constructor(source, reason) {
+        super(`${source} has invalid integrations: ${reason}`);
+        this.name = "InvalidIntegrationRefsError";
+    }
+}
+/**
+ * JishuShell currently supports at most one Core-native integration per app
+ * instance. The array remains in the persisted/API schema so the contract can
+ * grow later, but array order has no dispatch meaning and must never be used as
+ * an implicit "primary integration" rule.
+ */
+export function normalizeSingleIntegrationRef(items, source) {
+    if (items === undefined)
+        return [];
+    if (!Array.isArray(items)) {
+        throw new InvalidIntegrationRefsError(source, "expected an array");
+    }
+    if (items.length > 1) {
+        throw new InvalidIntegrationRefsError(source, "at most one integration is supported");
+    }
+    if (items.length === 0)
+        return [];
+    const item = items[0];
+    if (!item || typeof item !== "object" || Array.isArray(item)) {
+        throw new InvalidIntegrationRefsError(source, "integrations[0] must be an object");
+    }
+    const kind = typeof item.kind === "string"
+        ? item.kind.trim()
+        : "";
+    if (!kind) {
+        throw new InvalidIntegrationRefsError(source, "integrations[0].kind is required");
+    }
+    return [{ kind }];
+}
+export function resolveIntegrationsFromSpec(spec) {
+    return normalizeSingleIntegrationRef(spec?.integrations, "AppSpec");
+}
+export function resolveIntegrationRefsFromMetadata(metadata) {
+    return normalizeSingleIntegrationRef(metadata?.integrations, "instance metadata");
+}
+export function resolveIntegrationKindFromMetadata(metadata) {
+    return resolveIntegrationRefsFromMetadata(metadata)[0]?.kind ?? null;
+}
+//# sourceMappingURL=integration-refs.js.map

package/dist/services/app-common/integration-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-refs.js","sourceRoot":"","sources":["../../../src/services/app-common/integration-refs.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,6BAA6B,GAAG,0BAA0B,CAAC;AAExE,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAC3C,IAAI,GAAG,6BAA6B,CAAC;IAE9C,YAAY,MAAc,EAAE,MAAc;QACxC,KAAK,CAAC,GAAG,MAAM,8BAA8B,MAAM,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAc,EACd,MAAc;IAEd,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,2BAA2B,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,2BAA2B,CAAC,MAAM,EAAE,sCAAsC,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,2BAA2B,CAAC,MAAM,EAAE,mCAAmC,CAAC,CAAC;IACrF,CAAC;IACD,MAAM,IAAI,GAAG,OAAQ,IAAgC,CAAC,IAAI,KAAK,QAAQ;QACrE,CAAC,CAAG,IAAgC,CAAC,IAAe,CAAC,IAAI,EAAE;QAC3D,CAAC,CAAC,EAAE,CAAC;IACP,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,2BAA2B,CAAC,MAAM,EAAE,kCAAkC,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,IAAyC;IAEzC,OAAO,6BAA6B,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,QAAoD;IAEpD,OAAO,6BAA6B,CAAC,QAAQ,EAAE,YAAY,EAAE,mBAAmB,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,QAAoD;IAEpD,OAAQ,kCAAkC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,IAAuC,IAAI,IAAI,CAAC;AAC3G,CAAC"}

package/dist/services/app-common/lifecycle-pipeline.d.ts

@@ -0,0 +1,62 @@
+import type { AppIntegrationRef, AppManifest, AppSpec, InstanceConnections, ServiceResult } from "../../types.js";
+import type { AppIntegration, CreateInstanceArgs, CreatePrepareResult } from "../integrations/types.js";
+export interface AppLifecycleRecord {
+    spec: AppSpec;
+    manifest: AppManifest;
+}
+export interface ResolvedLifecyclePlan {
+    readonly kind: string | null;
+    readonly integration: AppIntegration | null;
+    readonly usesIntegrationRuntime: boolean;
+    runBeforeStart(context: LifecycleStartContext): Promise<ServiceResult>;
+    runAfterStart(): Promise<ServiceResult>;
+    runBeforeStop(): Promise<ServiceResult>;
+    runAfterStop(): Promise<ServiceResult>;
+}
+export interface LifecycleStartContext {
+    action: "start" | "restart";
+    controlUiOrigin?: string;
+}
+export interface ResolvedCreatePlan {
+    readonly kind: string | null;
+    readonly integration: AppIntegration | null;
+    readonly materializedIntegrations: AppIntegrationRef[];
+    readonly usesIntegrationRuntime: boolean;
+    readonly preferredHostPort?: number;
+    runCreatePrepare(args: CreateInstanceArgs): Promise<CreatePrepareResult>;
+    prepareRuntime(args: {
+        instanceId: string;
+        spec: AppSpec;
+        paths: CreatePrepareResult;
+    }): Promise<PreparedCreateRuntime>;
+    buildMetadataRaw(args: {
+        createdAt: string;
+        connections: InstanceConnections;
+        paths: CreatePrepareResult;
+        createArgs: CreateInstanceArgs;
+    }): Record<string, any>;
+    resolveInstanceName(args: {
+        instanceId: string;
+        spec: AppSpec;
+        createArgs: CreateInstanceArgs;
+    }): string;
+    resolveInstanceDescription(args: {
+        spec: AppSpec;
+        createArgs: CreateInstanceArgs;
+    }): string;
+    runCreate(args: {
+        instanceId: string;
+        meta: Record<string, any>;
+        paths?: CreatePrepareResult;
+        createArgs?: CreateInstanceArgs;
+    }): Promise<void>;
+}
+export interface PreparedCreateRuntime {
+    runtime: Record<string, any>;
+    commit(): void;
+    release(): void;
+    buildFinalRuntime(): Promise<Record<string, any>>;
+}
+export declare function resolveStartPlan(appData: AppLifecycleRecord): ResolvedLifecyclePlan;
+export declare function resolveStopPlan(appData: AppLifecycleRecord): ResolvedLifecyclePlan;
+export declare function resolveCreatePlan(spec: AppSpec): ResolvedCreatePlan;