@semiont/sdk 0.5.3 → 0.5.4

package/dist/namespaces/admin.d.ts

@@ -0,0 +1,27 @@
+/**
+ * AdminNamespace — administration. Backend ops only; no bus.
+ */
+import type { UserDID, ProgressEvent, components, paths } from '@semiont/core';
+import type { BackendDownload, IBackendOperations } from '@semiont/core';
+import { StreamObservable } from '../awaitable';
+import type { AdminNamespace as IAdminNamespace, User, RequestContent, ResponseContent } from './types';
+type AdminUserStatsResponse = components['schemas']['AdminUserStatsResponse'];
+type OAuthConfigResponse = components['schemas']['OAuthConfigResponse'];
+export declare class AdminNamespace implements IAdminNamespace {
+    private readonly backend;
+    constructor(backend: IBackendOperations);
+    users(): Promise<User[]>;
+    userStats(): Promise<AdminUserStatsResponse>;
+    updateUser(userId: UserDID, data: RequestContent<paths['/api/admin/users/{id}']['patch']>): Promise<User>;
+    oauthConfig(): Promise<OAuthConfigResponse>;
+    healthCheck(): Promise<ResponseContent<paths['/api/health']['get']>>;
+    status(): Promise<ResponseContent<paths['/api/status']['get']>>;
+    backup(): Promise<BackendDownload>;
+    restore(file: File): StreamObservable<ProgressEvent>;
+    exportKnowledgeBase(params?: {
+        includeArchived?: boolean;
+    }): Promise<BackendDownload>;
+    importKnowledgeBase(file: File): StreamObservable<ProgressEvent>;
+}
+export {};
+//# sourceMappingURL=admin.d.ts.map

package/dist/namespaces/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../src/namespaces/admin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,IAAI,eAAe,EAAE,IAAI,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAExG,KAAK,sBAAsB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,wBAAwB,CAAC,CAAC;AAC9E,KAAK,mBAAmB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,qBAAqB,CAAC,CAAC;AAExE,qBAAa,cAAe,YAAW,eAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,kBAAkB;IAElD,KAAK,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAKxB,SAAS,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAI5C,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAI3C,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAIpE,MAAM,IAAI,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAI/D,MAAM,IAAI,OAAO,CAAC,eAAe,CAAC;IAIxC,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,gBAAgB,CAAC,aAAa,CAAC;IAI9C,mBAAmB,CAAC,MAAM,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAI3F,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,gBAAgB,CAAC,aAAa,CAAC;CAGjE"}

package/dist/namespaces/auth.d.ts

@@ -0,0 +1,26 @@
+/**
+ * AuthNamespace — authentication. Backend ops only; no bus.
+ */
+import type { ResourceId, components } from '@semiont/core';
+import type { IBackendOperations } from '@semiont/core';
+import type { AuthNamespace as IAuthNamespace, User } from './types';
+type AuthResponse = components['schemas']['AuthResponse'];
+type TokenRefreshResponse = components['schemas']['TokenRefreshResponse'];
+export declare class AuthNamespace implements IAuthNamespace {
+    private readonly backend;
+    constructor(backend: IBackendOperations);
+    password(emailStr: string, passwordStr: string): Promise<AuthResponse>;
+    google(credential: string): Promise<AuthResponse>;
+    refresh(token: string): Promise<TokenRefreshResponse>;
+    logout(): Promise<void>;
+    me(): Promise<User>;
+    acceptTerms(): Promise<void>;
+    mcpToken(): Promise<{
+        token: string;
+    }>;
+    mediaToken(resourceId: ResourceId): Promise<{
+        token: string;
+    }>;
+}
+export {};
+//# sourceMappingURL=auth.d.ts.map

package/dist/namespaces/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/namespaces/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,IAAI,cAAc,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAErE,KAAK,YAAY,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,cAAc,CAAC,CAAC;AAC1D,KAAK,oBAAoB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,sBAAsB,CAAC,CAAC;AAE1E,qBAAa,aAAc,YAAW,cAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,kBAAkB;IAElD,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAItE,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAIjD,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAIrD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IAInB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,QAAQ,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAItC,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAGrE"}

package/dist/namespaces/beckon.d.ts

