import { SecretRef } from './secrets.js';
import { WorkspaceSkill } from './workspace.js';
/**
 * The shape provided to harness adapters via the sandbox projection capability.
 * Harness adapters read this in their `chatStream` setup to project workspace
 * inputs into their native format (MCP config, skills dirs, plugin installs).
 */
export interface WorkspaceProjection {
    /** Skills declared on the workspace — MCP servers, file skills, git repos, etc. */
    skills: Array<WorkspaceSkill>;
    /** Harness plugin identifiers to install idempotently. */
    plugins: Array<string>;
    /**
     * Resolve a SecretRef to its plaintext value. Bound to the workspace's
     * secrets registry; throws when the ref is unknown.
     */
    resolveSecret: (ref: SecretRef) => string;
    /**
     * Absolute path to the idempotency marker file. Harness adapters write this
     * file after a successful projection so subsequent runs skip re-projection.
     * The file is NOT included in snapshots — absent on restore, triggering
     * re-projection (which re-writes any secret-bearing config files).
     */
    markerPath: string;
    /** Workspace root inside the sandbox (e.g. `/workspace`). */
    root: string;
    /** Named commands declared on the workspace (e.g. `{ test: 'pnpm test' }`). */
    scripts?: Record<string, string>;
}
export declare const ProjectionCapability: import('@tanstack/ai').Capability<WorkspaceProjection, "sandbox-projection">;
export declare const getWorkspaceProjection: import('@tanstack/ai').CapabilityGetter<WorkspaceProjection>, provideWorkspaceProjection: import('@tanstack/ai').CapabilityProvider<WorkspaceProjection>;