@octostar/platform-types 0.5.37 → 1.0.0

package/dist/report.d.ts

@@ -0,0 +1,112 @@
+import type { Entity, WorkspaceItem } from './model';
+/**
+ * @beta
+ * A report (.odoc) that is open in the app (Composer tab and/or sidebar).
+ */
+export type OpenReportSummary = {
+    /** Workspace item entity uid */
+    os_entity_uid: string;
+    /** Display title (without .odoc when applicable) */
+    displayName: string;
+    /** Timestamp when the report was last updated, if known */
+    os_last_updated_at?: string;
+    surface: 'tab' | 'sidebar';
+    /** True when this is the document selected in the Composer sidebar */
+    isSidebarSelected?: boolean;
+};
+/**
+ * @beta
+ * Checkbox payload for "Add to report" content.
+ */
+export type AddToReportContentSelection = {
+    coreData: boolean;
+    mainPicture: boolean;
+    allPictures: boolean;
+    relatedLinks: boolean;
+};
+/**
+ * @beta
+ * Minimal TipTap/ProseMirror JSON node shape used by the report append APIs.
+ *
+ * This intentionally mirrors the recursive JSON structure without depending on TipTap packages
+ * from the public platform-types package.
+ */
+export type ReportTiptapNode = {
+    type?: string;
+    attrs?: Record<string, unknown>;
+    text?: string;
+    marks?: {
+        type: string;
+        attrs?: Record<string, unknown>;
+    }[];
+    content?: ReportTiptapNode[];
+};
+type AddToReportBaseInput = {
+    /** Optional: preselect a target report when the flow opens */
+    initialTargetUid?: string;
+    /** Optional: require a live in-memory insert target instead of silently appending to disk */
+    requireLiveInsert?: boolean;
+};
+/**
+ * @beta
+ * Entity-driven "Add to report" payload. The host app will build report blocks from the entity plus
+ * the usual checkbox selection.
+ */
+export type AddToReportEntityInput = AddToReportBaseInput & {
+    mode?: 'entity';
+    /** Entity to snapshot into the report */
+    sourceEntity: Entity;
+    /** Optional: override default checkbox state */
+    initialSelection?: Partial<AddToReportContentSelection>;
+};
+/**
+ * @beta
+ * Arbitrary-content "Add to report" payload. The host app shows the same target-picker UI, but
+ * appends the supplied TipTap JSON blocks directly instead of building them from an entity.
+ */
+export type AddToReportBlocksInput = AddToReportBaseInput & {
+    mode: 'blocks';
+    /** Arbitrary TipTap JSON blocks to append directly into the target report */
+    blocks: ReportTiptapNode[];
+    /** Optional: short label shown in the flow and suggested report name */
+    sourceLabel?: string;
+    /** Optional: explanatory text shown in the flow instead of the entity checkbox section */
+    sourceDescription?: string;
+};
+/**
+ * @beta
+ * Input for {@link ReportApi.presentAddToReportFlow}.
+ */
+export type AddToReportInput = AddToReportEntityInput | AddToReportBlocksInput;
+/**
+ * @beta
+ * Result after a successful append.
+ */
+export type AddToReportResult = {
+    targetOdocUid: string;
+    targetDisplayName: string;
+};
+/**
+ * @beta
+ * Report / Composer integration API (Octostar app).
+ */
+export interface ReportApi {
+    /**
+     * Lists .odoc reports that are currently open (tabs and/or Composer sidebar), with metadata.
+     */
+    getOpenReportSummaries: () => Promise<OpenReportSummary[]>;
+    /**
+     * Lists .odoc files in open workspaces (same discovery as Composer empty state).
+     */
+    listWorkspaceReports: () => Promise<WorkspaceItem[]>;
+    /**
+     * Opens the shared "Add to report" modal.
+     *
+     * Supported payload modes:
+     * - `entity`/default: pick target, choose the usual checkboxes, and append a snapshot of an entity.
+     * - `blocks`: pick target, then append arbitrary TipTap JSON blocks directly.
+     */
+    presentAddToReportFlow: (input: AddToReportInput) => Promise<AddToReportResult | void>;
+}
+export {};
+//# sourceMappingURL=report.d.ts.map

