@semiont/sdk 0.5.2 → 0.5.4

package/dist/namespaces/types.d.ts

@@ -0,0 +1,438 @@
+/**
+ * Verb Namespace Interfaces
+ *
+ * These interfaces define the public API of `@semiont/sdk`, organized by
+ * the 7 domain flows (Browse, Mark, Bind, Gather, Match, Yield, Beckon)
+ * plus infrastructure namespaces (Job, Auth, Admin).
+ *
+ * Each namespace maps 1:1 to a flow. Each flow maps to a clear actor on
+ * the backend. The frontend calls `client.mark.annotation()` and the
+ * client handles HTTP, auth, SSE, and caching internally.
+ *
+ * Return type conventions:
+ * - Browse live queries → `CacheObservable<T>` (bus-driven, cached;
+ *   subscribe yields `T | undefined`, await yields `T` after first load)
+ * - Browse one-shot reads → `Promise<T>` (fetch once, no cache)
+ * - Commands (mark, bind, yield.resource) → `Promise<T>` (atomic ops)
+ * - Long-running ops (gather, match, yield.fromAnnotation, mark.assist)
+ *   → `StreamObservable<T>` (progress + result; subscribe yields every
+ *   emit, await yields the last one)
+ * - Ephemeral signals (beckon) → `void`
+ *
+ * `StreamObservable` and `CacheObservable` are `Observable` subclasses
+ * that also implement `PromiseLike<T>` — `await client.X.Y(...)` works
+ * directly without `lastValueFrom`/`firstValueFrom` wrappers.
+ * `.pipe(...)` returns a plain `Observable<T>` (the thenable subclass
+ * does not propagate through pipe — by design).
+ */
+import type { Observable } from 'rxjs';
+import type { StreamObservable, CacheObservable, UploadObservable } from '../awaitable';
+import type { components, EventMap, paths } from '@semiont/core';
+import type { ResourceId, AnnotationId, BackendDownload, BodyOperation, GraphConnection, JobId, Motivation, GatheredContext, ProgressEvent, TagSchema, UserDID } from '@semiont/core';
+import type { Annotation } from '@semiont/core';
+import type { ResourceDescriptor } from '@semiont/core';
+type StoredEventResponse = components['schemas']['StoredEventResponse'];
+type GatherProgress = components['schemas']['GatherProgress'];
+type MatchSearchResult = components['schemas']['MatchSearchResult'];
+type JobProgress = components['schemas']['JobProgress'];
+type GatherAnnotationComplete = components['schemas']['GatherAnnotationComplete'];
+type JobStatusResponse = components['schemas']['JobStatusResponse'];
+type AuthResponse = components['schemas']['AuthResponse'];
+type TokenRefreshResponse = components['schemas']['TokenRefreshResponse'];
+type OAuthConfigResponse = components['schemas']['OAuthConfigResponse'];
+type AdminUserStatsResponse = components['schemas']['AdminUserStatsResponse'];
+export type ResponseContent<T> = T extends {
+    responses: {
+        200: {
+            content: {
+                'application/json': infer R;
+            };
+        };
+    };
+} ? R : T extends {
+    responses: {
+        201: {
+            content: {
+                'application/json': infer R;
+            };
+        };
+    };
+} ? R : T extends {
+    responses: {
+        202: {
+            content: {
+                'application/json': infer R;
+            };
+        };
+    };
+} ? R : never;
+export type RequestContent<T> = T extends {
+    requestBody?: {
+        content: {
+            'application/json': infer R;
+        };
+    };
+} ? R : never;
+/** Input for creating an annotation via mark.annotation() */
+export type CreateAnnotationInput = components['schemas']['CreateAnnotationRequest'];
+/** Input for creating a resource via yield.resource() */
+export interface CreateResourceInput {
+    name: string;
+    file: File | Buffer;
+    format: string;
+    entityTypes?: string[];
+    language?: string;
+    sourceAnnotationId?: string;
+    sourceResourceId?: string;
+    storageUri: string;
+    /** Prompt that drove AI generation (for AI-generated resources). */
+    generationPrompt?: string;
+    /** Agent(s) that generated the content (for AI-generated resources). */
+    generator?: components['schemas']['Agent'] | components['schemas']['Agent'][];
+    isDraft?: boolean;
+}
+/** Options for yield.fromAnnotation() */
+export interface GenerationOptions {
+    title: string;
+    storageUri: string;
+    context: GatheredContext;
+    prompt?: string;
+    /** Entity-type tags to stamp on the synthesized resource. Used both as a prompt bias for the generation worker and as the `entityTypes` set on the resulting resource (so `browse.resources({ entityType: ... })` queries can find it). */
+    entityTypes?: string[];
+    /** Annotation/resource body locale — language the generated resource is written in (typically the user's UI locale). */
+    language?: string;
+    /** Source-resource locale — language of the resource the annotation lives on, used in the prompt so the LLM understands embedded source-context snippets. BCP-47. */
+    sourceLanguage?: string;
+    temperature?: number;
+    maxTokens?: number;
+}
+/** Options for mark.assist() */
+export interface MarkAssistOptions {
+    entityTypes?: string[];
+    includeDescriptiveReferences?: boolean;
+    instructions?: string;
+    density?: number;
+    tone?: string;
+    /** Annotation body locale — language the LLM should write generated body text in (comment text, assessment text, tag/reference body language stamp). BCP-47. */
+    language?: string;
+    /** Source-resource locale — language of the content being analyzed, used in the prompt so the LLM analyzes non-English source correctly. BCP-47. */
+    sourceLanguage?: string;
+    schemaId?: string;
+    categories?: string[];
+}
+/** Options for yield.createFromToken() */
+export type CreateFromTokenOptions = {
+    token: string;
+    name: string;
+    content: string;
+    archiveOriginal?: boolean;
+};
+/** Referenced-by entry from browse.referencedBy() */
+export type ReferencedByEntry = components['schemas']['GetReferencedByResponse']['referencedBy'][number];
+/** Annotation history from browse.annotationHistory() */
+export type AnnotationHistoryResponse = components['schemas']['GetAnnotationHistoryResponse'];
+/** User object from auth/admin responses */
+export type User = AuthResponse['user'];
+/**
+ * Progress emitted by gather.annotation() Observable.
+ * Emits GatherProgress during assembly, then GatherAnnotationComplete on finish.
+ */
+export type GatherAnnotationProgress = GatherProgress | GatherAnnotationComplete;
+/**
+ * Progress emitted by match.search() Observable.
+ * Emits the final MatchSearchResult (no intermediate progress events currently).
+ */
+export type MatchSearchProgress = MatchSearchResult;
+/**
+ * Progress payload emitted by mark.assist() and yield.fromAnnotation()
+ * Observables. Each progress emission carries a JobProgress snapshot
+ * (unified job lifecycle).
+ */
+export type MarkAssistProgress = JobProgress;
+/**
+ * Discriminated event yielded by the `mark.assist()` Observable. Progress
+ * events stream while the worker runs; the final value before the
+ * Observable completes is a `complete` event carrying the `JobCompleteCommand`
+ * payload (with `result`, `jobId`, `jobType`, etc.). The Observable errors
+ * on `job:fail`.
+ */
+export type MarkAssistEvent = {
+    kind: 'progress';
+    data: MarkAssistProgress;
+} | {
+    kind: 'complete';
+    data: components['schemas']['JobCompleteCommand'];
+};
+/**
+ * Discriminated event yielded by the `yield.fromAnnotation()` Observable.
+ * Same shape and semantics as `MarkAssistEvent`.
+ */
+export type YieldGenerationEvent = {
+    kind: 'progress';
+    data: JobProgress;
+} | {
+    kind: 'complete';
+    data: components['schemas']['JobCompleteCommand'];
+};
+/**
+ * Browse — reads from materialized views
+ *
+ * Live queries return Observables that emit initial state and re-emit
+ * on bus gateway updates. One-shot reads return Promises.
+ *
+ * Backend actor: Browser (context classes)
+ * Event prefix: browse:*
+ */
+export interface BrowseNamespace {
+    resource(resourceId: ResourceId): CacheObservable<ResourceDescriptor>;
+    resources(filters?: {
+        limit?: number;
+        archived?: boolean;
+        search?: string;
+    }): 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;
+}
+/**
+ * Frame — schema-layer flow (the eighth flow).
+ *
+ * Frame operates on the KB's conceptual vocabulary — what *kinds* of
+ * things exist (entity types) and, in the future, what taxonomies are
+ * recognized (tag schemas), what relations are typed (predicate types),
+ * and how schemas are imported (ontology I/O). The other seven flows
+ * (yield, mark, match, bind, gather, browse, beckon) operate on
+ * content; Frame operates on the schema layer that content is expressed
+ * in.
+ *
+ * MVP scope is small: entity-type vocabulary writes only. Live reads of
+ * the entity-type vocabulary stay on Browse (`browse.entityTypes()` is
+ * a `CacheObservable<string[]>` consumed by 8+ call sites). Frame owns
+ * writes; Browse owns reads — the same asymmetry that already holds for
+ * resources and annotations.
+ *
+ * Backend actor: Stower
+ * Event prefix: frame:*
+ */
+export interface FrameNamespace {
+    /** Add a single entity type to the KB's vocabulary. Idempotent — adding an existing type is a no-op. */
+    addEntityType(type: string): Promise<void>;
+    /** Add multiple entity types in one call. Convenience over a loop of `addEntityType`. */
+    addEntityTypes(types: string[]): Promise<void>;
+    /**
+     * Register a tag schema with the KB's runtime registry.
+     *
+     * Most-recent registration of a given `schema.id` wins; identical
+     * re-registrations are silent, differing content overwrites the
+     * existing entry and logs a warning. KBs typically call this at
+     * session/skill startup so the schema is available for `mark.assist`
+     * with motivation `tagging` and surfaces in `browse.tagSchemas()`.
+     */
+    addTagSchema(schema: TagSchema): Promise<void>;
+}
+/**
+ * Mark — annotation CRUD, AI assist, resource lifecycle
+ *
+ * Commands return Promises that resolve on HTTP acceptance (202).
+ * Results appear on browse Observables via bus gateway.
+ * assist() returns an Observable for long-running progress.
+ *
+ * Backend actor: Stower
+ * Event prefix: mark:*
+ */
+export interface MarkNamespace {
+    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;
+    /** Fire-and-forget variant of `assist` — mark-state-unit orchestrates the call and its progress Observable. */
+    requestAssist(motivation: Motivation, options: MarkAssistOptions, correlationId?: string): void;
+    /** Submit the currently pending annotation with its selector and optional body. */
+    submit(input: components['schemas']['MarkSubmitEvent']): void;
+    /** Cancel the currently pending annotation (if any). */
+    cancelPending(): void;
+    /** Dismiss the in-progress AI-assist widget. */
+    dismissProgress(): void;
+    changeSelection(motivation: Motivation | null): void;
+    changeClick(action: string): void;
+    changeShape(shape: string): void;
+    toggleMode(): void;
+}
+/**
+ * Bind — reference linking
+ *
+ * The simplest namespace. One method. The result (updated annotation
+ * with resolved reference) arrives on browse.annotations() via the
+ * enriched mark:body-updated event.
+ *
+ * Backend actor: Stower (via mark:update-body)
+ * Event prefix: mark:body-updated (shares mark event pipeline)
+ */
+export interface BindNamespace {
+    body(resourceId: ResourceId, annotationId: AnnotationId, operations: BodyOperation[]): Promise<void>;
+    /** UI signal: a reference-binding flow is requested for an annotation. */
+    initiate(input: EventMap['bind:initiate']): void;
+}
+/**
+ * Gather — context assembly
+ *
+ * Long-running (LLM calls + graph traversal). Returns Observables
+ * that emit progress then the gathered context.
+ *
+ * Backend actor: Gatherer
+ * Event prefix: gather:*
+ */
+export interface GatherNamespace {
+    annotation(resourceId: ResourceId, annotationId: AnnotationId, options?: {
+        contextWindow?: number;
+    }): StreamObservable<GatherAnnotationProgress>;
+    resource(resourceId: ResourceId, options?: {
+        contextWindow?: number;
+    }): StreamObservable<GatherAnnotationProgress>;
+}
+/**
+ * Match — search and ranking
+ *
+ * Long-running (semantic search, optional LLM scoring). Returns
+ * Observable with progress then results.
+ *
+ * Backend actor: Matcher
+ * Event prefix: match:*
+ */
+export interface MatchNamespace {
+    search(resourceId: ResourceId, referenceId: AnnotationId, context: GatheredContext, options?: {
+        limit?: number;
+        useSemanticScoring?: boolean;
+    }): StreamObservable<MatchSearchProgress>;
+    /** Fire-and-forget variant: match-state-unit orchestrates the call and its result Observable. */
+    requestSearch(input: components['schemas']['MatchSearchRequest']): void;
+}
+/**
+ * Yield — resource creation
+ *
+ * resource() is synchronous file upload (Promise).
+ * fromAnnotation() is long-running LLM generation (Observable).
+ *
+ * Backend actor: Stower + generation worker
+ * Event prefix: yield:*
+ */
+export interface YieldNamespace {
+    resource(data: CreateResourceInput): UploadObservable;
+    fromAnnotation(resourceId: ResourceId, annotationId: AnnotationId, options: GenerationOptions): StreamObservable<YieldGenerationEvent>;
+    cloneToken(resourceId: ResourceId): Promise<{
+        token: string;
+        expiresAt: string;
+    }>;
+    fromToken(token: string): Promise<ResourceDescriptor>;
+    createFromToken(options: CreateFromTokenOptions): Promise<{
+        resourceId: ResourceId;
+    }>;
+    /** UI signal: user invoked the clone action from the resource-info panel. */
+    clone(): void;
+}
+/**
+ * Beckon — attention coordination
+ *
+ * Fire-and-forget. Ephemeral presence signal delivered via the
+ * attention-stream to other participants.
+ *
+ * Backend actor: (frontend relay via attention-stream)
+ * Event prefix: beckon:*
+ */
+export interface BeckonNamespace {
+    attention(resourceId: ResourceId, annotationId: AnnotationId): void;
+    hover(annotationId: AnnotationId | null): void;
+    sparkle(annotationId: AnnotationId): void;
+}
+/**
+ * Job — worker lifecycle
+ */
+export interface JobNamespace {
+    /** Live stream of `job:queued` events from the bus. */
+    readonly queued$: Observable<EventMap['job:queued']>;
+    /** Live stream of `job:report-progress` events from the bus. */
+    readonly progress$: Observable<EventMap['job:report-progress']>;
+    /** Live stream of `job:complete` events from the bus. */
+    readonly complete$: Observable<EventMap['job:complete']>;
+    /** Live stream of `job:fail` events from the bus. */
+    readonly 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>;
+    /** UI signal: cancel all active jobs of a given type (e.g. "annotation"). */
+    cancelRequest(jobType: 'annotation' | 'generation'): void;
+}
+/**
+ * Auth — authentication
+ */
+export interface AuthNamespace {
+    password(email: string, password: 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;
+    }>;
+}
+/**
+ * Admin — administration
+ */
+export interface AdminNamespace {
+    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 from a backup archive. Returns a `StreamObservable` that
+     * emits each `ProgressEvent` as the operation runs (`'started'`,
+     * `'parsing'`, `'importing'`, ..., `'complete'`). Subscribers see
+     * every step; awaiters get the final event via the PromiseLike sugar.
+     */
+    restore(file: File): StreamObservable<ProgressEvent>;
+    exportKnowledgeBase(params?: {
+        includeArchived?: boolean;
+    }): Promise<BackendDownload>;
+    importKnowledgeBase(file: File): StreamObservable<ProgressEvent>;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/namespaces/types.ts"],"names":[],"mappings":"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"}

package/dist/namespaces/yield.d.ts

@@ -0,0 +1,23 @@
+import type { ResourceId, AnnotationId, EventBus } from '@semiont/core';
+import type { ITransport, IContentTransport } from '@semiont/core';
+import { StreamObservable, UploadObservable } from '../awaitable';
+import type { YieldNamespace as IYieldNamespace, CreateResourceInput, GenerationOptions, CreateFromTokenOptions, YieldGenerationEvent } from './types';
+import type { ResourceDescriptor } from '@semiont/core';
+export declare class YieldNamespace implements IYieldNamespace {
+    private readonly transport;
+    private readonly bus;
+    private readonly content;
+    constructor(transport: ITransport, bus: EventBus, content: IContentTransport);
+    resource(data: CreateResourceInput): UploadObservable;
+    fromAnnotation(resourceId: ResourceId, annotationId: AnnotationId, options: GenerationOptions): StreamObservable<YieldGenerationEvent>;
+    cloneToken(resourceId: ResourceId): Promise<{
+        token: string;
+        expiresAt: string;
+    }>;
+    fromToken(token: string): Promise<ResourceDescriptor>;
+    createFromToken(options: CreateFromTokenOptions): Promise<{
+        resourceId: ResourceId;
+    }>;
+    clone(): void;
+}
+//# sourceMappingURL=yield.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"yield.d.ts","sourceRoot":"","sources":["../../src/namespaces/yield.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,QAAQ,EAET,MAAM,eAAe,CAAC;AAGvB,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEnE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EACV,cAAc,IAAI,eAAe,EACjC,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAEjB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGxD,qBAAa,cAAe,YAAW,eAAe;IAElD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,SAAS,EAAE,UAAU,EACrB,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,iBAAiB;IAG7C,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,gBAAgB;IAgErD,cAAc,CACZ,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,iBAAiB,GACzB,gBAAgB,CAAC,oBAAoB,CAAC;IAkInC,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAUjF,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAWrD,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,UAAU,CAAA;KAAE,CAAC;IAW3F,KAAK,IAAI,IAAI;CAGd"}

package/dist/session/errors.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Session-level error surface. Emitted on `SemiontBrowser.error$` for
+ * failures that make the session itself unusable (auth failed, actor
+ * couldn't start, token refresh terminally exhausted). Per-request
+ * errors stay with the caller as normal Promise rejections.
+ *
+ * `SemiontSessionError` extends `SemiontError` (the unified Semiont base)
+ * so consumers can catch with `instanceof SemiontError` for any error
+ * surfaced through the SDK.
+ */
+import { SemiontError } from '@semiont/core';
+export type SemiontSessionErrorCode = 'session.construct-failed' | 'session.auth-failed' | 'session.refresh-exhausted' | 'browser.sign-in-failed';
+export declare class SemiontSessionError extends SemiontError {
+    code: SemiontSessionErrorCode;
+    readonly kbId: string | null;
+    constructor(code: SemiontSessionErrorCode, message: string, kbId?: string | null);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/session/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/session/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,MAAM,uBAAuB,GAC/B,0BAA0B,GAC1B,qBAAqB,GACrB,2BAA2B,GAC3B,wBAAwB,CAAC;AAE7B,qBAAa,mBAAoB,SAAQ,YAAY;IAC3C,IAAI,EAAE,uBAAuB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEjB,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,GAAG,IAAW;CAKvF"}

package/dist/session/http-session-factory.d.ts

@@ -0,0 +1,15 @@
+/**
+ * createHttpSessionFactory — the default `SessionFactory` for HTTP-backed
+ * KBs. Owns every HTTP-specific construction concern that used to live in
+ * `SemiontBrowser`: building `HttpTransport`/`HttpContentTransport`,
+ * wiring the `tokenRefresher` callback, deduplicating concurrent 401
+ * refresh round trips, and invoking the auth endpoints for token refresh
+ * and user-validate.
+ *
+ * Returned as a closure so a single `inFlightRefreshes` map is shared
+ * across every session this factory builds — the dedup is meaningful
+ * across concurrent session reactivations for the same KB id.
+ */
+import type { SessionFactory } from './session-factory';
+export declare function createHttpSessionFactory(): SessionFactory;
+//# sourceMappingURL=http-session-factory.d.ts.map

package/dist/session/http-session-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-session-factory.d.ts","sourceRoot":"","sources":["../../src/session/http-session-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,OAAO,KAAK,EAAE,cAAc,EAAyB,MAAM,mBAAmB,CAAC;AAE/E,wBAAgB,wBAAwB,IAAI,cAAc,CAoGzD"}

package/dist/session/knowledge-base.d.ts

@@ -0,0 +1,95 @@
+/**
+ * KnowledgeBase — a connection to a Semiont knowledge system.
+ *
+ * The KB type itself is uniform. The transport-shape variation lives in
+ * the nested `endpoint` field, which is a discriminated union:
+ *
+ *  - `endpoint.kind === 'http'`  — a remote backend reached over HTTP+SSE.
+ *                                  Carries `host`/`port`/`protocol`.
+ *  - `endpoint.kind === 'local'` — an in-process knowledge system reached
+ *                                  via `LocalTransport` from
+ *                                  `@semiont/make-meaning`. Carries an
+ *                                  opaque `kbId` identifying the local
+ *                                  instance to the host process.
+ *
+ * Code that doesn't know how to make a transport (`SemiontSession`,
+ * `SemiontBrowser`, the frontend KB list UI) treats `KnowledgeBase` as
+ * uniform and never inspects `endpoint`. Code that *does* construct
+ * transports (the transport-factory passed to `SemiontBrowser`,
+ * `kbBackendUrl` for HTTP URL construction) inspects `endpoint.kind`
+ * and dispatches.
+ *
+ * Each KB has its own session, its own credentials (where applicable),
+ * and its own JWT (HTTP only). The user is "authenticated against KB X" —
+ * never globally authenticated.
+ */
+/** Fields shared by every KB regardless of endpoint kind. */
+export interface KnowledgeBase {
+    id: string;
+    label: string;
+    email: string;
+    gitBranch?: string;
+    endpoint: KbEndpoint;
+}
+export type KbEndpoint = HttpEndpoint | LocalEndpoint;
+export interface HttpEndpoint {
+    kind: 'http';
+    host: string;
+    port: number;
+    protocol: 'http' | 'https';
+}
+export interface LocalEndpoint {
+    kind: 'local';
+    /** Opaque identifier for the in-process KB instance the host has loaded. */
+    kbId: string;
+}
+/**
+ * Input shape for adding a new KB. The id is generated by the provider.
+ */
+export type NewKnowledgeBase = Omit<KnowledgeBase, 'id'>;
+/**
+ * Status of the locally-stored credential for a KB. Derived from the
+ * presence and validity of the JWT in session storage.
+ */
+export type KbSessionStatus = 'authenticated' | 'expired' | 'signed-out' | 'unreachable';
+/**
+ * Construct a `KnowledgeBase` for an HTTP-backed Semiont backend without
+ * spelling out the nested `endpoint` literal. Convenience for tests,
+ * worker bootstraps, and one-off scripts.
+ *
+ * ```ts
+ * const kb = httpKb({
+ *   id: 'my-watcher',
+ *   label: 'My Watcher',
+ *   email: 'me@example.com',
+ *   host: 'localhost',
+ *   port: 4000,
+ *   protocol: 'http',
+ * });
+ * ```
+ *
+ * Equivalent to:
+ *
+ * ```ts
+ * const kb: KnowledgeBase = {
+ *   id, label, email,
+ *   endpoint: { kind: 'http', host, port, protocol },
+ * };
+ * ```
+ *
+ * UI hosts that have a structured form (host / port / protocol pickers)
+ * already construct the literal directly — they don't need this helper.
+ * Local-endpoint KBs construct the literal directly too; the local
+ * endpoint shape (`{ kind: 'local', kbId }`) is one line and doesn't
+ * earn a helper.
+ */
+export declare function httpKb(opts: {
+    id: string;
+    label: string;
+    email: string;
+    host: string;
+    port: number;
+    protocol: 'http' | 'https';
+    gitBranch?: string;
+}): KnowledgeBase;
+//# sourceMappingURL=knowledge-base.d.ts.map

package/dist/session/knowledge-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-base.d.ts","sourceRoot":"","sources":["../../src/session/knowledge-base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,6DAA6D;AAC7D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,aAAa,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,SAAS,GAAG,YAAY,GAAG,aAAa,CAAC;AAEzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,aAAa,CAShB"}

package/dist/session/open-resource.d.ts

@@ -0,0 +1,22 @@
+/**
+ * OpenResource — a single entry in the open-resources list (tabs).
+ *
+ * The list itself lives on `SemiontBrowser.openResources$`. The CRUD
+ * methods (`addOpenResource`, `removeOpenResource`, `updateOpenResourceName`,
+ * `reorderOpenResources`) live on `SemiontBrowser` too.
+ */
+export interface OpenResource {
+    /** Unique identifier for the resource */
+    id: string;
+    /** Display name of the resource */
+    name: string;
+    /** Timestamp when the resource was opened */
+    openedAt: number;
+    /** Order/position for manual sorting (optional for backward compatibility) */
+    order?: number;
+    /** Media type for icon display (e.g., 'application/pdf', 'text/plain') */
+    mediaType?: string;
+    /** Working-tree URI (e.g. "file://docs/overview.md") — used as tooltip in navigation */
+    storageUri?: string;
+}
+//# sourceMappingURL=open-resource.d.ts.map

package/dist/session/open-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-resource.d.ts","sourceRoot":"","sources":["../../src/session/open-resource.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IAEX,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IAEb,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IAEjB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}