jishushell 0.6.5 → 0.6.18

package/dist/services/app-common/lifecycle-pipeline.js

@@ -0,0 +1,317 @@
+import { getIntegration, hasIntegration } from "../integrations/index.js";
+import * as instanceServices from "../instances/manager.js";
+import { renderRuntimeConnectionsEnv } from "../connections/apply.js";
+import { resolveExecutionOwner } from "./execution-owner.js";
+import { resolveIntegrationsFromSpec } from "./integration-refs.js";
+import { readCanonicalSpecForInstance } from "./instance-store.js";
+import { resolveAppDir } from "./paths.js";
+function ok() {
+    return { ok: true };
+}
+function hookError(error) {
+    const e = error;
+    return {
+        ok: false,
+        error: e?.message || String(error),
+        ...(typeof e?.code === "string" ? { code: e.code } : {}),
+        ...(typeof e?.statusCode === "number" ? { statusCode: e.statusCode } : {}),
+        ...(e?.building === true ? { building: true } : {}),
+        ...(typeof e?.taskId === "string" ? { taskId: e.taskId } : {}),
+    };
+}
+function noOpLifecyclePlan() {
+    return {
+        kind: null,
+        integration: null,
+        usesIntegrationRuntime: false,
+        async runBeforeStart() {
+            return ok();
+        },
+        async runAfterStart() {
+            return ok();
+        },
+        async runBeforeStop() {
+            return ok();
+        },
+        async runAfterStop() {
+            return ok();
+        },
+    };
+}
+export function resolveStartPlan(appData) {
+    const owner = resolveExecutionOwner(appData.manifest.instanceId);
+    if (owner?.type !== "integration")
+        return noOpLifecyclePlan();
+    const integration = getIntegration(owner.integrationKind);
+    return {
+        kind: owner.integrationKind,
+        integration,
+        usesIntegrationRuntime: true,
+        async runBeforeStart(context) {
+            await prepareIntegrationControlUiOrigin(appData.manifest.instanceId, integration, context);
+            await refreshIntegrationConnectionConfig(appData.manifest.instanceId, appData.spec, integration);
+            try {
+                if (integration.hooks?.onBeforeStart) {
+                    await integration.hooks.onBeforeStart({ instanceId: appData.manifest.instanceId });
+                }
+                return ok();
+            }
+            catch (error) {
+                return hookError(error);
+            }
+        },
+        async runAfterStart() {
+            if (!integration.hooks?.onAfterStart)
+                return ok();
+            try {
+                await integration.hooks.onAfterStart({ instanceId: appData.manifest.instanceId });
+                return ok();
+            }
+            catch (error) {
+                return hookError(error);
+            }
+        },
+        async runBeforeStop() {
+            if (!integration.hooks?.onBeforeStop)
+                return ok();
+            try {
+                await integration.hooks.onBeforeStop({ instanceId: appData.manifest.instanceId });
+                return ok();
+            }
+            catch (error) {
+                return hookError(error);
+            }
+        },
+        async runAfterStop() {
+            if (!integration.hooks?.onAfterStop)
+                return ok();
+            try {
+                await integration.hooks.onAfterStop({ instanceId: appData.manifest.instanceId });
+                return ok();
+            }
+            catch (error) {
+                return hookError(error);
+            }
+        },
+    };
+}
+export function resolveStopPlan(appData) {
+    return resolveStartPlan(appData);
+}
+async function prepareIntegrationControlUiOrigin(instanceId, integration, context) {
+    const origin = context.controlUiOrigin?.trim();
+    if (!origin)
+        return;
+    const prepare = integration.hooks?.onPrepareControlUiOrigin;
+    if (!prepare)
+        return;
+    try {
+        const added = await prepare({ instanceId, origin, action: context.action });
+        if (added) {
+            console.log(`[lifecycle] ${context.action} prepared control-ui origin for ${instanceId} origin=${origin}`);
+        }
+    }
+    catch (error) {
+        // Preserve the old route-level behavior: origin auto-allowlisting is
+        // best-effort and must not block start/restart. The control UI launch path
+        // can still report restartRequired when it adds an origin after startup.
+        console.warn(`[lifecycle] ${context.action} failed to prepare control-ui origin for ${instanceId} origin=${origin}:`, error?.message ?? error);
+    }
+}
+function extractRuntimeHostPortSeed(runtime) {
+    const ports = Array.isArray(runtime.ports) ? runtime.ports : [];
+    const primary = ports.find((port) => (port?.visibility ?? "external") !== "internal") ?? ports[0];
+    const seed = primary?.hostPortSeed ?? primary?.hostPort ?? primary?.containerPort;
+    return Number.isInteger(seed) && seed > 0 ? seed : null;
+}
+function ensureRuntimeEnvFile(runtime, secretEnv) {
+    if (!secretEnv)
+        return;
+    if (Array.isArray(runtime.env_files)) {
+        if (!runtime.env_files.includes(secretEnv)) {
+            runtime.env_files = [secretEnv, ...runtime.env_files];
+        }
+        return;
+    }
+    if (Array.isArray(runtime.envFiles)) {
+        if (!runtime.envFiles.includes(secretEnv)) {
+            runtime.envFiles = [secretEnv, ...runtime.envFiles];
+        }
+        return;
+    }
+    runtime.envFiles = [secretEnv];
+}
+function applyHostPort(runtime, hostPort, reallocateRuntimePort) {
+    if (reallocateRuntimePort) {
+        reallocateRuntimePort(runtime, hostPort);
+        return;
+    }
+    if (Array.isArray(runtime.ports) && runtime.ports.length > 0) {
+        runtime.ports = runtime.ports.map((port, index) => index === 0 ? { ...port, hostPort } : port);
+    }
+}
+function buildCreateRawBase(createdAt, connections, cloneFrom) {
+    return {
+        createdAt,
+        ...(typeof cloneFrom === "string" && cloneFrom.trim()
+            ? { derivedFromInstanceId: cloneFrom.trim() }
+            : {}),
+        ...(Object.keys(connections).length > 0 ? { connections } : {}),
+    };
+}
+function noOpCreatePlan(spec) {
+    const materializedIntegrations = resolveIntegrationsFromSpec(spec);
+    return {
+        kind: null,
+        integration: null,
+        materializedIntegrations,
+        usesIntegrationRuntime: false,
+        async runCreatePrepare({ instanceId }) {
+            return {
+                instanceDir: resolveAppDir(instanceId),
+                integrationHome: resolveAppDir(instanceId),
+            };
+        },
+        async prepareRuntime({ instanceId }) {
+            const { allocateCanonicalRuntimeHostPorts, buildCanonicalRuntimeFromSpec, commitCanonicalRuntimeHostPorts, releaseCanonicalRuntimeHostPorts, } = await import("./runtime-facts.js");
+            const runtime = buildCanonicalRuntimeFromSpec(spec, instanceId);
+            const allocation = await allocateCanonicalRuntimeHostPorts(instanceId, runtime);
+            return {
+                runtime: allocation.runtime,
+                commit() {
+                    commitCanonicalRuntimeHostPorts(allocation.allocations);
+                },
+                release() {
+                    releaseCanonicalRuntimeHostPorts(allocation.allocations);
+                },
+                async buildFinalRuntime() {
+                    return allocation.runtime;
+                },
+            };
+        },
+        buildMetadataRaw({ createdAt, connections, createArgs }) {
+            return buildCreateRawBase(createdAt, connections, createArgs.cloneFrom);
+        },
+        resolveInstanceName({ instanceId }) {
+            return spec.name || instanceId;
+        },
+        resolveInstanceDescription() {
+            return spec.description || "";
+        },
+        async runCreate() {
+            // no-op
+        },
+    };
+}
+export function resolveCreatePlan(spec) {
+    const kind = resolveIntegrationsFromSpec(spec)[0]?.kind;
+    if (!kind || !hasIntegration(kind))
+        return noOpCreatePlan(spec);
+    const integration = getIntegration(kind);
+    const materializedIntegrations = resolveIntegrationsFromSpec(spec);
+    const reallocateRuntimePort = integration.reallocateRuntimePort?.bind(integration);
+    return {
+        kind,
+        integration,
+        materializedIntegrations,
+        usesIntegrationRuntime: true,
+        preferredHostPort: integration.preferredHostPort,
+        async runCreatePrepare(args) {
+            return integration.hooks?.onCreatePrepare
+                ? integration.hooks.onCreatePrepare(args)
+                : {
+                    instanceDir: resolveAppDir(args.instanceId),
+                    integrationHome: resolveAppDir(args.instanceId),
+                };
+        },
+        async prepareRuntime({ instanceId, spec, paths }) {
+            const { buildCanonicalRuntimeFromSpec } = await import("./runtime-facts.js");
+            const bootstrapRuntime = buildCanonicalRuntimeFromSpec(spec, instanceId);
+            // Architecture boundary: integration-managed AppSpecs enter through the
+            // shared AppSpec create pipeline, but their final runtime is still
+            // supplied by integration.buildRuntime(). The current integration runtime
+            // contract is single-primary-external-port (OpenClaw/Hermes both expose a
+            // single gateway port), so this branch allocates one canonical hostPort
+            // and applies it to the integration runtime. If an integration-managed
+            // app needs multiple external ports, migrate this branch to the same
+            // per-runtime.ports[] allocation model used by noOpCreatePlan(); do not
+            // extend this primary-only path.
+            const requestedHostPort = instanceServices.extractPrimaryHostPort(bootstrapRuntime, kind)
+                ?? extractRuntimeHostPortSeed(bootstrapRuntime)
+                ?? integration.preferredHostPort
+                ?? null;
+            const portAllocation = requestedHostPort != null
+                ? await instanceServices.allocateHostPort(instanceId, requestedHostPort)
+                : null;
+            ensureRuntimeEnvFile(bootstrapRuntime, paths.secretEnv);
+            if (typeof bootstrapRuntime.cwd !== "string" || !bootstrapRuntime.cwd.trim()) {
+                bootstrapRuntime.cwd = paths.integrationHome;
+            }
+            if (portAllocation) {
+                applyHostPort(bootstrapRuntime, portAllocation.port, reallocateRuntimePort);
+            }
+            return {
+                runtime: bootstrapRuntime,
+                commit() {
+                    portAllocation?.commit();
+                },
+                release() {
+                    portAllocation?.release();
+                },
+                async buildFinalRuntime() {
+                    const finalRuntime = await integration.buildRuntime(instanceId);
+                    ensureRuntimeEnvFile(finalRuntime, paths.secretEnv);
+                    if (portAllocation) {
+                        applyHostPort(finalRuntime, portAllocation.port, reallocateRuntimePort);
+                    }
+                    return finalRuntime;
+                },
+            };
+        },
+        buildMetadataRaw({ createdAt, connections, paths, createArgs }) {
+            return {
+                ...buildCreateRawBase(createdAt, connections, createArgs.cloneFrom),
+                paths: {
+                    instanceDir: paths.instanceDir,
+                    integrationHome: paths.integrationHome,
+                    ...(paths.primaryConfig ? { primaryConfig: paths.primaryConfig } : {}),
+                    ...(paths.secretEnv ? { secretEnv: paths.secretEnv } : {}),
+                },
+            };
+        },
+        resolveInstanceName({ createArgs }) {
+            return createArgs.name;
+        },
+        resolveInstanceDescription({ createArgs }) {
+            return createArgs.description;
+        },
+        async runCreate(args) {
+            if (integration.hooks?.onCreate) {
+                await integration.hooks.onCreate(args);
+            }
+        },
+    };
+}
+async function refreshIntegrationConnectionConfig(instanceId, installedSpec, integration) {
+    if (!integration.applyConnectionEnv)
+        return;
+    try {
+        const meta = instanceServices.getInstance(instanceId);
+        if (!meta)
+            return;
+        const spec = installedSpec ?? readCanonicalSpecForInstance(instanceId);
+        if (!spec)
+            return;
+        const env = await renderRuntimeConnectionsEnv(spec, {
+            id: instanceId,
+            connections: meta.connections,
+        });
+        if (Object.keys(env).length === 0)
+            return;
+        await integration.applyConnectionEnv(instanceId, env);
+    }
+    catch (error) {
+        console.warn(`[lifecycle] integration connection refresh failed for ${instanceId}: ${error?.message ?? error}`);
+    }
+}
+//# sourceMappingURL=lifecycle-pipeline.js.map

