@intentic/sandbox-contract 1.247.0 → 1.249.0

package/dist/events/cards.js

@@ -0,0 +1,179 @@
+import { z } from "zod";
+import { AgentProviderSchema } from "../schemas/agent.js";
+import { CredentialGateKindSchema, CredentialGateScopeSchema, CredentialLaneSchema } from "../schemas/secrets.js";
+export const AskOptionSchema = z.object({
+    label: z.string().describe("The choice, in a few words."),
+    description: z.string().describe("What picking it means."),
+    preview: z.string().optional().describe("Something to look at while deciding: a mock-up, a snippet, a layout."),
+});
+export const AskQuestionSchema = z.object({
+    question: z.string().describe("What the agent is asking."),
+    header: z.string().describe("A short label for the question."),
+    multiSelect: z.boolean().describe("Whether more than one answer can be picked."),
+    options: z.array(AskOptionSchema).describe("The choices offered. A free-text answer is always possible as well."),
+});
+export const ProgramAskSchema = z.object({
+    text: z.string().describe("What would run."),
+    language: z.enum(["bash", "javascript"]).describe("Which of the two backends it is written for, named as the grammar that colours it."),
+    truncated: z
+        .boolean()
+        .describe("Whether this is an excerpt of a longer program, so the card can say so instead of ending mid-word. An excerpt always carries the flagged fragment: the beginning, then a window around the fragment, with any skipped middle written into the text as a bracketed count."),
+    spans: z
+        .array(z.object({ start: z.number().int().nonnegative(), end: z.number().int().nonnegative() }))
+        .describe("Which fragments of the text the pattern match fired on: every matched class's, or, under the hard rule, only the class the title names. Offsets into text, in order, never overlapping."),
+});
+export const PermissionAskSchema = z.object({
+    toolName: z.string().describe("Which tool it wants to use."),
+    title: z.string().optional().describe("The whole question, as a sentence, exactly as the runtime words it."),
+    displayName: z.string().optional().describe("A short phrase for the button, such as read file."),
+    description: z.string().optional().describe("More about what it is asking for."),
+    reason: z.string().optional().describe("Why it is asking at all: a rule, the current mode, something that looked risky."),
+    path: z.string().optional().describe("Which file it concerns, when it concerns one."),
+    alwaysLabel: z
+        .string()
+        .optional()
+        .describe("The wording for an always-allow answer. Present only when there is something an always could actually remember; without it the only answers are once and no."),
+    program: ProgramAskSchema.optional().describe("The program this card is holding, when the card is about one. Present on a command gate's card and absent on every other permission ask."),
+    explain: z
+        .string()
+        .optional()
+        .describe("One plain sentence saying what the program does and why it is being asked about, where the title says something else. Written by the judge that read your safety policy, never by the agent being gated."),
+});
+export const CapabilityOfferSchema = z.object({
+    card: z.string().describe("Which connection is being asked for."),
+    name: z.string().describe("What it is called, as the catalogue titles it rather than as the agent named it."),
+    why: z.string().optional().describe("The agent's case for connecting it, and the only words on this card that are the agent's."),
+});
+export const PaymentOfferSchema = z.object({
+    url: z.string().describe("What is being paid for."),
+    description: z.string().optional().describe("What the endpoint says it is."),
+    payTo: z.string().describe("Where the money goes, taken verbatim from the endpoint's own demand."),
+    network: z.string().describe("On which network."),
+    asset: z.string().describe("In which token."),
+    assetName: z.string().describe("That token's name. It is pegged to the dollar, which is what lets every amount here read as dollars."),
+    amountUsd: z.string().describe("The exact price. Not a ceiling: this scheme has no ranges, so this is the whole spend."),
+    spentTodayUsd: z.string().describe("What has already gone out today."),
+    dailyCapUsd: z.string().describe("What may go out in a day."),
+    why: z.string().optional().describe("The agent's case for paying, and the only words on this card that are the agent's."),
+});
+export const CredentialOfferSchema = z.object({
+    subject: z.string().describe("Which credential is being asked for."),
+    kind: CredentialGateKindSchema,
+    lane: CredentialLaneSchema,
+    detail: z
+        .string()
+        .optional()
+        .describe("Where it would go: the start of the command, the site, or what is being mounted. Never a value: the command still reads as a reference at this point."),
+    why: z.string().optional().describe("The agent's case for using it, and the only words on this card that are the agent's."),
+    approvers: z.array(z.string()).describe("Who may release it. A click from anyone else is refused and leaves the card standing."),
+    scope: CredentialGateScopeSchema,
+});
+export const AgentCommandSchema = z.object({
+    name: z.string().describe("What to type, without the leading slash."),
+    description: z.string().describe("What it does."),
+    hint: z.string().optional().describe("What its argument should look like, shown after the name."),
+});
+export const AgentCommandsQuerySchema = z.object({
+    agent: AgentProviderSchema.optional().describe("Whose commands to read. Leave it out for Claude."),
+});
+export const AgentCommandsSchema = z.object({
+    commands: z.array(AgentCommandSchema).describe("The shortcut commands, as the provider last published them."),
+});
+export const TodoItemSchema = z.object({
+    content: z.string().describe("The item, as the agent wrote it."),
+    status: z.enum(["pending", "in_progress", "completed"]).describe("Where it is."),
+    activeForm: z
+        .string()
+        .optional()
+        .describe("How to phrase it while it is happening, so a screen can say what the agent is doing rather than what it plans to do."),
+});
+export const ContextUsageSchema = z.object({
+    tokens: z.number().describe("How much the latest request sent, all told."),
+    contextWindow: z.number().describe("How much the model can hold. The gap between these two is how close the conversation is to being compacted."),
+});
+export const ToolKindSchema = z.enum(["read", "edit", "delete", "move", "search", "execute", "think", "fetch", "other"]);
+export const ToolCallStatusSchema = z.enum(["pending", "in_progress", "completed", "failed"]);
+export const ToolCallLocationSchema = z.object({
+    path: z.string().describe("The file, as a workspace path, whatever directory the tool was run from."),
+    line: z.number().optional().describe("Which line, counting from one."),
+});
+export const ToolCallContentSchema = z.discriminatedUnion("type", [
+    z.object({
+        type: z.literal("text").describe("Plain output."),
+        text: z.string().describe("What the tool said."),
+    }),
+    z.object({
+        type: z.literal("diff").describe("A change to a file."),
+        path: z.string().describe("Which file, as a workspace path."),
+        oldText: z.string().optional().describe("What was there. Absent for a new file, or where the previous contents are not known."),
+        newText: z.string().describe("What is there now."),
+        truncated: z.boolean().optional().describe("One of the two sides was too large to send whole."),
+    }),
+    z.object({
+        type: z.literal("image").describe("A picture the tool produced."),
+        path: z
+            .string()
+            .describe("Where it is, as a workspace path. A path rather than the bytes, because the workspace already serves it, sending it inline would bloat every stored record, and this way the picture stays openable afterwards."),
+    }),
+]);
+export const CardDocumentSchema = z.object({
+    path: z.string().describe("Where it lives, as a workspace path."),
+    title: z.string().describe("What it is called: its opening heading, or its file name."),
+    markdown: z.string().describe("The document itself."),
+    truncated: z.boolean().optional().describe("It was clipped at the wire cap; the file on disk has more."),
+    plan: z.boolean().optional().describe("It is one of the CLI's plan files, written to be approved rather than merely read."),
+});
+const REQUEST_ID = z.string().describe("What to send back when you answer.");
+export const planCard = {
+    requestId: REQUEST_ID,
+    text: z.string().describe("The plan itself."),
+    document: CardDocumentSchema.optional().describe("The write-up this plan refers to, when the plan itself is a pointer to one."),
+};
+export const questionCard = {
+    requestId: REQUEST_ID,
+    questions: z.array(AskQuestionSchema).describe("What it wants to know."),
+    document: CardDocumentSchema.optional().describe("The document this turn wrote and is asking about, so the choice can be read beside it."),
+};
+export const permissionCard = { requestId: REQUEST_ID };
+export const browserHelpCard = {
+    requestId: z.string(),
+    session: z.string(),
+    account: z.string(),
+    message: z.string(),
+};
+export const terminalHelpCard = {
+    requestId: z.string(),
+    session: z.string(),
+    message: z.string(),
+};
+export const capabilityOfferCard = { requestId: z.string(), offer: CapabilityOfferSchema };
+export const paymentOfferCard = { requestId: z.string(), offer: PaymentOfferSchema };
+export const credentialOfferCard = { requestId: z.string(), offer: CredentialOfferSchema };
+export const CapabilityOutcomeSchema = z.object({
+    outcome: z.enum(["connected", "unfinished"]),
+    id: z.string().optional(),
+});
+export const PaymentReceiptSchema = z.object({
+    outcome: z.enum(["paid", "failed"]),
+    amountUsd: z.string(),
+    transaction: z.string().optional(),
+    network: z.string().optional(),
+});
+export const CredentialReceiptSchema = z.object({
+    outcome: z.enum(["released", "refused"]),
+    approvedBy: z.string().optional(),
+});
+export const PlanCardSchema = z.object({
+    kind: z.literal("plan").describe("The agent has written a plan and is waiting for a yes."),
+    ...planCard,
+});
+export const QuestionCardSchema = z.object({
+    kind: z.literal("question").describe("The agent has asked you something and is waiting."),
+    ...questionCard,
+});
+export const PermissionCardSchema = PermissionAskSchema.extend({
+    kind: z.literal("permission").describe("The agent wants to use a tool it needs permission for."),
+    ...permissionCard,
+});
+export const ParkedCardSchema = z.discriminatedUnion("kind", [PlanCardSchema, QuestionCardSchema, PermissionCardSchema]);
+//# sourceMappingURL=cards.js.map

