@zackbart/connecta 0.34.0 → 0.35.0

package/dist/providers/forms/lib/constants.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The Forms API root. Every path the tools send sits beneath `/forms`; there
+ * is no user segment, because a form is a Drive file the token's subject can
+ * or cannot open.
+ */
+export declare const FORMS_API_BASE_URL = "https://forms.googleapis.com/v1";
+/**
+ * Exactly the scopes this connection requests, and exactly what the Admin
+ * console's domain-wide delegation entry must list (comma-separated there).
+ * `forms.body` reads and edits forms; responses are read-only.
+ */
+export declare const FORMS_SCOPES: readonly ["https://www.googleapis.com/auth/forms.body", "https://www.googleapis.com/auth/forms.responses.readonly"];
+/** A large form with embedded media metadata, or a page of long answers. */
+export declare const FORMS_MAX_RESPONSE_BYTES: number;

package/dist/providers/forms/lib/constants.js

@@ -0,0 +1,19 @@
+// Public Forms constants, kept outside the kit declarations so the published
+// entry names no Effect type.
+/**
+ * The Forms API root. Every path the tools send sits beneath `/forms`; there
+ * is no user segment, because a form is a Drive file the token's subject can
+ * or cannot open.
+ */
+export const FORMS_API_BASE_URL = "https://forms.googleapis.com/v1";
+/**
+ * Exactly the scopes this connection requests, and exactly what the Admin
+ * console's domain-wide delegation entry must list (comma-separated there).
+ * `forms.body` reads and edits forms; responses are read-only.
+ */
+export const FORMS_SCOPES = [
+    "https://www.googleapis.com/auth/forms.body",
+    "https://www.googleapis.com/auth/forms.responses.readonly",
+];
+/** A large form with embedded media metadata, or a page of long answers. */
+export const FORMS_MAX_RESPONSE_BYTES = 8 * 1024 * 1024;

package/dist/providers/forms/lib/hatch.js

@@ -0,0 +1,72 @@
+import { googlePageToken } from "../../../http/hatch-paging.js";
+import { googleBatchGuard, googleHatchBinding } from "../../_shared/google/hatch.js";
+import { OperationIndex } from "../../_shared/rest/operation-index.js";
+import { openapi } from "../openapi.generated.js";
+export const formsIndex = new OperationIndex(openapi, {
+    vendor: "forms",
+    title: "Google Forms",
+    pathMatching: "uri-template",
+});
+export const FORMS_REQUEST_KINDS = [
+    "createItem",
+    "updateItem",
+    "deleteItem",
+    "moveItem",
+    "updateFormInfo",
+    "updateSettings",
+];
+export const FORMS_REFUSALS = {
+    "POST /forms/{formId}:setPublishSettings": "Publishing and response availability changes require separate product authorization; the owner can change them in Forms.",
+    "POST /forms/{formId}/watches": "Watch registration creates persistent Pub/Sub delivery and requires separate product authorization.",
+    "GET /forms/{formId}/watches": "Watch administration is outside this connection; manage watches through the approved operator workflow.",
+    "POST /forms/{formId}/watches/{watchId}:renew": "Watch renewal extends persistent Pub/Sub delivery and requires separate product authorization.",
+    "DELETE /forms/{formId}/watches/{watchId}": "Watch administration is outside this connection; manage watches through the approved operator workflow.",
+};
+export function formsBinding(connection) {
+    return googleHatchBinding(connection, {
+        index: formsIndex,
+        review: "Five reviewed Forms JSON methods, confined below /v1 with delegated subject, shared safety and revision-checked batches; publish settings and watches refused.",
+        refusal: (op) => FORMS_REFUSALS[`${op.method} ${op.path}`],
+        refuse: (call) => {
+            const refusal = FORMS_REFUSALS[`${call.method} ${call.op.path}`];
+            if (refusal)
+                return refusal;
+            const pageSize = call.query["pageSize"];
+            if (call.op.path === "/forms/{formId}/responses" &&
+                pageSize !== undefined &&
+                (typeof pageSize !== "number" || !Number.isInteger(pageSize) || pageSize < 1 || pageSize > 5000))
+                return "Forms query.pageSize must be an integer from 1 to 5000; omit it for the default.";
+            return call.op.path === "/forms/{formId}:batchUpdate"
+                ? googleBatchGuard(call.body, { kinds: FORMS_REQUEST_KINDS, revision: true })
+                : undefined;
+        },
+        revisionGuarded: (call) => call.op.path === "/forms/{formId}:batchUpdate",
+    });
+}
+export const FORMS_HATCH = {
+    name: "forms",
+    title: "Google Forms",
+    index: formsIndex,
+    pathExample: "/forms/form_123",
+    verdicts: {
+        "GET /forms/{formId}": "read",
+        "POST /forms": "write",
+        "POST /forms/{formId}:batchUpdate": "destructive",
+        "GET /forms/{formId}/responses": "read",
+        "GET /forms/{formId}/responses/{responseId}": "read",
+        "POST /forms/{formId}:setPublishSettings": "refuse",
+        "POST /forms/{formId}/watches": "refuse",
+        "GET /forms/{formId}/watches": "refuse",
+        "POST /forms/{formId}/watches/{watchId}:renew": "refuse",
+        "DELETE /forms/{formId}/watches/{watchId}": "refuse",
+    },
+    named: {
+        "GET /forms/{formId}": "get_form",
+        "POST /forms": "create_form",
+        "POST /forms/{formId}:batchUpdate": "batch_update_form",
+        "GET /forms/{formId}/responses": "list_responses",
+        "GET /forms/{formId}/responses/{responseId}": "get_response",
+    },
+    pages: { "GET /forms/{formId}/responses": googlePageToken },
+    pageCursor: "argument",
+};

package/dist/providers/forms/openapi.generated.js