package/dist/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAErD;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,gCAAgC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,KAAK,GAAG,SAAS,CAAC;IAC3B,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,EAAE,CAAC;IACJ,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC9B,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6FAA6F;IAC7F,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,GAAG;IAC1D,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC,CAAC;CACzD,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,GAAG;IAC1D,IAAI,EAAE,QAAQ,CAAC;IACf,6EAA6E;IAC7E,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0FAA0F;IAC1F,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,GAAG,sBAAsB,CAAC;AAE/E;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,sBAAsB,EAAE,MAAM,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAE3D;;OAEG;IACH,oBAAoB,EAAE,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAErD;;;;;;OAMG;IACH,sBAAsB,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CACxF"}

package/dist/report.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":""}

package/dist/savedSet.d.ts

@@ -0,0 +1,5 @@
+export interface SavedSetContent {
+    lastFiredQuery: string;
+    uiState: Record<string, unknown>;
+}
+//# sourceMappingURL=savedSet.d.ts.map

package/dist/savedSet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"savedSet.d.ts","sourceRoot":"","sources":["../src/savedSet.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC"}

package/dist/savedSet.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=savedSet.js.map

package/dist/savedSet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"savedSet.js","sourceRoot":"","sources":["../src/savedSet.ts"],"names":[],"mappings":""}

package/dist/search.d.ts

@@ -1,5 +1,13 @@
-import { type QueryDslQueryContainer } from '@elastic/elasticsearch/lib/api/types';
 import { type Entity, type WorkspaceItem } from './model';
+/**
+ * @beta
+ * An opaque Elasticsearch query-DSL fragment. Previously imported from
+ * `@elastic/elasticsearch`, but that type is an `any`-sea and pulling the whole
+ * ES client (with its OpenTelemetry/undici transitive advisories) into the dev
+ * tree to type a single field wasn't worth it — consumers treat `query`
+ * opaquely (see content-browser queryComposition.ts / createEmbeddingFilter.ts).
+ */
+export type QueryDslQueryContainer = Record<string, unknown>;
 /**
  * @beta
  * Interface representing the properties for the SearchXperience component.
@@ -37,12 +45,41 @@ export interface SearchXperienceModalProps extends SearchXperienceProps {
  * @beta
  * Type representing the search filter.
  */
-export type SearchFilter = {
+export interface SearchFilter {
     label?: string;
     entity?: Entity;
     query?: QueryDslQueryContainer;
     imageUrl?: string;
-};
+    /**
+     * Optional long-form descriptor for this filter. Chips in the UI use
+     * the short `label` on their face and surface `tooltip` in a hover
+     * tooltip — useful when the label alone is ambiguous (for example a
+     * "Folder: Reports" chip whose `tooltip` disambiguates to the full
+     * breadcrumb "WorkspaceName / Projects / 2025 / Reports").
+     */
+    tooltip?: string;
+    /**
+     * Optional classification of how this filter participates in the final
+     * Elasticsearch query. Filters tagged `'scope'` (i.e. those produced by
+     * "Open with the Search Engine" or by dropping items onto search-app) are
+     * combined with OR (`bool.should`); other kinds combine with AND
+     * (`bool.must`). When omitted, the filter behaves as a `bool.must` clause
+     * for backwards compatibility.
+     */
+    kind?: 'scope' | 'concept' | 'text' | 'image';
+    /**
+     * When `true`, this filter is a **hard browsing scope** that must survive a
+     * facet's self-exclusion: it represents the universe the user opened into
+     * (e.g. the "Files" or "Records" section they launched the Search Engine
+     * from), not a pivotable facet pick. Normally an AND-combined (`'concept'`)
+     * filter whose query references a facet's own field is dropped from that
+     * facet's bucket counts so the user can pivot between sibling values; a
+     * pinned scope is kept regardless, so the by-type facet stays constrained to
+     * the section you opened. No effect on OR-combined (`'scope'`) filters, which
+     * already survive self-exclusion. Defaults to unpinned.
+     */
+    pinned?: boolean;
+}
 /**
  * @beta
  * Interface representing the properties for the Search component.
@@ -64,6 +101,7 @@ export interface SearchProps {
      * the default image to use for the search.
      */
     image?: WorkspaceItem;
