@skaile/workspaces 4.6.0 → 4.7.0

package/dist/workspace-plugin/adapters/omp.js

@@ -74,7 +74,7 @@ function buildOmpToolSet(plugin) {
       description: "List all available flow definitions from ai-assets.",
       parameters: {},
       handler: async () => {
-        const { flowList } = await import('../../flows-X4KJC4RH.js');
+        const { flowList } = await import('../../flows-DAA2HPCK.js');
         return (await flowList(plugin.projectDir)).content[0].text;
       }
     },
@@ -83,7 +83,7 @@ function buildOmpToolSet(plugin) {
       description: "List past flow run sessions for this workspace.",
       parameters: {},
       handler: async () => {
-        const { flowListSessions } = await import('../../flows-X4KJC4RH.js');
+        const { flowListSessions } = await import('../../flows-DAA2HPCK.js');
         return (await flowListSessions(plugin.projectDir)).content[0].text;
       }
     },
@@ -92,7 +92,7 @@ function buildOmpToolSet(plugin) {
       description: "List all skills in the ai-assets catalog.",
       parameters: { domain: { type: "string", optional: true } },
       handler: async ({ domain }) => {
-        const { skillList } = await import('../../skills-C6NOMIBV.js');
+        const { skillList } = await import('../../skills-ZO66BL2Y.js');
         return (await skillList(plugin.projectDir, domain)).content[0].text;
       }
     },
@@ -101,7 +101,7 @@ function buildOmpToolSet(plugin) {
       description: "Search skills by name, description, or keywords.",
       parameters: { query: { type: "string" } },
       handler: async ({ query }) => {
-        const { skillSearch } = await import('../../skills-C6NOMIBV.js');
+        const { skillSearch } = await import('../../skills-ZO66BL2Y.js');
         return (await skillSearch(plugin.projectDir, query)).content[0].text;
       }
     },
@@ -110,7 +110,7 @@ function buildOmpToolSet(plugin) {
       description: "Show the full SKILL.md content for a skill.",
       parameters: { skill_id: { type: "string" } },
       handler: async ({ skill_id }) => {
-        const { skillShow } = await import('../../skills-C6NOMIBV.js');
+        const { skillShow } = await import('../../skills-ZO66BL2Y.js');
         return (await skillShow(plugin.projectDir, skill_id)).content[0].text;
       }
     },
@@ -163,7 +163,7 @@ function buildOmpToolSet(plugin) {
       description: "Run a full health check on the workspace config.",
       parameters: {},
       handler: async () => {
-        const { workspaceValidate } = await import('../../validator-P5ESKTW5.js');
+        const { workspaceValidate } = await import('../../validator-FA2PFW6N.js');
         return (await workspaceValidate(plugin, plugin.driver ?? "omp")).content[0].text;
       }
     },
@@ -172,7 +172,7 @@ function buildOmpToolSet(plugin) {
       description: "Show workspace configuration (driver, model, resource counts).",
       parameters: {},
       handler: async () => {
-        const { workspaceInfo } = await import('../../validator-P5ESKTW5.js');
+        const { workspaceInfo } = await import('../../validator-FA2PFW6N.js');
         return (await workspaceInfo(plugin, plugin.driver ?? "omp", plugin.model)).content[0].text;
       }
     }
