@skaile/workspaces 0.8.5

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

@@ -0,0 +1,94 @@
+import type { ConnectorManager } from "@skaile/workspaces/connectors";
+import type { ToolResult } from "../types.js";
+/**
+ * List all connectors registered with the `ConnectorManager`.
+ *
+ * Returns a JSON array of connector descriptors as reported by
+ * `manager.listConnectors()`.  Returns an error result when no manager is
+ * configured (i.e. `skaile.yaml` has no `connectors` section).
+ *
+ * @param manager - Active `ConnectorManager` or `null` when not configured.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function connectorList(manager: ConnectorManager | null): Promise<ToolResult>;
+/**
+ * Read content from a connector at the given path.
+ *
+ * Delegates to `manager.read(id, path)`.  Returns an error result when the
+ * path yields `null` (not found) or the manager is absent.
+ *
+ * @param manager - Active `ConnectorManager` or `null`.
+ * @param id      - Connector ID declared in `skaile.yaml`.
+ * @param path    - Resource path within the connector (connector-specific format).
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function connectorRead(manager: ConnectorManager | null, id: string, path: string): Promise<ToolResult>;
+/**
+ * Write string content to a connector at the given path.
+ *
+ * Delegates to `manager.write(id, path, { data: content })`.
+ *
+ * @param manager - Active `ConnectorManager` or `null`.
+ * @param id      - Connector ID declared in `skaile.yaml`.
+ * @param path    - Destination path within the connector.
+ * @param content - String payload to write.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function connectorWrite(manager: ConnectorManager | null, id: string, path: string, content: string): Promise<ToolResult>;
+/**
+ * Search a connector's data using a query string.
+ *
+ * Delegates to `manager.search(id, query)` and returns the result set as JSON.
+ *
+ * @param manager - Active `ConnectorManager` or `null`.
+ * @param id      - Connector ID declared in `skaile.yaml`.
+ * @param query   - Free-text or structured query (connector-specific format).
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function connectorSearch(manager: ConnectorManager | null, id: string, query: string): Promise<ToolResult>;
+/**
+ * Execute a named operation on a connector.
+ *
+ * Delegates to `manager.executeOp(id, operation, args)`.  Operations and
+ * their argument shapes are connector-specific; use {@link connectorDescribe}
+ * to discover what operations a connector supports.
+ *
+ * @param manager   - Active `ConnectorManager` or `null`.
+ * @param id        - Connector ID declared in `skaile.yaml`.
+ * @param operation - Operation name (from the connector's `RuntimeSkillDescriptor`).
+ * @param args      - Named arguments for the operation.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function connectorExec(manager: ConnectorManager | null, id: string, operation: string, args: Record<string, unknown>): Promise<ToolResult>;
+/**
+ * Load the rendered skill body for a connector.
+ *
+ * Delegates to `manager.loadSkill(id)` and returns the skill content as
+ * plain text.  Useful when the agent needs the connector's operations and
+ * usage instructions injected as prompt context.
+ *
+ * @param manager - Active `ConnectorManager` or `null`.
+ * @param id      - Connector ID declared in `skaile.yaml`.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function connectorLoadSkill(manager: ConnectorManager | null, id: string): Promise<ToolResult>;
+/**
+ * Describe a connector's capabilities via its `RuntimeSkillDescriptor`.
+ *
+ * Finds the matching skill descriptor from `manager.listSkills()` and returns
+ * it as JSON.  The descriptor includes the connector's operations, argument
+ * shapes, and usage instructions.
+ *
+ * @param manager - Active `ConnectorManager` or `null`.
+ * @param id      - Connector ID declared in `skaile.yaml`.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function connectorDescribe(manager: ConnectorManager | null, id: string): Promise<ToolResult>;
+//# sourceMappingURL=connectors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connectors.d.ts","sourceRoot":"","sources":["../../../../workspace-plugin/src/tools/connectors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAQzF;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,gBAAgB,GAAG,IAAI,EAChC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,UAAU,CAAC,CASrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,gBAAgB,GAAG,IAAI,EAChC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,CAAC,CAQrB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,gBAAgB,GAAG,IAAI,EAChC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,UAAU,CAAC,CAQrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,gBAAgB,GAAG,IAAI,EAChC,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,UAAU,CAAC,CAQrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,gBAAgB,GAAG,IAAI,EAChC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,UAAU,CAAC,CAQrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,gBAAgB,GAAG,IAAI,EAChC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,UAAU,CAAC,CAUrB"}

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

@@ -0,0 +1,54 @@
+import type { ToolResult } from "../types.js";
+/**
+ * List all flow definitions available in the project's `ai-assets` directory.
+ *
+ * Returns a JSON array of summary objects `{ id, name, nodeCount }`.
+ * Returns an empty array when no `ai-assets` root is found.
+ *
+ * @param projectDir - Absolute path to the skaile project root.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function flowList(projectDir: string): Promise<ToolResult>;
+/**
+ * Show the full flow definition (nodes, edges, metadata) for a specific flow.
+ *
+ * @param projectDir - Absolute path to the skaile project root.
+ * @param flowId     - Flow ID as returned by {@link flowList}.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function flowShow(projectDir: string, flowId: string): Promise<ToolResult>;
+/**
+ * List all past and active flow run sessions for the workspace.
+ *
+ * Delegates to {@link readAllSessions} (reads `.skaile/sessions/*.json`),
+ * sorted newest-first by `updatedAt`.
+ *
+ * @param projectDir - Absolute path to the skaile project root.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function flowListSessions(projectDir: string): Promise<ToolResult>;
+/**
+ * Get driver metadata for a specific flow run session.
+ *
+ * @param projectDir - Absolute path to the skaile project root.
+ * @param runId      - Run ID from {@link flowListSessions}.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function flowGetSession(projectDir: string, runId: string): Promise<ToolResult>;
+/**
+ * Resolve and return the flow definition that was used in a past session.
+ *
+ * Looks up the session by `runId`, reads its `flowId`, then returns the full
+ * flow definition from `ai-assets`.
+ *
+ * @param projectDir - Absolute path to the skaile project root.
+ * @param runId      - Run ID from {@link flowListSessions}.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function flowFindFlowForSession(projectDir: string, runId: string): Promise<ToolResult>;
+//# sourceMappingURL=flows.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flows.d.ts","sourceRoot":"","sources":["../../../../workspace-plugin/src/tools/flows.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAM9C;;;;;;;;;GASG;AACH,wBAAsB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAetE;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAYtF;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAO9E;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAS3F;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,UAAU,CAAC,CAiBrB"}

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

@@ -0,0 +1,51 @@
+import type { MountManager } from "@skaile/workspaces/connectors";
+import type { ToolResult } from "../types.js";
+/**
+ * List all mounts declared in `skaile.yaml` with their current mount status.
+ *
+ * Returns a JSON array of mount descriptors from `mountManager.listMounts()`.
+ * Returns an error result when no manager is configured.
+ *
+ * @param mountManager - Active `MountManager` or `null` when not configured.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function mountList(mountManager: MountManager | null): Promise<ToolResult>;
+/**
+ * Sync a mount — pull the latest content from its remote source.
+ *
+ * Delegates to `mountManager.sync(mountId)` and returns the sync result as
+ * JSON.  Supported remotes include git, S3, WebDAV, and SharePoint.
+ *
+ * @param mountManager - Active `MountManager` or `null`.
+ * @param mountId      - Mount ID declared in `skaile.yaml`.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function mountSync(mountManager: MountManager | null, mountId: string): Promise<ToolResult>;
+/**
+ * Get the current status and mount metadata for a single mount.
+ *
+ * Finds the mount by ID in `mountManager.listMounts()` and returns its
+ * descriptor as JSON.
+ *
+ * @param mountManager - Active `MountManager` or `null`.
+ * @param mountId      - Mount ID declared in `skaile.yaml`.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function mountStatus(mountManager: MountManager | null, mountId: string): Promise<ToolResult>;
+/**
+ * Read a file from within a mounted mount by its relative path.
+ *
+ * Resolves `filePath` against the mount's `mountPath` and reads the file as
+ * UTF-8 text.
+ *
+ * @param mountManager - Active `MountManager` or `null`.
+ * @param mountId      - Mount ID declared in `skaile.yaml`.
+ * @param filePath     - Relative path within the mount directory.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function mountRead(mountManager: MountManager | null, mountId: string, filePath: string): Promise<ToolResult>;
+//# sourceMappingURL=mounts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mounts.d.ts","sourceRoot":"","sources":["../../../../workspace-plugin/src/tools/mounts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAQtF;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAC7B,YAAY,EAAE,YAAY,GAAG,IAAI,EACjC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,CAAC,CAQrB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,YAAY,EAAE,YAAY,GAAG,IAAI,EACjC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,CAAC,CAUrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAC7B,YAAY,EAAE,YAAY,GAAG,IAAI,EACjC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC,CAWrB"}

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

@@ -0,0 +1,35 @@
+import type { SessionState, ToolResult } from "../types.js";
+/**
+ * Read all session state files from `.skaile/sessions/` and return them
+ * sorted newest-first by `updatedAt`.
+ *
+ * Silently skips missing directories and corrupt JSON files.  This function
+ * is exported for internal use by `flows.ts` — prefer {@link sessionList} or
+ * {@link sessionGet} for tool-level access.
+ *
+ * @param projectDir - Absolute path to the skaile project root.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function readAllSessions(projectDir: string): Promise<SessionState[]>;
+/**
+ * List all past agent run sessions for the workspace, sorted newest-first.
+ *
+ * Returns a JSON array of {@link SessionState} objects read from
+ * `.skaile/sessions/*.json`.
+ *
+ * @param projectDir - Absolute path to the skaile project root.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function sessionList(projectDir: string): Promise<ToolResult>;
+/**
+ * Get full metadata for a specific agent run session.
+ *
+ * @param projectDir - Absolute path to the skaile project root.
+ * @param runId      - Run ID as returned by {@link sessionList}.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function sessionGet(projectDir: string, runId: string): Promise<ToolResult>;
+//# sourceMappingURL=sessions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../../../workspace-plugin/src/tools/sessions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE5D;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAkBjF;AAED;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAOzE;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CASvF"}

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

@@ -0,0 +1,75 @@
+import type { ToolResult } from "../types.js";
+/**
+ * List all skills in the `ai-assets` catalog, optionally filtered by domain.
+ *
+ * Walks every `<domain>/skills/` directory under the `ai-assets` root looking
+ * for `SKILL.md` files.  Returns a JSON array of skill summaries
+ * `{ id, name, description, source, version, keywords, domain }`.
+ *
+ * @param projectDir - Absolute path to the skaile project root.
+ * @param domain     - Optional domain name filter (e.g. `"skaile-development"`).
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function skillList(projectDir: string, domain: string | undefined): Promise<ToolResult>;
+/**
+ * List all skill domains — the top-level directories under `ai-assets` that
+ * contain a `skills/` subdirectory.
+ *
+ * Returns a JSON array of `{ name, path }` objects.
+ *
+ * @param projectDir - Absolute path to the skaile project root.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function skillListDomains(projectDir: string): Promise<ToolResult>;
+/**
+ * Show the full `SKILL.md` content for a skill.
+ *
+ * @param projectDir - Absolute path to the skaile project root.
+ * @param skillId    - Skill ID (directory name) as returned by {@link skillList}.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function skillShow(projectDir: string, skillId: string): Promise<ToolResult>;
+/**
+ * Search skills by name, description, ID, or keywords.
+ *
+ * Case-insensitive substring match against all text fields in every skill
+ * entry.  Returns the same summary shape as {@link skillList}.
+ *
+ * @param projectDir - Absolute path to the skaile project root.
+ * @param query      - Search string.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function skillSearch(projectDir: string, query: string): Promise<ToolResult>;
+/**
+ * Validate that all prerequisites declared in a skill's `SKILL.md` are
+ * satisfied in `targetDir`.
+ *
+ * Uses `@skaile/workspaces/resolver` to parse the `REQUIRES` / `READS` / `WRITES`
+ * DSL and run the requirement checks against the filesystem.  Returns a
+ * validation report as JSON.
+ *
+ * @param projectDir - Absolute path to the skaile project root (for skill lookup).
+ * @param skillId    - Skill ID as returned by {@link skillList}.
+ * @param targetDir  - Directory to validate against (typically the user's project).
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function skillCheckRequirements(projectDir: string, skillId: string, targetDir: string): Promise<ToolResult>;
+/**
+ * Get the formatted `REQUIRES`/`INPUT`/`READS`/`WRITES` DSL preamble for a skill.
+ *
+ * Uses `@skaile/workspaces/resolver` to build the requirements preamble that can be
+ * prepended to the skill prompt for injection into the agent's context.
+ * Returns `"(no requirements declared)"` when the skill has no requirements.
+ *
+ * @param projectDir - Absolute path to the skaile project root.
+ * @param skillId    - Skill ID as returned by {@link skillList}.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function skillGetPreamble(projectDir: string, skillId: string): Promise<ToolResult>;
+//# sourceMappingURL=skills.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../../workspace-plugin/src/tools/skills.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAqF9C;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAC7B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,OAAO,CAAC,UAAU,CAAC,CAmBrB;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAY9E;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAYxF;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA2BxF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC,CAerB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAe/F"}

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

@@ -0,0 +1,64 @@
+import type { ToolResult } from "../types.js";
+interface PluginLike {
+    projectDir: string;
+    mountManager: {
+        listMounts(): unknown[];
+    } | null;
+    connectorManager: {
+        listConnectors(): unknown[];
+    } | null;
+    reload(): Promise<void>;
+}
+/**
+ * Return a summary of the current workspace configuration.
+ *
+ * Reports the active driver, provider, model, mount count, connector count,
+ * and per-resource descriptors.
+ *
+ * @param plugin   - Plugin instance (or compatible shape) exposing managers.
+ * @param driver   - Driver name (e.g. `"omp"`, `"claude-sdk"`).
+ * @param provider - Provider identifier, if resolved.
+ * @param model    - Model identifier, if resolved.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function workspaceInfo(plugin: PluginLike, driver: string, provider: string | undefined, model: string | undefined): Promise<ToolResult>;
+/**
+ * Test resolution of a secret reference.
+ *
+ * Resolves `env:<VAR>` references against `process.env`.  For other provider
+ * schemes (e.g. `forge:key`) reports that a running forge/vault context is
+ * required.  Returns a JSON object with `{ resolved, provider?, masked? }` —
+ * the secret value is never returned in plain text.
+ *
+ * @param ref - Secret reference string, e.g. `"env:ANTHROPIC_API_KEY"`.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function workspaceTestSecret(ref: string): Promise<ToolResult>;
+/**
+ * Run a full health check on the workspace.
+ *
+ * Checks whether the driver binary is installed, then validates every
+ * declared mount and connector.  Returns a JSON report with a top-level
+ * `passed` boolean and per-resource `ok` flags.
+ *
+ * @param plugin - Plugin instance (or compatible shape) exposing managers.
+ * @param driver - Driver name used to locate the binary (`omp` or `claude`).
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function workspaceValidate(plugin: PluginLike, driver: string): Promise<ToolResult>;
+/**
+ * Re-read `skaile.yaml` and reinitialise all plugin resources.
+ *
+ * Delegates to `plugin.reload()`.  Returns a JSON object comparing the
+ * mount and connector counts before and after the reload.
+ *
+ * @param plugin - Plugin instance exposing a `reload()` method.
+ *
+ * @docLink packages/workspace-plugin/concepts#tool-delivery
+ */
+export declare function workspaceReload(plugin: PluginLike): Promise<ToolResult>;
+export {};
+//# sourceMappingURL=validator.d.ts.map

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