@@ -0,0 +1,12 @@
+import type { AnnotationId, EventBus, ResourceId } from '@semiont/core';
+import type { ITransport } from '@semiont/core';
+import type { BeckonNamespace as IBeckonNamespace } from './types';
+export declare class BeckonNamespace implements IBeckonNamespace {
+    private readonly transport;
+    private readonly bus;
+    constructor(transport: ITransport, bus: EventBus);
+    attention(resourceId: ResourceId, annotationId: AnnotationId): void;
+    hover(annotationId: AnnotationId | null): void;
+    sparkle(annotationId: AnnotationId): void;
+}
+//# sourceMappingURL=beckon.d.ts.map

package/dist/namespaces/beckon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beckon.d.ts","sourceRoot":"","sources":["../../src/namespaces/beckon.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,IAAI,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEnE,qBAAa,eAAgB,YAAW,gBAAgB;IAEpD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,SAAS,EAAE,UAAU,EACrB,GAAG,EAAE,QAAQ;IAGhC,SAAS,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,GAAG,IAAI;IAInE,KAAK,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI;IAK9C,OAAO,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI;CAG1C"}

package/dist/namespaces/bind.d.ts

@@ -0,0 +1,11 @@
+import type { ResourceId, AnnotationId, BodyOperation, EventBus, EventMap } from '@semiont/core';
+import type { ITransport } from '@semiont/core';
+import type { BindNamespace as IBindNamespace } from './types';
+export declare class BindNamespace implements IBindNamespace {
+    private readonly transport;
+    private readonly bus;
+    constructor(transport: ITransport, bus: EventBus);
+    body(resourceId: ResourceId, annotationId: AnnotationId, operations: BodyOperation[]): Promise<void>;
+    initiate(input: EventMap['bind:initiate']): void;
+}
+//# sourceMappingURL=bind.d.ts.map

package/dist/namespaces/bind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind.d.ts","sourceRoot":"","sources":["../../src/namespaces/bind.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACjG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,IAAI,cAAc,EAAE,MAAM,SAAS,CAAC;AAE/D,qBAAa,aAAc,YAAW,cAAc;IAEhD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,SAAS,EAAE,UAAU,EACrB,GAAG,EAAE,QAAQ;IAG1B,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1G,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,IAAI;CAIjD"}

package/dist/namespaces/browse.d.ts

