@skaile/workspaces 0.21.0 → 0.22.0-beta.1

package/dist/core/src/workspace-yaml-editor.d.ts

@@ -11,11 +11,11 @@
  *
  *   const editor = WorkspaceYamlEditor.load('/project/skaile.yaml')
  *   editor.setAgentConfig('default', { driver: 'claude-sdk', model: 'claude-sonnet-4-6' })
- *   editor.addAiResource({ name: 'skaile', path: './ai-assets' })
+ *   editor.setSource({ url: 'https://github.com/skaile-ai/ai-assets' })
  *   editor.save()
  */
 import { Document } from "yaml";
-import type { AgentConfigProfile, AiResourceEntry, ConnectorDeclaration, SourceEntry } from "./workspace-config.js";
+import type { AgentConfigProfile, AssetEntry, ConnectorDeclaration, OverrideEntry, SourceEntry, StoreEntry } from "./workspace-config.js";
 /**
  * Comment-preserving editor for `skaile.yaml` files.
  * Uses the `yaml` library's Document AST so untouched sections remain byte-identical.
@@ -53,30 +53,67 @@ export declare class WorkspaceYamlEditor {
      */
     deleteAgentConfigField(profile: string, field: string): void;
     private _getAgentConfigSection;
-    /** Get all ai_resources entries. */
-    getAiResources(): AiResourceEntry[];
-    /**
-     * Add or update an AI resource entry by name.
-     * If an entry with the same name exists, it is replaced.
-     */
-    setAiResource(entry: AiResourceEntry): void;
-    /** Remove an AI resource entry by name. */
-    removeAiResource(name: string): boolean;
+    /** Get the publication-half `publisher:` field. */
+    getPublisher(): string | undefined;
+    /** Set the publication-half `publisher:` field. */
+    setPublisher(p: string): void;
+    /** Get the publication-half `version:` field. */
+    getVersion(): string | undefined;
+    /** Set the publication-half `version:` field. */
+    setVersion(v: string): void;
     /** Get all connectors. */
     getConnectors(): ConnectorDeclaration[];
     /** Add or update a connector by id. */
     setConnector(connector: ConnectorDeclaration): void;
     /** Remove a connector by id. */
     removeConnector(id: string): boolean;
-    /** Get all source entries. */
+    /** Get all `plugins:` specifiers. */
+    getPlugins(): string[];
+    /**
+     * Add a plugin specifier to `plugins:`, deduped by package name.
+     * If an entry with the same package name exists it is replaced (so a version
+     * bump re-pins in place); otherwise the spec is appended.
+     *
+     * @param spec - npm specifier, e.g. `"@skaile/provider-fly@^0.1.0"`.
+     * @param nameOf - Extracts the package name from a spec (caller passes `parseSpec`-derived names).
+     * @returns `true` when an existing entry was replaced, `false` when appended.
+     */
+    addPlugin(spec: string, nameOf: (s: string) => string): boolean;
+    /**
+     * Remove the `plugins:` entry whose package name matches `name`.
+     *
+     * @param name - Package name to remove (e.g. `"@skaile/provider-fly"`).
+     * @param nameOf - Extracts the package name from a spec.
+     * @returns `true` when an entry was removed.
+     */
+    removePlugin(name: string, nameOf: (s: string) => string): boolean;
+    /** Get all source entries (`{url, pin?}`). */
     getSources(): SourceEntry[];
     /**
-     * Add or update a source entry by name.
-     * If an entry with the same name exists, it is replaced.
+     * Add or update a source entry, matched by `url`.
+     * If an entry with the same url exists, it is replaced.
      */
     setSource(entry: SourceEntry): void;
-    /** Remove a source entry by name. Returns true when an entry was removed. */
-    removeSource(name: string): boolean;
+    /** Remove a source entry by url. Returns true when an entry was removed. */
+    removeSource(url: string): boolean;
+    /** Get all store entries (`{url}`). */
+    getStores(): StoreEntry[];
+    /** Add or update a store entry, matched by `url`. */
+    setStore(entry: StoreEntry): void;
+    /** Remove a store entry by url. Returns true when an entry was removed. */
+    removeStore(url: string): boolean;
+    /** Get all override entries (`{ref, source, reason}`). */
+    getOverrides(): OverrideEntry[];
+    /** Add or update an override entry, matched by `ref`. */
+    setOverride(entry: OverrideEntry): void;
+    /** Remove an override entry by ref. Returns true when an entry was removed. */
+    removeOverride(ref: string): boolean;
+    /** Get all publication-half `assets:` entries. */
+    getPublicationAssets(): AssetEntry[];
+    /** Add or update a publication asset entry, matched by `kind` + `name`. */
+    setPublicationAsset(entry: AssetEntry): void;
+    /** Remove a publication asset entry by kind + name. Returns true when removed. */
+    removePublicationAsset(kind: string, name: string): boolean;
     /** Get the underlying yaml Document for advanced manipulation. */
     get document(): Document;
 }

