@penclipai/adapter-utils 2026.419.0 → 2026.424.0-canary.0

package/dist/execution-target.d.ts

@@ -0,0 +1,78 @@
+import type { SshRemoteExecutionSpec } from "./ssh.js";
+import { type RemoteManagedRuntimeAsset } from "./remote-managed-runtime.js";
+import { type RunProcessResult, type TerminalResultCleanupOptions } from "./server-utils.js";
+export interface AdapterLocalExecutionTarget {
+    kind: "local";
+    environmentId?: string | null;
+    leaseId?: string | null;
+}
+export interface AdapterSshExecutionTarget {
+    kind: "remote";
+    transport: "ssh";
+    environmentId?: string | null;
+    leaseId?: string | null;
+    remoteCwd: string;
+    paperclipApiUrl?: string | null;
+    spec: SshRemoteExecutionSpec;
+}
+export type AdapterExecutionTarget = AdapterLocalExecutionTarget | AdapterSshExecutionTarget;
+export type AdapterRemoteExecutionSpec = SshRemoteExecutionSpec;
+export type AdapterManagedRuntimeAsset = RemoteManagedRuntimeAsset;
+export interface PreparedAdapterExecutionTargetRuntime {
+    target: AdapterExecutionTarget;
+    runtimeRootDir: string | null;
+    assetDirs: Record<string, string>;
+    restoreWorkspace(): Promise<void>;
+}
+export interface AdapterExecutionTargetProcessOptions {
+    cwd: string;
+    env: Record<string, string>;
+    stdin?: string;
+    timeoutSec: number;
+    graceSec: number;
+    onLog: (stream: "stdout" | "stderr", chunk: string) => Promise<void>;
+    onSpawn?: (meta: {
+        pid: number;
+        processGroupId: number | null;
+        startedAt: string;
+    }) => Promise<void>;
+    terminalResultCleanup?: TerminalResultCleanupOptions;
+}
+export interface AdapterExecutionTargetShellOptions {
+    cwd: string;
+    env: Record<string, string>;
+    timeoutSec?: number;
+    graceSec?: number;
+    onLog?: (stream: "stdout" | "stderr", chunk: string) => Promise<void>;
+}
+export declare function adapterExecutionTargetToRemoteSpec(target: AdapterExecutionTarget | null | undefined): AdapterRemoteExecutionSpec | null;
+export declare function adapterExecutionTargetIsRemote(target: AdapterExecutionTarget | null | undefined): boolean;
+export declare function adapterExecutionTargetUsesManagedHome(target: AdapterExecutionTarget | null | undefined): boolean;
+export declare function adapterExecutionTargetRemoteCwd(target: AdapterExecutionTarget | null | undefined, localCwd: string): string;
+export declare function adapterExecutionTargetPaperclipApiUrl(target: AdapterExecutionTarget | null | undefined): string | null;
+export declare function describeAdapterExecutionTarget(target: AdapterExecutionTarget | null | undefined): string;
+export declare function ensureAdapterExecutionTargetCommandResolvable(command: string, target: AdapterExecutionTarget | null | undefined, cwd: string, env: NodeJS.ProcessEnv): Promise<void>;
+export declare function resolveAdapterExecutionTargetCommandForLogs(command: string, target: AdapterExecutionTarget | null | undefined, cwd: string, env: NodeJS.ProcessEnv): Promise<string>;
+export declare function runAdapterExecutionTargetProcess(runId: string, target: AdapterExecutionTarget | null | undefined, command: string, args: string[], options: AdapterExecutionTargetProcessOptions): Promise<RunProcessResult>;
+export declare function runAdapterExecutionTargetShellCommand(runId: string, target: AdapterExecutionTarget | null | undefined, command: string, options: AdapterExecutionTargetShellOptions): Promise<RunProcessResult>;
+export declare function readAdapterExecutionTargetHomeDir(runId: string, target: AdapterExecutionTarget | null | undefined, options: AdapterExecutionTargetShellOptions): Promise<string | null>;
+export declare function ensureAdapterExecutionTargetFile(runId: string, target: AdapterExecutionTarget | null | undefined, filePath: string, options: AdapterExecutionTargetShellOptions): Promise<void>;
+export declare function adapterExecutionTargetSessionIdentity(target: AdapterExecutionTarget | null | undefined): Record<string, unknown> | null;
+export declare function adapterExecutionTargetSessionMatches(saved: unknown, target: AdapterExecutionTarget | null | undefined): boolean;
+export declare function parseAdapterExecutionTarget(value: unknown): AdapterExecutionTarget | null;
+export declare function adapterExecutionTargetFromRemoteExecution(remoteExecution: unknown, metadata?: Pick<AdapterLocalExecutionTarget, "environmentId" | "leaseId">): AdapterExecutionTarget | null;
+export declare function readAdapterExecutionTarget(input: {
+    executionTarget?: unknown;
+    legacyRemoteExecution?: unknown;
+}): AdapterExecutionTarget | null;
+export declare function prepareAdapterExecutionTargetRuntime(input: {
+    target: AdapterExecutionTarget | null | undefined;
+    adapterKey: string;
+    workspaceLocalDir: string;
+    workspaceExclude?: string[];
+    preserveAbsentOnRestore?: string[];
+    assets?: AdapterManagedRuntimeAsset[];
+    installCommand?: string | null;
+}): Promise<PreparedAdapterExecutionTargetRuntime>;
+export declare function runtimeAssetDir(prepared: Pick<PreparedAdapterExecutionTargetRuntime, "assetDirs">, key: string, fallbackRemoteCwd: string): string;
+//# sourceMappingURL=execution-target.d.ts.map

