host-execution-mcp 1.0.0

package/dist/tools/remote-schemas.d.ts

@@ -0,0 +1,879 @@
+import { z } from "zod";
+import type { AccessRuntime } from "../access/index.js";
+import type { FileEndpoint } from "../utils/remote-copy.js";
+export declare const landingTarget: z.ZodLiteral<"landing">;
+export declare const podFields: {
+    namespace: z.ZodString;
+    pod: z.ZodString;
+    container: z.ZodOptional<z.ZodString>;
+};
+export declare const contextFields: {
+    contextKey: z.ZodString;
+};
+export type RemoteSchemaOpts = {
+    allowContext?: boolean;
+};
+/** Shared landing | pod [| context] discriminated union builder. */
+export declare function remotePathUnion<T extends z.ZodRawShape>(fields: T, opts?: RemoteSchemaOpts): z.ZodDiscriminatedUnion<"target", [z.ZodObject<{
+    target: z.ZodLiteral<"landing">;
+} & T, "strict", z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<{
+    target: z.ZodLiteral<"landing">;
+} & T>, any> extends infer T_1 ? { [k in keyof T_1]: T_1[k]; } : never, z.baseObjectInputType<{
+    target: z.ZodLiteral<"landing">;
+} & T> extends infer T_2 ? { [k_1 in keyof T_2]: T_2[k_1]; } : never>, z.ZodObject<{
+    namespace: z.ZodString;
+    pod: z.ZodString;
+    container: z.ZodOptional<z.ZodString>;
+    target: z.ZodLiteral<"pod">;
+} & T, "strict", z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<{
+    namespace: z.ZodString;
+    pod: z.ZodString;
+    container: z.ZodOptional<z.ZodString>;
+    target: z.ZodLiteral<"pod">;
+} & T>, any> extends infer T_3 ? { [k_2 in keyof T_3]: T_3[k_2]; } : never, z.baseObjectInputType<{
+    namespace: z.ZodString;
+    pod: z.ZodString;
+    container: z.ZodOptional<z.ZodString>;
+    target: z.ZodLiteral<"pod">;
+} & T> extends infer T_4 ? { [k_3 in keyof T_4]: T_4[k_3]; } : never>]> | z.ZodDiscriminatedUnion<"target", [z.ZodObject<{
+    target: z.ZodLiteral<"landing">;
+} & T, "strict", z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<{
+    target: z.ZodLiteral<"landing">;
+} & T>, any> extends infer T_5 ? { [k in keyof T_5]: T_5[k]; } : never, z.baseObjectInputType<{
+    target: z.ZodLiteral<"landing">;
+} & T> extends infer T_6 ? { [k_1 in keyof T_6]: T_6[k_1]; } : never>, z.ZodObject<{
+    namespace: z.ZodString;
+    pod: z.ZodString;
+    container: z.ZodOptional<z.ZodString>;
+    target: z.ZodLiteral<"pod">;
+} & T, "strict", z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<{
+    namespace: z.ZodString;
+    pod: z.ZodString;
+    container: z.ZodOptional<z.ZodString>;
+    target: z.ZodLiteral<"pod">;
+} & T>, any> extends infer T_7 ? { [k_2 in keyof T_7]: T_7[k_2]; } : never, z.baseObjectInputType<{
+    namespace: z.ZodString;
+    pod: z.ZodString;
+    container: z.ZodOptional<z.ZodString>;
+    target: z.ZodLiteral<"pod">;
+} & T> extends infer T_8 ? { [k_3 in keyof T_8]: T_8[k_3]; } : never>, z.ZodObject<{
+    contextKey: z.ZodString;
+    target: z.ZodLiteral<"context">;
+} & T, "strict", z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<{
+    contextKey: z.ZodString;
+    target: z.ZodLiteral<"context">;
+} & T>, any> extends infer T_9 ? { [k_4 in keyof T_9]: T_9[k_4]; } : never, z.baseObjectInputType<{
+    contextKey: z.ZodString;
+    target: z.ZodLiteral<"context">;
+} & T> extends infer T_10 ? { [k_5 in keyof T_10]: T_10[k_5]; } : never>]>;
+export declare function buildRemoteReadFileSchema(opts?: RemoteSchemaOpts): z.ZodDiscriminatedUnion<"target", [z.ZodObject<{
+    target: z.ZodLiteral<"landing">;
+} & {
+    mode: z.ZodOptional<z.ZodEnum<["head", "tail"]>>;
+    lines: z.ZodOptional<z.ZodNumber>;
+    maxLines: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    grep: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    path: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    target: "landing";
+    path: string;
+    timeoutMs?: number | undefined;
+    mode?: "head" | "tail" | undefined;
+    lines?: number | undefined;
+    maxLines?: number | undefined;
+    offset?: number | undefined;
+    grep?: string | undefined;
+}, {
+    target: "landing";
+    path: string;
+    timeoutMs?: number | undefined;
+    mode?: "head" | "tail" | undefined;
+    lines?: number | undefined;
+    maxLines?: number | undefined;
+    offset?: number | undefined;
+    grep?: string | undefined;
+}>, z.ZodObject<{
+    namespace: z.ZodString;
+    pod: z.ZodString;
+    container: z.ZodOptional<z.ZodString>;
+    target: z.ZodLiteral<"pod">;
+} & {
+    mode: z.ZodOptional<z.ZodEnum<["head", "tail"]>>;
+    lines: z.ZodOptional<z.ZodNumber>;
+    maxLines: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    grep: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    path: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    pod: string;
+    target: "pod";
+    path: string;
+    namespace: string;
+    timeoutMs?: number | undefined;
+    container?: string | undefined;
+    mode?: "head" | "tail" | undefined;
+    lines?: number | undefined;
+    maxLines?: number | undefined;
+    offset?: number | undefined;
+    grep?: string | undefined;
+}, {
+    pod: string;
+    target: "pod";
+    path: string;
+    namespace: string;
+    timeoutMs?: number | undefined;
+    container?: string | undefined;
+    mode?: "head" | "tail" | undefined;
+    lines?: number | undefined;
+    maxLines?: number | undefined;
+    offset?: number | undefined;
+    grep?: string | undefined;
+}>]> | z.ZodDiscriminatedUnion<"target", [z.ZodObject<{
+    target: z.ZodLiteral<"landing">;
+} & {
+    mode: z.ZodOptional<z.ZodEnum<["head", "tail"]>>;
+    lines: z.ZodOptional<z.ZodNumber>;
+    maxLines: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    grep: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    path: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    target: "landing";
+    path: string;
+    timeoutMs?: number | undefined;
+    mode?: "head" | "tail" | undefined;
+    lines?: number | undefined;
+    maxLines?: number | undefined;
+    offset?: number | undefined;
+    grep?: string | undefined;
+}, {
+    target: "landing";
+    path: string;
+    timeoutMs?: number | undefined;
+    mode?: "head" | "tail" | undefined;
+    lines?: number | undefined;
+    maxLines?: number | undefined;
+    offset?: number | undefined;
+    grep?: string | undefined;
+}>, z.ZodObject<{
+    namespace: z.ZodString;
+    pod: z.ZodString;
+    container: z.ZodOptional<z.ZodString>;
+    target: z.ZodLiteral<"pod">;
+} & {
+    mode: z.ZodOptional<z.ZodEnum<["head", "tail"]>>;
+    lines: z.ZodOptional<z.ZodNumber>;
+    maxLines: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    grep: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    path: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    pod: string;
+    target: "pod";
+    path: string;
+    namespace: string;
+    timeoutMs?: number | undefined;
+    container?: string | undefined;
+    mode?: "head" | "tail" | undefined;
+    lines?: number | undefined;
+    maxLines?: number | undefined;
+    offset?: number | undefined;
+    grep?: string | undefined;
+}, {
+    pod: string;
+    target: "pod";
+    path: string;
+    namespace: string;
+    timeoutMs?: number | undefined;
+    container?: string | undefined;
+    mode?: "head" | "tail" | undefined;
+    lines?: number | undefined;
+    maxLines?: number | undefined;
+    offset?: number | undefined;
+    grep?: string | undefined;
+}>, z.ZodObject<{
+    contextKey: z.ZodString;
+    target: z.ZodLiteral<"context">;
+} & {
+    mode: z.ZodOptional<z.ZodEnum<["head", "tail"]>>;
+    lines: z.ZodOptional<z.ZodNumber>;
+    maxLines: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    grep: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    path: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    contextKey: string;
+    target: "context";
+    path: string;
+    timeoutMs?: number | undefined;
+    mode?: "head" | "tail" | undefined;
+    lines?: number | undefined;
+    maxLines?: number | undefined;
+    offset?: number | undefined;
+    grep?: string | undefined;
+}, {
+    contextKey: string;
+    target: "context";
+    path: string;
+    timeoutMs?: number | undefined;
+    mode?: "head" | "tail" | undefined;
+    lines?: number | undefined;
+    maxLines?: number | undefined;
+    offset?: number | undefined;
+    grep?: string | undefined;
+}>]>;
+export declare function buildRemotePsSchema(opts?: RemoteSchemaOpts): z.ZodDiscriminatedUnion<"target", [z.ZodObject<{
+    target: z.ZodLiteral<"landing">;
+} & {
+    pattern: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    target: "landing";
+    timeoutMs?: number | undefined;
+    pattern?: string | undefined;
+}, {
+    target: "landing";
+    timeoutMs?: number | undefined;
+    pattern?: string | undefined;
+}>, z.ZodObject<{
+    namespace: z.ZodString;
+    pod: z.ZodString;
+    container: z.ZodOptional<z.ZodString>;
+    target: z.ZodLiteral<"pod">;
+} & {
+    pattern: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    pod: string;
+    target: "pod";
+    namespace: string;
+    timeoutMs?: number | undefined;
+    container?: string | undefined;
+    pattern?: string | undefined;
+}, {
+    pod: string;
+    target: "pod";
+    namespace: string;
+    timeoutMs?: number | undefined;
+    container?: string | undefined;
+    pattern?: string | undefined;
+}>]> | z.ZodDiscriminatedUnion<"target", [z.ZodObject<{
+    target: z.ZodLiteral<"landing">;
+} & {
+    pattern: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    target: "landing";
+    timeoutMs?: number | undefined;
+    pattern?: string | undefined;
+}, {
+    target: "landing";
+    timeoutMs?: number | undefined;
+    pattern?: string | undefined;
+}>, z.ZodObject<{
+    namespace: z.ZodString;
+    pod: z.ZodString;
+    container: z.ZodOptional<z.ZodString>;
+    target: z.ZodLiteral<"pod">;
+} & {
+    pattern: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    pod: string;
+    target: "pod";
+    namespace: string;
+    timeoutMs?: number | undefined;
+    container?: string | undefined;
+    pattern?: string | undefined;
+}, {
+    pod: string;
+    target: "pod";
+    namespace: string;
+    timeoutMs?: number | undefined;
+    container?: string | undefined;
+    pattern?: string | undefined;
+}>, z.ZodObject<{
+    contextKey: z.ZodString;
+    target: z.ZodLiteral<"context">;
+} & {
+    pattern: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    contextKey: string;
+    target: "context";
+    timeoutMs?: number | undefined;
+    pattern?: string | undefined;
+}, {
+    contextKey: string;
+    target: "context";
+    timeoutMs?: number | undefined;
+    pattern?: string | undefined;
+}>]>;
+/** Default schemas (ACCESS_KIND=ssh — context allowed). */
+export declare const remoteReadFileSchema: z.ZodDiscriminatedUnion<"target", [z.ZodObject<{
+    target: z.ZodLiteral<"landing">;
+} & {
+    mode: z.ZodOptional<z.ZodEnum<["head", "tail"]>>;
+    lines: z.ZodOptional<z.ZodNumber>;
+    maxLines: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    grep: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    path: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    target: "landing";
+    path: string;
+    timeoutMs?: number | undefined;
+    mode?: "head" | "tail" | undefined;
+    lines?: number | undefined;
+    maxLines?: number | undefined;
+    offset?: number | undefined;
+    grep?: string | undefined;
+}, {
+    target: "landing";
+    path: string;
+    timeoutMs?: number | undefined;
+    mode?: "head" | "tail" | undefined;
+    lines?: number | undefined;
+    maxLines?: number | undefined;
+    offset?: number | undefined;
+    grep?: string | undefined;
+}>, z.ZodObject<{
+    namespace: z.ZodString;
+    pod: z.ZodString;
+    container: z.ZodOptional<z.ZodString>;
+    target: z.ZodLiteral<"pod">;
+} & {
+    mode: z.ZodOptional<z.ZodEnum<["head", "tail"]>>;
+    lines: z.ZodOptional<z.ZodNumber>;
+    maxLines: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    grep: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    path: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    pod: string;
+    target: "pod";
+    path: string;
+    namespace: string;
+    timeoutMs?: number | undefined;
+    container?: string | undefined;
+    mode?: "head" | "tail" | undefined;
+    lines?: number | undefined;
+    maxLines?: number | undefined;
+    offset?: number | undefined;
+    grep?: string | undefined;
+}, {
+    pod: string;
+    target: "pod";
+    path: string;
+    namespace: string;
+    timeoutMs?: number | undefined;
+    container?: string | undefined;
+    mode?: "head" | "tail" | undefined;
+    lines?: number | undefined;
+    maxLines?: number | undefined;
+    offset?: number | undefined;
+    grep?: string | undefined;
+}>]> | z.ZodDiscriminatedUnion<"target", [z.ZodObject<{
+    target: z.ZodLiteral<"landing">;
+} & {
+    mode: z.ZodOptional<z.ZodEnum<["head", "tail"]>>;
+    lines: z.ZodOptional<z.ZodNumber>;
+    maxLines: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    grep: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    path: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    target: "landing";
+    path: string;
+    timeoutMs?: number | undefined;
+    mode?: "head" | "tail" | undefined;
+    lines?: number | undefined;
+    maxLines?: number | undefined;
+    offset?: number | undefined;
+    grep?: string | undefined;
+}, {
+    target: "landing";
+    path: string;
+    timeoutMs?: number | undefined;
+    mode?: "head" | "tail" | undefined;
+    lines?: number | undefined;
+    maxLines?: number | undefined;
+    offset?: number | undefined;
+    grep?: string | undefined;
+}>, z.ZodObject<{
+    namespace: z.ZodString;
+    pod: z.ZodString;
+    container: z.ZodOptional<z.ZodString>;
+    target: z.ZodLiteral<"pod">;
+} & {
+    mode: z.ZodOptional<z.ZodEnum<["head", "tail"]>>;
+    lines: z.ZodOptional<z.ZodNumber>;
+    maxLines: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    grep: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    path: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    pod: string;
+    target: "pod";
+    path: string;
+    namespace: string;
+    timeoutMs?: number | undefined;
+    container?: string | undefined;
+    mode?: "head" | "tail" | undefined;
+    lines?: number | undefined;
+    maxLines?: number | undefined;
+    offset?: number | undefined;
+    grep?: string | undefined;
+}, {
+    pod: string;
+    target: "pod";
+    path: string;
+    namespace: string;
+    timeoutMs?: number | undefined;
+    container?: string | undefined;
+    mode?: "head" | "tail" | undefined;
+    lines?: number | undefined;
+    maxLines?: number | undefined;
+    offset?: number | undefined;
+    grep?: string | undefined;
+}>, z.ZodObject<{
+    contextKey: z.ZodString;
+    target: z.ZodLiteral<"context">;
+} & {
+    mode: z.ZodOptional<z.ZodEnum<["head", "tail"]>>;
+    lines: z.ZodOptional<z.ZodNumber>;
+    maxLines: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    grep: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    path: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    contextKey: string;
+    target: "context";
+    path: string;
+    timeoutMs?: number | undefined;
+    mode?: "head" | "tail" | undefined;
+    lines?: number | undefined;
+    maxLines?: number | undefined;
+    offset?: number | undefined;
+    grep?: string | undefined;
+}, {
+    contextKey: string;
+    target: "context";
+    path: string;
+    timeoutMs?: number | undefined;
+    mode?: "head" | "tail" | undefined;
+    lines?: number | undefined;
+    maxLines?: number | undefined;
+    offset?: number | undefined;
+    grep?: string | undefined;
+}>]>;
+export declare const remotePsSchema: z.ZodDiscriminatedUnion<"target", [z.ZodObject<{
+    target: z.ZodLiteral<"landing">;
+} & {
+    pattern: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    target: "landing";
+    timeoutMs?: number | undefined;
+    pattern?: string | undefined;
+}, {
+    target: "landing";
+    timeoutMs?: number | undefined;
+    pattern?: string | undefined;
+}>, z.ZodObject<{
+    namespace: z.ZodString;
+    pod: z.ZodString;
+    container: z.ZodOptional<z.ZodString>;
+    target: z.ZodLiteral<"pod">;
+} & {
+    pattern: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    pod: string;
+    target: "pod";
+    namespace: string;
+    timeoutMs?: number | undefined;
+    container?: string | undefined;
+    pattern?: string | undefined;
+}, {
+    pod: string;
+    target: "pod";
+    namespace: string;
+    timeoutMs?: number | undefined;
+    container?: string | undefined;
+    pattern?: string | undefined;
+}>]> | z.ZodDiscriminatedUnion<"target", [z.ZodObject<{
+    target: z.ZodLiteral<"landing">;
+} & {
+    pattern: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    target: "landing";
+    timeoutMs?: number | undefined;
+    pattern?: string | undefined;
+}, {
+    target: "landing";
+    timeoutMs?: number | undefined;
+    pattern?: string | undefined;
+}>, z.ZodObject<{
+    namespace: z.ZodString;
+    pod: z.ZodString;
+    container: z.ZodOptional<z.ZodString>;
+    target: z.ZodLiteral<"pod">;
+} & {
+    pattern: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    pod: string;
+    target: "pod";
+    namespace: string;
+    timeoutMs?: number | undefined;
+    container?: string | undefined;
+    pattern?: string | undefined;
+}, {
+    pod: string;
+    target: "pod";
+    namespace: string;
+    timeoutMs?: number | undefined;
+    container?: string | undefined;
+    pattern?: string | undefined;
+}>, z.ZodObject<{
+    contextKey: z.ZodString;
+    target: z.ZodLiteral<"context">;
+} & {
+    pattern: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    contextKey: string;
+    target: "context";
+    timeoutMs?: number | undefined;
+    pattern?: string | undefined;
+}, {
+    contextKey: string;
+    target: "context";
+    timeoutMs?: number | undefined;
+    pattern?: string | undefined;
+}>]>;
+export type RemoteReadFileInput = z.infer<typeof remoteReadFileSchema>;
+export type RemotePsInput = z.infer<typeof remotePsSchema>;
+export type RemotePathInput = RemoteReadFileInput | RemotePsInput;
+/** Map discriminated-union input to internal RemoteTarget. */
+export declare function remoteInputToTarget(args: RemotePathInput): {
+    target: "landing";
+    namespace?: undefined;
+    pod?: undefined;
+    container?: undefined;
+    contextKey?: undefined;
+} | {
+    target: "pod";
+    namespace: string;
+    pod: string;
+    container: string | undefined;
+    contextKey?: undefined;
+} | {
+    target: "context";
+    contextKey: string;
+    namespace?: undefined;
+    pod?: undefined;
+    container?: undefined;
+};
+export type RemoteTarget = ReturnType<typeof remoteInputToTarget>;
+export declare function buildRemoteFileEndpointSchema(opts?: RemoteSchemaOpts): z.ZodDiscriminatedUnion<"target", [z.ZodObject<{
+    path: z.ZodString;
+    target: z.ZodLiteral<"local">;
+}, "strict", z.ZodTypeAny, {
+    target: "local";
+    path: string;
+}, {
+    target: "local";
+    path: string;
+}>, z.ZodObject<{
+    path: z.ZodString;
+    target: z.ZodLiteral<"landing">;
+}, "strict", z.ZodTypeAny, {
+    target: "landing";
+    path: string;
+}, {
+    target: "landing";
+    path: string;
+}>, z.ZodObject<{
+    path: z.ZodString;
+    namespace: z.ZodString;
+    pod: z.ZodString;
+    container: z.ZodOptional<z.ZodString>;
+    target: z.ZodLiteral<"pod">;
+}, "strict", z.ZodTypeAny, {
+    pod: string;
+    target: "pod";
+    path: string;
+    namespace: string;
+    container?: string | undefined;
+}, {
+    pod: string;
+    target: "pod";
+    path: string;
+    namespace: string;
+    container?: string | undefined;
+}>]> | z.ZodDiscriminatedUnion<"target", [z.ZodObject<{
+    path: z.ZodString;
+    target: z.ZodLiteral<"local">;
+}, "strict", z.ZodTypeAny, {
+    target: "local";
+    path: string;
+}, {
+    target: "local";
+    path: string;
+}>, z.ZodObject<{
+    path: z.ZodString;
+    target: z.ZodLiteral<"landing">;
+}, "strict", z.ZodTypeAny, {
+    target: "landing";
+    path: string;
+}, {
+    target: "landing";
+    path: string;
+}>, z.ZodObject<{
+    path: z.ZodString;
+    namespace: z.ZodString;
+    pod: z.ZodString;
+    container: z.ZodOptional<z.ZodString>;
+    target: z.ZodLiteral<"pod">;
+}, "strict", z.ZodTypeAny, {
+    pod: string;
+    target: "pod";
+    path: string;
+    namespace: string;
+    container?: string | undefined;
+}, {
+    pod: string;
+    target: "pod";
+    path: string;
+    namespace: string;
+    container?: string | undefined;
+}>, z.ZodObject<{
+    path: z.ZodString;
+    contextKey: z.ZodString;
+    target: z.ZodLiteral<"context">;
+}, "strict", z.ZodTypeAny, {
+    contextKey: string;
+    target: "context";
+    path: string;
+}, {
+    contextKey: string;
+    target: "context";
+    path: string;
+}>]>;
+export declare const remoteFileEndpointSchema: z.ZodDiscriminatedUnion<"target", [z.ZodObject<{
+    path: z.ZodString;
+    target: z.ZodLiteral<"local">;
+}, "strict", z.ZodTypeAny, {
+    target: "local";
+    path: string;
+}, {
+    target: "local";
+    path: string;
+}>, z.ZodObject<{
+    path: z.ZodString;
+    target: z.ZodLiteral<"landing">;
+}, "strict", z.ZodTypeAny, {
+    target: "landing";
+    path: string;
+}, {
+    target: "landing";
+    path: string;
+}>, z.ZodObject<{
+    path: z.ZodString;
+    namespace: z.ZodString;
+    pod: z.ZodString;
+    container: z.ZodOptional<z.ZodString>;
+    target: z.ZodLiteral<"pod">;
+}, "strict", z.ZodTypeAny, {
+    pod: string;
+    target: "pod";
+    path: string;
+    namespace: string;
+    container?: string | undefined;
+}, {
+    pod: string;
+    target: "pod";
+    path: string;
+    namespace: string;
+    container?: string | undefined;
+}>]> | z.ZodDiscriminatedUnion<"target", [z.ZodObject<{
+    path: z.ZodString;
+    target: z.ZodLiteral<"local">;
+}, "strict", z.ZodTypeAny, {
+    target: "local";
+    path: string;
+}, {
+    target: "local";
+    path: string;
+}>, z.ZodObject<{
+    path: z.ZodString;
+    target: z.ZodLiteral<"landing">;
+}, "strict", z.ZodTypeAny, {
+    target: "landing";
+    path: string;
+}, {
+    target: "landing";
+    path: string;
+}>, z.ZodObject<{
+    path: z.ZodString;
+    namespace: z.ZodString;
+    pod: z.ZodString;
+    container: z.ZodOptional<z.ZodString>;
+    target: z.ZodLiteral<"pod">;
+}, "strict", z.ZodTypeAny, {
+    pod: string;
+    target: "pod";
+    path: string;
+    namespace: string;
+    container?: string | undefined;
+}, {
+    pod: string;
+    target: "pod";
+    path: string;
+    namespace: string;
+    container?: string | undefined;
+}>, z.ZodObject<{
+    path: z.ZodString;
+    contextKey: z.ZodString;
+    target: z.ZodLiteral<"context">;
+}, "strict", z.ZodTypeAny, {
+    contextKey: string;
+    target: "context";
+    path: string;
+}, {
+    contextKey: string;
+    target: "context";
+    path: string;
+}>]>;
+export type RemoteFileEndpoint = z.infer<typeof remoteFileEndpointSchema>;
+export declare function buildRemoteCopyFileSchema(opts?: RemoteSchemaOpts): z.ZodEffects<z.ZodObject<{
+    source: z.ZodType<any, z.ZodTypeDef, any>;
+    dest: z.ZodType<any, z.ZodTypeDef, any>;
+    recursive: z.ZodOptional<z.ZodBoolean>;
+    /** @deprecated Prefer totalTimeoutMs; mapped to totalTimeoutMs when set. */
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    skipIfComplete: z.ZodOptional<z.ZodBoolean>;
+    progressIntervalMs: z.ZodOptional<z.ZodNumber>;
+    totalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    connectionTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    verify: z.ZodOptional<z.ZodEnum<["none", "size", "size+sha256"]>>;
+}, "strict", z.ZodTypeAny, {
+    timeoutMs?: number | undefined;
+    source?: any;
+    dest?: any;
+    recursive?: boolean | undefined;
+    skipIfComplete?: boolean | undefined;
+    verify?: "none" | "size" | "size+sha256" | undefined;
+    progressIntervalMs?: number | undefined;
+    totalTimeoutMs?: number | undefined;
+    connectionTimeoutMs?: number | undefined;
+}, {
+    timeoutMs?: number | undefined;
+    source?: any;
+    dest?: any;
+    recursive?: boolean | undefined;
+    skipIfComplete?: boolean | undefined;
+    verify?: "none" | "size" | "size+sha256" | undefined;
+    progressIntervalMs?: number | undefined;
+    totalTimeoutMs?: number | undefined;
+    connectionTimeoutMs?: number | undefined;
+}>, {
+    timeoutMs?: number | undefined;
+    source?: any;
+    dest?: any;
+    recursive?: boolean | undefined;
+    skipIfComplete?: boolean | undefined;
+    verify?: "none" | "size" | "size+sha256" | undefined;
+    progressIntervalMs?: number | undefined;
+    totalTimeoutMs?: number | undefined;
+    connectionTimeoutMs?: number | undefined;
+}, {
+    timeoutMs?: number | undefined;
+    source?: any;
+    dest?: any;
+    recursive?: boolean | undefined;
+    skipIfComplete?: boolean | undefined;
+    verify?: "none" | "size" | "size+sha256" | undefined;
+    progressIntervalMs?: number | undefined;
+    totalTimeoutMs?: number | undefined;
+    connectionTimeoutMs?: number | undefined;
+}>;
+export declare const remoteCopyFileSchema: z.ZodEffects<z.ZodObject<{
+    source: z.ZodType<any, z.ZodTypeDef, any>;
+    dest: z.ZodType<any, z.ZodTypeDef, any>;
+    recursive: z.ZodOptional<z.ZodBoolean>;
+    /** @deprecated Prefer totalTimeoutMs; mapped to totalTimeoutMs when set. */
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    skipIfComplete: z.ZodOptional<z.ZodBoolean>;
+    progressIntervalMs: z.ZodOptional<z.ZodNumber>;
+    totalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    connectionTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    verify: z.ZodOptional<z.ZodEnum<["none", "size", "size+sha256"]>>;
+}, "strict", z.ZodTypeAny, {
+    timeoutMs?: number | undefined;
+    source?: any;
+    dest?: any;
+    recursive?: boolean | undefined;
+    skipIfComplete?: boolean | undefined;
+    verify?: "none" | "size" | "size+sha256" | undefined;
+    progressIntervalMs?: number | undefined;
+    totalTimeoutMs?: number | undefined;
+    connectionTimeoutMs?: number | undefined;
+}, {
+    timeoutMs?: number | undefined;
+    source?: any;
+    dest?: any;
+    recursive?: boolean | undefined;
+    skipIfComplete?: boolean | undefined;
+    verify?: "none" | "size" | "size+sha256" | undefined;
+    progressIntervalMs?: number | undefined;
+    totalTimeoutMs?: number | undefined;
+    connectionTimeoutMs?: number | undefined;
+}>, {
+    timeoutMs?: number | undefined;
+    source?: any;
+    dest?: any;
+    recursive?: boolean | undefined;
+    skipIfComplete?: boolean | undefined;
+    verify?: "none" | "size" | "size+sha256" | undefined;
+    progressIntervalMs?: number | undefined;
+    totalTimeoutMs?: number | undefined;
+    connectionTimeoutMs?: number | undefined;
+}, {
+    timeoutMs?: number | undefined;
+    source?: any;
+    dest?: any;
+    recursive?: boolean | undefined;
+    skipIfComplete?: boolean | undefined;
+    verify?: "none" | "size" | "size+sha256" | undefined;
+    progressIntervalMs?: number | undefined;
+    totalTimeoutMs?: number | undefined;
+    connectionTimeoutMs?: number | undefined;
+}>;
+export type RemoteCopyFileInput = z.infer<typeof remoteCopyFileSchema>;
+export declare function fileEndpointToInternal(endpoint: RemoteFileEndpoint): FileEndpoint;
+/** Materialize context endpoints to landing|host for the copy engine. */
+export declare function materializeCopyEndpoint(access: AccessRuntime, endpoint: FileEndpoint): FileEndpoint;
+export type ReadFileMode = "head" | "tail";
+export interface ResolvedReadOptions {
+    mode: ReadFileMode;
+    lines: number;
+    offset?: number;
+    grep?: string;
+}
+/** Normalize remote_read_file args. */
+export declare function resolveReadOptions(args: RemoteReadFileInput): ResolvedReadOptions;