@semiont/sdk 0.5.3 → 0.5.4

package/dist/state/flows/mark-state-unit.d.ts

@@ -0,0 +1,17 @@
+import { type Observable } from 'rxjs';
+import type { ResourceId, Motivation, Selector, components } from '@semiont/core';
+import type { SemiontClient } from '../../client';
+import type { StateUnit } from '../lib/state-unit';
+type JobProgress = components['schemas']['JobProgress'];
+export interface PendingAnnotation {
+    selector: Selector | Selector[];
+    motivation: Motivation;
+}
+export interface MarkStateUnit extends StateUnit {
+    pendingAnnotation$: Observable<PendingAnnotation | null>;
+    assistingMotivation$: Observable<Motivation | null>;
+    progress$: Observable<JobProgress | null>;
+}
+export declare function createMarkStateUnit(client: SemiontClient, resourceId: ResourceId): MarkStateUnit;
+export {};
+//# sourceMappingURL=mark-state-unit.d.ts.map

package/dist/state/flows/mark-state-unit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark-state-unit.d.ts","sourceRoot":"","sources":["../../../src/state/flows/mark-state-unit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,UAAU,EAAqB,MAAM,MAAM,CAAC;AAE3E,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAY,UAAU,EAAE,MAAM,eAAe,CAAC;AAC5F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,KAAK,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAAC;IAChC,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,kBAAkB,EAAE,UAAU,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IACzD,oBAAoB,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACpD,SAAS,EAAE,UAAU,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAC3C;AAcD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,UAAU,GACrB,aAAa,CA6Gf"}

package/dist/state/flows/match-state-unit.d.ts

@@ -0,0 +1,7 @@
+import type { ResourceId } from '@semiont/core';
+import type { SemiontClient } from '../../client';
+import type { StateUnit } from '../lib/state-unit';
+export interface MatchStateUnit extends StateUnit {
+}
+export declare function createMatchStateUnit(client: SemiontClient, _resourceId: ResourceId): MatchStateUnit;
+//# sourceMappingURL=match-state-unit.d.ts.map

package/dist/state/flows/match-state-unit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-state-unit.d.ts","sourceRoot":"","sources":["../../../src/state/flows/match-state-unit.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,eAAe,CAAC;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,WAAW,cAAe,SAAQ,SAAS;CAAG;AAEpD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,UAAU,GACtB,cAAc,CA2BhB"}

package/dist/state/flows/yield-state-unit.d.ts

@@ -0,0 +1,25 @@
+import { type Observable } from 'rxjs';
+import type { ResourceId, GatheredContext, components } from '@semiont/core';
+import type { SemiontClient } from '../../client';
+import type { StateUnit } from '../lib/state-unit';
+type JobProgress = components['schemas']['JobProgress'];
+export interface GenerateDocumentOptions {
+    title: string;
+    storageUri: string;
+    prompt?: string;
+    /** Body locale — language the generated resource is written in. Falls back to the state unit's UI locale when unset. */
+    language?: string;
+    /** Source-resource locale — language of the resource the annotation lives on. Forwarded to the prompt for context-snippet awareness. BCP-47. */
+    sourceLanguage?: string;
+    temperature?: number;
+    maxTokens?: number;
+    context: GatheredContext;
+}
+export interface YieldStateUnit extends StateUnit {
+    isGenerating$: Observable<boolean>;
+    progress$: Observable<JobProgress | null>;
+    generate(referenceId: string, options: GenerateDocumentOptions): void;
+}
+export declare function createYieldStateUnit(client: SemiontClient, resourceId: ResourceId, locale: string): YieldStateUnit;
+export {};
+//# sourceMappingURL=yield-state-unit.d.ts.map

package/dist/state/flows/yield-state-unit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yield-state-unit.d.ts","sourceRoot":"","sources":["../../../src/state/flows/yield-state-unit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,UAAU,EAAqB,MAAM,MAAM,CAAC;AAE3E,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,KAAK,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC;AAExD,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wHAAwH;IACxH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gJAAgJ;IAChJ,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,aAAa,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,UAAU,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAAC;CACvE;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,GACb,cAAc,CAmDhB"}