@@ -0,0 +1,111 @@
+import { CacheObservable } from '../awaitable';
+import type { Annotation, EventBus, ResourceDescriptor, ResourceId, AnnotationId, GraphConnection, Motivation, TagSchema, components } from '@semiont/core';
+import type { ITransport, IContentTransport } from '@semiont/core';
+import type { BrowseNamespace as IBrowseNamespace, ReferencedByEntry, AnnotationHistoryResponse } from './types';
+type StoredEventResponse = components['schemas']['StoredEventResponse'];
+type ResourceListFilters = {
+    limit?: number;
+    archived?: boolean;
+    search?: string;
+};
+export declare class BrowseNamespace implements IBrowseNamespace {
+    private readonly transport;
+    private readonly bus;
+    private readonly content;
+    private readonly resourceCache;
+    private readonly resourceListCache;
+    private readonly annotationListCache;
+    /**
+     * Annotation-detail cache keyed by `annotationId` only — the resourceId
+     * is a routing hint for the backend fetch, not an identity component.
+     * We track the most recent resourceId per annotationId in a side-map
+     * so `mark:delete-ok` (which carries only `annotationId`) can reach
+     * the right cache entry. Aligns with the pre-refactor semantics.
+     */
+    private readonly annotationDetailCache;
+    private readonly annotationResources;
+    private readonly entityTypesCache;
+    private readonly tagSchemasCache;
+    private readonly referencedByCache;
+    private readonly resourceEventsCache;
+    /** Filter-blob memory so `invalidateResourceLists` can replay per-key. */
+    private readonly resourceListFilters;
+    /**
+     * Per-key memo for `annotations()` observables. The cache stores the
+     * full `AnnotationsListResponse`; the public shape is just the inner
+     * `Annotation[]`. Without this memo, every call to `annotations(rId)`
+     * would produce a fresh `.pipe(map(...))` observable, violating B4
+     * (per-key observable stability). Consumers that compare observable
+     * identity — React hooks depending on the observable reference,
+     * `distinctUntilChanged` at a higher level — would misbehave.
+     */
+    private readonly annotationListObs;
+    constructor(transport: ITransport, bus: EventBus, content: IContentTransport);
+    resource(resourceId: ResourceId): CacheObservable<ResourceDescriptor>;
+    resources(filters?: ResourceListFilters): CacheObservable<ResourceDescriptor[]>;
+    annotations(resourceId: ResourceId): CacheObservable<Annotation[]>;
+    annotation(resourceId: ResourceId, annotationId: AnnotationId): CacheObservable<Annotation>;
+    entityTypes(): CacheObservable<string[]>;
+    tagSchemas(): CacheObservable<TagSchema[]>;
+    referencedBy(resourceId: ResourceId): CacheObservable<ReferencedByEntry[]>;
+    events(resourceId: ResourceId): CacheObservable<StoredEventResponse[]>;
+    resourceContent(resourceId: ResourceId): Promise<string>;
+    resourceRepresentation(resourceId: ResourceId, options?: {
+        accept?: string;
+    }): Promise<{
+        data: ArrayBuffer;
+        contentType: string;
+    }>;
+    resourceRepresentationStream(resourceId: ResourceId, options?: {
+        accept?: string;
+    }): Promise<{
+        stream: ReadableStream<Uint8Array>;
+        contentType: string;
+    }>;
+    resourceEvents(resourceId: ResourceId): Promise<StoredEventResponse[]>;
+    annotationHistory(resourceId: ResourceId, annotationId: AnnotationId): Promise<AnnotationHistoryResponse>;
+    connections(_resourceId: ResourceId): Promise<GraphConnection[]>;
+    backlinks(_resourceId: ResourceId): Promise<Annotation[]>;
+    resourcesByName(_query: string, _limit?: number): Promise<ResourceDescriptor[]>;
+    files(dirPath?: string, sort?: 'name' | 'mtime' | 'annotationCount'): Promise<components['schemas']['BrowseFilesResponse']>;
+    click(annotationId: AnnotationId, motivation: Motivation): void;
+    navigateReference(resourceId: ResourceId): void;
+    invalidateAnnotationList(resourceId: ResourceId): void;
+    removeAnnotationDetail(annotationId: AnnotationId): void;
+    invalidateResourceDetail(id: ResourceId): void;
+    invalidateResourceLists(): void;
+    invalidateEntityTypes(): void;
+    invalidateTagSchemas(): void;
+    invalidateReferencedBy(resourceId: ResourceId): void;
+    invalidateResourceEvents(resourceId: ResourceId): void;
+    updateAnnotationInPlace(resourceId: ResourceId, annotation: Annotation): void;
+    /**
+     * Typed shorthand for `eventBus.get(channel).subscribe(handler)`.
+     * Preserves per-channel payload typing so handlers read
+     * `EventMap[K]` without any casts.
+     */
+    private on;
+    /**
+     * Handler shared by `mark:entity-tag-added` and `mark:entity-tag-removed`.
+     * Both events carry the same effect: the annotation list, the
+     * resource descriptor, and the event log for that resource all may
+     * now reflect different entity tagging, so invalidate all three.
+     */
+    private onEntityTagChanged;
+    /**
+     * Handler shared by `mark:archived` and `mark:unarchived`. Both
+     * change a resource's archived flag, which is stored on the resource
+     * descriptor and affects the resource-list filter.
+     */
+    private onArchiveToggled;
+    /**
+     * Handler shared by `yield:create-ok` and `yield:update-ok`. Both
+     * report a resource mutation with the resourceId as a string (not
+     * yet branded), so we brand and apply the same effect as
+     * `onArchiveToggled`.
+     */
+    private onYieldResourceMutated;
+    private subscribeToEvents;
+}
+export {};
+//# sourceMappingURL=browse.d.ts.map