@@ -0,0 +1,23 @@
+import { compactOpenApi } from "../_shared/rest/compact-index.js";
+export const openapi = compactOpenApi({
+    source: "https://forms.googleapis.com/$discovery/rest?version=v1",
+    revision: "20261022",
+    digest: "sha256:2e867ccaa2a404efaffc20705102b90510d1be5cb47ca23795a776cfa0548869",
+    version: "v1",
+    servers: ["https://forms.googleapis.com/v1"],
+    tags: ["forms", "forms.responses", "forms.watches"],
+    ops: [
+        ["POST", "/forms", "forms.forms.create", "Create add an empty form with title and optional Drive document title.", 0],
+        ["GET", "/forms/{formId}", "forms.forms.get", "Get read form question options, quiz grading answer key, images and section navigation.", 0],
+        ["GET", "/forms/{formId}/responses", "forms.forms.responses.list", "List find form responses since a timestamp, submitted answers and respondent email.", 1],
+        ["GET", "/forms/{formId}/responses/{responseId}", "forms.forms.responses.get", "Get read one form response with answers, quiz grades and feedback.", 1],
+        ["GET", "/forms/{formId}/watches", "forms.forms.watches.list", "Refused: list watch form response registrations is outside this connection.", 2],
+        ["POST", "/forms/{formId}/watches", "forms.forms.watches.create", "Refused: register watch form responses with persistent Pub/Sub delivery requires separate authorization.", 2],
+        ["DELETE", "/forms/{formId}/watches/{watchId}", "forms.forms.watches.delete", "Refused: delete watch form response registration is outside this connection.", 2],
+        ["POST", "/forms/{formId}/watches/{watchId}:renew", "forms.forms.watches.renew", "Refused: renew watch form response delivery requires separate authorization.", 2],
+        ["POST", "/forms/{formId}:batchUpdate", "forms.forms.batchUpdate", "Edit form: change name/title/quiz settings/correct answer key, rename choice option, add/delete/move item/question.", 0],
+        ["POST", "/forms/{formId}:setPublishSettings", "forms.forms.setPublishSettings", "Refused: publish form settings and response availability require separate authorization.", 0],
+    ],
+    fields: "{\"p\":[\"answers\",\"createTime\",\"errorType\",\"eventType\",\"expireTime\",\"form\",\"formId\",\"id\",\"info\",\"items\",\"items[].description\",\"items[].imageItem\",\"items[].itemId\",\"items[].pageBreakItem\",\"items[].questionGroupItem\",\"items[].questionItem\",\"items[].textItem\",\"items[].title\",\"items[].videoItem\",\"lastSubmittedTime\",\"linkedSheetId\",\"nextPageToken\",\"publishSettings\",\"replies\",\"replies[].createItem\",\"respondentEmail\",\"responderUri\",\"responseId\",\"responses\",\"responses[].answers\",\"responses[].createTime\",\"responses[].formId\",\"responses[].lastSubmittedTime\",\"responses[].respondentEmail\",\"responses[].responseId\",\"responses[].totalScore\",\"revisionId\",\"settings\",\"state\",\"target\",\"totalScore\",\"watches\",\"watches[].createTime\",\"watches[].errorType\",\"watches[].eventType\",\"watches[].expireTime\",\"watches[].id\",\"watches[].state\",\"watches[].target\",\"writeControl\"],\"d\":[[6,8,9,10,11,12,13,14,15,16,17,18,20,22,26,36,37],[21,28,29,30,31,32,33,34,35],[0,1,6,19,25,27,40],[41,42,43,44,45,46,47,48],[1,2,3,4,7,38,39],[],[5,23,24,49],[6,22]],\"o\":[0,0,1,2,3,4,5,4,6,7]}",
+    requestSchemas: "{\"definitions\":{\"Input_Form\":{\"description\":\"A Google Forms document.\",\"properties\":{\"info\":{\"description\":\"Required.\",\"$ref\":\"#/$defs/Input_Info\"},\"items\":{\"description\":\"Required.\",\"items\":{\"$ref\":\"#/$defs/Input_Item\"},\"type\":\"array\"},\"settings\":{\"description\":\"The form's settings.\",\"$ref\":\"#/$defs/Input_FormSettings\"}},\"type\":\"object\"},\"Input_Info\":{\"description\":\"The general information for a form.\",\"properties\":{\"description\":{\"description\":\"The description of the form.\",\"type\":\"string\"},\"title\":{\"description\":\"Required.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_Item\":{\"description\":\"A single item of the form.\",\"properties\":{\"description\":{\"description\":\"The description of the item.\",\"type\":\"string\"},\"imageItem\":{\"description\":\"Displays an image on the page.\",\"$ref\":\"#/$defs/Input_ImageItem\"},\"itemId\":{\"description\":\"The item ID.\",\"type\":\"string\"},\"pageBreakItem\":{\"description\":\"Starts a new page with a title.\",\"$ref\":\"#/$defs/Input_PageBreakItem\"},\"questionGroupItem\":{\"description\":\"Poses one or more questions to the user with a single major prompt.\",\"$ref\":\"#/$defs/Input_QuestionGroupItem\"},\"questionItem\":{\"description\":\"Poses a question to the user.\",\"$ref\":\"#/$defs/Input_QuestionItem\"},\"textItem\":{\"description\":\"Displays a title and description on the page.\",\"$ref\":\"#/$defs/Input_TextItem\"},\"title\":{\"description\":\"The title of the item.\",\"type\":\"string\"},\"videoItem\":{\"description\":\"Displays a video on the page.\",\"$ref\":\"#/$defs/Input_VideoItem\"}},\"type\":\"object\"},\"Input_ImageItem\":{\"description\":\"An item containing an image.\",\"properties\":{\"image\":{\"description\":\"Required.\",\"$ref\":\"#/$defs/Input_Image\"}},\"type\":\"object\"},\"Input_Image\":{\"description\":\"Data representing an image.\",\"properties\":{\"altText\":{\"description\":\"A description of the image that is shown on hover and read by screenreaders.\",\"type\":\"string\"},\"properties\":{\"description\":\"Properties of an image.\",\"$ref\":\"#/$defs/Input_MediaProperties\"},\"sourceUri\":{\"description\":\"Input only.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_MediaProperties\":{\"description\":\"Properties of the media.\",\"properties\":{\"alignment\":{\"description\":\"Position of the media.\",\"enum\":[\"ALIGNMENT_UNSPECIFIED\",\"LEFT\",\"RIGHT\",\"CENTER\"],\"type\":\"string\"},\"width\":{\"description\":\"The width of the media in pixels.\",\"format\":\"int32\",\"type\":\"integer\"}},\"type\":\"object\"},\"Input_PageBreakItem\":{\"additionalProperties\":true,\"description\":\"A page break.\",\"properties\":{},\"type\":\"object\"},\"Input_QuestionGroupItem\":{\"description\":\"Defines a question that comprises multiple questions grouped together.\",\"properties\":{\"grid\":{\"description\":\"The question group is a grid with rows of multiple choice questions that share the same options.\",\"$ref\":\"#/$defs/Input_Grid\"},\"image\":{\"description\":\"The image displayed within the question group above the specific questions.\",\"$ref\":\"#/$defs/Input_Image\"},\"questions\":{\"description\":\"Required.\",\"items\":{\"$ref\":\"#/$defs/Input_Question\"},\"type\":\"array\"}},\"type\":\"object\"},\"Input_Grid\":{\"description\":\"A grid of choices (radio or check boxes) with each row constituting a separate question.\",\"properties\":{\"columns\":{\"description\":\"Required.\",\"$ref\":\"#/$defs/Input_ChoiceQuestion\"},\"shuffleQuestions\":{\"description\":\"If `true`, the questions are randomly ordered.\",\"type\":\"boolean\"}},\"type\":\"object\"},\"Input_ChoiceQuestion\":{\"description\":\"A radio/checkbox/dropdown question.\",\"properties\":{\"options\":{\"description\":\"Required.\",\"items\":{\"$ref\":\"#/$defs/Input_Option\"},\"type\":\"array\"},\"shuffle\":{\"description\":\"Whether the options should be displayed in random order for different instances of the quiz.\",\"type\":\"boolean\"},\"type\":{\"description\":\"Required.\",\"enum\":[\"CHOICE_TYPE_UNSPECIFIED\",\"RADIO\",\"CHECKBOX\",\"DROP_DOWN\"],\"type\":\"string\"}},\"type\":\"object\"},\"Input_Option\":{\"description\":\"An option for a Choice question.\",\"properties\":{\"goToAction\":{\"description\":\"Section navigation type.\",\"enum\":[\"GO_TO_ACTION_UNSPECIFIED\",\"NEXT_SECTION\",\"RESTART_FORM\",\"SUBMIT_FORM\"],\"type\":\"string\"},\"goToSectionId\":{\"description\":\"Item ID of section header to go to.\",\"type\":\"string\"},\"image\":{\"description\":\"Display image as an option.\",\"$ref\":\"#/$defs/Input_Image\"},\"isOther\":{\"description\":\"Whether the option is \\\"other\\\".\",\"type\":\"boolean\"},\"value\":{\"description\":\"Required.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_Question\":{\"description\":\"Any question.\",\"properties\":{\"choiceQuestion\":{\"description\":\"A respondent can choose from a pre-defined set of options.\",\"$ref\":\"#/$defs/Input_ChoiceQuestion\"},\"dateQuestion\":{\"description\":\"A respondent can enter a date.\",\"$ref\":\"#/$defs/Input_DateQuestion\"},\"fileUploadQuestion\":{\"description\":\"A respondent can upload one or more files.\",\"$ref\":\"#/$defs/Input_FileUploadQuestion\"},\"grading\":{\"description\":\"Grading setup for the question.\",\"$ref\":\"#/$defs/Input_Grading\"},\"questionId\":{\"description\":\"Read only.\",\"type\":\"string\"},\"ratingQuestion\":{\"description\":\"A respondent can choose a rating from a pre-defined set of icons.\",\"$ref\":\"#/$defs/Input_RatingQuestion\"},\"required\":{\"description\":\"Whether the question must be answered in order for a respondent to submit their response.\",\"type\":\"boolean\"},\"rowQuestion\":{\"description\":\"A row of a QuestionGroupItem.\",\"$ref\":\"#/$defs/Input_RowQuestion\"},\"scaleQuestion\":{\"description\":\"A respondent can choose a number from a range.\",\"$ref\":\"#/$defs/Input_ScaleQuestion\"},\"textQuestion\":{\"description\":\"A respondent can enter a free text response.\",\"$ref\":\"#/$defs/Input_TextQuestion\"},\"timeQuestion\":{\"description\":\"A respondent can enter a time.\",\"$ref\":\"#/$defs/Input_TimeQuestion\"}},\"type\":\"object\"},\"Input_DateQuestion\":{\"description\":\"A date question.\",\"properties\":{\"includeTime\":{\"description\":\"Whether to include the time as part of the question.\",\"type\":\"boolean\"},\"includeYear\":{\"description\":\"Whether to include the year as part of the question.\",\"type\":\"boolean\"}},\"type\":\"object\"},\"Input_FileUploadQuestion\":{\"description\":\"A file upload question.\",\"properties\":{\"folderId\":{\"description\":\"Required.\",\"type\":\"string\"},\"maxFileSize\":{\"description\":\"Maximum number of bytes allowed for any single file uploaded to this question.\",\"format\":\"int64\",\"type\":\"string\"},\"maxFiles\":{\"description\":\"Maximum number of files that can be uploaded for this question in a single response.\",\"format\":\"int32\",\"type\":\"integer\"},\"types\":{\"description\":\"File types accepted by this question.\",\"items\":{\"enum\":[\"FILE_TYPE_UNSPECIFIED\",\"ANY\",\"DOCUMENT\",\"PRESENTATION\",\"SPREADSHEET\",\"DRAWING\",\"PDF\",\"IMAGE\",\"VIDEO\",\"AUDIO\"],\"type\":\"string\"},\"type\":\"array\"}},\"type\":\"object\"},\"Input_Grading\":{\"description\":\"Grading for a single question\",\"properties\":{\"correctAnswers\":{\"description\":\"Required.\",\"$ref\":\"#/$defs/Input_CorrectAnswers\"},\"generalFeedback\":{\"description\":\"The feedback displayed for all answers.\",\"$ref\":\"#/$defs/Input_Feedback\"},\"pointValue\":{\"description\":\"Required.\",\"format\":\"int32\",\"type\":\"integer\"},\"whenRight\":{\"description\":\"The feedback displayed for correct responses.\",\"$ref\":\"#/$defs/Input_Feedback\"},\"whenWrong\":{\"description\":\"The feedback displayed for incorrect responses.\",\"$ref\":\"#/$defs/Input_Feedback\"}},\"type\":\"object\"},\"Input_CorrectAnswers\":{\"description\":\"The answer key for a question.\",\"properties\":{\"answers\":{\"description\":\"A list of correct answers.\",\"items\":{\"$ref\":\"#/$defs/Input_CorrectAnswer\"},\"type\":\"array\"}},\"type\":\"object\"},\"Input_CorrectAnswer\":{\"description\":\"A single correct answer for a question.\",\"properties\":{\"value\":{\"description\":\"Required.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_Feedback\":{\"description\":\"Feedback for a respondent about their response to a question.\",\"properties\":{\"material\":{\"description\":\"Additional information provided as part of the feedback, often used to point the respondent to more reading and resources.\",\"items\":{\"$ref\":\"#/$defs/Input_ExtraMaterial\"},\"type\":\"array\"},\"text\":{\"description\":\"Required.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_ExtraMaterial\":{\"description\":\"Supplementary material to the feedback.\",\"properties\":{\"link\":{\"description\":\"Text feedback.\",\"$ref\":\"#/$defs/Input_TextLink\"},\"video\":{\"description\":\"Video feedback.\",\"$ref\":\"#/$defs/Input_VideoLink\"}},\"type\":\"object\"},\"Input_TextLink\":{\"description\":\"Link for text.\",\"properties\":{\"displayText\":{\"description\":\"Required.\",\"type\":\"string\"},\"uri\":{\"description\":\"Required.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_VideoLink\":{\"description\":\"Link to a video.\",\"properties\":{\"displayText\":{\"description\":\"Required.\",\"type\":\"string\"},\"youtubeUri\":{\"description\":\"The URI of a YouTube video.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_RatingQuestion\":{\"description\":\"A rating question.\",\"properties\":{\"iconType\":{\"description\":\"Required.\",\"enum\":[\"RATING_ICON_TYPE_UNSPECIFIED\",\"STAR\",\"HEART\",\"THUMB_UP\"],\"type\":\"string\"},\"ratingScaleLevel\":{\"description\":\"Required.\",\"format\":\"int32\",\"type\":\"integer\"}},\"type\":\"object\"},\"Input_RowQuestion\":{\"description\":\"Configuration for a question that is part of a question group.\",\"properties\":{\"title\":{\"description\":\"Required.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_ScaleQuestion\":{\"description\":\"A scale question.\",\"properties\":{\"high\":{\"description\":\"Required.\",\"format\":\"int32\",\"type\":\"integer\"},\"highLabel\":{\"description\":\"The label to display describing the highest point on the scale.\",\"type\":\"string\"},\"low\":{\"description\":\"Required.\",\"format\":\"int32\",\"type\":\"integer\"},\"lowLabel\":{\"description\":\"The label to display describing the lowest point on the scale.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_TextQuestion\":{\"description\":\"A text-based question.\",\"properties\":{\"paragraph\":{\"description\":\"Whether the question is a paragraph question or not.\",\"type\":\"boolean\"}},\"type\":\"object\"},\"Input_TimeQuestion\":{\"description\":\"A time question.\",\"properties\":{\"duration\":{\"description\":\"`true` if the question is about an elapsed time.\",\"type\":\"boolean\"}},\"type\":\"object\"},\"Input_QuestionItem\":{\"description\":\"A form item containing a single question.\",\"properties\":{\"image\":{\"description\":\"The image displayed within the question.\",\"$ref\":\"#/$defs/Input_Image\"},\"question\":{\"description\":\"Required.\",\"$ref\":\"#/$defs/Input_Question\"}},\"type\":\"object\"},\"Input_TextItem\":{\"additionalProperties\":true,\"description\":\"A text item.\",\"properties\":{},\"type\":\"object\"},\"Input_VideoItem\":{\"description\":\"An item containing a video.\",\"properties\":{\"caption\":{\"description\":\"The text displayed below the video.\",\"type\":\"string\"},\"video\":{\"description\":\"Required.\",\"$ref\":\"#/$defs/Input_Video\"}},\"type\":\"object\"},\"Input_Video\":{\"description\":\"Data representing a video.\",\"properties\":{\"properties\":{\"description\":\"Properties of a video.\",\"$ref\":\"#/$defs/Input_MediaProperties\"},\"youtubeUri\":{\"description\":\"Required.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_FormSettings\":{\"description\":\"A form's settings.\",\"properties\":{\"emailCollectionType\":{\"description\":\"Optional.\",\"enum\":[\"EMAIL_COLLECTION_TYPE_UNSPECIFIED\",\"DO_NOT_COLLECT\",\"VERIFIED\",\"RESPONDER_INPUT\"],\"type\":\"string\"},\"quizSettings\":{\"description\":\"Settings related to quiz forms and grading.\",\"$ref\":\"#/$defs/Input_QuizSettings\"}},\"type\":\"object\"},\"Input_QuizSettings\":{\"description\":\"Settings related to quiz forms and grading.\",\"properties\":{\"isQuiz\":{\"description\":\"Whether this form is a quiz or not.\",\"type\":\"boolean\"}},\"type\":\"object\"},\"Input_CreateWatchRequest\":{\"description\":\"Create a new watch.\",\"properties\":{\"watch\":{\"description\":\"Required.\",\"$ref\":\"#/$defs/Input_Watch\"},\"watchId\":{\"description\":\"The ID to use for the watch.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_Watch\":{\"description\":\"A watch for events for a form.\",\"properties\":{\"eventType\":{\"description\":\"Required.\",\"enum\":[\"EVENT_TYPE_UNSPECIFIED\",\"SCHEMA\",\"RESPONSES\"],\"type\":\"string\"},\"target\":{\"description\":\"Required.\",\"$ref\":\"#/$defs/Input_WatchTarget\"}},\"type\":\"object\"},\"Input_WatchTarget\":{\"description\":\"The target for notification delivery.\",\"properties\":{\"topic\":{\"description\":\"A Pub/Sub topic.\",\"$ref\":\"#/$defs/Input_CloudPubsubTopic\"}},\"type\":\"object\"},\"Input_CloudPubsubTopic\":{\"description\":\"A Pub/Sub topic.\",\"properties\":{\"topicName\":{\"description\":\"Required.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_RenewWatchRequest\":{\"additionalProperties\":true,\"description\":\"Renew an existing Watch for seven days.\",\"properties\":{},\"type\":\"object\"},\"Input_BatchUpdateFormRequest\":{\"description\":\"A batch of updates to perform on a form.\",\"properties\":{\"includeFormInResponse\":{\"description\":\"Whether to return an updated version of the model in the response.\",\"type\":\"boolean\"},\"requests\":{\"description\":\"Required.\",\"items\":{\"$ref\":\"#/$defs/Input_Request\"},\"type\":\"array\"},\"writeControl\":{\"description\":\"Provides control over how write requests are executed.\",\"$ref\":\"#/$defs/Input_WriteControl\"}},\"type\":\"object\"},\"Input_Request\":{\"description\":\"The kinds of update requests that can be made.\",\"properties\":{\"createItem\":{\"description\":\"Create a new item.\",\"$ref\":\"#/$defs/Input_CreateItemRequest\"},\"deleteItem\":{\"description\":\"Delete an item.\",\"$ref\":\"#/$defs/Input_DeleteItemRequest\"},\"moveItem\":{\"description\":\"Move an item to a specified location.\",\"$ref\":\"#/$defs/Input_MoveItemRequest\"},\"updateFormInfo\":{\"description\":\"Update Form's Info.\",\"$ref\":\"#/$defs/Input_UpdateFormInfoRequest\"},\"updateItem\":{\"description\":\"Update an item.\",\"$ref\":\"#/$defs/Input_UpdateItemRequest\"},\"updateSettings\":{\"description\":\"Updates the Form's settings.\",\"$ref\":\"#/$defs/Input_UpdateSettingsRequest\"}},\"type\":\"object\"},\"Input_CreateItemRequest\":{\"description\":\"Create an item in a form.\",\"properties\":{\"item\":{\"description\":\"Required.\",\"$ref\":\"#/$defs/Input_Item\"},\"location\":{\"description\":\"Required.\",\"$ref\":\"#/$defs/Input_Location\"}},\"type\":\"object\"},\"Input_Location\":{\"description\":\"A specific location in a form.\",\"properties\":{\"index\":{\"description\":\"The index of an item in the form.\",\"format\":\"int32\",\"type\":\"integer\"}},\"type\":\"object\"},\"Input_DeleteItemRequest\":{\"description\":\"Delete an item in a form.\",\"properties\":{\"location\":{\"description\":\"Required.\",\"$ref\":\"#/$defs/Input_Location\"}},\"type\":\"object\"},\"Input_MoveItemRequest\":{\"description\":\"Move an item in a form.\",\"properties\":{\"newLocation\":{\"description\":\"Required.\",\"$ref\":\"#/$defs/Input_Location\"},\"originalLocation\":{\"description\":\"Required.\",\"$ref\":\"#/$defs/Input_Location\"}},\"type\":\"object\"},\"Input_UpdateFormInfoRequest\":{\"description\":\"Update Form's Info.\",\"properties\":{\"info\":{\"description\":\"The info to update.\",\"$ref\":\"#/$defs/Input_Info\"},\"updateMask\":{\"description\":\"Required.\",\"format\":\"google-fieldmask\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_UpdateItemRequest\":{\"description\":\"Update an item in a form.\",\"properties\":{\"item\":{\"description\":\"Required.\",\"$ref\":\"#/$defs/Input_Item\"},\"location\":{\"description\":\"Required.\",\"$ref\":\"#/$defs/Input_Location\"},\"updateMask\":{\"description\":\"Required.\",\"format\":\"google-fieldmask\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_UpdateSettingsRequest\":{\"description\":\"Update Form's FormSettings.\",\"properties\":{\"settings\":{\"description\":\"Required.\",\"$ref\":\"#/$defs/Input_FormSettings\"},\"updateMask\":{\"description\":\"Required.\",\"format\":\"google-fieldmask\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_WriteControl\":{\"description\":\"Provides control over how write requests are executed.\",\"properties\":{\"requiredRevisionId\":{\"description\":\"The revision ID of the form that the write request is applied to.\",\"type\":\"string\"},\"targetRevisionId\":{\"description\":\"The target revision ID of the form that the write request is applied to.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_SetPublishSettingsRequest\":{\"description\":\"Updates the publish settings of a Form.\",\"properties\":{\"publishSettings\":{\"description\":\"Required.\",\"$ref\":\"#/$defs/Input_PublishSettings\"},\"updateMask\":{\"description\":\"Optional.\",\"format\":\"google-fieldmask\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_PublishSettings\":{\"description\":\"The publishing settings of a form.\",\"properties\":{\"publishState\":{\"description\":\"Optional.\",\"$ref\":\"#/$defs/Input_PublishState\"}},\"type\":\"object\"},\"Input_PublishState\":{\"description\":\"The publishing state of a form.\",\"properties\":{\"isAcceptingResponses\":{\"description\":\"Required.\",\"type\":\"boolean\"},\"isPublished\":{\"description\":\"Required.\",\"type\":\"boolean\"}},\"type\":\"object\"}},\"roots\":[{\"$ref\":\"#/$defs/Input_Form\"},null,null,null,null,{\"$ref\":\"#/$defs/Input_CreateWatchRequest\"},null,{\"$ref\":\"#/$defs/Input_RenewWatchRequest\"},{\"$ref\":\"#/$defs/Input_BatchUpdateFormRequest\"},{\"$ref\":\"#/$defs/Input_SetPublishSettingsRequest\"}]}",
+}, { "length": 6875, "definitions": "[{\"t\":\"object\",\"p\":{\"altText\":{\"t\":\"string\"},\"properties\":{\"t\":\"object\",\"x\":1},\"sourceUri\":{\"t\":\"string\"}}},{\"t\":\"string\",\"e\":[\"EMAIL_COLLECTION_TYPE_UNSPECIFIED\",\"DO_NOT_COLLECT\",\"VERIFIED\",\"RESPONDER_INPUT\"]},{\"t\":\"object\",\"p\":{\"description\":{\"t\":\"string\"},\"imageItem\":{\"t\":\"object\",\"x\":1},\"itemId\":{\"t\":\"string\"},\"pageBreakItem\":{\"t\":\"object\",\"x\":1},\"questionGroupItem\":{\"t\":\"object\",\"x\":1},\"questionItem\":{\"t\":\"object\",\"x\":1},\"textItem\":{\"t\":\"object\",\"x\":1},\"title\":{\"t\":\"string\"},\"videoItem\":{\"t\":\"object\",\"x\":1}}}]", "parameters": ["[\"prettyPrint\",\"query\",0,{\"t\":\"boolean\"},\"Returns response with indentations and line breaks.\"]", "[\"fields\",\"query\",0,{\"t\":\"string\"},\"Selector specifying which fields to include in a partial response.\"]", "[\"unpublished\",\"query\",0,{\"t\":\"boolean\"},\"Optional.\"]", "[\"formId\",\"path\",1,{\"t\":\"string\"},\"Required.\"]", "[\"pageToken\",\"query\",0,{\"t\":\"string\"},\"A page token returned by a previous list response.\"]", "[\"filter\",\"query\",0,{\"t\":\"string\"},\"Which form responses to return.\"]", "[\"pageSize\",\"query\",0,{\"t\":\"integer\",\"f\":\"int32\"},\"The maximum number of responses to return.\"]", "[\"responseId\",\"path\",1,{\"t\":\"string\"},\"Required.\"]", "[\"watchId\",\"path\",1,{\"t\":\"string\"},\"Required.\"]"], "operations": [[[0, 1, 2], "[\"application/json\",{\"t\":\"object\",\"p\":{\"info\":{\"t\":\"object\",\"d\":\"The general information for a form.\",\"p\":{\"description\":{\"t\":\"string\"},\"title\":{\"t\":\"string\"}}},\"items\":{\"t\":\"array\",\"d\":\"Required.\",\"i\":{\"t\":\"object\",\"p\":{\"description\":{\"t\":\"string\"},\"imageItem\":{\"t\":\"object\",\"p\":{\"image\":{\"$\":0}}},\"itemId\":{\"t\":\"string\"},\"pageBreakItem\":{\"t\":\"object\",\"p\":{},\"m\":{}},\"questionGroupItem\":{\"t\":\"object\",\"p\":{\"grid\":{\"t\":\"object\",\"p\":{\"columns\":{\"t\":\"object\",\"x\":1},\"shuffleQuestions\":{\"t\":\"boolean\"}}},\"image\":{\"$\":0},\"questions\":{\"t\":\"array\",\"i\":{\"t\":\"object\",\"x\":1}}}},\"questionItem\":{\"t\":\"object\",\"p\":{\"image\":{\"$\":0},\"question\":{\"t\":\"object\",\"p\":{\"choiceQuestion\":{\"t\":\"object\",\"x\":1},\"dateQuestion\":{\"t\":\"object\",\"x\":1},\"fileUploadQuestion\":{\"t\":\"object\",\"x\":1},\"grading\":{\"t\":\"object\",\"x\":1},\"questionId\":{\"t\":\"string\"},\"ratingQuestion\":{\"t\":\"object\",\"x\":1},\"required\":{\"t\":\"boolean\"},\"rowQuestion\":{\"t\":\"object\",\"x\":1},\"scaleQuestion\":{\"t\":\"object\",\"x\":1},\"textQuestion\":{\"t\":\"object\",\"x\":1},\"timeQuestion\":{\"t\":\"object\",\"x\":1}}}}},\"textItem\":{\"t\":\"object\",\"p\":{},\"m\":{}},\"title\":{\"t\":\"string\"},\"videoItem\":{\"t\":\"object\",\"p\":{\"caption\":{\"t\":\"string\"},\"video\":{\"t\":\"object\",\"p\":{\"properties\":{\"t\":\"object\",\"x\":1},\"youtubeUri\":{\"t\":\"string\"}}}}}}}},\"settings\":{\"t\":\"object\",\"d\":\"A form's settings.\",\"p\":{\"emailCollectionType\":{\"$\":1},\"quizSettings\":{\"t\":\"object\",\"p\":{\"isQuiz\":{\"t\":\"boolean\"}}}}}}},1]"], [[0, 1, 3], "0"], [[0, 1, 3, 4, 5, 6], "0"], [[0, 1, 7, 3], "0"], [[0, 1, 3], "0"], [[0, 1, 3], "[\"application/json\",{\"t\":\"object\",\"p\":{\"watch\":{\"t\":\"object\",\"d\":\"A watch for events for a form.\",\"p\":{\"eventType\":{\"t\":\"string\",\"e\":[\"EVENT_TYPE_UNSPECIFIED\",\"SCHEMA\",\"RESPONSES\"]},\"target\":{\"t\":\"object\",\"p\":{\"topic\":{\"t\":\"object\",\"p\":{\"topicName\":{\"t\":\"string\"}}}}}}},\"watchId\":{\"t\":\"string\",\"d\":\"The ID to use for the watch.\"}}},1]"], [[0, 1, 8, 3], "0"], [[0, 1, 8, 3], "[\"application/json\",{\"t\":\"object\",\"p\":{},\"m\":{}},1]"], [[0, 1, 3], "[\"application/json\",{\"t\":\"object\",\"p\":{\"includeFormInResponse\":{\"t\":\"boolean\",\"d\":\"Whether to return an updated version of the model in the response.\"},\"requests\":{\"t\":\"array\",\"d\":\"Required.\",\"i\":{\"t\":\"object\",\"p\":{\"createItem\":{\"t\":\"object\",\"p\":{\"item\":{\"$\":2},\"location\":{\"t\":\"object\",\"p\":{\"index\":{\"t\":\"integer\",\"f\":\"int32\"}}}}},\"deleteItem\":{\"t\":\"object\",\"p\":{\"location\":{\"t\":\"object\",\"p\":{\"index\":{\"t\":\"integer\",\"f\":\"int32\"}}}}},\"moveItem\":{\"t\":\"object\",\"p\":{\"newLocation\":{\"t\":\"object\",\"p\":{\"index\":{\"t\":\"integer\",\"f\":\"int32\"}}},\"originalLocation\":{\"t\":\"object\",\"p\":{\"index\":{\"t\":\"integer\",\"f\":\"int32\"}}}}},\"updateFormInfo\":{\"t\":\"object\",\"p\":{\"info\":{\"t\":\"object\",\"p\":{\"description\":{\"t\":\"string\"},\"title\":{\"t\":\"string\"}}},\"updateMask\":{\"t\":\"string\",\"f\":\"google-fieldmask\"}}},\"updateItem\":{\"t\":\"object\",\"p\":{\"item\":{\"$\":2},\"location\":{\"t\":\"object\",\"p\":{\"index\":{\"t\":\"integer\",\"f\":\"int32\"}}},\"updateMask\":{\"t\":\"string\",\"f\":\"google-fieldmask\"}}},\"updateSettings\":{\"t\":\"object\",\"p\":{\"settings\":{\"t\":\"object\",\"p\":{\"emailCollectionType\":{\"$\":1},\"quizSettings\":{\"t\":\"object\",\"x\":1}}},\"updateMask\":{\"t\":\"string\",\"f\":\"google-fieldmask\"}}}}}},\"writeControl\":{\"t\":\"object\",\"d\":\"Provides control over how write requests are executed.\",\"p\":{\"requiredRevisionId\":{\"t\":\"string\"},\"targetRevisionId\":{\"t\":\"string\"}}}}},1]"], [[0, 1, 3], "[\"application/json\",{\"t\":\"object\",\"p\":{\"publishSettings\":{\"t\":\"object\",\"d\":\"The publishing settings of a form.\",\"p\":{\"publishState\":{\"t\":\"object\",\"p\":{\"isAcceptingResponses\":{\"t\":\"boolean\"},\"isPublished\":{\"t\":\"boolean\"}}}}},\"updateMask\":{\"t\":\"string\",\"f\":\"google-fieldmask\",\"d\":\"Optional.\"}}},1]"]] });

