@buoy-gg/ask-buoy 7.0.33

package/lib/typescript/preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../../src/preset.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC;AAE5C,eAAO,MAAM,iBAAiB;;;;;;4BAUJ;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;;CAIzD,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB;;;uBAOpC,iBAAiB;;;;4BAlCd;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;EAsCzD"}

package/lib/typescript/store/askBuoyStore.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Conversation state for the sheet.
+ *
+ * A module-level store rather than component state for two reasons: the sheet
+ * is unmounted whenever the tool is closed or minimised (and a conversation
+ * that vanished because someone tapped away would be maddening), and the sync
+ * adapter needs to read the same transcript to show it on the desktop.
+ *
+ * Deliberately NOT persisted. A transcript can contain anything the agent read
+ * — storage values, response bodies, a customer's record — and writing that to
+ * disk under a Buoy key would put it in the Storage tool and, from there, on
+ * the unauthenticated broker wire. It lives for the session and no longer.
+ */
+import type { Block, BlockAnswer, AskBuoySession, EffectLedger, TurnEvent } from "@buoy-gg/agent-core";
+/** A block in a message, and (for receipts) the tool call that produced it. */
+export interface PlacedBlock {
+    block: Block;
+    forToolCallId?: string;
+}
+export interface ChatToolCall {
+    id: string;
+    toolId: string;
+    action: string;
+    /** Short human title — "Open /bag". */
+    label: string;
+    /** The catalog's fuller sentence, shown when the row is expanded. */
+    description?: string;
+    status: "running" | "ok" | "failed" | "refused";
+    /** Trailing status word once finished — "12 items", "Not found", "Done". */
+    summary?: string;
+}
+export interface ChatMessage {
+    id: string;
+    role: "user" | "assistant";
+    text: string;
+    toolCalls: ChatToolCall[];
+    /** Rich blocks — receipts from tool results and model-authored blocks. */
+    blocks: PlacedBlock[];
+    /** Set while the assistant is still streaming this message. */
+    streaming?: boolean;
+    error?: string;
+    /**
+     * True once a tool call has run and no narration has arrived since.
+     *
+     * One assistant "message" in this UI spans every turn of a multi-step run,
+     * so each turn's narration lands in the same bubble. Without a boundary they
+     * run together — "Taking you to the shop.Waiting for the menu.Opening Fire
+     * Grill." A tool event is the only reliable marker of a turn edge, because
+     * the engine emits them between turns and never inside one.
+     */
+    breakBeforeNextText?: boolean;
+}
+export interface PendingApproval {
+    id: string;
+    toolId: string;
+    action: string;
+    label: string;
+    description?: string;
+    reason: string;
+    resolve: (approved: boolean) => void;
+}
+export interface AskBuoyState {
+    messages: ChatMessage[];
+    busy: boolean;
+    pending: PendingApproval | null;
+    /** Set when the tool is unconfigured or the endpoint keeps failing. */
+    notice: string | null;
+    /** Whether the host app wired an endpoint + model. Set by the sheet's hook. */
+    configured: boolean;
+    /** Answers given to Ask blocks, by block id. Answered blocks lock. */
+    answers: Record<string, BlockAnswer>;
+    /** The Ask block the turn stopped on, until it is answered or skipped. */
+    awaitingBlockId: string | null;
+    /** Run state of block action buttons, keyed `${blockId}:${label}`. */
+    actionState: Record<string, "running" | "done" | "failed">;
+    /** A message typed while a turn was running; sent when the turn finishes. */
+    queued: string | null;
+    /** Session token totals, accumulated from provider usage reports. */
+    usage: {
+        input: number;
+        output: number;
+        requests: number;
+    };
+}
+type Listener = () => void;
+export declare const askBuoyStore: {
+    getState: () => AskBuoyState;
+    subscribe(fn: Listener): () => void;
+    setLedger(ledger: EffectLedger | null): void;
+    getLedger(): EffectLedger | null;
+    holdSession(session: AskBuoySession, signature: string): void;
+    getHeldSession(): {
+        session: AskBuoySession;
+        signature: string;
+    } | null;
+    setNotice(notice: string | null): void;
+    setConfigured(configured: boolean): void;
+    addUser(text: string): void;
+    /** Mark a turn as running without adding a bubble — the retry path. */
+    beginTurn(): void;
+    /** Park a message typed mid-turn instead of silently dropping it. */
+    setQueued(text: string | null): void;
+    /** Drop one message — the failed assistant bubble a retry replaces. */
+    removeMessage(id: string): void;
+    /** The user answered (or skipped) an Ask block. */
+    recordAnswer(answer: BlockAnswer): void;
+    setActionState(key: string, value: "running" | "done" | "failed" | null): void;
+    /** Open a new assistant bubble for the turn that is about to stream. */
+    startAssistant(): string;
+    /**
+     * Fold one engine event into the open assistant message.
+     *
+     * Tool calls render as rows inside the bubble rather than as raw payloads:
+     * the label is already domain-flavoured ("Set points to 1500"), which is the
+     * only form a non-developer can actually check.
+     */
+    applyEvent(messageId: string, ev: TurnEvent): void;
+    finishAssistant(messageId: string): void;
+    askApproval(input: Omit<PendingApproval, "resolve">): Promise<boolean>;
+    answerApproval(approved: boolean): void;
+    reset(): void;
+};
+export {};
+//# sourceMappingURL=askBuoyStore.d.ts.map

