@skaile/workspaces 0.8.5

package/dist/chunk-FVTV7M76.js

@@ -0,0 +1,30 @@
+// base-assets/connectors/flow/stimulus-driver.ts
+function computeStimulus(oldExec, newExec) {
+  if (!oldExec) {
+    return { kind: "state_changed" };
+  }
+  if (oldExec === newExec) {
+    return null;
+  }
+  if (snapshotsEqual(oldExec, newExec)) {
+    return null;
+  }
+  return { kind: "state_changed" };
+}
+function snapshotsEqual(a, b) {
+  if (a === b) return true;
+  if (a.runId !== b.runId) return false;
+  if (a.flowId !== b.flowId) return false;
+  if (a.status !== b.status) return false;
+  if (a.done !== b.done) return false;
+  if (a.autonomousMode !== b.autonomousMode) return false;
+  try {
+    return JSON.stringify(a) === JSON.stringify(b);
+  } catch {
+    return false;
+  }
+}
+
+export { computeStimulus };
+//# sourceMappingURL=chunk-FVTV7M76.js.map
+//# sourceMappingURL=chunk-FVTV7M76.js.map

package/dist/chunk-FVTV7M76.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../base-assets/connectors/flow/stimulus-driver.ts"],"names":[],"mappings":";AA0CO,SAAS,eAAA,CACd,SACA,OAAA,EACqB;AAGrB,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,OAAO,EAAE,MAAM,eAAA,EAAgB;AAAA,EACjC;AAIA,EAAA,IAAI,YAAY,OAAA,EAAS;AACvB,IAAA,OAAO,IAAA;AAAA,EACT;AAKA,EAAA,IAAI,cAAA,CAAe,OAAA,EAAS,OAAO,CAAA,EAAG;AACpC,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,OAAO,EAAE,MAAM,eAAA,EAAgB;AACjC;AASA,SAAS,cAAA,CAAe,GAAkB,CAAA,EAA2B;AACnE,EAAA,IAAI,CAAA,KAAM,GAAG,OAAO,IAAA;AAGpB,EAAA,IAAI,CAAA,CAAE,KAAA,KAAU,CAAA,CAAE,KAAA,EAAO,OAAO,KAAA;AAChC,EAAA,IAAI,CAAA,CAAE,MAAA,KAAW,CAAA,CAAE,MAAA,EAAQ,OAAO,KAAA;AAClC,EAAA,IAAI,CAAA,CAAE,MAAA,KAAW,CAAA,CAAE,MAAA,EAAQ,OAAO,KAAA;AAClC,EAAA,IAAI,CAAA,CAAE,IAAA,KAAS,CAAA,CAAE,IAAA,EAAM,OAAO,KAAA;AAC9B,EAAA,IAAI,CAAA,CAAE,cAAA,KAAmB,CAAA,CAAE,cAAA,EAAgB,OAAO,KAAA;AAElD,EAAA,IAAI;AACF,IAAA,OAAO,KAAK,SAAA,CAAU,CAAC,CAAA,KAAM,IAAA,CAAK,UAAU,CAAC,CAAA;AAAA,EAC/C,CAAA,CAAA,MAAQ;AAGN,IAAA,OAAO,KAAA;AAAA,EACT;AACF","file":"chunk-FVTV7M76.js","sourcesContent":["/**\n * Pure state-change → stimulus translator for the flow connector.\n *\n * Given the previous and current {@link FlowExecution} snapshots, decides\n * whether the runner should be woken with a fresh turn and (if so) what\n * kind of stimulus to render. Returns `null` when no turn is warranted\n * (e.g. the snapshots are deep-equal).\n *\n * Today's FlowOrchestrator subscribes to `adapter.onStateChange(...)` and\n * forwards the snapshot to the host without kicking a turn — the host\n * issues explicit turn-kicking commands (`approve_flow_node`, etc.). Phase\n * 3 of the flow-connector extraction adds this function as the connector-\n * side decision point so a future direct path (FlowAdapter →\n * SessionStimulusBus → runner) can reproduce today's coalesced \"state\n * changed → maybe a turn\" semantics without going through the orchestrator.\n *\n * Default behaviour mirrors today exactly: any structural change in the\n * FlowExecution snapshot produces a single `{ kind: \"state_changed\" }`\n * stimulus. Phase 4 may refine this with kind discriminators (approval-\n * received, input-received, etc.) once the orchestrator's onStateChange\n * subscription is removed; until then we keep gating purely on equality.\n *\n * @docLink packages/base-assets/flow#stimulus-driver\n */\n\nimport type { FlowExecution } from \"@skaile/workspaces/types\";\nimport type { TurnStimulus } from \"./prompt-fragments.js\";\n\n/**\n * Decide whether a state transition warrants kicking an agent turn, and\n * which kind of stimulus to render. Returns `null` to suppress turn-kicking\n * when nothing observable changed.\n *\n * Pure — depends only on its inputs.\n *\n * @param oldExec - Previous FlowExecution snapshot (or `undefined` on the\n *   first emission, e.g. immediately after `connect()`).\n * @param newExec - Current FlowExecution snapshot.\n * @returns A {@link TurnStimulus} when a turn should be kicked, or `null`.\n *\n * @docLink packages/base-assets/flow#compute-stimulus\n */\nexport function computeStimulus(\n  oldExec: FlowExecution | undefined,\n  newExec: FlowExecution,\n): TurnStimulus | null {\n  // First emission (no prior snapshot) — treat as a full state change so\n  // downstream consumers can latch onto the initial state.\n  if (!oldExec) {\n    return { kind: \"state_changed\" };\n  }\n\n  // Identity short-circuit (cheap; mutate() returns a fresh object on every\n  // change so reference inequality is the common case).\n  if (oldExec === newExec) {\n    return null;\n  }\n\n  // Structural compare — JSON.stringify is good enough for FlowExecution\n  // because it has stable key ordering produced by the engine and contains\n  // no functions or class instances. Avoids pulling in a deep-equal dep.\n  if (snapshotsEqual(oldExec, newExec)) {\n    return null;\n  }\n\n  return { kind: \"state_changed\" };\n}\n\n/**\n * Cheap structural equality for two FlowExecution snapshots. Mirrors the\n * comparison the orchestrator's onStateChange subscription would do if it\n * cared (it currently re-fires unconditionally).\n *\n * @internal\n */\nfunction snapshotsEqual(a: FlowExecution, b: FlowExecution): boolean {\n  if (a === b) return true;\n  // Hot-path guard: differing top-level fields short-circuit before the\n  // expensive serialize.\n  if (a.runId !== b.runId) return false;\n  if (a.flowId !== b.flowId) return false;\n  if (a.status !== b.status) return false;\n  if (a.done !== b.done) return false;\n  if (a.autonomousMode !== b.autonomousMode) return false;\n\n  try {\n    return JSON.stringify(a) === JSON.stringify(b);\n  } catch {\n    // Defensive: if a snapshot somehow contains a circular ref the safe\n    // answer is \"treat as different\" so we don't suppress a real change.\n    return false;\n  }\n}\n"]}

