@honcho-ai/core 1.8.0 → 2.1.0

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

@@ -10,7 +10,7 @@ import { type PageParams } from "../../../pagination.js";
 
 export class Peers extends APIResource {
   /**
-   * Get peers from a session
+   * Get all Peers in a Session. Results are paginated.
    */
   list(
     workspaceId: string,
@@ -39,7 +39,8 @@ export class Peers extends APIResource {
   }
 
   /**
-   * Add peers to a session
+   * Add Peers to a Session. If a Peer does not yet exist, it will be created
+   * automatically.
    */
   add(
     workspaceId: string,
@@ -54,9 +55,9 @@ export class Peers extends APIResource {
   }
 
   /**
-   * Get the configuration for a peer in a session
+   * Get the configuration for a Peer in a Session.
    */
-  getConfig(
+  config(
     workspaceId: string,
     sessionId: string,
     peerId: string,
@@ -69,7 +70,7 @@ export class Peers extends APIResource {
   }
 
   /**
-   * Remove peers from a session
+   * Remove Peers by ID from a Session.
    */
   remove(
     workspaceId: string,
@@ -84,7 +85,10 @@ export class Peers extends APIResource {
   }
 
   /**
-   * Set the peers in a session
+   * Set the Peers in a Session. If a Peer does not yet exist, it will be created
+   * automatically.
+   *
+   * This will fully replace the current set of Peers in the Session.
    */
   set(
     workspaceId: string,
@@ -99,7 +103,7 @@ export class Peers extends APIResource {
   }
 
   /**
-   * Set the configuration for a peer in a session
+   * Set the configuration for a Peer in a Session.
    */
   setConfig(
     workspaceId: string,
@@ -107,17 +111,18 @@ export class Peers extends APIResource {
     peerId: string,
     body: PeerSetConfigParams,
     options?: Core.RequestOptions,
-  ): Core.APIPromise<unknown> {
-    return this._client.post(`/v2/workspaces/${workspaceId}/sessions/${sessionId}/peers/${peerId}/config`, {
+  ): Core.APIPromise<void> {
+    return this._client.put(`/v2/workspaces/${workspaceId}/sessions/${sessionId}/peers/${peerId}/config`, {
       body,
       ...options,
+      headers: { Accept: '*/*', ...options?.headers },
     });
   }
 }
 
 export interface SessionPeerConfig {
   /**
-   * Whether honcho should form a global theory-of-mind representation of this peer
+   * Whether Honcho will use reasoning to form a representation of this peer
    */
   observe_me?: boolean | null;
 
@@ -128,8 +133,6 @@ export interface SessionPeerConfig {
   observe_others?: boolean | null;
 }
 
-export type PeerSetConfigResponse = unknown;
-
 export interface PeerListParams extends PageParams {}
 
 export type PeerAddParams = { [key: string]: SessionPeerConfig };
@@ -140,7 +143,7 @@ export type PeerSetParams = { [key: string]: SessionPeerConfig };
 
 export interface PeerSetConfigParams {
   /**
-   * Whether honcho should form a global theory-of-mind representation of this peer
+   * Whether Honcho will use reasoning to form a representation of this peer
    */
   observe_me?: boolean | null;
 
@@ -154,7 +157,6 @@ export interface PeerSetConfigParams {
 export declare namespace Peers {
   export {
     type SessionPeerConfig as SessionPeerConfig,
-    type PeerSetConfigResponse as PeerSetConfigResponse,
     type PeerListParams as PeerListParams,
     type PeerAddParams as PeerAddParams,
     type PeerRemoveParams as PeerRemoveParams,

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

@@ -4,7 +4,6 @@ import { APIResource } from "../../../resource.js";
 import { isRequestOptions } from "../../../core.js";
 import * as Core from "../../../core.js";
 import * as WorkspacesAPI from "../workspaces.js";
-import * as PeersAPI from "../peers/peers.js";
 import * as MessagesAPI from "./messages.js";
 import {
   Message,
@@ -18,13 +17,12 @@ import {
   Messages,
   MessagesPage,
 } from "./messages.js";
-import * as SessionsPeersAPI from "./peers.js";
+import * as PeersAPI from "./peers.js";
 import {
   PeerAddParams,
   PeerListParams,
   PeerRemoveParams,
   PeerSetConfigParams,
-  PeerSetConfigResponse,
   PeerSetParams,
   Peers,
   SessionPeerConfig,
@@ -33,10 +31,10 @@ import { Page, type PageParams } from "../../../pagination.js";
 
 export class Sessions extends APIResource {
   messages: MessagesAPI.Messages = new MessagesAPI.Messages(this._client);
-  peers: SessionsPeersAPI.Peers = new SessionsPeersAPI.Peers(this._client);
+  peers: PeersAPI.Peers = new PeersAPI.Peers(this._client);
 
   /**
-   * Update the metadata of a Session
+   * Update a Session's metadata and/or configuration.
    */
   update(
     workspaceId: string,
@@ -48,7 +46,7 @@ export class Sessions extends APIResource {
   }
 
   /**
-   * Get All Sessions in a Workspace
+   * Get all Sessions for a Workspace, paginated with optional filters.
    */
   list(
     workspaceId: string,
@@ -74,11 +72,11 @@ export class Sessions extends APIResource {
   }
 
   /**
-   * Delete a session and all associated data.
+   * Delete a Session and all associated messages.
    *
-   * The session is marked as inactive immediately and returns 202 Accepted. The
-   * actual deletion of all related data (messages, embeddings, documents, etc.)
-   * happens asynchronously via the queue with retry support.
+   * The Session is marked as inactive immediately and returns 202 Accepted. The
+   * actual deletion of all related data happens asynchronously via the queue with
+   * retry support.
    *
    * This action cannot be undone.
    */
@@ -87,57 +85,58 @@ export class Sessions extends APIResource {
   }
 
   /**
-   * Clone a session, optionally up to a specific message
+   * Clone a Session, optionally up to a specific message ID.
    */
   clone(
     workspaceId: string,
     sessionId: string,
-    query?: SessionCloneParams,
+    params?: SessionCloneParams,
     options?: Core.RequestOptions,
   ): Core.APIPromise<Session>;
   clone(workspaceId: string, sessionId: string, options?: Core.RequestOptions): Core.APIPromise<Session>;
   clone(
     workspaceId: string,
     sessionId: string,
-    query: SessionCloneParams | Core.RequestOptions = {},
+    params: SessionCloneParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
   ): Core.APIPromise<Session> {
-    if (isRequestOptions(query)) {
-      return this.clone(workspaceId, sessionId, {}, query);
+    if (isRequestOptions(params)) {
+      return this.clone(workspaceId, sessionId, {}, params);
     }
-    return this._client.get(`/v2/workspaces/${workspaceId}/sessions/${sessionId}/clone`, {
-      query,
+    const { message_id } = params;
+    return this._client.post(`/v2/workspaces/${workspaceId}/sessions/${sessionId}/clone`, {
+      query: { message_id },
       ...options,
     });
   }
 
   /**
-   * Produce a context object from the session. The caller provides an optional token
+   * 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(
+  context(
     workspaceId: string,
     sessionId: string,
-    query?: SessionGetContextParams,
+    query?: SessionContextParams,
     options?: Core.RequestOptions,
-  ): Core.APIPromise<SessionGetContextResponse>;
-  getContext(
+  ): Core.APIPromise<SessionContextResponse>;
+  context(
     workspaceId: string,
     sessionId: string,
     options?: Core.RequestOptions,
-  ): Core.APIPromise<SessionGetContextResponse>;
-  getContext(
+  ): Core.APIPromise<SessionContextResponse>;
+  context(
     workspaceId: string,
     sessionId: string,
-    query: SessionGetContextParams | Core.RequestOptions = {},
+    query: SessionContextParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
-  ): Core.APIPromise<SessionGetContextResponse> {
+  ): Core.APIPromise<SessionContextResponse> {
     if (isRequestOptions(query)) {
-      return this.getContext(workspaceId, sessionId, {}, query);
+      return this.context(workspaceId, sessionId, {}, query);
     }
     return this._client.get(`/v2/workspaces/${workspaceId}/sessions/${sessionId}/context`, {
       query,
@@ -146,10 +145,10 @@ export class Sessions extends APIResource {
   }
 
   /**
-   * Get a specific session in a workspace.
+   * Get a Session by ID or create a new Session with the given ID.
    *
-   * 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 for verification.
+   * If Session ID is provided as a parameter, it verifies the Session is in the
+   * Workspace. Otherwise, it uses the session_id from the JWT for verification.
    */
   getOrCreate(
     workspaceId: string,
@@ -160,7 +159,8 @@ export class Sessions extends APIResource {
   }
 
   /**
-   * Search a Session
+   * Search a Session with optional filters. Use `limit` to control the number of
+   * results returned.
    */
   search(
     workspaceId: string,
@@ -175,7 +175,7 @@ export class Sessions extends APIResource {
   }
 
   /**
-   * Get available summaries for a session.
+   * 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.
@@ -213,22 +213,22 @@ export interface Session {
  */
 export interface SessionConfiguration {
   /**
-   * Configuration for deriver functionality.
-   */
-  deriver?: WorkspacesAPI.DeriverConfiguration | null;
-
-  /**
-   * Configuration for dream functionality. If deriver is disabled, dreams will also
-   * be disabled and these settings will be ignored.
+   * Configuration for dream functionality. If reasoning is disabled, dreams will
+   * also be disabled and these settings will be ignored.
    */
   dream?: WorkspacesAPI.DreamConfiguration | null;
 
   /**
-   * Configuration for peer card functionality. If deriver is disabled, peer cards
+   * Configuration for peer card functionality. If reasoning is disabled, peer cards
    * will also be disabled and these settings will be ignored.
    */
   peer_card?: WorkspacesAPI.PeerCardConfiguration | null;
 
+  /**
+   * Configuration for reasoning functionality.
+   */
+  reasoning?: WorkspacesAPI.ReasoningConfiguration | null;
+
   /**
    * Configuration for summary functionality.
    */
@@ -266,7 +266,7 @@ export interface Summary {
 
 export type SessionDeleteResponse = unknown;
 
-export interface SessionGetContextResponse {
+export interface SessionContextResponse {
   id: string;
 
   messages: Array<MessagesAPI.Message>;
@@ -277,25 +277,10 @@ export interface SessionGetContextResponse {
   peer_card?: Array<string> | null;
 
   /**
-   * A Representation is a traversable and diffable map of observations. At the base,
-   * we have a list of explicit observations, derived from a peer's messages.
-   *
-   * From there, deductive observations can be made by establishing logical
-   * relationships between explicit observations.
-   *
-   * In the future, we can add more levels of reasoning on top of these.
-   *
-   * All of a peer's observations are stored as documents in a collection. These
-   * documents can be queried in various ways to produce this Representation object.
-   *
-   * Additionally, a "working representation" is a version of this data structure
-   * representing the most recent observations within a single session.
-   *
-   * A representation can have a maximum number of observations, which is applied
-   * individually to each level of reasoning. If a maximum is set, observations are
-   * added and removed in FIFO order.
+   * A curated subset of a peer representation, if context is requested from a
+   * specific perspective
    */
-  peer_representation?: PeersAPI.Representation | null;
+  peer_representation?: string | null;
 
   /**
    * The summary if available
@@ -345,15 +330,15 @@ export interface SessionCloneParams {
   message_id?: string | null;
 }
 
-export interface SessionGetContextParams {
+export interface SessionContextParams {
   /**
-   * Only used if `last_message` is provided. Whether to include the most derived
-   * observations in the representation
+   * Only used if `last_message` is provided. Whether to include the most frequent
+   * conclusions in the representation
    */
-  include_most_derived?: boolean;
+  include_most_frequent?: boolean;
 
   /**
-   * The most recent message, used to fetch semantically relevant observations
+   * The most recent message, used to fetch semantically relevant conclusions
    */
   last_message?: string | null;
 
@@ -364,10 +349,10 @@ export interface SessionGetContextParams {
   limit_to_session?: boolean;
 
   /**
-   * Only used if `last_message` is provided. The maximum number of observations to
+   * Only used if `last_message` is provided. The maximum number of conclusions to
    * include in the representation
    */
-  max_observations?: number | null;
+  max_conclusions?: number | null;
 
   /**
    * A peer to get context for. If given, response will attempt to include
@@ -386,13 +371,13 @@ export interface SessionGetContextParams {
 
   /**
    * Only used if `last_message` is provided. The maximum distance to search for
-   * semantically relevant observations
+   * semantically relevant conclusions
    */
   search_max_distance?: number | null;
 
   /**
    * Only used if `last_message` is provided. The number of semantic-search-retrieved
-   * observations to include in the representation
+   * conclusions to include in the representation
    */
   search_top_k?: number | null;
 
@@ -422,7 +407,7 @@ export interface SessionGetOrCreateParams {
 
   metadata?: { [key: string]: unknown } | null;
 
-  peers?: { [key: string]: SessionsPeersAPI.SessionPeerConfig } | null;
+  peers?: { [key: string]: PeersAPI.SessionPeerConfig } | null;
 }
 
 export interface SessionSearchParams {
@@ -453,14 +438,14 @@ export declare namespace Sessions {
     type SessionConfiguration as SessionConfiguration,
     type Summary as Summary,
     type SessionDeleteResponse as SessionDeleteResponse,
-    type SessionGetContextResponse as SessionGetContextResponse,
+    type SessionContextResponse as SessionContextResponse,
     type SessionSearchResponse as SessionSearchResponse,
     type SessionSummariesResponse as SessionSummariesResponse,
     SessionsPage as SessionsPage,
     type SessionUpdateParams as SessionUpdateParams,
     type SessionListParams as SessionListParams,
     type SessionCloneParams as SessionCloneParams,
-    type SessionGetContextParams as SessionGetContextParams,
+    type SessionContextParams as SessionContextParams,
     type SessionGetOrCreateParams as SessionGetOrCreateParams,
     type SessionSearchParams as SessionSearchParams,
   };
@@ -481,7 +466,6 @@ export declare namespace Sessions {
   export {
     Peers as Peers,
     type SessionPeerConfig as SessionPeerConfig,
-    type PeerSetConfigResponse as PeerSetConfigResponse,
     type PeerListParams as PeerListParams,
     type PeerAddParams as PeerAddParams,
     type PeerRemoveParams as PeerRemoveParams,

package/src/resources/workspaces/webhooks.ts

@@ -35,8 +35,11 @@ export class Webhooks extends APIResource {
   /**
    * 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);
+  delete(workspaceId: string, endpointId: string, options?: Core.RequestOptions): Core.APIPromise<void> {
+    return this._client.delete(`/v2/workspaces/${workspaceId}/webhooks/${endpointId}`, {
+      ...options,
+      headers: { Accept: '*/*', ...options?.headers },
+    });
   }
 
   /**
@@ -70,8 +73,6 @@ export interface WebhookEndpoint {
   workspace_id: string | null;
 }
 
-export type WebhookDeleteResponse = unknown;
-
 export type WebhookTestEmitResponse = unknown;
 
 export interface WebhookListParams extends PageParams {}
@@ -85,7 +86,6 @@ 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,