package/dist/state/index.d.ts

@@ -0,0 +1,10 @@
+export { type StateUnit, createDisposer } from './lib/state-unit';
+export { createSearchPipeline, type SearchPipeline, type SearchPipelineOptions, type SearchState, } from './lib/search-pipeline';
+export type { WorkerBus } from './lib/worker-bus';
+export { createBeckonStateUnit, type BeckonStateUnit, createHoverHandlers, type HoverHandlers, HOVER_DELAY_MS, } from './flows/beckon-state-unit';
+export { createGatherStateUnit, type GatherStateUnit, } from './flows/gather-state-unit';
+export { createMatchStateUnit, type MatchStateUnit, } from './flows/match-state-unit';
+export { createYieldStateUnit, type YieldStateUnit, type GenerateDocumentOptions, } from './flows/yield-state-unit';
+export { createMarkStateUnit, type MarkStateUnit, type PendingAnnotation, } from './flows/mark-state-unit';
+export type { ConnectionState } from '@semiont/core';
+//# sourceMappingURL=index.d.ts.map

package/dist/state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,KAAK,SAAS,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,GACjB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIlD,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,mBAAmB,EACnB,KAAK,aAAa,EAClB,cAAc,GACf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,GACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,uBAAuB,GAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/state/lib/search-pipeline.d.ts

@@ -0,0 +1,38 @@
+/**
+ * createSearchPipeline
+ *
+ * A debounced-search RxJS pipeline factory. Combines an input Subject with a
+ * downstream fetch function and emits typed `{ results, isSearching }` state.
+ *
+ * Designed to be created once per consumer instance and held for its lifetime
+ * (e.g. by a view layer's lazy initializer), then observed via `state$`. The
+ * pipeline is pure RxJS — unit-testable without any view-layer dependency.
+ *
+ * The fetch function is expected to return `Observable<T[] | undefined>`,
+ * matching the cache-miss-then-data shape of `BrowseNamespace` Observables:
+ * `undefined` means "fetch in flight, no value yet"; an array means "data
+ * available (possibly empty)".
+ */
+import { type Observable } from 'rxjs';
+export interface SearchState<T> {
+    results: T[];
+    isSearching: boolean;
+}
+export interface SearchPipeline<T> {
+    /** Latest query string. Bind to a controlled input. */
+    query$: Observable<string>;
+    /** Latest search state — results plus a loading flag. */
+    state$: Observable<SearchState<T>>;
+    /** Push a new query value. Triggers the debounced fetch. */
+    setQuery(value: string): void;
+    /** Tear down the input Subject. Call from the consumer's cleanup hook. */
+    dispose(): void;
+}
+export interface SearchPipelineOptions {
+    /** Milliseconds to wait after the last keystroke before fetching. Default 250. */
+    debounceMs?: number;
+    /** Initial query value. Useful for modals that open with a pre-filled term. */
+    initialQuery?: string;
+}
+export declare function createSearchPipeline<T>(fetch: (query: string) => Observable<T[] | undefined>, options?: SearchPipelineOptions): SearchPipeline<T>;
+//# sourceMappingURL=search-pipeline.d.ts.map

package/dist/state/lib/search-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-pipeline.d.ts","sourceRoot":"","sources":["../../../src/state/lib/search-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAGpD,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,uDAAuD;IACvD,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3B,yDAAyD;IACzD,MAAM,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,0EAA0E;IAC1E,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,UAAU,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,EACrD,OAAO,GAAE,qBAA0B,GAClC,cAAc,CAAC,CAAC,CAAC,CAgCnB"}