package/dist/chunk-GCRKAFH7.js

@@ -0,0 +1,40 @@
+// connectors/src/rclone-config/onedrive.ts
+function renderOneDriveConfig(opts) {
+  const tokenObj = {
+    access_token: opts.accessToken,
+    token_type: "Bearer"
+  };
+  if (opts.refreshToken) tokenObj.refresh_token = opts.refreshToken;
+  if (opts.expiresAtMs != null) {
+    tokenObj.expiry = new Date(opts.expiresAtMs).toISOString();
+  }
+  const lines = [];
+  lines.push(`[${opts.remoteName}]`);
+  lines.push("type = onedrive");
+  lines.push(`drive_id = ${opts.driveId}`);
+  lines.push(`drive_type = ${opts.driveType ?? "business"}`);
+  lines.push(`token = ${JSON.stringify(tokenObj)}`);
+  if (opts.clientId) lines.push(`client_id = ${opts.clientId}`);
+  if (opts.clientSecret) lines.push(`client_secret = ${opts.clientSecret}`);
+  if (opts.tenantId) lines.push(`tenant = ${opts.tenantId}`);
+  lines.push("");
+  return lines.join("\n");
+}
+
+// connectors/src/rclone-config/webdav.ts
+function renderWebDAVConfig(opts) {
+  const lines = [];
+  lines.push(`[${opts.remoteName}]`);
+  lines.push("type = webdav");
+  lines.push(`url = ${opts.url}`);
+  lines.push(`vendor = ${opts.vendor}`);
+  if (opts.username) lines.push(`user = ${opts.username}`);
+  if (opts.obscuredPassword) lines.push(`pass = ${opts.obscuredPassword}`);
+  if (opts.bearerToken) lines.push(`bearer_token = ${opts.bearerToken}`);
+  lines.push("");
+  return lines.join("\n");
+}
+
+export { renderOneDriveConfig, renderWebDAVConfig };
+//# sourceMappingURL=chunk-GCRKAFH7.js.map
+//# sourceMappingURL=chunk-GCRKAFH7.js.map