package/dist/providers/forms/safety.js

@@ -0,0 +1,34 @@
+// Reviewed against archived Forms Discovery revision 20261022.
+// Form/response bodies are user data: grading answer keys and respondent email
+// remain available. Image.contentUri is a vendor-minted temporary bearer
+// destination and is permanently withheld, including in batch.form expansions.
+// User-authored sourceUri, responderUri, video URLs and feedback links are
+// ordinary references. No generic credential URL-name rule is applied there;
+// global signing-name defense still covers free text and error bodies.
+import { safe, redact, refuse, vendorErrors } from "../_shared/rest/value-safety.js";
+const imagePaths = [
+    "items[].imageItem.image.contentUri",
+    "items[].questionGroupItem.questions[].choiceQuestion.options[].image.contentUri",
+    "items[].questionGroupItem.grid.columns.options[].image.contentUri",
+    "items[].questionGroupItem.image.contentUri",
+    "items[].questionItem.question.choiceQuestion.options[].image.contentUri",
+    "items[].questionItem.image.contentUri",
+];
+export const FORMS_VALUE_SAFETY = {
+    title: "Google Forms",
+    embeddedUrls: {},
+    operations: {
+        "GET /forms/{formId}": vendorErrors(redact("Temporary image download destinations convey private access; form structure and quiz answer keys remain requested user data.", imagePaths)),
+        "POST /forms": vendorErrors(redact("Created forms use the same permanent image destination boundary.", imagePaths)),
+        "POST /forms/{formId}:batchUpdate": vendorErrors(redact("Expanded batch forms use the same permanent image destination boundary.", imagePaths.map((path) => `form.${path}`))),
+        "GET /forms/{formId}/responses": vendorErrors(safe("Responses and respondent email are requested user data; nextPageToken is only a continuation, not an authentication credential.", ["nextPageToken"])),
+        "POST /forms/{formId}/watches": refuse("Persistent Pub/Sub watch registration requires separate product authorization."),
+        "POST /forms/{formId}:setPublishSettings": refuse("Publishing and response availability changes require separate product authorization."),
+    },
+    fields: {
+        nextPageToken: {
+            verdict: "keep",
+            reason: "Opaque Forms pagination metadata, usable only with the delegated grant; not an access credential.",
+        },
+    },
+};