package/dist/namespaces/browse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse.d.ts","sourceRoot":"","sources":["../../src/namespaces/browse.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EAER,kBAAkB,EAClB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,UAAU,EACV,SAAS,EACT,UAAU,EACX,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGnE,OAAO,KAAK,EACV,eAAe,IAAI,gBAAgB,EACnC,iBAAiB,EACjB,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AACjB,KAAK,mBAAmB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,qBAAqB,CAAC,CAAC;AAMxE,KAAK,mBAAmB,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAQnF,qBAAa,eAAgB,YAAW,gBAAgB;IA0CpD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAlC1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwC;IACtE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAsC;IACxE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA6C;IACjF;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAkC;IACxE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAuC;IAC3E,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA0B;IAC3D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6B;IAC7D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAyC;IAC3E,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA2C;IAE/E,0EAA0E;IAC1E,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA0C;IAE9E;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA+D;gBAG9E,SAAS,EAAE,UAAU,EACrB,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,iBAAiB;IAwG7C,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,CAAC,kBAAkB,CAAC;IAIrE,SAAS,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,eAAe,CAAC,kBAAkB,EAAE,CAAC;IAQ/E,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,CAAC,UAAU,EAAE,CAAC;IASlE,UAAU,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,GAAG,eAAe,CAAC,UAAU,CAAC;IAQ3F,WAAW,IAAI,eAAe,CAAC,MAAM,EAAE,CAAC;IAIxC,UAAU,IAAI,eAAe,CAAC,SAAS,EAAE,CAAC;IAI1C,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,CAAC,iBAAiB,EAAE,CAAC;IAI1E,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,CAAC,mBAAmB,EAAE,CAAC;IAMhE,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAMxD,sBAAsB,CAC1B,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5B,OAAO,CAAC;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAIhD,4BAA4B,CAChC,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5B,OAAO,CAAC;QAAE,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAIjE,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAWtE,iBAAiB,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAUzG,WAAW,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAIhE,SAAS,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAIzD,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAI/E,KAAK,CACT,OAAO,CAAC,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,iBAAiB,GAC1C,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,qBAAqB,CAAC,CAAC;IAYxD,KAAK,CAAC,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI;IAI/D,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAW/C,wBAAwB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAItD,sBAAsB,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI;IAKxD,wBAAwB,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI;IAI9C,uBAAuB,IAAI,IAAI;IAI/B,qBAAqB,IAAI,IAAI;IAI7B,oBAAoB,IAAI,IAAI;IAI5B,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAIpD,wBAAwB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAItD,uBAAuB,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI;IAsB7E;;;;OAIG;IACH,OAAO,CAAC,EAAE;IAOV;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB,CAKxB;IAEF;;;;OAIG;IACH,OAAO,CAAC,gBAAgB,CAItB;IAEF;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB,CAI5B;IAEF,OAAO,CAAC,iBAAiB;CA+E1B"}

package/dist/namespaces/frame.d.ts

@@ -0,0 +1,29 @@
+/**
+ * FrameNamespace — the eighth flow's surface.
+ *
+ * Frame operates on the KB's **schema layer** — the conceptual vocabulary
+ * the other seven flows are expressed in. Where yield/mark/match/bind/
+ * gather/browse/beckon act on content (resources, annotations, references,
+ * attention), Frame acts on what *kinds* of things exist: entity types,
+ * eventually tag schemas, relation/predicate types, ontology imports.
+ *
+ * The MVP owns a single primitive — entity-type vocabulary writes on the
+ * `frame:add-entity-type` channel. See `docs/protocol/flows/FRAME.md`
+ * for the per-flow contract.
+ *
+ * Live reads of the entity-type vocabulary stay on Browse
+ * (`browse.entityTypes()` is a `CacheObservable<string[]>`). Frame owns
+ * writes; Browse owns reads. The asymmetry is intentional — re-implementing
+ * Browse's cache primitives on Frame for a single read would duplicate
+ * machinery without benefit.
+ */
+import type { ITransport, TagSchema } from '@semiont/core';
+import type { FrameNamespace as IFrameNamespace } from './types';
+export declare class FrameNamespace implements IFrameNamespace {
+    private readonly transport;
+    constructor(transport: ITransport);
+    addEntityType(type: string): Promise<void>;
+    addEntityTypes(types: string[]): Promise<void>;
+    addTagSchema(schema: TagSchema): Promise<void>;
+}
+//# sourceMappingURL=frame.d.ts.map

package/dist/namespaces/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../src/namespaces/frame.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,IAAI,eAAe,EAAE,MAAM,SAAS,CAAC;AAEjE,qBAAa,cAAe,YAAW,eAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,UAAU;IAE5C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9C,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrD"}