package/dist/chunk-GCRKAFH7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../connectors/src/rclone-config/onedrive.ts","../connectors/src/rclone-config/webdav.ts"],"names":[],"mappings":";AA+CO,SAAS,qBAAqB,IAAA,EAA2C;AAC9E,EAAA,MAAM,QAAA,GAAmC;AAAA,IACvC,cAAc,IAAA,CAAK,WAAA;AAAA,IACnB,UAAA,EAAY;AAAA,GACd;AACA,EAAA,IAAI,IAAA,CAAK,YAAA,EAAc,QAAA,CAAS,aAAA,GAAgB,IAAA,CAAK,YAAA;AACrD,EAAA,IAAI,IAAA,CAAK,eAAe,IAAA,EAAM;AAC5B,IAAA,QAAA,CAAS,SAAS,IAAI,IAAA,CAAK,IAAA,CAAK,WAAW,EAAE,WAAA,EAAY;AAAA,EAC3D;AAEA,EAAA,MAAM,QAAkB,EAAC;AACzB,EAAA,KAAA,CAAM,IAAA,CAAK,CAAA,CAAA,EAAI,IAAA,CAAK,UAAU,CAAA,CAAA,CAAG,CAAA;AACjC,EAAA,KAAA,CAAM,KAAK,iBAAiB,CAAA;AAC5B,EAAA,KAAA,CAAM,IAAA,CAAK,CAAA,WAAA,EAAc,IAAA,CAAK,OAAO,CAAA,CAAE,CAAA;AACvC,EAAA,KAAA,CAAM,IAAA,CAAK,CAAA,aAAA,EAAgB,IAAA,CAAK,SAAA,IAAa,UAAU,CAAA,CAAE,CAAA;AACzD,EAAA,KAAA,CAAM,KAAK,CAAA,QAAA,EAAW,IAAA,CAAK,SAAA,CAAU,QAAQ,CAAC,CAAA,CAAE,CAAA;AAChD,EAAA,IAAI,KAAK,QAAA,EAAU,KAAA,CAAM,KAAK,CAAA,YAAA,EAAe,IAAA,CAAK,QAAQ,CAAA,CAAE,CAAA;AAC5D,EAAA,IAAI,KAAK,YAAA,EAAc,KAAA,CAAM,KAAK,CAAA,gBAAA,EAAmB,IAAA,CAAK,YAAY,CAAA,CAAE,CAAA;AACxE,EAAA,IAAI,KAAK,QAAA,EAAU,KAAA,CAAM,KAAK,CAAA,SAAA,EAAY,IAAA,CAAK,QAAQ,CAAA,CAAE,CAAA;AACzD,EAAA,KAAA,CAAM,KAAK,EAAE,CAAA;AACb,EAAA,OAAO,KAAA,CAAM,KAAK,IAAI,CAAA;AACxB;;;AClBO,SAAS,mBAAmB,IAAA,EAAyC;AAC1E,EAAA,MAAM,QAAkB,EAAC;AACzB,EAAA,KAAA,CAAM,IAAA,CAAK,CAAA,CAAA,EAAI,IAAA,CAAK,UAAU,CAAA,CAAA,CAAG,CAAA;AACjC,EAAA,KAAA,CAAM,KAAK,eAAe,CAAA;AAC1B,EAAA,KAAA,CAAM,IAAA,CAAK,CAAA,MAAA,EAAS,IAAA,CAAK,GAAG,CAAA,CAAE,CAAA;AAC9B,EAAA,KAAA,CAAM,IAAA,CAAK,CAAA,SAAA,EAAY,IAAA,CAAK,MAAM,CAAA,CAAE,CAAA;AACpC,EAAA,IAAI,KAAK,QAAA,EAAU,KAAA,CAAM,KAAK,CAAA,OAAA,EAAU,IAAA,CAAK,QAAQ,CAAA,CAAE,CAAA;AACvD,EAAA,IAAI,KAAK,gBAAA,EAAkB,KAAA,CAAM,KAAK,CAAA,OAAA,EAAU,IAAA,CAAK,gBAAgB,CAAA,CAAE,CAAA;AACvE,EAAA,IAAI,KAAK,WAAA,EAAa,KAAA,CAAM,KAAK,CAAA,eAAA,EAAkB,IAAA,CAAK,WAAW,CAAA,CAAE,CAAA;AACrE,EAAA,KAAA,CAAM,KAAK,EAAE,CAAA;AACb,EAAA,OAAO,KAAA,CAAM,KAAK,IAAI,CAAA;AACxB","file":"chunk-GCRKAFH7.js","sourcesContent":["/**\n * Render an rclone INI config snippet for a single OneDrive/SharePoint remote.\n *\n * Pure helper — no IO, no logging — so it can be unit-tested by string compare.\n * The output is the full text for one `[<remoteName>]` section using rclone's\n * `onedrive` backend. The OAuth `token` field is a single-line JSON literal as\n * rclone expects.\n *\n * Lives in `@skaile/workspaces/connectors/rclone-config` so both consumers can\n * reach it: the in-container `sharepoint` mount driver\n * (`ai-assets-skaile/mounts/sharepoint/driver.ts`) and the platform-side\n * `RcloneFleetService` (`platform/backend/libs/session/`) which renders the\n * same INI on the host before spawning a shared rclone process.\n */\n\n/**\n * Options for `renderOneDriveConfig`. Carries OAuth token, drive ID, and optional tenant/client credentials.\n * @docLink packages/connectors/api-reference#render-one-drive-config-options\n */\nexport interface RenderOneDriveConfigOptions {\n  /** The rclone remote section name (e.g. `skaile-sharepoint`). */\n  remoteName: string;\n  /** Current OAuth access token. */\n  accessToken: string;\n  /** Long-lived refresh token (embedded in the rclone `token` JSON field). */\n  refreshToken?: string | null;\n  /** Expiry of the access token as a Unix timestamp in milliseconds. */\n  expiresAtMs?: number | null;\n  /** Azure tenant ID for MSAL authentication. */\n  tenantId?: string | null;\n  /** OAuth client (application) ID. */\n  clientId?: string | null;\n  /** OAuth client secret. */\n  clientSecret?: string | null;\n  /** OneDrive drive ID (required by the rclone `onedrive` backend). */\n  driveId: string;\n  /** Drive type. Defaults to `\"business\"`. */\n  driveType?: \"business\" | \"personal\" | \"documentLibrary\";\n}\n\n/**\n * Render an rclone INI config section for a OneDrive / SharePoint remote. Pure — no IO, no side effects.\n * The `token` field is serialised as a single-line JSON literal as rclone expects.\n * @param opts - Remote name, OAuth token, drive ID, and optional tenant/client credentials.\n * @returns Full INI text for one `[<remoteName>]` rclone section.\n * @docLink packages/connectors/api-reference#render-one-drive-config\n */\nexport function renderOneDriveConfig(opts: RenderOneDriveConfigOptions): string {\n  const tokenObj: Record<string, string> = {\n    access_token: opts.accessToken,\n    token_type: \"Bearer\",\n  };\n  if (opts.refreshToken) tokenObj.refresh_token = opts.refreshToken;\n  if (opts.expiresAtMs != null) {\n    tokenObj.expiry = new Date(opts.expiresAtMs).toISOString();\n  }\n\n  const lines: string[] = [];\n  lines.push(`[${opts.remoteName}]`);\n  lines.push(\"type = onedrive\");\n  lines.push(`drive_id = ${opts.driveId}`);\n  lines.push(`drive_type = ${opts.driveType ?? \"business\"}`);\n  lines.push(`token = ${JSON.stringify(tokenObj)}`);\n  if (opts.clientId) lines.push(`client_id = ${opts.clientId}`);\n  if (opts.clientSecret) lines.push(`client_secret = ${opts.clientSecret}`);\n  if (opts.tenantId) lines.push(`tenant = ${opts.tenantId}`);\n  lines.push(\"\");\n  return lines.join(\"\\n\");\n}\n","/**\n * Render an rclone INI config snippet for a single WebDAV remote.\n *\n * Pure helper -- no IO, no logging -- so it can be unit-tested by string compare.\n * The output is the full text for one `[<remoteName>]` section using rclone's\n * `webdav` backend.\n *\n * NOTE: rclone's `pass` field is not plaintext; it must already be passed\n * through `rclone obscure` by the caller. See the driver's `obscurePassword`\n * helper for the spawn that produces it.\n *\n * Lives in `@skaile/workspaces/connectors/rclone-config` so both consumers can\n * reach it: the in-container `webdav` mount driver\n * (`ai-assets-skaile/mounts/webdav/driver.ts`) and the platform-side\n * `RcloneFleetService` (`platform/backend/libs/session/`) which renders the\n * same INI on the host before spawning a shared rclone process.\n */\n\n/**\n * Supported WebDAV vendor identifiers for the rclone `webdav` backend.\n * @docLink packages/connectors/api-reference#web-dav-vendor\n */\nexport type WebDAVVendor = \"nextcloud\" | \"owncloud\" | \"sharepoint\" | \"fastmail\" | \"other\";\n\n/**\n * Options for `renderWebDAVConfig`. Carries remote name, URL, vendor, and credentials.\n * @docLink packages/connectors/api-reference#render-web-dav-config-options\n */\nexport interface RenderWebDAVConfigOptions {\n  /** The rclone remote section name (e.g. `skaile-docs`). */\n  remoteName: string;\n  /** Base URL of the WebDAV server. */\n  url: string;\n  /** WebDAV vendor; drives rclone's `vendor =` field. */\n  vendor: WebDAVVendor;\n  /** Basic-auth username. */\n  username?: string | null;\n  /** Already passed through `rclone obscure`. */\n  obscuredPassword?: string | null;\n  /** OAuth bearer token (used instead of basic-auth for SharePoint). */\n  bearerToken?: string | null;\n}\n\n/**\n * Render an rclone INI config section for a WebDAV remote. Pure — no IO, no side effects.\n * The `obscuredPassword` field must already have been processed through `rclone obscure`.\n * @param opts - Remote name, URL, vendor, and credentials.\n * @returns Full INI text for one `[<remoteName>]` rclone section.\n * @docLink packages/connectors/api-reference#render-web-dav-config\n */\nexport function renderWebDAVConfig(opts: RenderWebDAVConfigOptions): string {\n  const lines: string[] = [];\n  lines.push(`[${opts.remoteName}]`);\n  lines.push(\"type = webdav\");\n  lines.push(`url = ${opts.url}`);\n  lines.push(`vendor = ${opts.vendor}`);\n  if (opts.username) lines.push(`user = ${opts.username}`);\n  if (opts.obscuredPassword) lines.push(`pass = ${opts.obscuredPassword}`);\n  if (opts.bearerToken) lines.push(`bearer_token = ${opts.bearerToken}`);\n  lines.push(\"\");\n  return lines.join(\"\\n\");\n}\n"]}

package/dist/chunk-GVOLEJG5.js

