@intentic/sandbox-contract 1.232.0 → 1.233.0

package/dist/schemas/personas.js

@@ -0,0 +1,102 @@
+import { z } from "zod";
+import { entryId } from "./internal.js";
+import { SkillDraftSchema, SkillNameSchema, SystemPromptModeSchema } from "./settings.js";
+export const PersonaPowersSchema = z.object({
+    files: z
+        .enum(["none", "read", "write"])
+        .default("write")
+        .describe("What it may do with files: nothing, look and search, or also create and change."),
+    shell: z
+        .boolean()
+        .default(true)
+        .describe("Whether it may run commands, and with them the terminals, the test runs and every tool on the image. The switch the strength of the others depends on."),
+    code: z
+        .boolean()
+        .default(true)
+        .describe("Whether it may write and run a script rather than a command line. Its fence is real where the shell's is not: reads and writes follow the files answer, and it can start no other program unless commands are allowed too. The one stated gap is that the fence cannot cut the network."),
+    web: z.boolean().default(true).describe("Whether it may fetch a page or run a search."),
+    browser: z.boolean().default(true),
+    delegate: z.boolean().default(true),
+    sandbox: z.boolean().default(true),
+    connectors: z.array(entryId).max(100).optional(),
+    computers: z.array(entryId).max(50).optional(),
+    mcp: z.array(entryId).max(50).optional(),
+});
+export const PersonaWorkspaceSchema = z.object({
+    startIn: z.string().max(200).optional().describe("Which folder a conversation opens in."),
+    folders: z.array(z.string().min(1)).max(50).optional().describe("Which folders it may touch at all. Absent means the whole workspace."),
+});
+export const PersonaSchema = z.object({
+    id: entryId.describe("The persona's id."),
+    label: z.string().max(60).optional().describe("What to call it on screen. Absent falls back to the id, which somebody chose anyway."),
+    capabilities: z
+        .array(entryId)
+        .max(50)
+        .describe("Which connected accounts are its hands. Named individually rather than by site, because two accounts on one site is the whole problem this solves. Naming one that is not connected yet is not an error: it is a card describing an account this sandbox has still to sign into."),
+    repos: z
+        .array(z.string().min(1))
+        .max(50)
+        .optional()
+        .describe("Which repositories prefer this persona, so a conversation opened on one starts with the right choice already made. A preference rather than a fence."),
+    powers: PersonaPowersSchema.optional().describe("What a conversation wearing it may do. Absent means the full toolbox, so a card written before this existed behaves exactly as it did."),
+    workspace: PersonaWorkspaceSchema.optional().describe("Where it works. Absent means the whole workspace."),
+    systemPromptMode: SystemPromptModeSchema.optional(),
+});
+export const FRONT_DESK_PERSONA = "front-desk";
+export const personaBounds = (persona) => {
+    const powers = persona.powers;
+    if (powers === undefined) {
+        return "Full powers";
+    }
+    const resolved = PersonaPowersSchema.parse(powers);
+    if (resolved.files === "read" && !resolved.shell) {
+        return "Read-only";
+    }
+    if (!resolved.shell) {
+        return "No shell";
+    }
+    const limits = [
+        resolved.files === "none",
+        !resolved.code,
+        !resolved.web,
+        !resolved.browser,
+        !resolved.delegate,
+        !resolved.sandbox,
+        resolved.connectors !== undefined,
+        resolved.computers !== undefined,
+        resolved.mcp !== undefined,
+    ].filter(Boolean).length;
+    return limits === 0 ? "Full powers" : `${limits} limit${limits === 1 ? "" : "s"}`;
+};
+export const PersonaIdParamSchema = z.object({ id: entryId.describe("Which persona.") });
+export const PersonasListSchema = z.object({
+    personas: z.array(PersonaSchema).describe("The characters an agent can wear."),
+    connected: z
+        .array(z.string())
+        .describe("Which accounts are actually connected right now, so a persona naming one that has since been disconnected can be shown as broken rather than as working."),
+});
+export const PersonaKitSchema = z.object({
+    prompt: z
+        .string()
+        .describe("What this persona is told, on top of everything else. Empty means it simply follows the sandbox's own instructions."),
+    skills: z
+        .array(z.object({
+        name: z.string().describe("The skill's name."),
+        description: z.string().describe("What it is for."),
+    }))
+        .describe("Skills only this persona's conversations can reach. A different question from what the agent knows generally, with a different answer."),
+});
+export const PersonaPromptSchema = PersonaIdParamSchema.extend({
+    prompt: z
+        .string()
+        .max(20000)
+        .describe("What to tell this persona. Sending an empty one removes it entirely rather than storing a blank, so the persona falls back to the sandbox's own instructions."),
+});
+export const PersonaSkillSchema = PersonaIdParamSchema.extend(SkillDraftSchema.shape);
+export const PersonaSkillNameSchema = PersonaIdParamSchema.extend({ name: SkillNameSchema.describe("Which skill.") });
+export const PersonaSkillBodySchema = z.object({
+    name: z.string().describe("The skill's name."),
+    description: z.string().describe("What it is for."),
+    body: z.string().describe("The skill itself, in full."),
+});
+//# sourceMappingURL=personas.js.map

