@honcho-ai/core 1.0.0

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

@@ -0,0 +1,308 @@
+// 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 * as MessagesAPI from "./messages.js";
+import {
+  Message,
+  MessageCreate,
+  MessageCreateParams,
+  MessageCreateResponse,
+  MessageListParams,
+  MessageUpdateParams,
+  Messages,
+  MessagesPage,
+} from "./messages.js";
+import * as PeersAPI from "./peers.js";
+import {
+  PeerAddParams,
+  PeerGetConfigResponse,
+  PeerListParams,
+  PeerRemoveParams,
+  PeerSetConfigParams,
+  PeerSetConfigResponse,
+  PeerSetParams,
+  Peers as PeersAPIPeers,
+} from "./peers.js";
+import { Page, type PageParams } from "../../../pagination.js";
+
+export class Sessions extends APIResource {
+  messages: MessagesAPI.Messages = new MessagesAPI.Messages(this._client);
+  peers: PeersAPI.Peers = new PeersAPI.Peers(this._client);
+
+  /**
+   * Update the metadata of a Session
+   */
+  update(
+    workspaceId: string,
+    sessionId: string,
+    body: SessionUpdateParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<Session> {
+    return this._client.put(`/v1/workspaces/${workspaceId}/sessions/${sessionId}`, { body, ...options });
+  }
+
+  /**
+   * Get All Sessions in a Workspace
+   */
+  list(
+    workspaceId: string,
+    params?: SessionListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<SessionsPage, Session>;
+  list(workspaceId: string, options?: Core.RequestOptions): Core.PagePromise<SessionsPage, Session>;
+  list(
+    workspaceId: string,
+    params: SessionListParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<SessionsPage, Session> {
+    if (isRequestOptions(params)) {
+      return this.list(workspaceId, {}, params);
+    }
+    const { page, size, ...body } = params;
+    return this._client.getAPIList(`/v1/workspaces/${workspaceId}/sessions/list`, SessionsPage, {
+      query: { page, size },
+      body,
+      method: 'post',
+      ...options,
+    });
+  }
+
+  /**
+   * Delete a session by marking it as inactive
+   */
+  delete(workspaceId: string, sessionId: string, options?: Core.RequestOptions): Core.APIPromise<unknown> {
+    return this._client.delete(`/v1/workspaces/${workspaceId}/sessions/${sessionId}`, options);
+  }
+
+  /**
+   * Clone a session, optionally up to a specific message
+   */
+  clone(
+    workspaceId: string,
+    sessionId: string,
+    query?: 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 = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<Session> {
+    if (isRequestOptions(query)) {
+      return this.clone(workspaceId, sessionId, {}, query);
+    }
+    return this._client.get(`/v1/workspaces/${workspaceId}/sessions/${sessionId}/clone`, {
+      query,
+      ...options,
+    });
+  }
+
+  /**
+   * 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)
+   */
+  getContext(
+    workspaceId: string,
+    sessionId: string,
+    query?: SessionGetContextParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<SessionGetContextResponse>;
+  getContext(
+    workspaceId: string,
+    sessionId: string,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<SessionGetContextResponse>;
+  getContext(
+    workspaceId: string,
+    sessionId: string,
+    query: SessionGetContextParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<SessionGetContextResponse> {
+    if (isRequestOptions(query)) {
+      return this.getContext(workspaceId, sessionId, {}, query);
+    }
+    return this._client.get(`/v1/workspaces/${workspaceId}/sessions/${sessionId}/context`, {
+      query,
+      ...options,
+    });
+  }
+
+  /**
+   * 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.
+   */
+  getOrCreate(
+    workspaceId: string,
+    body: SessionGetOrCreateParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<Session> {
+    return this._client.post(`/v1/workspaces/${workspaceId}/sessions`, { body, ...options });
+  }
+
+  /**
+   * Search a Session
+   */
+  search(
+    workspaceId: string,
+    sessionId: string,
+    params: SessionSearchParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<MessagesPage, MessagesAPI.Message> {
+    const { body, page, size } = params;
+    return this._client.getAPIList(
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/search`,
+      MessagesPage,
+      { query: { page, size }, body: body, method: 'post', ...options },
+    );
+  }
+}
+
+export class SessionsPage extends Page<Session> {}
+
+export interface Session {
+  id: string;
+
+  created_at: string;
+
+  is_active: boolean;
+
+  workspace_id: string;
+
+  configuration?: Record<string, unknown>;
+
+  metadata?: Record<string, unknown>;
+}
+
+export type SessionDeleteResponse = unknown;
+
+export interface SessionGetContextResponse {
+  id: string;
+
+  messages: Array<MessagesAPI.Message>;
+
+  summary: string;
+}
+
+export interface SessionUpdateParams {
+  configuration?: Record<string, unknown> | null;
+
+  metadata?: Record<string, unknown> | null;
+}
+
+export interface SessionListParams extends PageParams {
+  /**
+   * Body param:
+   */
+  filter?: Record<string, unknown> | null;
+
+  /**
+   * Body param:
+   */
+  is_active?: boolean;
+}
+
+export interface SessionCloneParams {
+  /**
+   * Message ID to cut off the clone at
+   */
+  message_id?: string | null;
+}
+
+export interface SessionGetContextParams {
+  /**
+   * Whether to summarize the session history prior to the cutoff message
+   */
+  summary?: boolean;
+
+  /**
+   * Number of tokens to use for the context. Includes summary if set to true
+   */
+  tokens?: number | null;
+}
+
+export interface SessionGetOrCreateParams {
+  id: string;
+
+  configuration?: Record<string, unknown> | null;
+
+  metadata?: Record<string, unknown> | null;
+
+  peers?: Record<string, SessionGetOrCreateParams.Peers> | 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;
+
+    /**
+     * 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 {
+  /**
+   * Body param: Search query
+   */
+  body: string;
+}
+
+Sessions.SessionsPage = SessionsPage;
+Sessions.Messages = Messages;
+Sessions.MessagesPage = MessagesPage;
+Sessions.Peers = PeersAPIPeers;
+
+export declare namespace Sessions {
+  export {
+    type Session as Session,
+    type SessionDeleteResponse as SessionDeleteResponse,
+    type SessionGetContextResponse as SessionGetContextResponse,
+    SessionsPage as SessionsPage,
+    type SessionUpdateParams as SessionUpdateParams,
+    type SessionListParams as SessionListParams,
+    type SessionCloneParams as SessionCloneParams,
+    type SessionGetContextParams as SessionGetContextParams,
+    type SessionGetOrCreateParams as SessionGetOrCreateParams,
+    type SessionSearchParams as SessionSearchParams,
+  };
+
+  export {
+    Messages as Messages,
+    type Message as Message,
+    type MessageCreate as MessageCreate,
+    type MessageCreateResponse as MessageCreateResponse,
+    MessagesPage as MessagesPage,
+    type MessageCreateParams as MessageCreateParams,
+    type MessageUpdateParams as MessageUpdateParams,
+    type MessageListParams as MessageListParams,
+  };
+
+  export {
+    PeersAPIPeers as Peers,
+    type PeerGetConfigResponse as PeerGetConfigResponse,
+    type PeerSetConfigResponse as PeerSetConfigResponse,
+    type PeerListParams as PeerListParams,
+    type PeerAddParams as PeerAddParams,
+    type PeerRemoveParams as PeerRemoveParams,
+    type PeerSetParams as PeerSetParams,
+    type PeerSetConfigParams as PeerSetConfigParams,
+  };
+}
+
+export { MessagesPage };

package/src/resources/workspaces/sessions.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from "./sessions/index.js";

package/src/resources/workspaces/workspaces.ts

@@ -0,0 +1,194 @@
+// 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 * as PeersAPI from "./peers/peers.js";
+import {
+  PageSession,
+  Peer,
+  PeerChatParams,
+  PeerChatResponse,
+  PeerGetOrCreateParams,
+  PeerListParams,
+  PeerSearchParams,
+  PeerUpdateParams,
+  PeerWorkingRepresentationParams,
+  PeerWorkingRepresentationResponse,
+  Peers,
+  PeersPage,
+  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,
+  SessionCloneParams,
+  SessionDeleteResponse,
+  SessionGetContextParams,
+  SessionGetContextResponse,
+  SessionGetOrCreateParams,
+  SessionListParams,
+  SessionSearchParams,
+  SessionUpdateParams,
+  Sessions,
+  SessionsPage,
+} from "./sessions/sessions.js";
+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);
+
+  /**
+   * Update a Workspace
+   */
+  update(
+    workspaceId: string,
+    body: WorkspaceUpdateParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<Workspace> {
+    return this._client.put(`/v1/workspaces/${workspaceId}`, { body, ...options });
+  }
+
+  /**
+   * Get all Workspaces
+   */
+  list(
+    params?: WorkspaceListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<WorkspacesPage, Workspace>;
+  list(options?: Core.RequestOptions): Core.PagePromise<WorkspacesPage, Workspace>;
+  list(
+    params: WorkspaceListParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<WorkspacesPage, Workspace> {
+    if (isRequestOptions(params)) {
+      return this.list({}, params);
+    }
+    const { page, size, ...body } = params;
+    return this._client.getAPIList('/v1/workspaces/list', WorkspacesPage, {
+      query: { page, size },
+      body,
+      method: 'post',
+      ...options,
+    });
+  }
+
+  /**
+   * 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.
+   */
+  getOrCreate(body: WorkspaceGetOrCreateParams, options?: Core.RequestOptions): Core.APIPromise<Workspace> {
+    return this._client.post('/v1/workspaces', { body, ...options });
+  }
+
+  /**
+   * Search a Workspace
+   */
+  search(
+    workspaceId: string,
+    params: WorkspaceSearchParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<MessagesPage, MessagesAPI.Message> {
+    const { body, page, size } = params;
+    return this._client.getAPIList(`/v1/workspaces/${workspaceId}/search`, MessagesPage, {
+      query: { page, size },
+      body: body,
+      method: 'post',
+      ...options,
+    });
+  }
+}
+
+export class WorkspacesPage extends Page<Workspace> {}
+
+export interface Workspace {
+  id: string;
+
+  created_at: string;
+
+  configuration?: Record<string, unknown>;
+
+  metadata?: Record<string, unknown>;
+}
+
+export interface WorkspaceUpdateParams {
+  configuration?: Record<string, unknown> | null;
+
+  metadata?: Record<string, unknown> | null;
+}
+
+export interface WorkspaceListParams extends PageParams {
+  /**
+   * Body param:
+   */
+  filter?: Record<string, unknown> | null;
+}
+
+export interface WorkspaceGetOrCreateParams {
+  id: string;
+
+  configuration?: Record<string, unknown>;
+
+  metadata?: Record<string, unknown>;
+}
+
+export interface WorkspaceSearchParams extends PageParams {
+  /**
+   * Body param: Search query
+   */
+  body: string;
+}
+
+Workspaces.WorkspacesPage = WorkspacesPage;
+Workspaces.Peers = Peers;
+Workspaces.PeersPage = PeersPage;
+Workspaces.Sessions = Sessions;
+Workspaces.SessionsPage = SessionsPage;
+
+export declare namespace Workspaces {
+  export {
+    type Workspace as Workspace,
+    WorkspacesPage as WorkspacesPage,
+    type WorkspaceUpdateParams as WorkspaceUpdateParams,
+    type WorkspaceListParams as WorkspaceListParams,
+    type WorkspaceGetOrCreateParams as WorkspaceGetOrCreateParams,
+    type WorkspaceSearchParams as WorkspaceSearchParams,
+  };
+
+  export {
+    Peers as Peers,
+    type PageSession as PageSession,
+    type Peer as Peer,
+    type SessionGet as SessionGet,
+    type PeerChatResponse as PeerChatResponse,
+    type PeerWorkingRepresentationResponse as PeerWorkingRepresentationResponse,
+    PeersPage as PeersPage,
+    type PeerUpdateParams as PeerUpdateParams,
+    type PeerListParams as PeerListParams,
+    type PeerChatParams as PeerChatParams,
+    type PeerGetOrCreateParams as PeerGetOrCreateParams,
+    type PeerSearchParams as PeerSearchParams,
+    type PeerWorkingRepresentationParams as PeerWorkingRepresentationParams,
+  };
+
+  export {
+    Sessions as Sessions,
+    type Session as Session,
+    type SessionDeleteResponse as SessionDeleteResponse,
+    type SessionGetContextResponse as SessionGetContextResponse,
+    SessionsPage as SessionsPage,
+    type SessionUpdateParams as SessionUpdateParams,
+    type SessionListParams as SessionListParams,
+    type SessionCloneParams as SessionCloneParams,
+    type SessionGetContextParams as SessionGetContextParams,
+    type SessionGetOrCreateParams as SessionGetOrCreateParams,
+    type SessionSearchParams as SessionSearchParams,
+  };
+}
+
+export { MessagesPage };

package/src/resources/workspaces.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from "./workspaces/index.js";

package/src/resources.ts

@@ -0,0 +1 @@
+export * from "./resources/index.js";

package/src/shims/node.ts

@@ -0,0 +1,50 @@
+// @ts-ignore
+import * as types from "../_shims/node-types.js";
+import { setShims } from "../_shims/registry.js";
+import { getRuntime } from "../_shims/node-runtime.js";
+setShims(getRuntime());
+
+declare module '../_shims/manual-types' {
+  export namespace manual {
+    // @ts-ignore
+    export type Agent = types.Agent;
+    // @ts-ignore
+    export import fetch = types.fetch;
+    // @ts-ignore
+    export type Request = types.Request;
+    // @ts-ignore
+    export type RequestInfo = types.RequestInfo;
+    // @ts-ignore
+    export type RequestInit = types.RequestInit;
+    // @ts-ignore
+    export type Response = types.Response;
+    // @ts-ignore
+    export type ResponseInit = types.ResponseInit;
+    // @ts-ignore
+    export type ResponseType = types.ResponseType;
+    // @ts-ignore
+    export type BodyInit = types.BodyInit;
+    // @ts-ignore
+    export type Headers = types.Headers;
+    // @ts-ignore
+    export type HeadersInit = types.HeadersInit;
+    // @ts-ignore
+    export type BlobPropertyBag = types.BlobPropertyBag;
+    // @ts-ignore
+    export type FilePropertyBag = types.FilePropertyBag;
+    // @ts-ignore
+    export type FileFromPathOptions = types.FileFromPathOptions;
+    // @ts-ignore
+    export import FormData = types.FormData;
+    // @ts-ignore
+    export import File = types.File;
+    // @ts-ignore
+    export import Blob = types.Blob;
+    // @ts-ignore
+    export type Readable = types.Readable;
+    // @ts-ignore
+    export type FsReadStream = types.FsReadStream;
+    // @ts-ignore
+    export import ReadableStream = types.ReadableStream;
+  }
+}

package/src/shims/web.ts

@@ -0,0 +1,50 @@
+// @ts-ignore
+import * as types from "../_shims/web-types.js";
+import { setShims } from "../_shims/registry.js";
+import { getRuntime } from "../_shims/web-runtime.js";
+setShims(getRuntime({ manuallyImported: true }));
+
+declare module '../_shims/manual-types' {
+  export namespace manual {
+    // @ts-ignore
+    export type Agent = types.Agent;
+    // @ts-ignore
+    export import fetch = types.fetch;
+    // @ts-ignore
+    export type Request = types.Request;
+    // @ts-ignore
+    export type RequestInfo = types.RequestInfo;
+    // @ts-ignore
+    export type RequestInit = types.RequestInit;
+    // @ts-ignore
+    export type Response = types.Response;
+    // @ts-ignore
+    export type ResponseInit = types.ResponseInit;
+    // @ts-ignore
+    export type ResponseType = types.ResponseType;
+    // @ts-ignore
+    export type BodyInit = types.BodyInit;
+    // @ts-ignore
+    export type Headers = types.Headers;
+    // @ts-ignore
+    export type HeadersInit = types.HeadersInit;
+    // @ts-ignore
+    export type BlobPropertyBag = types.BlobPropertyBag;
+    // @ts-ignore
+    export type FilePropertyBag = types.FilePropertyBag;
+    // @ts-ignore
+    export type FileFromPathOptions = types.FileFromPathOptions;
+    // @ts-ignore
+    export import FormData = types.FormData;
+    // @ts-ignore
+    export import File = types.File;
+    // @ts-ignore
+    export import Blob = types.Blob;
+    // @ts-ignore
+    export type Readable = types.Readable;
+    // @ts-ignore
+    export type FsReadStream = types.FsReadStream;
+    // @ts-ignore
+    export import ReadableStream = types.ReadableStream;
+  }
+}

package/src/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  // this config is included in the published src directory to prevent TS errors
+  // from appearing when users go to source, and VSCode opens the source .ts file
+  // via declaration maps
+  "include": ["index.ts"],
+  "compilerOptions": {
+    "target": "es2015",
+    "lib": ["DOM"],
+    "moduleResolution": "node"
+  }
+}