@@ -0,0 +1,93 @@
+import { globalSettingsPath, mapLegacyFields } from './chunk-65CYXYUW.js';
+import { existsSync, readFileSync, mkdirSync, writeFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+
+function getStoreConfig() {
+  const settingsPath = globalSettingsPath();
+  let settings = {};
+  if (existsSync(settingsPath)) {
+    try {
+      settings = mapLegacyFields(JSON.parse(readFileSync(settingsPath, "utf-8")));
+    } catch {
+      settings = {};
+    }
+  }
+  return {
+    url: settings.storeUrl ?? process.env.SKAILE_STORE_URL ?? "https://store.skaile.ai",
+    jwt: settings.storeJwt ?? null,
+    refreshToken: settings.storeRefreshToken ?? null
+  };
+}
+function userSettingsPath() {
+  return join(homedir(), ".skaile", "settings.json");
+}
+function saveStoreTokens(jwt, refreshToken) {
+  const settingsPath = userSettingsPath();
+  const dir = join(settingsPath, "..");
+  mkdirSync(dir, { recursive: true });
+  let current = {};
+  if (existsSync(settingsPath)) {
+    try {
+      current = JSON.parse(readFileSync(settingsPath, "utf-8"));
+    } catch {
+      current = {};
+    }
+  }
+  current.storeJwt = jwt;
+  current.storeRefreshToken = refreshToken;
+  writeFileSync(settingsPath, JSON.stringify(current, null, 2), "utf-8");
+}
+function clearStoreTokens() {
+  const settingsPath = userSettingsPath();
+  if (!existsSync(settingsPath)) return;
+  try {
+    const current = JSON.parse(readFileSync(settingsPath, "utf-8"));
+    delete current.storeJwt;
+    delete current.storeRefreshToken;
+    writeFileSync(settingsPath, JSON.stringify(current, null, 2), "utf-8");
+  } catch {
+  }
+}
+async function storeFetch(config, path, opts) {
+  let url = `${config.url}${path}`;
+  if (opts?.params) {
+    const sp = new URLSearchParams(opts.params);
+    url += `?${sp}`;
+  }
+  const headers = {
+    "Content-Type": "application/json",
+    Accept: "application/json",
+    ...opts?.headers ?? {}
+  };
+  if (config.jwt) {
+    headers.Authorization = `Bearer ${config.jwt}`;
+  }
+  const fetchOpts = {
+    method: opts?.method ?? "GET",
+    headers
+  };
+  if (opts?.body) {
+    fetchOpts.body = JSON.stringify(opts.body);
+  }
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), 1500);
+  try {
+    const res = await fetch(url, { ...fetchOpts, signal: controller.signal });
+    if (!res.ok) {
+      const body = await res.json().catch(() => ({ error: `HTTP ${res.status}` }));
+      throw new Error(body.error ?? `Store API error: ${res.status}`);
+    }
+    return res.json();
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+function isStoreAuthenticated(config) {
+  const c = config ?? getStoreConfig();
+  return !!c.jwt;
+}
+
+export { clearStoreTokens, getStoreConfig, isStoreAuthenticated, saveStoreTokens, storeFetch };
+//# sourceMappingURL=chunk-GVOLEJG5.js.map
+//# sourceMappingURL=chunk-GVOLEJG5.js.map

package/dist/chunk-GVOLEJG5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../cli/src/store-client.ts"],"names":[],"mappings":"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","file":"chunk-GVOLEJG5.js","sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { globalSettingsPath, mapLegacyFields } from \"@skaile/workspaces/core\";\n\n/**\n * Connection configuration for the AI Asset Store API.\n *\n * @docLink cli/dev-guide#store-client\n */\nexport interface StoreConfig {\n  url: string;\n  jwt: string | null;\n  refreshToken: string | null;\n}\n\n/**\n * Read store connection config from global user settings, falling back to\n * `SKAILE_STORE_URL` env var and the default store URL.\n *\n * @returns Populated {@link StoreConfig} with `url`, `jwt`, and `refreshToken`.\n * @docLink cli/dev-guide#store-client\n */\nexport function getStoreConfig(): StoreConfig {\n  const settingsPath = globalSettingsPath();\n  let settings: Record<string, any> = {};\n  if (existsSync(settingsPath)) {\n    try {\n      settings = mapLegacyFields(JSON.parse(readFileSync(settingsPath, \"utf-8\")));\n    } catch {\n      settings = {};\n    }\n  }\n  return {\n    url: settings.storeUrl ?? process.env.SKAILE_STORE_URL ?? \"https://store.skaile.ai\",\n    jwt: settings.storeJwt ?? null,\n    refreshToken: settings.storeRefreshToken ?? null,\n  };\n}\n\n/** Path to user-level settings */\nfunction userSettingsPath(): string {\n  return join(homedir(), \".skaile\", \"settings.json\");\n}\n\n/**\n * Persist store authentication tokens to `~/.skaile/settings.json`.\n *\n * @param jwt - The JWT access token returned by the store login endpoint.\n * @param refreshToken - The refresh token for obtaining new JWTs.\n * @docLink cli/dev-guide#store-client\n */\nexport function saveStoreTokens(jwt: string, refreshToken: string): void {\n  const settingsPath = userSettingsPath();\n  const dir = join(settingsPath, \"..\");\n  mkdirSync(dir, { recursive: true });\n\n  let current: Record<string, any> = {};\n  if (existsSync(settingsPath)) {\n    try {\n      current = JSON.parse(readFileSync(settingsPath, \"utf-8\"));\n    } catch {\n      current = {};\n    }\n  }\n\n  current.storeJwt = jwt;\n  current.storeRefreshToken = refreshToken;\n  writeFileSync(settingsPath, JSON.stringify(current, null, 2), \"utf-8\");\n}\n\n/**\n * Remove store authentication tokens from `~/.skaile/settings.json`.\n *\n * @docLink cli/dev-guide#store-client\n */\nexport function clearStoreTokens(): void {\n  const settingsPath = userSettingsPath();\n  if (!existsSync(settingsPath)) return;\n\n  try {\n    const current = JSON.parse(readFileSync(settingsPath, \"utf-8\"));\n    delete current.storeJwt;\n    delete current.storeRefreshToken;\n    writeFileSync(settingsPath, JSON.stringify(current, null, 2), \"utf-8\");\n  } catch {\n    // ignore\n  }\n}\n\n/**\n * Make an authenticated HTTP request to the store REST API with a 1.5s timeout.\n *\n * @param config - Store connection config (URL + auth token).\n * @param path - API path (e.g. `/api/assets`).\n * @param opts - Optional method, body, query params, and extra headers.\n * @returns Parsed JSON response body.\n * @docLink cli/dev-guide#store-client\n */\nexport async function storeFetch<T = any>(\n  config: StoreConfig,\n  path: string,\n  opts?: {\n    method?: string;\n    body?: unknown;\n    params?: Record<string, string>;\n    headers?: Record<string, string>;\n  },\n): Promise<T> {\n  let url = `${config.url}${path}`;\n  if (opts?.params) {\n    const sp = new URLSearchParams(opts.params);\n    url += `?${sp}`;\n  }\n\n  const headers: Record<string, string> = {\n    \"Content-Type\": \"application/json\",\n    Accept: \"application/json\",\n    ...(opts?.headers ?? {}),\n  };\n  if (config.jwt) {\n    headers.Authorization = `Bearer ${config.jwt}`;\n  }\n\n  const fetchOpts: RequestInit = {\n    method: opts?.method ?? \"GET\",\n    headers,\n  };\n  if (opts?.body) {\n    fetchOpts.body = JSON.stringify(opts.body);\n  }\n\n  const controller = new AbortController();\n  const timeout = setTimeout(() => controller.abort(), 1_500);\n  try {\n    const res = await fetch(url, { ...fetchOpts, signal: controller.signal });\n    if (!res.ok) {\n      const body = await res.json().catch(() => ({ error: `HTTP ${res.status}` }));\n      throw new Error((body as any).error ?? `Store API error: ${res.status}`);\n    }\n    return res.json() as Promise<T>;\n  } finally {\n    clearTimeout(timeout);\n  }\n}\n\n/**\n * Return `true` if a JWT token is present in the provided (or default) store config.\n *\n * @param config - Optional pre-loaded config; if omitted, calls {@link getStoreConfig}.\n * @docLink cli/dev-guide#store-client\n */\nexport function isStoreAuthenticated(config?: StoreConfig): boolean {\n  const c = config ?? getStoreConfig();\n  return !!c.jwt;\n}\n"]}

