@buoy-gg/agent-core 7.0.34 → 7.0.36

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

@@ -24,6 +24,25 @@ export interface ToolResult {
     content: string;
     isError?: boolean;
 }
+/**
+ * An Anthropic thinking block, kept verbatim.
+ *
+ * Every current Claude model thinks by DEFAULT, and the API requires the
+ * thinking blocks of the assistant turn that made a tool call to come back
+ * unchanged with the tool results — signature included. Drop them and the
+ * next request is a 400 ("Expected `thinking` or `redacted_thinking`"), which
+ * is every tool-using turn, i.e. all of them. So the adapter captures these
+ * and replays them; nothing else in the engine reads them, and the OpenAI
+ * adapter ignores the field.
+ */
+export type ThinkingBlock = {
+    type: "thinking";
+    thinking: string;
+    signature: string;
+} | {
+    type: "redacted_thinking";
+    data: string;
+};
 export type AgentMessage = {
     role: "user";
     text: string;
@@ -31,10 +50,40 @@ export type AgentMessage = {
     role: "assistant";
     text: string;
     toolCalls?: ToolCall[];
+    thinking?: ThinkingBlock[];
 } | {
     role: "tool-results";
     results: ToolResult[];
 };
+/**
+ * Why a stream ended, and whether what arrived can be acted on.
+ *
+ * `completed` is the ONLY value that admits tool calls for execution. The
+ * distinction exists because a truncated response is indistinguishable from a
+ * finished one by content alone: a connection cut after the model emitted
+ * `{"key":"cart","value":[]}` leaves valid JSON and a plausible plan, and the
+ * engine used to run it. See `StreamEvent.error.kind` for the other half.
+ */
+export type StreamOutcome = 
+/** A terminal marker arrived: `message_stop` (Anthropic) or `[DONE]` (OpenAI). */
+"completed"
+/**
+ * Terminal marker arrived, but the model was cut off at `max_tokens` mid-plan.
+ * The text it managed is real; any tool calls in it are half a thought and
+ * are NOT executed.
+ */
+ | "output-limited";
+/**
+ * Why a stream failed. `provider` is the model or gateway saying so; the other
+ * two are this side deciding the response cannot be trusted.
+ */
+export type StreamErrorKind = 
+/** The provider reported it: HTTP error, or an `error` event on a 200. */
+"provider"
+/** The stream ended with no terminal marker. Bare EOF is never success. */
+ | "truncated"
+/** No headers within `connectTimeoutMs`, or no bytes within `idleTimeoutMs`. */
+ | "timeout";
 /** Incremental output from a streaming turn. */
 export type StreamEvent = {
     type: "text";
@@ -43,14 +92,31 @@ export type StreamEvent = {
     type: "tool-call";
     call: ToolCall;
 }
+/** A completed thinking block, to be replayed on the next request. */
+ | {
+    type: "thinking";
+    block: ThinkingBlock;
+}
 /** Mid-stream provider error. Anthropic can emit these on a committed 200. */
  | {
     type: "error";
     message: string;
-} | {
+    kind: StreamErrorKind;
+}
+/**
+ * The stream ended in a state worth acting on. A provider that cannot say
+ * this yields an `error` instead — there is no third way out.
+ *
+ * `model` is the id the provider actually SERVED — `message_start.message.model`
+ * on Anthropic, the chunk's `model` on OpenAI — which differs from the one
+ * requested whenever a gateway resolves an alias to a dated snapshot.
+ */
+ | {
     type: "done";
+    outcome: StreamOutcome;
     stopReason?: string;
     usage?: TokenUsage;
+    model?: string;
 };
 export interface TokenUsage {
     input: number;
@@ -59,8 +125,10 @@ export interface TokenUsage {
      * Anthropic's prompt-cache counters, when the provider reports them.
      * `cacheRead` is the prefix that was served from cache at 0.1x — the whole
      * point of caching — and `cacheWrite` is the prefix stored at 1.25x on the
-     * request that populated it. Both are reported SEPARATELY from `input` by
-     * the API, so a cached request shows a tiny `input` and a large `cacheRead`
+     * request that populated it. On Anthropic both are reported SEPARATELY from
+     * `input`, so a cached request shows a tiny `input` and a large `cacheRead`;
+     * on the OpenAI protocol `cacheRead` (from `prompt_tokens_details.cached_tokens`)
+     * is INCLUDED in `input` — never add the two there. Otherwise a cached request shows a tiny `input` and a large `cacheRead`
      * rather than a smaller `input`; adding them is what gives the real total.
      */
     cacheRead?: number;
@@ -69,6 +137,13 @@ export interface TokenUsage {
 export interface ProviderRequest {
     messages: AgentMessage[];
     system: string;
+    /**
+     * The part of the system prompt that changes every turn — the "right now"
+     * picture of the app (current route, mounted queries, recent requests).
+     * Kept apart from `system` so a provider that caches the stable prefix can
+     * append this AFTER its cache breakpoint instead of invalidating it.
+     */
+    systemVolatile?: string;
     tools: ProviderTool[];
     model: string;
     maxTokens: number;
@@ -107,6 +182,25 @@ export interface ProviderConfig {
      * Set false for a gateway that rejects unknown `cache_control` fields.
      */
     cache?: boolean;
+    /**
+     * How long to wait for response HEADERS before giving up. Default 30s.
+     *
+     * There was no clock here at all: a gateway that accepted the socket and
+     * never replied left the turn spinning until someone pressed Stop, with the
+     * thinking strip still animating. A timeout is not a retry — nothing is
+     * re-sent, because a request that may have reached the model is not safe to
+     * duplicate.
+     */
+    connectTimeoutMs?: number;
+    /**
+     * How long to wait between BYTES once the stream is open. Default 90s.
+     *
+     * Deliberately generous. Anthropic sends `ping` frames, but an OpenAI-protocol
+     * reasoning model can legitimately produce nothing for a long stretch while
+     * it thinks, and cutting that off looks exactly like a broken product. Only
+     * total silence counts — any frame, including a keepalive comment, resets it.
+     */
+    idleTimeoutMs?: number;
     /**
      * Extra fields merged into every request BODY, last — `temperature`, a
      * gateway's routing hints, whatever the endpoint demands that this config
@@ -115,6 +209,25 @@ export interface ProviderConfig {
      * stream) win only if you don't override them, so use with care.
      */
     requestOverrides?: Record<string, unknown>;
+    /**
+     * How to send the request: `fetch`, `xhr`, or `auto` (the default).
+     *
+     * `auto` starts with `fetch` and switches to XHR for the rest of the session
+     * if that first response turns out to have no readable body — which is React
+     * Native's own `fetch`, and every runtime without `expo/fetch` installed as
+     * the global. Pin it to `"xhr"` in a bare-RN app to stream from the very
+     * first reply instead of the second; pin it to `"fetch"` to rule XHR out.
+     * See providers/transport.ts for why the choice cannot be made later.
+     */
+    transport?: "fetch" | "xhr" | "auto";
+    /**
+     * The fetch to send requests with. Default: the global one. A harness
+     * passes its own so a network interceptor that wraps the global fetch
+     * stays off model traffic (it would otherwise capture — and could
+     * override — the agent's own requests), and so it can keep every request
+     * body it sent.
+     */
+    fetch?: typeof fetch;
 }
 export interface Provider {
     readonly protocol: "anthropic" | "openai";

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/providers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,oEAAoE;AACpE,MAAM,WAAW,QAAQ;IACvB,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC;AAEpD,gDAAgD;AAChD,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE;AACvC,8EAA8E;GAC5E;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,CAAA;CAAE,CAAC;AAE9D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzE,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC1C;;;;;OAKG;IACH,IAAI,CAAC,GAAG,EAAE,eAAe,GAAG,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;CACrE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/providers/types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/providers/xhrStream.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Streaming over `XMLHttpRequest`, for the runtimes where `fetch` cannot.
+ *
+ * React Native core still has no `response.body`: its `fetch` is the whatwg
+ * polyfill over XHR and resolves inside `xhr.onload`, i.e. after the ENTIRE
+ * body. Under Expo the global is `expo/fetch`, which does stream — but
+ * `EXPO_PUBLIC_USE_RN_FETCH=1` reverts that, and the bare-RN CLI, TV CLI and
+ * NativeScript lanes never had it at all. On those, every Ask Buoy answer
+ * appeared in one lump, however long the model took.
+ *
+ * XHR itself has streamed the whole time. `responseText` grows as bytes arrive
+ * and `onprogress` fires as it does, so slicing from the last offset gives the
+ * same incremental text a reader would. Two conditions, both easy to miss:
+ * the progress handler must be installed BEFORE `send()`, and `responseType`
+ * must stay text — anything else stops RN emitting progress at all.
+ *
+ * WHAT THIS IS NOT. It is not a second SSE parser: framing, the truncation
+ * rule and the terminal-marker contract all live in `sse.ts` and are shared
+ * verbatim. This file only produces text chunks.
+ */
+import { type SseEvent, type SseReadOptions } from "./sse";
+export interface XhrStreamRequest {
+    url: string;
+    headers: Record<string, string>;
+    body: string;
+    signal?: AbortSignal;
+}
+export interface XhrStreamResponse {
+    status: number;
+    ok: boolean;
+    contentType: string;
+    /** Whole body, for the non-2xx and not-a-stream paths. Reads what arrived. */
+    text(): Promise<string>;
+    frames(options?: SseReadOptions): AsyncGenerator<SseEvent, void, void>;
+}
+export declare function xhrAvailable(): boolean;
+/**
+ * Send the request and resolve once the HEADERS are in, so the caller can
+ * check the status and content type before deciding to read a stream — the
+ * same shape `fetch` offers, and the reason this can slot in beside it.
+ */
+export declare function xhrStream(req: XhrStreamRequest): Promise<XhrStreamResponse>;
+//# sourceMappingURL=xhrStream.d.ts.map

package/lib/typescript/providers/xhrStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xhrStream.d.ts","sourceRoot":"","sources":["../../../src/providers/xhrStream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAc,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAKvE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,MAAM,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;CACxE;AAED,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA+K3E"}

package/lib/typescript/session.d.ts

@@ -1,7 +1,8 @@
 import { type TurnEvent } from "./engine/runAgentTurn";
 import { type ContextPack } from "./engine/systemPrompt";
 import { EffectLedger } from "./effects/ledger";
-import type { AgentMessage, ProviderConfig } from "./providers/types";
+import { compressConsumed, trimHistory, trimHistoryReport } from "./engine/historyBudget";
+import type { AgentMessage, Provider, ProviderConfig } from "./providers/types";
 import { type AskBuoyPolicy } from "./policy/policy";
 import type { DispatchFn, SnapshotFn, ToolDescriptor } from "./types";
 export interface AskBuoySessionConfig extends ProviderConfig {
@@ -26,6 +27,12 @@ export interface AskBuoySessionConfig extends ProviderConfig {
     /** Override the built-in catalog. Tests and the desktop port use this. */
     catalog?: ToolDescriptor[];
     requestApproval?: RunApproval;
+    /**
+     * A ready-made provider, injected by tests and benches — a scripted one,
+     * or a real adapter wrapped for capture. Otherwise the session builds one
+     * from `protocol` and the ProviderConfig fields.
+     */
+    provider?: Provider;
 }
 type RunApproval = (input: {
     id: string;
@@ -34,10 +41,20 @@ type RunApproval = (input: {
     label: string;
     description: string;
     reason: string;
+    /** The call itself — see `RunInput.requestApproval` for why it travels. */
+    params: Record<string, unknown>;
+    /** Fingerprint of the target at ask time — see `readTargetDigest`. */
+    targetDigest?: string;
 }) => Promise<boolean>;
 export interface AskBuoySession {
     readonly ledger: EffectLedger;
     readonly messages: AgentMessage[];
+    /**
+     * Reinstate a conversation from a previous run of the app, so the model
+     * remembers what was said before a reload or a crash. The history is
+     * sanitised first — see `resumableHistory`.
+     */
+    restore(history: AgentMessage[]): void;
     /** Probe the app for grounding. Safe to call more than once. */
     prime(): Promise<void>;
     /**
@@ -50,9 +67,53 @@ export interface AskBuoySession {
      * separate store and kept rendering. Update in place instead.
      */
     setAvailableActions(actions: Record<string, string[]>): void;
+    /**
+     * Turn this device's approval cards off, or back on.
+     *
+     * A DEVICE preference ("stop asking me"), not app policy — which is why it
+     * is a setter rather than a field on the config. The session is held across
+     * close and reopen so the conversation and the undo ledger survive, so a
+     * value captured when it was built could not be changed afterwards without
+     * throwing both away.
+     *
+     * It suppresses approval GATES only. `deny`, `allow`, `readOnly` and the
+     * release-build refusals are the app saying no, not the app asking a
+     * question, and a "stop asking" toggle must never widen what the agent can
+     * reach.
+     */
+    setApprovalBypass(enabled: boolean): void;
+    /**
+     * The device's "look, don't touch" toggle.
+     *
+     * Effective policy is app read-only OR device read-only: this can only
+     * NARROW what the agent may do, never widen it — turning the device toggle
+     * off cannot switch off an app that configured `policy.readOnly`. Takes
+     * effect on the next call, including the remaining calls of a turn already
+     * running: the engine reads the policy object per call, and this mutates
+     * that object in place rather than handing the engine a new one at the next
+     * turn.
+     */
+    setReadOnly(enabled: boolean): void;
     send(text: string, signal?: AbortSignal): AsyncGenerator<TurnEvent, void, void>;
     reset(): void;
 }
+/**
+ * A stored history, made safe to send as the start of a new request.
+ *
+ * Two things make a saved conversation unusable as-is.
+ *
+ * A history captured mid-turn ends with an assistant message whose `tool_use`
+ * blocks were never answered, or with the `tool_result`s and no reply after
+ * them. Every provider rejects both: the blocks must pair up. So this rewinds
+ * to the last COMPLETE round — an assistant message that made no tool calls,
+ * which is where a conversation is always safe to resume from.
+ *
+ * And thinking blocks are dropped. Anthropic needs them replayed only when the
+ * very next thing sent is that turn's `tool_result`s; a restored conversation
+ * always resumes with a fresh user message instead, so their signatures are
+ * dead weight at best and a stale-signature 400 at worst.
+ */
+export { compressConsumed, trimHistory, trimHistoryReport };
+export declare function resumableHistory(history: AgentMessage[]): AgentMessage[];
 export declare function createAskBuoySession(config: AskBuoySessionConfig): AskBuoySession;
-export {};
 //# sourceMappingURL=session.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"AAWA,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,OAAO,KAAK,EAAE,YAAY,EAAY,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAA0B,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE7E,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEtE,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,QAAQ,EAAE,WAAW,GAAG,QAAQ,CAAC;IACjC,QAAQ,EAAE,UAAU,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,KAAK,WAAW,GAAG,CAAC,KAAK,EAAE;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEvB,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC;IAClC,gEAAgE;IAChE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB;;;;;;;;OAQG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAChF,KAAK,IAAI,IAAI,CAAC;CACf;AAsCD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAqHjF"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/agent-core",
-  "version": "7.0.34",
+  "version": "7.0.36",
   "description": "Headless agent core for Ask Buoy - the tool catalog, BYO-model providers, turn loop and effect ledger that let an LLM drive Buoy devtools",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -43,7 +43,7 @@
   "bugs": {
     "url": "https://github.com/LovesWorking/react-native-buoy/issues"
   },
-  "homepage": "https://github.com/LovesWorking/react-native-buoy/tree/main/packages/agent-core#readme",
+  "homepage": "https://buoy.gg/buoy/latest/docs/tools/ask-buoy",
   "publishConfig": {
     "access": "public",
     "tag": "latest"