doover-js 0.4.7 → 0.4.9

package/dist/apis/messages-api.d.ts

@@ -28,5 +28,6 @@ export declare class MessagesApi {
     patchMessage(agentId: string, channelName: string, messageId: string, body: MessageBody, params?: MessageMutationParams): Promise<unknown>;
     deleteMessage(agentId: string, channelName: string, messageId: string): Promise<unknown>;
     getMessageAttachment(agentId: string, channelName: string, messageId: string, attachmentId: string): Promise<Blob>;
+    getInvocationLogs<TLog = unknown>(agentId: string, channelName: string, messageId: string): Promise<TLog[]>;
     createMultipartPayload(jsonPayload: Record<string, unknown>, attachments: Array<Blob | File>): FormData;
 }

package/dist/apis/messages-api.js

@@ -33,6 +33,9 @@ class MessagesApi {
     getMessageAttachment(agentId, channelName, messageId, attachmentId) {
         return this.rest.get(`/agents/${agentId}/channels/${channelName}/messages/${messageId}/attachments/${attachmentId}`);
     }
+    getInvocationLogs(agentId, channelName, messageId) {
+        return this.rest.get(`/agents/${agentId}/channels/${channelName}/messages/${messageId}/logs`);
+    }
     createMultipartPayload(jsonPayload, attachments) {
         const formData = new FormData();
         formData.set("json_payload", JSON.stringify(jsonPayload));

package/dist/react/index.d.ts

@@ -17,6 +17,8 @@ export { useChannelMessages, channelMessagesQueryKey, } from "./useChannelMessag
 export type { UseChannelMessagesOptions, UseChannelMessagesResult, } from "./useChannelMessages";
 export { useChannelMessage, channelMessageQueryKey, } from "./useChannelMessage";
 export type { UseChannelMessageOptions, UseChannelMessageResult, } from "./useChannelMessage";
+export { useInvocationLogs, invocationLogsQueryKey, } from "./useInvocationLogs";
+export type { UseInvocationLogsOptions } from "./useInvocationLogs";
 export { useSendRpc } from "./useSendRpc";
 export type { RpcCommandId, RpcStatusEvent, SendRpcVariables, UseSendRpcOptions, UseSendRpcResult, } from "./useSendRpc";
 export { useMultiAgentAggregates, multiAgentAggregatesQueryKey, } from "./useMultiAgentAggregates";

package/dist/react/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resetSharedQueryClient = exports.getSharedQueryClient = exports.useTurnCredentials = exports.multiAgentChannelMessagesQueryKey = exports.useMultiAgentChannelMessages = exports.multiAgentAggregatesQueryKey = exports.useMultiAgentAggregates = exports.useSendRpc = exports.channelMessageQueryKey = exports.useChannelMessage = exports.channelMessagesQueryKey = exports.useChannelMessages = exports.useUpdateMessage = exports.useUpdateAggregate = exports.useSendMessage = exports.useAgentChannel = exports.channelAggregateQueryKey = exports.useChannelAggregate = exports.useChannelSubscription = exports.agentConnectionsQueryKey = exports.useAgentConnections = exports.useConnectionState = exports.useDooverClient = exports.DooverProvider = void 0;
+exports.resetSharedQueryClient = exports.getSharedQueryClient = exports.useTurnCredentials = exports.multiAgentChannelMessagesQueryKey = exports.useMultiAgentChannelMessages = exports.multiAgentAggregatesQueryKey = exports.useMultiAgentAggregates = exports.useSendRpc = exports.invocationLogsQueryKey = exports.useInvocationLogs = exports.channelMessageQueryKey = exports.useChannelMessage = exports.channelMessagesQueryKey = exports.useChannelMessages = exports.useUpdateMessage = exports.useUpdateAggregate = exports.useSendMessage = exports.useAgentChannel = exports.channelAggregateQueryKey = exports.useChannelAggregate = exports.useChannelSubscription = exports.agentConnectionsQueryKey = exports.useAgentConnections = exports.useConnectionState = exports.useDooverClient = exports.DooverProvider = void 0;
 var context_1 = require("./context");
 Object.defineProperty(exports, "DooverProvider", { enumerable: true, get: function () { return context_1.DooverProvider; } });
 Object.defineProperty(exports, "useDooverClient", { enumerable: true, get: function () { return context_1.useDooverClient; } });
@@ -28,6 +28,9 @@ Object.defineProperty(exports, "channelMessagesQueryKey", { enumerable: true, ge
 var useChannelMessage_1 = require("./useChannelMessage");
 Object.defineProperty(exports, "useChannelMessage", { enumerable: true, get: function () { return useChannelMessage_1.useChannelMessage; } });
 Object.defineProperty(exports, "channelMessageQueryKey", { enumerable: true, get: function () { return useChannelMessage_1.channelMessageQueryKey; } });
+var useInvocationLogs_1 = require("./useInvocationLogs");
+Object.defineProperty(exports, "useInvocationLogs", { enumerable: true, get: function () { return useInvocationLogs_1.useInvocationLogs; } });
+Object.defineProperty(exports, "invocationLogsQueryKey", { enumerable: true, get: function () { return useInvocationLogs_1.invocationLogsQueryKey; } });
 var useSendRpc_1 = require("./useSendRpc");
 Object.defineProperty(exports, "useSendRpc", { enumerable: true, get: function () { return useSendRpc_1.useSendRpc; } });
 var useMultiAgentAggregates_1 = require("./useMultiAgentAggregates");

package/dist/react/useChannelMessages.d.ts

@@ -1,7 +1,9 @@
 import { type InfiniteData, type UseInfiniteQueryResult } from "@tanstack/react-query";
 import type { MessageStructure } from "../types/common";
 import type { ChannelIdentifier } from "../types/viewer";
-export declare function channelMessagesQueryKey(agentId: string | undefined, channelName: string | undefined): readonly ["doover", "agent", string | undefined, "channel", string | undefined, "messages"];
+export declare function channelMessagesQueryKey(agentId: string | undefined, channelName: string | undefined, fields?: readonly string[]): readonly ["doover", "agent", string | undefined, "channel", string | undefined, "messages"] | readonly ["doover", "agent", string | undefined, "channel", string | undefined, "messages", {
+    readonly fields: string[];
+}];
 export interface UseChannelMessagesOptions {
     limit?: number;
     /** If false, skip subscribing for live message-create updates. Defaults true. */

package/dist/react/useChannelMessages.js

@@ -6,8 +6,17 @@ const react_1 = require("react");
 const react_query_1 = require("@tanstack/react-query");
 const context_1 = require("./context");
 const useChannelSubscription_1 = require("./useChannelSubscription");
-function channelMessagesQueryKey(agentId, channelName) {
-    return ["doover", "agent", agentId, "channel", channelName, "messages"];
+function channelMessagesQueryKey(agentId, channelName, fields) {
+    const key = ["doover", "agent", agentId, "channel", channelName, "messages"];
+    if (!fields || fields.length === 0)
+        return key;
+    // A `field_name`-filtered request returns a different message stream than
+    // the unfiltered (or differently-filtered) one, so it must live under its
+    // own cache entry — otherwise one filter's pagination cursor leaks into
+    // another's `getNextPageParam`, and the "next page" fetch ends up anchored
+    // to an unrelated (often much older) message id. Sort so call-site argument
+    // order doesn't fragment the cache.
+    return [...key, { fields: [...fields].sort() }];
 }
 /**
  * Paginated infinite query over `DooverDataProvider.getMessages`, with live
@@ -24,8 +33,19 @@ function useChannelMessages(identifier, options) {
     const initialBefore = options?.initialBefore;
     const after = options?.after;
     const autoPaginate = options?.autoPaginate ?? false;
-    const key = channelMessagesQueryKey(agentId, channelName);
+    const key = channelMessagesQueryKey(agentId, channelName, fields);
     const onMessage = (0, react_1.useCallback)((message) => {
+        // This cache entry is scoped to `fields`; the gateway delivers every
+        // message on the channel, so drop live pushes whose payload doesn't
+        // carry one of those fields rather than letting them pollute it.
+        if (fields && fields.length > 0) {
+            const data = message.data;
+            if (!data ||
+                typeof data !== "object" ||
+                !fields.some((f) => f in data)) {
+                return;
+            }
+        }
         queryClient.setQueryData(key, (current) => {
             if (!current)
                 return current;
@@ -39,7 +59,7 @@ function useChannelMessages(identifier, options) {
         });
     }, 
     // eslint-disable-next-line react-hooks/exhaustive-deps
-    [queryClient, agentId, channelName]);
+    [queryClient, agentId, channelName, fields?.join(",")]);
     (0, useChannelSubscription_1.useChannelSubscription)(liveUpdates ? identifier : undefined, { onMessage });
     const query = (0, react_query_1.useInfiniteQuery)({
         queryKey: key,

package/dist/react/useInvocationLogs.d.ts

@@ -0,0 +1,23 @@
+import { type UseQueryResult } from "@tanstack/react-query";
+import type { ChannelIdentifier } from "../types/viewer";
+export declare function invocationLogsQueryKey(agentId: string | undefined, channelName: string | undefined, messageId: string | undefined): readonly ["doover", "agent", string | undefined, "channel", string | undefined, "message", string | undefined, "logs"];
+export interface UseInvocationLogsOptions {
+    /** Defaults to true. Set false to skip the query (e.g. dialog closed). */
+    enabled?: boolean;
+    /**
+     * react-query retry behaviour. Defaults to false — the logs endpoint
+     * commonly 404s while logs are still materialising server-side, and a
+     * manual refetch button is friendlier than silent retry.
+     */
+    retry?: boolean | number;
+}
+/**
+ * Fetch the log entries for a single invocation message. The `/logs`
+ * endpoint is only meaningful for invocation messages (channel name like
+ * `dv-proc-inv-…`); other message types return 404.
+ *
+ * Generic on `TLog` — the shape of a single log entry. Defaults to `unknown`
+ * because log payloads are domain-specific (lambda telemetry, app-level
+ * structured logs, etc.) and doover-js does not own the canonical shape.
+ */
+export declare function useInvocationLogs<TLog = unknown>(identifier: ChannelIdentifier, messageId: string | undefined, options?: UseInvocationLogsOptions): UseQueryResult<TLog[]>;

package/dist/react/useInvocationLogs.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invocationLogsQueryKey = invocationLogsQueryKey;
+exports.useInvocationLogs = useInvocationLogs;
+const react_query_1 = require("@tanstack/react-query");
+const context_1 = require("./context");
+function invocationLogsQueryKey(agentId, channelName, messageId) {
+    return [
+        "doover",
+        "agent",
+        agentId,
+        "channel",
+        channelName,
+        "message",
+        messageId,
+        "logs",
+    ];
+}
+/**
+ * Fetch the log entries for a single invocation message. The `/logs`
+ * endpoint is only meaningful for invocation messages (channel name like
+ * `dv-proc-inv-…`); other message types return 404.
+ *
+ * Generic on `TLog` — the shape of a single log entry. Defaults to `unknown`
+ * because log payloads are domain-specific (lambda telemetry, app-level
+ * structured logs, etc.) and doover-js does not own the canonical shape.
+ */
+function useInvocationLogs(identifier, messageId, options) {
+    const client = (0, context_1.useDooverClient)();
+    const { agentId, channelName } = identifier;
+    return (0, react_query_1.useQuery)({
+        queryKey: invocationLogsQueryKey(agentId, channelName, messageId),
+        queryFn: () => client.messages.getInvocationLogs(agentId, channelName, messageId),
+        enabled: !!agentId &&
+            !!channelName &&
+            !!messageId &&
+            (options?.enabled ?? true),
+        retry: options?.retry ?? false,
+        staleTime: Infinity,
+    });
+}

package/dist/test/react.test.js

@@ -336,6 +336,42 @@ function wrapper(client) {
         });
         await (0, react_1.waitFor)(() => (0, chai_1.expect)(result.current.data?.response?.status).to.equal("success"));
     });
+    (0, mocha_1.it)("useInvocationLogs fetches logs for the message", async () => {
+        const messageId = (0, snowflake_1.generateSnowflakeIdAtTime)(new Date("2026-01-01T00:00:00.000Z"));
+        const fetchMock = (0, helpers_1.createFetchMock)(() => (0, helpers_1.createJsonResponse)([
+            { level: "INFO", message: "hello", timestamp: 1 },
+            { level: "ERROR", message: "boom", timestamp: 2 },
+        ]));
+        const client = new doover_client_1.DooverClient({
+            dataRestUrl: "https://api.example.com",
+            controlApiUrl: "https://control.example.com",
+            dataWssUrl: "wss://ws.example.com",
+            fetchImpl: fetchMock,
+            webSocketImpl: helpers_1.MockWebSocket,
+            disableBrowserLifecycleHooks: true,
+        });
+        const { result } = (0, react_1.renderHook)(() => (0, react_2.useInvocationLogs)({ agentId: "a1", channelName: "dv-proc-inv-1" }, messageId), { wrapper: wrapper(client) });
+        await (0, react_1.waitFor)(() => (0, chai_1.expect)(result.current.isSuccess).to.equal(true));
+        (0, chai_1.expect)(result.current.data?.map((l) => l.level)).to.deep.equal([
+            "INFO",
+            "ERROR",
+        ]);
+        const requestUrl = fetchMock.firstCall?.args[0];
+        (0, chai_1.expect)(requestUrl).to.contain(`/agents/a1/channels/dv-proc-inv-1/messages/${messageId}/logs`);
+    });
+    (0, mocha_1.it)("useInvocationLogs is disabled when messageId is undefined", () => {
+        const fetchMock = (0, helpers_1.createFetchMock)(() => (0, helpers_1.createJsonResponse)([]));
+        const client = new doover_client_1.DooverClient({
+            dataRestUrl: "https://api.example.com",
+            controlApiUrl: "https://control.example.com",
+            dataWssUrl: "wss://ws.example.com",
+            fetchImpl: fetchMock,
+            webSocketImpl: helpers_1.MockWebSocket,
+            disableBrowserLifecycleHooks: true,
+        });
+        (0, react_1.renderHook)(() => (0, react_2.useInvocationLogs)({ agentId: "a1", channelName: "dv-proc-inv-1" }, undefined), { wrapper: wrapper(client) });
+        (0, chai_1.expect)(fetchMock.callCount).to.equal(0);
+    });
     (0, mocha_1.it)("getSharedQueryClient returns the same QueryClient across callers", () => {
         (0, react_2.resetSharedQueryClient)();
         const a = (0, react_2.getSharedQueryClient)();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "doover-js",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "description": "TypeScript client for Doover.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",