@honcho-ai/core 1.6.0 → 1.7.0

package/src/index.ts

@@ -14,12 +14,14 @@ import {
   DreamConfiguration,
   MessageSearchOptions,
   PeerCardConfiguration,
+  QueueStatus,
   SummaryConfiguration,
   Workspace,
   WorkspaceConfiguration,
   WorkspaceDeriverStatusParams,
   WorkspaceGetOrCreateParams,
   WorkspaceListParams,
+  WorkspaceQueueStatusParams,
   WorkspaceSearchParams,
   WorkspaceSearchResponse,
   WorkspaceTriggerDreamParams,
@@ -29,9 +31,8 @@ import {
 } from "./resources/workspaces/workspaces.js";
 
 const environments = {
-  demo: 'https://demo.honcho.dev',
-  local: 'http://localhost:8000',
   production: 'https://api.honcho.dev',
+  local: 'http://localhost:8000',
 };
 type Environment = keyof typeof environments;
 
@@ -45,9 +46,8 @@ export interface ClientOptions {
    * Specifies the environment to use for the API.
    *
    * Each environment maps to a different base URL:
-   * - `demo` corresponds to `https://demo.honcho.dev`
-   * - `local` corresponds to `http://localhost:8000`
    * - `production` corresponds to `https://api.honcho.dev`
+   * - `local` corresponds to `http://localhost:8000`
    */
   environment?: Environment | undefined;
 
@@ -122,8 +122,8 @@ export class Honcho extends Core.APIClient {
    * API Client for interfacing with the Honcho API.
    *
    * @param {string | null | undefined} [opts.apiKey=process.env['HONCHO_API_KEY'] ?? null]
-   * @param {Environment} [opts.environment=demo] - Specifies the environment URL to use for the API.
-   * @param {string} [opts.baseURL=process.env['HONCHO_BASE_URL'] ?? https://demo.honcho.dev] - Override the default base URL for the API.
+   * @param {Environment} [opts.environment=production] - Specifies the environment URL to use for the API.
+   * @param {string} [opts.baseURL=process.env['HONCHO_BASE_URL'] ?? https://api.honcho.dev] - Override the default base URL for the API.
    * @param {number} [opts.timeout=1 minute] - The maximum amount of time (in milliseconds) the client will wait for a response before timing out.
    * @param {number} [opts.httpAgent] - An HTTP agent used to manage HTTP(s) connections.
    * @param {Core.Fetch} [opts.fetch] - Specify a custom `fetch` function implementation.
@@ -140,7 +140,7 @@ export class Honcho extends Core.APIClient {
       apiKey,
       ...opts,
       baseURL,
-      environment: opts.environment ?? 'demo',
+      environment: opts.environment ?? 'production',
     };
 
     if (baseURL && opts.environment) {
@@ -150,8 +150,8 @@ export class Honcho extends Core.APIClient {
     }
 
     super({
-      baseURL: options.baseURL || environments[options.environment || 'demo'],
-      baseURLOverridden: baseURL ? baseURL !== environments[options.environment || 'demo'] : false,
+      baseURL: options.baseURL || environments[options.environment || 'production'],
+      baseURLOverridden: baseURL ? baseURL !== environments[options.environment || 'production'] : false,
       timeout: options.timeout ?? 60000 /* 1 minute */,
       httpAgent: options.httpAgent,
       maxRetries: options.maxRetries,
@@ -170,7 +170,7 @@ export class Honcho extends Core.APIClient {
    * Check whether the base URL is set to its default.
    */
   #baseURLOverridden(): boolean {
-    return this.baseURL !== environments[this._options.environment || 'demo'];
+    return this.baseURL !== environments[this._options.environment || 'production'];
   }
 
   protected override defaultQuery(): Core.DefaultQuery | undefined {
@@ -229,6 +229,7 @@ export declare namespace Honcho {
     type DreamConfiguration as DreamConfiguration,
     type MessageSearchOptions as MessageSearchOptions,
     type PeerCardConfiguration as PeerCardConfiguration,
+    type QueueStatus as QueueStatus,
     type SummaryConfiguration as SummaryConfiguration,
     type Workspace as Workspace,
     type WorkspaceConfiguration as WorkspaceConfiguration,
@@ -238,6 +239,7 @@ export declare namespace Honcho {
     type WorkspaceListParams as WorkspaceListParams,
     type WorkspaceDeriverStatusParams as WorkspaceDeriverStatusParams,
     type WorkspaceGetOrCreateParams as WorkspaceGetOrCreateParams,
+    type WorkspaceQueueStatusParams as WorkspaceQueueStatusParams,
     type WorkspaceSearchParams as WorkspaceSearchParams,
     type WorkspaceTriggerDreamParams as WorkspaceTriggerDreamParams,
   };

package/src/resources/index.ts

@@ -9,6 +9,7 @@ export {
   type DreamConfiguration,
   type MessageSearchOptions,
   type PeerCardConfiguration,
+  type QueueStatus,
   type SummaryConfiguration,
   type Workspace,
   type WorkspaceConfiguration,
@@ -17,6 +18,7 @@ export {
   type WorkspaceListParams,
   type WorkspaceDeriverStatusParams,
   type WorkspaceGetOrCreateParams,
+  type WorkspaceQueueStatusParams,
   type WorkspaceSearchParams,
   type WorkspaceTriggerDreamParams,
 } from "./workspaces/workspaces.js";

package/src/resources/workspaces/conclusions.ts

@@ -0,0 +1,220 @@
+// 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 Conclusions extends APIResource {
+  /**
+   * Create one or more conclusions.
+   *
+   * Conclusions are theory-of-mind facts derived from interactions between peers.
+   */
+  create(
+    workspaceId: string,
+    body: ConclusionCreateParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<ConclusionCreateResponse> {
+    return this._client.post(`/v2/workspaces/${workspaceId}/conclusions`, { body, ...options });
+  }
+
+  /**
+   * List conclusions using custom filters, ordered by recency unless `reverse` is
+   * true.
+   */
+  list(
+    workspaceId: string,
+    params?: ConclusionListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<ConclusionsPage, Conclusion>;
+  list(workspaceId: string, options?: Core.RequestOptions): Core.PagePromise<ConclusionsPage, Conclusion>;
+  list(
+    workspaceId: string,
+    params: ConclusionListParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<ConclusionsPage, Conclusion> {
+    if (isRequestOptions(params)) {
+      return this.list(workspaceId, {}, params);
+    }
+    const { page, reverse, size, ...body } = params;
+    return this._client.getAPIList(`/v2/workspaces/${workspaceId}/conclusions/list`, ConclusionsPage, {
+      query: { page, reverse, size },
+      body,
+      method: 'post',
+      ...options,
+    });
+  }
+
+  /**
+   * Delete a specific conclusion (document).
+   */
+  delete(workspaceId: string, conclusionId: string, options?: Core.RequestOptions): Core.APIPromise<unknown> {
+    return this._client.delete(`/v2/workspaces/${workspaceId}/conclusions/${conclusionId}`, options);
+  }
+
+  /**
+   * Query conclusions using semantic search.
+   */
+  query(
+    workspaceId: string,
+    body: ConclusionQueryParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<ConclusionQueryResponse> {
+    return this._client.post(`/v2/workspaces/${workspaceId}/conclusions/query`, { body, ...options });
+  }
+}
+
+export class ConclusionsPage extends Page<Conclusion> {}
+
+/**
+ * Conclusion response - external view of a document.
+ */
+export interface Conclusion {
+  id: string;
+
+  content: string;
+
+  created_at: string;
+
+  /**
+   * The peer the conclusion is about
+   */
+  observed_id: string;
+
+  /**
+   * The peer who made the conclusion
+   */
+  observer_id: string;
+
+  session_id: string;
+}
+
+/**
+ * Schema for creating a single conclusion.
+ */
+export interface ConclusionCreate {
+  content: string;
+
+  /**
+   * The peer the conclusion is about
+   */
+  observed_id: string;
+
+  /**
+   * The peer making the conclusion
+   */
+  observer_id: string;
+
+  /**
+   * The session this conclusion relates to
+   */
+  session_id: string;
+}
+
+/**
+ * Schema for listing conclusions with optional filters.
+ */
+export interface ConclusionGet {
+  filters?: { [key: string]: unknown } | null;
+}
+
+/**
+ * Query parameters for semantic search of conclusions.
+ */
+export interface ConclusionQuery {
+  /**
+   * Semantic search query
+   */
+  query: string;
+
+  /**
+   * Maximum cosine distance threshold for results
+   */
+  distance?: number | null;
+
+  /**
+   * Additional filters to apply
+   */
+  filters?: { [key: string]: unknown } | null;
+
+  /**
+   * Number of results to return
+   */
+  top_k?: number;
+}
+
+export interface PageConclusion {
+  items: Array<Conclusion>;
+
+  page: number;
+
+  size: number;
+
+  pages?: number;
+
+  total?: number;
+}
+
+export type ConclusionCreateResponse = Array<Conclusion>;
+
+export type ConclusionDeleteResponse = unknown;
+
+export type ConclusionQueryResponse = Array<Conclusion>;
+
+export interface ConclusionCreateParams {
+  conclusions: Array<ConclusionCreate>;
+}
+
+export interface ConclusionListParams extends PageParams {
+  /**
+   * Query param: Whether to reverse the order of results
+   */
+  reverse?: boolean | null;
+
+  /**
+   * Body param:
+   */
+  filters?: { [key: string]: unknown } | null;
+}
+
+export interface ConclusionQueryParams {
+  /**
+   * Semantic search query
+   */
+  query: string;
+
+  /**
+   * Maximum cosine distance threshold for results
+   */
+  distance?: number | null;
+
+  /**
+   * Additional filters to apply
+   */
+  filters?: { [key: string]: unknown } | null;
+
+  /**
+   * Number of results to return
+   */
+  top_k?: number;
+}
+
+Conclusions.ConclusionsPage = ConclusionsPage;
+
+export declare namespace Conclusions {
+  export {
+    type Conclusion as Conclusion,
+    type ConclusionCreate as ConclusionCreate,
+    type ConclusionGet as ConclusionGet,
+    type ConclusionQuery as ConclusionQuery,
+    type PageConclusion as PageConclusion,
+    type ConclusionCreateResponse as ConclusionCreateResponse,
+    type ConclusionDeleteResponse as ConclusionDeleteResponse,
+    type ConclusionQueryResponse as ConclusionQueryResponse,
+    ConclusionsPage as ConclusionsPage,
+    type ConclusionCreateParams as ConclusionCreateParams,
+    type ConclusionListParams as ConclusionListParams,
+    type ConclusionQueryParams as ConclusionQueryParams,
+  };
+}

package/src/resources/workspaces/index.ts

@@ -1,13 +1,32 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export {
+  ConclusionsPage,
+  Conclusions,
+  type Conclusion,
+  type ConclusionCreate,
+  type ConclusionGet,
+  type ConclusionQuery,
+  type PageConclusion,
+  type ConclusionCreateResponse,
+  type ConclusionDeleteResponse,
+  type ConclusionQueryResponse,
+  type ConclusionCreateParams,
+  type ConclusionListParams,
+  type ConclusionQueryParams,
+} from "./conclusions.js";
 export {
   ObservationsPage,
   Observations,
+  type Observation,
+  type ObservationCreate,
   type ObservationGet,
   type ObservationQuery,
   type PageObservation,
+  type ObservationCreateResponse,
   type ObservationDeleteResponse,
   type ObservationQueryResponse,
+  type ObservationCreateParams,
   type ObservationListParams,
   type ObservationQueryParams,
 } from "./observations.js";
@@ -67,6 +86,7 @@ export {
   type DreamConfiguration,
   type MessageSearchOptions,
   type PeerCardConfiguration,
+  type QueueStatus,
   type SummaryConfiguration,
   type Workspace,
   type WorkspaceConfiguration,
@@ -75,6 +95,7 @@ export {
   type WorkspaceListParams,
   type WorkspaceDeriverStatusParams,
   type WorkspaceGetOrCreateParams,
+  type WorkspaceQueueStatusParams,
   type WorkspaceSearchParams,
   type WorkspaceTriggerDreamParams,
 } from "./workspaces.js";

package/src/resources/workspaces/observations.ts

@@ -3,27 +3,49 @@
 import { APIResource } from "../../resource.js";
 import { isRequestOptions } from "../../core.js";
 import * as Core from "../../core.js";
+import * as ConclusionsAPI from "./conclusions.js";
 import { Page, type PageParams } from "../../pagination.js";
 
 export class Observations extends APIResource {
+  /**
+   * Create one or more observations.
+   *
+   * Creates observations (theory-of-mind facts) for the specified observer/observed
+   * peer pairs. Each observation must reference existing peers and a session within
+   * the workspace. Embeddings are automatically generated for semantic search.
+   *
+   * Maximum of 100 observations per request.
+   *
+   * @deprecated
+   */
+  create(
+    workspaceId: string,
+    body: ObservationCreateParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<ObservationCreateResponse> {
+    return this._client.post(`/v2/workspaces/${workspaceId}/observations`, { body, ...options });
+  }
+
   /**
    * List all observations using custom filters. Observations are listed by recency
    * unless `reverse` is set to `true`.
    *
    * Observations can be filtered by session_id, observer_id and observed_id using
    * the filters parameter.
+   *
+   * @deprecated
    */
   list(
     workspaceId: string,
     params?: ObservationListParams,
     options?: Core.RequestOptions,
-  ): Core.PagePromise<ObservationsPage, Observations>;
-  list(workspaceId: string, options?: Core.RequestOptions): Core.PagePromise<ObservationsPage, Observations>;
+  ): Core.PagePromise<ObservationsPage, Observation>;
+  list(workspaceId: string, options?: Core.RequestOptions): Core.PagePromise<ObservationsPage, Observation>;
   list(
     workspaceId: string,
     params: ObservationListParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
-  ): Core.PagePromise<ObservationsPage, Observations> {
+  ): Core.PagePromise<ObservationsPage, Observation> {
     if (isRequestOptions(params)) {
       return this.list(workspaceId, {}, params);
     }
@@ -41,6 +63,8 @@ export class Observations extends APIResource {
    *
    * This permanently deletes the observation (document) from the theory-of-mind
    * system. This action cannot be undone.
+   *
+   * @deprecated
    */
   delete(
     workspaceId: string,
@@ -56,6 +80,8 @@ export class Observations extends APIResource {
    * Performs vector similarity search on observations to find semantically relevant
    * results. Observer and observed are required for semantic search and must be
    * provided in filters.
+   *
+   * @deprecated
    */
   query(
     workspaceId: string,
@@ -66,17 +92,62 @@ export class Observations extends APIResource {
   }
 }
 
-export class ObservationsPage extends Page<Observations> {}
+export class ObservationsPage extends Page<Observation> {}
+
+/**
+ * Deprecated: use Conclusion.
+ */
+export interface Observation {
+  id: string;
+
+  content: string;
+
+  created_at: string;
+
+  /**
+   * The peer the conclusion is about
+   */
+  observed_id: string;
+
+  /**
+   * The peer who made the conclusion
+   */
+  observer_id: string;
+
+  session_id: string;
+}
 
 /**
- * Schema for listing observations with optional filters
+ * Deprecated: use ConclusionCreate.
+ */
+export interface ObservationCreate {
+  content: string;
+
+  /**
+   * The peer the conclusion is about
+   */
+  observed_id: string;
+
+  /**
+   * The peer making the conclusion
+   */
+  observer_id: string;
+
+  /**
+   * The session this conclusion relates to
+   */
+  session_id: string;
+}
+
+/**
+ * Deprecated: use ConclusionGet.
  */
 export interface ObservationGet {
   filters?: { [key: string]: unknown } | null;
 }
 
 /**
- * Query parameters for semantic search of observations
+ * Deprecated: use ConclusionQuery.
  */
 export interface ObservationQuery {
   /**
@@ -100,31 +171,8 @@ export interface ObservationQuery {
   top_k?: number;
 }
 
-/**
- * Observation response - external view of a document
- */
-export interface Observations {
-  id: string;
-
-  content: string;
-
-  created_at: string;
-
-  /**
-   * The peer being observed
-   */
-  observed_id: string;
-
-  /**
-   * The peer who made the observation
-   */
-  observer_id: string;
-
-  session_id: string;
-}
-
 export interface PageObservation {
-  items: Array<Observations>;
+  items: Array<Observation>;
 
   page: number;
 
@@ -135,9 +183,17 @@ export interface PageObservation {
   total?: number;
 }
 
+export type ObservationCreateResponse = Array<Observation>;
+
 export type ObservationDeleteResponse = unknown;
 
-export type ObservationQueryResponse = Array<Observations>;
+export type ObservationQueryResponse = Array<Observation>;
+
+export interface ObservationCreateParams {
+  conclusions: Array<ConclusionsAPI.ConclusionCreate>;
+
+  observations: Array<ObservationCreate>;
+}
 
 export interface ObservationListParams extends PageParams {
   /**
@@ -177,13 +233,16 @@ Observations.ObservationsPage = ObservationsPage;
 
 export declare namespace Observations {
   export {
+    type Observation as Observation,
+    type ObservationCreate as ObservationCreate,
     type ObservationGet as ObservationGet,
     type ObservationQuery as ObservationQuery,
-    type Observations as Observations,
     type PageObservation as PageObservation,
+    type ObservationCreateResponse as ObservationCreateResponse,
     type ObservationDeleteResponse as ObservationDeleteResponse,
     type ObservationQueryResponse as ObservationQueryResponse,
     ObservationsPage as ObservationsPage,
+    type ObservationCreateParams as ObservationCreateParams,
     type ObservationListParams as ObservationListParams,
     type ObservationQueryParams as ObservationQueryParams,
   };