@pome-sh/cli 0.2.0 → 0.4.0

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/shared-types/dist/finalize-shapes.d.ts

@@ -0,0 +1,254 @@
+import { z } from "zod";
+export declare const finalizeRequestSchema: z.ZodObject<{
+    stop_reason: z.ZodString;
+    exit_code: z.ZodNumber;
+    duration_ms: z.ZodNumber;
+    agent_model: z.ZodString;
+    agent_sdk: z.ZodNullable<z.ZodString>;
+    criteria: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        text: z.ZodString;
+        kind: z.ZodPipe<z.ZodEnum<{
+            model: "model";
+            code: "code";
+            D: "D";
+            P: "P";
+        }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+        twin: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    scenario_name: z.ZodString;
+    scenario_hash: z.ZodString;
+    scenario_prompt: z.ZodString;
+    expected_behavior: z.ZodString;
+    trace_storage_key: z.ZodOptional<z.ZodString>;
+    state_initial_storage_key: z.ZodOptional<z.ZodString>;
+    state_final_storage_key: z.ZodOptional<z.ZodString>;
+    signals_storage_key: z.ZodOptional<z.ZodString>;
+    per_twin_state_keys: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        state_initial_key: z.ZodOptional<z.ZodString>;
+        state_final_key: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type FinalizeRequest = z.infer<typeof finalizeRequestSchema>;
+export declare const finalizeResponseSchema: z.ZodObject<{
+    run_id: z.ZodString;
+    score: z.ZodNumber;
+    judge_model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    dashboard_url: z.ZodString;
+    criteria_results: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        criterion: z.ZodObject<{
+            type: z.ZodPipe<z.ZodEnum<{
+                model: "model";
+                code: "code";
+                D: "D";
+                P: "P";
+            }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+            text: z.ZodString;
+            twin: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        passed: z.ZodBoolean;
+        skipped: z.ZodBoolean;
+        reason: z.ZodString;
+        confidence: z.ZodNumber;
+        judge_model: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        criterion: z.ZodObject<{
+            type: z.ZodPipe<z.ZodEnum<{
+                model: "model";
+                code: "code";
+                D: "D";
+                P: "P";
+            }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+            text: z.ZodString;
+            twin: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        passed: z.ZodBoolean;
+        skipped: z.ZodBoolean;
+        reason: z.ZodString;
+    }, z.core.$strip>]>>>;
+}, z.core.$strip>;
+export type FinalizeResponse = z.infer<typeof finalizeResponseSchema>;
+export declare const finalizeStatusUrlSchema: z.ZodString;
+export type FinalizeStatusUrl = z.infer<typeof finalizeStatusUrlSchema>;
+export declare const finalizeAcceptedResponseSchema: z.ZodObject<{
+    evaluation_id: z.ZodString;
+    run_id: z.ZodString;
+    status: z.ZodLiteral<"queued">;
+    status_url: z.ZodString;
+}, z.core.$strict>;
+export type FinalizeAcceptedResponse = z.infer<typeof finalizeAcceptedResponseSchema>;
+export declare const finalizeQueuedStatusResponseSchema: z.ZodObject<{
+    status: z.ZodLiteral<"queued">;
+    evaluation_id: z.ZodString;
+    run_id: z.ZodString;
+}, z.core.$strict>;
+export type FinalizeQueuedStatusResponse = z.infer<typeof finalizeQueuedStatusResponseSchema>;
+export declare const finalizeRunningStatusResponseSchema: z.ZodObject<{
+    status: z.ZodLiteral<"running">;
+    evaluation_id: z.ZodString;
+    run_id: z.ZodString;
+}, z.core.$strict>;
+export type FinalizeRunningStatusResponse = z.infer<typeof finalizeRunningStatusResponseSchema>;
+export declare const finalizeFailureErrorSchema: z.ZodObject<{
+    type: z.ZodString;
+    message: z.ZodString;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export type FinalizeFailureError = z.infer<typeof finalizeFailureErrorSchema>;
+export declare const finalizeFailedStatusResponseSchema: z.ZodObject<{
+    status: z.ZodLiteral<"failed">;
+    error: z.ZodObject<{
+        type: z.ZodString;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>;
+    evaluation_id: z.ZodString;
+    run_id: z.ZodString;
+}, z.core.$strict>;
+export type FinalizeFailedStatusResponse = z.infer<typeof finalizeFailedStatusResponseSchema>;
+export declare const finalizeCompletedStatusResponseSchema: z.ZodObject<{
+    status: z.ZodLiteral<"completed">;
+    result: z.ZodObject<{
+        run_id: z.ZodString;
+        score: z.ZodNumber;
+        judge_model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        dashboard_url: z.ZodString;
+        criteria_results: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            criterion: z.ZodObject<{
+                type: z.ZodPipe<z.ZodEnum<{
+                    model: "model";
+                    code: "code";
+                    D: "D";
+                    P: "P";
+                }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+                text: z.ZodString;
+                twin: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            passed: z.ZodBoolean;
+            skipped: z.ZodBoolean;
+            reason: z.ZodString;
+            confidence: z.ZodNumber;
+            judge_model: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            criterion: z.ZodObject<{
+                type: z.ZodPipe<z.ZodEnum<{
+                    model: "model";
+                    code: "code";
+                    D: "D";
+                    P: "P";
+                }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+                text: z.ZodString;
+                twin: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            passed: z.ZodBoolean;
+            skipped: z.ZodBoolean;
+            reason: z.ZodString;
+        }, z.core.$strip>]>>>;
+    }, z.core.$strip>;
+    evaluation_id: z.ZodString;
+    run_id: z.ZodString;
+}, z.core.$strict>;
+export type FinalizeCompletedStatusResponse = z.infer<typeof finalizeCompletedStatusResponseSchema>;
+export declare const finalizeStatusResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"queued">;
+    evaluation_id: z.ZodString;
+    run_id: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    status: z.ZodLiteral<"running">;
+    evaluation_id: z.ZodString;
+    run_id: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    status: z.ZodLiteral<"failed">;
+    error: z.ZodObject<{
+        type: z.ZodString;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>;
+    evaluation_id: z.ZodString;
+    run_id: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    status: z.ZodLiteral<"completed">;
+    result: z.ZodObject<{
+        run_id: z.ZodString;
+        score: z.ZodNumber;
+        judge_model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        dashboard_url: z.ZodString;
+        criteria_results: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            criterion: z.ZodObject<{
+                type: z.ZodPipe<z.ZodEnum<{
+                    model: "model";
+                    code: "code";
+                    D: "D";
+                    P: "P";
+                }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+                text: z.ZodString;
+                twin: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            passed: z.ZodBoolean;
+            skipped: z.ZodBoolean;
+            reason: z.ZodString;
+            confidence: z.ZodNumber;
+            judge_model: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            criterion: z.ZodObject<{
+                type: z.ZodPipe<z.ZodEnum<{
+                    model: "model";
+                    code: "code";
+                    D: "D";
+                    P: "P";
+                }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+                text: z.ZodString;
+                twin: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            passed: z.ZodBoolean;
+            skipped: z.ZodBoolean;
+            reason: z.ZodString;
+        }, z.core.$strip>]>>>;
+    }, z.core.$strip>;
+    evaluation_id: z.ZodString;
+    run_id: z.ZodString;
+}, z.core.$strict>], "status">;
+export type FinalizeStatusResponse = z.infer<typeof finalizeStatusResponseSchema>;
+export declare const finalizeInitialResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
+    run_id: z.ZodString;
+    score: z.ZodNumber;
+    judge_model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    dashboard_url: z.ZodString;
+    criteria_results: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        criterion: z.ZodObject<{
+            type: z.ZodPipe<z.ZodEnum<{
+                model: "model";
+                code: "code";
+                D: "D";
+                P: "P";
+            }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+            text: z.ZodString;
+            twin: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        passed: z.ZodBoolean;
+        skipped: z.ZodBoolean;
+        reason: z.ZodString;
+        confidence: z.ZodNumber;
+        judge_model: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        criterion: z.ZodObject<{
+            type: z.ZodPipe<z.ZodEnum<{
+                model: "model";
+                code: "code";
+                D: "D";
+                P: "P";
+            }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+            text: z.ZodString;
+            twin: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        passed: z.ZodBoolean;
+        skipped: z.ZodBoolean;
+        reason: z.ZodString;
+    }, z.core.$strip>]>>>;
+}, z.core.$strip>, z.ZodObject<{
+    evaluation_id: z.ZodString;
+    run_id: z.ZodString;
+    status: z.ZodLiteral<"queued">;
+    status_url: z.ZodString;
+}, z.core.$strict>]>;
+export type FinalizeInitialResponse = z.infer<typeof finalizeInitialResponseSchema>;

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/shared-types/dist/finalize-shapes.js

