@neta-art/cohub 1.0.0 → 1.1.0

package/dist/apis/prompts.d.ts

@@ -0,0 +1,10 @@
+import type { Fetch } from "../transport.js";
+import type { PromptTemplateCatalogResponse } from "../types.js";
+export declare class PromptsApi {
+    private readonly fetcher;
+    private readonly baseUrl;
+    constructor(fetcher: Fetch, baseUrl: string);
+    list(options?: {
+        spaceId?: string;
+    }, customFetch?: Fetch): Promise<PromptTemplateCatalogResponse>;
+}

package/dist/apis/prompts.js

@@ -0,0 +1,22 @@
+export class PromptsApi {
+    fetcher;
+    baseUrl;
+    constructor(fetcher, baseUrl) {
+        this.fetcher = fetcher;
+        this.baseUrl = baseUrl;
+    }
+    async list(options, customFetch) {
+        const fetchImpl = customFetch ?? this.fetcher;
+        const params = new URLSearchParams();
+        if (options?.spaceId)
+            params.set("spaceId", options.spaceId);
+        const query = params.toString();
+        const base = this.baseUrl ? `${this.baseUrl}/api/prompts` : "/api/prompts";
+        const url = query ? `${base}?${query}` : base;
+        const response = await fetchImpl(url);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch prompt templates: ${response.status} ${response.statusText}`);
+        }
+        return response.json();
+    }
+}

package/dist/apis/session-access.js

@@ -8,7 +8,7 @@ export class SessionAccessApi {
     }
     set(sessionId, body) {
         return this.transport.request(`/api/sessions/${sessionId}/access`, {
-            method: "PUT",
+            method: "PATCH",
             headers: { "Content-Type": "application/json" },
             body: JSON.stringify(body),
         });

package/dist/apis/spaces.d.ts

@@ -1,6 +1,6 @@
 import type { WebsocketClient, WebsocketEventPayload } from "../websocket.js";
 import type { HttpTransport, Fetch } from "../transport.js";
-import type { CheckpointRecord, ContentBlock, SessionMessagesPaginatedResponse, SessionMessagesResponse, SessionRecord, SpaceAccessPolicy, SpaceBootstrapSource, SpaceChannelBindingInput, SpaceCheckpointDetailResponse, SpaceCreateResponse, SpaceEnvInput, SpaceFsFileResponse, SpaceFsMoveInput, SpaceFsTreeResponse, SpaceFsWriteFileInput, SpaceMember, SpaceRecord, SpaceRole, SpaceSessionsResponse } from "../types.js";
+import type { CheckpointRecord, ContentBlock, SessionMessagesPaginatedResponse, SessionMessagesResponse, SessionRecord, SpaceAccessPolicy, SpaceBootstrapSource, SpaceChannelBindingInput, SpaceCheckpointDetailResponse, SpaceCreateResponse, SpaceEnvInput, SpaceFsFileResponse, SpaceFsMoveInput, SpaceFsTreeResponse, SpaceUsageResponse, SpaceFsWriteFileInput, SpaceMember, SpaceRecord, SpaceRole, SpaceSessionsResponse } from "../types.js";
 export type SessionSubscriptionHandlers = {
     progress?: (event: WebsocketEventPayload) => void;
     final?: (event: WebsocketEventPayload) => void;
@@ -96,6 +96,9 @@ export declare class SessionClient {
         space: SpaceRecord;
         session: SessionRecord;
     }>;
+    rename(title: string | null, customFetch?: Fetch): Promise<{
+        session: SessionRecord;
+    }>;
     subscribe(handlers: SessionSubscriptionHandlers): () => void;
     on(type: SessionEventName, handler: (event: WebsocketEventPayload) => void): () => void;
 }
@@ -114,6 +117,11 @@ export declare class SpaceSessionsApi {
     list(customFetch?: Fetch): Promise<SpaceSessionsResponse>;
     byId(sessionId: string): SessionClient;
 }
+export type WebSocketConnectionState = {
+    state: "open" | "closed" | "error";
+    willReconnect: boolean;
+    connectionId?: string | null;
+};
 export declare class SpaceEventsApi {
     private readonly websocketClient;
     private readonly spaceId;
@@ -143,6 +151,12 @@ export declare class SpaceAccessApi {
         anonymous_user?: SpaceRole | null;
     }): Promise<SpaceAccessPolicy>;
 }
+export declare class SpaceUsageApi {
+    private readonly transport;
+    private readonly spaceId;
+    constructor(transport: HttpTransport, spaceId: string);
+    get(days?: number, customFetch?: Fetch): Promise<SpaceUsageResponse>;
+}
 export declare class SpaceCheckpointsApi {
     private readonly transport;
     private readonly spaceId;
@@ -165,6 +179,7 @@ export declare class SpaceClient {
     readonly members: SpaceMembersApi;
     readonly access: SpaceAccessApi;
     readonly checkpoints: SpaceCheckpointsApi;
+    readonly usage: SpaceUsageApi;
     constructor(id: string, transport: HttpTransport, websocketClient: WebsocketClient | null);
     get(customFetch?: Fetch): Promise<SpaceRecord>;
     rename(name: string): Promise<{

package/dist/apis/spaces.js

@@ -201,6 +201,13 @@ export class SessionClient {
             fetch: customFetch,
         });
     }
+    rename(title, customFetch) {
+        return this.transport.request(`/api/sessions/${this.id}`, {
+            method: "PATCH",
+            body: JSON.stringify({ title }),
+            fetch: customFetch,
+        });
+    }
     subscribe(handlers) {
         return this.realtime.subscribe(handlers);
     }
@@ -301,12 +308,24 @@ export class SpaceAccessApi {
     }
     set(body) {
         return this.transport.request(`/api/spaces/${this.spaceId}/access`, {
-            method: "PUT",
+            method: "PATCH",
             headers: { "Content-Type": "application/json" },
             body: JSON.stringify(body),
         });
     }
 }
+export class SpaceUsageApi {
+    transport;
+    spaceId;
+    constructor(transport, spaceId) {
+        this.transport = transport;
+        this.spaceId = spaceId;
+    }
+    get(days = 30, customFetch) {
+        const params = new URLSearchParams({ days: String(days) });
+        return this.transport.request(`/api/spaces/${this.spaceId}/usage?${params.toString()}`, { fetch: customFetch });
+    }
+}
 export class SpaceCheckpointsApi {
     transport;
     spaceId;
@@ -337,6 +356,7 @@ export class SpaceClient {
     members;
     access;
     checkpoints;
+    usage;
     constructor(id, transport, websocketClient) {
         this.id = id;
         this.transport = transport;
@@ -346,6 +366,7 @@ export class SpaceClient {
         this.members = new SpaceMembersApi(transport, id);
         this.access = new SpaceAccessApi(transport, id);
         this.checkpoints = new SpaceCheckpointsApi(transport, id);
+        this.usage = new SpaceUsageApi(transport, id);
     }
     get(customFetch) {
         return this.transport.request(`/api/spaces/${this.id}`, {

package/dist/client.d.ts

@@ -1,8 +1,9 @@
 import { ChannelsApi } from "./apis/channels.js";
 import { CronJobsApi } from "./apis/cron-jobs.js";
 import { ModelsApi } from "./apis/models.js";
+import { PromptsApi } from "./apis/prompts.js";
 import { SessionAccessApi } from "./apis/session-access.js";
-import { SpaceClient, SpacesApi } from "./apis/spaces.js";
+import { SpaceClient, SpacesApi, type WebSocketConnectionState } from "./apis/spaces.js";
 import { TasksApi } from "./apis/tasks.js";
 import { UserApi } from "./apis/user.js";
 import { type CohubClientOptions } from "./transport.js";
@@ -11,6 +12,7 @@ export declare class CohubClient {
     readonly channels: ChannelsApi;
     readonly user: UserApi;
     readonly models: ModelsApi;
+    readonly prompts: PromptsApi;
     readonly sessionAccess: SessionAccessApi;
     readonly tasks: TasksApi;
     readonly cronJobs: CronJobsApi;
@@ -18,5 +20,6 @@ export declare class CohubClient {
     private readonly websocketClient;
     constructor(options?: CohubClientOptions);
     space(spaceId: string): SpaceClient;
+    onConnection(handler: (state: WebSocketConnectionState) => void): () => void;
 }
 export declare const createCohubClient: (options?: CohubClientOptions) => CohubClient;

package/dist/client.js

@@ -1,6 +1,7 @@
 import { ChannelsApi } from "./apis/channels.js";
 import { CronJobsApi } from "./apis/cron-jobs.js";
 import { ModelsApi } from "./apis/models.js";
+import { PromptsApi } from "./apis/prompts.js";
 import { SessionAccessApi } from "./apis/session-access.js";
 import { SpaceClient, SpacesApi } from "./apis/spaces.js";
 import { TasksApi } from "./apis/tasks.js";
@@ -12,6 +13,7 @@ export class CohubClient {
     channels;
     user;
     models;
+    prompts;
     sessionAccess;
     tasks;
     cronJobs;
@@ -27,6 +29,7 @@ export class CohubClient {
         this.channels = new ChannelsApi(this.transport);
         this.user = new UserApi(this.transport, options.baseUrl ?? "", options.setStoredAuthToken, options.clearStoredAuthToken);
         this.models = new ModelsApi(options.fetch ?? fetch, options.baseUrl ?? "");
+        this.prompts = new PromptsApi(options.fetch ?? fetch, options.baseUrl ?? "");
         this.sessionAccess = new SessionAccessApi(this.transport);
         this.tasks = new TasksApi(this.transport);
         this.cronJobs = new CronJobsApi(this.transport);
@@ -34,5 +37,28 @@ export class CohubClient {
     space(spaceId) {
         return new SpaceClient(spaceId, this.transport, this.websocketClient);
     }
+    onConnection(handler) {
+        const openCleanup = this.websocketClient.on("open", (payload) => {
+            handler({
+                state: "open",
+                willReconnect: false,
+                connectionId: payload.connectionId,
+            });
+        });
+        const closeCleanup = this.websocketClient.on("close", (payload) => {
+            handler({
+                state: "closed",
+                willReconnect: payload.willReconnect,
+            });
+        });
+        const errorCleanup = this.websocketClient.on("error", () => {
+            handler({ state: "error", willReconnect: true });
+        });
+        return () => {
+            openCleanup();
+            closeCleanup();
+            errorCleanup();
+        };
+    }
 }
 export const createCohubClient = (options) => new CohubClient(options);

package/dist/http.d.ts

@@ -1,6 +1,7 @@
 import { ChannelsApi } from "./apis/channels.js";
 import { CronJobsApi } from "./apis/cron-jobs.js";
 import { ModelsApi } from "./apis/models.js";
+import { PromptsApi } from "./apis/prompts.js";
 import { SessionAccessApi } from "./apis/session-access.js";
 import { SpaceClient, SpacesApi } from "./apis/spaces.js";
 import { TasksApi } from "./apis/tasks.js";
@@ -11,6 +12,7 @@ export declare class CohubHttpClient {
     readonly channels: ChannelsApi;
     readonly user: UserApi;
     readonly models: ModelsApi;
+    readonly prompts: PromptsApi;
     readonly sessionAccess: SessionAccessApi;
     readonly tasks: TasksApi;
     readonly cronJobs: CronJobsApi;

package/dist/http.js

@@ -1,6 +1,7 @@
 import { ChannelsApi } from "./apis/channels.js";
 import { CronJobsApi } from "./apis/cron-jobs.js";
 import { ModelsApi } from "./apis/models.js";
+import { PromptsApi } from "./apis/prompts.js";
 import { SessionAccessApi } from "./apis/session-access.js";
 import { SpaceClient, SpacesApi } from "./apis/spaces.js";
 import { TasksApi } from "./apis/tasks.js";
@@ -11,6 +12,7 @@ export class CohubHttpClient {
     channels;
     user;
     models;
+    prompts;
     sessionAccess;
     tasks;
     cronJobs;
@@ -21,6 +23,7 @@ export class CohubHttpClient {
         this.channels = new ChannelsApi(this.transport);
         this.user = new UserApi(this.transport, options.baseUrl ?? "", options.setStoredAuthToken, options.clearStoredAuthToken);
         this.models = new ModelsApi(options.fetch ?? fetch, options.baseUrl ?? "");
+        this.prompts = new PromptsApi(options.fetch ?? fetch, options.baseUrl ?? "");
         this.sessionAccess = new SessionAccessApi(this.transport);
         this.tasks = new TasksApi(this.transport);
         this.cronJobs = new CronJobsApi(this.transport);

package/dist/index.d.ts

@@ -4,4 +4,4 @@ export { WebsocketClient, createWebsocketClient } from "./websocket.js";
 export { HttpError } from "./transport.js";
 export type { CohubClientOptions, Fetch } from "./transport.js";
 export * from "./types.js";
-export type { SessionEventName, SessionSubscriptionHandlers, SpaceEventName } from "./apis/spaces.js";
+export type { SessionEventName, SessionSubscriptionHandlers, SpaceEventName, WebSocketConnectionState } from "./apis/spaces.js";

package/dist/types.d.ts

@@ -86,12 +86,10 @@ export type SpaceCreateResponse = {
 };
 export type SpaceListItem = SpaceRecord;
 export type SessionMessagesResponse = {
-    space: SpaceRecord;
     session: SessionRecord;
     messages: MessageRecord[];
 };
 export type SessionMessagesPaginatedResponse = {
-    space: SpaceRecord;
     session: SessionRecord;
     messages: MessageRecord[];
     hasMore: boolean;
@@ -102,6 +100,16 @@ export type ModelCatalogEntry = {
     id: string;
     model: Record<string, unknown>;
 };
+export type PromptTemplateCatalogEntry = {
+    name: string;
+    description: string;
+    argumentHint?: string;
+    category?: string;
+    scope: "platform";
+};
+export type PromptTemplateCatalogResponse = {
+    prompts: PromptTemplateCatalogEntry[];
+};
 export type Channel = {
     id: string;
     userUuid: string;
@@ -125,7 +133,6 @@ export type SpaceChannelBindingInput = {
     config?: ChannelConfig | null;
 };
 export type SpaceSessionsResponse = {
-    space: SpaceRecord;
     sessions: SessionRecord[];
 };
 export type UserSshKey = {
@@ -198,7 +205,7 @@ export type CreateScheduledTaskInput = {
     spaceId?: string;
     sessionId?: string;
 };
-export type SpaceRole = "host" | "maker" | "guest";
+export type SpaceRole = "host" | "builder" | "guest";
 export type SpaceMember = {
     userId: string;
     role: SpaceRole;
@@ -209,3 +216,32 @@ export type SpaceAccessPolicy = {
     signed_in_user: SpaceRole | null;
     anonymous_user: SpaceRole | null;
 };
+export type SpaceUsageHourlyStat = {
+    bucketStartAt: string;
+    totalTokens: number;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    costTotal: number;
+    requestCount: number;
+    successCount: number;
+    errorCount: number;
+    models: string[];
+};
+export type SpaceUsageSummary = {
+    totalTokens: number;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    costTotal: number;
+    requestCount: number;
+    successCount: number;
+    errorCount: number;
+};
+export type SpaceUsageResponse = {
+    hourly: SpaceUsageHourlyStat[];
+    summary: SpaceUsageSummary;
+    days: number;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Cohub SDK for spaces, sessions, checkpoints, and realtime agent collaboration.",
   "license": "UNLICENSED",
   "private": false,
@@ -8,10 +8,10 @@
   "sideEffects": false,
   "repository": {
     "type": "git",
-    "url": "https://github.com/neta-art/cohub.git",
+    "url": "https://github.com/talesofai/cohub.git",
     "directory": "packages/sdk"
   },
-  "homepage": "https://github.com/neta-art/cohub",
+  "homepage": "https://github.com/talesofai/cohub",
   "keywords": [
     "cohub",
     "sdk",
@@ -43,14 +43,14 @@
     "dist",
     "README.md"
   ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
   "dependencies": {
     "@neta-art/cohub-protocol": "^1.0.0"
   },
   "devDependencies": {
     "typescript": "^6.0.3"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
   }
-}
+}