package/dist/chunk-GZWJGNNN.js

@@ -0,0 +1,122 @@
+// base-assets/connectors/flow/prompt-fragments.ts
+function renderStimulusPrompt(stimulus) {
+  switch (stimulus.kind) {
+    case "flow_started":
+      return "The user just started this flow. Begin with the first available node \u2014 call `get_available`, then `build_handoff` for your chosen node, then `start_node`.";
+    case "approval_received": {
+      const { nodeId, decision, decidedBy, feedback } = stimulus;
+      if (decision === "approved") {
+        return `Node \`${nodeId}\` was **approved** by ${decidedBy}. Call \`complete_node\` for this node with the approved output, then advance to the next available node.`;
+      }
+      const fb = feedback ? ` Feedback: "${feedback}".` : "";
+      return `Node \`${nodeId}\` was **rejected** by ${decidedBy}.${fb} Decide how to proceed: retry the node (the engine returned it to \`available\`), ask clarifying questions via \`request_input\`, or call \`fail_node(..., recoverable: false)\` if the issue cannot be addressed.`;
+    }
+    case "input_received":
+      return `The user just provided input for node \`${stimulus.nodeId}\` (provided by ${stimulus.providedBy}). The node has returned to its prior status. Continue executing the node with this input.`;
+    case "retry_requested":
+      return `A user requested a retry of node \`${stimulus.nodeId}\` (requested by ${stimulus.requestedBy}). The node has been returned to \`available\` with its prior error preserved in history. Start a fresh attempt \u2014 review the error context if relevant and try a different approach.`;
+    case "user_message":
+      return `A user sent a message: "${stimulus.text}" (from ${stimulus.senderId}). You can respond directly without touching the flow, continue flow work, or both. If the message is a question about the flow, answer it; if it signals a new direction, consider whether to pause.`;
+    case "resumed_after_hibernation":
+      return "This session was hibernated and has just resumed. Review the current state above and continue where you left off. No state was lost.";
+    case "cancelled":
+      return "The user has cancelled this flow. Wrap up cleanly: do not start any new nodes. You may record a short summary if relevant, then stop.";
+    case "state_changed":
+      return "The flow state changed. Review the current state above and continue work accordingly.";
+  }
+}
+function buildOrchestratorPrompt(flowDef, state, stimulus) {
+  const skillNodes = flowDef.nodes.filter((n) => n.type === "skill");
+  const nodeRows = skillNodes.map((n) => {
+    const deps = flowDef.edges.filter((e) => e.target === n.id && e.type === "flow").map((e) => e.source).join(", ") || "\u2014";
+    const required = n.data?.optional ? "optional" : "required";
+    const nodeState = state.nodes[n.id];
+    const status = nodeState?.status ?? "not_started";
+    return `| ${n.id} | ${n.data?.skill ?? n.id} | ${n.data?.label ?? n.id} | ${required} | ${status} | ${deps} |`;
+  }).join("\n");
+  const nodesByStatus = (s) => Object.values(state.nodes).filter((n) => n.status === s).map((n) => n.id);
+  const available = nodesByStatus("available");
+  const awaitingApproval = nodesByStatus("awaiting_approval");
+  const awaitingInput = nodesByStatus("awaiting_input");
+  const running = nodesByStatus("running");
+  const failed = nodesByStatus("failed");
+  const completed = nodesByStatus("complete");
+  const totalRequired = skillNodes.filter((n) => !n.data?.optional).length;
+  const stateSummary = [
+    `- Run ID: ${state.runId}`,
+    `- Status: ${state.status}`,
+    `- Autonomous mode: ${state.autonomousMode}`,
+    `- Progress: ${completed.length} / ${totalRequired} required nodes complete`,
+    `- Available now: ${available.join(", ") || "(none)"}`,
+    `- Currently running: ${running.join(", ") || "(none)"}`,
+    `- Awaiting approval: ${awaitingApproval.join(", ") || "(none)"}`,
+    `- Awaiting input: ${awaitingInput.join(", ") || "(none)"}`,
+    `- Failed: ${failed.join(", ") || "(none)"}`
+  ].join("\n");
+  const stimulusParagraph = renderStimulusPrompt(stimulus);
+  return `# Flow Execution Context
+
+You are orchestrating the flow **${flowDef.name}** (${flowDef.id} v${flowDef.version}). This is a governed flow execution: your job is to run nodes through the flow tools, summarize their outputs for human review, and yield control at approval gates.
+
+## Flow definition
+
+| ID | Skill | Label | Required | Status | Depends on |
+|----|-------|-------|----------|--------|------------|
+${nodeRows}
+
+## Current state
+
+${stateSummary}
+
+## Why this turn is happening
+
+${stimulusParagraph}
+
+## Flow tools available
+
+All tools are exposed by the \`flow\` connector:
+
+- \`get_available()\` \u2014 list node IDs that are ready to start
+- \`get_state()\` \u2014 full current state including approvals, inputs, outputs
+- \`build_handoff(nodeId)\` \u2014 curated context from upstream predecessors (summaries + artifacts)
+- \`start_node(nodeId)\` \u2014 transition \`available\` \u2192 \`running\`; call before executing the skill
+- \`request_approval(nodeId, summary, artifacts)\` \u2014 transition \`running\` \u2192 \`awaiting_approval\`. **This ends your turn.**
+- \`request_input(nodeId, prompt, schema)\` \u2014 transition to \`awaiting_input\`. **This ends your turn.** Legal from \`available\`, \`running\`, or \`awaiting_approval\`.
+- \`complete_node(nodeId, output)\` \u2014 transition to \`complete\`. Valid only if autonomousMode is true OR the node was approved.
+- \`fail_node(nodeId, message, recoverable)\` \u2014 transition to \`failed\`. \`recoverable=true\` returns the node to \`available\`.
+- \`skip_node(nodeId)\` \u2014 transition to \`skipped\`. Only valid for optional nodes.
+
+## Rules
+
+1. Before executing a skill, call \`start_node(nodeId)\`.
+2. After executing the skill, call \`request_approval\` unless \`autonomousMode\` is true \u2014 in which case call \`complete_node\` directly.
+3. If you need information from the user before or during execution, call \`request_input\`. This ends your turn until the user responds.
+4. On unrecoverable failure, call \`fail_node(..., recoverable: false)\`. On recoverable failure, call \`fail_node(..., recoverable: true)\` and the engine returns the node to \`available\`.
+5. When all required nodes are \`complete\` or \`skipped\`, stop. The runner marks the flow done automatically.
+6. Free-chat user messages do not require flow action. Respond directly, continue flow work, or both \u2014 your call.
+`;
+}
+function describeStimulus(stimulus) {
+  switch (stimulus.kind) {
+    case "flow_started":
+      return "flow_started";
+    case "approval_received":
+      return `approval_received:${stimulus.nodeId}:${stimulus.decision}`;
+    case "input_received":
+      return `input_received:${stimulus.nodeId}`;
+    case "retry_requested":
+      return `retry_requested:${stimulus.nodeId}`;
+    case "user_message":
+      return `user_message:${stimulus.senderId}`;
+    case "resumed_after_hibernation":
+      return "resumed_after_hibernation";
+    case "cancelled":
+      return "cancelled";
+    case "state_changed":
+      return "state_changed";
+  }
+}
+
+export { buildOrchestratorPrompt, describeStimulus, renderStimulusPrompt };
+//# sourceMappingURL=chunk-GZWJGNNN.js.map
+//# sourceMappingURL=chunk-GZWJGNNN.js.map