package/dist/events/cards.js.map

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

package/dist/events/resume.d.ts

@@ -0,0 +1,23 @@
+import type { TurnNote } from "./transcript.js";
+export declare const RESUME_NOTES: {
+    readonly auth: "The Claude credential that interrupted this conversation has been renewed, and this turn resumed automatically. The interrupted request is repeated below, where part of it was already completed in this session, continue from that point instead of starting over.";
+    readonly outage: "The model provider was briefly unavailable and interrupted this conversation; this turn resumed automatically. The interrupted request is repeated below, where part of it was already completed in this session, continue from that point instead of starting over.";
+    readonly restart: "The sandbox restarted while this turn was running, which stopped it, and this turn resumed automatically once it came back. The interrupted request is repeated below, where part of it was already completed in this session, continue from that point instead of starting over.";
+    readonly limit: "The model provider's usage allowance ran out while this turn was running, which stopped it, and it has been sent again. The interrupted request is repeated below, where part of it was already completed in this session, continue from that point instead of starting over.";
+    readonly switched: "The model provider's usage allowance ran out while this turn was running, which stopped it, and it has been sent again on a different account, which starts a fresh session. The conversation so far has been carried across above, including the part of the request that was already completed, and the sandbox has measured where the work actually stands (the files changed on this branch, what was verified, what the checklist still holds) in the note headed 'Where the work stands': trust that note over anything recalled, then continue from that point instead of starting over.";
+    readonly carried: "The model provider's usage allowance ran out while this turn was running, which stopped it, and it has been sent again on a different account of the same provider, in this same session: everything you knew is still here. The interrupted request is repeated below, where part of it was already completed in this session, continue from that point instead of starting over.";
+    readonly refused: "The model provider refused the previous attempt at this request outright, because its usage allowance was spent: no part of the request below was read or acted on, and nothing has been done towards it. It has been sent again, and starts from the beginning. Where the sandbox has measured earlier work on this branch, it is in the note headed 'Where the work stands'.";
+    readonly answered: "The sandbox restarted while this conversation was waiting for the user to respond; it is back, and their response follows below: continue from where the session left off.";
+};
+export declare const withResumeNote: (prompt: string, note: string) => string;
+export declare const withoutResumeNote: (prompt: string) => string;
+export type ResumeReason = keyof typeof RESUME_NOTES;
+export type ResumeDisclosure = {
+    readonly kind: "notice";
+    readonly text: string;
+} | {
+    readonly kind: "note";
+    readonly note: TurnNote;
+};
+export declare const resumeDisclosure: (prompt: string) => ResumeDisclosure | undefined;
+//# sourceMappingURL=resume.d.ts.map