package/dist/state/lib/state-unit.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Marker for the state-unit pattern: a stateful, lifecycled object with an
+ * RxJS-shaped public surface, constructed by a factory function
+ * (`createFooStateUnit`), with internal state held in a closure.
+ *
+ * The structural contract is `dispose()` — the rest of the pattern
+ * (closure-based identity, Observable public surface, internal Subjects
+ * exposed as `.asObservable()` views, no leaked subscriptions, composition
+ * by parameter rather than ownership) is convention enforced by review,
+ * not the type system.
+ *
+ * See `packages/sdk/docs/STATE-UNITS.md` for the full axioms and rationale.
+ */
+export interface StateUnit {
+    /**
+     * Idempotent, total teardown. Completes every Subject the unit owns,
+     * unsubscribes every internal subscription, releases timers / abort
+     * controllers / network handles. Safe to call multiple times — the
+     * second call is a no-op.
+     */
+    dispose(): void;
+}
+/**
+ * Compose multiple disposers into a single `dispose()` call. Accepts either
+ * a `StateUnit` (whose `dispose()` will be invoked) or a plain teardown
+ * function. The returned object is itself disposable; call its `dispose()`
+ * once to tear down everything that was added.
+ */
+export declare function createDisposer(): {
+    add(item: StateUnit | (() => void)): void;
+    dispose(): void;
+};
+//# sourceMappingURL=state-unit.d.ts.map

package/dist/state/lib/state-unit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-unit.d.ts","sourceRoot":"","sources":["../../../src/state/lib/state-unit.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;OAKG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI;IAChC,GAAG,CAAC,IAAI,EAAE,SAAS,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1C,OAAO,IAAI,IAAI,CAAC;CACjB,CAOA"}

package/dist/state/lib/worker-bus.d.ts

@@ -0,0 +1,21 @@
+/**
+ * WorkerBus — minimal channel-bus surface that worker-side adapters
+ * (e.g. `JobClaimAdapter` in `@semiont/jobs`, `SmelterActorStateUnit` in
+ * `@semiont/make-meaning`) need.
+ *
+ * Transport-neutral by design. HTTP `ActorStateUnit` (from `@semiont/api-client`)
+ * 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.
+ *
+ * `addChannels` is optional because in-process buses receive every emit
+ * implicitly — only HTTP needs to widen its SSE subscription set to
+ * include worker-only channels (`job:queued`, `yield:created`, etc.).
+ */
+import type { Observable } from 'rxjs';
+export interface WorkerBus {
+    on$<T = Record<string, unknown>>(channel: string): Observable<T>;
+    emit(channel: string, payload: Record<string, unknown>): Promise<void>;
+    addChannels?(channels: readonly string[]): void;
+}
+//# sourceMappingURL=worker-bus.d.ts.map

package/dist/state/lib/worker-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-bus.d.ts","sourceRoot":"","sources":["../../../src/state/lib/worker-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAEvC,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IACjE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,WAAW,CAAC,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;CACjD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@semiont/sdk",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "description": "Semiont SDK — SemiontClient, namespaces, session/browser, state units, and the bus-request/cache helpers. Transport-agnostic; pair with @semiont/api-client (HttpTransport) or @semiont/make-meaning (LocalTransport) for the wire.",
   "type": "module",
   "main": "dist/index.js",
@@ -31,7 +31,7 @@
   "scripts": {
     "pretypecheck": "npm run build --workspace=@semiont/core --if-present && npm run build --workspace=@semiont/api-client --if-present",
     "typecheck": "tsc --noEmit",
-    "build": "npm run typecheck && tsup",
+    "build": "npm run typecheck && tsup && tsc -p tsconfig.build.json",
     "watch": "tsup --watch",
     "clean": "rm -rf dist",
     "test": "vitest run",
@@ -46,7 +46,7 @@
   "devDependencies": {
     "@vitest/coverage-v8": "^4.1.0",
     "tsup": "^8.5.1",
-    "typescript": "^5.6.3"
+    "typescript": "^6.0.2"
   },
   "keywords": [
     "semiont",