package/dist/core/src/workspace-yaml-editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-yaml-editor.d.ts","sourceRoot":"","sources":["../../../core/src/workspace-yaml-editor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,QAAQ,EAA6C,MAAM,MAAM,CAAC;AAC3E,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAE/B;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,GAAG,CAAW;IAEtB,OAAO;IAKP,yCAAyC;IACzC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB;IASlD,qEAAqE;IACrE,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB;IAKpD,2EAA2E;IAC3E,IAAI,IAAI,IAAI;IAIZ,iEAAiE;IACjE,QAAQ,IAAI,MAAM;IAMlB,wDAAwD;IACxD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,GAAG,SAAS;IAKpD,oCAAoC;IACpC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMrD;;;OAGG;IACH,cAAc,CAAC,OAAO,SAAY,GAAG,kBAAkB,GAAG,SAAS;IAOnE;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI;IAoB1E;;OAEG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAS5D,OAAO,CAAC,sBAAsB;IAQ9B,oCAAoC;IACpC,cAAc,IAAI,eAAe,EAAE;IAMnC;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IA4B3C,2CAA2C;IAC3C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAgBvC,0BAA0B;IAC1B,aAAa,IAAI,oBAAoB,EAAE;IAMvC,uCAAuC;IACvC,YAAY,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI;IAwBnD,gCAAgC;IAChC,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAiBpC,8BAA8B;IAC9B,UAAU,IAAI,WAAW,EAAE;IAM3B;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAuBnC,6EAA6E;IAC7E,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAgBnC,kEAAkE;IAClE,IAAI,QAAQ,IAAI,QAAQ,CAEvB;CACF"}
+{"version":3,"file":"workspace-yaml-editor.d.ts","sourceRoot":"","sources":["../../../core/src/workspace-yaml-editor.ts"],"names":[],"mappings":"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"}

package/dist/core/store.d.ts

@@ -0,0 +1,2 @@
+// Auto-generated by _scripts/emit-dts-sidecars.ts — do not edit by hand.
+export * from "./src/store.js";

package/dist/core/workspace-config.d.ts

@@ -0,0 +1,2 @@
+// Auto-generated by _scripts/emit-dts-sidecars.ts — do not edit by hand.
+export * from "./src/workspace-config.js";

package/dist/core/workspace-config.js

@@ -1,6 +1,6 @@
-export { COMPACTION_DEFAULTS, SKAILE_YAML_DEFAULT, SKAILE_YAML_SUFFIX, SK_WORKSPACE_DEFAULT_NAME, SK_WORKSPACE_SUFFIX, decodeSkaileYaml, encodeSkaileYaml, findWorkspaceRoot, isWorkspaceConfigFilename, listSkWorkspaceConfigs, loadMcpServerDeclarations, loadSkWorkspaceConfig, mergeSkWorkspaceConfigs, normalizeConfig, resolveAgentDir, resolveSkWorkspaceConfig, saveSkWorkspaceConfig, validateAssetRecipeAttr, workspaceConfigFilename, workspaceNameFromFilename } from '../chunk-5QNQLSBW.js';
-import '../chunk-FRPKLIEZ.js';
-import '../chunk-37JKX6D7.js';
+export { COMPACTION_DEFAULTS, DEFAULT_RECIPE_ATTR, SKAILE_YAML_DEFAULT, SKAILE_YAML_SUFFIX, SK_WORKSPACE_DEFAULT_NAME, SK_WORKSPACE_SUFFIX, decodeSkaileYaml, encodeSkaileYaml, findWorkspaceRoot, isWorkspaceConfigFilename, listSkWorkspaceConfigs, loadMcpServerDeclarations, loadSkWorkspaceConfig, mergeSkWorkspaceConfigs, normalizeConfig, resolveAgentDir, resolveSkWorkspaceConfig, saveSkWorkspaceConfig, validateAssetRecipeAttr, validateAssetRecipeFlake, workspaceConfigFilename, workspaceNameFromFilename } from '../chunk-J3VKAEQP.js';
+import '../chunk-4AZKT2BU.js';
+import '../chunk-I3UEM3FX.js';
 import '../chunk-NSBPE2FW.js';
 //# sourceMappingURL=workspace-config.js.map
 //# sourceMappingURL=workspace-config.js.map