package/dist/events/resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../src/events/resume.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAQhD,eAAO,MAAM,YAAY;aACrB,IAAI;aACJ,MAAM;aACN,OAAO;aAEP,KAAK;aACL,QAAQ,EACJ,ikBAAikB;aAErkB,OAAO;aACP,OAAO,EACH,gXAAgX;aAEpX,QAAQ,EACJ,4KAA4K;CAC1K,CAAC;AAGX,eAAO,MAAM,cAAc,WAAY,MAAM,QAAQ,MAAM,KAAG,MAC6C,CAAC;AAI5G,eAAO,MAAM,iBAAiB,WAAY,MAAM,KAAG,MAGlD,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,YAAY,CAAC;AAIrD,MAAM,MAAM,gBAAgB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAgBvI,eAAO,MAAM,gBAAgB,WAAY,MAAM,KAAG,gBAAgB,GAAG,SAGpE,CAAC"}

package/dist/events/resume.js

@@ -0,0 +1,31 @@
+const REPEATED = "The interrupted request is repeated below, where part of it was already completed in this session, continue from that point instead of starting over.";
+export const RESUME_NOTES = {
+    auth: `The Claude credential that interrupted this conversation has been renewed, and this turn resumed automatically. ${REPEATED}`,
+    outage: `The model provider was briefly unavailable and interrupted this conversation; this turn resumed automatically. ${REPEATED}`,
+    restart: `The sandbox restarted while this turn was running, which stopped it, and this turn resumed automatically once it came back. ${REPEATED}`,
+    limit: `The model provider's usage allowance ran out while this turn was running, which stopped it, and it has been sent again. ${REPEATED}`,
+    switched: "The model provider's usage allowance ran out while this turn was running, which stopped it, and it has been sent again on a different account, which starts a fresh session. The conversation so far has been carried across above, including the part of the request that was already completed, and the sandbox has measured where the work actually stands (the files changed on this branch, what was verified, what the checklist still holds) in the note headed 'Where the work stands': trust that note over anything recalled, then continue from that point instead of starting over.",
+    carried: `The model provider's usage allowance ran out while this turn was running, which stopped it, and it has been sent again on a different account of the same provider, in this same session: everything you knew is still here. ${REPEATED}`,
+    refused: "The model provider refused the previous attempt at this request outright, because its usage allowance was spent: no part of the request below was read or acted on, and nothing has been done towards it. It has been sent again, and starts from the beginning. Where the sandbox has measured earlier work on this branch, it is in the note headed 'Where the work stands'.",
+    answered: "The sandbox restarted while this conversation was waiting for the user to respond; it is back, and their response follows below: continue from where the session left off.",
+};
+export const withResumeNote = (prompt, note) => Object.values(RESUME_NOTES).some((known) => prompt.startsWith(known)) ? prompt : `${note}\n\n${prompt}`;
+export const withoutResumeNote = (prompt) => {
+    const note = Object.values(RESUME_NOTES).find((known) => prompt.startsWith(known));
+    return note === undefined ? prompt : prompt.slice(prompt.indexOf("\n\n") + 2);
+};
+const RESUME_DISCLOSURES = {
+    auth: { kind: "notice", text: "Claude sign-in renewed, this turn picked up where it left off." },
+    outage: { kind: "notice", text: "The model provider came back, this turn picked up where it left off." },
+    restart: { kind: "notice", text: "The sandbox came back, this turn picked up where it left off." },
+    limit: { kind: "notice", text: "Sent again after the allowance ran out mid-turn, picking up where it left off." },
+    switched: { kind: "notice", text: "Sent again on the switched account after the allowance ran out mid-turn, in a fresh session." },
+    carried: { kind: "notice", text: "Sent again on the switched account after the allowance ran out mid-turn, carrying the session with it." },
+    refused: { kind: "notice", text: "Sent again after the allowance refused it: nothing had run." },
+    answered: { kind: "note", note: { title: "Picked back up after a sandbox restart", text: RESUME_NOTES.answered } },
+};
+export const resumeDisclosure = (prompt) => {
+    const reason = Object.keys(RESUME_NOTES).find((key) => prompt.startsWith(RESUME_NOTES[key]));
+    return reason === undefined ? undefined : RESUME_DISCLOSURES[reason];
+};
+//# sourceMappingURL=resume.js.map

