@honcho-ai/core 1.2.0 → 1.4.0

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,27 @@ 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,
+    });
+  }
+
+  /**
+   * Get available summaries for a session.
+   *
+   * Returns both short and long summaries if available, including metadata like the
+   * message ID they cover up to, creation timestamp, and token count.
+   */
+  summaries(
+    workspaceId: string,
+    sessionId: string,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<SessionSummariesResponse> {
+    return this._client.get(`/v2/workspaces/${workspaceId}/sessions/${sessionId}/summaries`, options);
   }
 }
 
@@ -192,7 +204,120 @@ export interface SessionGetContextResponse {
 
   messages: Array<MessagesAPI.Message>;
 
-  summary: string;
+  /**
+   * The summary if available
+   */
+  summary?: SessionGetContextResponse.Summary | null;
+}
+
+export namespace SessionGetContextResponse {
+  /**
+   * The summary if available
+   */
+  export interface Summary {
+    /**
+     * The summary text
+     */
+    content: string;
+
+    /**
+     * The timestamp of when the summary was created (ISO format)
+     */
+    created_at: string;
+
+    /**
+     * The ID of the message that this summary covers up to
+     */
+    message_id: number;
+
+    /**
+     * The type of summary (short or long)
+     */
+    summary_type: string;
+
+    /**
+     * The number of tokens in the summary text
+     */
+    token_count: number;
+  }
+}
+
+export type SessionSearchResponse = Array<MessagesAPI.Message>;
+
+export interface SessionSummariesResponse {
+  id: string;
+
+  /**
+   * The long summary if available
+   */
+  long_summary?: SessionSummariesResponse.LongSummary | null;
+
+  /**
+   * The short summary if available
+   */
+  short_summary?: SessionSummariesResponse.ShortSummary | null;
+}
+
+export namespace SessionSummariesResponse {
+  /**
+   * The long summary if available
+   */
+  export interface LongSummary {
+    /**
+     * The summary text
+     */
+    content: string;
+
+    /**
+     * The timestamp of when the summary was created (ISO format)
+     */
+    created_at: string;
+
+    /**
+     * The ID of the message that this summary covers up to
+     */
+    message_id: number;
+
+    /**
+     * The type of summary (short or long)
+     */
+    summary_type: string;
+
+    /**
+     * The number of tokens in the summary text
+     */
+    token_count: number;
+  }
+
+  /**
+   * The short summary if available
+   */
+  export interface ShortSummary {
+    /**
+     * The summary text
+     */
+    content: string;
+
+    /**
+     * The timestamp of when the summary was created (ISO format)
+     */
+    created_at: string;
+
+    /**
+     * The ID of the message that this summary covers up to
+     */
+    message_id: number;
+
+    /**
+     * The type of summary (short or long)
+     */
+    summary_type: string;
+
+    /**
+     * The number of tokens in the summary text
+     */
+    token_count: number;
+  }
 }
 
 export interface SessionUpdateParams {
@@ -205,7 +330,7 @@ export interface SessionListParams extends PageParams {
   /**
    * Body param:
    */
-  filter?: { [key: string]: unknown } | null;
+  filters?: { [key: string]: unknown } | null;
 }
 
 export interface SessionCloneParams {
@@ -217,12 +342,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 +360,38 @@ export interface SessionGetOrCreateParams {
 
   metadata?: { [key: string]: unknown } | null;
 
-  peers?: { [key: string]: SessionGetOrCreateParams.Peers } | null;
+  peers?: { [key: string]: PeersAPI.SessionPeerConfig } | 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;
-  }
-}
-
-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
    */
-  semantic?: boolean | null;
+  filters?: { [key: string]: unknown } | null;
+
+  /**
+   * Number of results to return
+   */
+  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,
+    type SessionSummariesResponse as SessionSummariesResponse,
     SessionsPage as SessionsPage,
     type SessionUpdateParams as SessionUpdateParams,
     type SessionListParams as SessionListParams,
@@ -298,8 +415,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 +425,3 @@ export declare namespace Sessions {
     type PeerSetConfigParams as PeerSetConfigParams,
   };
 }
-
-export { MessagesPage };

package/src/resources/workspaces/webhooks.ts

