@honcho-ai/core 1.4.0 → 1.5.0

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

@@ -50,6 +50,31 @@ export class Peers extends APIResource {
     });
   }
 
+  /**
+   * Get a peer card for a specific peer relationship.
+   *
+   * Returns the peer card that the observer peer has for the target peer if it
+   * exists. If no target is specified, returns the observer's own peer card.
+   */
+  card(
+    workspaceId: string,
+    peerId: string,
+    query?: PeerCardParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<PeerCardResponse>;
+  card(workspaceId: string, peerId: string, options?: Core.RequestOptions): Core.APIPromise<PeerCardResponse>;
+  card(
+    workspaceId: string,
+    peerId: string,
+    query: PeerCardParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<PeerCardResponse> {
+    if (isRequestOptions(query)) {
+      return this.card(workspaceId, peerId, {}, query);
+    }
+    return this._client.get(`/v2/workspaces/${workspaceId}/peers/${peerId}/card`, { query, ...options });
+  }
+
   /**
    * Chat
    */
@@ -94,7 +119,7 @@ export class Peers extends APIResource {
    * If a session_id is provided in the body, we get the working representation of
    * the peer in that session. If a target is provided, we get the representation of
    * the target from the perspective of the peer. If no target is provided, we get
-   * the global representation of the peer.
+   * the omniscient Honcho representation of the peer.
    */
   workingRepresentation(
     workspaceId: string,
@@ -151,6 +176,13 @@ export interface SessionGet {
   filters?: { [key: string]: unknown } | null;
 }
 
+export interface PeerCardResponse {
+  /**
+   * The peer card content, or None if not found
+   */
+  peer_card?: Array<string> | null;
+}
+
 export interface PeerChatResponse {
   content: string;
 }
@@ -172,6 +204,14 @@ export interface PeerListParams extends PageParams {
   filters?: { [key: string]: unknown } | null;
 }
 
+export interface PeerCardParams {
+  /**
+   * The peer whose card to retrieve. If not provided, returns the observer's own
+   * card
+   */
+  target?: string | null;
+}
+
 export interface PeerChatParams {
   /**
    * Dialectic API Prompt
@@ -220,7 +260,7 @@ export interface PeerWorkingRepresentationParams {
   /**
    * Get the working representation within this session
    */
-  session_id: string;
+  session_id?: string | null;
 
   /**
    * Optional peer ID to get the representation for, from the perspective of this
@@ -238,12 +278,14 @@ export declare namespace Peers {
     type PageSession as PageSession,
     type Peer as Peer,
     type SessionGet as SessionGet,
+    type PeerCardResponse as PeerCardResponse,
     type PeerChatResponse as PeerChatResponse,
     type PeerSearchResponse as PeerSearchResponse,
     type PeerWorkingRepresentationResponse as PeerWorkingRepresentationResponse,
     PeersPage as PeersPage,
     type PeerUpdateParams as PeerUpdateParams,
     type PeerListParams as PeerListParams,
+    type PeerCardParams as PeerCardParams,
     type PeerChatParams as PeerChatParams,
     type PeerGetOrCreateParams as PeerGetOrCreateParams,
     type PeerSearchParams as PeerSearchParams,

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

@@ -26,6 +26,7 @@ export {
   SessionsPage,
   Sessions,
   type Session,
+  type Summary,
   type SessionDeleteResponse,
   type SessionGetContextResponse,
   type SessionSearchResponse,

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

@@ -197,6 +197,33 @@ export interface Session {
   metadata?: { [key: string]: unknown };
 }
 
+export interface Summary {
+  /**
+   * The summary text
+   */
+  content: string;
+
+  /**
+   * The timestamp of when the summary was created (ISO format)
+   */
+  created_at: string;
+
+  /**
+   * The public ID of the message that this summary covers up to
+   */
+  message_id: string;
+
+  /**
+   * The type of summary (short or long)
+   */
+  summary_type: string;
+
+  /**
+   * The number of tokens in the summary text
+   */
+  token_count: number;
+}
+
 export type SessionDeleteResponse = unknown;
 
 export interface SessionGetContextResponse {
@@ -204,41 +231,110 @@ export interface SessionGetContextResponse {
 
   messages: Array<MessagesAPI.Message>;
 
+  /**
+   * The peer card, if context is requested from a specific perspective
+   */
+  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.
+   */
+  peer_representation?: SessionGetContextResponse.PeerRepresentation | null;
+
   /**
    * The summary if available
    */
-  summary?: SessionGetContextResponse.Summary | null;
+  summary?: Summary | null;
 }
 
 export namespace SessionGetContextResponse {
   /**
-   * The summary if available
+   * 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.
    */
-  export interface Summary {
+  export interface PeerRepresentation {
     /**
-     * The summary text
+     * Conclusions that MUST be true given explicit facts and premises - strict logical
+     * necessities. Each deduction should have premises and a single conclusion.
      */
-    content: string;
+    deductive?: Array<PeerRepresentation.Deductive>;
 
     /**
-     * The timestamp of when the summary was created (ISO format)
+     * Facts LITERALLY stated by the user - direct quotes or clear paraphrases only, no
+     * interpretation or inference. Example: ['The user is 25 years old', 'The user has
+     * a dog']
      */
-    created_at: string;
+    explicit?: Array<PeerRepresentation.Explicit>;
+  }
 
+  export namespace PeerRepresentation {
     /**
-     * The ID of the message that this summary covers up to
+     * Deductive observation with multiple premises and one conclusion, plus metadata.
      */
-    message_id: number;
+    export interface Deductive {
+      /**
+       * The deductive conclusion
+       */
+      conclusion: string;
 
-    /**
-     * The type of summary (short or long)
-     */
-    summary_type: string;
+      created_at: string;
+
+      message_ids: Array<Array<unknown>>;
+
+      session_name: string;
+
+      /**
+       * Supporting premises or evidence for this conclusion
+       */
+      premises?: Array<string>;
+    }
 
     /**
-     * The number of tokens in the summary text
+     * Explicit observation with content and metadata.
      */
-    token_count: number;
+    export interface Explicit {
+      /**
+       * The explicit observation
+       */
+      content: string;
+
+      created_at: string;
+
+      message_ids: Array<Array<unknown>>;
+
+      session_name: string;
+    }
   }
 }
 
@@ -250,74 +346,12 @@ export interface SessionSummariesResponse {
   /**
    * The long summary if available
    */
-  long_summary?: SessionSummariesResponse.LongSummary | null;
+  long_summary?: Summary | 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;
-  }
+  short_summary?: Summary | null;
 }
 
 export interface SessionUpdateParams {
@@ -341,14 +375,35 @@ export interface SessionCloneParams {
 }
 
 export interface SessionGetContextParams {
+  /**
+   * The most recent message, used to fetch semantically relevant observations
+   */
+  last_message?: string | null;
+
+  /**
+   * A peer to get context for. If given, response will attempt to include
+   * representation and card from the perspective of that peer. Must be provided with
+   * `peer_target`.
+   */
+  peer_perspective?: string | null;
+
+  /**
+   * The target of the perspective. If given without `peer_perspective`, will get the
+   * Honcho-level representation and peer card for this peer. If given with
+   * `peer_perspective`, will get the representation and card for this peer _from the
+   * perspective of that peer_.
+   */
+  peer_target?: string | null;
+
   /**
    * 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. If not
-   * provided, the context will be exhaustive (within 100000 tokens)
+   * Number of tokens to use for the context. Includes summary if set to true.
+   * Includes representation and peer card if they are included in the response. If
+   * not provided, the context will be exhaustive (within 100000 tokens)
    */
   tokens?: number | null;
 }
@@ -388,6 +443,7 @@ Sessions.Peers = Peers;
 export declare namespace Sessions {
   export {
     type Session as Session,
+    type Summary as Summary,
     type SessionDeleteResponse as SessionDeleteResponse,
     type SessionGetContextResponse as SessionGetContextResponse,
     type SessionSearchResponse as SessionSearchResponse,

package/src/resources/workspaces/workspaces.ts

@@ -18,6 +18,8 @@ import {
   PagePeer,
   PageSession,
   Peer,
+  PeerCardParams,
+  PeerCardResponse,
   PeerChatParams,
   PeerChatResponse,
   PeerGetOrCreateParams,
@@ -47,6 +49,7 @@ import {
   SessionUpdateParams,
   Sessions as SessionsAPISessions,
   SessionsPage,
+  Summary,
 } from "./sessions/sessions.js";
 import { Page, type PageParams } from "../../pagination.js";
 
@@ -303,12 +306,14 @@ export declare namespace Workspaces {
     type PageSession as PageSession,
     type Peer as Peer,
     type SessionGet as SessionGet,
+    type PeerCardResponse as PeerCardResponse,
     type PeerChatResponse as PeerChatResponse,
     type PeerSearchResponse as PeerSearchResponse,
     type PeerWorkingRepresentationResponse as PeerWorkingRepresentationResponse,
     PeersPage as PeersPage,
     type PeerUpdateParams as PeerUpdateParams,
     type PeerListParams as PeerListParams,
+    type PeerCardParams as PeerCardParams,
     type PeerChatParams as PeerChatParams,
     type PeerGetOrCreateParams as PeerGetOrCreateParams,
     type PeerSearchParams as PeerSearchParams,
@@ -318,6 +323,7 @@ export declare namespace Workspaces {
   export {
     SessionsAPISessions as Sessions,
     type Session as Session,
+    type Summary as Summary,
     type SessionDeleteResponse as SessionDeleteResponse,
     type SessionGetContextResponse as SessionGetContextResponse,
     type SessionSearchResponse as SessionSearchResponse,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.4.0'; // x-release-please-version
+export const VERSION = '1.5.0'; // x-release-please-version

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.4.0";
+export declare const VERSION = "1.5.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.4.0'; // x-release-please-version
+exports.VERSION = '1.5.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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