+    selectMode?: 'single' | 'multi';
     /**
      * disable ask AI
      */
@@ -81,6 +119,15 @@ export interface SearchProps {
      */
     searchInfoDescription?: React.ReactNode;
 }
+/**
+ * @beta
+ * Represents the result of a query-mode search: the raw Elasticsearch query
+ * plus the total number of matching documents.
+ */
+export interface SearchQueryResult {
+    query: Record<string, unknown>;
+    numberOfResults: number;
+}
 /**
  * @beta
  * Interface representing the options given to search
@@ -91,5 +138,95 @@ export interface SearchOptions {
      */
     limit?: number;
     workspace_ids?: string[];
+    /** Cheaper than listing everywhere-else; neither grants access. */
+    exclude_workspace_ids?: string[];
+    /**
+     * Entity types to exclude.
+     */
+    exclude_entity_types?: string[];
+    /**
+     * Narrow to these types. {@link limit} is applied on `_score` alone, so without
+     * this a broad term spends the whole result set on types the caller discards.
+     */
+    entity_types?: string[];
+    /**
+     * Look up these entities by uid, with an empty query. Treat an absent one as
+     * "ask again".
+     */
+    os_entity_uids?: string[];
+    /**
+     * How wide to match. See {@link SearchScope}.
+     */
+    scope?: SearchScope;
+    /**
+     * Override the response shape. The default ships every field except the heavy
+     * annotation blobs (extracted text, chunks, NER arrays), which is what a hit
+     * list needs; pass this only when a caller genuinely wants something narrower
+     * or one of the excluded keys.
+     */
+    source?: {
+        includes?: string[];
+        excludes?: string[];
+    };
 }
+/**
+ * How wide a text search matches — THE declaration; every other scope type
+ * derives from it (`FinderSearchScope` adds an `'off'` rung on top).
+ *
+ * `names` is a filter-a-list surface: the name only, and also *inside* it
+ * (`atch` → `match.pdf`), which the analyzed tiers cannot do — a hit whose
+ * text mentions the term but whose name does not reads as wrong there.
+ * `names+contents` is the full relevance ladder, extracted text included.
+ *
+ * One value rather than two flags: they were only ever set together, and a
+ * caller asking for substring matching without names-only meant nothing.
+ */
+export type SearchScope = 'names' | 'names+contents';
+export interface SearchInnerHit {
+    _score?: number | null;
+    _source?: Record<string, unknown>;
+}
+/**
+ * One raw engine hit, the subset of the ES/OpenSearch hit shape Octostar
+ * reads. Lives here — not in a UI package — because both the Content
+ * Browser and the app's search layer consume the same hits; the UI
+ * package re-exports it for back-compat.
+ */
+export interface SearchHit {
+    _id: string;
+    _index?: string;
+    _score?: number;
+    _source: Record<string, unknown>;
+    highlight?: Record<string, string[]>;
+    inner_hits?: Record<string, {
+        hits: {
+            total?: {
+                value: number;
+                relation: 'eq' | 'gte';
+            } | number;
+            hits: SearchInnerHit[];
+        };
+    }>;
+}
+/**
+ * Annotation keys never worth shipping with a hit list: `rag:fulltext` and
+ * `rag:chunks` carry every document's extracted text (a 200-hit search shipped
+ * ~10 MB of it to draw a list of names), `ner:entities` is a long array nothing
+ * renders, and the heavy `materialized` children are the detection copies with
+ * their vectors and the NER and geo rollups. The small
+ * `materialized.image:labels*` arrays ride along: they are how a card learns
+ * that a document holds a flagged image on one of its pages.
+ *
+ * An exclude list rather than an allowlist, deliberately: the small card-shaped
+ * annotations (`summary:txt`, `image:annotations-*`) have to ride along, and a
+ * field nobody thought of must arrive rather than vanish. Exported so any caller
+ * that shapes its own `_source` trims the same things — two lists would drift,
+ * and the drift shows up as a blank cell nobody can explain.
+ *
+ * Lives here with the rest of the wire contract — not in a UI package, and not
+ * in platform-api (whose barrel several test suites blanket-mock; a constant
+ * read at module scope must survive that). The Content Browser re-exports it
+ * for back-compat.
+ */
+export declare const HEAVY_ANNOTATION_FIELDS: readonly string[];
 //# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACtC,+CAA+C;IAC/C,sBAAsB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7C,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9E;AAED;;;GAGG;AACH,MAAM,WAAW,yBAA0B,SAAQ,oBAAoB;IACrE,iCAAiC;IACjC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B;;;;OAIG;IACH,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,SAAS,CAAC;CACnD;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,CAAC,CAAC,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB;;OAEG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,qBAAqB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"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"}