package/lib/typescript/store/askBuoyStore.d.ts.map

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

package/lib/typescript/store/useAskBuoy.d.ts

@@ -0,0 +1,22 @@
+import { type BlockAction, type BlockAnswer } from "@buoy-gg/agent-core";
+import { type AskBuoyState } from "./askBuoyStore";
+import type { AskBuoyConfig } from "../types";
+export declare function useAskBuoyState(): AskBuoyState;
+export interface AskBuoyController {
+    state: AskBuoyState;
+    send: (text: string) => void;
+    stop: () => void;
+    reset: () => void;
+    approve: (approved: boolean) => void;
+    /** Re-send the last user message after a failed turn. */
+    retry: () => void;
+    /** Answer an Ask block: locks it and sends the answer as the next message. */
+    answer: (answer: BlockAnswer) => void;
+    /** Run a block button that dispatches a Buoy action or sends a message. */
+    runAction: (action: BlockAction, blockId: string) => Promise<void>;
+    configured: boolean;
+    /** How many Buoy tools the agent can reach on this device. */
+    toolCount: number;
+}
+export declare function useAskBuoy(config: AskBuoyConfig | undefined): AskBuoyController;
+//# sourceMappingURL=useAskBuoy.d.ts.map

package/lib/typescript/store/useAskBuoy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAskBuoy.d.ts","sourceRoot":"","sources":["../../../src/store/useAskBuoy.ts"],"names":[],"mappings":"AAuBA,OAAO,EAML,KAAK,WAAW,EAChB,KAAK,WAAW,EAEjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAI9C,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,yDAAyD;IACzD,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,8EAA8E;IAC9E,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IACtC,2EAA2E;IAC3E,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,UAAU,EAAE,OAAO,CAAC;IACpB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,iBAAiB,CAoS/E"}

package/lib/typescript/sync/askBuoySyncAdapter.d.ts

@@ -0,0 +1,73 @@
+export declare const ASK_BUOY_ADAPTER_VERSION = 1;
+export declare const askBuoySyncAdapter: {
+    version: number;
+    getSnapshot(): {
+        version: number;
+        busy: boolean;
+        configured: boolean;
+        notice: string | null;
+        messageCount: number;
+        messages: {
+            id: string;
+            role: "user" | "assistant";
+            text: string;
+            streaming: boolean;
+            toolCalls: {
+                toolId: string;
+                action: string;
+                status: "running" | "failed" | "ok" | "refused";
+            }[];
+        }[];
+        usage: {
+            input: number;
+            output: number;
+            requests: number;
+        };
+        pendingApproval: {
+            toolId: string;
+            action: string;
+            label: string;
+        } | null;
+        changes: {
+            reversible: number;
+            permanent: number;
+            transients: number;
+            items: {
+                kind: "network-override" | "impersonation" | "storage-write" | "state-write" | "transient";
+                label: string;
+            }[];
+        };
+    };
+    subscribe(onChange: () => void): () => void;
+    actions: {
+        /** What the agent changed, and whether it can be put back. */
+        listChanges: () => {
+            id: string;
+            at: number;
+            toolId: string;
+            action: string;
+            kind: "network-override" | "impersonation" | "storage-write" | "state-write" | "transient";
+            label: string;
+            reversible: boolean;
+        }[];
+        /** Put back everything that can be put back. Safe direction only. */
+        undoAll: () => Promise<{
+            ok: boolean;
+            error: string;
+        } | {
+            reverted: number;
+            failed: {
+                label: string;
+                error: string;
+            }[];
+            skippedTransients: number;
+            ok: boolean;
+            error?: undefined;
+        }>;
+        /** Clear the transcript and the ledger. Does not undo anything. */
+        reset: () => {
+            ok: boolean;
+        };
+    };
+};
+//# sourceMappingURL=askBuoySyncAdapter.d.ts.map

