@skaile/workspaces 0.8.5

package/dist/types/src/transport.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Transport interfaces — the pluggable communication layer between
+ * agent client and server.
+ *
+ * ClientTransport: used by AgentClient to send commands and receive events.
+ * ServerTransport: used by the agent server to receive commands and send events.
+ *
+ * Transport implementations (WebSocket, stdio, etc.) live in
+ * @skaile/workspaces/transport. These interfaces live here so both the client
+ * and server packages can depend on them without depending on each other.
+ */
+import type { AgentEvent } from "./events.js";
+import type { AgentCommand } from "./protocol.js";
+/**
+ * Client-side transport: sends commands to the agent server and receives events.
+ *
+ * Implementations live in `@skaile/workspaces/transport` (WebSocket, stdio, etc.).
+ * `AgentClient` uses this interface to drive the remote agent side of the
+ * {@link IAgentRuntime} contract regardless of the underlying connection medium.
+ *
+ * @see {@link ServerTransport} for the server-side counterpart
+ * @category Transport
+ * @since 1.0.0
+ * @docLink packages/types/transport#client-transport
+ */
+export interface ClientTransport {
+    /** Establish the connection. */
+    connect(): Promise<void>;
+    /** Tear down the connection. */
+    disconnect(): Promise<void>;
+    /** Send a command to the server. */
+    send(command: AgentCommand): void;
+    /** Subscribe to events from the server. Returns unsubscribe function. */
+    onMessage(handler: (event: AgentEvent) => void): () => void;
+    /** Subscribe to disconnect events. Returns unsubscribe function. */
+    onDisconnect(handler: () => void): () => void;
+    /** Whether the transport is currently connected. */
+    readonly connected: boolean;
+}
+/**
+ * Server-side transport: sends events to the connected client and receives commands.
+ *
+ * Implementations live in `@skaile/workspaces/transport` (WebSocket, stdio, etc.).
+ * The runner's `serve()` layer binds a `ServerTransport` to handle incoming
+ * {@link AgentCommand} messages and stream {@link AgentEvent} responses back.
+ *
+ * @see {@link ClientTransport} for the client-side counterpart
+ * @category Transport
+ * @since 1.0.0
+ * @docLink packages/types/transport#server-transport
+ */
+export interface ServerTransport {
+    /** Send an event to the connected client. */
+    send(event: AgentEvent): void;
+    /** Subscribe to commands from the client. Returns unsubscribe function. */
+    onCommand(handler: (command: AgentCommand) => void): () => void;
+    /** Subscribe to client connect events. Returns unsubscribe function. */
+    onConnect(handler: () => void): () => void;
+    /** Subscribe to client disconnect events. Returns unsubscribe function. */
+    onDisconnect(handler: () => void): () => void;
+    /** Whether a client is currently connected. */
+    readonly connected: boolean;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/types/src/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../types/src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB,gCAAgC;IAChC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B,oCAAoC;IACpC,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAElC,yEAAyE;IACzE,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAE5D,oEAAoE;IACpE,YAAY,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAE9C,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAE9B,2EAA2E;IAC3E,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAEhE,wEAAwE;IACxE,SAAS,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAE3C,2EAA2E;IAC3E,YAAY,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAE9C,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B"}

package/dist/types/src/version.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Protocol versioning primitives for Skaile Agent Protocol v2.
+ *
+ * The protocol is versioned by a structured {@link ProtocolVersion} record
+ * (`major.minor.patch`). The compatibility rule applied at handshake is
+ * **major-equality**: a runner emits {@link IncompatibleProtocolEvent} and
+ * shuts down when its declared major does not match the platform's announced
+ * major. Minor and patch differences ride through transparently because
+ * unknown fields are preserved on round-trip (see `MessageMeta` round-trip
+ * contract in `messaging.ts`).
+ *
+ * @category Protocol
+ * @since 2.0.0
+ */
+/**
+ * Structured semantic version triple for the agent protocol.
+ *
+ * @example
+ * ```ts
+ * const v: ProtocolVersion = { major: 2, minor: 0, patch: 0 };
+ * ```
+ *
+ * @category Protocol
+ * @since 2.0.0
+ * @docLink packages/types/protocol-v2#protocol-version
+ */
+export type ProtocolVersion = {
+    /** Incremented on breaking wire-format changes (field removed, semantics changed, required field added). */
+    major: number;
+    /** Incremented on additive wire-format changes (new optional fields, new event types). */
+    minor: number;
+    /** Incremented on bug-fix or doc-only changes that do not affect the wire. */
+    patch: number;
+};
+/**
+ * The protocol version the framework currently speaks. Runners and platforms
+ * compare this against the peer's announced version at session boot via
+ * `SessionInitCommand.protocolVersion`.
+ *
+ * @example
+ * ```ts
+ * import { PROTOCOL_VERSION } from '@skaile/workspaces/types';
+ * if (cmd.protocolVersion.major !== PROTOCOL_VERSION.major) {
+ *   emit({ type: 'incompatible_protocol', agentVersion: PROTOCOL_VERSION, platformVersion: cmd.protocolVersion });
+ * }
+ * ```
+ *
+ * @category Protocol
+ * @since 3.0.0
+ *
+ * Changed in 3.1.0:
+ * Additive cost / token usage extension. `FinishedEvent` gains an optional
+ * `tokens?: TokenUsage` field carrying per-turn input / output / cache-read /
+ * cache-creation / reasoning token counts. `AgentDriver.getTokenUsage()` is
+ * widened to return the same `TokenUsage` shape (existing consumers reading
+ * `inputTokens` / `outputTokens` keep working unchanged). Drivers that do not
+ * surface token usage continue to return `null` / omit the field.
+ *
+ * Changed in 3.0.0:
+ * Major bump for the deterministic session bootstrap rewrite. `ConfigureCommandV2`,
+ * `provision_secrets`, `request_access_token`, `add_resource`, `remove_resource`,
+ * `set_log_level`, `state_action`, `lifecycle`, `remount_mount`, `compact`, and
+ * `reconfigure_agent` are removed from the `AgentCommand` union. Their semantics
+ * are reachable through:
+ *   - `session_init` (one deterministic envelope at session start that delivers
+ *     identity, resolved config, pre-minted credentials, secrets, capabilities,
+ *     shared state, active flows, resume hints, and logging config),
+ *   - `host.refresh_credential` (capability invocation that replaces the
+ *     refresh-on-401 path of `request_access_token`), and
+ *   - `runner.*` capabilities (`runner.add_mount`, `runner.add_connector`,
+ *     `runner.remove_resource`, `runner.update_credential`, `runner.set_log_level`,
+ *     `runner.set_state`, `runner.lifecycle`) invoked by the platform via the
+ *     bidirectional capability registry.
+ *
+ * Capabilities gain an `audience: ('llm' | 'user' | 'runtime')[]` field that
+ * scopes visibility: host RPCs (`host.*`) and runner RPCs (`runner.*`) are
+ * `['runtime']` and never reach the LLM tool list or the user-facing command
+ * palette. v2.x capabilities without an explicit `audience` default to
+ * `['llm', 'user']`, preserving prior behaviour.
+ *
+ * Spec: `_devlog/specs/2026-05-10-deterministic-session-bootstrap.md`.
+ *
+ * @docLink packages/types/protocol-v3#protocol-version
+ */
+export declare const PROTOCOL_VERSION: ProtocolVersion;
+/**
+ * String form of {@link PROTOCOL_VERSION}, kept in lock-step. Useful for
+ * `package.json` version fields and HTTP `User-Agent` strings.
+ *
+ * @category Protocol
+ * @since 3.0.0
+ * @docLink packages/types/protocol-v3#protocol-version
+ */
+export declare const PROTOCOL_VERSION_STRING = "3.1.0";
+/**
+ * Parse a `"major.minor.patch"` string into a {@link ProtocolVersion}.
+ *
+ * @param s - the version string to parse, exactly three dot-separated non-negative integers
+ * @returns the parsed protocol version
+ * @throws {Error} if the string is not exactly three dot-separated non-negative integers
+ *
+ * @example
+ * ```ts
+ * parseVersion('2.0.0'); // { major: 2, minor: 0, patch: 0 }
+ * parseVersion('2.1');   // throws
+ * ```
+ *
+ * @category Protocol
+ * @since 2.0.0
+ * @docLink packages/types/protocol-v2#parse-version
+ */
+export declare function parseVersion(s: string): ProtocolVersion;
+/**
+ * Format a {@link ProtocolVersion} record into its `"major.minor.patch"` string form.
+ *
+ * @param v - the protocol version to format
+ * @returns the dot-joined string form
+ *
+ * @example
+ * ```ts
+ * formatVersion({ major: 2, minor: 0, patch: 0 }); // '2.0.0'
+ * ```
+ *
+ * @category Protocol
+ * @since 2.0.0
+ * @docLink packages/types/protocol-v2#format-version
+ */
+export declare function formatVersion(v: ProtocolVersion): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/types/src/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../types/src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,4GAA4G;IAC5G,KAAK,EAAE,MAAM,CAAC;IACd,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,eAAO,MAAM,gBAAgB,EAAE,eAAkD,CAAC;AAElF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAE/C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,eAAe,CAoBvD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CAExD"}

package/dist/validator-764EQNM3.js

@@ -0,0 +1,5 @@
+export { workspaceInfo, workspaceReload, workspaceTestSecret, workspaceValidate } from './chunk-D5IH3QMH.js';
+import './chunk-X5YPJV4N.js';
+import './chunk-NSBPE2FW.js';
+//# sourceMappingURL=validator-764EQNM3.js.map
+//# sourceMappingURL=validator-764EQNM3.js.map

package/dist/validator-764EQNM3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"validator-764EQNM3.js"}

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