package/dist/search.js

@@ -1,2 +1,33 @@
-export {};
+/**
+ * Annotation keys never worth shipping with a hit list: `rag:fulltext` and
+ * `rag:chunks` carry every document's extracted text (a 200-hit search shipped
+ * ~10 MB of it to draw a list of names), `ner:entities` is a long array nothing
+ * renders, and the heavy `materialized` children are the detection copies with
+ * their vectors and the NER and geo rollups. The small
+ * `materialized.image:labels*` arrays ride along: they are how a card learns
+ * that a document holds a flagged image on one of its pages.
+ *
+ * An exclude list rather than an allowlist, deliberately: the small card-shaped
+ * annotations (`summary:txt`, `image:annotations-*`) have to ride along, and a
+ * field nobody thought of must arrive rather than vanish. Exported so any caller
+ * that shapes its own `_source` trims the same things — two lists would drift,
+ * and the drift shows up as a blank cell nobody can explain.
+ *
+ * Lives here with the rest of the wire contract — not in a UI package, and not
+ * in platform-api (whose barrel several test suites blanket-mock; a constant
+ * read at module scope must survive that). The Content Browser re-exports it
+ * for back-compat.
+ */
+export const HEAVY_ANNOTATION_FIELDS = [
+    'annotations.rag:fulltext',
+    'annotations.rag:chunks',
+    'annotations.extract:metadata',
+    'annotations.extract:src',
+    'annotations.extract:txtLang',
+    'annotations.ner:entities',
+    'annotations.materialized.image:annotations*',
+    'annotations.materialized.ner:*',
+    'annotations.materialized.exif:*',
+    'annotations.extract:txt',
+];
 //# sourceMappingURL=search.js.map

package/dist/search.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":""}
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAkNA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAsB;IACxD,0BAA0B;IAC1B,wBAAwB;IACxB,8BAA8B;IAC9B,yBAAyB;IACzB,6BAA6B;IAC7B,0BAA0B;IAC1B,6CAA6C;IAC7C,gCAAgC;IAChC,iCAAiC;IACjC,yBAAyB;CAC1B,CAAC"}

package/dist/semantic.d.ts

@@ -1,4 +1,4 @@
-import { ConceptName } from './model';
+import { type ConceptName } from './model';
 /**
  * @beta
  * Type representing the properties for a template binding.
@@ -10,6 +10,8 @@ export interface SemanticBindingProps {
     priority?: number;
     /** Whether the result should be shown in large mode by default */
     maximized?: boolean;
+    /** Sift-compatible query evaluated against the entity. When present, the binding only matches if the filter passes. */
+    filter?: Record<string, any>;
     /** Other properties */
     [key: string]: any;
 }
