import type { AgentTool } from "@caupulican/pi-agent-core";
import { type Static, Type } from "typebox";
import { type ArtifactRetrievalMode } from "../context/artifact-retrieval.ts";
import type { ArtifactStore } from "../context/context-artifacts.ts";
import type { ToolDefinition } from "../extensions/types.ts";
declare const artifactRetrieveSchema: Type.TObject<{
    artifactId: Type.TString;
    mode: Type.TOptional<Type.TUnion<[Type.TLiteral<"metadata">, Type.TLiteral<"head">, Type.TLiteral<"tail">]>>;
    maxLines: Type.TOptional<Type.TNumber>;
}>;
export type ArtifactRetrieveToolInput = Static<typeof artifactRetrieveSchema>;
export interface ArtifactRetrieveToolDetails {
    found: boolean;
    mode: ArtifactRetrievalMode;
}
export interface ArtifactRetrieveToolOptions {
    /** Session-scoped artifact store to resolve ids against. Omitted: the tool reports unavailable. */
    artifactStore?: ArtifactStore;
}
export declare function createArtifactRetrieveToolDefinition(_cwd: string, options?: ArtifactRetrieveToolOptions): ToolDefinition<typeof artifactRetrieveSchema, ArtifactRetrieveToolDetails | undefined>;
export declare function createArtifactRetrieveTool(cwd: string, options?: ArtifactRetrieveToolOptions): AgentTool<typeof artifactRetrieveSchema>;
export {};
//# sourceMappingURL=artifact-retrieve.d.ts.map