@@ -0,0 +1,259 @@
+import { skillList, skillListDomains, skillShow, skillSearch, skillCheckRequirements, skillGetPreamble } from '../../chunk-LSGAYQ2E.js';
+import { workspaceValidate, workspaceInfo, workspaceTestSecret, workspaceReload } from '../../chunk-D5IH3QMH.js';
+import { connectorList, connectorRead, connectorWrite, connectorSearch, connectorExec, connectorLoadSkill, connectorDescribe } from '../../chunk-AIGWF3TJ.js';
+import { flowList, flowShow, flowListSessions, flowGetSession, flowFindFlowForSession } from '../../chunk-6UQ66R46.js';
+import '../../chunk-XCBG2KDC.js';
+import { sessionList, sessionGet } from '../../chunk-HK5FRWG6.js';
+import { mountList, mountSync, mountStatus, mountRead } from '../../chunk-QT2KQHDT.js';
+import '../../chunk-IPUYL6TD.js';
+import '../../chunk-X5YPJV4N.js';
+import '../../chunk-NSBPE2FW.js';
+import * as zNS from 'zod';
+
+var zStatic = zNS.z ?? zNS.default ?? zNS;
+function buildWorkspaceToolDefs(plugin) {
+  const z2 = zStatic;
+  const driver = plugin.driver ?? "omp";
+  const p = plugin.projectDir;
+  return [
+    // Mount tools
+    {
+      name: "mount_list",
+      description: "List all mounts declared in skaile.yaml with their mount status.",
+      inputSchema: {},
+      handler: async () => mountList(plugin.mountManager)
+    },
+    {
+      name: "mount_sync",
+      description: "Sync a mount \u2014 pull latest from remote (git, S3, WebDAV).",
+      inputSchema: { mount_id: z2.string().describe("Mount ID from mount_list") },
+      handler: async ({ mount_id }) => mountSync(plugin.mountManager, mount_id)
+    },
+    {
+      name: "mount_status",
+      description: "Get the mount status and last sync time for a mount.",
+      inputSchema: { mount_id: z2.string() },
+      handler: async ({ mount_id }) => mountStatus(plugin.mountManager, mount_id)
+    },
+    {
+      name: "mount_read",
+      description: "Read a file from a mounted mount by path.",
+      inputSchema: {
+        mount_id: z2.string(),
+        path: z2.string().describe("Relative path within the mount")
+      },
+      handler: async ({ mount_id, path }) => mountRead(plugin.mountManager, mount_id, path)
+    },
+    // Flow tools
+    {
+      name: "flow_list",
+      description: "List all available flow definitions from ai-assets.",
+      inputSchema: {},
+      handler: async () => flowList(p)
+    },
+    {
+      name: "flow_show",
+      description: "Show full flow definition (nodes + edges) for a flow ID.",
+      inputSchema: { flow_id: z2.string().describe("Flow ID from flow_list") },
+      handler: async ({ flow_id }) => flowShow(p, flow_id)
+    },
+    {
+      name: "flow_list_sessions",
+      description: "List past and active flow run sessions for this workspace.",
+      inputSchema: {},
+      handler: async () => flowListSessions(p)
+    },
+    {
+      name: "flow_get_session",
+      description: "Get driver metadata for a specific flow run session.",
+      inputSchema: { run_id: z2.string().describe("Run ID from flow_list_sessions") },
+      handler: async ({ run_id }) => flowGetSession(p, run_id)
+    },
+    {
+      name: "flow_find_flow_for_session",
+      description: "Resolve and return the flow definition used in a past session.",
+      inputSchema: { run_id: z2.string() },
+      handler: async ({ run_id }) => flowFindFlowForSession(p, run_id)
+    },
+    // Skill tools
+    {
+      name: "skill_list",
+      description: "List all skills in the ai-assets catalog, optionally filtered by domain.",
+      inputSchema: { domain: z2.string().optional().describe("Domain name filter") },
+      handler: async ({ domain }) => skillList(p, domain)
+    },
+    {
+      name: "skill_list_domains",
+      description: "List all skill domains (top-level ai-assets directories with skills).",
+      inputSchema: {},
+      handler: async () => skillListDomains(p)
+    },
+    {
+      name: "skill_show",
+      description: "Show the full SKILL.md content for a skill ID.",
+      inputSchema: { skill_id: z2.string().describe("Skill ID from skill_list") },
+      handler: async ({ skill_id }) => skillShow(p, skill_id)
+    },
+    {
+      name: "skill_search",
+      description: "Search skills by name, description, or keywords.",
+      inputSchema: { query: z2.string() },
+      handler: async ({ query }) => skillSearch(p, query)
+    },
+    {
+      name: "skill_check_requirements",
+      description: "Validate that all skill prerequisites are met in the target directory.",
+      inputSchema: {
+        skill_id: z2.string(),
+        target_dir: z2.string().optional().describe("Directory to check against (default: projectDir)")
+      },
+      handler: async ({ skill_id, target_dir }) => skillCheckRequirements(p, skill_id, target_dir ?? p)
+    },
+    {
+      name: "skill_get_preamble",
+      description: "Get the REQUIRES/INPUT/READS/WRITES DSL preamble for a skill.",
+      inputSchema: { skill_id: z2.string() },
+      handler: async ({ skill_id }) => skillGetPreamble(p, skill_id)
+    },
+    // Session tools
+    {
+      name: "session_list",
+      description: "List all past agent run sessions for this workspace, sorted newest first.",
+      inputSchema: {},
+      handler: async () => sessionList(p)
+    },
+    {
+      name: "session_get",
+      description: "Get full metadata for a specific session by run ID.",
+      inputSchema: { run_id: z2.string() },
+      handler: async ({ run_id }) => sessionGet(p, run_id)
+    },
+    // Connector tools
+    {
+      name: "connector_list",
+      description: "List all connectors declared in skaile.yaml with their connection status.",
+      inputSchema: {},
+      handler: async () => connectorList(plugin.connectorManager)
+    },
+    {
+      name: "connector_read",
+      description: "Read content from a connector by path.",
+      inputSchema: {
+        connector_id: z2.string().describe("Connector ID from connector_list"),
+        path: z2.string().describe("Path within the connector")
+      },
+      handler: async ({ connector_id, path }) => connectorRead(plugin.connectorManager, connector_id, path)
+    },
+    {
+      name: "connector_write",
+      description: "Write content to a connector by path.",
+      inputSchema: {
+        connector_id: z2.string(),
+        path: z2.string(),
+        content: z2.string().describe("Content to write")
+      },
+      handler: async ({
+        connector_id,
+        path,
+        content
+      }) => connectorWrite(plugin.connectorManager, connector_id, path, content)
+    },
+    {
+      name: "connector_search",
+      description: "Search within a connector by query string.",
+      inputSchema: {
+        connector_id: z2.string(),
+        query: z2.string().describe("Search query")
+      },
+      handler: async ({ connector_id, query }) => connectorSearch(plugin.connectorManager, connector_id, query)
+    },
+    {
+      name: "connector_exec",
+      description: "Execute a custom operation on a connector.",
+      inputSchema: {
+        connector_id: z2.string(),
+        operation: z2.string().describe("Operation name from connector_describe"),
+        args: z2.record(z2.unknown()).describe("Operation arguments")
+      },
+      handler: async ({
+        connector_id,
+        operation,
+        args
+      }) => connectorExec(plugin.connectorManager, connector_id, operation, args)
+    },
+    {
+      name: "connector_load_skill",
+      description: "Load the rendered skill body for a connector (operations + usage).",
+      inputSchema: {
+        connector_id: z2.string()
+      },
+      handler: async ({ connector_id }) => connectorLoadSkill(plugin.connectorManager, connector_id)
+    },
+    {
+      name: "connector_describe",
+      description: "Describe a connector's capabilities via its RuntimeSkillDescriptor.",
+      inputSchema: {
+        connector_id: z2.string()
+      },
+      handler: async ({ connector_id }) => connectorDescribe(plugin.connectorManager, connector_id)
+    },
+    // Validator tools
+    {
+      name: "workspace_validate",
+      description: "Run a full health check: connectors, mounts, secrets, driver binary.",
+      inputSchema: {},
+      handler: async () => workspaceValidate(plugin, driver)
+    },
+    {
+      name: "workspace_info",
+      description: "Show workspace configuration: driver, model, provider, resource counts.",
+      inputSchema: {},
+      handler: async () => workspaceInfo(plugin, driver, plugin.provider, plugin.model)
+    },
+    {
+      name: "workspace_test_secret",
+      description: "Test resolution of one secret reference (env:VAR, forge:key).",
+      inputSchema: { ref: z2.string().describe("Secret ref e.g. env:ANTHROPIC_API_KEY") },
+      handler: async ({ ref }) => workspaceTestSecret(ref)
+    },
+    {
+      name: "workspace_reload",
+      description: "Re-read skaile.yaml and re-sync the plugin state.",
+      inputSchema: {},
+      handler: async () => workspaceReload(plugin)
+    }
+  ];
+}
+async function buildWorkspaceMcpServer(plugin) {
+  let sdk;
+  try {
+    sdk = await import('@anthropic-ai/claude-agent-sdk');
+  } catch {
+    return null;
+  }
+  return sdk.createSdkMcpServer({
+    name: "skaile-workspace",
+    tools: buildWorkspaceToolDefs(plugin)
+  });
+}
+async function buildWorkspaceMcpStdioServer(plugin) {
+  const { McpServer } = await import('@modelcontextprotocol/sdk/server/mcp.js');
+  const server = new McpServer({ name: "skaile-workspace", version: "1.0.0" });
+  for (const def of buildWorkspaceToolDefs(plugin)) {
+    server.registerTool(
+      def.name,
+      { description: def.description, inputSchema: def.inputSchema },
+      def.handler
+    );
+  }
+  return server;
+}
+async function runMcpServerStdio(plugin) {
+  const server = await buildWorkspaceMcpStdioServer(plugin);
+  const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
+  await server.connect(new StdioServerTransport());
+}
+
+export { buildWorkspaceMcpServer, buildWorkspaceMcpStdioServer, buildWorkspaceToolDefs, runMcpServerStdio };
+//# sourceMappingURL=mcp.js.map
+//# sourceMappingURL=mcp.js.map