package/dist/deploy/index.d.ts

@@ -0,0 +1,2 @@
+// Auto-generated by _scripts/emit-dts-sidecars.ts — do not edit by hand.
+export * from "./src/index.js";

package/dist/deploy/index.js

@@ -0,0 +1,473 @@
+import { pluginRegistry } from '../chunk-6E6PKKAD.js';
+import { portableSpawnSync, portableSpawn } from '../chunk-UMOENHVH.js';
+import '../chunk-K5GBV4SA.js';
+import '../chunk-KLNL7QHN.js';
+import '../chunk-GFNW72LW.js';
+import '../chunk-J3VKAEQP.js';
+import '../chunk-4AZKT2BU.js';
+import '../chunk-I3UEM3FX.js';
+import '../chunk-JKNWJ64A.js';
+import '../chunk-O4JH3KUE.js';
+import '../chunk-24UIWON4.js';
+import '../chunk-NSBPE2FW.js';
+import * as z from 'zod';
+import { createServer } from 'net';
+import { createRequire } from 'module';
+import { join, dirname, resolve } from 'path';
+import { mkdir, writeFile, readFile, rm } from 'fs/promises';
+
+function allocateFreePort(host = "127.0.0.1") {
+  return new Promise((resolve, reject) => {
+    const server = createServer();
+    server.once("error", reject);
+    server.listen(0, host, () => {
+      const addr = server.address();
+      if (addr === null || typeof addr === "string") {
+        server.close();
+        reject(new Error("could not determine allocated port"));
+        return;
+      }
+      const { port } = addr;
+      server.close(() => resolve(port));
+    });
+  });
+}
+
+// deploy/src/targets/stream-lines.ts
+var LineBuffer = class {
+  constructor(max = 1e3) {
+    this.max = max;
+  }
+  max;
+  lines = [];
+  waiters = /* @__PURE__ */ new Set();
+  push(line) {
+    const entry = { ts: Date.now(), line };
+    this.lines.push(entry);
+    if (this.lines.length > this.max) this.lines.shift();
+    for (const w of this.waiters) w(entry);
+  }
+  /** Snapshot of buffered lines at or after `sinceMs` (epoch millis). */
+  since(sinceMs = 0) {
+    return this.lines.filter((l) => l.ts >= sinceMs);
+  }
+  /** Subscribe to future pushes; returns an unsubscribe fn. */
+  subscribe(fn) {
+    this.waiters.add(fn);
+    return () => this.waiters.delete(fn);
+  }
+};
+async function pumpLines(stream, buffer) {
+  const reader = stream.getReader();
+  const decoder = new TextDecoder();
+  let pending = "";
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      pending += decoder.decode(value, { stream: true });
+      let idx = pending.indexOf("\n");
+      while (idx !== -1) {
+        buffer.push(pending.slice(0, idx));
+        pending = pending.slice(idx + 1);
+        idx = pending.indexOf("\n");
+      }
+    }
+  } catch {
+  } finally {
+    if (pending.length > 0) buffer.push(pending);
+    reader.releaseLock();
+  }
+}
+function waitForLine(buffer, pattern, opts) {
+  for (const { line } of buffer.since(0)) {
+    if (pattern.test(line)) return Promise.resolve();
+  }
+  return new Promise((resolve, reject) => {
+    let settled = false;
+    const finish = (fn) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      unsub();
+      opts.signal.removeEventListener("abort", onAbort);
+      fn();
+    };
+    const unsub = buffer.subscribe(({ line }) => {
+      if (pattern.test(line)) finish(resolve);
+    });
+    const onAbort = () => finish(() => reject(new Error("aborted while waiting for ready line")));
+    const timer = setTimeout(
+      () => finish(
+        () => reject(new Error(`timed out after ${opts.timeoutMs}ms waiting for ready line`))
+      ),
+      opts.timeoutMs
+    );
+    if (opts.signal.aborted) onAbort();
+    else opts.signal.addEventListener("abort", onAbort);
+  });
+}
+
+// deploy/src/targets/container-runtime.ts
+var LOOPBACK_BINDS = /* @__PURE__ */ new Set(["127.0.0.1", "localhost", "::1"]);
+var DEFAULT_READY_PATTERN = "ws://";
+var DEFAULT_READY_TIMEOUT_MS = 6e4;
+var containerConfigSchema = z.object({
+  image: z.string(),
+  port: z.number().int().positive().optional(),
+  bind: z.string().default("127.0.0.1"),
+  mounts: z.array(z.string()).default([]),
+  env: z.record(z.string(), z.string()).default({}),
+  network: z.string().optional(),
+  pullPolicy: z.enum(["always", "if-missing", "never"]).default("if-missing"),
+  // "local" only — this target runs a prebuilt image and has no in-provider builder.
+  // The full buildStrategySchema (local/remote/managed) lives in plugin-registry for the provider-* packages that implement remote builds.
+  buildStrategy: z.literal("local").default("local"),
+  containerPort: z.number().int().positive().optional(),
+  readyPattern: z.string().optional()
+}).strict().refine((c) => LOOPBACK_BINDS.has(c.bind), {
+  message: "non-loopback bind requires tls config (not yet supported); use a loopback bind",
+  path: ["bind"]
+});
+function payloadSchemaFor(bin) {
+  return z.object({
+    containerId: z.string(),
+    hostPort: z.number(),
+    runtime: z.enum(["docker", "podman"]).refine((r) => r === bin, {
+      message: `runtime mismatch: handle belongs to ${bin}`
+    }),
+    // Older handles predate `bind`; default to loopback so restore stays valid.
+    bind: z.string().default("127.0.0.1")
+  });
+}
+function pullFlag(policy) {
+  const mapped = policy === "if-missing" ? "missing" : policy;
+  return ["--pull", mapped];
+}
+async function readStream(stream) {
+  const reader = stream.getReader();
+  const decoder = new TextDecoder();
+  let out = "";
+  try {
+    for (; ; ) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      if (value) out += decoder.decode(value, { stream: true });
+    }
+  } finally {
+    reader.releaseLock();
+  }
+  return out + decoder.decode();
+}
+async function isRunning(bin, containerId) {
+  const proc = portableSpawn([bin, "inspect", "-f", "{{.State.Running}}", containerId]);
+  const [exitCode, stdout] = await Promise.all([proc.exited, readStream(proc.stdout)]);
+  return exitCode === 0 && stdout.trim() === "true";
+}
+function buildHandle(bin, payload, config, ctx, ready) {
+  let state = "starting";
+  let followProc = null;
+  return {
+    wsUrl: `ws://${config.bind}:${payload.hostPort}`,
+    get state() {
+      return state;
+    },
+    payload,
+    async waitReady(timeoutMs) {
+      try {
+        await ready();
+        state = "ready";
+      } catch (err) {
+        state = "errored";
+        throw err;
+      }
+    },
+    async health() {
+      const healthy = await isRunning(bin, payload.containerId);
+      return healthy ? { healthy } : { healthy, detail: `container ${payload.containerId} not running` };
+    },
+    async *logs(opts) {
+      const buffer = new LineBuffer();
+      const args = ["logs"];
+      if (opts?.follow) args.push("--follow");
+      followProc = portableSpawn([bin, ...args, payload.containerId]);
+      void pumpLines(followProc.stdout, buffer);
+      void pumpLines(followProc.stderr, buffer);
+      const since = opts?.sinceMs ?? 0;
+      if (!opts?.follow) await followProc.exited;
+      for (const l of buffer.since(since)) yield l;
+      if (!opts?.follow) return;
+      const queue = [];
+      let notify = null;
+      const unsub = buffer.subscribe((l) => {
+        queue.push(l);
+        notify?.();
+      });
+      try {
+        while (!ctx.signal.aborted) {
+          if (queue.length === 0) {
+            await new Promise((r) => {
+              notify = r;
+            });
+            notify = null;
+          }
+          while (queue.length > 0) yield queue.shift();
+        }
+      } finally {
+        unsub();
+        followProc?.kill("SIGTERM");
+      }
+    },
+    async stop() {
+      state = "stopping";
+      followProc?.kill("SIGTERM");
+      portableSpawnSync([bin, "rm", "-f", payload.containerId]);
+      state = "stopped";
+    }
+  };
+}
+function makeContainerDeployTarget(bin) {
+  const payloadSchema = payloadSchemaFor(bin);
+  return {
+    id: bin,
+    displayName: bin === "docker" ? "Docker container" : "Podman container",
+    apiVersion: 1,
+    tlsTermination: "none",
+    configSchema: containerConfigSchema,
+    payloadSchema,
+    async create(config, ctx) {
+      const log = ctx.log;
+      const hostPort = config.port ?? await allocateFreePort(config.bind);
+      const containerPort = config.containerPort ?? hostPort;
+      const name = `skaile-ws-${ctx.workspaceId}`;
+      const pattern = new RegExp(config.readyPattern ?? DEFAULT_READY_PATTERN);
+      const args = [
+        bin,
+        "run",
+        "-d",
+        "--name",
+        name,
+        "-p",
+        `${config.bind}:${hostPort}:${containerPort}`,
+        ...pullFlag(config.pullPolicy)
+      ];
+      if (config.network) args.push("--network", config.network);
+      for (const [k, v] of Object.entries(config.env)) args.push("-e", `${k}=${v}`);
+      for (const m of config.mounts) args.push("-v", m);
+      args.push(config.image);
+      const runRes = portableSpawnSync(args);
+      if (runRes.exitCode !== 0) {
+        throw new Error(`${bin} run failed: ${runRes.stderr.trim() || runRes.stdout.trim()}`);
+      }
+      const containerId = runRes.stdout.trim();
+      log.info("container started", { runtime: bin, containerId, hostPort });
+      const payload = { containerId, hostPort, runtime: bin, bind: config.bind };
+      const ready = async () => {
+        const buffer = new LineBuffer();
+        const logProc = portableSpawn([bin, "logs", "--follow", containerId]);
+        void pumpLines(logProc.stdout, buffer);
+        void pumpLines(logProc.stderr, buffer);
+        try {
+          await waitForLine(buffer, pattern, {
+            timeoutMs: DEFAULT_READY_TIMEOUT_MS,
+            signal: ctx.signal
+          });
+        } finally {
+          logProc.kill("SIGTERM");
+        }
+      };
+      return buildHandle(bin, payload, config, ctx, ready);
+    },
+    async restore(payload, ctx) {
+      const log = ctx.log;
+      if (!await isRunning(bin, payload.containerId)) {
+        throw new Error(`${bin} container ${payload.containerId} is not running`);
+      }
+      log.info("re-attached to container", { runtime: bin, containerId: payload.containerId });
+      return buildHandle(
+        bin,
+        payload,
+        { bind: payload.bind},
+        ctx,
+        async () => {
+        }
+      );
+    }
+  };
+}
+
+// deploy/src/targets/docker.ts
+var dockerDeployTarget = makeContainerDeployTarget("docker");
+var localConfigSchema = z.object({
+  port: z.number().int().positive().optional(),
+  env: z.record(z.string(), z.string()).optional(),
+  cwd: z.string().optional(),
+  command: z.string().optional(),
+  args: z.array(z.string()).optional(),
+  // `skaile serve` emits structured logs rather than a single banner; the
+  // ws:// URL line is the most stable readiness marker.
+  readyPattern: z.string().optional()
+}).strict().default({});
+var localPayloadSchema = z.object({
+  pid: z.number(),
+  port: z.number(),
+  cwd: z.string()
+});
+var DEFAULT_READY_PATTERN2 = "ws://";
+var DEFAULT_READY_TIMEOUT_MS2 = 3e4;
+function resolveSkaileBin() {
+  const require2 = createRequire(import.meta.url);
+  const pkgPath = require2.resolve("@skaile/workspaces/package.json");
+  const pkg = require2("@skaile/workspaces/package.json");
+  const rel = pkg.bin?.skaile ?? "dist/cli/index.js";
+  return resolve(dirname(pkgPath), rel);
+}
+function pidAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function buildHandle2(payload, ctx, ready, proc) {
+  let state = proc ? "starting" : "ready";
+  return {
+    wsUrl: `ws://127.0.0.1:${payload.port}`,
+    get state() {
+      return state;
+    },
+    payload,
+    async waitReady(timeoutMs) {
+      try {
+        await ready();
+        state = "ready";
+      } catch (err) {
+        state = "errored";
+        throw err;
+      }
+    },
+    async health() {
+      const healthy = pidAlive(payload.pid);
+      return healthy ? { healthy } : { healthy, detail: `pid ${payload.pid} not alive` };
+    },
+    async *logs(opts) {
+      if (!proc) return;
+      const since = opts?.sinceMs ?? 0;
+      for (const l of proc.buffer.since(since)) yield l;
+      if (!opts?.follow) return;
+      const queue = [];
+      let notify = null;
+      const unsub = proc.buffer.subscribe((l) => {
+        queue.push(l);
+        notify?.();
+      });
+      try {
+        while (!ctx.signal.aborted) {
+          if (queue.length === 0) {
+            await new Promise((r) => {
+              notify = r;
+            });
+            notify = null;
+          }
+          while (queue.length > 0) yield queue.shift();
+        }
+      } finally {
+        unsub();
+      }
+    },
+    async stop() {
+      state = "stopping";
+      if (pidAlive(payload.pid)) {
+        try {
+          process.kill(payload.pid, "SIGTERM");
+        } catch {
+        }
+      }
+      state = "stopped";
+    }
+  };
+}
+var localDeployTarget = {
+  id: "local",
+  displayName: "Local process",
+  apiVersion: 1,
+  tlsTermination: "none",
+  configSchema: localConfigSchema,
+  payloadSchema: localPayloadSchema,
+  async create(config, ctx) {
+    const log = ctx.log;
+    const port = config.port ?? await allocateFreePort();
+    const cwd = config.cwd ?? process.cwd();
+    const command = config.command ?? resolveSkaileBin();
+    const args = config.args ?? ["serve", "--port", String(port)];
+    const pattern = new RegExp(config.readyPattern ?? DEFAULT_READY_PATTERN2);
+    const proc = portableSpawn([command, ...args], {
+      cwd,
+      env: { ...process.env, ...config.env }
+    });
+    const buffer = new LineBuffer();
+    void pumpLines(proc.stdout, buffer);
+    void pumpLines(proc.stderr, buffer);
+    log.info("local process spawned", { pid: proc.pid, port, command });
+    const payload = { pid: proc.pid, port, cwd };
+    const ready = () => waitForLine(buffer, pattern, { timeoutMs: DEFAULT_READY_TIMEOUT_MS2, signal: ctx.signal });
+    return buildHandle2(payload, ctx, ready, { buffer });
+  },
+  async restore(payload, ctx) {
+    const log = ctx.log;
+    if (!pidAlive(payload.pid)) {
+      throw new Error(`local deploy pid ${payload.pid} is no longer alive`);
+    }
+    log.info("re-attached to local process", { pid: payload.pid, port: payload.port });
+    return buildHandle2(payload, ctx, async () => {
+    }, null);
+  }
+};
+
+// deploy/src/targets/podman.ts
+var podmanDeployTarget = makeContainerDeployTarget("podman");
+var storedHandleSchema = z.object({
+  targetId: z.string().min(1),
+  payload: z.unknown()
+});
+function handlePath(projectDir) {
+  return join(projectDir, ".skaile", "deploy", "handle.json");
+}
+async function writeHandle(projectDir, targetId, payload) {
+  const path = handlePath(projectDir);
+  await mkdir(dirname(path), { recursive: true });
+  const envelope = { targetId, payload };
+  await writeFile(path, `${JSON.stringify(envelope, null, 2)}
+`, "utf8");
+}
+async function readHandle(projectDir) {
+  let raw;
+  try {
+    raw = await readFile(handlePath(projectDir), "utf8");
+  } catch {
+    return null;
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return null;
+  }
+  const result = storedHandleSchema.safeParse(parsed);
+  return result.success ? result.data : null;
+}
+async function clearHandle(projectDir) {
+  await rm(handlePath(projectDir), { force: true });
+}
+
+// deploy/src/index.ts
+function registerBuiltinDeployTargets(registry = pluginRegistry) {
+  for (const t of [localDeployTarget, dockerDeployTarget, podmanDeployTarget]) {
+    if (!registry.get("deployTarget", t.id)) registry.register("deployTarget", t);
+  }
+}
+
+export { clearHandle, dockerDeployTarget, handlePath, localDeployTarget, makeContainerDeployTarget, podmanDeployTarget, readHandle, registerBuiltinDeployTargets, writeHandle };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map