@semiont/sdk 0.5.6 → 0.5.7

package/README.md

@@ -87,7 +87,7 @@ const client = new SemiontClient(localTransport, localContentTransport);
 - **Collaboration primitives** — fire-and-forget signals on the verb namespaces (`beckon.hover`, `bind.initiate`, `mark.changeShape`, `browse.click`, ...) coordinate attention and intent across participants. Not afterthoughts, not browser-app fluff: they're how a multi-participant session stays coherent.
 - **Session layer** — `SemiontSession` (per-KB authentication, token refresh, lifecycle), `SemiontBrowser` (multi-KB orchestration), and `SessionStorage` adapters (`InMemorySessionStorage`, plus a browser-backed one in `@semiont/react-ui`).
 - **Flow state machines** — RxJS-based factories (`createMarkStateUnit`, `createGatherStateUnit`, `createMatchStateUnit`, `createYieldStateUnit`, `createBeckonStateUnit`) that wrap each long-running flow with `loading$` / `error$` / progress observables. UI-shape-agnostic — any consumer (browser, terminal, mobile, daemon) can subscribe.
-- **`WorkerBus`** — the transport-neutral channel-bus interface that worker-side adapters consume. Domain-specific worker adapters live with their domain — `createJobClaimAdapter` and `createJobQueueStateUnit` in [`@semiont/jobs`](https://github.com/The-AI-Alliance/semiont/tree/main/packages/jobs); `createSmelterActorStateUnit` in [`@semiont/make-meaning`](https://github.com/The-AI-Alliance/semiont/tree/main/packages/make-meaning) — and consume `WorkerBus` from here.
+- **`WorkerBus`** — the transport-neutral channel-bus interface that worker-side adapters consume. Domain-specific worker adapters live with their domain — `createJobClaimAdapter` in [`@semiont/jobs`](https://github.com/The-AI-Alliance/semiont/tree/main/packages/jobs); `createSmelterActorStateUnit` in [`@semiont/make-meaning`](https://github.com/The-AI-Alliance/semiont/tree/main/packages/make-meaning) — and consume `WorkerBus` from here.
 - **Helpers** — `bus-request` (correlation-ID request/reply), the cache primitive backing live queries, and `createSearchPipeline` (debounced-search RxJS pipeline).
 
 Page-shaped state machines (admin tables, compose page, resource viewer page, etc.) live in [`@semiont/react-ui`](https://github.com/The-AI-Alliance/semiont/tree/main/packages/react-ui), alongside the components that render them. Those are framework-neutral but tied to the Semiont web frontend's specific page taxonomy; they don't apply to non-web consumers.
@@ -104,7 +104,7 @@ Page-shaped state machines (admin tables, compose page, resource viewer page, et
 - The transport-neutral `WorkerBus` interface (worker adapters live in their domain packages — `@semiont/jobs`, `@semiont/make-meaning`)
 - Branded ID types, the unified error hierarchy, the `TransportErrorCode` neutral vocabulary
 
-Nothing page-shaped, nothing web-shell-shaped. A TUI, mobile reader, daemon, or AI agent installs `@semiont/sdk` alone (plus a transport package — `@semiont/api-client` for HTTP, `@semiont/make-meaning` for in-process).
+Nothing page-shaped, nothing web-shell-shaped. A TUI, mobile reader, daemon, or AI agent installs `@semiont/sdk` alone (plus a transport package — `@semiont/http-transport` for HTTP, `@semiont/make-meaning` for in-process).
 
 ## Installation
 
@@ -245,7 +245,7 @@ Apache-2.0 — see [LICENSE](https://github.com/The-AI-Alliance/semiont/blob/mai
 ## Related packages
 
 - [`@semiont/core`](https://github.com/The-AI-Alliance/semiont/tree/main/packages/core) — domain types, `ITransport` contract, OpenAPI-derived schemas
-- [`@semiont/api-client`](https://github.com/The-AI-Alliance/semiont/tree/main/packages/api-client) — HTTP transport (`HttpTransport`, `HttpContentTransport`)
+- [`@semiont/http-transport`](https://github.com/The-AI-Alliance/semiont/tree/main/packages/http-transport) — HTTP transport (`HttpTransport`, `HttpContentTransport`)
 - [`@semiont/make-meaning`](https://github.com/The-AI-Alliance/semiont/tree/main/packages/make-meaning) — in-process transport (`LocalTransport`) and the actor model behind it
 - [`@semiont/observability`](https://github.com/The-AI-Alliance/semiont/tree/main/packages/observability) — OpenTelemetry tracing the SDK propagates across the bus
 - [`@semiont/react-ui`](https://github.com/The-AI-Alliance/semiont/tree/main/packages/react-ui) — React bindings (`useStateUnit`, web `SessionStorage`)

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export { firstValueFrom, lastValueFrom } from 'rxjs';
 import * as _semiont_core from '@semiont/core';
 import { ResourceId, components, UserDID, paths, BackendDownload, ProgressEvent, AnnotationId, BodyOperation, EventMap, ResourceDescriptor, Annotation, TagSchema, GraphConnection, Motivation, GatheredContext, JobId, ITransport, EventBus, IContentTransport, IBackendOperations, BaseUrl, AccessToken, SemiontError, ConnectionState, Selector } from '@semiont/core';
 export { AccessToken, Annotation, AnnotationId, BaseUrl, BodyItem, BodyOperation, ConnectionState, EntityType, EventMap, GatheredContext, IContentTransport, ITransport, Logger, Motivation, RefreshToken, ResourceDescriptor, ResourceId, SemiontError, TagCategory, TagSchema, UserId, accessToken, annotationId, baseUrl, entityType, refreshToken, resourceId, userId } from '@semiont/core';
-export { APIError, HttpContentTransport, HttpTransport, HttpTransportConfig, TokenRefresher } from '@semiont/api-client';
+export { APIError, HttpContentTransport, HttpTransport, HttpTransportConfig, TokenRefresher } from '@semiont/http-transport';
 
 /**
  * Thenable Observable subclasses.
@@ -152,6 +152,7 @@ declare class UploadObservable extends Observable<UploadProgress> implements Pro
  */
 
 type StoredEventResponse$1 = components['schemas']['StoredEventResponse'];
+type GetResourceResponse$1 = components['schemas']['GetResourceResponse'];
 type GatherProgress = components['schemas']['GatherProgress'];
 type MatchSearchResult = components['schemas']['MatchSearchResult'];
 type JobProgress$2 = components['schemas']['JobProgress'];
@@ -318,15 +319,12 @@ interface BrowseNamespace$1 {
     referencedBy(resourceId: ResourceId): CacheObservable<ReferencedByEntry[]>;
     events(resourceId: ResourceId): CacheObservable<StoredEventResponse$1[]>;
     resourceContent(resourceId: ResourceId): Promise<string>;
-    resourceRepresentation(resourceId: ResourceId, options?: {
-        accept?: string;
-    }): Promise<{
+    resourceGraph(resourceId: ResourceId): Promise<GetResourceResponse$1>;
+    resourceRepresentation(resourceId: ResourceId): Promise<{
         data: ArrayBuffer;
         contentType: string;
     }>;
-    resourceRepresentationStream(resourceId: ResourceId, options?: {
-        accept?: string;
-    }): Promise<{
+    resourceRepresentationStream(resourceId: ResourceId): Promise<{
         stream: ReadableStream<Uint8Array>;
         contentType: string;
     }>;
@@ -557,6 +555,7 @@ interface AdminNamespace$1 {
 }
 
 type StoredEventResponse = components['schemas']['StoredEventResponse'];
+type GetResourceResponse = components['schemas']['GetResourceResponse'];
 type ResourceListFilters = {
     limit?: number;
     archived?: boolean;
@@ -631,15 +630,18 @@ declare class BrowseNamespace implements BrowseNamespace$1 {
     referencedBy(resourceId: ResourceId): CacheObservable<ReferencedByEntry[]>;
     events(resourceId: ResourceId): CacheObservable<StoredEventResponse[]>;
     resourceContent(resourceId: ResourceId): Promise<string>;
-    resourceRepresentation(resourceId: ResourceId, options?: {
-        accept?: string;
-    }): Promise<{
+    /**
+     * Fetch the resource's JSON-LD metadata graph (descriptor + annotations +
+     * inbound entity references). One-shot, uncached, dereferenced via the
+     * transport's HTTP `/jsonld` face (bus-free) — the LD view an external
+     * linked-data client gets. See `.plans/SIMPLER-JSON-LD.md` §5.
+     */
+    resourceGraph(resourceId: ResourceId): Promise<GetResourceResponse>;
+    resourceRepresentation(resourceId: ResourceId): Promise<{
         data: ArrayBuffer;
         contentType: string;
     }>;
-    resourceRepresentationStream(resourceId: ResourceId, options?: {
-        accept?: string;
-    }): Promise<{
+    resourceRepresentationStream(resourceId: ResourceId): Promise<{
         stream: ReadableStream<Uint8Array>;
         contentType: string;
     }>;
@@ -1720,7 +1722,7 @@ declare function createSearchPipeline<T>(fetch: (query: string) => Observable<T[
  * (e.g. `JobClaimAdapter` in `@semiont/jobs`, `SmelterActorStateUnit` in
  * `@semiont/make-meaning`) need.
  *
- * Transport-neutral by design. HTTP `ActorStateUnit` (from `@semiont/api-client`)
+ * Transport-neutral by design. HTTP `ActorStateUnit` (from `@semiont/http-transport`)
  * satisfies it directly; an in-process worker can pass a small shim around
  * an `EventBus` with a `() => Promise<void>` `emit` that calls into the
  * actor system.

package/dist/index.js

@@ -1,10 +1,10 @@
-import { SemiontError, annotationId, resourceId, email, googleCredential, refreshToken, EventBus, baseUrl, accessToken, searchQuery } from '@semiont/core';
+import { SemiontError, decodeWithCharset, annotationId, resourceId, email, googleCredential, refreshToken, EventBus, baseUrl, accessToken, searchQuery } from '@semiont/core';
 export { SemiontError, accessToken, annotationId, baseUrl, entityType, refreshToken, resourceId, userId } from '@semiont/core';
 import { Observable, lastValueFrom, firstValueFrom, merge, TimeoutError, throwError, map as map$1, BehaviorSubject, Subject, Subscription, of, distinctUntilChanged as distinctUntilChanged$1 } from 'rxjs';
 export { firstValueFrom, lastValueFrom } from 'rxjs';
 import { filter, map, take, timeout, catchError, takeUntil, startWith, debounceTime, distinctUntilChanged, switchMap } from 'rxjs/operators';
-import { HttpTransport, HttpContentTransport, APIError } from '@semiont/api-client';
-export { APIError, HttpContentTransport, HttpTransport } from '@semiont/api-client';
+import { HttpTransport, HttpContentTransport, APIError } from '@semiont/http-transport';
+export { APIError, HttpContentTransport, HttpTransport } from '@semiont/http-transport';
 
 // src/client.ts
 var StreamObservable = class _StreamObservable extends Observable {
@@ -421,15 +421,23 @@ var BrowseNamespace = class {
   }
   // ── One-shot reads ──────────────────────────────────────────────────────
   async resourceContent(resourceId2) {
-    const result = await this.content.getBinary(resourceId2, { accept: "text/plain" });
-    const decoder = new TextDecoder();
-    return decoder.decode(result.data);
+    const result = await this.content.getBinary(resourceId2);
+    return decodeWithCharset(result.data, result.contentType);
   }
-  async resourceRepresentation(resourceId2, options) {
-    return this.content.getBinary(resourceId2, options?.accept ? { accept: options.accept } : void 0);
+  /**
+   * Fetch the resource's JSON-LD metadata graph (descriptor + annotations +
+   * inbound entity references). One-shot, uncached, dereferenced via the
+   * transport's HTTP `/jsonld` face (bus-free) — the LD view an external
+   * linked-data client gets. See `.plans/SIMPLER-JSON-LD.md` §5.
+   */
+  async resourceGraph(resourceId2) {
+    return this.content.getResourceGraph(resourceId2);
+  }
+  async resourceRepresentation(resourceId2) {
+    return this.content.getBinary(resourceId2);
   }
-  async resourceRepresentationStream(resourceId2, options) {
-    return this.content.getBinaryStream(resourceId2, options?.accept ? { accept: options.accept } : void 0);
+  async resourceRepresentationStream(resourceId2) {
+    return this.content.getBinaryStream(resourceId2);
   }
   async resourceEvents(resourceId2) {
     const result = await busRequest(