@@ -201,7 +201,7 @@ async function handleSlashCommand(plugin, group, args) {
   }
 }
 async function handleFlowCommand(plugin, sub, rest) {
-  const { flowList, flowShow, flowListSessions, flowGetSession } = await import('../../flows-X4KJC4RH.js');
+  const { flowList, flowShow, flowListSessions, flowGetSession } = await import('../../flows-DAA2HPCK.js');
   if (!sub || sub === "list") return (await flowList(plugin.projectDir)).content[0].text;
   if (sub === "show" && rest[0])
     return (await flowShow(plugin.projectDir, rest[0])).content[0].text;
@@ -230,7 +230,7 @@ async function handleConnectorCommand(plugin, sub, rest) {
   return "Usage: /connector list | read <id> <path> | exec <id> <op> [json-args] | describe <id>";
 }
 async function handleSkillCommand(plugin, sub, rest) {
-  const { skillList, skillShow, skillSearch } = await import('../../skills-C6NOMIBV.js');
+  const { skillList, skillShow, skillSearch } = await import('../../skills-ZO66BL2Y.js');
   if (sub === "run" && rest[0])
     return (await skillShow(plugin.projectDir, rest[0])).content[0].text;
   if (!sub || sub === "list") return (await skillList(plugin.projectDir, rest[0])).content[0].text;
@@ -250,7 +250,7 @@ async function handleMountsCommand(plugin, sub, rest) {
   return "Usage: /mounts list | sync <id> | status <id>";
 }
 async function handleValidateCommand(plugin) {
-  const { workspaceValidate } = await import('../../validator-P5ESKTW5.js');
+  const { workspaceValidate } = await import('../../validator-FA2PFW6N.js');
   return (await workspaceValidate(plugin, plugin.driver ?? "omp")).content[0].text;
 }
 

package/dist/workspace-plugin/index.js

@@ -1,4 +1,4 @@
-export { PluginStore, WorkspacePlugin, buildClaudePluginFiles, resolveProjectDir } from '../chunk-2HZJKDLG.js';
+export { PluginStore, WorkspacePlugin, buildClaudePluginFiles, resolveProjectDir } from '../chunk-7UM46L33.js';
 export { err, ok, okJson } from '../chunk-X5YPJV4N.js';
 import '../chunk-FTG7CRFD.js';
 import '../chunk-W4IPN3DD.js';

package/dist/workspace-plugin/src/tools/validator.d.ts

@@ -8,6 +8,7 @@ interface PluginLike {
     projectDir: string;
     connectorManager: {
         listConnectors(): ConnectorSummary[];
+        listFailedConnectors?(): unknown[];
     } | null;
     reload(): Promise<void>;
 }

package/dist/workspace-plugin/src/tools/validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../../workspace-plugin/src/tools/validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAkB9C,UAAU,gBAAgB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD,UAAU,UAAU;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE;QAAE,cAAc,IAAI,gBAAgB,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IAClE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAoCD;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,OAAO,CAAC,UAAU,CAAC,CAerB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAoB1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA+C/F;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAW7E"}
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../../workspace-plugin/src/tools/validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAkB9C,UAAU,gBAAgB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD,UAAU,UAAU;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE;QAChB,cAAc,IAAI,gBAAgB,EAAE,CAAC;QACrC,oBAAoB,CAAC,IAAI,OAAO,EAAE,CAAC;KACpC,GAAG,IAAI,CAAC;IACT,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAmDD;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,OAAO,CAAC,UAAU,CAAC,CAerB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAoB1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA+C/F;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAS7E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skaile/workspaces",
-  "version": "4.6.0",
+  "version": "4.7.0",
   "description": "Skaile workspaces runtime — types, core, bridge, runner, store, connectors, and supporting layers as one publishable package",
   "type": "module",
   "packageManager": "bun@1.3.9",

package/dist/chunk-JXCUUZA3.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../workspace-plugin/src/tools/validator.ts"],"names":["val"],"mappings":"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","file":"chunk-JXCUUZA3.js","sourcesContent":["import { execFile } from \"node:child_process\";\nimport { promisify } from \"node:util\";\nimport type { ToolResult } from \"../types.js\";\nimport { err, okJson } from \"../types.js\";\n\nconst execFileAsync = promisify(execFile);\n\n/**\n * Wall-clock ceiling for the driver-binary probe.\n *\n * `which` searches `PATH`, and a `PATH` entry on a wedged network mount makes\n * the lookup itself unbounded. This runs on an agent request path inside the\n * long-lived `skaile serve` process, so the probe must fail rather than wait.\n */\nconst WHICH_TIMEOUT_MS = 10_000;\n\n// Minimal interface for WorkspacePlugin to avoid circular dep.\n// The unified ConnectorManager owns both filesystem-face (mountable) and\n// tool-face connectors — `listConnectors()` returns both; filesystem-face\n// entries carry a `mountPath`.\ninterface ConnectorSummary {\n  id: string;\n  driver: string;\n  mountPath?: string;\n}\ninterface PluginLike {\n  projectDir: string;\n  connectorManager: { listConnectors(): ConnectorSummary[] } | null;\n  reload(): Promise<void>;\n}\n\n/** Split a manager's connectors into mountable / tool-face groups. */\nfunction splitConnectors(plugin: PluginLike): {\n  mounts: ConnectorSummary[];\n  connectors: ConnectorSummary[];\n} {\n  const all = plugin.connectorManager?.listConnectors() ?? [];\n  return {\n    mounts: all.filter((c) => typeof c.mountPath === \"string\"),\n    connectors: all.filter((c) => typeof c.mountPath !== \"string\"),\n  };\n}\n\nfunction maskSecret(value: string): string {\n  if (value.length <= 4) return \"****\";\n  return `${value.slice(0, 4)}****`;\n}\n\nfunction resolveEnvRef(ref: string): {\n  resolved: boolean;\n  value?: string;\n  provider?: string;\n  error?: string;\n} {\n  if (ref.startsWith(\"env:\")) {\n    const varName = ref.slice(4);\n    const val = process.env[varName];\n    if (val) return { resolved: true, value: val, provider: \"env\" };\n    return { resolved: false, error: `env var '${varName}' is not set` };\n  }\n  const val = process.env[ref];\n  if (val) return { resolved: true, value: val, provider: \"env\" };\n  return { resolved: false, error: `'${ref}' not found in environment` };\n}\n\n/**\n * Return a summary of the current workspace configuration.\n *\n * Reports the active driver, model, mount count, connector count, and\n * per-resource descriptors. Endpoints are not summarised here: they live in\n * the session's AI provider registry, which `skaile providers list` prints.\n *\n * @param plugin   - Plugin instance (or compatible shape) exposing managers.\n * @param driver   - Driver name (e.g. `\"omp\"`, `\"claude-sdk\"`).\n * @param model    - Model identifier, if resolved.\n *\n * @docLink packages/workspace-plugin/concepts#tool-delivery\n */\nexport async function workspaceInfo(\n  plugin: PluginLike,\n  driver: string,\n  model: string | undefined,\n): Promise<ToolResult> {\n  try {\n    const { mounts, connectors } = splitConnectors(plugin);\n    return okJson({\n      driver,\n      model,\n      mountCount: mounts.length,\n      connectorCount: connectors.length,\n      mounts: mounts.map((v) => ({ id: v.id, driver: v.driver, mounted: true })),\n      connectors: connectors.map((c) => ({ id: c.id, adapter: c.driver })),\n      projectDir: plugin.projectDir,\n    });\n  } catch (e: unknown) {\n    return err(e instanceof Error ? e.message : String(e));\n  }\n}\n\n/**\n * Test resolution of a secret reference.\n *\n * Resolves `env:<VAR>` references against `process.env`.  For other provider\n * schemes (e.g. `forge:key`) reports that a running forge/vault context is\n * required.  Returns a JSON object with `{ resolved, provider?, masked? }` —\n * the secret value is never returned in plain text.\n *\n * @param ref - Secret reference string, e.g. `\"env:ANTHROPIC_API_KEY\"`.\n *\n * @docLink packages/workspace-plugin/concepts#tool-delivery\n */\nexport async function workspaceTestSecret(ref: string): Promise<ToolResult> {\n  try {\n    const result = resolveEnvRef(ref);\n    if (result.resolved && result.value) {\n      return okJson({\n        resolved: true,\n        provider: result.provider,\n        masked: maskSecret(result.value),\n      });\n    }\n    if (ref.includes(\":\") && !ref.startsWith(\"env:\")) {\n      return okJson({\n        resolved: false,\n        error: `Provider '${ref.split(\":\")[0]}' requires a running forge/vault context. Use env: refs for standalone validation.`,\n      });\n    }\n    return okJson({ resolved: false, error: result.error });\n  } catch (e: unknown) {\n    return err(e instanceof Error ? e.message : String(e));\n  }\n}\n\n/**\n * Run a full health check on the workspace.\n *\n * Checks whether the driver binary is installed, then validates every\n * declared mount and connector.  Returns a JSON report with a top-level\n * `passed` boolean and per-resource `ok` flags.\n *\n * @param plugin - Plugin instance (or compatible shape) exposing managers.\n * @param driver - Driver name used to locate the binary (`omp` or `claude`).\n *\n * @docLink packages/workspace-plugin/concepts#tool-delivery\n */\nexport async function workspaceValidate(plugin: PluginLike, driver: string): Promise<ToolResult> {\n  const report: Record<string, unknown> = {\n    driver: { name: driver, installed: false },\n    mounts: [] as unknown[],\n    connectors: [] as unknown[],\n  };\n\n  try {\n    const binaryName = driver === \"omp\" ? \"omp\" : \"claude\";\n    // `killSignal: \"SIGKILL\"`: a process stuck in an uninterruptible wait on a\n    // dead mount never receives SIGTERM, so a SIGTERM-based timeout would not\n    // actually end it — the same reason the recipe resolver uses SIGKILL.\n    await execFileAsync(\"which\", [binaryName], {\n      timeout: WHICH_TIMEOUT_MS,\n      killSignal: \"SIGKILL\",\n    });\n    (report.driver as any).installed = true;\n  } catch {\n    (report.driver as any).installed = false;\n    (report.driver as any).hint = `Install the '${driver}' binary to use this driver`;\n  }\n\n  const { mounts, connectors } = splitConnectors(plugin);\n  for (const v of mounts) {\n    (report.mounts as any[]).push({\n      id: v.id,\n      driver: v.driver,\n      mounted: true,\n      ok: true,\n    });\n  }\n\n  for (const c of connectors) {\n    (report.connectors as any[]).push({\n      id: c.id,\n      adapter: c.driver,\n      connected: true,\n      ok: true,\n    });\n  }\n\n  report.passed =\n    (report.driver as any).installed &&\n    (report.mounts as any[]).every((v) => v.ok) &&\n    (report.connectors as any[]).every((c) => c.ok);\n\n  return okJson(report);\n}\n\n/**\n * Re-read `skaile.yaml` and reinitialise all plugin resources.\n *\n * Delegates to `plugin.reload()`.  Returns a JSON object comparing the\n * mount and connector counts before and after the reload.\n *\n * @param plugin - Plugin instance exposing a `reload()` method.\n *\n * @docLink packages/workspace-plugin/concepts#tool-delivery\n */\nexport async function workspaceReload(plugin: PluginLike): Promise<ToolResult> {\n  try {\n    const countBefore = splitConnectors(plugin);\n    const before = { mounts: countBefore.mounts.length, connectors: countBefore.connectors.length };\n    await plugin.reload();\n    const countAfter = splitConnectors(plugin);\n    const after = { mounts: countAfter.mounts.length, connectors: countAfter.connectors.length };\n    return okJson({ reloaded: true, before, after });\n  } catch (e: unknown) {\n    return err(e instanceof Error ? e.message : String(e));\n  }\n}\n"]}