@absolutejs/mcp 0.18.0 → 0.19.0

package/dist/src/apps.d.ts

@@ -35,3 +35,4 @@ export declare const appResourceContent: (resource: McpAppResource, uri: string)
 export { createBillingApps } from "./billingApps";
 export { createWorkflowApps } from "./workflowApps";
 export { createWorkflowTools, projectSetupStatus, projectWorkPreview, type McpSetupStatus, type McpWorkPreview, type McpWorkPreviewRequest, } from "./workflowTools";
+export { createSetupSelectionTools, projectSetupSelection, type SetupSelection, type SetupConfirmation, type SetupOption, } from "./setupSelection";

package/dist/src/index.d.ts

@@ -51,3 +51,4 @@ export { MCP_APP_MIME, clientSupportsMcpApps, withMcpApp, type McpAppResource, t
 export { createBillingApps } from "./billingApps";
 export { createWorkflowApps } from "./workflowApps";
 export { createWorkflowTools, projectSetupStatus, projectWorkPreview, type McpSetupStatus, type McpWorkPreview, type McpWorkPreviewRequest, } from "./workflowTools";
+export { createSetupSelectionTools, projectSetupSelection, type SetupSelection, type SetupConfirmation, type SetupOption, } from "./setupSelection";

package/dist/src/setupSelection.d.ts

@@ -0,0 +1,23 @@
+import type { McpToolRegistry } from "./types";
+export type SetupOption = {
+    id: string;
+    label: string;
+};
+export type SetupSelection = {
+    revision: string;
+    selectedId: string | null;
+    options: SetupOption[];
+};
+export type SetupConfirmation = {
+    expectedRevision: string;
+    selectedId: string | null;
+};
+export declare const projectSetupSelection: (value: unknown) => SetupSelection;
+/** Bind to the authenticated owner. confirm MUST atomically compare the revision,
+ * validate option ownership, change selection and advance the revision. All
+ * writers must advance it, including A→B→A. Retries with an old revision fail
+ * without effects. Recover by reading; never auto-retry against a new revision. */
+export declare const createSetupSelectionTools: (adapter: {
+    read: () => Promise<SetupSelection>;
+    confirm: (request: SetupConfirmation) => Promise<SetupSelection>;
+}) => McpToolRegistry;

package/dist/src/setupSelection.generated.d.ts

@@ -0,0 +1 @@
+export declare const setupSelectionScript: string;

package/docs/mcp-apps.md

@@ -82,3 +82,22 @@ operation and budget. Errors clear stale eligibility and point back to the assis
 Known affected VS Code builds retain the shared text fallback. The visible-browser
 fixture is `bun test/fixtures/workflowServer.ts` (loopback port 4418); it uses zero
 credits and no gateway or database.
+
+### Reviewed setup selection
+
+`createSetupSelectionTools({ read, confirm })` exposes `get_setup_options` and
+`confirm_setup_selection`; `createWorkflowApps()` supplies the selection view.
+The adapter returns `{ revision, selectedId, options: [{ id, label }] }`, with
+`null` selecting all businesses. It must bind the authenticated account itself.
+`confirm({ expectedRevision, selectedId })` must atomically compare the reviewed
+revision, validate ownership, change selection, and advance the revision. Every
+other selection writer must advance it too, including A → B → A. The package
+validates and projects values but cannot provide database atomicity for adapters.
+
+The view makes no call on mount. Review and Cancel are local; Confirm sends the
+exact reviewed revision and selection once. Errors discard review state and
+require a fresh read. Text-only hosts receive the same options/revision and must
+obtain explicit approval before invoking the write tool. This is a reversible
+setup action with no billing or outbound effects; it does not authorize paid
+work. At most 200 options are supported; IDs/revisions are bounded at 128
+characters and labels at 512. No account selector or credentials enter the view.

package/package.json

@@ -90,5 +90,5 @@
     "canary:checkout": "bun canary/checkout.ts"
   },
   "types": "./dist/src/index.d.ts",
-  "version": "0.18.0"
+  "version": "0.19.0"
 }