@@ -0,0 +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;AAG9C,UAAU,UAAU;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE;QAAE,UAAU,IAAI,OAAO,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,gBAAgB,EAAE;QAAE,cAAc,IAAI,OAAO,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IACzD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAwBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,OAAO,CAAC,UAAU,CAAC,CAiBrB;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,CA0C/F;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAe7E"}

package/dist/workspace-plugin/src/types.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Standard tool result shape used by all plugin tool functions.
+ *
+ * Mirrors the MCP `CallToolResult` content structure so results can be
+ * forwarded directly to either adapter without transformation.
+ *
+ * Construct via {@link ok}, {@link okJson}, or {@link err} — never manually.
+ *
+ * @docLink packages/workspace-plugin/concepts#plugin-types
+ */
+export interface ToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * Return a successful plain-text {@link ToolResult}.
+ *
+ * @param text - Human-readable result string delivered to the agent.
+ * @returns A `ToolResult` with `isError` unset.
+ *
+ * @docLink packages/workspace-plugin/concepts#plugin-types
+ */
+export declare function ok(text: string): ToolResult;
+/**
+ * Return a successful JSON {@link ToolResult}.
+ *
+ * Serializes `data` with two-space indentation.  The agent receives the
+ * pretty-printed JSON string as a text block.
+ *
+ * @param data - Any JSON-serialisable value.
+ * @returns A `ToolResult` with `isError` unset.
+ *
+ * @docLink packages/workspace-plugin/concepts#plugin-types
+ */
+export declare function okJson(data: unknown): ToolResult;
+/**
+ * Return an error {@link ToolResult}.
+ *
+ * The message is prefixed with `"Error: "` so agents can identify failures
+ * without inspecting `isError`.
+ *
+ * @param message - Short description of what went wrong.
+ * @returns A `ToolResult` with `isError: true`.
+ *
+ * @docLink packages/workspace-plugin/concepts#plugin-types
+ */
+export declare function err(message: string): ToolResult;
+/**
+ * Minimal session state shape persisted to `.skaile/sessions/<runId>.json`.
+ *
+ * Intentionally a subset of `runner/src/session.ts` — this package must not
+ * depend on `@skaile/workspaces/runner` to avoid a circular dependency.
+ *
+ * @docLink packages/workspace-plugin/concepts#plugin-types
+ */
+export interface SessionState {
+    runId: string;
+    flowId: string;
+    projectDir: string;
+    agentDir?: string;
+    driver: string;
+    provider?: string;
+    model?: string;
+    driverSessionId?: string;
+    startedAt: string;
+    updatedAt: string;
+    label?: string;
+    status?: "running" | "complete" | "failed" | "paused";
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/workspace-plugin/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../workspace-plugin/src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAE3C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAEhD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAE/C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;CACvD"}

package/dist/workspace-plugin/src/utils/ai-assets.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Walk up from `startDir` looking for an `ai-assets/` directory.
+ *
+ * Synchronous directory walk capped at the filesystem root.  Called once per
+ * plugin invocation at startup time — synchronous is intentional to keep the
+ * boot path simple.
+ *
+ * @param startDir - Absolute path to begin the upward search from (typically
+ *   the skaile `projectDir`).
+ * @returns Absolute path to the first `ai-assets/` directory found, or `null`
+ *   if no match exists between `startDir` and the filesystem root.
+ *
+ * @docLink packages/workspace-plugin/concepts#workspaceplugin-lifecycle
+ */
+export declare function findAiAssetsRoot(startDir: string): string | null;
+//# sourceMappingURL=ai-assets.d.ts.map

package/dist/workspace-plugin/src/utils/ai-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-assets.d.ts","sourceRoot":"","sources":["../../../../workspace-plugin/src/utils/ai-assets.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAehE"}

package/dist/workspace-plugin/src/utils/project-dir.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Resolve the skaile project directory from environment variables.
+ *
+ * Resolution order:
+ * 1. `SKAILE_PROJECT_DIR` (always checked first)
+ * 2. Any additional env var keys supplied by the caller (in order)
+ * 3. `process.cwd()` as final fallback
+ *
+ * @param additionalEnvVars - Optional list of extra environment variable names
+ *   to check before falling back to `process.cwd()`.
+ * @returns Absolute path to the resolved project directory.
+ *
+ * @example
+ * // Claude Code — also checks CLAUDE_PROJECT_DIR
+ * const projectDir = resolveProjectDir(["CLAUDE_PROJECT_DIR"]);
+ *
+ * // OMP / standalone — SKAILE_PROJECT_DIR or cwd only
+ * const projectDir = resolveProjectDir();
+ *
+ * @docLink packages/workspace-plugin/concepts#workspaceplugin-lifecycle
+ */
+export declare function resolveProjectDir(additionalEnvVars?: string[]): string;
+//# sourceMappingURL=project-dir.d.ts.map

package/dist/workspace-plugin/src/utils/project-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-dir.d.ts","sourceRoot":"","sources":["../../../../workspace-plugin/src/utils/project-dir.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAOtE"}