package/dist/execution-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-target.d.ts","sourceRoot":"","sources":["../src/execution-target.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAIL,KAAK,yBAAyB,EAC/B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,4BAA4B,EAClC,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,KAAK,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,IAAI,EAAE,sBAAsB,CAAC;CAC9B;AAED,MAAM,MAAM,sBAAsB,GAC9B,2BAA2B,GAC3B,yBAAyB,CAAC;AAE9B,MAAM,MAAM,0BAA0B,GAAG,sBAAsB,CAAC;AAEhE,MAAM,MAAM,0BAA0B,GAAG,yBAAyB,CAAC;AAEnE,MAAM,WAAW,qCAAqC;IACpD,MAAM,EAAE,sBAAsB,CAAC;IAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,oCAAoC;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrG,qBAAqB,CAAC,EAAE,4BAA4B,CAAC;CACtD;AAED,MAAM,WAAW,kCAAkC;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAwBD,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,GAChD,0BAA0B,GAAG,IAAI,CAEnC;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,GAChD,OAAO,CAET;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,GAChD,OAAO,CAKT;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,EACjD,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,GAChD,MAAM,GAAG,IAAI,CAGf;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,GAChD,MAAM,CAGR;AAED,wBAAsB,6CAA6C,CACjE,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,EACjD,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,CAAC,UAAU,iBAKvB;AAED,wBAAsB,2CAA2C,CAC/D,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,EACjD,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED,wBAAsB,gCAAgC,CACpD,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,EACjD,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,oCAAoC,GAC5C,OAAO,CAAC,gBAAgB,CAAC,CAY3B;AAED,wBAAsB,qCAAqC,CACzD,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,EACjD,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,gBAAgB,CAAC,CAsE3B;AAED,wBAAsB,iCAAiC,CACrD,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,EACjD,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASxB;AAED,wBAAsB,gCAAgC,CACpD,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,EACjD,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,GAChD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAGhC;AAED,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,GAChD,OAAO,CAKT;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,GAAG,IAAI,CA2BzF;AAED,wBAAgB,yCAAyC,CACvD,eAAe,EAAE,OAAO,EACxB,QAAQ,GAAE,IAAI,CAAC,2BAA2B,EAAE,eAAe,GAAG,SAAS,CAAM,GAC5E,sBAAsB,GAAG,IAAI,CAgB/B;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,GAAG,sBAAsB,GAAG,IAAI,CAQhC;AAED,wBAAsB,oCAAoC,CAAC,KAAK,EAAE;IAChE,MAAM,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,CAAC;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC,MAAM,CAAC,EAAE,0BAA0B,EAAE,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,GAAG,OAAO,CAAC,qCAAqC,CAAC,CAuBjD;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,IAAI,CAAC,qCAAqC,EAAE,WAAW,CAAC,EAClE,GAAG,EAAE,MAAM,EACX,iBAAiB,EAAE,MAAM,GACxB,MAAM,CAER"}

