@neta-art/cohub 2.11.2 → 2.12.0

package/dist/chunks/http.d.ts

@@ -568,6 +568,7 @@ declare class ReferencesApi {
     groupBy?: ReferenceAggregateGroupBy;
     kinds?: ReferenceKind[];
     days?: number;
+    limit?: number;
   }, customFetch?: Fetch): Promise<ReferenceAggregateResponse>;
 }
 //#endregion
@@ -817,6 +818,11 @@ declare class SpacesApi {
   private readonly transport;
   constructor(transport: HttpTransport);
   list(customFetch?: Fetch): Promise<SpaceRecord[]>;
+  /**
+   * Resolve the user's default space (owned/member home, else most recent).
+   * When the account has no accessible space, the API creates a blank Home
+   * space (`slug=home`) and returns it.
+   */
   getDefault(customFetch?: Fetch): Promise<SpaceDefaultResponse>;
   get(spaceId: string, customFetch?: Fetch): Promise<SpaceRecord>;
   getBySlug(username: string, slug: string, customFetch?: Fetch): Promise<SpaceRecord>;

package/dist/chunks/http.js

@@ -311,6 +311,7 @@ var ReferencesApi = class {
 		if (input.groupBy) params.set("groupBy", input.groupBy);
 		if (input.kinds && input.kinds.length > 0) params.set("kinds", input.kinds.join(","));
 		if (input.days !== void 0) params.set("days", String(input.days));
+		if (input.limit !== void 0) params.set("limit", String(input.limit));
 		return this.transport.request(`/api/references/aggregate?${params.toString()}`, { fetch: customFetch });
 	}
 };
@@ -1357,6 +1358,11 @@ var SpacesApi = class {
 			fetch: customFetch
 		});
 	}
+	/**
+	* Resolve the user's default space (owned/member home, else most recent).
+	* When the account has no accessible space, the API creates a blank Home
+	* space (`slug=home`) and returns it.
+	*/
 	getDefault(customFetch) {
 		return this.transport.request("/api/spaces/default", {
 			method: "GET",

package/dist/chunks/websocket.d.ts

@@ -2205,7 +2205,7 @@ type ExploreSpacesResponse = {
   sections: ExploreSection[];
   spaces: ExploreSpaceItem[];
 };
-type Permission = "space.view" | "space.edit" | "space.label.view" | "space.label.manage" | "space.label.assign" | "session.view" | "session.edit" | "session.prompt.readonly" | "session.prompt.fullaccess" | "generation.create" | "file.view" | "file.view.filtered" | "file.edit" | "checkpoint.view" | "checkpoint.edit" | "member.view" | "member.manage" | "channel.view" | "channel.manage" | "cronjob.view" | "cronjob.manage" | "taskrun.view" | "sandbox.view" | "sandbox.manage" | "mod.view" | "mod.manage" | "user.space.list" | "user.session.list" | "user.usage.read";
+type Permission = "space.view" | "space.edit" | "space.label.view" | "space.label.manage" | "space.label.assign" | "session.view" | "session.edit" | "session.prompt.readonly" | "session.prompt.fullaccess" | "generation.create" | "file.view" | "file.view.filtered" | "file.edit" | "checkpoint.view" | "checkpoint.edit" | "member.view" | "member.manage" | "references.view" | "channel.view" | "channel.manage" | "cronjob.view" | "cronjob.manage" | "taskrun.view" | "sandbox.view" | "sandbox.manage" | "mod.view" | "mod.manage" | "user.space.list" | "user.session.list" | "user.usage.read";
 type SpaceAccess = {
   role: SpaceRole | null;
   permissions: Permission[];
@@ -2339,23 +2339,23 @@ type AcceptInvitationResponse = {
   spaceName: string;
   role: SpaceRole;
 };
-type ReferenceResourceType = "space" | "session" | "checkpoint" | "user" | "file" | "tool";
+type ReferenceResourceType = "turn" | "session" | "space" | "checkpoint" | "file";
 /**
- * Resource types usable as a query `source`. Only these have an owning space to
- * authorize against; user/file/tool appear only as reference targets.
+ * Resource types usable as a query `source`: they resolve to an owning space to
+ * authorize against. `turn` gives the finest precision; session/space roll up.
+ * `file` appears only as an edge target, never as a queryable source.
  */
-type ReferenceQueryableType = "space" | "session" | "checkpoint";
-type ReferenceKind = "session_fork" | "space_fork" | "checkpoint_fork" | "mention" | "tool_call" | "mod" | "participant";
+type ReferenceQueryableType = "turn" | "session" | "space" | "checkpoint";
+type ReferenceKind = "session_fork" | "space_fork" | "checkpoint_fork" | "mod" | "mention" | "tool_call" | "agent_tool_file_read" | "agent_tool_file_write" | "agent_tool_file_edit" | "agent_tool_file_ls" | "agent_tool_file_find" | "agent_tool_file_grep";
 type ReferenceDirection = "out" | "in" | "both";
 type ReferenceRecord = {
   kind: ReferenceKind;
   sourceType: ReferenceResourceType;
   sourceId: string;
-  sourceTurnId: string | null;
   targetType: ReferenceResourceType;
   targetId: string;
-  spaceId: string;
-  sessionId: string | null;
+  sourceSpaceId: string;
+  sourceSessionId: string | null;
   count: number;
   createdAt: string;
   updatedAt: string;
@@ -2366,7 +2366,7 @@ type ReferenceQueryResponse = {
   direction: ReferenceDirection;
   references: ReferenceRecord[];
 };
-type ReferenceAggregateGroupBy = "kind" | "targetType" | "sourceType" | "day";
+type ReferenceAggregateGroupBy = "kind" | "targetType" | "target" | "sourceType" | "day";
 type ReferenceAggregateGroup = {
   group: string;
   references: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub",
-  "version": "2.11.2",
+  "version": "2.12.0",
   "description": "Cohub SDK for spaces, sessions, checkpoints, and realtime agent collaboration.",
   "license": "Apache-2.0",
   "private": false,