package/dist/services/app-common/lifecycle-pipeline.js.map

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

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

@@ -0,0 +1,38 @@
+import type { AppInstallArtifact, AppLifecycleStep, AppSpec } from "../../types.js";
+import { type Task } from "../tasks/registry.js";
+export type LifecycleExecOptions = {
+    sudoPassword?: string;
+};
+export declare function decorateInstallError(error: unknown, spec: AppSpec): Error;
+export declare function validateSudoPassword(sudoPassword: string): Promise<void>;
+export declare function emitInstallTaskLog(task: Task | undefined, message: string): void;
+export declare function selectRollbackUninstallSteps(steps: AppLifecycleStep[] | undefined, ownedArtifacts: AppInstallArtifact[]): AppLifecycleStep[];
+export declare function pullDockerImageStep(label: string, image: string, display: string, task?: Task, timeoutMs?: number, idleTimeoutMs?: number): Promise<boolean>;
+/**
+ * Fire-and-forget background docker pull. Used by `*-manager.ts`
+ * (custom / hermes / ollama) when an instance is requested with an image
+ * that's not yet local: kicks off a pull in the background and the caller
+ * asks the user to retry later (HTTP 202).
+ *
+ * Wraps the same `pullDockerImageStep` used by full installs, so it
+ * inherits the same protections — total timeout (30 min), idle timeout
+ * (10 min of silence on the pull's stdout/stderr terminates it), 3
+ * retries, and a post-failure `dockerImageExists` recovery check — that
+ * a bare `exec("docker pull ...", { timeout: 0 })` lacks. Docker Desktop
+ * on macOS can hang the CLI for tens of minutes after the image has been
+ * fully downloaded (the final manifest/tag write step occasionally
+ * deadlocks); the idle timer kills the hung CLI and the recovery check
+ * picks up the image if the tag did make it through.
+ *
+ * Concurrent calls for the same image dedup onto a single in-flight pull
+ * so repeated UI clicks don't waste retries.
+ *
+ * Always resolves — errors are logged via console.warn so the
+ * fire-and-forget caller doesn't have to attach a `.catch` handler.
+ */
+export declare function pullDockerImageInBackground(label: string, image: string): Promise<void>;
+export declare function runLifecycleSteps(steps: AppLifecycleStep[] | undefined, label: string, artifacts?: AppInstallArtifact[], task?: Task, execOptions?: LifecycleExecOptions, ownedArtifacts?: AppInstallArtifact[], instanceId?: string): Promise<void>;
+export declare function cleanupArtifacts(artifacts: AppInstallArtifact[], task?: Task): void;
+export declare function runPostStartSteps(spec: AppSpec, instanceId?: string): Promise<void>;
+export declare function runPreStartSteps(spec: AppSpec, instanceId?: string): Promise<void>;
+export declare function waitForAppRuntimeRunning(instanceId: string, timeoutMs?: number, pollIntervalMs?: number): Promise<boolean>;