package/dist/execution-target.js

@@ -0,0 +1,235 @@
+import path from "node:path";
+import { buildRemoteExecutionSessionIdentity, prepareRemoteManagedRuntime, remoteExecutionSessionMatches, } from "./remote-managed-runtime.js";
+import { parseSshRemoteExecutionSpec, runSshCommand, shellQuote } from "./ssh.js";
+import { ensureCommandResolvable, resolveCommandForLogs, runChildProcess, } from "./server-utils.js";
+function parseObject(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+function readString(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+function readStringMeta(parsed, key) {
+    return readString(parsed[key]);
+}
+function isAdapterExecutionTargetInstance(value) {
+    const parsed = parseObject(value);
+    if (parsed.kind === "local")
+        return true;
+    if (parsed.kind !== "remote")
+        return false;
+    if (parsed.transport === "ssh")
+        return parseSshRemoteExecutionSpec(parseObject(parsed.spec)) !== null;
+    return false;
+}
+export function adapterExecutionTargetToRemoteSpec(target) {
+    return target?.kind === "remote" && target.transport === "ssh" ? target.spec : null;
+}
+export function adapterExecutionTargetIsRemote(target) {
+    return target?.kind === "remote";
+}
+export function adapterExecutionTargetUsesManagedHome(target) {
+    // SSH execution targets sync the runtime assets they need into the remote cwd today,
+    // so neither local nor remote targets provision a separate managed adapter home.
+    void target;
+    return false;
+}
+export function adapterExecutionTargetRemoteCwd(target, localCwd) {
+    return target?.kind === "remote" ? target.remoteCwd : localCwd;
+}
+export function adapterExecutionTargetPaperclipApiUrl(target) {
+    if (target?.kind !== "remote")
+        return null;
+    return target.paperclipApiUrl ?? target.spec.paperclipApiUrl ?? null;
+}
+export function describeAdapterExecutionTarget(target) {
+    if (!target || target.kind === "local")
+        return "local environment";
+    return `SSH environment ${target.spec.username}@${target.spec.host}:${target.spec.port}`;
+}
+export async function ensureAdapterExecutionTargetCommandResolvable(command, target, cwd, env) {
+    await ensureCommandResolvable(command, cwd, env, {
+        remoteExecution: adapterExecutionTargetToRemoteSpec(target),
+    });
+}
+export async function resolveAdapterExecutionTargetCommandForLogs(command, target, cwd, env) {
+    return await resolveCommandForLogs(command, cwd, env, {
+        remoteExecution: adapterExecutionTargetToRemoteSpec(target),
+    });
+}
+export async function runAdapterExecutionTargetProcess(runId, target, command, args, options) {
+    return await runChildProcess(runId, command, args, {
+        cwd: options.cwd,
+        env: options.env,
+        stdin: options.stdin,
+        timeoutSec: options.timeoutSec,
+        graceSec: options.graceSec,
+        onLog: options.onLog,
+        onSpawn: options.onSpawn,
+        terminalResultCleanup: options.terminalResultCleanup,
+        remoteExecution: adapterExecutionTargetToRemoteSpec(target),
+    });
+}
+export async function runAdapterExecutionTargetShellCommand(runId, target, command, options) {
+    const onLog = options.onLog ?? (async () => { });
+    if (target?.kind === "remote") {
+        const startedAt = new Date().toISOString();
+        try {
+            const result = await runSshCommand(target.spec, `sh -lc ${shellQuote(command)}`, {
+                timeoutMs: (options.timeoutSec ?? 15) * 1000,
+            });
+            if (result.stdout)
+                await onLog("stdout", result.stdout);
+            if (result.stderr)
+                await onLog("stderr", result.stderr);
+            return {
+                exitCode: 0,
+                signal: null,
+                timedOut: false,
+                stdout: result.stdout,
+                stderr: result.stderr,
+                pid: null,
+                startedAt,
+            };
+        }
+        catch (error) {
+            const timedOutError = error;
+            const stdout = timedOutError.stdout ?? "";
+            const stderr = timedOutError.stderr ?? "";
+            if (typeof timedOutError.code === "number") {
+                if (stdout)
+                    await onLog("stdout", stdout);
+                if (stderr)
+                    await onLog("stderr", stderr);
+                return {
+                    exitCode: timedOutError.code,
+                    signal: timedOutError.signal ?? null,
+                    timedOut: false,
+                    stdout,
+                    stderr,
+                    pid: null,
+                    startedAt,
+                };
+            }
+            if (timedOutError.code !== "ETIMEDOUT") {
+                throw error;
+            }
+            if (stdout)
+                await onLog("stdout", stdout);
+            if (stderr)
+                await onLog("stderr", stderr);
+            return {
+                exitCode: null,
+                signal: timedOutError.signal ?? null,
+                timedOut: true,
+                stdout,
+                stderr,
+                pid: null,
+                startedAt,
+            };
+        }
+    }
+    return await runAdapterExecutionTargetProcess(runId, target, "sh", ["-lc", command], {
+        cwd: options.cwd,
+        env: options.env,
+        timeoutSec: options.timeoutSec ?? 15,
+        graceSec: options.graceSec ?? 5,
+        onLog,
+    });
+}
+export async function readAdapterExecutionTargetHomeDir(runId, target, options) {
+    const result = await runAdapterExecutionTargetShellCommand(runId, target, 'printf %s "$HOME"', options);
+    const homeDir = result.stdout.trim();
+    return homeDir.length > 0 ? homeDir : null;
+}
+export async function ensureAdapterExecutionTargetFile(runId, target, filePath, options) {
+    await runAdapterExecutionTargetShellCommand(runId, target, `mkdir -p ${shellQuote(path.posix.dirname(filePath))} && : > ${shellQuote(filePath)}`, options);
+}
+export function adapterExecutionTargetSessionIdentity(target) {
+    if (!target || target.kind === "local")
+        return null;
+    return buildRemoteExecutionSessionIdentity(target.spec);
+}
+export function adapterExecutionTargetSessionMatches(saved, target) {
+    if (!target || target.kind === "local") {
+        return Object.keys(parseObject(saved)).length === 0;
+    }
+    return remoteExecutionSessionMatches(saved, target.spec);
+}
+export function parseAdapterExecutionTarget(value) {
+    const parsed = parseObject(value);
+    const kind = readStringMeta(parsed, "kind");
+    if (kind === "local") {
+        return {
+            kind: "local",
+            environmentId: readStringMeta(parsed, "environmentId"),
+            leaseId: readStringMeta(parsed, "leaseId"),
+        };
+    }
+    if (kind === "remote" && readStringMeta(parsed, "transport") === "ssh") {
+        const spec = parseSshRemoteExecutionSpec(parseObject(parsed.spec));
+        if (!spec)
+            return null;
+        return {
+            kind: "remote",
+            transport: "ssh",
+            environmentId: readStringMeta(parsed, "environmentId"),
+            leaseId: readStringMeta(parsed, "leaseId"),
+            remoteCwd: spec.remoteCwd,
+            paperclipApiUrl: readStringMeta(parsed, "paperclipApiUrl") ?? spec.paperclipApiUrl ?? null,
+            spec,
+        };
+    }
+    return null;
+}
+export function adapterExecutionTargetFromRemoteExecution(remoteExecution, metadata = {}) {
+    const parsed = parseObject(remoteExecution);
+    const ssh = parseSshRemoteExecutionSpec(parsed);
+    if (ssh) {
+        return {
+            kind: "remote",
+            transport: "ssh",
+            environmentId: metadata.environmentId ?? null,
+            leaseId: metadata.leaseId ?? null,
+            remoteCwd: ssh.remoteCwd,
+            paperclipApiUrl: ssh.paperclipApiUrl ?? null,
+            spec: ssh,
+        };
+    }
+    return null;
+}
+export function readAdapterExecutionTarget(input) {
+    if (isAdapterExecutionTargetInstance(input.executionTarget)) {
+        return input.executionTarget;
+    }
+    return (parseAdapterExecutionTarget(input.executionTarget) ??
+        adapterExecutionTargetFromRemoteExecution(input.legacyRemoteExecution));
+}
+export async function prepareAdapterExecutionTargetRuntime(input) {
+    const target = input.target ?? { kind: "local" };
+    if (target.kind === "local") {
+        return {
+            target,
+            runtimeRootDir: null,
+            assetDirs: {},
+            restoreWorkspace: async () => { },
+        };
+    }
+    const prepared = await prepareRemoteManagedRuntime({
+        spec: target.spec,
+        adapterKey: input.adapterKey,
+        workspaceLocalDir: input.workspaceLocalDir,
+        assets: input.assets,
+    });
+    return {
+        target,
+        runtimeRootDir: prepared.runtimeRootDir,
+        assetDirs: prepared.assetDirs,
+        restoreWorkspace: prepared.restoreWorkspace,
+    };
+}
+export function runtimeAssetDir(prepared, key, fallbackRemoteCwd) {
+    return prepared.assetDirs[key] ?? path.posix.join(fallbackRemoteCwd, ".paperclip-runtime", key);
+}
+//# sourceMappingURL=execution-target.js.map

package/dist/execution-target.js.map

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

package/dist/execution-target.test.d.ts

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

package/dist/execution-target.test.d.ts.map

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

package/dist/execution-target.test.js

@@ -0,0 +1,129 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import * as ssh from "./ssh.js";
+import { adapterExecutionTargetUsesManagedHome, runAdapterExecutionTargetShellCommand, } from "./execution-target.js";
+describe("runAdapterExecutionTargetShellCommand", () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("quotes remote shell commands with the shared SSH quoting helper", async () => {
+        const runSshCommandSpy = vi.spyOn(ssh, "runSshCommand").mockResolvedValue({
+            stdout: "",
+            stderr: "",
+        });
+        await runAdapterExecutionTargetShellCommand("run-1", {
+            kind: "remote",
+            transport: "ssh",
+            remoteCwd: "/srv/paperclip/workspace",
+            spec: {
+                host: "ssh.example.test",
+                port: 22,
+                username: "ssh-user",
+                remoteCwd: "/srv/paperclip/workspace",
+                remoteWorkspacePath: "/srv/paperclip/workspace",
+                privateKey: null,
+                knownHosts: null,
+                strictHostKeyChecking: true,
+            },
+        }, `printf '%s\\n' "$HOME" && echo "it's ok"`, {
+            cwd: "/tmp/local",
+            env: {},
+        });
+        expect(runSshCommandSpy).toHaveBeenCalledWith(expect.objectContaining({
+            host: "ssh.example.test",
+            username: "ssh-user",
+        }), `sh -lc ${ssh.shellQuote(`printf '%s\\n' "$HOME" && echo "it's ok"`)}`, expect.any(Object));
+    });
+    it("returns a timedOut result when the SSH shell command times out", async () => {
+        vi.spyOn(ssh, "runSshCommand").mockRejectedValue(Object.assign(new Error("timed out"), {
+            code: "ETIMEDOUT",
+            stdout: "partial stdout",
+            stderr: "partial stderr",
+            signal: "SIGTERM",
+        }));
+        const onLog = vi.fn(async () => { });
+        const result = await runAdapterExecutionTargetShellCommand("run-2", {
+            kind: "remote",
+            transport: "ssh",
+            remoteCwd: "/srv/paperclip/workspace",
+            spec: {
+                host: "ssh.example.test",
+                port: 22,
+                username: "ssh-user",
+                remoteCwd: "/srv/paperclip/workspace",
+                remoteWorkspacePath: "/srv/paperclip/workspace",
+                privateKey: null,
+                knownHosts: null,
+                strictHostKeyChecking: true,
+            },
+        }, "sleep 10", {
+            cwd: "/tmp/local",
+            env: {},
+            onLog,
+        });
+        expect(result).toMatchObject({
+            exitCode: null,
+            signal: "SIGTERM",
+            timedOut: true,
+            stdout: "partial stdout",
+            stderr: "partial stderr",
+        });
+        expect(onLog).toHaveBeenCalledWith("stdout", "partial stdout");
+        expect(onLog).toHaveBeenCalledWith("stderr", "partial stderr");
+    });
+    it("returns the SSH process exit code for non-zero remote command failures", async () => {
+        vi.spyOn(ssh, "runSshCommand").mockRejectedValue(Object.assign(new Error("non-zero exit"), {
+            code: 17,
+            stdout: "partial stdout",
+            stderr: "partial stderr",
+            signal: null,
+        }));
+        const onLog = vi.fn(async () => { });
+        const result = await runAdapterExecutionTargetShellCommand("run-3", {
+            kind: "remote",
+            transport: "ssh",
+            remoteCwd: "/srv/paperclip/workspace",
+            spec: {
+                host: "ssh.example.test",
+                port: 22,
+                username: "ssh-user",
+                remoteCwd: "/srv/paperclip/workspace",
+                remoteWorkspacePath: "/srv/paperclip/workspace",
+                privateKey: null,
+                knownHosts: null,
+                strictHostKeyChecking: true,
+            },
+        }, "false", {
+            cwd: "/tmp/local",
+            env: {},
+            onLog,
+        });
+        expect(result).toMatchObject({
+            exitCode: 17,
+            signal: null,
+            timedOut: false,
+            stdout: "partial stdout",
+            stderr: "partial stderr",
+        });
+        expect(onLog).toHaveBeenCalledWith("stdout", "partial stdout");
+        expect(onLog).toHaveBeenCalledWith("stderr", "partial stderr");
+    });
+    it("keeps managed homes disabled for both local and SSH targets", () => {
+        expect(adapterExecutionTargetUsesManagedHome(null)).toBe(false);
+        expect(adapterExecutionTargetUsesManagedHome({
+            kind: "remote",
+            transport: "ssh",
+            remoteCwd: "/srv/paperclip/workspace",
+            spec: {
+                host: "ssh.example.test",
+                port: 22,
+                username: "ssh-user",
+                remoteCwd: "/srv/paperclip/workspace",
+                remoteWorkspacePath: "/srv/paperclip/workspace",
+                privateKey: null,
+                knownHosts: null,
+                strictHostKeyChecking: true,
+            },
+        })).toBe(false);
+    });
+});
+//# sourceMappingURL=execution-target.test.js.map

package/dist/execution-target.test.js.map

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

package/dist/remote-managed-runtime.d.ts

@@ -0,0 +1,32 @@
+import { type SshRemoteExecutionSpec } from "./ssh.js";
+export interface RemoteManagedRuntimeAsset {
+    key: string;
+    localDir: string;
+    followSymlinks?: boolean;
+    exclude?: string[];
+}
+export interface PreparedRemoteManagedRuntime {
+    spec: SshRemoteExecutionSpec;
+    workspaceLocalDir: string;
+    workspaceRemoteDir: string;
+    runtimeRootDir: string;
+    assetDirs: Record<string, string>;
+    restoreWorkspace(): Promise<void>;
+}
+export declare function buildRemoteExecutionSessionIdentity(spec: SshRemoteExecutionSpec | null): {
+    readonly paperclipApiUrl?: string | undefined;
+    readonly transport: "ssh";
+    readonly host: string;
+    readonly port: number;
+    readonly username: string;
+    readonly remoteCwd: string;
+} | null;
+export declare function remoteExecutionSessionMatches(saved: unknown, current: SshRemoteExecutionSpec | null): boolean;
+export declare function prepareRemoteManagedRuntime(input: {
+    spec: SshRemoteExecutionSpec;
+    adapterKey: string;
+    workspaceLocalDir: string;
+    workspaceRemoteDir?: string;
+    assets?: RemoteManagedRuntimeAsset[];
+}): Promise<PreparedRemoteManagedRuntime>;
+//# sourceMappingURL=remote-managed-runtime.d.ts.map

package/dist/remote-managed-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-managed-runtime.d.ts","sourceRoot":"","sources":["../src/remote-managed-runtime.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,sBAAsB,EAI5B,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,sBAAsB,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAgBD,wBAAgB,mCAAmC,CAAC,IAAI,EAAE,sBAAsB,GAAG,IAAI;;;;;;;SAUtF;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,sBAAsB,GAAG,IAAI,GAAG,OAAO,CAa7G;AAED,wBAAsB,2BAA2B,CAAC,KAAK,EAAE;IACvD,IAAI,EAAE,sBAAsB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,yBAAyB,EAAE,CAAC;CACtC,GAAG,OAAO,CAAC,4BAA4B,CAAC,CA8CxC"}

package/dist/remote-managed-runtime.js

@@ -0,0 +1,83 @@
+import path from "node:path";
+import { prepareWorkspaceForSshExecution, restoreWorkspaceFromSshExecution, syncDirectoryToSsh, } from "./ssh.js";
+function asObject(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+function asString(value) {
+    return typeof value === "string" ? value : "";
+}
+function asNumber(value) {
+    return typeof value === "number" ? value : Number(value);
+}
+export function buildRemoteExecutionSessionIdentity(spec) {
+    if (!spec)
+        return null;
+    return {
+        transport: "ssh",
+        host: spec.host,
+        port: spec.port,
+        username: spec.username,
+        remoteCwd: spec.remoteCwd,
+        ...(spec.paperclipApiUrl ? { paperclipApiUrl: spec.paperclipApiUrl } : {}),
+    };
+}
+export function remoteExecutionSessionMatches(saved, current) {
+    const currentIdentity = buildRemoteExecutionSessionIdentity(current);
+    if (!currentIdentity)
+        return false;
+    const parsedSaved = asObject(saved);
+    return (asString(parsedSaved.transport) === currentIdentity.transport &&
+        asString(parsedSaved.host) === currentIdentity.host &&
+        asNumber(parsedSaved.port) === currentIdentity.port &&
+        asString(parsedSaved.username) === currentIdentity.username &&
+        asString(parsedSaved.remoteCwd) === currentIdentity.remoteCwd &&
+        asString(parsedSaved.paperclipApiUrl) === asString(currentIdentity.paperclipApiUrl));
+}
+export async function prepareRemoteManagedRuntime(input) {
+    const workspaceRemoteDir = input.workspaceRemoteDir ?? input.spec.remoteCwd;
+    const runtimeRootDir = path.posix.join(workspaceRemoteDir, ".paperclip-runtime", input.adapterKey);
+    await prepareWorkspaceForSshExecution({
+        spec: input.spec,
+        localDir: input.workspaceLocalDir,
+        remoteDir: workspaceRemoteDir,
+    });
+    const assetDirs = {};
+    try {
+        for (const asset of input.assets ?? []) {
+            const remoteDir = path.posix.join(runtimeRootDir, asset.key);
+            assetDirs[asset.key] = remoteDir;
+            await syncDirectoryToSsh({
+                spec: input.spec,
+                localDir: asset.localDir,
+                remoteDir,
+                followSymlinks: asset.followSymlinks,
+                exclude: asset.exclude,
+            });
+        }
+    }
+    catch (error) {
+        await restoreWorkspaceFromSshExecution({
+            spec: input.spec,
+            localDir: input.workspaceLocalDir,
+            remoteDir: workspaceRemoteDir,
+        });
+        throw error;
+    }
+    return {
+        spec: input.spec,
+        workspaceLocalDir: input.workspaceLocalDir,
+        workspaceRemoteDir,
+        runtimeRootDir,
+        assetDirs,
+        restoreWorkspace: async () => {
+            await restoreWorkspaceFromSshExecution({
+                spec: input.spec,
+                localDir: input.workspaceLocalDir,
+                remoteDir: workspaceRemoteDir,
+            });
+        },
+    };
+}
+//# sourceMappingURL=remote-managed-runtime.js.map

package/dist/remote-managed-runtime.js.map

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