codexgpt 1.0.0

package/dist/tools/schemas/edit.js

@@ -0,0 +1,321 @@
+import { z } from "zod";
+import { createToolMeta, toolMetaSchema } from "./common.js";
+import { transactionResultV2Schema } from "./transactionResult.js";
+export const EDIT_ERROR_MESSAGES = {
+    WORKSPACE_NOT_FOUND: "The requested workspace is not available. Open the workspace before retrying.",
+    PATH_OUTSIDE_WORKSPACE: "The requested path is outside the permitted workspace boundary.",
+    PATH_BLOCKED: "The requested path is blocked by safety rules, including unsafe symlink targets.",
+    FILE_NOT_FOUND: "The requested file does not exist.",
+    NOT_A_FILE: "The requested path is not a regular file.",
+    FILE_NOT_TEXT: "The requested file is not supported as a text file.",
+    FILE_TOO_LARGE: "The requested edit exceeds the configured file-size limit.",
+    INVALID_ARGUMENT: "The requested edit contains an invalid argument.",
+    OLD_TEXT_NOT_FOUND: "The requested old_text was not found in the file.",
+    OLD_TEXT_NOT_UNIQUE: "The requested old_text matched more than once. Use a more specific old_text or enable replace_all.",
+    REPLACEMENT_COUNT_MISMATCH: "The requested replacement count did not match the number of replacements that would be performed.",
+    SECRET_CONTENT_BLOCKED: "Secret-looking content is blocked because the edited file appears to contain a secret value.",
+    EDIT_FAILED: "The file could not be edited by the operating system.",
+    INTERNAL_ERROR: "The file could not be edited because of an internal error."
+};
+export const editDataSchema = z.object({
+    workspace_id: z.string().min(1),
+    root: z.string(),
+    path: z.string().min(1),
+    replacements: z.number().int().positive(),
+    bytes: z.number().int().nonnegative(),
+    sha256: z.string().regex(/^[a-f0-9]{64}$/),
+    additions: z.number().int().nonnegative(),
+    deletions: z.number().int().nonnegative(),
+    diff: z.string()
+}).strict();
+const workspaceDetailsSchema = z.object({
+    workspace_id: z.string().min(1).max(160)
+}).strict();
+const pathDetailsSchema = z.object({
+    path: z.string().min(1).max(240)
+}).strict();
+const fileTooLargeDetailsSchema = z.object({
+    path: z.string().min(1).max(240),
+    scope: z.enum(["existing_file", "edited_file"]),
+    limit_bytes: z.number().int().positive()
+}).strict();
+const invalidArgumentDetailsSchema = z.object({
+    argument: z.literal("old_text")
+}).strict();
+const textNotUniqueDetailsSchema = z.object({
+    path: z.string().min(1).max(240),
+    matches: z.number().int().positive()
+}).strict();
+const replacementCountMismatchDetailsSchema = z.object({
+    path: z.string().min(1).max(240),
+    expected: z.number().int().nonnegative(),
+    actual: z.number().int().positive()
+}).strict();
+const emptyDetailsSchema = z.object({}).strict();
+const workspaceNotFoundErrorSchema = z.object({
+    code: z.literal("WORKSPACE_NOT_FOUND"),
+    message: z.literal(EDIT_ERROR_MESSAGES.WORKSPACE_NOT_FOUND),
+    retryable: z.literal(false),
+    details: workspaceDetailsSchema
+}).strict();
+const pathOutsideWorkspaceErrorSchema = z.object({
+    code: z.literal("PATH_OUTSIDE_WORKSPACE"),
+    message: z.literal(EDIT_ERROR_MESSAGES.PATH_OUTSIDE_WORKSPACE),
+    retryable: z.literal(false),
+    details: pathDetailsSchema
+}).strict();
+const pathBlockedErrorSchema = z.object({
+    code: z.literal("PATH_BLOCKED"),
+    message: z.literal(EDIT_ERROR_MESSAGES.PATH_BLOCKED),
+    retryable: z.literal(false),
+    details: pathDetailsSchema
+}).strict();
+const fileNotFoundErrorSchema = z.object({
+    code: z.literal("FILE_NOT_FOUND"),
+    message: z.literal(EDIT_ERROR_MESSAGES.FILE_NOT_FOUND),
+    retryable: z.literal(false),
+    details: pathDetailsSchema
+}).strict();
+const notAFileErrorSchema = z.object({
+    code: z.literal("NOT_A_FILE"),
+    message: z.literal(EDIT_ERROR_MESSAGES.NOT_A_FILE),
+    retryable: z.literal(false),
+    details: pathDetailsSchema
+}).strict();
+const fileNotTextErrorSchema = z.object({
+    code: z.literal("FILE_NOT_TEXT"),
+    message: z.literal(EDIT_ERROR_MESSAGES.FILE_NOT_TEXT),
+    retryable: z.literal(false),
+    details: pathDetailsSchema
+}).strict();
+const fileTooLargeErrorSchema = z.object({
+    code: z.literal("FILE_TOO_LARGE"),
+    message: z.literal(EDIT_ERROR_MESSAGES.FILE_TOO_LARGE),
+    retryable: z.literal(false),
+    details: fileTooLargeDetailsSchema
+}).strict();
+const invalidArgumentErrorSchema = z.object({
+    code: z.literal("INVALID_ARGUMENT"),
+    message: z.literal(EDIT_ERROR_MESSAGES.INVALID_ARGUMENT),
+    retryable: z.literal(false),
+    details: invalidArgumentDetailsSchema
+}).strict();
+const oldTextNotFoundErrorSchema = z.object({
+    code: z.literal("OLD_TEXT_NOT_FOUND"),
+    message: z.literal(EDIT_ERROR_MESSAGES.OLD_TEXT_NOT_FOUND),
+    retryable: z.literal(false),
+    details: pathDetailsSchema
+}).strict();
+const oldTextNotUniqueErrorSchema = z.object({
+    code: z.literal("OLD_TEXT_NOT_UNIQUE"),
+    message: z.literal(EDIT_ERROR_MESSAGES.OLD_TEXT_NOT_UNIQUE),
+    retryable: z.literal(false),
+    details: textNotUniqueDetailsSchema
+}).strict();
+const replacementCountMismatchErrorSchema = z.object({
+    code: z.literal("REPLACEMENT_COUNT_MISMATCH"),
+    message: z.literal(EDIT_ERROR_MESSAGES.REPLACEMENT_COUNT_MISMATCH),
+    retryable: z.literal(false),
+    details: replacementCountMismatchDetailsSchema
+}).strict();
+const secretContentBlockedErrorSchema = z.object({
+    code: z.literal("SECRET_CONTENT_BLOCKED"),
+    message: z.literal(EDIT_ERROR_MESSAGES.SECRET_CONTENT_BLOCKED),
+    retryable: z.literal(false),
+    details: pathDetailsSchema
+}).strict();
+const editFailedErrorSchema = z.object({
+    code: z.literal("EDIT_FAILED"),
+    message: z.literal(EDIT_ERROR_MESSAGES.EDIT_FAILED),
+    retryable: z.literal(false),
+    details: emptyDetailsSchema
+}).strict();
+const internalErrorSchema = z.object({
+    code: z.literal("INTERNAL_ERROR"),
+    message: z.literal(EDIT_ERROR_MESSAGES.INTERNAL_ERROR),
+    retryable: z.literal(false),
+    details: emptyDetailsSchema
+}).strict();
+export const editErrorSchema = z.discriminatedUnion("code", [
+    workspaceNotFoundErrorSchema,
+    pathOutsideWorkspaceErrorSchema,
+    pathBlockedErrorSchema,
+    fileNotFoundErrorSchema,
+    notAFileErrorSchema,
+    fileNotTextErrorSchema,
+    fileTooLargeErrorSchema,
+    invalidArgumentErrorSchema,
+    oldTextNotFoundErrorSchema,
+    oldTextNotUniqueErrorSchema,
+    replacementCountMismatchErrorSchema,
+    secretContentBlockedErrorSchema,
+    editFailedErrorSchema,
+    internalErrorSchema
+]);
+export const editOutputShape = {
+    codexgpt_tool: z.literal("edit"),
+    codexgpt_title: z.literal("Edit File"),
+    ok: z.boolean(),
+    data: editDataSchema.nullable(),
+    error: editErrorSchema.nullable(),
+    meta: toolMetaSchema
+};
+const editOutputBaseSchema = z.object(editOutputShape).strict();
+export const editOutputSchema = editOutputBaseSchema.superRefine((value, context) => {
+    if (value.ok) {
+        if (value.data === null) {
+            context.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["data"],
+                message: "Successful edit results require data."
+            });
+        }
+        if (value.error !== null) {
+            context.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["error"],
+                message: "Successful edit results require error to be null."
+            });
+        }
+        return;
+    }
+    if (value.data !== null) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["data"],
+            message: "Failed edit results require data to be null."
+        });
+    }
+    if (value.error === null) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["error"],
+            message: "Failed edit results require an error object."
+        });
+    }
+});
+export function createEditSuccess(data, durationMs = 0) {
+    return editOutputSchema.parse({
+        codexgpt_tool: "edit",
+        codexgpt_title: "Edit File",
+        ok: true,
+        data: editDataSchema.parse(data),
+        error: null,
+        meta: createToolMeta(durationMs)
+    });
+}
+export function createEditFailure(failure, durationMs = 0) {
+    return editOutputSchema.parse({
+        codexgpt_tool: "edit",
+        codexgpt_title: "Edit File",
+        ok: false,
+        data: null,
+        error: {
+            code: failure.code,
+            message: EDIT_ERROR_MESSAGES[failure.code],
+            retryable: false,
+            details: failure.details
+        },
+        meta: createToolMeta(durationMs)
+    });
+}
+export const EDIT_TRANSACTION_ERROR_MESSAGES = {
+    FILE_VERSION_CONFLICT: "The target changed since the expected version was read. Read the file again before retrying.",
+    TRANSACTION_BUSY: "Another workspace transaction is active. Retry after it completes.",
+    ATOMIC_BACKEND_UNAVAILABLE: "The filesystem cannot provide the required atomic mutation guarantees.",
+    AUDIT_UNAVAILABLE: "The required persistent audit record could not be completed, so the edit was rolled back.",
+    AUDIT_INTEGRITY_FAILURE: "Persistent audit integrity verification failed.",
+    TRANSACTION_FAILED: "The atomic edit failed and no successful commit was acknowledged.",
+    ROLLBACK_FAILED: "The edit failed and rollback could not be proven complete.",
+    TRANSACTION_RECOVERY_REQUIRED: "The workspace requires transaction recovery before another edit."
+};
+const editTransactionRetryable = {
+    FILE_VERSION_CONFLICT: false,
+    TRANSACTION_BUSY: true,
+    ATOMIC_BACKEND_UNAVAILABLE: false,
+    AUDIT_UNAVAILABLE: true,
+    AUDIT_INTEGRITY_FAILURE: false,
+    TRANSACTION_FAILED: true,
+    ROLLBACK_FAILED: false,
+    TRANSACTION_RECOVERY_REQUIRED: false
+};
+const editTransactionErrorCodeSchema = z.enum([
+    "FILE_VERSION_CONFLICT",
+    "TRANSACTION_BUSY",
+    "ATOMIC_BACKEND_UNAVAILABLE",
+    "AUDIT_UNAVAILABLE",
+    "AUDIT_INTEGRITY_FAILURE",
+    "TRANSACTION_FAILED",
+    "ROLLBACK_FAILED",
+    "TRANSACTION_RECOVERY_REQUIRED"
+]);
+const editTransactionErrorSchema = z.object({
+    code: editTransactionErrorCodeSchema,
+    message: z.string().min(1),
+    retryable: z.boolean(),
+    details: z.union([pathDetailsSchema, emptyDetailsSchema])
+}).strict().superRefine((value, context) => {
+    if (value.message !== EDIT_TRANSACTION_ERROR_MESSAGES[value.code]) {
+        context.addIssue({ code: z.ZodIssueCode.custom, path: ["message"], message: "Unexpected transaction error message." });
+    }
+    if (value.retryable !== editTransactionRetryable[value.code]) {
+        context.addIssue({ code: z.ZodIssueCode.custom, path: ["retryable"], message: "Unexpected transaction retryability." });
+    }
+    const hasPath = Object.prototype.hasOwnProperty.call(value.details, "path");
+    if ((value.code === "FILE_VERSION_CONFLICT") !== hasPath) {
+        context.addIssue({ code: z.ZodIssueCode.custom, path: ["details"], message: "Unexpected transaction error details." });
+    }
+});
+export const editDataSchemaV2 = editDataSchema.extend({
+    transaction: transactionResultV2Schema,
+    before_sha256: z.string().regex(/^[a-f0-9]{64}$/)
+}).strict();
+export const editErrorSchemaV2 = z.union([editErrorSchema, editTransactionErrorSchema]);
+export const editOutputShapeV2 = {
+    codexgpt_tool: z.literal("edit"),
+    codexgpt_title: z.literal("Edit File"),
+    ok: z.boolean(),
+    data: editDataSchemaV2.nullable(),
+    error: editErrorSchemaV2.nullable(),
+    meta: toolMetaSchema
+};
+const editOutputBaseSchemaV2 = z.object(editOutputShapeV2).strict();
+export const editOutputSchemaV2 = editOutputBaseSchemaV2.superRefine((value, context) => {
+    if (value.ok) {
+        if (value.data === null)
+            context.addIssue({ code: z.ZodIssueCode.custom, path: ["data"], message: "Successful edit results require data." });
+        if (value.error !== null)
+            context.addIssue({ code: z.ZodIssueCode.custom, path: ["error"], message: "Successful edit results require error to be null." });
+        return;
+    }
+    if (value.data !== null)
+        context.addIssue({ code: z.ZodIssueCode.custom, path: ["data"], message: "Failed edit results require data to be null." });
+    if (value.error === null)
+        context.addIssue({ code: z.ZodIssueCode.custom, path: ["error"], message: "Failed edit results require an error object." });
+});
+export function createEditSuccessV2(data, durationMs = 0) {
+    return editOutputSchemaV2.parse({
+        codexgpt_tool: "edit",
+        codexgpt_title: "Edit File",
+        ok: true,
+        data: editDataSchemaV2.parse(data),
+        error: null,
+        meta: createToolMeta(durationMs)
+    });
+}
+export function createEditTransactionFailureV2(failure, durationMs = 0) {
+    return editOutputSchemaV2.parse({
+        codexgpt_tool: "edit",
+        codexgpt_title: "Edit File",
+        ok: false,
+        data: null,
+        error: {
+            code: failure.code,
+            message: EDIT_TRANSACTION_ERROR_MESSAGES[failure.code],
+            retryable: editTransactionRetryable[failure.code],
+            details: failure.details
+        },
+        meta: createToolMeta(durationMs)
+    });
+}
+//# sourceMappingURL=edit.js.map