package/dist/providers/forms/skill.generated.js

@@ -1,11 +1,5 @@
 // Generated by scripts/generate-providers.mjs; do not edit.
 export const skill = {
-    "content": "# Google Forms usage\n\nActs as the signed-in person in Google Forms through Workspace delegation: read and edit their forms, read responses, never submit or delete.\n\nConnection purpose: \n\n## Whose forms\n\nEvery call reaches only the forms the Workspace user deployment config maps\nthe caller to can open; an agent acts as the owner of the pool it came through, unless the deployment fixes one shared account that every caller, agent or person, acts as. No argument names a user. A call with none mapped fails `auth_required`; only an operator can change\nthat. A form id\nthat does not exist and one not shared with that user fail alike, as\n`connector_call_failed`: Google does not say which.\n\n## Finding forms\n\nThere is no list or search here: the Forms API has none. Find a form in\nDrive, or take its id from an edit URL (`/forms/d/<formId>/edit`). The\n`/forms/d/e/…` responder link is not the form id.\n\n## Reading\n\n- Every result stays inside  KiB, so it crosses into\n  `execute_code` whole. A page that would outgrow that ends early with\n  `page.hasMore`; follow `page.nextCursor` rather than raising `limit`.\n- `get_form` lists items with their `questions`: one for a question,\n  one per row for a grid, none for sections and media. Answers are keyed by\n  those `questionId`s. A large form pages its items (`itemCount` is the\n  total), and a grid too large for one page continues on the next: the item\n  repeats with `questionsFrom`, the index of its first row there, and\n  `moreQuestions` counts rows still to come. A cursor from a form that has\n  since changed fails `conflict`.\n  Long text is cut with a marker; `raw: true` returns Google's whole Form\n  resource, or refuses one too large for a result.\n- `list_responses` labels each answer with its question's title, in form\n  order; an answer to a since-deleted question has no title. Answers longer\n  than  characters end with a truncation marker; `get_response`\n  reads one whole. Page with `page.nextCursor` and the same\n  `submittedAfter`. To read only new responses, pass the newest\n  `lastSubmittedTime` already seen as `submittedAfter`. A cursor\n  continues after the last response it returned; if Google's page has\n  changed since (new, deleted, or reordered responses), it fails\n  `conflict` — start again, or use `submittedAfter`.\n- A response too large for one result comes back cut, with the answers left\n  out named in `omittedQuestionIds`; pass them to `get_response` as\n  `questionIds`.\n\n## Editing\n\n- `create_form` makes an empty form: Google takes only its title and Drive\n  file name at creation. Add a description and questions afterwards.\n- `update_form_info` replaces the title or description.\n- `batch_update_form` is the escape hatch for everything else, and always\n  needs approval. It takes Google's own Request objects, applied all or none,\n  with the form's current `revisionId` as `requiredRevisionId`: a form\n  someone changed since you read it is refused as `conflict`, so re-read it\n  and rebuild the edit. Its reply carries the new `revisionId` and each created item's id.\n  A reply too large to return whole comes back with `truncated: true`: the\n  batch still applied; read the rest with `get_form`. An `updateItem` needs an `updateMask`; read `raw: true` first so the\n  item it replaces keeps its grading, images, and navigation.\n- Publishing, sharing, deleting, and watches are not in this connection; the\n  owner does those in Forms or Drive. Responses are read-only.\n",
-    "instructionsHeading": "Connection instructions",
-    "fragments": {
-        "guide_0": "# Google Forms usage\n\nActs as the signed-in person in Google Forms through Workspace delegation: read and edit their forms, read responses, never submit or delete.\n\nConnection purpose: ",
-        "guide_1": "\n\n## Whose forms\n\nEvery call reaches only the forms the Workspace user deployment config maps\nthe caller to can open; an agent acts as the owner of the pool it came through, unless the deployment fixes one shared account that every caller, agent or person, acts as. No argument names a user. A call with none mapped fails `auth_required`; only an operator can change\nthat. A form id\nthat does not exist and one not shared with that user fail alike, as\n`connector_call_failed`: Google does not say which.\n\n## Finding forms\n\nThere is no list or search here: the Forms API has none. Find a form in\nDrive, or take its id from an edit URL (`/forms/d/<formId>/edit`). The\n`/forms/d/e/…` responder link is not the form id.\n\n## Reading\n\n- Every result stays inside ",
-        "guide_2": " KiB, so it crosses into\n  `execute_code` whole. A page that would outgrow that ends early with\n  `page.hasMore`; follow `page.nextCursor` rather than raising `limit`.\n- `get_form` lists items with their `questions`: one for a question,\n  one per row for a grid, none for sections and media. Answers are keyed by\n  those `questionId`s. A large form pages its items (`itemCount` is the\n  total), and a grid too large for one page continues on the next: the item\n  repeats with `questionsFrom`, the index of its first row there, and\n  `moreQuestions` counts rows still to come. A cursor from a form that has\n  since changed fails `conflict`.\n  Long text is cut with a marker; `raw: true` returns Google's whole Form\n  resource, or refuses one too large for a result.\n- `list_responses` labels each answer with its question's title, in form\n  order; an answer to a since-deleted question has no title. Answers longer\n  than ",
-        "guide_3": " characters end with a truncation marker; `get_response`\n  reads one whole. Page with `page.nextCursor` and the same\n  `submittedAfter`. To read only new responses, pass the newest\n  `lastSubmittedTime` already seen as `submittedAfter`. A cursor\n  continues after the last response it returned; if Google's page has\n  changed since (new, deleted, or reordered responses), it fails\n  `conflict` — start again, or use `submittedAfter`.\n- A response too large for one result comes back cut, with the answers left\n  out named in `omittedQuestionIds`; pass them to `get_response` as\n  `questionIds`.\n\n## Editing\n\n- `create_form` makes an empty form: Google takes only its title and Drive\n  file name at creation. Add a description and questions afterwards.\n- `update_form_info` replaces the title or description.\n- `batch_update_form` is the escape hatch for everything else, and always\n  needs approval. It takes Google's own Request objects, applied all or none,\n  with the form's current `revisionId` as `requiredRevisionId`: a form\n  someone changed since you read it is refused as `conflict`, so re-read it\n  and rebuild the edit. Its reply carries the new `revisionId` and each created item's id.\n  A reply too large to return whole comes back with `truncated: true`: the\n  batch still applied; read the rest with `get_form`. An `updateItem` needs an `updateMask`; read `raw: true` first so the\n  item it replaces keeps its grading, images, and navigation.\n- Publishing, sharing, deleting, and watches are not in this connection; the\n  owner does those in Forms or Drive. Responses are read-only.\n"
-    }
+    "content": "## Finding forms and joining answers\n\nThe Forms API cannot list or search forms. Find the file through Drive, or use\nthe id after `/forms/d/` in its edit URL. The `/forms/d/e/…` responder link is\nnot a form id. A form id is also its Drive file id.\n\nA form contains items; an item may ask one question, several grid questions,\nor no question. Responses join by `questionId`, never by `itemId`. Named\nresponse reads label answers with the current question titles in form order;\nan answer to a deleted question has no title. A response may contain several\nvalues or uploaded-file references for one question. File ids join to Drive.\n\n## Reading complete responses\n\nResponses and respondent emails can contain personal information. Filter and\naggregate in `execute_code`, returning named answers only when the task needs\nthem. `submittedAfter` is exclusive UTC: retain the newest `lastSubmittedTime`\nfor the next incremental read. Google does not promise a stable response\nsnapshot. A continuation inside a changed vendor page fails `conflict`; start\nagain or use that newest timestamp.\n\nLarge grids continue inside the same item: `questionsFrom` places the returned\nrows. `omittedQuestionIds` identifies answers left out for size; read those ids\nwith `get_response`. The structural hatch exposes quiz grading and correct\nanswers, images, and option navigation that named projections omit. Temporary\nimage access destinations remain withheld.\n\n## Editing without losing structure\n\nRead the form's current revision before editing. A stale revision refuses the\nbatch as `conflict`; re-read and rebuild the requested edit. A revision guards\nconcurrent changes and does not make a repeated write safe.\n\nCreation sets only title and Drive file name. Add descriptions or questions\nafterward. `updateItem` can replace grading, images and section navigation;\nread the full item through the hatch first and use a precise `updateMask`.\nItem locations are indexes, while response answers use question ids.\n\nPublishing, sharing, deleting forms, and watch administration are outside this\nconnection. Responses are read-only; no tool submits or deletes a response.\n\n## Conventions\n\n- **Paging:** while `page.hasMore` is true, continue with `page.nextCursor` unchanged. For `forms_api_details`, `forms_api_read`, `forms_api_search`, `get_form`, `list_responses`, pass it as the top-level `cursor`; omit raw paging anchors on continuations. Keep the original method, path, filters, page size, fields and headers. Paged `list_*` and `search_*` reads take `limit` (default 25, at most 100). The last page has no `nextCursor`. If `page.hasMore` is true without a cursor, the data is incomplete and continuation was withheld. When approaching execute_code's per-program call limit, return page.nextCursor before the call that would exceed it and continue in the next program; don't restart.\n- **Results:** `fields` narrows a read's result to the dot paths you name. `truncated` lists the dot paths a result cut for size; the ids that fetch what was cut stay in the result.\n- **Hatch:** `forms_api_search` finds this API's operations and reads no account data, `forms_api_details` shows one operation's contract, and `forms_api_read` calls a reviewed read. `forms_api_write` calls a reviewed write; the host may ask the user to confirm it. An operation without a reviewed verdict is refused. 5 operations are refused by design; use `forms_api_details` with the method and path to inspect the original operation summary and its separate refusal. Use details for refused methods outside the read/write call schemas; those methods remain unavailable.\n- **Writes:** a write is sent once and never retried. When its outcome is unknown, read the target before repeating it. Writes take no idempotency key.\n- **Errors:** codes come from the vendor's statuses and error facts, never its prose. An unknown id, or one these credentials cannot reach, fails as `connector_call_failed`; this API does not tell the two apart. `conflict` means: A revision-guarded batch update returned ABORTED or FAILED_PRECONDITION with HTTP 400 or 409.\n- **Withheld values:** a value withheld for safety reads `\"[redacted]\"`. Writes refuse whole marker values and withheld links; longer prose may mention the marker. Paths and queries refuse any containment.",
+    "instructionsHeading": "Connection instructions"
 };