package/dist/workspace-plugin/adapters/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../workspace-plugin/src/adapters/mcp.ts"],"names":["z"],"mappings":"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","file":"mcp.js","sourcesContent":["// Static namespace import so bun --compile bundles zod into the binary.\n// Dynamic import(\"zod\") via a string variable evades bun's static analysis\n// and fails at runtime inside /$bunfs/. The unwrap (zNS.z ?? zNS.default\n// ?? zNS) handles both bun's native ESM and vitest's CJS-interop resolver,\n// which return the zod namespace at different keys.\nimport * as zNS from \"zod\";\nimport type { WorkspacePlugin } from \"../plugin.js\";\nimport {\n  connectorDescribe,\n  connectorExec,\n  connectorList,\n  connectorLoadSkill,\n  connectorRead,\n  connectorSearch,\n  connectorWrite,\n} from \"../tools/connectors.js\";\nimport {\n  flowFindFlowForSession,\n  flowGetSession,\n  flowList,\n  flowListSessions,\n  flowShow,\n} from \"../tools/flows.js\";\nimport { mountList, mountRead, mountStatus, mountSync } from \"../tools/mounts.js\";\nimport { sessionGet, sessionList } from \"../tools/sessions.js\";\nimport {\n  skillCheckRequirements,\n  skillGetPreamble,\n  skillList,\n  skillListDomains,\n  skillSearch,\n  skillShow,\n} from \"../tools/skills.js\";\nimport {\n  workspaceInfo,\n  workspaceReload,\n  workspaceTestSecret,\n  workspaceValidate,\n} from \"../tools/validator.js\";\n\nconst zStatic: any = (zNS as any).z ?? (zNS as any).default ?? zNS;\n\n/**\n * One workspace plugin tool — name, description, a zod raw-shape input schema,\n * and an async handler returning a `ToolResult`.\n *\n * Carries **zero MCP/SDK dependency**: the same definitions feed both the\n * in-process Claude Agent SDK server ({@link buildWorkspaceMcpServer}) and the\n * raw stdio MCP server ({@link buildWorkspaceMcpStdioServer}).\n */\nexport interface WorkspaceToolDef {\n  name: string;\n  description: string;\n  inputSchema: Record<string, unknown>;\n  handler: (args: any) => Promise<unknown>;\n}\n\n/**\n * Build the 28 workspace plugin tool definitions.\n *\n * Tool groups:\n * - 4 mount tools (`mount_list`, `mount_sync`, `mount_status`, `mount_read`)\n * - 5 flow tools (`flow_list`, `flow_show`, `flow_list_sessions`, `flow_get_session`, `flow_find_flow_for_session`)\n * - 6 skill tools (`skill_list`, `skill_list_domains`, `skill_show`, `skill_search`, `skill_check_requirements`, `skill_get_preamble`)\n * - 2 session tools (`session_list`, `session_get`)\n * - 7 connector tools (`connector_list`, `connector_read`, `connector_write`, `connector_search`, `connector_exec`, `connector_load_skill`, `connector_describe`)\n * - 4 workspace tools (`workspace_validate`, `workspace_info`, `workspace_test_secret`, `workspace_reload`)\n *\n * @param plugin - A booted `WorkspacePlugin` instance.\n * @returns The 28 tool definitions, free of any MCP/SDK coupling.\n *\n * @docLink packages/workspace-plugin/concepts#adapters\n */\nexport function buildWorkspaceToolDefs(plugin: WorkspacePlugin): WorkspaceToolDef[] {\n  const z: any = zStatic;\n\n  const driver = plugin.driver ?? \"omp\";\n  const p = plugin.projectDir;\n\n  return [\n    // Mount tools\n    {\n      name: \"mount_list\",\n      description: \"List all mounts declared in skaile.yaml with their mount status.\",\n      inputSchema: {},\n      handler: async () => mountList(plugin.mountManager),\n    },\n    {\n      name: \"mount_sync\",\n      description: \"Sync a mount — pull latest from remote (git, S3, WebDAV).\",\n      inputSchema: { mount_id: z.string().describe(\"Mount ID from mount_list\") },\n      handler: async ({ mount_id }: { mount_id: string }) =>\n        mountSync(plugin.mountManager, mount_id),\n    },\n    {\n      name: \"mount_status\",\n      description: \"Get the mount status and last sync time for a mount.\",\n      inputSchema: { mount_id: z.string() },\n      handler: async ({ mount_id }: { mount_id: string }) =>\n        mountStatus(plugin.mountManager, mount_id),\n    },\n    {\n      name: \"mount_read\",\n      description: \"Read a file from a mounted mount by path.\",\n      inputSchema: {\n        mount_id: z.string(),\n        path: z.string().describe(\"Relative path within the mount\"),\n      },\n      handler: async ({ mount_id, path }: { mount_id: string; path: string }) =>\n        mountRead(plugin.mountManager, mount_id, path),\n    },\n    // Flow tools\n    {\n      name: \"flow_list\",\n      description: \"List all available flow definitions from ai-assets.\",\n      inputSchema: {},\n      handler: async () => flowList(p),\n    },\n    {\n      name: \"flow_show\",\n      description: \"Show full flow definition (nodes + edges) for a flow ID.\",\n      inputSchema: { flow_id: z.string().describe(\"Flow ID from flow_list\") },\n      handler: async ({ flow_id }: { flow_id: string }) => flowShow(p, flow_id),\n    },\n    {\n      name: \"flow_list_sessions\",\n      description: \"List past and active flow run sessions for this workspace.\",\n      inputSchema: {},\n      handler: async () => flowListSessions(p),\n    },\n    {\n      name: \"flow_get_session\",\n      description: \"Get driver metadata for a specific flow run session.\",\n      inputSchema: { run_id: z.string().describe(\"Run ID from flow_list_sessions\") },\n      handler: async ({ run_id }: { run_id: string }) => flowGetSession(p, run_id),\n    },\n    {\n      name: \"flow_find_flow_for_session\",\n      description: \"Resolve and return the flow definition used in a past session.\",\n      inputSchema: { run_id: z.string() },\n      handler: async ({ run_id }: { run_id: string }) => flowFindFlowForSession(p, run_id),\n    },\n    // Skill tools\n    {\n      name: \"skill_list\",\n      description: \"List all skills in the ai-assets catalog, optionally filtered by domain.\",\n      inputSchema: { domain: z.string().optional().describe(\"Domain name filter\") },\n      handler: async ({ domain }: { domain?: string }) => skillList(p, domain),\n    },\n    {\n      name: \"skill_list_domains\",\n      description: \"List all skill domains (top-level ai-assets directories with skills).\",\n      inputSchema: {},\n      handler: async () => skillListDomains(p),\n    },\n    {\n      name: \"skill_show\",\n      description: \"Show the full SKILL.md content for a skill ID.\",\n      inputSchema: { skill_id: z.string().describe(\"Skill ID from skill_list\") },\n      handler: async ({ skill_id }: { skill_id: string }) => skillShow(p, skill_id),\n    },\n    {\n      name: \"skill_search\",\n      description: \"Search skills by name, description, or keywords.\",\n      inputSchema: { query: z.string() },\n      handler: async ({ query }: { query: string }) => skillSearch(p, query),\n    },\n    {\n      name: \"skill_check_requirements\",\n      description: \"Validate that all skill prerequisites are met in the target directory.\",\n      inputSchema: {\n        skill_id: z.string(),\n        target_dir: z\n          .string()\n          .optional()\n          .describe(\"Directory to check against (default: projectDir)\"),\n      },\n      handler: async ({ skill_id, target_dir }: { skill_id: string; target_dir?: string }) =>\n        skillCheckRequirements(p, skill_id, target_dir ?? p),\n    },\n    {\n      name: \"skill_get_preamble\",\n      description: \"Get the REQUIRES/INPUT/READS/WRITES DSL preamble for a skill.\",\n      inputSchema: { skill_id: z.string() },\n      handler: async ({ skill_id }: { skill_id: string }) => skillGetPreamble(p, skill_id),\n    },\n    // Session tools\n    {\n      name: \"session_list\",\n      description: \"List all past agent run sessions for this workspace, sorted newest first.\",\n      inputSchema: {},\n      handler: async () => sessionList(p),\n    },\n    {\n      name: \"session_get\",\n      description: \"Get full metadata for a specific session by run ID.\",\n      inputSchema: { run_id: z.string() },\n      handler: async ({ run_id }: { run_id: string }) => sessionGet(p, run_id),\n    },\n    // Connector tools\n    {\n      name: \"connector_list\",\n      description: \"List all connectors declared in skaile.yaml with their connection status.\",\n      inputSchema: {},\n      handler: async () => connectorList(plugin.connectorManager),\n    },\n    {\n      name: \"connector_read\",\n      description: \"Read content from a connector by path.\",\n      inputSchema: {\n        connector_id: z.string().describe(\"Connector ID from connector_list\"),\n        path: z.string().describe(\"Path within the connector\"),\n      },\n      handler: async ({ connector_id, path }: { connector_id: string; path: string }) =>\n        connectorRead(plugin.connectorManager, connector_id, path),\n    },\n    {\n      name: \"connector_write\",\n      description: \"Write content to a connector by path.\",\n      inputSchema: {\n        connector_id: z.string(),\n        path: z.string(),\n        content: z.string().describe(\"Content to write\"),\n      },\n      handler: async ({\n        connector_id,\n        path,\n        content,\n      }: {\n        connector_id: string;\n        path: string;\n        content: string;\n      }) => connectorWrite(plugin.connectorManager, connector_id, path, content),\n    },\n    {\n      name: \"connector_search\",\n      description: \"Search within a connector by query string.\",\n      inputSchema: {\n        connector_id: z.string(),\n        query: z.string().describe(\"Search query\"),\n      },\n      handler: async ({ connector_id, query }: { connector_id: string; query: string }) =>\n        connectorSearch(plugin.connectorManager, connector_id, query),\n    },\n    {\n      name: \"connector_exec\",\n      description: \"Execute a custom operation on a connector.\",\n      inputSchema: {\n        connector_id: z.string(),\n        operation: z.string().describe(\"Operation name from connector_describe\"),\n        args: z.record(z.unknown()).describe(\"Operation arguments\"),\n      },\n      handler: async ({\n        connector_id,\n        operation,\n        args,\n      }: {\n        connector_id: string;\n        operation: string;\n        args: Record<string, unknown>;\n      }) => connectorExec(plugin.connectorManager, connector_id, operation, args),\n    },\n    {\n      name: \"connector_load_skill\",\n      description: \"Load the rendered skill body for a connector (operations + usage).\",\n      inputSchema: {\n        connector_id: z.string(),\n      },\n      handler: async ({ connector_id }: { connector_id: string }) =>\n        connectorLoadSkill(plugin.connectorManager, connector_id),\n    },\n    {\n      name: \"connector_describe\",\n      description: \"Describe a connector's capabilities via its RuntimeSkillDescriptor.\",\n      inputSchema: {\n        connector_id: z.string(),\n      },\n      handler: async ({ connector_id }: { connector_id: string }) =>\n        connectorDescribe(plugin.connectorManager, connector_id),\n    },\n    // Validator tools\n    {\n      name: \"workspace_validate\",\n      description: \"Run a full health check: connectors, mounts, secrets, driver binary.\",\n      inputSchema: {},\n      handler: async () => workspaceValidate(plugin, driver),\n    },\n    {\n      name: \"workspace_info\",\n      description: \"Show workspace configuration: driver, model, provider, resource counts.\",\n      inputSchema: {},\n      handler: async () => workspaceInfo(plugin, driver, plugin.provider, plugin.model),\n    },\n    {\n      name: \"workspace_test_secret\",\n      description: \"Test resolution of one secret reference (env:VAR, forge:key).\",\n      inputSchema: { ref: z.string().describe(\"Secret ref e.g. env:ANTHROPIC_API_KEY\") },\n      handler: async ({ ref }: { ref: string }) => workspaceTestSecret(ref),\n    },\n    {\n      name: \"workspace_reload\",\n      description: \"Re-read skaile.yaml and re-sync the plugin state.\",\n      inputSchema: {},\n      handler: async () => workspaceReload(plugin),\n    },\n  ];\n}\n\n/**\n * Build the **in-process** workspace MCP server via the Claude Agent SDK's\n * `createSdkMcpServer`. This shape is what the runner embeds into a Claude\n * Agent SDK `query()` call — the runner *is* the Claude Agent SDK host.\n *\n * Returns `null` when `@anthropic-ai/claude-agent-sdk` is not installed\n * (graceful degradation for non-Claude-Code environments).\n *\n * For the standalone `skaile mcp-server` stdio subprocess use\n * {@link buildWorkspaceMcpStdioServer} / {@link runMcpServerStdio} instead —\n * those carry no Claude Agent SDK dependency.\n *\n * @param plugin - A booted `WorkspacePlugin` instance.\n * @returns The SDK MCP server object or `null` if the SDK is unavailable.\n *\n * @docLink packages/workspace-plugin/concepts#adapters\n */\nexport async function buildWorkspaceMcpServer(plugin: WorkspacePlugin): Promise<unknown | null> {\n  let sdk: any;\n  try {\n    sdk = await import(\"@anthropic-ai/claude-agent-sdk\");\n  } catch {\n    return null;\n  }\n  return sdk.createSdkMcpServer({\n    name: \"skaile-workspace\",\n    tools: buildWorkspaceToolDefs(plugin),\n  });\n}\n\n/**\n * Build a **raw stdio** workspace MCP server on `@modelcontextprotocol/sdk` —\n * no Claude Agent SDK. This is the correct shape for the `skaile mcp-server`\n * stdio subprocess that MCP-client agents (Claude Code, Codex, …) spawn.\n * Runs on plain Node.\n *\n * The returned server is not yet connected — call `.connect(transport)` (or\n * use {@link runMcpServerStdio}).\n *\n * @param plugin - A booted `WorkspacePlugin` instance.\n * @returns A `McpServer` with all 28 workspace tools registered.\n *\n * @docLink packages/workspace-plugin/concepts#adapters\n */\nexport async function buildWorkspaceMcpStdioServer(plugin: WorkspacePlugin): Promise<any> {\n  const { McpServer } = await import(\"@modelcontextprotocol/sdk/server/mcp.js\" as string);\n  const server = new McpServer({ name: \"skaile-workspace\", version: \"1.0.0\" });\n  for (const def of buildWorkspaceToolDefs(plugin)) {\n    server.registerTool(\n      def.name,\n      { description: def.description, inputSchema: def.inputSchema },\n      def.handler,\n    );\n  }\n  return server;\n}\n\n/**\n * Start the workspace MCP server over stdio transport.\n *\n * Builds the raw `@modelcontextprotocol/sdk` server via\n * {@link buildWorkspaceMcpStdioServer} and connects a `StdioServerTransport`.\n * No `@anthropic-ai/claude-agent-sdk` dependency anywhere on this path.\n *\n * @param plugin - A booted `WorkspacePlugin` instance.\n *\n * @docLink packages/workspace-plugin/concepts#adapters\n */\nexport async function runMcpServerStdio(plugin: WorkspacePlugin): Promise<void> {\n  const server = await buildWorkspaceMcpStdioServer(plugin);\n  const { StdioServerTransport } = await import(\n    \"@modelcontextprotocol/sdk/server/stdio.js\" as string\n  );\n  await server.connect(new StdioServerTransport());\n}\n"]}