@honcho-ai/core 1.5.1 → 1.6.0

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

@@ -3,11 +3,12 @@
 import { APIResource } from "../../../resource.js";
 import { isRequestOptions } from "../../../core.js";
 import * as Core from "../../../core.js";
+import * as WorkspacesAPI from "../workspaces.js";
 import { Page, type PageParams } from "../../../pagination.js";
 
 export class Messages extends APIResource {
   /**
-   * Create messages for a session with JSON data (original functionality).
+   * Add new message(s) to a session.
    */
   create(
     workspaceId: string,
@@ -125,11 +126,40 @@ export interface MessageCreate {
 
   peer_id: string;
 
+  /**
+   * The set of options that can be in a message DB-level configuration dictionary.
+   *
+   * All fields are optional. Message-level configuration overrides all other
+   * configurations.
+   */
+  configuration?: MessageCreate.Configuration | null;
+
   created_at?: string | null;
 
   metadata?: { [key: string]: unknown } | null;
 }
 
+export namespace MessageCreate {
+  /**
+   * The set of options that can be in a message DB-level configuration dictionary.
+   *
+   * All fields are optional. Message-level configuration overrides all other
+   * configurations.
+   */
+  export interface Configuration {
+    /**
+     * Configuration for deriver functionality.
+     */
+    deriver?: WorkspacesAPI.DeriverConfiguration | null;
+
+    /**
+     * Configuration for peer card functionality. If deriver is disabled, peer cards
+     * will also be disabled and these settings will be ignored.
+     */
+    peer_card?: WorkspacesAPI.PeerCardConfiguration | null;
+  }
+}
+
 export type MessageCreateResponse = Array<Message>;
 
 export type MessageUploadResponse = Array<Message>;
@@ -158,6 +188,12 @@ export interface MessageUploadParams {
   file: Core.Uploadable;
 
   peer_id: string;
+
+  configuration?: string | null;
+
+  created_at?: string | null;
+
+  metadata?: string | null;
 }
 
 Messages.MessagesPage = MessagesPage;

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

@@ -117,8 +117,7 @@ export class Peers extends APIResource {
 
 export interface SessionPeerConfig {
   /**
-   * Whether other peers in this session should try to form a session-level
-   * theory-of-mind representation of this peer
+   * Whether honcho should form a global theory-of-mind representation of this peer
    */
   observe_me?: boolean | null;
 
@@ -126,7 +125,7 @@ export interface SessionPeerConfig {
    * Whether this peer should form a session-level theory-of-mind representation of
    * other peers in the session
    */
-  observe_others?: boolean;
+  observe_others?: boolean | null;
 }
 
 export type PeerSetConfigResponse = unknown;
@@ -141,8 +140,7 @@ export type PeerSetParams = { [key: string]: SessionPeerConfig };
 
 export interface PeerSetConfigParams {
   /**
-   * Whether other peers in this session should try to form a session-level
-   * theory-of-mind representation of this peer
+   * Whether honcho should form a global theory-of-mind representation of this peer
    */
   observe_me?: boolean | null;
 
@@ -150,7 +148,7 @@ export interface PeerSetConfigParams {
    * Whether this peer should form a session-level theory-of-mind representation of
    * other peers in the session
    */
-  observe_others?: boolean;
+  observe_others?: boolean | null;
 }
 
 export declare namespace Peers {

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

@@ -3,6 +3,7 @@
 import { APIResource } from "../../../resource.js";
 import { isRequestOptions } from "../../../core.js";
 import * as Core from "../../../core.js";
+import * as WorkspacesAPI from "../workspaces.js";
 import * as MessagesAPI from "./messages.js";
 import {
   Message,
@@ -72,7 +73,13 @@ export class Sessions extends APIResource {
   }
 
   /**
-   * Delete a session by marking it as inactive
+   * Delete a session and all associated data.
+   *
+   * 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.
+   *
+   * This action cannot be undone.
    */
   delete(workspaceId: string, sessionId: string, options?: Core.RequestOptions): Core.APIPromise<unknown> {
     return this._client.delete(`/v2/workspaces/${workspaceId}/sessions/${sessionId}`, options);
@@ -197,6 +204,38 @@ export interface Session {
   metadata?: { [key: string]: unknown };
 }
 
+/**
+ * The set of options that can be in a session DB-level configuration dictionary.
+ *
+ * All fields are optional. Session-level configuration overrides workspace-level
+ * configuration, which overrides global configuration.
+ */
+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.
+   */
+  dream?: WorkspacesAPI.DreamConfiguration | null;
+
+  /**
+   * Configuration for peer card functionality. If deriver is disabled, peer cards
+   * will also be disabled and these settings will be ignored.
+   */
+  peer_card?: WorkspacesAPI.PeerCardConfiguration | null;
+
+  /**
+   * Configuration for summary functionality.
+   */
+  summary?: WorkspacesAPI.SummaryConfiguration | null;
+
+  [k: string]: unknown;
+}
+
 export interface Summary {
   /**
    * The summary text
@@ -310,7 +349,7 @@ export namespace SessionGetContextResponse {
 
       created_at: string;
 
-      message_ids: Array<Array<unknown>>;
+      message_ids: Array<number>;
 
       session_name: string;
 
@@ -331,7 +370,7 @@ export namespace SessionGetContextResponse {
 
       created_at: string;
 
-      message_ids: Array<Array<unknown>>;
+      message_ids: Array<number>;
 
       session_name: string;
     }
@@ -355,7 +394,13 @@ export interface SessionSummariesResponse {
 }
 
 export interface SessionUpdateParams {
-  configuration?: { [key: string]: unknown } | null;
+  /**
+   * The set of options that can be in a session DB-level configuration dictionary.
+   *
+   * All fields are optional. Session-level configuration overrides workspace-level
+   * configuration, which overrides global configuration.
+   */
+  configuration?: SessionConfiguration | null;
 
   metadata?: { [key: string]: unknown } | null;
 }
@@ -375,11 +420,29 @@ export interface SessionCloneParams {
 }
 
 export interface SessionGetContextParams {
+  /**
+   * Only used if `last_message` is provided. Whether to include the most derived
+   * observations in the representation
+   */
+  include_most_derived?: boolean;
+
   /**
    * The most recent message, used to fetch semantically relevant observations
    */
   last_message?: string | null;
 
+  /**
+   * Only used if `last_message` is provided. Whether to limit the representation to
+   * the session (as opposed to everything known about the target peer)
+   */
+  limit_to_session?: boolean;
+
+  /**
+   * Only used if `last_message` is provided. The maximum number of observations to
+   * include in the representation
+   */
+  max_observations?: number | 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
@@ -395,6 +458,18 @@ export interface SessionGetContextParams {
    */
   peer_target?: string | null;
 
+  /**
+   * Only used if `last_message` is provided. The maximum distance to search for
+   * semantically relevant observations
+   */
+  search_max_distance?: number | null;
+
+  /**
+   * Only used if `last_message` is provided. The number of semantic-search-retrieved
+   * observations to include in the representation
+   */
+  search_top_k?: number | null;
+
   /**
    * Whether or not to include a summary _if_ one is available for the session
    */
@@ -411,7 +486,13 @@ export interface SessionGetContextParams {
 export interface SessionGetOrCreateParams {
   id: string;
 
-  configuration?: { [key: string]: unknown } | null;
+  /**
+   * The set of options that can be in a session DB-level configuration dictionary.
+   *
+   * All fields are optional. Session-level configuration overrides workspace-level
+   * configuration, which overrides global configuration.
+   */
+  configuration?: SessionConfiguration | null;
 
   metadata?: { [key: string]: unknown } | null;
 
@@ -443,6 +524,7 @@ Sessions.Peers = Peers;
 export declare namespace Sessions {
   export {
     type Session as Session,
+    type SessionConfiguration as SessionConfiguration,
     type Summary as Summary,
     type SessionDeleteResponse as SessionDeleteResponse,
     type SessionGetContextResponse as SessionGetContextResponse,

package/src/resources/workspaces/workspaces.ts

@@ -3,6 +3,18 @@
 import { APIResource } from "../../resource.js";
 import { isRequestOptions } from "../../core.js";
 import * as Core from "../../core.js";
+import * as ObservationsAPI from "./observations.js";
+import {
+  ObservationDeleteResponse,
+  ObservationGet,
+  ObservationListParams,
+  ObservationQuery,
+  ObservationQueryParams,
+  ObservationQueryResponse,
+  Observations,
+  ObservationsPage,
+  PageObservation,
+} from "./observations.js";
 import * as WebhooksAPI from "./webhooks.js";
 import {
   WebhookDeleteResponse,
@@ -22,10 +34,13 @@ import {
   PeerCardResponse,
   PeerChatParams,
   PeerChatResponse,
+  PeerGetContextParams,
+  PeerGetContextResponse,
   PeerGetOrCreateParams,
   PeerListParams,
   PeerSearchParams,
   PeerSearchResponse,
+  PeerSetCardParams,
   PeerUpdateParams,
   PeerWorkingRepresentationParams,
   PeerWorkingRepresentationResponse,
@@ -38,6 +53,7 @@ import * as SessionsAPI from "./sessions/sessions.js";
 import {
   Session,
   SessionCloneParams,
+  SessionConfiguration,
   SessionDeleteResponse,
   SessionGetContextParams,
   SessionGetContextResponse,
@@ -54,6 +70,7 @@ import {
 import { Page, type PageParams } from "../../pagination.js";
 
 export class Workspaces extends APIResource {
+  observations: ObservationsAPI.Observations = new ObservationsAPI.Observations(this._client);
   peers: PeersAPI.Peers = new PeersAPI.Peers(this._client);
   sessions: SessionsAPI.Sessions = new SessionsAPI.Sessions(this._client);
   webhooks: WebhooksAPI.Webhooks = new WebhooksAPI.Webhooks(this._client);
@@ -141,10 +158,42 @@ export class Workspaces extends APIResource {
   ): Core.APIPromise<WorkspaceSearchResponse> {
     return this._client.post(`/v2/workspaces/${workspaceId}/search`, { body, ...options });
   }
+
+  /**
+   * Manually trigger a dream task immediately for a specific collection.
+   *
+   * This endpoint bypasses all automatic dream conditions (document threshold,
+   * minimum hours between dreams) and executes the dream task immediately without
+   * delay.
+   */
+  triggerDream(
+    workspaceId: string,
+    body: WorkspaceTriggerDreamParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<void> {
+    return this._client.post(`/v2/workspaces/${workspaceId}/trigger_dream`, {
+      body,
+      ...options,
+      headers: { Accept: '*/*', ...options?.headers },
+    });
+  }
 }
 
 export class WorkspacesPage extends Page<Workspace> {}
 
+export interface DeriverConfiguration {
+  /**
+   * TODO: currently unused. Custom instructions to use for the deriver on this
+   * workspace/session/message.
+   */
+  custom_instructions?: string | null;
+
+  /**
+   * Whether to enable deriver functionality.
+   */
+  enabled?: boolean | null;
+}
+
 export interface DeriverStatus {
   /**
    * Completed work units
@@ -201,6 +250,14 @@ export namespace DeriverStatus {
   }
 }
 
+export interface DreamConfiguration {
+  /**
+   * Whether to enable dream functionality. If deriver is disabled, dreams will also
+   * be disabled and this setting will be ignored.
+   */
+  enabled?: boolean | null;
+}
+
 export interface MessageSearchOptions {
   /**
    * Search query
@@ -218,6 +275,37 @@ export interface MessageSearchOptions {
   limit?: number;
 }
 
+export interface PeerCardConfiguration {
+  /**
+   * Whether to generate peer card based on content.
+   */
+  create?: boolean | null;
+
+  /**
+   * Whether to use peer card related to this peer during deriver process.
+   */
+  use?: boolean | null;
+}
+
+export interface SummaryConfiguration {
+  /**
+   * Whether to enable summary functionality.
+   */
+  enabled?: boolean | null;
+
+  /**
+   * Number of messages per long summary. Must be positive, greater than or equal to
+   * 20, and greater than messages_per_short_summary.
+   */
+  messages_per_long_summary?: number | null;
+
+  /**
+   * Number of messages per short summary. Must be positive, greater than or equal to
+   * 10, and less than messages_per_long_summary.
+   */
+  messages_per_short_summary?: number | null;
+}
+
 export interface Workspace {
   id: string;
 
@@ -228,10 +316,48 @@ export interface Workspace {
   metadata?: { [key: string]: unknown };
 }
 
+/**
+ * The set of options that can be in a workspace DB-level configuration dictionary.
+ *
+ * All fields are optional. Session-level configuration overrides workspace-level
+ * configuration, which overrides global configuration.
+ */
+export interface WorkspaceConfiguration {
+  /**
+   * Configuration for deriver functionality.
+   */
+  deriver?: DeriverConfiguration | null;
+
+  /**
+   * Configuration for dream functionality. If deriver is disabled, dreams will also
+   * be disabled and these settings will be ignored.
+   */
+  dream?: DreamConfiguration | null;
+
+  /**
+   * Configuration for peer card functionality. If deriver is disabled, peer cards
+   * will also be disabled and these settings will be ignored.
+   */
+  peer_card?: PeerCardConfiguration | null;
+
+  /**
+   * Configuration for summary functionality.
+   */
+  summary?: SummaryConfiguration | null;
+
+  [k: string]: unknown;
+}
+
 export type WorkspaceSearchResponse = Array<MessagesAPI.Message>;
 
 export interface WorkspaceUpdateParams {
-  configuration?: { [key: string]: unknown } | null;
+  /**
+   * The set of options that can be in a workspace DB-level configuration dictionary.
+   *
+   * All fields are optional. Session-level configuration overrides workspace-level
+   * configuration, which overrides global configuration.
+   */
+  configuration?: WorkspaceConfiguration | null;
 
   metadata?: { [key: string]: unknown } | null;
 }
@@ -263,7 +389,13 @@ export interface WorkspaceDeriverStatusParams {
 export interface WorkspaceGetOrCreateParams {
   id: string;
 
-  configuration?: { [key: string]: unknown };
+  /**
+   * The set of options that can be in a workspace DB-level configuration dictionary.
+   *
+   * All fields are optional. Session-level configuration overrides workspace-level
+   * configuration, which overrides global configuration.
+   */
+  configuration?: WorkspaceConfiguration;
 
   metadata?: { [key: string]: unknown };
 }
@@ -285,7 +417,25 @@ export interface WorkspaceSearchParams {
   limit?: number;
 }
 
+export interface WorkspaceTriggerDreamParams {
+  /**
+   * Type of dream to trigger
+   */
+  dream_type: 'consolidate' | 'agent';
+
+  /**
+   * Observer peer name
+   */
+  observer: string;
+
+  /**
+   * Observed peer name (defaults to observer if not specified)
+   */
+  observed?: string | null;
+}
+
 Workspaces.WorkspacesPage = WorkspacesPage;
+Workspaces.ObservationsPage = ObservationsPage;
 Workspaces.Peers = Peers;
 Workspaces.PeersPage = PeersPage;
 Workspaces.Sessions = SessionsAPISessions;
@@ -295,9 +445,14 @@ Workspaces.WebhookEndpointsPage = WebhookEndpointsPage;
 
 export declare namespace Workspaces {
   export {
+    type DeriverConfiguration as DeriverConfiguration,
     type DeriverStatus as DeriverStatus,
+    type DreamConfiguration as DreamConfiguration,
     type MessageSearchOptions as MessageSearchOptions,
+    type PeerCardConfiguration as PeerCardConfiguration,
+    type SummaryConfiguration as SummaryConfiguration,
     type Workspace as Workspace,
+    type WorkspaceConfiguration as WorkspaceConfiguration,
     type WorkspaceSearchResponse as WorkspaceSearchResponse,
     WorkspacesPage as WorkspacesPage,
     type WorkspaceUpdateParams as WorkspaceUpdateParams,
@@ -305,6 +460,19 @@ export declare namespace Workspaces {
     type WorkspaceDeriverStatusParams as WorkspaceDeriverStatusParams,
     type WorkspaceGetOrCreateParams as WorkspaceGetOrCreateParams,
     type WorkspaceSearchParams as WorkspaceSearchParams,
+    type WorkspaceTriggerDreamParams as WorkspaceTriggerDreamParams,
+  };
+
+  export {
+    type Observations as Observations,
+    type ObservationGet as ObservationGet,
+    type ObservationQuery as ObservationQuery,
+    type PageObservation as PageObservation,
+    type ObservationDeleteResponse as ObservationDeleteResponse,
+    type ObservationQueryResponse as ObservationQueryResponse,
+    ObservationsPage as ObservationsPage,
+    type ObservationListParams as ObservationListParams,
+    type ObservationQueryParams as ObservationQueryParams,
   };
 
   export {
@@ -312,9 +480,10 @@ export declare namespace Workspaces {
     type PagePeer as PagePeer,
     type PageSession as PageSession,
     type Peer as Peer,
-    type SessionGet as SessionGet,
     type PeerCardResponse as PeerCardResponse,
+    type SessionGet as SessionGet,
     type PeerChatResponse as PeerChatResponse,
+    type PeerGetContextResponse as PeerGetContextResponse,
     type PeerSearchResponse as PeerSearchResponse,
     type PeerWorkingRepresentationResponse as PeerWorkingRepresentationResponse,
     PeersPage as PeersPage,
@@ -322,14 +491,17 @@ export declare namespace Workspaces {
     type PeerListParams as PeerListParams,
     type PeerCardParams as PeerCardParams,
     type PeerChatParams as PeerChatParams,
+    type PeerGetContextParams as PeerGetContextParams,
     type PeerGetOrCreateParams as PeerGetOrCreateParams,
     type PeerSearchParams as PeerSearchParams,
+    type PeerSetCardParams as PeerSetCardParams,
     type PeerWorkingRepresentationParams as PeerWorkingRepresentationParams,
   };
 
   export {
     SessionsAPISessions as Sessions,
     type Session as Session,
+    type SessionConfiguration as SessionConfiguration,
     type Summary as Summary,
     type SessionDeleteResponse as SessionDeleteResponse,
     type SessionGetContextResponse as SessionGetContextResponse,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.5.1'; // x-release-please-version
+export const VERSION = '1.6.0'; // x-release-please-version

package/version.d.ts

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

package/version.mjs

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