import type { ConnectorManager } from "@skaile/workspaces/connectors";
import type { ToolResult } from "../types.js";
/**
 * List all mountable (filesystem-face) connectors declared in `skaile.yaml`
 * with their current mount status.
 *
 * @param manager - Active `ConnectorManager` or `null` when not configured.
 *
 * @docLink packages/workspace-plugin/concepts#tool-delivery
 */
export declare function mountList(manager: ConnectorManager | null): Promise<ToolResult>;
/**
 * Sync a mountable connector — pull the latest content from its remote source.
 *
 * @param manager - Active `ConnectorManager` or `null`.
 * @param mountId - Connector ID declared in `skaile.yaml`.
 *
 * @docLink packages/workspace-plugin/concepts#tool-delivery
 */
export declare function mountSync(manager: ConnectorManager | null, mountId: string): Promise<ToolResult>;
/**
 * Get the current status and metadata for a single mountable connector.
 *
 * @param manager - Active `ConnectorManager` or `null`.
 * @param mountId - Connector ID declared in `skaile.yaml`.
 *
 * @docLink packages/workspace-plugin/concepts#tool-delivery
 */
export declare function mountStatus(manager: ConnectorManager | null, mountId: string): Promise<ToolResult>;
/**
 * Read a file from within a mountable connector's projected directory by its
 * relative path.
 *
 * @param manager  - Active `ConnectorManager` or `null`.
 * @param mountId  - Connector ID declared in `skaile.yaml`.
 * @param filePath - Relative path within the projected mount directory.
 *
 * @docLink packages/workspace-plugin/concepts#tool-delivery
 */
export declare function mountRead(manager: ConnectorManager | null, mountId: string, filePath: string): Promise<ToolResult>;
/**
 * List all connectors registered with the `ConnectorManager`.
 *
 * Returns `{ connected, failed }` — `connected` from `manager.listConnectors()`,
 * `failed` from `manager.listFailedConnectors()`. A connector that threw during
 * `connect()` never enters the active map, so it is absent from the first list
 * entirely; without the second one an agent driven through MCP or OMP has no
 * way to learn that a mount it is about to write into is dead. 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