@opengeni/sdk 0.52.1 → 1.0.1

package/README.md

@@ -139,6 +139,60 @@ and long-lived credentials are never placed in the WebSocket URL. Hosts may
 inject both `fetch` and the WebSocket factory for authenticated proxies and
 tests; negotiated frame and mutation limits are enforced before work is queued.
 
+## Browser and computer interaction (`@opengeni/sdk/interaction`)
+
+An interaction **resource** is a workspace-scoped, durable object with a stable
+id and lifecycle, such as a `BrowserSession`, `ComputerSession`, browser
+identity, network route, auth run, or pending human intervention. This use of
+"resource" is unrelated to the file/repository `resources` attached to a chat
+message. A **facade** is only the typed, resource-oriented SDK organization
+shown below; it owns no state or authority of its own.
+
+`OpenGeniClient.interaction` is the framework-free resource facade over the same
+public BrowserSession, ComputerSession, identity, auth, network-route, and human
+intervention APIs used by OpenGeni itself. It adds no second state or execution
+path: facade methods call the ordinary typed transport, and every mutation still
+uses the canonical generation fences, operation receipt, permission check, and
+placement controller.
+
+```ts
+const browser = await client.interaction.browsers.currentOrOpen({
+  workspaceId,
+  associationSessionId: session.id,
+  initialUrl: "http://127.0.0.1:3000",
+});
+
+const { targets } = await browser.tabs.list();
+const target = targets.find((candidate) => candidate.selected) ?? targets[0]!;
+const page = await browser.observe(target.id);
+
+const receipt = await browser.act({
+  operationId: crypto.randomUUID(),
+  targetId: target.id,
+  expectedTargetGeneration: target.targetGeneration,
+  expectedDocumentGeneration: target.documentGeneration,
+  expectedFrameId: page.frameId,
+  action: { type: "click", locator: { kind: "role", role: "button", name: "Continue" } },
+});
+
+if (receipt.state === "outcome_unknown") {
+  // Do not replay a mutation blindly. Re-observe, then inspect this exact receipt.
+  console.log(await browser.receipt(receipt.operationId));
+}
+```
+
+Browser identities are immutable version graphs: live browser state stays
+private until `browser.publishRevision(...)` explicitly creates a new revision.
+Protected auth fills resolve connection secrets only inside the broker/controller
+path; normal SDK reads, observations, diagnostics, receipts, and logs never
+return credential values. `client.openWorkspaceInteractionRevisionStream(...)`
+is the low-volume latest-wins invalidation stream for keeping resource catalogs
+fresh without attaching them to an inference/session event stream.
+
+Use the flat `OpenGeniClient` interaction methods when implementing a proxy or
+custom transport. Use `client.interaction` for application logic. Both are the
+same API and authority boundary.
+
 ## Workspace artifacts
 
 Workspace artifacts are generic, immutable HTML publications. The SDK does not
@@ -484,13 +538,13 @@ Every public endpoint group has typed methods:
 | Packs | `listPacks`, `registerPack`, `getPack`, `enablePack`, `deletePack`, `listPackInstallations` |
 | Capabilities | `listCapabilities`, `createCapability`, `enableCapability`, `disableCapability`, `discoverMcpCapabilities` |
 | Plugin packages | `previewPlugin`, `installPlugin`, `previewPluginUninstall`, `uninstallPlugin` |
-| API Integrations | `listApiIntegrationPresets`, `listApiIntegrations`, `previewApiIntegration`, `startApiIntegrationOAuth`, `installApiIntegration`, `previewApiIntegrationUninstall`, `uninstallApiIntegration`, `listIntegrationFeatures`, `configureIntegrationFeature`, `pauseIntegrationFeature`, `resumeIntegrationFeature`, `removeIntegrationFeature`, `browseGoogleDriveIntegrationSource`, `saveGoogleDriveIntegrationSource` |
+| API Integrations | `listIntegrationDefinitions`, `listApiIntegrations`, `previewApiIntegration`, `startApiIntegrationOAuth`, `installApiIntegration`, `previewApiIntegrationUninstall`, `uninstallApiIntegration`, `listIntegrationFacets`, `configureIntegrationFacet`, `pauseIntegrationFacet`, `resumeIntegrationFacet`, `removeIntegrationFacet`, `browseGoogleDriveFacetSource`, `saveGoogleDriveFacetSource` |
 | Remote Skills | `previewSkillImport`, `installSkill`, `previewSkillUninstall`, `uninstallSkill` |
 | GitHub | `getGitHubApp`, `githubConnectUrl`, `listGitHubRepositories`, `syncGitHubRepositories`, `createGitHubAppManifest` |
 | API keys | `listApiKeys`, `createApiKey`, `deleteApiKey` |
 | Billing | `getBilling`, `getBillingUsage`, `getBillingEntitlements`, `createBillingCheckout` |
 