@@ -32,9 +34,26 @@ export type SemanticBinding = {
 };
 /**
  * @beta
- * Type representing multiple semantic bindings.
+ * Options of one concept in an app manifest's `semantic_bindings`.
  */
-export type SemanticBindings = {
-    [k in SemanticBindingType]: (ConceptName | SemanticBinding)[];
-};
+export interface SemanticBindingOptions {
+    /** Order among the bindings for an entity. Lower comes first. */
+    priority?: number;
+    /** `record_viewer` only: open the tab full screen. */
+    maximized?: boolean;
+    /** Sift-compatible query evaluated against the entity. The binding applies only when it matches. */
+    filter?: Record<string, unknown>;
+}
+/**
+ * @beta
+ * The bindings of one role: a concept name, a list of concept names and one-key maps of concept to options,
+ * or a map of concept to options.
+ */
+export type SemanticBindingSpec = ConceptName | (ConceptName | Record<ConceptName, SemanticBindingOptions | null>)[] | Record<ConceptName, SemanticBindingOptions | null>;
+/**
+ * @beta
+ * An app manifest's `semantic_bindings`: the bindings per role. The platform reads `opener`
+ * (a double-click on a matching entity opens the app) and `record_viewer` (the app is a Record Viewer tab).
+ */
+export type SemanticBindings = Partial<Record<SemanticBindingType, SemanticBindingSpec>>;
 //# sourceMappingURL=semantic.d.ts.map

package/dist/semantic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../src/semantic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uBAAuB;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,MAAM,CAAC;AAE3D;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,+CAA+C;IAC/C,OAAO,EAAE,WAAW,CAAC;IACrB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,oCAAoC;IACpC,KAAK,CAAC,EAAE,oBAAoB,CAAC;CAC9B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;KAC5B,CAAC,IAAI,mBAAmB,GAAG,CAAC,WAAW,GAAG,eAAe,CAAC,EAAE;CAC9D,CAAC"}
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../src/semantic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uHAAuH;IACvH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,uBAAuB;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,MAAM,CAAC;AAE3D;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,+CAA+C;IAC/C,OAAO,EAAE,WAAW,CAAC;IACrB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,oCAAoC;IACpC,KAAK,CAAC,EAAE,oBAAoB,CAAC;CAC9B,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oGAAoG;IACpG,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B,WAAW,GACX,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,sBAAsB,GAAG,IAAI,CAAC,CAAC,EAAE,GACpE,MAAM,CAAC,WAAW,EAAE,sBAAsB,GAAG,IAAI,CAAC,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,CAAC,CAAC"}

package/dist/templates.d.ts

@@ -1,6 +1,7 @@
 import { type ModalProps } from 'antd';
-import { type ReactCssProperties } from './react-types';
+import { type ReactCssProperties, type ReactNode } from './react-types';
 import { type SemanticBinding } from './semantic';
+import { type WorkspaceItem } from './model';
 /**
  * @beta
  * Type representing the possible template types.
@@ -38,18 +39,27 @@ export type TemplateMetadata = {
     style?: ReactCssProperties;
     /** Whether the template renders multiple records. */
     rendersMultipleRecords?: boolean;
-    /** Whether the template is an app. */
-    isApp?: boolean;
     /** details for semantic bindings. These can be app-specific */
     bindings?: SemanticBinding[];
+    /** Optional CSS injected when the template renders. */
+    css_content?: string;
 };
 /**
  * @beta
  * Type representing a custom template, extending TemplateMetadata.
+ *
+ * `os_entity_uid` and `os_workspace` are optional here so an in-memory
+ * template built via `newCustomTemplate()` can still flow through
+ * `RenderableTemplate`-typed code paths. `SavedTemplate` narrows both
+ * to required strings.
  */
 export type CustomTemplate = TemplateMetadata & {
     /** The template content. */
     template: string;
+    /** Set once the template is persisted as a workspace item. */
+    os_entity_uid?: string;
+    /** Set once the template is persisted as a workspace item. */
+    os_workspace?: string;
 };
 /**
  * @beta
@@ -60,9 +70,57 @@ export type SavedTemplate = CustomTemplate & {
     os_entity_uid: string;
     /** The workspace to which the template belongs. */
     os_workspace: string;