package/dist/chunk-GZWJGNNN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../base-assets/connectors/flow/prompt-fragments.ts"],"names":[],"mappings":"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","file":"chunk-GZWJGNNN.js","sourcesContent":["/**\n * Prompt fragments for the flow connector.\n *\n * Pure functions that translate a {@link TurnStimulus} into the strings the\n * runner's flow orchestrator splices into the per-turn agent prompt.\n * Extracted from `runner/src/flow-orchestrator.ts` in Phase 3 of the\n * flow-connector extraction (2026-05-08) so the connector owns its\n * prompt-rendering surface without a runtime dep on the orchestrator.\n *\n * The contract is byte-identical to the previous inline implementation —\n * any divergence is a regression.\n *\n * @docLink packages/base-assets/flow#prompt-fragments\n */\n\nimport type { FlowExecution } from \"@skaile/workspaces/types\";\nimport type { FlowDefinition } from \"./engine/types.js\";\n\n/**\n * Reasons why a new turn is starting. The flow orchestrator's prompt template\n * renders a stimulus-specific paragraph (via {@link renderStimulusPrompt}) so\n * the agent knows exactly why it has been invoked.\n *\n * @docLink packages/base-assets/flow#turn-stimulus\n */\nexport type TurnStimulus =\n  | { kind: \"flow_started\" }\n  | {\n      kind: \"approval_received\";\n      nodeId: string;\n      decision: \"approved\" | \"rejected\";\n      feedback?: string;\n      decidedBy: string;\n    }\n  | { kind: \"input_received\"; nodeId: string; response: unknown; providedBy: string }\n  | { kind: \"retry_requested\"; nodeId: string; requestedBy: string }\n  | { kind: \"user_message\"; text: string; senderId: string }\n  | { kind: \"resumed_after_hibernation\" }\n  | { kind: \"cancelled\" }\n  | { kind: \"state_changed\" };\n\n/**\n * Render the stimulus paragraph the agent sees at turn start.\n *\n * The output is a single paragraph (one or more sentences, no surrounding\n * whitespace) describing why the runner has woken the agent. Spliced into\n * the orchestrator prompt under the `## Why this turn is happening` heading.\n *\n * @docLink packages/base-assets/flow#render-stimulus-prompt\n */\nexport function renderStimulusPrompt(stimulus: TurnStimulus): string {\n  switch (stimulus.kind) {\n    case \"flow_started\":\n      return \"The user just started this flow. Begin with the first available node — call `get_available`, then `build_handoff` for your chosen node, then `start_node`.\";\n    case \"approval_received\": {\n      const { nodeId, decision, decidedBy, feedback } = stimulus;\n      if (decision === \"approved\") {\n        return `Node \\`${nodeId}\\` was **approved** by ${decidedBy}. Call \\`complete_node\\` for this node with the approved output, then advance to the next available node.`;\n      }\n      const fb = feedback ? ` Feedback: \"${feedback}\".` : \"\";\n      return `Node \\`${nodeId}\\` was **rejected** by ${decidedBy}.${fb} Decide how to proceed: retry the node (the engine returned it to \\`available\\`), ask clarifying questions via \\`request_input\\`, or call \\`fail_node(..., recoverable: false)\\` if the issue cannot be addressed.`;\n    }\n    case \"input_received\":\n      return `The user just provided input for node \\`${stimulus.nodeId}\\` (provided by ${stimulus.providedBy}). The node has returned to its prior status. Continue executing the node with this input.`;\n    case \"retry_requested\":\n      return `A user requested a retry of node \\`${stimulus.nodeId}\\` (requested by ${stimulus.requestedBy}). The node has been returned to \\`available\\` with its prior error preserved in history. Start a fresh attempt — review the error context if relevant and try a different approach.`;\n    case \"user_message\":\n      return `A user sent a message: \"${stimulus.text}\" (from ${stimulus.senderId}). You can respond directly without touching the flow, continue flow work, or both. If the message is a question about the flow, answer it; if it signals a new direction, consider whether to pause.`;\n    case \"resumed_after_hibernation\":\n      return \"This session was hibernated and has just resumed. Review the current state above and continue where you left off. No state was lost.\";\n    case \"cancelled\":\n      return \"The user has cancelled this flow. Wrap up cleanly: do not start any new nodes. You may record a short summary if relevant, then stop.\";\n    case \"state_changed\":\n      return \"The flow state changed. Review the current state above and continue work accordingly.\";\n  }\n}\n\n/**\n * Build the full agent-orchestrator prompt for a flow turn.\n *\n * Reassembles the five-section prompt from the current FlowExecution snapshot\n * and the supplied stimulus:\n *\n *  1. Flow definition (markdown table of nodes)\n *  2. Current state (progress, available/blocked, interaction pointers)\n *  3. Why this turn is happening (stimulus-specific paragraph)\n *  4. Flow tools available (static documentation)\n *  5. Rules\n *\n * Identical to `FlowOrchestrator.buildOrchestratorPrompt` (Phase 3 lift —\n * any divergence is a regression). Pure — depends only on its inputs.\n *\n * @docLink packages/base-assets/flow#build-orchestrator-prompt\n * @since 2.2.0\n */\nexport function buildOrchestratorPrompt(\n  flowDef: FlowDefinition,\n  state: FlowExecution,\n  stimulus: TurnStimulus,\n): string {\n  const skillNodes = flowDef.nodes.filter((n) => n.type === \"skill\");\n\n  // ── Section 1: definition table ──\n  const nodeRows = skillNodes\n    .map((n) => {\n      const deps =\n        flowDef.edges\n          .filter((e) => e.target === n.id && e.type === \"flow\")\n          .map((e) => e.source)\n          .join(\", \") || \"—\";\n      const required = n.data?.optional ? \"optional\" : \"required\";\n      const nodeState = state.nodes[n.id];\n      const status = nodeState?.status ?? \"not_started\";\n      return `| ${n.id} | ${n.data?.skill ?? n.id} | ${n.data?.label ?? n.id} | ${required} | ${status} | ${deps} |`;\n    })\n    .join(\"\\n\");\n\n  // ── Section 2: current state summary ──\n  const nodesByStatus = (s: string) =>\n    Object.values(state.nodes)\n      .filter((n) => n.status === s)\n      .map((n) => n.id);\n  const available = nodesByStatus(\"available\");\n  const awaitingApproval = nodesByStatus(\"awaiting_approval\");\n  const awaitingInput = nodesByStatus(\"awaiting_input\");\n  const running = nodesByStatus(\"running\");\n  const failed = nodesByStatus(\"failed\");\n  const completed = nodesByStatus(\"complete\");\n  const totalRequired = skillNodes.filter((n) => !n.data?.optional).length;\n\n  const stateSummary = [\n    `- Run ID: ${state.runId}`,\n    `- Status: ${state.status}`,\n    `- Autonomous mode: ${state.autonomousMode}`,\n    `- Progress: ${completed.length} / ${totalRequired} required nodes complete`,\n    `- Available now: ${available.join(\", \") || \"(none)\"}`,\n    `- Currently running: ${running.join(\", \") || \"(none)\"}`,\n    `- Awaiting approval: ${awaitingApproval.join(\", \") || \"(none)\"}`,\n    `- Awaiting input: ${awaitingInput.join(\", \") || \"(none)\"}`,\n    `- Failed: ${failed.join(\", \") || \"(none)\"}`,\n  ].join(\"\\n\");\n\n  // ── Section 3: stimulus paragraph ──\n  const stimulusParagraph = renderStimulusPrompt(stimulus);\n\n  // ── Section 4+5: static tool surface and rules ──\n  return `# Flow Execution Context\n\nYou are orchestrating the flow **${flowDef.name}** (${flowDef.id} v${flowDef.version}). This is a governed flow execution: your job is to run nodes through the flow tools, summarize their outputs for human review, and yield control at approval gates.\n\n## Flow definition\n\n| ID | Skill | Label | Required | Status | Depends on |\n|----|-------|-------|----------|--------|------------|\n${nodeRows}\n\n## Current state\n\n${stateSummary}\n\n## Why this turn is happening\n\n${stimulusParagraph}\n\n## Flow tools available\n\nAll tools are exposed by the \\`flow\\` connector:\n\n- \\`get_available()\\` — list node IDs that are ready to start\n- \\`get_state()\\` — full current state including approvals, inputs, outputs\n- \\`build_handoff(nodeId)\\` — curated context from upstream predecessors (summaries + artifacts)\n- \\`start_node(nodeId)\\` — transition \\`available\\` → \\`running\\`; call before executing the skill\n- \\`request_approval(nodeId, summary, artifacts)\\` — transition \\`running\\` → \\`awaiting_approval\\`. **This ends your turn.**\n- \\`request_input(nodeId, prompt, schema)\\` — transition to \\`awaiting_input\\`. **This ends your turn.** Legal from \\`available\\`, \\`running\\`, or \\`awaiting_approval\\`.\n- \\`complete_node(nodeId, output)\\` — transition to \\`complete\\`. Valid only if autonomousMode is true OR the node was approved.\n- \\`fail_node(nodeId, message, recoverable)\\` — transition to \\`failed\\`. \\`recoverable=true\\` returns the node to \\`available\\`.\n- \\`skip_node(nodeId)\\` — transition to \\`skipped\\`. Only valid for optional nodes.\n\n## Rules\n\n1. Before executing a skill, call \\`start_node(nodeId)\\`.\n2. After executing the skill, call \\`request_approval\\` unless \\`autonomousMode\\` is true — in which case call \\`complete_node\\` directly.\n3. If you need information from the user before or during execution, call \\`request_input\\`. This ends your turn until the user responds.\n4. On unrecoverable failure, call \\`fail_node(..., recoverable: false)\\`. On recoverable failure, call \\`fail_node(..., recoverable: true)\\` and the engine returns the node to \\`available\\`.\n5. When all required nodes are \\`complete\\` or \\`skipped\\`, stop. The runner marks the flow done automatically.\n6. Free-chat user messages do not require flow action. Respond directly, continue flow work, or both — your call.\n`;\n}\n\n/**\n * Single-line tag suitable for telemetry / logging. Derives a short, stable\n * summary of a stimulus that's safe to attach to spans, log entries, and\n * trace events. The kind is always included; node-specific stimuli also\n * include their `nodeId` so log queries can pivot on it.\n *\n * @docLink packages/base-assets/flow#describe-stimulus\n */\nexport function describeStimulus(stimulus: TurnStimulus): string {\n  switch (stimulus.kind) {\n    case \"flow_started\":\n      return \"flow_started\";\n    case \"approval_received\":\n      return `approval_received:${stimulus.nodeId}:${stimulus.decision}`;\n    case \"input_received\":\n      return `input_received:${stimulus.nodeId}`;\n    case \"retry_requested\":\n      return `retry_requested:${stimulus.nodeId}`;\n    case \"user_message\":\n      return `user_message:${stimulus.senderId}`;\n    case \"resumed_after_hibernation\":\n      return \"resumed_after_hibernation\";\n    case \"cancelled\":\n      return \"cancelled\";\n    case \"state_changed\":\n      return \"state_changed\";\n  }\n}\n"]}