package/dist/namespaces/gather.d.ts

@@ -0,0 +1,16 @@
+import type { AnnotationId, ResourceId, EventBus } from '@semiont/core';
+import type { ITransport } from '@semiont/core';
+import { StreamObservable } from '../awaitable';
+import type { GatherNamespace as IGatherNamespace, GatherAnnotationProgress } from './types';
+export declare class GatherNamespace implements IGatherNamespace {
+    private readonly transport;
+    private readonly bus;
+    constructor(transport: ITransport, bus: EventBus);
+    annotation(resourceId: ResourceId, annotationId: AnnotationId, options?: {
+        contextWindow?: number;
+    }): StreamObservable<GatherAnnotationProgress>;
+    resource(_resourceId: ResourceId, _options?: {
+        contextWindow?: number;
+    }): StreamObservable<GatherAnnotationProgress>;
+}
+//# sourceMappingURL=gather.d.ts.map

package/dist/namespaces/gather.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gather.d.ts","sourceRoot":"","sources":["../../src/namespaces/gather.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,IAAI,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAE7F,qBAAa,eAAgB,YAAW,gBAAgB;IAEpD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,SAAS,EAAE,UAAU,EACrB,GAAG,EAAE,QAAQ;IAGhC,UAAU,CACR,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,YAAY,EAC1B,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GACnC,gBAAgB,CAAC,wBAAwB,CAAC;IAkD7C,QAAQ,CACN,WAAW,EAAE,UAAU,EACvB,QAAQ,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GACpC,gBAAgB,CAAC,wBAAwB,CAAC;CAG9C"}

package/dist/namespaces/job.d.ts

@@ -0,0 +1,32 @@
+import type { Observable } from 'rxjs';
+import type { EventBus, EventMap, JobId, components } from '@semiont/core';
+import type { ITransport } from '@semiont/core';
+import type { JobNamespace as IJobNamespace } from './types';
+type JobStatusResponse = components['schemas']['JobStatusResponse'];
+export declare class JobNamespace implements IJobNamespace {
+    private readonly transport;
+    private readonly bus;
+    constructor(transport: ITransport, bus: EventBus);
+    /**
+     * Live stream of `job:queued` events. Surfaces a typed view onto the
+     * underlying bus channel for consumers (CLIs, MCP handlers, widgets)
+     * that orchestrate jobs and need to react to lifecycle transitions.
+     */
+    get queued$(): Observable<EventMap['job:queued']>;
+    /** Live stream of `job:report-progress` events. */
+    get progress$(): Observable<EventMap['job:report-progress']>;
+    /** Live stream of `job:complete` events. */
+    get complete$(): Observable<EventMap['job:complete']>;
+    /** Live stream of `job:fail` events. */
+    get fail$(): Observable<EventMap['job:fail']>;
+    status(jobId: JobId): Promise<JobStatusResponse>;
+    pollUntilComplete(jobId: JobId, options?: {
+        interval?: number;
+        timeout?: number;
+        onProgress?: (status: JobStatusResponse) => void;
+    }): Promise<JobStatusResponse>;
+    cancelByType(jobType: 'annotation' | 'generation'): Promise<void>;
+    cancelRequest(jobType: 'annotation' | 'generation'): void;
+}
+export {};
+//# sourceMappingURL=job.d.ts.map

package/dist/namespaces/job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../../src/namespaces/job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,KAAK,EAAE,YAAY,IAAI,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7D,KAAK,iBAAiB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC,CAAC;AAEpE,qBAAa,YAAa,YAAW,aAAa;IAE9C,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,SAAS,EAAE,UAAU,EACrB,GAAG,EAAE,QAAQ;IAGhC;;;;OAIG;IACH,IAAI,OAAO,IAAI,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAEhD;IAED,mDAAmD;IACnD,IAAI,SAAS,IAAI,UAAU,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC,CAE3D;IAED,4CAA4C;IAC5C,IAAI,SAAS,IAAI,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAEpD;IAED,wCAAwC;IACxC,IAAI,KAAK,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAE5C;IAEK,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAUhD,iBAAiB,CACrB,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAA;KAAE,GAClG,OAAO,CAAC,iBAAiB,CAAC;IAkBvB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvE,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,GAAG,IAAI;CAK1D"}