package/lib/typescript/sync/askBuoySyncAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"askBuoySyncAdapter.d.ts","sourceRoot":"","sources":["../../../src/sync/askBuoySyncAdapter.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAiDT,MAAM,IAAI;;QAU5B,8DAA8D;;;;;;;;;;QAgB9D,qEAAqE;;;;;;;;;;;;;;QAQrE,mEAAmE;;;;;CAMtE,CAAC"}

package/lib/typescript/sync/askBuoySyncAdapter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=askBuoySyncAdapter.test.d.ts.map

package/lib/typescript/sync/askBuoySyncAdapter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"askBuoySyncAdapter.test.d.ts","sourceRoot":"","sources":["../../../src/sync/askBuoySyncAdapter.test.ts"],"names":[],"mappings":""}

package/lib/typescript/sync/wire.d.ts

@@ -0,0 +1,17 @@
+/**
+ * What the sync adapter is allowed to put on the broker wire.
+ *
+ * The broker has no authentication, `cors.origin: "*"`, binds every interface,
+ * and forwards to every connected dashboard — it already broadcasts each
+ * device's license key to every socket. A chat transcript is not a safe thing
+ * to add to that channel unfiltered: the agent reads storage values, network
+ * response bodies and user records, and any of it can end up quoted in an
+ * answer.
+ *
+ * So text crossing the wire is scrubbed for the shapes that are unambiguously
+ * credentials. This is a reduction in blast radius, not a guarantee — the real
+ * guarantee is that tool RESULTS never cross at all (see askBuoySyncAdapter).
+ */
+export { dispatchToolAction } from "@buoy-gg/shared-ui";
+export declare function redactForWire(text: string): string;
+//# sourceMappingURL=wire.d.ts.map

package/lib/typescript/sync/wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../../src/sync/wire.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAcxD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOlD"}

package/lib/typescript/types.d.ts