package/dist/chunk-HK5FRWG6.js

@@ -0,0 +1,44 @@
+import { okJson, err } from './chunk-X5YPJV4N.js';
+import fs from 'fs/promises';
+import path from 'path';
+
+async function readAllSessions(projectDir) {
+  const dir = path.join(projectDir, ".skaile", "sessions");
+  try {
+    const files = await fs.readdir(dir);
+    const sessions = [];
+    for (const file of files) {
+      if (!file.endsWith(".json")) continue;
+      try {
+        const raw = await fs.readFile(path.join(dir, file), "utf-8");
+        sessions.push(JSON.parse(raw));
+      } catch {
+      }
+    }
+    return sessions.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+  } catch {
+    return [];
+  }
+}
+async function sessionList(projectDir) {
+  try {
+    const sessions = await readAllSessions(projectDir);
+    return okJson(sessions);
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+}
+async function sessionGet(projectDir, runId) {
+  try {
+    const sessions = await readAllSessions(projectDir);
+    const session = sessions.find((s) => s.runId === runId);
+    if (!session) return err(`Session '${runId}' not found in ${projectDir}/.skaile/sessions/`);
+    return okJson(session);
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+}
+
+export { readAllSessions, sessionGet, sessionList };
+//# sourceMappingURL=chunk-HK5FRWG6.js.map
+//# sourceMappingURL=chunk-HK5FRWG6.js.map

package/dist/chunk-HK5FRWG6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../workspace-plugin/src/tools/sessions.ts"],"names":[],"mappings":";;;;AAkBA,eAAsB,gBAAgB,UAAA,EAA6C;AACjF,EAAA,MAAM,GAAA,GAAM,IAAA,CAAK,IAAA,CAAK,UAAA,EAAY,WAAW,UAAU,CAAA;AACvD,EAAA,IAAI;AACF,IAAA,MAAM,KAAA,GAAQ,MAAM,EAAA,CAAG,OAAA,CAAQ,GAAG,CAAA;AAClC,IAAA,MAAM,WAA2B,EAAC;AAClC,IAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,MAAA,IAAI,CAAC,IAAA,CAAK,QAAA,CAAS,OAAO,CAAA,EAAG;AAC7B,MAAA,IAAI;AACF,QAAA,MAAM,GAAA,GAAM,MAAM,EAAA,CAAG,QAAA,CAAS,KAAK,IAAA,CAAK,GAAA,EAAK,IAAI,CAAA,EAAG,OAAO,CAAA;AAC3D,QAAA,QAAA,CAAS,IAAA,CAAK,IAAA,CAAK,KAAA,CAAM,GAAG,CAAiB,CAAA;AAAA,MAC/C,CAAA,CAAA,MAAQ;AAAA,MAER;AAAA,IACF;AACA,IAAA,OAAO,QAAA,CAAS,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM,EAAE,SAAA,CAAU,aAAA,CAAc,CAAA,CAAE,SAAS,CAAC,CAAA;AAAA,EACvE,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,EAAC;AAAA,EACV;AACF;AAYA,eAAsB,YAAY,UAAA,EAAyC;AACzE,EAAA,IAAI;AACF,IAAA,MAAM,QAAA,GAAW,MAAM,eAAA,CAAgB,UAAU,CAAA;AACjD,IAAA,OAAO,OAAO,QAAQ,CAAA;AAAA,EACxB,SAAS,CAAA,EAAY;AACnB,IAAA,OAAO,IAAI,CAAA,YAAa,KAAA,GAAQ,EAAE,OAAA,GAAU,MAAA,CAAO,CAAC,CAAC,CAAA;AAAA,EACvD;AACF;AAUA,eAAsB,UAAA,CAAW,YAAoB,KAAA,EAAoC;AACvF,EAAA,IAAI;AACF,IAAA,MAAM,QAAA,GAAW,MAAM,eAAA,CAAgB,UAAU,CAAA;AACjD,IAAA,MAAM,UAAU,QAAA,CAAS,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,UAAU,KAAK,CAAA;AACtD,IAAA,IAAI,CAAC,SAAS,OAAO,GAAA,CAAI,YAAY,KAAK,CAAA,eAAA,EAAkB,UAAU,CAAA,kBAAA,CAAoB,CAAA;AAC1F,IAAA,OAAO,OAAO,OAAO,CAAA;AAAA,EACvB,SAAS,CAAA,EAAY;AACnB,IAAA,OAAO,IAAI,CAAA,YAAa,KAAA,GAAQ,EAAE,OAAA,GAAU,MAAA,CAAO,CAAC,CAAC,CAAA;AAAA,EACvD;AACF","file":"chunk-HK5FRWG6.js","sourcesContent":["// src/tools/sessions.ts\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { err, okJson } from \"../types.js\";\nimport type { SessionState, ToolResult } from \"../types.js\";\n\n/**\n * Read all session state files from `.skaile/sessions/` and return them\n * sorted newest-first by `updatedAt`.\n *\n * Silently skips missing directories and corrupt JSON files.  This function\n * is exported for internal use by `flows.ts` — prefer {@link sessionList} or\n * {@link sessionGet} for tool-level access.\n *\n * @param projectDir - Absolute path to the skaile project root.\n *\n * @docLink packages/workspace-plugin/concepts#tool-delivery\n */\nexport async function readAllSessions(projectDir: string): Promise<SessionState[]> {\n  const dir = path.join(projectDir, \".skaile\", \"sessions\");\n  try {\n    const files = await fs.readdir(dir);\n    const sessions: SessionState[] = [];\n    for (const file of files) {\n      if (!file.endsWith(\".json\")) continue;\n      try {\n        const raw = await fs.readFile(path.join(dir, file), \"utf-8\");\n        sessions.push(JSON.parse(raw) as SessionState);\n      } catch {\n        /* skip corrupt */\n      }\n    }\n    return sessions.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));\n  } catch {\n    return [];\n  }\n}\n\n/**\n * List all past agent run sessions for the workspace, sorted newest-first.\n *\n * Returns a JSON array of {@link SessionState} objects read from\n * `.skaile/sessions/*.json`.\n *\n * @param projectDir - Absolute path to the skaile project root.\n *\n * @docLink packages/workspace-plugin/concepts#tool-delivery\n */\nexport async function sessionList(projectDir: string): Promise<ToolResult> {\n  try {\n    const sessions = await readAllSessions(projectDir);\n    return okJson(sessions);\n  } catch (e: unknown) {\n    return err(e instanceof Error ? e.message : String(e));\n  }\n}\n\n/**\n * Get full metadata for a specific agent run session.\n *\n * @param projectDir - Absolute path to the skaile project root.\n * @param runId      - Run ID as returned by {@link sessionList}.\n *\n * @docLink packages/workspace-plugin/concepts#tool-delivery\n */\nexport async function sessionGet(projectDir: string, runId: string): Promise<ToolResult> {\n  try {\n    const sessions = await readAllSessions(projectDir);\n    const session = sessions.find((s) => s.runId === runId);\n    if (!session) return err(`Session '${runId}' not found in ${projectDir}/.skaile/sessions/`);\n    return okJson(session);\n  } catch (e: unknown) {\n    return err(e instanceof Error ? e.message : String(e));\n  }\n}\n"]}