@opengeni/sdk 2.6.0-canary.0 → 3.1.0

package/README.md

@@ -52,6 +52,45 @@ const operatorClient = new OpenGeniDocumentAuthorityClient({
 });
 ```
 
+## Related-work discovery
+
+`listAgentTopology` returns a bounded hierarchy page plus provider-neutral
+`relatedWork` evidence. A text query searches durable semantic titles, active
+goals, and typed work claims; it never searches the opening prompt. An exact
+subject filter looks up one canonical typed identity:
+
+```ts
+const page = await client.listAgentTopology(workspaceId, {
+  query: "permission scoped discovery",
+  statuses: ["running", "requires_action"],
+  activeOnly: true,
+  recentHours: 72,
+  claimLimit: 4,
+});
+
+for (const session of page.sessions) {
+  if (!session.relatedWork.possibleOverlap) continue;
+  console.log(session.title, session.relatedWork.match, session.relatedWork.claims);
+}
+
+const exact = await client.listAgentTopology(workspaceId, {
+  subject: {
+    namespace: "github",
+    type: "pull_request",
+    canonicalKey: "acme/app#42",
+  },
+});
+```
+
+The evidence is always advisory: `advisoryOnly` and `noAdditionalAccess` are
+literal `true` fields, and receiving a row does not authorize detail, message,
+or control operations. Preserve `nextCursor` with the exact same filters;
+relevance cursors are filter- and activity-snapshot-bound. A topology response
+may carry `humanAdvisoriesEnabled: false`, which lets a human-facing client hide
+the advisory UI without changing stored evidence or API authority. See
+[`docs/work-discovery.md`](../../docs/work-discovery.md) for ranking, bounds,
+claim lifecycle, and rollout semantics.
+
 ## Session visibility and forks
 
 For organizations with session-tenancy activation, a canonical managed-cookie

package/dist/artifacts.js

@@ -1,9 +1,9 @@
 import {
   OpenGeniClient
-} from "./chunk-JVRUGVPU.js";
-import "./chunk-C7AIXTNY.js";
-import "./chunk-4VCQBOOQ.js";
-import "./chunk-Y7PC524F.js";
+} from "./chunk-VUQZAB3O.js";
+import "./chunk-TX3EIENU.js";
+import "./chunk-7ZXBPJZP.js";
+import "./chunk-YTAWBDO2.js";
 import "./chunk-GW3EJ2GP.js";
 import "./chunk-C4DJPZRU.js";
 export {

package/dist/browser.js

@@ -3,11 +3,11 @@ import {
 } from "./chunk-VYCTL62C.js";
 import {
   OpenGeniClient
-} from "./chunk-4VCQBOOQ.js";
+} from "./chunk-7ZXBPJZP.js";
 import {
   OPENGENI_API_CONTRACT_HEADER,
   OPENGENI_API_CONTRACT_REVISION
-} from "./chunk-Y7PC524F.js";
+} from "./chunk-YTAWBDO2.js";
 import "./chunk-GW3EJ2GP.js";
 import {
   OpenGeniApiContractMismatchError,

package/dist/{chunk-4VCQBOOQ.js → chunk-7ZXBPJZP.js}

@@ -5,7 +5,7 @@ import {
   OPENGENI_API_CONTRACT_REVISION,
   OPENGENI_CORRELATION_HEADER,
   RETAINED_OUTPUT_MAX_PAGE_BYTES
-} from "./chunk-Y7PC524F.js";
+} from "./chunk-YTAWBDO2.js";
 import {
   OpenGeniInteractionClient
 } from "./chunk-GW3EJ2GP.js";
@@ -1140,7 +1140,10 @@ var OpenGeniClient = class {
   }
   /** Compact, bounded workspace agent hierarchy page. */
   async listAgentTopology(workspaceId, options = {}) {
-    const search = options.search?.trim();
+    const query = options.query?.trim() || options.search?.trim();
+    if (query && options.subject) {
+      throw new TypeError("listAgentTopology query cannot be combined with an exact subject");
+    }
     return await this.requestJson(
       "GET",
       `/v1/workspaces/${workspaceId}/agent-topology`,
@@ -1148,8 +1151,18 @@ var OpenGeniClient = class {
       {
         ...options.limit !== void 0 ? { limit: String(options.limit) } : {},
         ...options.parentSessionId === void 0 ? {} : { parentSessionId: options.parentSessionId ?? "null" },
+        ...options.rootSessionId ? { rootSessionId: options.rootSessionId } : {},
         ...options.cursor ? { cursor: options.cursor } : {},
-        ...search ? { search } : {}
+        ...query ? { query } : {},
+        ...options.statuses?.length ? { statuses: options.statuses.join(",") } : {},
+        ...options.activeOnly !== void 0 ? { activeOnly: options.activeOnly ? "true" : "false" } : {},
+        ...options.recentHours !== void 0 ? { recentHours: String(options.recentHours) } : {},
+        ...options.subject ? {
+          subjectNamespace: options.subject.namespace,
+          subjectType: options.subject.type,
+          subjectKey: options.subject.canonicalKey
+        } : {},
+        ...options.claimLimit !== void 0 ? { claimLimit: String(options.claimLimit) } : {}
       }
     );
   }
@@ -5465,4 +5478,4 @@ export {
   parseMediaGenerationResult,
   OpenGeniClient
 };
-//# sourceMappingURL=chunk-4VCQBOOQ.js.map
+//# sourceMappingURL=chunk-7ZXBPJZP.js.map