@@ -0,0 +1,119 @@
+/**
+ * The `ask-buoy` prop on <FloatingDevTools>.
+ *
+ * The shape of this config IS the security model. Buoy holds no model
+ * credential of its own — not in the bundle, not in storage, not on the sync
+ * wire — because `headers` is a callback the HOST APP owns. The QA person is
+ * already signed into the app; the app hands the agent its own session token;
+ * the company's gateway authorises and meters per user. Nothing to leak,
+ * nothing to rotate, nothing that shows up in a decompiled binary.
+ *
+ * That is why `endpoint` is required and `apiKey` is documented dev-only: a key
+ * pasted into app config is inlined into the JS bundle in plaintext, which is
+ * OWASP Mobile's #1 risk and not something to make convenient.
+ */
+import type { ContextPack, AskBuoyPolicy, ToolDescriptor, TurnEvent } from "@buoy-gg/agent-core";
+export interface AskBuoyConfig {
+    /**
+     * The company's own LLM gateway. Buoy POSTs the conversation here and never
+     * anywhere else — no request ever reaches Buoy infrastructure.
+     */
+    endpoint: string;
+    /** Which request/response shape the endpoint speaks. @default "anthropic" */
+    protocol?: "anthropic" | "openai";
+    /** Model id passed through to the endpoint. */
+    model: string;
+    /**
+     * Headers for each request, resolved fresh every time so a short-lived token
+     * from the app's own auth works. This is the intended way to authenticate:
+     * the app's credential, the company's gateway, Buoy in the middle holding
+     * nothing.
+     */
+    headers?: () => Record<string, string> | Promise<Record<string, string>>;
+    /**
+     * A provider key, sent straight to the provider.
+     *
+     * DEV ONLY. Anything you put here is compiled into the JS bundle in
+     * plaintext and ships to every install. Use `headers` + your own gateway for
+     * anything a tester or a customer will ever run.
+     */
+    apiKey?: string;
+    /** @default 4096 */
+    maxTokens?: number;
+    /** Anthropic API version header. Ignored when `protocol` is "openai". */
+    anthropicVersion?: string;
+    /**
+     * Extra fields merged into every request body, last — `temperature`, a
+     * gateway's routing hints, whatever the endpoint demands that this config
+     * doesn't model. Core fields win only if you don't override them.
+     */
+    requestOverrides?: Record<string, unknown>;
+    /**
+     * What the agent may do without asking. Default: reads and writes auto-run
+     * (a banner shows what changed, Undo reverses what can be reversed), and
+     * DESTRUCTIVE actions wait for a tap on an approval card. Pass
+     * `requireApproval: []` for full auto-run on a dev device that is yours.
+     */
+    policy?: AskBuoyPolicy;
+    /**
+     * What this app's data MEANS, and the exact shapes of what the agent may
+     * write — the single highest-leverage thing you can give it. Buoy derives
+     * the rest (routes, query keys, store names, storage keys) by observing the
+     * app, but only their NAMES: the digest carries no values and no shapes.
+     *
+     * `types` matters most for creating the FIRST of something. The agent reads
+     * a live instance and copies its fields when it can, but an empty cart has
+     * no shape to copy, and that is precisely when it is asked to add a line.
+     *
+     * @example
+     * context: {
+     *   notes: ["user.rewards.points = loyalty points"],
+     *   types: { CartLine: "{ lineId: string; itemId: string; qty: number }" },
+     * }
+     */
+    context?: ContextPack;
+    /** Shown in the sheet header and to the model. @default the app name */
+    appName?: string;
+    /**
+     * When the agent navigates or taps, the sheet drops to a short strip for a
+     * couple of seconds so the user SEES the app do it, then springs back.
+     * "Show me what a gold member sees" is meaningless if the sheet covers the
+     * screen it just navigated to. Default true; set false to keep the sheet
+     * fixed (the Peek chip in the transcript still minimizes on demand).
+     */
+    peek?: boolean;
+    /**
+     * Observability tap: every engine event — tool starts and results, blocks,
+     * approvals, errors, per-request token usage — as it happens, so a company
+     * can log agent activity to its own systems and meter cost per seat. Called
+     * synchronously on the JS thread; keep it cheap and never throw (throws are
+     * swallowed so a logging bug can't take the chat down).
+     */
+    onEvent?: (event: TurnEvent) => void;
+    /**
+     * Descriptors for YOUR custom tools, so the agent can drive them too.
+     *
+     * A custom tool registered with a sync adapter is dispatchable as
+     * `custom:<id>` — but the agent only offers what's in its catalog, so
+     * without a descriptor your tool is invisible to the chat while remaining
+     * fully drivable from MCP. Each descriptor's `toolId` must match the
+     * registered id (`custom:<id>`), and its actions get the same param
+     * validation, policy gates and release-truth refusals as the built-ins.
+     *
+     * @example
+     * tools: [{
+     *   toolId: "custom:feature-flags",
+     *   title: "Feature flags",
+     *   summary: "Read and set this app's feature flags.",
+     *   actions: [{
+     *     action: "setFlag",
+     *     summary: "Turn one feature flag on or off.",
+     *     params: { type: "object", properties: { name: { type: "string" }, on: { type: "boolean" } }, required: ["name", "on"] },
+     *     effect: "write",
+     *     release: "works",
+     *   }],
+     * }]
+     */
+    tools?: ToolDescriptor[];
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEjG,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;IAElC,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEzE;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,oBAAoB;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE3C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;IAEvB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IAEtB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAErC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;CAC1B"}

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@buoy-gg/ask-buoy",
+  "version": "7.0.33",
+  "description": "Ask Buoy - an in-app AI chat that drives every Buoy devtool, powered by your own model endpoint",
+  "main": "lib/commonjs/index.js",
+  "module": "lib/module/index.js",
+  "types": "lib/typescript/index.d.ts",
+  "react-native": "lib/module/index.js",
+  "source": "src/index.tsx",
+  "files": [
+    "lib"
+  ],
+  "sideEffects": [
+    "./src/index.tsx",
+    "./lib/commonjs/index.js",
+    "./lib/module/index.js"
+  ],
+  "keywords": [
+    "react-native",
+    "devtools",
+    "ai",
+    "chat",
+    "agent",
+    "buoy"
+  ],
+  "dependencies": {
+    "@buoy-gg/floating-tools-core": "^7.0.33",
+    "@buoy-gg/agent-core": "^7.0.33",
+    "@buoy-gg/shared-ui": "^7.0.33"
+  },
+  "peerDependencies": {
+    "@buoy-gg/license": "7.0.33",
+    "react": "*",
+    "react-native": "*",
+    "@buoy-gg/core": "^7.0.33"
+  },
+  "peerDependenciesMeta": {
+    "@buoy-gg/core": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^19.1.0",
+    "@types/react-native": "^0.73.0",
+    "typescript": "~5.8.3",
+    "@buoy-gg/core": "^7.0.33",
+    "@buoy-gg/license": "^7.0.33"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LovesWorking/react-native-buoy.git",
+    "directory": "packages/ask-buoy"
+  },
+  "bugs": {
+    "url": "https://github.com/LovesWorking/react-native-buoy/issues"
+  },
+  "homepage": "https://github.com/LovesWorking/react-native-buoy/tree/main/packages/ask-buoy#readme",
+  "publishConfig": {
+    "access": "public",
+    "tag": "latest"
+  },
+  "scripts": {
+    "build": "bob build",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf lib",
+    "test": "pnpm run typecheck",
+    "postinstall": "echo \"Run pnpm build to compile this package\""
+  }
+}