package/dist/namespaces/mark.d.ts

@@ -0,0 +1,27 @@
+import type { ResourceId, AnnotationId, Motivation, EventBus, components } from '@semiont/core';
+import type { ITransport } from '@semiont/core';
+import { StreamObservable } from '../awaitable';
+import type { MarkNamespace as IMarkNamespace, CreateAnnotationInput, MarkAssistOptions, MarkAssistEvent } from './types';
+export declare class MarkNamespace implements IMarkNamespace {
+    private readonly transport;
+    private readonly bus;
+    constructor(transport: ITransport, bus: EventBus);
+    annotation(input: CreateAnnotationInput): Promise<{
+        annotationId: AnnotationId;
+    }>;
+    delete(resourceId: ResourceId, annotationId: AnnotationId): Promise<void>;
+    archive(resourceId: ResourceId): Promise<void>;
+    unarchive(resourceId: ResourceId): Promise<void>;
+    assist(resourceId: ResourceId, motivation: Motivation, options: MarkAssistOptions): StreamObservable<MarkAssistEvent>;
+    request(selector: components['schemas']['MarkRequestedEvent']['selector'], motivation: Motivation): void;
+    requestAssist(motivation: Motivation, options: MarkAssistOptions, correlationId?: string): void;
+    submit(input: components['schemas']['MarkSubmitEvent']): void;
+    cancelPending(): void;
+    dismissProgress(): void;
+    changeSelection(motivation: Motivation | null): void;
+    changeClick(action: string): void;
+    changeShape(shape: string): void;
+    toggleMode(): void;
+    private dispatchAssist;
+}
+//# sourceMappingURL=mark.d.ts.map

package/dist/namespaces/mark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark.d.ts","sourceRoot":"","sources":["../../src/namespaces/mark.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,UAAU,EACX,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EACV,aAAa,IAAI,cAAc,EAC/B,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,qBAAa,aAAc,YAAW,cAAc;IAEhD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,SAAS,EAAE,UAAU,EACrB,GAAG,EAAE,QAAQ;IAG1B,UAAU,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC;QAAE,YAAY,EAAE,YAAY,CAAA;KAAE,CAAC;IAejF,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzE,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAAC,eAAe,CAAC;IA+GrH,OAAO,CACL,QAAQ,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,CAAC,UAAU,CAAC,EACjE,UAAU,EAAE,UAAU,GACrB,IAAI;IAKP,aAAa,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ/F,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,iBAAiB,CAAC,GAAG,IAAI;IAI7D,aAAa,IAAI,IAAI;IAIrB,eAAe,IAAI,IAAI;IAIvB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI;IAIpD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIjC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhC,UAAU,IAAI,IAAI;YAIJ,cAAc;CAwC7B"}

package/dist/namespaces/match.d.ts

@@ -0,0 +1,15 @@
+import type { AnnotationId, ResourceId, GatheredContext, EventBus, components } from '@semiont/core';
+import type { ITransport } from '@semiont/core';
+import { StreamObservable } from '../awaitable';
+import type { MatchNamespace as IMatchNamespace, MatchSearchProgress } from './types';
+export declare class MatchNamespace implements IMatchNamespace {
+    private readonly transport;
+    private readonly bus;
+    constructor(transport: ITransport, bus: EventBus);
+    requestSearch(input: components['schemas']['MatchSearchRequest']): void;
+    search(resourceId: ResourceId, referenceId: AnnotationId, context: GatheredContext, options?: {
+        limit?: number;
+        useSemanticScoring?: boolean;
+    }): StreamObservable<MatchSearchProgress>;
+}
+//# sourceMappingURL=match.d.ts.map

package/dist/namespaces/match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.d.ts","sourceRoot":"","sources":["../../src/namespaces/match.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACrG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,IAAI,eAAe,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEtF,qBAAa,cAAe,YAAW,eAAe;IAElD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,SAAS,EAAE,UAAU,EACrB,GAAG,EAAE,QAAQ;IAGhC,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAKvE,MAAM,CACJ,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,YAAY,EACzB,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAAE,GACzD,gBAAgB,CAAC,mBAAmB,CAAC;CAqCzC"}