package/dist/events/resume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.js","sourceRoot":"","sources":["../../src/events/resume.ts"],"names":[],"mappings":"AAMA,MAAM,QAAQ,GACV,uJAAuJ,CAAC;AAC5J,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,IAAI,EAAE,mHAAmH,QAAQ,EAAE;IACnI,MAAM,EAAE,kHAAkH,QAAQ,EAAE;IACpI,OAAO,EAAE,+HAA+H,QAAQ,EAAE;IAElJ,KAAK,EAAE,2HAA2H,QAAQ,EAAE;IAC5I,QAAQ,EACJ,ikBAAikB;IAErkB,OAAO,EAAE,gOAAgO,QAAQ,EAAE;IACnP,OAAO,EACH,gXAAgX;IAEpX,QAAQ,EACJ,4KAA4K;CAC1K,CAAC;AAGX,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAc,EAAE,IAAY,EAAU,EAAE,CACnE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,OAAO,MAAM,EAAE,CAAC;AAI5G,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAc,EAAU,EAAE;IACxD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IACnF,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAClF,CAAC,CAAC;AAQF,MAAM,kBAAkB,GAA2C;IAC/D,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,gEAAgE,EAAE;IAChG,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,sEAAsE,EAAE;IACxG,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,+DAA+D,EAAE;IAElG,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,gFAAgF,EAAE;IACjH,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,8FAA8F,EAAE;IAClI,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,wGAAwG,EAAE;IAC3I,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,6DAA6D,EAAE;IAChG,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,wCAAwC,EAAE,IAAI,EAAE,YAAY,CAAC,QAAQ,EAAE,EAAE;CACrH,CAAC;AAIF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAc,EAAgC,EAAE;IAC7E,MAAM,MAAM,GAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAoB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACjH,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACzE,CAAC,CAAC"}