package/dist/tools/schemas/edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.js","sourceRoot":"","sources":["../../../src/tools/schemas/edit.ts"],"names":[],"mappings":"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"}

package/dist/tools/schemas/execution.js

@@ -0,0 +1,330 @@
+import { z } from "zod";
+import path from "node:path";
+import { createToolMeta, toolMetaSchema } from "./common.js";
+const safeOpaqueIdSchema = z.string().min(1).max(160).regex(/^[A-Za-z0-9][A-Za-z0-9._:-]*$/);
+export const processIdV1Schema = z.string().regex(/^process_[a-f0-9]{32}$/);
+export const outputCursorV1Schema = z.string().min(16).max(2048);
+const argumentSchema = z.string().max(8 * 1024);
+const argumentListSchema = z.array(argumentSchema).max(512).superRefine((values, context) => {
+    const total = values.reduce((sum, value) => sum + Buffer.byteLength(value, "utf8"), 0);
+    if (total > 64 * 1024) {
+        context.addIssue({ code: z.ZodIssueCode.custom, message: "Aggregate argument bytes exceed 64 KiB." });
+    }
+});
+const argvCommandSchema = z.object({
+    kind: z.literal("argv"),
+    executable: z.string().min(1).max(32_767).refine((value) => !/[\\/]/.test(value) || path.win32.isAbsolute(value), "Relative executable paths containing separators are not allowed."),
+    args: argumentListSchema.optional()
+}).strict();
+const powershellCommandSchema = z.object({
+    kind: z.literal("powershell"),
+    script: z.string().max(32 * 1024),
+    edition: z.enum(["auto", "core", "windows"]).optional()
+}).strict();
+const bashCommandSchema = z.object({
+    kind: z.literal("bash"),
+    script: z.string().max(32 * 1024)
+}).strict();
+export const commandSpecV1Schema = z.discriminatedUnion("kind", [
+    argvCommandSchema,
+    powershellCommandSchema,
+    bashCommandSchema
+]);
+export const executionCwdV1Schema = z.discriminatedUnion("kind", [
+    z.object({
+        kind: z.literal("workspace"),
+        path: z.string().max(32_767).optional()
+    }).strict(),
+    z.object({
+        kind: z.literal("absolute_local"),
+        path: z.string().min(1).max(32_767)
+    }).strict()
+]);
+const environmentSchema = z.record(z.string().min(1).max(32767), z.string().max(16 * 1024))
+    .superRefine((value, context) => {
+    const keys = Object.keys(value);
+    if (keys.length > 64) {
+        context.addIssue({ code: z.ZodIssueCode.custom, message: "Environment entry limit exceeded." });
+    }
+    const folded = keys.map((key) => key.toLocaleUpperCase("en-US"));
+    if (new Set(folded).size !== folded.length) {
+        context.addIssue({ code: z.ZodIssueCode.custom, message: "Windows environment keys must be unique case-insensitively." });
+    }
+    const total = Object.values(value).reduce((sum, item) => sum + Buffer.byteLength(item, "utf8"), 0);
+    if (total > 16 * 1024) {
+        context.addIssue({ code: z.ZodIssueCode.custom, message: "Aggregate environment value bytes exceed 16 KiB." });
+    }
+});
+const authorityModeSchema = z.enum(["full_access", "workspace"]);
+const executionBaseInputShape = {
+    command: commandSpecV1Schema,
+    cwd: executionCwdV1Schema,
+    environment: environmentSchema.optional(),
+    mode: authorityModeSchema,
+    timeout_ms: z.number().int().min(1).max(10 * 60_000).optional()
+};
+export const runCommandInputV1Schema = z.object(executionBaseInputShape).strict();
+export const candidateVerificationInputV4Schema = z.object({
+    merge_plan_id: z.string().regex(/^merge_[a-f0-9]{32}$/u),
+    integration_workspace_id: z.string().regex(/^ws_[a-f0-9]{32}$/u),
+    category: z.string().regex(/^[a-z][a-z0-9_-]{0,31}$/u)
+}).strict();
+export const runCommandInputV4Schema = z.object({
+    ...executionBaseInputShape,
+    verification: candidateVerificationInputV4Schema.optional()
+}).strict();
+export const startProcessInputV1Schema = z.object({
+    ...executionBaseInputShape,
+    terminal: z.enum(["pipes", "conpty"]).optional(),
+    lifetime_ms: z.number().int().min(1).max(2 * 60 * 60_000).optional()
+}).strict();
+export const startProcessInputV4Schema = z.object({
+    ...executionBaseInputShape,
+    terminal: z.enum(["pipes", "conpty"]).optional(),
+    lifetime_ms: z.number().int().min(1).max(2 * 60 * 60_000).optional(),
+    verification: candidateVerificationInputV4Schema.optional()
+}).strict();
+export const readProcessOutputInputV1Schema = z.object({
+    process_id: processIdV1Schema,
+    cursor: outputCursorV1Schema.optional(),
+    max_bytes: z.number().int().min(1).max(262_144).optional(),
+    wait_ms: z.number().int().min(0).max(30_000).optional()
+}).strict();
+export const writeProcessInputV1Schema = z.object({
+    process_id: processIdV1Schema,
+    data: z.string().max(64 * 1024),
+    close: z.boolean().optional()
+}).strict();
+export const interruptProcessInputV1Schema = z.object({
+    process_id: processIdV1Schema
+}).strict();
+export const terminateProcessInputV1Schema = z.object({
+    process_id: processIdV1Schema
+}).strict();
+export const resizeProcessTerminalInputV1Schema = z.object({
+    process_id: processIdV1Schema,
+    columns: z.number().int().min(1).max(500),
+    rows: z.number().int().min(1).max(500)
+}).strict();
+export const listProcessesInputV1Schema = z.object({}).strict();
+export const backendSummaryV1Schema = z.object({
+    backend_id: safeOpaqueIdSchema,
+    command_kind: z.enum(["argv", "powershell", "bash"]),
+    executable_identity: z.string().regex(/^[a-f0-9]{64}$/),
+    terminal: z.enum(["pipes", "conpty", "none"])
+}).strict();
+const fullAccessAuthoritySummaryV1Schema = z.object({
+    mode: z.literal("full_access"),
+    workspace_boundary_enforced: z.literal(false),
+    filesystem_scope: z.literal("current_user_unrestricted"),
+    filesystem_isolation: z.literal("none"),
+    credential_isolation: z.literal("none"),
+    registry_isolation: z.literal("none"),
+    network_isolation: z.literal("none"),
+    process_tree_control: z.literal("job_object_members_only"),
+    broker_escape_resistance: z.literal("none"),
+    host_writeback: z.literal("possible"),
+    redaction: z.literal("best_effort_known_patterns")
+}).strict();
+const workspaceAuthoritySummaryV1Schema = z.object({
+    mode: z.literal("workspace"),
+    workspace_boundary_enforced: z.literal(true),
+    filesystem_scope: z.literal("filtered_snapshot"),
+    filesystem_isolation: z.literal("snapshot_private"),
+    credential_isolation: z.literal("isolated"),
+    registry_isolation: z.literal("protected_registry"),
+    network_isolation: z.literal("deny_all"),
+    process_tree_control: z.literal("sandbox_job"),
+    broker_escape_resistance: z.literal("sandbox_proved"),
+    host_writeback: z.literal("none"),
+    redaction: z.literal("best_effort_known_patterns")
+}).strict();
+export const authoritySummaryV1Schema = z.discriminatedUnion("mode", [
+    fullAccessAuthoritySummaryV1Schema,
+    workspaceAuthoritySummaryV1Schema
+]);
+export const outputChunkV1Schema = z.object({
+    stream: z.enum(["stdout", "stderr", "terminal"]),
+    text: z.string(),
+    bytes: z.number().int().nonnegative()
+}).strict();
+export const outputPageV1Schema = z.object({
+    chunks: z.array(outputChunkV1Schema).max(4096),
+    next_cursor: outputCursorV1Schema.nullable(),
+    truncated: z.boolean(),
+    eof: z.boolean(),
+    returned_bytes: z.number().int().nonnegative().max(262_144)
+}).strict();
+export const terminationReasonV1Schema = z.enum([
+    "timeout",
+    "user_terminated",
+    "output_limit_exceeded",
+    "policy_revoked",
+    "evidence_revoked",
+    "transport_closed",
+    "lease_revoked",
+    "host_crashed"
+]);
+export const runCommandDataV1Schema = z.object({
+    process_id: processIdV1Schema,
+    status: z.enum(["exited", "failed", "terminated"]),
+    exit_code: z.number().int().nullable(),
+    termination_reason: terminationReasonV1Schema.nullable(),
+    backend: backendSummaryV1Schema,
+    authority: authoritySummaryV1Schema,
+    output: outputPageV1Schema,
+    started_at: z.string().datetime({ offset: true }),
+    ended_at: z.string().datetime({ offset: true })
+}).strict();
+export const runCommandDataV4Schema = runCommandDataV1Schema.extend({
+    verification_receipt: z.string().regex(/^verify_[A-Za-z0-9_-]+$/u).nullable()
+}).strict();
+export const startProcessDataV1Schema = z.object({
+    process_id: processIdV1Schema,
+    status: z.enum(["running", "exited", "failed"]),
+    backend: backendSummaryV1Schema,
+    authority: authoritySummaryV1Schema,
+    started_at: z.string().datetime({ offset: true }),
+    absolute_expires_at: z.string().datetime({ offset: true })
+}).strict();
+const processStateDataV1Schema = z.object({
+    process_id: processIdV1Schema,
+    status: z.enum(["running", "exited", "failed", "terminated"])
+}).strict();
+export const readProcessOutputDataV1Schema = processStateDataV1Schema.extend({
+    output: outputPageV1Schema
+}).strict();
+export const readProcessOutputDataV4Schema = readProcessOutputDataV1Schema.extend({
+    exit_code: z.number().int().nullable(),
+    verification_receipt: z.string().regex(/^verify_[A-Za-z0-9_-]+$/u).nullable()
+}).strict();
+export const listProcessesDataV1Schema = z.object({
+    processes: z.array(z.object({
+        process_id: processIdV1Schema,
+        status: z.enum(["running", "exited", "failed", "terminated"]),
+        mode: authorityModeSchema,
+        terminal: z.enum(["pipes", "conpty", "none"]),
+        started_at: z.string().datetime({ offset: true }),
+        absolute_expires_at: z.string().datetime({ offset: true }).nullable()
+    }).strict()).max(32),
+    process_count: z.number().int().nonnegative().max(32)
+}).strict().superRefine((value, context) => {
+    if (value.process_count !== value.processes.length) {
+        context.addIssue({ code: z.ZodIssueCode.custom, path: ["process_count"], message: "Process count is inconsistent." });
+    }
+});
+export const EXECUTION_ERROR_MESSAGES = Object.freeze({
+    APPROVAL_REQUIRED: "Local approval is required before this action can run.",
+    APPROVAL_QUEUE_FULL: "The local approval queue is full. Retry later.",
+    BACKEND_STALE: "The approved execution backend changed before use.",
+    BACKEND_UNAVAILABLE: "The requested execution backend is unavailable.",
+    EXECUTION_PROFILE_DISABLED: "The requested execution profile is disabled.",
+    EXECUTION_QUOTA_EXCEEDED: "The execution quota is exhausted.",
+    HOST_PROTOCOL_ERROR: "The native execution host rejected the protocol exchange.",
+    HOST_UNAVAILABLE: "The native execution host is unavailable.",
+    INTERRUPT_UNSUPPORTED: "The requested interrupt is unsupported for this process.",
+    NETWORK_ENFORCEMENT_UNAVAILABLE: "The requested network policy cannot be enforced.",
+    OUTPUT_LIMIT_EXCEEDED: "The process exceeded its bounded output allowance.",
+    PROCESS_NOT_FOUND: "The process was not found in this context.",
+    PROCESS_POLICY_UNENFORCEABLE: "The requested process policy cannot be enforced.",
+    PROCESS_SANDBOX_UNAVAILABLE: "The requested process sandbox is unavailable.",
+    SHELL_SANDBOX_UNAVAILABLE: "The requested shell sandbox is unavailable.",
+    TERMINAL_NOT_AVAILABLE: "The requested terminal backend is unavailable.",
+    INTERNAL_ERROR: "The execution action failed because of an internal error."
+});
+const executionErrorCodeSchema = z.enum(Object.keys(EXECUTION_ERROR_MESSAGES));
+export const executionErrorV1Schema = z.object({
+    code: executionErrorCodeSchema,
+    message: z.string().min(1),
+    retryable: z.boolean(),
+    details: z.object({
+        approval_id: safeOpaqueIdSchema.optional(),
+        server_id: safeOpaqueIdSchema.optional(),
+        next_action: z.string().min(1).max(240).optional()
+    }).strict()
+}).strict().superRefine((value, context) => {
+    if (value.message !== EXECUTION_ERROR_MESSAGES[value.code]) {
+        context.addIssue({ code: z.ZodIssueCode.custom, path: ["message"], message: "Execution error message is not canonical." });
+    }
+});
+const EXECUTION_TITLES = Object.freeze({
+    run_command: "Run Command",
+    start_process: "Start Process",
+    read_process_output: "Read Process Output",
+    write_process_input: "Write Process Input",
+    interrupt_process: "Interrupt Process",
+    terminate_process: "Terminate Process",
+    resize_process_terminal: "Resize Process Terminal",
+    list_processes: "List Processes"
+});
+function executionOutputShape(name, data) {
+    return {
+        codexgpt_tool: z.literal(name),
+        codexgpt_title: z.literal(EXECUTION_TITLES[name]),
+        ok: z.boolean(),
+        data: data.nullable(),
+        error: executionErrorV1Schema.nullable(),
+        meta: toolMetaSchema
+    };
+}
+function outputSchema(shape) {
+    return z.object(shape).strict().superRefine((value, context) => {
+        if (value.ok && (value.data === null || value.error !== null)) {
+            context.addIssue({ code: z.ZodIssueCode.custom, message: "Execution success fields are inconsistent." });
+        }
+        if (!value.ok && (value.data !== null || value.error === null)) {
+            context.addIssue({ code: z.ZodIssueCode.custom, message: "Execution failure fields are inconsistent." });
+        }
+    });
+}
+export const runCommandOutputShape = executionOutputShape("run_command", runCommandDataV1Schema);
+export const runCommandOutputShapeV4 = executionOutputShape("run_command", runCommandDataV4Schema);
+export const startProcessOutputShape = executionOutputShape("start_process", startProcessDataV1Schema);
+export const readProcessOutputOutputShape = executionOutputShape("read_process_output", readProcessOutputDataV1Schema);
+export const readProcessOutputOutputShapeV4 = executionOutputShape("read_process_output", readProcessOutputDataV4Schema);
+export const writeProcessInputOutputShape = executionOutputShape("write_process_input", processStateDataV1Schema);
+export const interruptProcessOutputShape = executionOutputShape("interrupt_process", processStateDataV1Schema);
+export const terminateProcessOutputShape = executionOutputShape("terminate_process", processStateDataV1Schema);
+export const resizeProcessTerminalOutputShape = executionOutputShape("resize_process_terminal", processStateDataV1Schema);
+export const listProcessesOutputShape = executionOutputShape("list_processes", listProcessesDataV1Schema);
+export const runCommandOutputSchema = outputSchema(runCommandOutputShape);
+export const runCommandOutputSchemaV4 = outputSchema(runCommandOutputShapeV4);
+export const startProcessOutputSchema = outputSchema(startProcessOutputShape);
+export const readProcessOutputOutputSchema = outputSchema(readProcessOutputOutputShape);
+export const readProcessOutputOutputSchemaV4 = outputSchema(readProcessOutputOutputShapeV4);
+export const writeProcessInputOutputSchema = outputSchema(writeProcessInputOutputShape);
+export const interruptProcessOutputSchema = outputSchema(interruptProcessOutputShape);
+export const terminateProcessOutputSchema = outputSchema(terminateProcessOutputShape);
+export const resizeProcessTerminalOutputSchema = outputSchema(resizeProcessTerminalOutputShape);
+export const listProcessesOutputSchema = outputSchema(listProcessesOutputShape);
+export const EXECUTION_OUTPUT_SCHEMAS = Object.freeze({
+    run_command: runCommandOutputSchema,
+    start_process: startProcessOutputSchema,
+    read_process_output: readProcessOutputOutputSchema,
+    write_process_input: writeProcessInputOutputSchema,
+    interrupt_process: interruptProcessOutputSchema,
+    terminate_process: terminateProcessOutputSchema,
+    resize_process_terminal: resizeProcessTerminalOutputSchema,
+    list_processes: listProcessesOutputSchema
+});
+export const EXECUTION_OUTPUT_SCHEMAS_V4 = Object.freeze({
+    ...EXECUTION_OUTPUT_SCHEMAS,
+    run_command: runCommandOutputSchemaV4,
+    read_process_output: readProcessOutputOutputSchemaV4
+});
+export function createExecutionFailure(toolName, code, details = {}, durationMs = 0) {
+    return EXECUTION_OUTPUT_SCHEMAS[toolName].parse({
+        codexgpt_tool: toolName,
+        codexgpt_title: EXECUTION_TITLES[toolName],
+        ok: false,
+        data: null,
+        error: {
+            code,
+            message: EXECUTION_ERROR_MESSAGES[code],
+            retryable: code === "APPROVAL_QUEUE_FULL" || code === "HOST_UNAVAILABLE",
+            details
+        },
+        meta: createToolMeta(durationMs)
+    });
+}
+//# sourceMappingURL=execution.js.map