-    /** The CSS content of the template. */
-    css_content?: string;
 };
+/**
+ * @beta
+ * Props passed to a code-resident default template's React component.
+ */
+export type DefaultTemplateProps = {
+    /** The record this template is rendering for, if any. */
+    record?: WorkspaceItem;
+    /** The same context object passed to react-live templates. */
+    context?: any;
+    /** Optional extra scope variables forwarded from `<OsTemplate extraScope>`. */
+    extraScope?: Record<string, unknown>;
+};
+/**
+ * @beta
+ * A code-resident default template. Carries the same metadata as a
+ * `SavedTemplate` so it can flow through the existing template lookup
+ * pipeline, but renders via a real React component rather than a
+ * `react-live` string.
+ *
+ * Defaults always have `os_workspace === ''` — that's the marker
+ * `isDefaultTemplate` looks for and disambiguates them from workspace
+ * templates whose `os_workspace` is always a real UUID.
+ */
+export type DefaultTemplate = TemplateMetadata & {
+    /** Synthetic identifier, e.g. `default-template-PersonInfo`. */
+    os_entity_uid: string;
+    /** Empty string marks this as a code-resident default. */
+    os_workspace: '';
+    /** The React component that renders this template. */
+    component: (props: DefaultTemplateProps) => ReactNode;
+};
+/**
+ * @beta
+ * Union of every shape a template lookup may return:
+ * - workspace-stored `SavedTemplate` (rendered via `react-live`),
+ * - code-resident `DefaultTemplate` (rendered as a real React component),
+ * - in-memory `CustomTemplate` produced by `newCustomTemplate()` before
+ *   it has been persisted.
+ *
+ * `SavedTemplate ⊂ CustomTemplate`, so this is structurally equivalent
+ * to `CustomTemplate | DefaultTemplate`; the explicit list is kept for
+ * readability.
+ */
+export type RenderableTemplate = SavedTemplate | DefaultTemplate | CustomTemplate;
+/**
+ * @beta
+ * Type guard distinguishing code-resident default templates from
+ * workspace-stored ones.
+ */
+export declare function isDefaultTemplate(t: RenderableTemplate | undefined | null): t is DefaultTemplate;
 /**
  * @beta
  * Type representing the properties for a custom template iframe.

package/dist/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,YAAY,CAAC;AAErD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;AAErC;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,IAAI,EAAE,YAAY,CAAC;IACnB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,OAAO,EAAE,eAAe,CAAC;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,gDAAgD;IAChD,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,qDAAqD;IACrD,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,sCAAsC;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;CAC9B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG;IAC9C,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG;IAC3C,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,iDAAiD;IACjD,QAAQ,EAAE,cAAc,GAAG,aAAa,GAAG,MAAM,CAAC;IAClD,oCAAoC;IACpC,OAAO,EAAE,GAAG,CAAC;IACb,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7C,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,qDAAqD;IACrD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,yBAAyB,GAAG;IAC3D,yCAAyC;IACzC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,iCAAiC;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,cAAc,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"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"}

package/dist/templates.js

@@ -1,2 +1,9 @@
-export {};
+/**
+ * @beta
+ * Type guard distinguishing code-resident default templates from
+ * workspace-stored ones.
+ */
+export function isDefaultTemplate(t) {
+    return (Boolean(t) && t.os_workspace === '' && typeof t.component === 'function');
+}
 //# sourceMappingURL=templates.js.map

package/dist/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":""}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AA8HA;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,CAAwC;IACxE,OAAO,CACL,OAAO,CAAC,CAAC,CAAC,IAAK,CAAqB,CAAC,YAAY,KAAK,EAAE,IAAI,OAAQ,CAAqB,CAAC,SAAS,KAAK,UAAU,CACnH,CAAC;AACJ,CAAC"}