@@ -0,0 +1,94 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from "../../resource.js";
+import { isRequestOptions } from "../../core.js";
+import * as Core from "../../core.js";
+import { Page, type PageParams } from "../../pagination.js";
+
+export class Webhooks extends APIResource {
+  /**
+   * List all webhook endpoints, optionally filtered by workspace.
+   */
+  list(
+    workspaceId: string,
+    query?: WebhookListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<WebhookEndpointsPage, WebhookEndpoint>;
+  list(
+    workspaceId: string,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<WebhookEndpointsPage, WebhookEndpoint>;
+  list(
+    workspaceId: string,
+    query: WebhookListParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<WebhookEndpointsPage, WebhookEndpoint> {
+    if (isRequestOptions(query)) {
+      return this.list(workspaceId, {}, query);
+    }
+    return this._client.getAPIList(`/v2/workspaces/${workspaceId}/webhooks`, WebhookEndpointsPage, {
+      query,
+      ...options,
+    });
+  }
+
+  /**
+   * Delete a specific webhook endpoint.
+   */
+  delete(workspaceId: string, endpointId: string, options?: Core.RequestOptions): Core.APIPromise<unknown> {
+    return this._client.delete(`/v2/workspaces/${workspaceId}/webhooks/${endpointId}`, options);
+  }
+
+  /**
+   * Get or create a webhook endpoint URL.
+   */
+  getOrCreate(
+    workspaceId: string,
+    body: WebhookGetOrCreateParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<WebhookEndpoint> {
+    return this._client.post(`/v2/workspaces/${workspaceId}/webhooks`, { body, ...options });
+  }
+
+  /**
+   * Test publishing a webhook event.
+   */
+  testEmit(workspaceId: string, options?: Core.RequestOptions): Core.APIPromise<unknown> {
+    return this._client.get(`/v2/workspaces/${workspaceId}/webhooks/test`, options);
+  }
+}
+
+export class WebhookEndpointsPage extends Page<WebhookEndpoint> {}
+
+export interface WebhookEndpoint {
+  id: string;
+
+  created_at: string;
+
+  url: string;
+
+  workspace_id: string | null;
+}
+
+export type WebhookDeleteResponse = unknown;
+
+export type WebhookTestEmitResponse = unknown;
+
+export interface WebhookListParams extends PageParams {}
+
+export interface WebhookGetOrCreateParams {
+  url: string;
+}
+
+Webhooks.WebhookEndpointsPage = WebhookEndpointsPage;
+
+export declare namespace Webhooks {
+  export {
+    type WebhookEndpoint as WebhookEndpoint,
+    type WebhookDeleteResponse as WebhookDeleteResponse,
+    type WebhookTestEmitResponse as WebhookTestEmitResponse,
+    WebhookEndpointsPage as WebhookEndpointsPage,
+    type WebhookListParams as WebhookListParams,
+    type WebhookGetOrCreateParams as WebhookGetOrCreateParams,
+  };
+}

package/src/resources/workspaces/workspaces.ts

@@ -3,8 +3,19 @@
 import { APIResource } from "../../resource.js";
 import { isRequestOptions } from "../../core.js";
 import * as Core from "../../core.js";
+import * as WebhooksAPI from "./webhooks.js";
+import {
+  WebhookDeleteResponse,
+  WebhookEndpoint,
+  WebhookEndpointsPage,
+  WebhookGetOrCreateParams,
+  WebhookListParams,
+  WebhookTestEmitResponse,
+  Webhooks,
+} from "./webhooks.js";
 import * as PeersAPI from "./peers/peers.js";
 import {
+  PagePeer,
   PageSession,
   Peer,
   PeerChatParams,
@@ -12,6 +23,7 @@ import {
   PeerGetOrCreateParams,
   PeerListParams,
   PeerSearchParams,
+  PeerSearchResponse,
   PeerUpdateParams,
   PeerWorkingRepresentationParams,
   PeerWorkingRepresentationResponse,
@@ -20,7 +32,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 +42,8 @@ import {
   SessionGetOrCreateParams,
   SessionListParams,
   SessionSearchParams,
+  SessionSearchResponse,
+  SessionSummariesResponse,
   SessionUpdateParams,
   Sessions as SessionsAPISessions,
   SessionsPage,
@@ -40,6 +53,7 @@ import { Page, type PageParams } from "../../pagination.js";
 export class Workspaces extends APIResource {
   peers: PeersAPI.Peers = new PeersAPI.Peers(this._client);
   sessions: SessionsAPI.Sessions = new SessionsAPI.Sessions(this._client);
+  webhooks: WebhooksAPI.Webhooks = new WebhooksAPI.Webhooks(this._client);
 
   /**
    * Update a Workspace
@@ -101,7 +115,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 +126,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 +191,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 +218,8 @@ export interface Workspace {
   metadata?: { [key: string]: unknown };
 }
 
+export type WorkspaceSearchResponse = Array<MessagesAPI.Message>;
+
 export interface WorkspaceUpdateParams {
   configuration?: { [key: string]: unknown } | null;
 
@@ -203,7 +230,7 @@ export interface WorkspaceListParams extends PageParams {
   /**
    * Body param:
    */
-  filter?: { [key: string]: unknown } | null;
+  filters?: { [key: string]: unknown } | null;
 }
 
 export interface WorkspaceDeriverStatusParams {
@@ -231,11 +258,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;
@@ -243,11 +280,15 @@ Workspaces.Peers = Peers;
 Workspaces.PeersPage = PeersPage;
 Workspaces.Sessions = SessionsAPISessions;
 Workspaces.SessionsPage = SessionsPage;
+Workspaces.Webhooks = Webhooks;
+Workspaces.WebhookEndpointsPage = WebhookEndpointsPage;
 
 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 +299,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 +320,8 @@ export declare namespace Workspaces {
     type Session as Session,
     type SessionDeleteResponse as SessionDeleteResponse,
     type SessionGetContextResponse as SessionGetContextResponse,
+    type SessionSearchResponse as SessionSearchResponse,
+    type SessionSummariesResponse as SessionSummariesResponse,
     SessionsPage as SessionsPage,
     type SessionUpdateParams as SessionUpdateParams,
     type SessionListParams as SessionListParams,
@@ -285,6 +330,14 @@ export declare namespace Workspaces {
     type SessionGetOrCreateParams as SessionGetOrCreateParams,
     type SessionSearchParams as SessionSearchParams,
   };
-}
 
-export { MessagesPage };
+  export {
+    Webhooks as Webhooks,
+    type WebhookEndpoint as WebhookEndpoint,
+    type WebhookDeleteResponse as WebhookDeleteResponse,
+    type WebhookTestEmitResponse as WebhookTestEmitResponse,
+    WebhookEndpointsPage as WebhookEndpointsPage,
+    type WebhookListParams as WebhookListParams,
+    type WebhookGetOrCreateParams as WebhookGetOrCreateParams,
+  };
+}

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.2.0'; // x-release-please-version
+export const VERSION = '1.4.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.4.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.4.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.4.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map