package/dist/schemas/personas.js.map

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

package/dist/schemas/plan-limits.d.ts

@@ -0,0 +1,172 @@
+import { z } from "zod";
+export declare const UsageWindowSchema: z.ZodObject<{
+    kind: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    utilization: z.ZodNumber;
+    resetsAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type UsageWindow = z.infer<typeof UsageWindowSchema>;
+export declare const AccountUsageSchema: z.ZodObject<{
+    windows: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        utilization: z.ZodNumber;
+        resetsAt: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    measuredAt: z.ZodNumber;
+}, z.core.$strip>;
+export type AccountUsage = z.infer<typeof AccountUsageSchema>;
+export declare const ProviderRefusalSchema: z.ZodObject<{
+    at: z.ZodNumber;
+    kind: z.ZodEnum<{
+        auth: "auth";
+        entitlement: "entitlement";
+        limit: "limit";
+    }>;
+    message: z.ZodString;
+    account: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ProviderRefusal = z.infer<typeof ProviderRefusalSchema>;
+export declare const ProviderRefusalsSchema: z.ZodObject<{
+    refusals: z.ZodRecord<z.ZodString, z.ZodObject<{
+        at: z.ZodNumber;
+        kind: z.ZodEnum<{
+            auth: "auth";
+            entitlement: "entitlement";
+            limit: "limit";
+        }>;
+        message: z.ZodString;
+        account: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ProviderRefusals = z.infer<typeof ProviderRefusalsSchema>;
+export declare const TranslatorAccountSchema: z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodString;
+    usage: z.ZodOptional<z.ZodObject<{
+        windows: z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            utilization: z.ZodNumber;
+            resetsAt: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        measuredAt: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type TranslatorAccount = z.infer<typeof TranslatorAccountSchema>;
+export declare const TranslatorAccountsSchema: z.ZodObject<{
+    codex: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodString;
+        usage: z.ZodOptional<z.ZodObject<{
+            windows: z.ZodArray<z.ZodObject<{
+                kind: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+                utilization: z.ZodNumber;
+                resetsAt: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            measuredAt: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    grok: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodString;
+        usage: z.ZodOptional<z.ZodObject<{
+            windows: z.ZodArray<z.ZodObject<{
+                kind: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+                utilization: z.ZodNumber;
+                resetsAt: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            measuredAt: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    kimi: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodString;
+        usage: z.ZodOptional<z.ZodObject<{
+            windows: z.ZodArray<z.ZodObject<{
+                kind: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+                utilization: z.ZodNumber;
+                resetsAt: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            measuredAt: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    gemini: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodString;
+        usage: z.ZodOptional<z.ZodObject<{
+            windows: z.ZodArray<z.ZodObject<{
+                kind: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+                utilization: z.ZodNumber;
+                resetsAt: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            measuredAt: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type TranslatorAccounts = z.infer<typeof TranslatorAccountsSchema>;
+export declare const AgentReplySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"plan">;
+    requestId: z.ZodString;
+    approve: z.ZodBoolean;
+    feedback: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"question">;
+    requestId: z.ZodString;
+    answers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+    cancelled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"permission">;
+    requestId: z.ZodString;
+    decision: z.ZodEnum<{
+        always: "always";
+        deny: "deny";
+        once: "once";
+    }>;
+    feedback: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"browser_help">;
+    requestId: z.ZodString;
+    helped: z.ZodBoolean;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"terminal_help">;
+    requestId: z.ZodString;
+    helped: z.ZodBoolean;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"service_offer">;
+    requestId: z.ZodString;
+    approve: z.ZodBoolean;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"capability_offer">;
+    requestId: z.ZodString;
+    connect: z.ZodBoolean;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"payment_offer">;
+    requestId: z.ZodString;
+    approve: z.ZodBoolean;
+}, z.core.$strip>], "kind">;
+export type AgentReply = z.infer<typeof AgentReplySchema>;
+export declare const SteerSchema: z.ZodObject<{
+    conversationId: z.ZodString;
+    text: z.ZodString;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    editorContext: z.ZodOptional<z.ZodObject<{
+        file: z.ZodString;
+        startLine: z.ZodOptional<z.ZodNumber>;
+        endLine: z.ZodOptional<z.ZodNumber>;
+        selection: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const StopTurnSchema: z.ZodObject<{
+    conversationId: z.ZodString;
+}, z.core.$strip>;
+export declare const ResumeTurnSchema: z.ZodObject<{
+    conversationId: z.ZodString;
+}, z.core.$strip>;
+//# sourceMappingURL=plan-limits.d.ts.map

package/dist/schemas/plan-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-limits.d.ts","sourceRoot":"","sources":["../../src/schemas/plan-limits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,iBAAiB;;;;;iBAK5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAU5D,eAAO,MAAM,kBAAkB;;;;;;;;iBAG7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAmB9D,eAAO,MAAM,qBAAqB;;;;;;;;;iBAmBhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,eAAO,MAAM,sBAAsB;;;;;;;;;;;iBAMjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAGtE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;iBAQlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAKxE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAI1E,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA2G3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAM1D,eAAO,MAAM,WAAW;;;;;;;;;;iBAclB,CAAC;AAGP,eAAO,MAAM,cAAc;;iBAA2G,CAAC;AAcvI,eAAO,MAAM,gBAAgB;;iBAE3B,CAAC"}

package/dist/schemas/plan-limits.js

@@ -0,0 +1,126 @@
+import { z } from "zod";
+import { EditorContextSchema } from "./agent.js";
+export const UsageWindowSchema = z.object({
+    kind: z.string(),
+    label: z.string().optional(),
+    utilization: z.number(),
+    resetsAt: z.number().optional(),
+});
+export const AccountUsageSchema = z.object({
+    windows: z.array(UsageWindowSchema),
+    measuredAt: z.number(),
+});
+export const ProviderRefusalSchema = z.object({
+    at: z.number().describe("When it refused, in milliseconds."),
+    kind: z
+        .enum(["limit", "auth", "entitlement"])
+        .describe("Three different noes, kept apart because what fixes each is different. A spent allowance is answered by waiting; a refused credential by signing in again; and an entitlement refusal, where somebody has switched this off for your seat, by neither of those. That last one authenticates fine and reports healthy limits the whole time it refuses everything."),
+    message: z.string().describe("The provider's own words, verbatim. The only part that says which limit or which credential."),
+    account: z.string().optional().describe("Which account was serving, where that is known."),
+});
+export const ProviderRefusalsSchema = z.object({
+    refusals: z
+        .record(z.string(), ProviderRefusalSchema)
+        .describe("The most recent refusal per provider. Read alongside an account's usage: that says how full it was when last checked, this says whether it has since started saying no."),
+});
+export const TranslatorAccountSchema = z.object({
+    name: z.string(),
+    label: z.string(),
+    usage: AccountUsageSchema.optional(),
+});
+export const TranslatorAccountsSchema = z.object({
+    codex: z.array(TranslatorAccountSchema),
+    grok: z.array(TranslatorAccountSchema),
+    kimi: z.array(TranslatorAccountSchema),
+    gemini: z.array(TranslatorAccountSchema),
+});
+export const AgentReplySchema = z.discriminatedUnion("kind", [
+    z.object({
+        kind: z.literal("plan").describe("Answering a plan the agent proposed."),
+        requestId: z.string().min(1).describe("Which card you are answering, from the frame that raised it."),
+        approve: z
+            .boolean()
+            .describe("Whether to go ahead. Approving means the plan then runs without asking again per tool, because being asked whether a plan you just approved may run its first command is not a question worth having."),
+        feedback: z.string().optional().describe("Why not, which goes back to the model as the reason."),
+    }),
+    z.object({
+        kind: z.literal("question").describe("Answering a question the agent asked."),
+        requestId: z.string().min(1).describe("Which card you are answering."),
+        answers: z
+            .record(z.string(), z.array(z.string()))
+            .optional()
+            .describe("What you chose, keyed by the question, with the chosen labels or your own words."),
+        cancelled: z
+            .boolean()
+            .optional()
+            .describe("Dismissing it instead, which tells the agent to carry on using sensible defaults rather than leaving it waiting."),
+    }),
+    z.object({
+        kind: z.literal("permission").describe("Answering a request to use a tool."),
+        requestId: z.string().min(1).describe("Which card you are answering."),
+        decision: z
+            .enum(["once", "always", "deny"])
+            .describe("Once allows this call alone; always allows that whole tool for the rest of the conversation; no blocks it."),
+        feedback: z.string().optional().describe("Why not, which goes back to the model as the reason."),
+    }),
+    z.object({
+        kind: z
+            .literal("browser_help")
+            .describe("Answering a request for help in the agent's browser: a captcha, a password it does not hold, a check on your phone."),
+        requestId: z.string().min(1).describe("Which card you are answering."),
+        helped: z
+            .boolean()
+            .describe("Whether you cleared it. Yes means the turn carries on from the page as you left it; no tells the agent so, and it moves on rather than waiting for ever."),
+        note: z.string().optional().describe("Anything the agent should know, which goes back to it either way."),
+    }),
+    z.object({
+        kind: z
+            .literal("terminal_help")
+            .describe("Answering a request for help at a terminal: a code to type, a confirmation only a person can give."),
+        requestId: z.string().min(1).describe("Which card you are answering."),
+        helped: z
+            .boolean()
+            .describe("Whether you did it. Yes also hands the agent what the terminal now says, because a person answering a prompt is exactly the moment the agent cannot see."),
+        note: z.string().optional().describe("Anything the agent should know, which goes back to it either way."),
+    }),
+    z.object({
+        kind: z.literal("service_offer").describe("Answering a request to spend on a paid service."),
+        requestId: z.string().min(1).describe("Which card you are answering."),
+        approve: z
+            .boolean()
+            .describe("Yes releases exactly one run. Anything else charges nothing. This click is the only way the spend can happen."),
+    }),
+    z.object({
+        kind: z.literal("capability_offer").describe("Answering a request to connect something the agent needs."),
+        requestId: z.string().min(1).describe("Which card you are answering."),
+        connect: z
+            .boolean()
+            .describe("Yes keeps the agent waiting while you set it up, and it carries on the moment the connection comes alive. No tells it to continue without. The reply itself connects nothing: setting it up is still your own doing."),
+    }),
+    z.object({
+        kind: z.literal("payment_offer").describe("Answering a request to pay for something."),
+        requestId: z.string().min(1).describe("Which card you are answering."),
+        approve: z
+            .boolean()
+            .describe("Yes releases exactly one payment. Anything else spends nothing. This click is the only way the money can move."),
+    }),
+]);
+export const SteerSchema = z
+    .object({
+    conversationId: z.string().min(1).describe("Which running conversation to interrupt."),
+    text: z.string().max(20_000).describe("What to say to it. It arrives mid-turn without stopping the turn."),
+    attachments: z
+        .array(z.string().min(1))
+        .max(20)
+        .optional()
+        .describe("Files to send with it, as workspace paths. A screenshot dropped in mid-turn with no words is a legitimate thing to send."),
+    editorContext: EditorContextSchema.optional().describe("What you have open, folded in so that pointing words resolve."),
+})
+    .refine((steer) => steer.text.trim().length > 0 || (steer.attachments?.length ?? 0) > 0, {
+    message: "text or attachments required",
+});
+export const StopTurnSchema = z.object({ conversationId: z.string().min(1).describe("Which conversation's running turn to cancel.") });
+export const ResumeTurnSchema = z.object({
+    conversationId: z.string().min(1).describe("Which conversation's held turn to run again."),
+});
+//# sourceMappingURL=plan-limits.js.map

package/dist/schemas/plan-limits.js.map

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

package/dist/schemas/ports.d.ts

@@ -0,0 +1,71 @@
+import { z } from "zod";
+export declare const PortSummarySchema: z.ZodObject<{
+    port: z.ZodNumber;
+    host: z.ZodEnum<{
+        "127.0.0.1": "127.0.0.1";
+        "::1": "::1";
+    }>;
+    forwardable: z.ZodBoolean;
+    kind: z.ZodEnum<{
+        system: "system";
+        workspace: "workspace";
+    }>;
+    title: z.ZodString;
+    purpose: z.ZodString;
+    origin: z.ZodEnum<{
+        agent: "agent";
+        container: "container";
+        extension: "extension";
+        panel: "panel";
+        sandbox: "sandbox";
+        terminal: "terminal";
+        unknown: "unknown";
+    }>;
+    pid: z.ZodOptional<z.ZodNumber>;
+    command: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    session: z.ZodOptional<z.ZodString>;
+    forwarded: z.ZodBoolean;
+    previewUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PortSummary = z.infer<typeof PortSummarySchema>;
+export declare const PortsListSchema: z.ZodObject<{
+    ports: z.ZodArray<z.ZodObject<{
+        port: z.ZodNumber;
+        host: z.ZodEnum<{
+            "127.0.0.1": "127.0.0.1";
+            "::1": "::1";
+        }>;
+        forwardable: z.ZodBoolean;
+        kind: z.ZodEnum<{
+            system: "system";
+            workspace: "workspace";
+        }>;
+        title: z.ZodString;
+        purpose: z.ZodString;
+        origin: z.ZodEnum<{
+            agent: "agent";
+            container: "container";
+            extension: "extension";
+            panel: "panel";
+            sandbox: "sandbox";
+            terminal: "terminal";
+            unknown: "unknown";
+        }>;
+        pid: z.ZodOptional<z.ZodNumber>;
+        command: z.ZodOptional<z.ZodString>;
+        cwd: z.ZodOptional<z.ZodString>;
+        session: z.ZodOptional<z.ZodString>;
+        forwarded: z.ZodBoolean;
+        previewUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PortsList = z.infer<typeof PortsListSchema>;
+export declare const PortParamSchema: z.ZodObject<{
+    port: z.ZodNumber;
+}, z.core.$strip>;
+export declare const PortForwardResultSchema: z.ZodObject<{
+    previewUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PortForwardResult = z.infer<typeof PortForwardResultSchema>;
+//# sourceMappingURL=ports.d.ts.map

package/dist/schemas/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../src/schemas/ports.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2D5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAI1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,eAAO,MAAM,eAAe;;iBAAiF,CAAC;AAE9G,eAAO,MAAM,uBAAuB;;iBAKlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/schemas/ports.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+export const PortSummarySchema = z.object({
+    port: z.number().describe("The port number."),
+    host: z
+        .enum(["127.0.0.1", "::1"])
+        .describe("Which loopback address it actually answers on. Some tools bind only one of the two, and anything dialling it has to know which."),
+    forwardable: z
+        .boolean()
+        .describe("Whether it can be exposed at all. Some listeners answer only at their own address and nowhere else; those are listed for honesty and refused for forwarding."),
+    kind: z
+        .enum(["workspace", "system"])
+        .describe("Whether somebody's own work put it there, or the sandbox's own machinery did. Only the first kind is worth previewing."),
+    title: z
+        .string()
+        .describe("What a person would call it. Always present: a listener nothing can explain is still named, because the button beside it publishes the port to the internet."),
+    purpose: z.string().describe("One sentence about what it is for, including when the honest answer is that nothing could work it out."),
+    origin: z
+        .enum(["terminal", "agent", "panel", "extension", "container", "sandbox", "unknown"])
+        .describe("Who put it there, which is the question somebody is really asking: mine, my agent's, or the box's own."),
+    pid: z.number().optional().describe("The process holding it. Absent when nothing could be matched to the socket."),
+    command: z.string().optional().describe("The command behind it, as it was run. Absent only when nothing could be attributed at all."),
+    cwd: z.string().optional().describe("Where it is running from, which is how a port gets attributed to a repository."),
+    session: z
+        .string()
+        .optional()
+        .describe('The terminal it came from, to watch it in or stop it from. Absent when nothing in its ancestry is one, which is the honest "you cannot reach this from here".'),
+    forwarded: z.boolean().describe("Whether it is currently reachable from outside."),
+    previewUrl: z.string().optional().describe("Where to open it. Present only while forwarded, and only on a sandbox that has an outside address."),
+});
+export const PortsListSchema = z.object({
+    ports: z
+        .array(PortSummarySchema)
+        .describe("Everything listening inside the sandbox right now, read fresh each time rather than from a register the sandbox keeps."),
+});
+export const PortParamSchema = z.object({ port: z.number().int().min(1).max(65535).describe("Which port.") });
+export const PortForwardResultSchema = z.object({
+    previewUrl: z
+        .string()
+        .optional()
+        .describe("Where it can now be reached. Absent on a sandbox with no outside address, where the mapping exists but has no public name."),
+});
+//# sourceMappingURL=ports.js.map

package/dist/schemas/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../src/schemas/ports.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAG7C,IAAI,EAAE,CAAC;SACF,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;SAC1B,QAAQ,CAAC,iIAAiI,CAAC;IAIhJ,WAAW,EAAE,CAAC;SACT,OAAO,EAAE;SACT,QAAQ,CACL,8JAA8J,CACjK;IAIL,IAAI,EAAE,CAAC;SACF,IAAI,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;SAC7B,QAAQ,CAAC,wHAAwH,CAAC;IAUvI,KAAK,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,CACL,8JAA8J,CACjK;IACL,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wGAAwG,CAAC;IACtI,MAAM,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;SACpF,QAAQ,CAAC,wGAAwG,CAAC;IAEvH,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6EAA6E,CAAC;IAIlH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4FAA4F,CAAC;IAErI,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;IAIrH,OAAO,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACL,+JAA+J,CAClK;IACL,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IAElF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oGAAoG,CAAC;CACnJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,KAAK,EAAE,CAAC;SACH,KAAK,CAAC,iBAAiB,CAAC;SACxB,QAAQ,CAAC,wHAAwH,CAAC;CAC1I,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;AAE9G,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,UAAU,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4HAA4H,CAAC;CAC9I,CAAC,CAAC"}