package/dist/workspace.d.ts

@@ -1,5 +1,27 @@
 import type { AddListener, Callback, Unsubscribe } from './callback';
-import type { Entity, OsTag, WorkspaceItem, WorkspaceItems, WorkspaceRelationship } from './model';
+import type { Entity, OsTag, WorkspaceItem, WorkspaceRelationship } from './model';
+/**
+ * A `WorkspaceItem` carrying the app's resolved iframe URL on the runtime-only
+ * `#appUrl` field.
+ *
+ * IMPORTANT: `#appUrl` is **runtime-only and never persisted**. It is hydrated
+ * in-memory from the K8s apps API (e.g. by `DesktopAPI.getApp` /
+ * `hydrateWithK8sState`) and is **stripped on any JSON round-trip** — notably
+ * the flexlayout tab-config serialization. Never read `#appUrl` off an item
+ * that was restored or deserialized; resolve the live URL via
+ * `useAppDeploymentState` instead. `os_item_content.app_url` no longer carries
+ * the URL — it is gone.
+ */
+export type RuntimeAppUrlWorkspaceItem = WorkspaceItem & {
+    '#appUrl'?: string;
+};
+/** {@link RuntimeAppUrlWorkspaceItem} for the raw `Entity` shape (e.g. the
+ *  synthetic iframe-transform items built in the job services). Same
+ *  runtime-only `#appUrl` contract — never persisted, never read off a
+ *  restored item. */
+export type RuntimeAppUrlEntity = Entity & {
+    '#appUrl'?: string;
+};
 /**
  * @beta
  * Type representing information about a tag.
@@ -69,44 +91,6 @@ export type WorkspaceFlags = {
     autoOpen?: boolean;
     isHidden?: boolean;
 };
-/**
- * @beta
- * Type representing information about records in a workspace.
- */
-export type WorkspaceRecordInfo = {
-    /** The concept associated with the records. */
-    concept: string;
-    /** The count of records. */
-    count: number;
-    /** The last updated timestamp for the records. */
-    max_last_updated: string;
-    /** The entities associated with the records. */
-    entities: Entity[];
-};
-/**
- * @beta
- * Type representing a collection of workspace records.
- */
-export type WorkspaceRecords = Record<string, WorkspaceRecordInfo>;
-/**
- * @beta
- * Type representing a workspace.
- */
-export type Workspace = {
-    /** The workspace item. */
-    workspace: WorkspaceItem;
-    /** The items in the workspace. */
-    items: WorkspaceItems;
-    /** Optional records in the workspace. */
-    workspace_records?: WorkspaceRecords;
-    /** Optional tags in the workspace. */
-    tags?: TagInfo[];
-    /** Optional permission for the workspace. */
-    permission?: WorkspacePermission;
-    /** Whether the workspace is active. */
-    isActive?: boolean;
-    os_flags?: number;
-};
 /**
  * @beta
  * Type representing a UUID.
@@ -147,7 +131,7 @@ export interface WorkspaceChangeEmitter {
      * @param callback - The callback to invoke on changes.
      * @returns A promise that resolves to an unsubscribe function.
      */
-    onWorkspaceChanged: (ws: WorkspaceIdentifier, callback: Callback<Workspace>) => Promise<Unsubscribe>;
+    onWorkspaceChanged: (ws: WorkspaceIdentifier, callback: Callback<WorkspaceItem>) => Promise<Unsubscribe>;
     /**
      * Subscribes to changes for a given workspace item.
      * @param item - The workspace item identifier.
@@ -160,7 +144,7 @@ export interface WorkspaceChangeEmitter {
      * @param callback - The callback to invoke with the current open workspaces.
      * @returns A promise that resolves to an unsubscribe function.
      */
-    onOpenWorkspacesChanged: AddListener<Workspace[]>;
+    onOpenWorkspacesChanged: AddListener<WorkspaceItem[]>;
 }
 /**
  * @beta