@@ -0,0 +1,122 @@
+// SPDX-License-Identifier: Apache-2.0
+//
+// shared-types — /v1/sessions/:id/finalize response family (part of §4 PUBLIC
+// REST API). ADR-013 managed-judge synchronous result plus the F-700 async
+// `Prefer: respond-async` accepted/status/union shapes. Re-exported through the
+// `@pome-sh/shared-types` barrel (index.ts).
+import { z } from "zod";
+import { criterionResultSchema } from "./run.js";
+import { criterionDefSchema, perTwinStateKeysSchema } from "./rest.js";
+// POST /v1/sessions/:id/finalize — ADR-013 managed-judge REQUEST. This is the
+// LIVE scoring wire: the CLI (cli/src/hosted/client.ts `finalize`) uploads trace
+// / state / signals blobs via the presigned upload-url routes, then POSTs the
+// criterion *definitions* plus the storage KEYS here; the cloud runs the managed
+// judge and returns `finalizeInitialResponseSchema`. (The sibling
+// `submitResultRequestSchema` in rest.ts is the DEPRECATED BYOK shim that scores
+// CLI-side and uploads inline state_*_json_b64.)
+//
+// Not `.strict()`: a tolerant reader that strips unknown additive keys, matching
+// the rest of the §4 request/response family. Field set mirrors the CLI body
+// exactly — `scenario_*` vocab (finalize does not take the W3 `task_*` aliases),
+// storage keys optional (cloud falls back to conventional paths when omitted).
+export const finalizeRequestSchema = z.object({
+    stop_reason: z.string(), // "completed" | "timeout" | "preflight_failed" | …
+    exit_code: z.number().int(),
+    duration_ms: z.number().int(),
+    agent_model: z.string(),
+    agent_sdk: z.string().nullable(), // normalizeAgentSdk() output: trimmed string or null
+    // Criterion DEFINITIONS (not results): cloud judges these against the recorded
+    // trace/state and returns the authoritative score. Carries optional per-criterion
+    // twin attribution (multi-twin M3).
+    criteria: z.array(criterionDefSchema),
+    scenario_name: z.string(),
+    scenario_hash: z.string(),
+    scenario_prompt: z.string(),
+    expected_behavior: z.string(),
+    // Optional storage-key overrides; omitted keys fall back to the conventional
+    // team-<>/session-<>/<filename> paths written by the *-upload-url routes.
+    trace_storage_key: z.string().optional(),
+    state_initial_storage_key: z.string().optional(),
+    state_final_storage_key: z.string().optional(),
+    signals_storage_key: z.string().optional(),
+    // Multi-twin (M3): additive per-twin state storage keys, keyed by twin id.
+    // Absent on single-twin sessions, which use the flat state_*_storage_key fields
+    // above. Unknown to an older cloud, which strips it and scores the primary twin
+    // unchanged (new CLI × old cloud degrades gracefully).
+    per_twin_state_keys: perTwinStateKeysSchema.optional(),
+});
+// /v1/sessions/:id/finalize — ADR-013 managed-judge response.
+// Not `.strict()`: cloud may emit additive M7 keys (`evaluator_version`,
+// `criteria_breakdown`, `all_skipped`, `provenance`) that older/newer CLIs
+// strip rather than reject.
+export const finalizeResponseSchema = z.object({
+    run_id: z.string(),
+    score: z.number().int().min(0).max(100),
+    judge_model: z.string().nullable().optional(),
+    dashboard_url: z.string().url(),
+    criteria_results: z.array(criterionResultSchema).optional(),
+});
+// F-700: `status_url` is a same-origin absolute URL *or* an absolute-path
+// relative URL (cloud returns `/v1/sessions/:id/evaluation`).
+export const finalizeStatusUrlSchema = z
+    .string()
+    .min(1)
+    .refine((value) => {
+    if (value.startsWith("/") && !value.startsWith("//"))
+        return true;
+    try {
+        new URL(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}, { message: "Invalid status_url" });
+// POST /v1/sessions/:id/finalize with `Prefer: respond-async`.
+// The legacy scored response remains in the initial-response union for the
+// synchronous N-1 compatibility window.
+export const finalizeAcceptedResponseSchema = z.object({
+    evaluation_id: z.string().min(1),
+    run_id: z.string().min(1),
+    status: z.literal("queued"),
+    status_url: finalizeStatusUrlSchema,
+}).strict();
+const finalizeStatusIdentitySchema = {
+    evaluation_id: z.string().min(1),
+    run_id: z.string().min(1),
+};
+export const finalizeQueuedStatusResponseSchema = z.object({
+    ...finalizeStatusIdentitySchema,
+    status: z.literal("queued"),
+}).strict();
+export const finalizeRunningStatusResponseSchema = z.object({
+    ...finalizeStatusIdentitySchema,
+    status: z.literal("running"),
+}).strict();
+// F-700 wire error on GET .../evaluation failed status.
+export const finalizeFailureErrorSchema = z.object({
+    type: z.string().min(1),
+    message: z.string().min(1),
+    details: z.record(z.string(), z.unknown()).optional(),
+}).strict();
+export const finalizeFailedStatusResponseSchema = z.object({
+    ...finalizeStatusIdentitySchema,
+    status: z.literal("failed"),
+    error: finalizeFailureErrorSchema,
+}).strict();
+export const finalizeCompletedStatusResponseSchema = z.object({
+    ...finalizeStatusIdentitySchema,
+    status: z.literal("completed"),
+    result: finalizeResponseSchema,
+}).strict();
+export const finalizeStatusResponseSchema = z.discriminatedUnion("status", [
+    finalizeQueuedStatusResponseSchema,
+    finalizeRunningStatusResponseSchema,
+    finalizeFailedStatusResponseSchema,
+    finalizeCompletedStatusResponseSchema,
+]);
+export const finalizeInitialResponseSchema = z.union([
+    finalizeResponseSchema,
+    finalizeAcceptedResponseSchema,
+]);
+//# sourceMappingURL=finalize-shapes.js.map

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/shared-types/dist/finalize-shapes.js.map

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

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/shared-types/dist/github-access-control.d.ts

@@ -0,0 +1,175 @@
+/**
+ * GitHub twin access-control catalog — cross-repo contract between
+ * `packages/twin-github` (runtime) and `pome-cloud` (dashboard toggles).
+ *
+ * Display labels follow the hosted Twins Manage UI: `{METHOD} {operation}`
+ * where `operation` is camelCase (with a few legacy aliases like `addComment`).
+ *
+ * Endpoints are grouped by functional cluster (Issues, Branches & files, …),
+ * aligned with the FDRS-300 hot-path expansion table — not reversible/irreversible.
+ */
+import { z } from "zod";
+export declare const githubAccessControlCategorySchema: z.ZodEnum<{
+    issues: "issues";
+    issue_comments: "issue_comments";
+    pull_requests: "pull_requests";
+    branches_files: "branches_files";
+    commits_diffs: "commits_diffs";
+    milestones: "milestones";
+    status_checks: "status_checks";
+    tags_releases: "tags_releases";
+    labels: "labels";
+    collaborators: "collaborators";
+}>;
+export type GitHubAccessControlCategory = z.infer<typeof githubAccessControlCategorySchema>;
+/** Human-readable section headers for the hosted Manage UI. */
+export declare const GITHUB_ACCESS_CONTROL_CATEGORY_LABELS: Record<GitHubAccessControlCategory, string>;
+/** Stable render order for dashboard sections. */
+export declare const GITHUB_ACCESS_CONTROL_CATEGORY_ORDER: GitHubAccessControlCategory[];
+export declare const githubAccessControlEndpointSchema: z.ZodObject<{
+    tool: z.ZodString;
+    operation: z.ZodString;
+    method: z.ZodEnum<{
+        GET: "GET";
+        POST: "POST";
+        PUT: "PUT";
+        PATCH: "PATCH";
+        DELETE: "DELETE";
+    }>;
+    category: z.ZodEnum<{
+        issues: "issues";
+        issue_comments: "issue_comments";
+        pull_requests: "pull_requests";
+        branches_files: "branches_files";
+        commits_diffs: "commits_diffs";
+        milestones: "milestones";
+        status_checks: "status_checks";
+        tags_releases: "tags_releases";
+        labels: "labels";
+        collaborators: "collaborators";
+    }>;
+    default_allowed: z.ZodBoolean;
+    v2: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type GitHubAccessControlEndpoint = z.infer<typeof githubAccessControlEndpointSchema>;
+export declare const githubAccessControlCategoryGroupSchema: z.ZodObject<{
+    category: z.ZodEnum<{
+        issues: "issues";
+        issue_comments: "issue_comments";
+        pull_requests: "pull_requests";
+        branches_files: "branches_files";
+        commits_diffs: "commits_diffs";
+        milestones: "milestones";
+        status_checks: "status_checks";
+        tags_releases: "tags_releases";
+        labels: "labels";
+        collaborators: "collaborators";
+    }>;
+    label: z.ZodString;
+    endpoints: z.ZodArray<z.ZodObject<{
+        tool: z.ZodString;
+        operation: z.ZodString;
+        method: z.ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PUT: "PUT";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+        }>;
+        category: z.ZodEnum<{
+            issues: "issues";
+            issue_comments: "issue_comments";
+            pull_requests: "pull_requests";
+            branches_files: "branches_files";
+            commits_diffs: "commits_diffs";
+            milestones: "milestones";
+            status_checks: "status_checks";
+            tags_releases: "tags_releases";
+            labels: "labels";
+            collaborators: "collaborators";
+        }>;
+        default_allowed: z.ZodBoolean;
+        v2: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type GitHubAccessControlCategoryGroup = z.infer<typeof githubAccessControlCategoryGroupSchema>;
+export declare const githubAccessControlCatalogSchema: z.ZodObject<{
+    version: z.ZodLiteral<2>;
+    twin: z.ZodLiteral<"github">;
+    endpoints: z.ZodArray<z.ZodObject<{
+        tool: z.ZodString;
+        operation: z.ZodString;
+        method: z.ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PUT: "PUT";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+        }>;
+        category: z.ZodEnum<{
+            issues: "issues";
+            issue_comments: "issue_comments";
+            pull_requests: "pull_requests";
+            branches_files: "branches_files";
+            commits_diffs: "commits_diffs";
+            milestones: "milestones";
+            status_checks: "status_checks";
+            tags_releases: "tags_releases";
+            labels: "labels";
+            collaborators: "collaborators";
+        }>;
+        default_allowed: z.ZodBoolean;
+        v2: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    categories: z.ZodArray<z.ZodObject<{
+        category: z.ZodEnum<{
+            issues: "issues";
+            issue_comments: "issue_comments";
+            pull_requests: "pull_requests";
+            branches_files: "branches_files";
+            commits_diffs: "commits_diffs";
+            milestones: "milestones";
+            status_checks: "status_checks";
+            tags_releases: "tags_releases";
+            labels: "labels";
+            collaborators: "collaborators";
+        }>;
+        label: z.ZodString;
+        endpoints: z.ZodArray<z.ZodObject<{
+            tool: z.ZodString;
+            operation: z.ZodString;
+            method: z.ZodEnum<{
+                GET: "GET";
+                POST: "POST";
+                PUT: "PUT";
+                PATCH: "PATCH";
+                DELETE: "DELETE";
+            }>;
+            category: z.ZodEnum<{
+                issues: "issues";
+                issue_comments: "issue_comments";
+                pull_requests: "pull_requests";
+                branches_files: "branches_files";
+                commits_diffs: "commits_diffs";
+                milestones: "milestones";
+                status_checks: "status_checks";
+                tags_releases: "tags_releases";
+                labels: "labels";
+                collaborators: "collaborators";
+            }>;
+            default_allowed: z.ZodBoolean;
+            v2: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type GitHubAccessControlCatalog = z.infer<typeof githubAccessControlCatalogSchema>;
+export declare function groupGitHubAccessControlByCategory(endpoints?: GitHubAccessControlEndpoint[]): GitHubAccessControlCategoryGroup[];
+/** Canonical 52-endpoint sandbox catalog (25 v1 + 27 v2). */
+export declare const GITHUB_ACCESS_CONTROL_CATALOG: GitHubAccessControlCatalog;
+export declare function formatGitHubAccessControlLabel(endpoint: GitHubAccessControlEndpoint): string;
+export declare function summarizeGitHubAccessControlCatalog(catalog?: GitHubAccessControlCatalog, allowedOverrides?: ReadonlySet<string>): {
+    total: number;
+    allowed: number;
+    denied: number;
+};
+export declare function githubAccessControlToolNames(catalog?: GitHubAccessControlCatalog): string[];