-`listApiIntegrationPresets` returns safe curated-provider metadata without any
+`listIntegrationDefinitions` returns safe Integration Definition metadata without any
 deployment OAuth client credentials. API Integrations are multi-instance:
 `installApiIntegration` may supply a
 stable `instanceKey`, display name, and exact Connection. The returned
@@ -499,14 +553,14 @@ selected in one session without tool-name collision. Uninstall preview and
 uninstall both require the exact `instanceKey` and instance version; neither
 operation disconnects the underlying Connection.
 
-Adapter-owned Integration features are listed and mutated under the exact
-`capabilityId` + `instanceKey` + `featureKey`. Generic primitive schemas use
-`configureIntegrationFeature`; lifecycle changes and removal require the
+Adapter-owned Integration facets are listed and mutated under the exact
+`capabilityId` + `instanceKey` + `facetKey`. Generic primitive schemas use
+`configureIntegrationFacet`; lifecycle changes and removal require the
 binding's exact optimistic version plus a caller UUID idempotency key. Google
 Drive's nested folder/Shared Drive source schema has dedicated
-`browseGoogleDriveIntegrationSource` and `saveGoogleDriveIntegrationSource`
+`browseGoogleDriveFacetSource` and `saveGoogleDriveFacetSource`
 methods. They verify provider metadata through that instance's exact Connection
-and persist only a versioned feature binding—never provider credentials, page
+and persist only a versioned facet binding—never provider credentials, page
 tokens, or selected-source configuration on the Connection.
 
 ### Protocol routes (deliberately not in the SDK)
@@ -560,3 +614,9 @@ packages. `test/contract-parity.test.ts` pins them to `@opengeni/contracts`,
 so contract drift fails the repo gate instead of shipping. `SessionEvent.type`
 is an open union: unknown event types from newer servers flow through instead
 of breaking older SDK consumers.
+
+Hosts, test doubles, and same-origin proxies must import
+`OPENGENI_API_CONTRACT_REVISION` from `@opengeni/sdk` when constructing a client
+configuration or contract header. Do not copy its string value: the revision is
+an executable compatibility boundary, and `getClientConfig()` intentionally
+fails closed when server and SDK revisions differ.

package/dist/artifacts.js

@@ -1,10 +1,10 @@
 import {
   OpenGeniClient
-} from "./chunk-FHI4DFIG.js";
-import "./chunk-ILQZR5N6.js";
-import "./chunk-V5F253OG.js";
-import "./chunk-MZWTWOX6.js";
-import "./chunk-FRJFNDIR.js";
+} from "./chunk-TYZ4JL4J.js";
+import "./chunk-YGH5P47G.js";
+import "./chunk-4DV37UUA.js";
+import "./chunk-GU6JF75T.js";
+import "./chunk-ST5DDKJP.js";
 export {
   OpenGeniClient
 };

package/dist/{chunk-FRJFNDIR.js → chunk-4DV37UUA.js}

@@ -47,6 +47,9 @@ var SESSION_EVENT_TYPES = [
   "artifact.created",
   "goal.set",
   "goal.updated",
+  "goal.progress",
+  "goal.rewrite.proposed",
+  "goal.rewrite.rejected",
   "goal.completed",
   "goal.paused",
   "goal.resumed",
@@ -86,6 +89,7 @@ var SESSION_EVENT_TYPES = [
   "terminal.pty.output.delta",
   "terminal.pty.exited",
   "session.title_set",
+  "session.visibility.changed",
   "session.mcp.approval_policy.updated",
   "session.tool_policy.updated",
   // Multi-account Codex (P1): the session's inference account changed.
@@ -175,7 +179,7 @@ var KNOWN_PERMISSIONS = [
   "artifacts:read",
   "artifacts:publish"
 ];
-var OPENGENI_API_CONTRACT_REVISION = "2026-08-social-provider-tools-v1";
+var OPENGENI_API_CONTRACT_REVISION = "2026-08-model-context-v1";
 var OPENGENI_API_CONTRACT_HEADER = "x-opengeni-api-contract";
 var OPENGENI_CORRELATION_HEADER = "x-opengeni-correlation-id";
 var RETAINED_OUTPUT_DEFAULT_PAGE_BYTES = 256 * 1024;
@@ -215,4 +219,4 @@ export {
   GENERATED_VIDEO_MAX_BYTES,
   KNOWN_USAGE_EVENT_TYPES
 };
-//# sourceMappingURL=chunk-FRJFNDIR.js.map
+//# sourceMappingURL=chunk-4DV37UUA.js.map