host-execution-mcp 1.0.0 → 2.0.0

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

@@ -1,766 +1,237 @@
 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">;
-} & {
+export declare const linkDescriptionField: z.ZodOptional<z.ZodString>;
+export declare const hopHostField: z.ZodOptional<z.ZodString>;
+/** Cross-field rules stay in handlers — .refine() becomes ZodEffects and MCP listTools yields empty properties. */
+export declare function assertPodPair(args: {
+    namespace?: string;
+    pod?: string;
+}): void;
+export declare function assertCopyEndpoint(endpoint: {
+    target: string;
+    namespace?: string;
+    pod?: string;
+}): void;
+export declare function assertCopySkipVerify(args: {
+    skipIfComplete?: boolean;
+    verify?: string;
+}): void;
+export declare function buildRemoteReadFileSchema(): z.ZodObject<{
     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;
+    namespace: z.ZodOptional<z.ZodString>;
+    pod: z.ZodOptional<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;
+    description: z.ZodOptional<z.ZodString>;
+    host: z.ZodOptional<z.ZodString>;
+    user: z.ZodOptional<z.ZodString>;
+    password: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
-    pod: string;
-    target: "pod";
     path: string;
-    namespace: string;
-    timeoutMs?: number | undefined;
-    container?: string | undefined;
+    password?: string | undefined;
+    description?: 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;
+    host?: string | undefined;
     timeoutMs?: number | undefined;
+    user?: string | 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;
+    pod?: string | undefined;
     lines?: number | undefined;
     maxLines?: number | undefined;
     offset?: number | undefined;
     grep?: string | undefined;
+    namespace?: string | undefined;
 }, {
-    target: "landing";
     path: string;
-    timeoutMs?: number | undefined;
+    password?: string | undefined;
+    description?: string | 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;
+    host?: string | undefined;
     timeoutMs?: number | undefined;
+    user?: string | 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;
+    pod?: string | 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>;
+    namespace?: string | undefined;
+}>;
+export declare function buildRemotePsSchema(): z.ZodObject<{
     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;
+    namespace: z.ZodOptional<z.ZodString>;
+    pod: z.ZodOptional<z.ZodString>;
     container: z.ZodOptional<z.ZodString>;
-    target: z.ZodLiteral<"pod">;
-} & {
+    description: z.ZodOptional<z.ZodString>;
+    host: z.ZodOptional<z.ZodString>;
+    user: z.ZodOptional<z.ZodString>;
+    password: z.ZodOptional<z.ZodString>;
     pattern: z.ZodOptional<z.ZodString>;
-    timeoutMs: z.ZodOptional<z.ZodNumber>;
 }, "strict", z.ZodTypeAny, {
-    pod: string;
-    target: "pod";
-    namespace: string;
+    password?: string | undefined;
+    description?: string | undefined;
+    host?: string | undefined;
     timeoutMs?: number | undefined;
+    user?: string | undefined;
     container?: string | undefined;
+    pod?: string | undefined;
+    namespace?: string | undefined;
     pattern?: string | undefined;
 }, {
-    pod: string;
-    target: "pod";
-    namespace: string;
+    password?: string | undefined;
+    description?: string | undefined;
+    host?: string | undefined;
     timeoutMs?: number | undefined;
+    user?: string | undefined;
     container?: string | undefined;
+    pod?: string | undefined;
+    namespace?: 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">;
-} & {
+}>;
+export declare const remoteReadFileSchema: z.ZodObject<{
     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;
+    namespace: z.ZodOptional<z.ZodString>;
+    pod: z.ZodOptional<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;
+    description: z.ZodOptional<z.ZodString>;
+    host: z.ZodOptional<z.ZodString>;
+    user: z.ZodOptional<z.ZodString>;
+    password: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
-    pod: string;
-    target: "pod";
     path: string;
-    namespace: string;
-    timeoutMs?: number | undefined;
-    container?: string | undefined;
+    password?: string | undefined;
+    description?: 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;
+    host?: string | undefined;
     timeoutMs?: number | undefined;
+    user?: string | 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;
+    pod?: string | undefined;
     lines?: number | undefined;
     maxLines?: number | undefined;
     offset?: number | undefined;
     grep?: string | undefined;
+    namespace?: 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;
+    password?: string | undefined;
+    description?: 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;
+    host?: string | undefined;
     timeoutMs?: number | undefined;
+    user?: string | 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;
+    pod?: string | 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>;
+    namespace?: string | undefined;
+}>;
+export declare const remotePsSchema: z.ZodObject<{
     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;
+    namespace: z.ZodOptional<z.ZodString>;
+    pod: z.ZodOptional<z.ZodString>;
     container: z.ZodOptional<z.ZodString>;
-    target: z.ZodLiteral<"pod">;
-} & {
+    description: z.ZodOptional<z.ZodString>;
+    host: z.ZodOptional<z.ZodString>;
+    user: z.ZodOptional<z.ZodString>;
+    password: z.ZodOptional<z.ZodString>;
     pattern: z.ZodOptional<z.ZodString>;
-    timeoutMs: z.ZodOptional<z.ZodNumber>;
 }, "strict", z.ZodTypeAny, {
-    pod: string;
-    target: "pod";
-    namespace: string;
+    password?: string | undefined;
+    description?: string | undefined;
+    host?: string | undefined;
     timeoutMs?: number | undefined;
+    user?: string | undefined;
     container?: string | undefined;
+    pod?: string | undefined;
+    namespace?: string | undefined;
     pattern?: string | undefined;
 }, {
-    pod: string;
-    target: "pod";
-    namespace: string;
+    password?: string | undefined;
+    description?: string | undefined;
+    host?: string | undefined;
     timeoutMs?: number | undefined;
+    user?: string | undefined;
     container?: string | undefined;
+    pod?: string | undefined;
+    namespace?: 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;
+export type RemoteRunTarget = {
+    mode: "machine";
+    contextKey: string;
 } | {
-    target: "context";
+    mode: "pod";
     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<{
+    container?: string;
+};
+export declare function runTargetFromArgs(contextKey: string, args: {
+    namespace?: string;
+    pod?: string;
+    container?: string;
+}): RemoteRunTarget;
+export declare function buildRemoteFileEndpointSchema(): z.ZodObject<{
+    target: z.ZodEnum<["local", "remote", "pod"]>;
     path: z.ZodString;
-    namespace: z.ZodString;
-    pod: z.ZodString;
+    namespace: z.ZodOptional<z.ZodString>;
+    pod: z.ZodOptional<z.ZodString>;
     container: z.ZodOptional<z.ZodString>;
-    target: z.ZodLiteral<"pod">;
 }, "strict", z.ZodTypeAny, {
-    pod: string;
-    target: "pod";
     path: string;
-    namespace: string;
+    target: "pod" | "local" | "remote";
     container?: string | undefined;
+    pod?: string | undefined;
+    namespace?: string | undefined;
 }, {
-    pod: string;
-    target: "pod";
     path: string;
-    namespace: string;
+    target: "pod" | "local" | "remote";
     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<{
+    pod?: string | undefined;
+    namespace?: string | undefined;
+}>;
+export declare const remoteFileEndpointSchema: z.ZodObject<{
+    target: z.ZodEnum<["local", "remote", "pod"]>;
     path: z.ZodString;
-    namespace: z.ZodString;
-    pod: z.ZodString;
+    namespace: z.ZodOptional<z.ZodString>;
+    pod: z.ZodOptional<z.ZodString>;
     container: z.ZodOptional<z.ZodString>;
-    target: z.ZodLiteral<"pod">;
 }, "strict", z.ZodTypeAny, {
-    pod: string;
-    target: "pod";
     path: string;
-    namespace: string;
+    target: "pod" | "local" | "remote";
     container?: string | undefined;
+    pod?: string | undefined;
+    namespace?: string | undefined;
 }, {
-    pod: string;
-    target: "pod";
     path: string;
-    namespace: string;
+    target: "pod" | "local" | "remote";
     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;
-}>]>;
+    pod?: string | undefined;
+    namespace?: string | undefined;
+}>;
 export type RemoteFileEndpoint = z.infer<typeof remoteFileEndpointSchema>;
-export declare function buildRemoteCopyFileSchema(opts?: RemoteSchemaOpts): z.ZodEffects<z.ZodObject<{
+export declare function buildRemoteCopyFileSchema(): z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    host: z.ZodOptional<z.ZodString>;
+    user: z.ZodOptional<z.ZodString>;
+    password: z.ZodOptional<z.ZodString>;
     source: z.ZodType<any, z.ZodTypeDef, any>;
     dest: z.ZodType<any, z.ZodTypeDef, any>;
     recursive: z.ZodOptional<z.ZodBoolean>;
@@ -772,7 +243,11 @@ export declare function buildRemoteCopyFileSchema(opts?: RemoteSchemaOpts): z.Zo
     connectionTimeoutMs: z.ZodOptional<z.ZodNumber>;
     verify: z.ZodOptional<z.ZodEnum<["none", "size", "size+sha256"]>>;
 }, "strict", z.ZodTypeAny, {
+    password?: string | undefined;
+    description?: string | undefined;
+    host?: string | undefined;
     timeoutMs?: number | undefined;
+    user?: string | undefined;
     source?: any;
     dest?: any;
     recursive?: boolean | undefined;
@@ -782,27 +257,11 @@ export declare function buildRemoteCopyFileSchema(opts?: RemoteSchemaOpts): z.Zo
     totalTimeoutMs?: number | undefined;
     connectionTimeoutMs?: number | undefined;
 }, {
+    password?: string | undefined;
+    description?: string | undefined;
+    host?: string | 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;
+    user?: string | undefined;
     source?: any;
     dest?: any;
     recursive?: boolean | undefined;
@@ -812,7 +271,11 @@ export declare function buildRemoteCopyFileSchema(opts?: RemoteSchemaOpts): z.Zo
     totalTimeoutMs?: number | undefined;
     connectionTimeoutMs?: number | undefined;
 }>;
-export declare const remoteCopyFileSchema: z.ZodEffects<z.ZodObject<{
+export declare const remoteCopyFileSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    host: z.ZodOptional<z.ZodString>;
+    user: z.ZodOptional<z.ZodString>;
+    password: z.ZodOptional<z.ZodString>;
     source: z.ZodType<any, z.ZodTypeDef, any>;
     dest: z.ZodType<any, z.ZodTypeDef, any>;
     recursive: z.ZodOptional<z.ZodBoolean>;
@@ -824,7 +287,11 @@ export declare const remoteCopyFileSchema: z.ZodEffects<z.ZodObject<{
     connectionTimeoutMs: z.ZodOptional<z.ZodNumber>;
     verify: z.ZodOptional<z.ZodEnum<["none", "size", "size+sha256"]>>;
 }, "strict", z.ZodTypeAny, {
+    password?: string | undefined;
+    description?: string | undefined;
+    host?: string | undefined;
     timeoutMs?: number | undefined;
+    user?: string | undefined;
     source?: any;
     dest?: any;
     recursive?: boolean | undefined;
@@ -834,27 +301,11 @@ export declare const remoteCopyFileSchema: z.ZodEffects<z.ZodObject<{
     totalTimeoutMs?: number | undefined;
     connectionTimeoutMs?: number | undefined;
 }, {
+    password?: string | undefined;
+    description?: string | undefined;
+    host?: string | 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;
+    user?: string | undefined;
     source?: any;
     dest?: any;
     recursive?: boolean | undefined;
@@ -865,9 +316,7 @@ export declare const remoteCopyFileSchema: z.ZodEffects<z.ZodObject<{
     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 declare function materializeAgentCopyEndpoint(access: AccessRuntime, contextKey: string, endpoint: RemoteFileEndpoint): FileEndpoint;
 export type ReadFileMode = "head" | "tail";
 export interface ResolvedReadOptions {
     mode: ReadFileMode;
@@ -875,5 +324,4 @@ export interface ResolvedReadOptions {
     offset?: number;
     grep?: string;
 }
-/** Normalize remote_read_file args. */
 export declare function resolveReadOptions(args: RemoteReadFileInput): ResolvedReadOptions;