@honcho-ai/core 1.2.0 → 1.3.0

package/src/resources/workspaces/peers/peers.ts

@@ -6,7 +6,6 @@ import * as Core from "../../../core.js";
 import * as SessionsAPI from "./sessions.js";
 import { SessionListParams, Sessions } from "./sessions.js";
 import * as MessagesAPI from "../sessions/messages.js";
-import { MessagesPage } from "../sessions/messages.js";
 import * as SessionsSessionsAPI from "../sessions/sessions.js";
 import { Page, type PageParams } from "../../../pagination.js";
 
@@ -67,7 +66,7 @@ export class Peers extends APIResource {
    * Get a Peer by ID
    *
    * If peer_id is provided as a query parameter, it uses that (must match JWT
-   * workspace_id). Otherwise, it uses the peer_id from the JWT token.
+   * workspace_id). Otherwise, it uses the peer_id from the JWT.
    */
   getOrCreate(
     workspaceId: string,
@@ -83,16 +82,10 @@ export class Peers extends APIResource {
   search(
     workspaceId: string,
     peerId: string,
-    params: PeerSearchParams,
+    body: PeerSearchParams,
     options?: Core.RequestOptions,
-  ): Core.PagePromise<MessagesPage, MessagesAPI.Message> {
-    const { page, size, ...body } = params;
-    return this._client.getAPIList(`/v2/workspaces/${workspaceId}/peers/${peerId}/search`, MessagesPage, {
-      query: { page, size },
-      body,
-      method: 'post',
-      ...options,
-    });
+  ): Core.APIPromise<PeerSearchResponse> {
+    return this._client.post(`/v2/workspaces/${workspaceId}/peers/${peerId}/search`, { body, ...options });
   }
 
   /**
@@ -118,6 +111,18 @@ export class Peers extends APIResource {
 
 export class PeersPage extends Page<Peer> {}
 
+export interface PagePeer {
+  items: Array<Peer>;
+
+  page: number;
+
+  size: number;
+
+  pages?: number;
+
+  total?: number;
+}
+
 export interface PageSession {
   items: Array<SessionsSessionsAPI.Session>;
 
@@ -143,13 +148,15 @@ export interface Peer {
 }
 
 export interface SessionGet {
-  filter?: { [key: string]: unknown } | null;
+  filters?: { [key: string]: unknown } | null;
 }
 
 export interface PeerChatResponse {
   content: string;
 }
 
+export type PeerSearchResponse = Array<MessagesAPI.Message>;
+
 export type PeerWorkingRepresentationResponse = { [key: string]: unknown };
 
 export interface PeerUpdateParams {
@@ -162,7 +169,7 @@ export interface PeerListParams extends PageParams {
   /**
    * Body param:
    */
-  filter?: { [key: string]: unknown } | null;
+  filters?: { [key: string]: unknown } | null;
 }
 
 export interface PeerChatParams {
@@ -192,16 +199,21 @@ export interface PeerGetOrCreateParams {
   metadata?: { [key: string]: unknown } | null;
 }
 
-export interface PeerSearchParams extends PageParams {
+export interface PeerSearchParams {
   /**
-   * Body param: Search query
+   * Search query
    */
   query: string;
 
   /**
-   * Body param: Whether to explicitly use semantic search to filter the results
+   * Filters to scope the search
    */
-  semantic?: boolean | null;
+  filters?: { [key: string]: unknown } | null;
+
+  /**
+   * Number of results to return
+   */
+  limit?: number;
 }
 
 export interface PeerWorkingRepresentationParams {
@@ -222,10 +234,12 @@ Peers.Sessions = Sessions;
 
 export declare namespace Peers {
   export {
+    type PagePeer as PagePeer,
     type PageSession as PageSession,
     type Peer as Peer,
     type SessionGet as SessionGet,
     type PeerChatResponse as PeerChatResponse,
+    type PeerSearchResponse as PeerSearchResponse,
     type PeerWorkingRepresentationResponse as PeerWorkingRepresentationResponse,
     PeersPage as PeersPage,
     type PeerUpdateParams as PeerUpdateParams,
@@ -238,5 +252,3 @@ export declare namespace Peers {
 
   export { Sessions as Sessions, type SessionListParams as SessionListParams };
 }
-
-export { MessagesPage };

package/src/resources/workspaces/peers/sessions.ts

@@ -45,7 +45,7 @@ export interface SessionListParams extends PageParams {
   /**
    * Body param:
    */
-  filter?: { [key: string]: unknown } | null;
+  filters?: { [key: string]: unknown } | null;
 }
 
 export declare namespace Sessions {

package/src/resources/workspaces/sessions/index.ts

@@ -14,7 +14,7 @@ export {
 } from "./messages.js";
 export {
   Peers,
-  type PeerGetConfigResponse,
+  type SessionPeerConfig,
   type PeerSetConfigResponse,
   type PeerListParams,
   type PeerAddParams,
@@ -28,6 +28,7 @@ export {
   type Session,
   type SessionDeleteResponse,
   type SessionGetContextResponse,
+  type SessionSearchResponse,
   type SessionUpdateParams,
   type SessionListParams,
   type SessionCloneParams,

package/src/resources/workspaces/sessions/messages.ts

@@ -111,7 +111,7 @@ export interface Message {
 
   peer_id: string;
 
-  session_id: string | null;
+  session_id: string;
 
   token_count: number;
 
@@ -149,7 +149,7 @@ export interface MessageListParams extends PageParams {
   /**
    * Body param:
    */
-  filter?: { [key: string]: unknown } | null;
+  filters?: { [key: string]: unknown } | null;
 }
 
 export interface MessageUploadParams {

package/src/resources/workspaces/sessions/peers.ts

@@ -61,7 +61,7 @@ export class Peers extends APIResource {
     sessionId: string,
     peerId: string,
     options?: Core.RequestOptions,
-  ): Core.APIPromise<PeerGetConfigResponse> {
+  ): Core.APIPromise<SessionPeerConfig> {
     return this._client.get(
       `/v2/workspaces/${workspaceId}/sessions/${sessionId}/peers/${peerId}/config`,
       options,
@@ -115,7 +115,7 @@ export class Peers extends APIResource {
   }
 }
 
-export interface PeerGetConfigResponse {
+export interface SessionPeerConfig {
   /**
    * Whether other peers in this session should try to form a session-level
    * theory-of-mind representation of this peer
@@ -133,43 +133,11 @@ export type PeerSetConfigResponse = unknown;
 
 export interface PeerListParams extends PageParams {}
 
-export type PeerAddParams = { [key: string]: PeerAddParams.Body };
-
-export namespace PeerAddParams {
-  export interface Body {
-    /**
-     * Whether other peers in this session should try to form a session-level
-     * theory-of-mind representation of this peer
-     */
-    observe_me?: boolean | null;
-
-    /**
-     * Whether this peer should form a session-level theory-of-mind representation of
-     * other peers in the session
-     */
-    observe_others?: boolean;
-  }
-}
+export type PeerAddParams = { [key: string]: SessionPeerConfig };
 
 export type PeerRemoveParams = Array<string>;
 
-export type PeerSetParams = { [key: string]: PeerSetParams.Body };
-
-export namespace PeerSetParams {
-  export interface Body {
-    /**
-     * Whether other peers in this session should try to form a session-level
-     * theory-of-mind representation of this peer
-     */
-    observe_me?: boolean | null;
-
-    /**
-     * Whether this peer should form a session-level theory-of-mind representation of
-     * other peers in the session
-     */
-    observe_others?: boolean;
-  }
-}
+export type PeerSetParams = { [key: string]: SessionPeerConfig };
 
 export interface PeerSetConfigParams {
   /**
@@ -187,7 +155,7 @@ export interface PeerSetConfigParams {
 
 export declare namespace Peers {
   export {
-    type PeerGetConfigResponse as PeerGetConfigResponse,
+    type SessionPeerConfig as SessionPeerConfig,
     type PeerSetConfigResponse as PeerSetConfigResponse,
     type PeerListParams as PeerListParams,
     type PeerAddParams as PeerAddParams,

package/src/resources/workspaces/sessions/sessions.ts

@@ -19,13 +19,13 @@ import {
 import * as PeersAPI from "./peers.js";
 import {
   PeerAddParams,
-  PeerGetConfigResponse,
   PeerListParams,
   PeerRemoveParams,
   PeerSetConfigParams,
   PeerSetConfigResponse,
   PeerSetParams,
-  Peers as PeersAPIPeers,
+  Peers,
+  SessionPeerConfig,
 } from "./peers.js";
 import { Page, type PageParams } from "../../../pagination.js";
 
@@ -104,11 +104,12 @@ export class Sessions extends APIResource {
   }
 
   /**
-   * Produce a context object from the session. The caller provides a token limit
-   * which the entire context must fit into. To do this, we allocate 40% of the token
-   * limit to the summary, and 60% to recent messages -- as many as can fit. If the
-   * caller does not want a summary, we allocate all the tokens to recent messages.
-   * The default token limit if not provided is 2048. (TODO: make this configurable)
+   * Produce a context object from the session. The caller provides an optional token
+   * limit which the entire context must fit into. If not provided, the context will
+   * be exhaustive (within configured max tokens). To do this, we allocate 40% of the
+   * token limit to the summary, and 60% to recent messages -- as many as can fit.
+   * Note that the summary will usually take up less space than this. If the caller
+   * does not want a summary, we allocate all the tokens to recent messages.
    */
   getContext(
     workspaceId: string,
@@ -140,8 +141,7 @@ export class Sessions extends APIResource {
    * Get a specific session in a workspace.
    *
    * If session_id is provided as a query parameter, it verifies the session is in
-   * the workspace. Otherwise, it uses the session_id from the JWT token for
-   * verification.
+   * the workspace. Otherwise, it uses the session_id from the JWT for verification.
    */
   getOrCreate(
     workspaceId: string,
@@ -157,15 +157,13 @@ export class Sessions extends APIResource {
   search(
     workspaceId: string,
     sessionId: string,
-    params: SessionSearchParams,
+    body: SessionSearchParams,
     options?: Core.RequestOptions,
-  ): Core.PagePromise<MessagesPage, MessagesAPI.Message> {
-    const { page, size, ...body } = params;
-    return this._client.getAPIList(
-      `/v2/workspaces/${workspaceId}/sessions/${sessionId}/search`,
-      MessagesPage,
-      { query: { page, size }, body, method: 'post', ...options },
-    );
+  ): Core.APIPromise<SessionSearchResponse> {
+    return this._client.post(`/v2/workspaces/${workspaceId}/sessions/${sessionId}/search`, {
+      body,
+      ...options,
+    });
   }
 }
 
@@ -195,6 +193,8 @@ export interface SessionGetContextResponse {
   summary: string;
 }
 
+export type SessionSearchResponse = Array<MessagesAPI.Message>;
+
 export interface SessionUpdateParams {
   configuration?: { [key: string]: unknown } | null;
 
@@ -205,7 +205,7 @@ export interface SessionListParams extends PageParams {
   /**
    * Body param:
    */
-  filter?: { [key: string]: unknown } | null;
+  filters?: { [key: string]: unknown } | null;
 }
 
 export interface SessionCloneParams {
@@ -217,12 +217,13 @@ export interface SessionCloneParams {
 
 export interface SessionGetContextParams {
   /**
-   * Whether to summarize the session history prior to the cutoff message
+   * Whether or not to include a summary _if_ one is available for the session
    */
   summary?: boolean;
 
   /**
-   * Number of tokens to use for the context. Includes summary if set to true
+   * Number of tokens to use for the context. Includes summary if set to true. If not
+   * provided, the context will be exhaustive (within 100000 tokens)
    */
   tokens?: number | null;
 }
@@ -234,47 +235,37 @@ export interface SessionGetOrCreateParams {
 
   metadata?: { [key: string]: unknown } | null;
 
-  peers?: { [key: string]: SessionGetOrCreateParams.Peers } | null;
-}
-
-export namespace SessionGetOrCreateParams {
-  export interface Peers {
-    /**
-     * Whether other peers in this session should try to form a session-level
-     * theory-of-mind representation of this peer
-     */
-    observe_me?: boolean | null;
-
-    /**
-     * Whether this peer should form a session-level theory-of-mind representation of
-     * other peers in the session
-     */
-    observe_others?: boolean;
-  }
+  peers?: { [key: string]: PeersAPI.SessionPeerConfig } | null;
 }
 
-export interface SessionSearchParams extends PageParams {
+export interface SessionSearchParams {
   /**
-   * Body param: Search query
+   * Search query
    */
   query: string;
 
   /**
-   * Body param: Whether to explicitly use semantic search to filter the results
+   * Filters to scope the search
+   */
+  filters?: { [key: string]: unknown } | null;
+
+  /**
+   * Number of results to return
    */
-  semantic?: boolean | null;
+  limit?: number;
 }
 
 Sessions.SessionsPage = SessionsPage;
 Sessions.Messages = Messages;
 Sessions.MessagesPage = MessagesPage;
-Sessions.Peers = PeersAPIPeers;
+Sessions.Peers = Peers;
 
 export declare namespace Sessions {
   export {
     type Session as Session,
     type SessionDeleteResponse as SessionDeleteResponse,
     type SessionGetContextResponse as SessionGetContextResponse,
+    type SessionSearchResponse as SessionSearchResponse,
     SessionsPage as SessionsPage,
     type SessionUpdateParams as SessionUpdateParams,
     type SessionListParams as SessionListParams,
@@ -298,8 +289,8 @@ export declare namespace Sessions {
   };
 
   export {
-    PeersAPIPeers as Peers,
-    type PeerGetConfigResponse as PeerGetConfigResponse,
+    Peers as Peers,
+    type SessionPeerConfig as SessionPeerConfig,
     type PeerSetConfigResponse as PeerSetConfigResponse,
     type PeerListParams as PeerListParams,
     type PeerAddParams as PeerAddParams,
@@ -308,5 +299,3 @@ export declare namespace Sessions {
     type PeerSetConfigParams as PeerSetConfigParams,
   };
 }
-
-export { MessagesPage };

package/src/resources/workspaces/workspaces.ts

@@ -5,6 +5,7 @@ import { isRequestOptions } from "../../core.js";
 import * as Core from "../../core.js";
 import * as PeersAPI from "./peers/peers.js";
 import {
+  PagePeer,
   PageSession,
   Peer,
   PeerChatParams,
@@ -12,6 +13,7 @@ import {
   PeerGetOrCreateParams,
   PeerListParams,
   PeerSearchParams,
+  PeerSearchResponse,
   PeerUpdateParams,
   PeerWorkingRepresentationParams,
   PeerWorkingRepresentationResponse,
@@ -20,7 +22,6 @@ import {
   SessionGet,
 } from "./peers/peers.js";
 import * as MessagesAPI from "./sessions/messages.js";
-import { MessagesPage } from "./sessions/messages.js";
 import * as SessionsAPI from "./sessions/sessions.js";
 import {
   Session,
@@ -31,6 +32,7 @@ import {
   SessionGetOrCreateParams,
   SessionListParams,
   SessionSearchParams,
+  SessionSearchResponse,
   SessionUpdateParams,
   Sessions as SessionsAPISessions,
   SessionsPage,
@@ -101,7 +103,7 @@ export class Workspaces extends APIResource {
    * Get a Workspace by ID.
    *
    * If workspace_id is provided as a query parameter, it uses that (must match JWT
-   * workspace_id). Otherwise, it uses the workspace_id from the JWT token.
+   * workspace_id). Otherwise, it uses the workspace_id from the JWT.
    */
   getOrCreate(body: WorkspaceGetOrCreateParams, options?: Core.RequestOptions): Core.APIPromise<Workspace> {
     return this._client.post('/v2/workspaces', { body, ...options });
@@ -112,16 +114,10 @@ export class Workspaces extends APIResource {
    */
   search(
     workspaceId: string,
-    params: WorkspaceSearchParams,
+    body: WorkspaceSearchParams,
     options?: Core.RequestOptions,
-  ): Core.PagePromise<MessagesPage, MessagesAPI.Message> {
-    const { body, page, size } = params;
-    return this._client.getAPIList(`/v2/workspaces/${workspaceId}/search`, MessagesPage, {
-      query: { page, size },
-      body: body,
-      method: 'post',
-      ...options,
-    });
+  ): Core.APIPromise<WorkspaceSearchResponse> {
+    return this._client.post(`/v2/workspaces/${workspaceId}/search`, { body, ...options });
   }
 }
 
@@ -183,6 +179,23 @@ export namespace DeriverStatus {
   }
 }
 
+export interface MessageSearchOptions {
+  /**
+   * Search query
+   */
+  query: string;
+
+  /**
+   * Filters to scope the search
+   */
+  filters?: { [key: string]: unknown } | null;
+
+  /**
+   * Number of results to return
+   */
+  limit?: number;
+}
+
 export interface Workspace {
   id: string;
 
@@ -193,6 +206,8 @@ export interface Workspace {
   metadata?: { [key: string]: unknown };
 }
 
+export type WorkspaceSearchResponse = Array<MessagesAPI.Message>;
+
 export interface WorkspaceUpdateParams {
   configuration?: { [key: string]: unknown } | null;
 
@@ -203,7 +218,7 @@ export interface WorkspaceListParams extends PageParams {
   /**
    * Body param:
    */
-  filter?: { [key: string]: unknown } | null;
+  filters?: { [key: string]: unknown } | null;
 }
 
 export interface WorkspaceDeriverStatusParams {
@@ -231,11 +246,21 @@ export interface WorkspaceGetOrCreateParams {
   metadata?: { [key: string]: unknown };
 }
 
-export interface WorkspaceSearchParams extends PageParams {
+export interface WorkspaceSearchParams {
   /**
-   * Body param: Search query
+   * Search query
    */
-  body: string;
+  query: string;
+
+  /**
+   * Filters to scope the search
+   */
+  filters?: { [key: string]: unknown } | null;
+
+  /**
+   * Number of results to return
+   */
+  limit?: number;
 }
 
 Workspaces.WorkspacesPage = WorkspacesPage;
@@ -247,7 +272,9 @@ Workspaces.SessionsPage = SessionsPage;
 export declare namespace Workspaces {
   export {
     type DeriverStatus as DeriverStatus,
+    type MessageSearchOptions as MessageSearchOptions,
     type Workspace as Workspace,
+    type WorkspaceSearchResponse as WorkspaceSearchResponse,
     WorkspacesPage as WorkspacesPage,
     type WorkspaceUpdateParams as WorkspaceUpdateParams,
     type WorkspaceListParams as WorkspaceListParams,
@@ -258,10 +285,12 @@ export declare namespace Workspaces {
 
   export {
     Peers as Peers,
+    type PagePeer as PagePeer,
     type PageSession as PageSession,
     type Peer as Peer,
     type SessionGet as SessionGet,
     type PeerChatResponse as PeerChatResponse,
+    type PeerSearchResponse as PeerSearchResponse,
     type PeerWorkingRepresentationResponse as PeerWorkingRepresentationResponse,
     PeersPage as PeersPage,
     type PeerUpdateParams as PeerUpdateParams,
@@ -277,6 +306,7 @@ export declare namespace Workspaces {
     type Session as Session,
     type SessionDeleteResponse as SessionDeleteResponse,
     type SessionGetContextResponse as SessionGetContextResponse,
+    type SessionSearchResponse as SessionSearchResponse,
     SessionsPage as SessionsPage,
     type SessionUpdateParams as SessionUpdateParams,
     type SessionListParams as SessionListParams,
@@ -286,5 +316,3 @@ export declare namespace Workspaces {
     type SessionSearchParams as SessionSearchParams,
   };
 }
-
-export { MessagesPage };

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.2.0'; // x-release-please-version
+export const VERSION = '1.3.0'; // x-release-please-version

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.2.0";
+export declare const VERSION = "1.3.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '1.2.0'; // x-release-please-version
+exports.VERSION = '1.3.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '1.2.0'; // x-release-please-version
+export const VERSION = '1.3.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map