@tutti-os/workspace-external-core 0.0.25 → 0.0.26

package/README.md

@@ -25,3 +25,26 @@ trusted app APIs may read or update host workspace state directly.
   state.
 - `workspace.openFeature()` for user-activated host workspace navigation, such as opening the message center.
 - `logs.write()` for fire-and-forget frontend diagnostics that append to the workspace app `web.log`.
+
+## Rich Text At Providers
+
+Workspace apps that use `@tutti-os/ui-rich-text` can adapt host mention
+candidates from `window.tuttiExternal.at.query()` directly into rich-text trigger
+providers:
+
+```ts
+import { createTuttiExternalAtRichTextTriggerProviders } from "@tutti-os/workspace-external-core/rich-text";
+
+const triggerProviders = createTuttiExternalAtRichTextTriggerProviders({
+  bridge: window.tuttiExternal,
+  providerIds: ["workspace-app", "agent-session", "agent-generated-file"]
+});
+```
+
+Each external at provider becomes one `RichTextTriggerProvider` with the same
+provider id. This keeps rich-text categories and sections aligned with the host
+contract, while the app still owns local-only mention sources, caching policy,
+i18n labels, palette categories, row rendering, and insertion side effects.
+
+See `@tutti-os/ui-rich-text` for the generic trigger-provider and at-panel
+contracts.

package/dist/chunk-B5XB2VL2.js

@@ -0,0 +1,53 @@
+import {
+  tuttiExternalAtProviderIds
+} from "./chunk-WVMOSO4W.js";
+
+// src/rich-text/index.ts
+async function queryTuttiExternalAtRichTextTriggerItems(input) {
+  const bridge = input.bridge?.at;
+  if (!bridge) return [];
+  const providerIds = input.providerIds === void 0 ? tuttiExternalAtProviderIds : input.providerIds;
+  const results = await bridge.query({
+    keyword: input.keyword,
+    ...input.maxResults !== void 0 ? { maxResults: input.maxResults } : {},
+    providers: providerIds
+  });
+  const providerSet = new Set(providerIds);
+  return results.filter((item) => providerSet.has(item.providerId));
+}
+function createTuttiExternalAtRichTextTriggerProvider(input) {
+  return {
+    id: input.providerId,
+    trigger: "@",
+    async query(queryInput) {
+      return queryTuttiExternalAtRichTextTriggerItems({
+        bridge: input.bridge,
+        keyword: queryInput.keyword,
+        maxResults: queryInput.maxResults ?? input.maxResults,
+        providerIds: [input.providerId]
+      });
+    },
+    getItemKey: (item) => item.itemId,
+    getItemLabel: (item) => item.label,
+    getItemSubtitle: (item) => item.subtitle,
+    getItemIconUrl: (item) => item.thumbnailUrl ?? (item.insert.kind === "mention" ? item.insert.mention.presentation?.iconUrl ?? item.insert.mention.presentation?.thumbnailUrl ?? item.insert.mention.presentation?.agentIconUrl : void 0),
+    toInsertResult: (item) => item.insert
+  };
+}
+function createTuttiExternalAtRichTextTriggerProviders(input) {
+  const providerIds = input.providerIds === void 0 ? tuttiExternalAtProviderIds : input.providerIds;
+  return providerIds.map(
+    (providerId) => createTuttiExternalAtRichTextTriggerProvider({
+      bridge: input.bridge,
+      providerId,
+      maxResults: input.maxResults
+    })
+  );
+}
+
+export {
+  queryTuttiExternalAtRichTextTriggerItems,
+  createTuttiExternalAtRichTextTriggerProvider,
+  createTuttiExternalAtRichTextTriggerProviders
+};
+//# sourceMappingURL=chunk-B5XB2VL2.js.map

package/dist/chunk-B5XB2VL2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/rich-text/index.ts"],"sourcesContent":["import {\n  tuttiExternalAtProviderIds,\n  type TuttiExternalAtProviderId,\n  type TuttiExternalAtQueryInput,\n  type TuttiExternalAtQueryResult\n} from \"../contracts/index.ts\";\nimport type {\n  RichTextTriggerInsertResult,\n  RichTextTriggerProvider\n} from \"@tutti-os/ui-rich-text/types\";\n\nexport interface TuttiExternalAtRichTextBridge {\n  at?: {\n    query(\n      input: TuttiExternalAtQueryInput\n    ):\n      | Promise<readonly TuttiExternalAtQueryResult[]>\n      | readonly TuttiExternalAtQueryResult[];\n  };\n}\n\nexport interface CreateTuttiExternalAtRichTextTriggerProviderInput {\n  bridge: TuttiExternalAtRichTextBridge | null | undefined;\n  providerId: TuttiExternalAtProviderId;\n  maxResults?: number;\n}\n\nexport interface CreateTuttiExternalAtRichTextTriggerProvidersInput {\n  bridge: TuttiExternalAtRichTextBridge | null | undefined;\n  providerIds?: readonly TuttiExternalAtProviderId[];\n  maxResults?: number;\n}\n\nexport interface QueryTuttiExternalAtRichTextTriggerItemsInput {\n  bridge: TuttiExternalAtRichTextBridge | null | undefined;\n  keyword: string;\n  providerIds?: readonly TuttiExternalAtProviderId[];\n  maxResults?: number;\n}\n\nexport async function queryTuttiExternalAtRichTextTriggerItems(\n  input: QueryTuttiExternalAtRichTextTriggerItemsInput\n): Promise<readonly TuttiExternalAtQueryResult[]> {\n  const bridge = input.bridge?.at;\n  if (!bridge) return [];\n\n  const providerIds =\n    input.providerIds === undefined\n      ? tuttiExternalAtProviderIds\n      : input.providerIds;\n  const results = await bridge.query({\n    keyword: input.keyword,\n    ...(input.maxResults !== undefined ? { maxResults: input.maxResults } : {}),\n    providers: providerIds\n  });\n  const providerSet = new Set<TuttiExternalAtProviderId>(providerIds);\n  return results.filter((item) => providerSet.has(item.providerId));\n}\n\nexport function createTuttiExternalAtRichTextTriggerProvider(\n  input: CreateTuttiExternalAtRichTextTriggerProviderInput\n): RichTextTriggerProvider<TuttiExternalAtQueryResult> {\n  return {\n    id: input.providerId,\n    trigger: \"@\",\n    async query(queryInput) {\n      return queryTuttiExternalAtRichTextTriggerItems({\n        bridge: input.bridge,\n        keyword: queryInput.keyword,\n        maxResults: queryInput.maxResults ?? input.maxResults,\n        providerIds: [input.providerId]\n      });\n    },\n    getItemKey: (item) => item.itemId,\n    getItemLabel: (item) => item.label,\n    getItemSubtitle: (item) => item.subtitle,\n    getItemIconUrl: (item) =>\n      item.thumbnailUrl ??\n      (item.insert.kind === \"mention\"\n        ? (item.insert.mention.presentation?.iconUrl ??\n          item.insert.mention.presentation?.thumbnailUrl ??\n          item.insert.mention.presentation?.agentIconUrl)\n        : undefined),\n    toInsertResult: (item) => item.insert as RichTextTriggerInsertResult\n  };\n}\n\nexport function createTuttiExternalAtRichTextTriggerProviders(\n  input: CreateTuttiExternalAtRichTextTriggerProvidersInput\n): readonly RichTextTriggerProvider<TuttiExternalAtQueryResult>[] {\n  const providerIds =\n    input.providerIds === undefined\n      ? tuttiExternalAtProviderIds\n      : input.providerIds;\n  return providerIds.map((providerId) =>\n    createTuttiExternalAtRichTextTriggerProvider({\n      bridge: input.bridge,\n      providerId,\n      maxResults: input.maxResults\n    })\n  );\n}\n"],"mappings":";;;;;AAwCA,eAAsB,yCACpB,OACgD;AAChD,QAAM,SAAS,MAAM,QAAQ;AAC7B,MAAI,CAAC,OAAQ,QAAO,CAAC;AAErB,QAAM,cACJ,MAAM,gBAAgB,SAClB,6BACA,MAAM;AACZ,QAAM,UAAU,MAAM,OAAO,MAAM;AAAA,IACjC,SAAS,MAAM;AAAA,IACf,GAAI,MAAM,eAAe,SAAY,EAAE,YAAY,MAAM,WAAW,IAAI,CAAC;AAAA,IACzE,WAAW;AAAA,EACb,CAAC;AACD,QAAM,cAAc,IAAI,IAA+B,WAAW;AAClE,SAAO,QAAQ,OAAO,CAAC,SAAS,YAAY,IAAI,KAAK,UAAU,CAAC;AAClE;AAEO,SAAS,6CACd,OACqD;AACrD,SAAO;AAAA,IACL,IAAI,MAAM;AAAA,IACV,SAAS;AAAA,IACT,MAAM,MAAM,YAAY;AACtB,aAAO,yCAAyC;AAAA,QAC9C,QAAQ,MAAM;AAAA,QACd,SAAS,WAAW;AAAA,QACpB,YAAY,WAAW,cAAc,MAAM;AAAA,QAC3C,aAAa,CAAC,MAAM,UAAU;AAAA,MAChC,CAAC;AAAA,IACH;AAAA,IACA,YAAY,CAAC,SAAS,KAAK;AAAA,IAC3B,cAAc,CAAC,SAAS,KAAK;AAAA,IAC7B,iBAAiB,CAAC,SAAS,KAAK;AAAA,IAChC,gBAAgB,CAAC,SACf,KAAK,iBACJ,KAAK,OAAO,SAAS,YACjB,KAAK,OAAO,QAAQ,cAAc,WACnC,KAAK,OAAO,QAAQ,cAAc,gBAClC,KAAK,OAAO,QAAQ,cAAc,eAClC;AAAA,IACN,gBAAgB,CAAC,SAAS,KAAK;AAAA,EACjC;AACF;AAEO,SAAS,8CACd,OACgE;AAChE,QAAM,cACJ,MAAM,gBAAgB,SAClB,6BACA,MAAM;AACZ,SAAO,YAAY;AAAA,IAAI,CAAC,eACtB,6CAA6C;AAAA,MAC3C,QAAQ,MAAM;AAAA,MACd;AAAA,MACA,YAAY,MAAM;AAAA,IACpB,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export { TUTTI_EXTERNAL_AT_PROVIDER_IDS, TuttiExternalAtInsertResult, TuttiExternalAtMentionPresentation, TuttiExternalAtProviderId, TuttiExternalAtQueryInput, TuttiExternalAtQueryResult, TuttiExternalBridge, TuttiExternalFileOpenInput, TuttiExternalFileSelectInput, TuttiExternalFileSelectResult, TuttiExternalFileUploadInput, TuttiExternalFileUploadProgress, TuttiExternalLogInput, TuttiExternalLogLevel, TuttiExternalManagedAiModel, TuttiExternalManagedAiModelProviderId, TuttiExternalPdfMargin, TuttiExternalPdfPageSize, TuttiExternalPdfPrintHtmlInput, TuttiExternalPdfPrintHtmlResult, TuttiExternalPermissionRequestInput, TuttiExternalPermissionRequestResult, TuttiExternalReferenceOpenInput, TuttiExternalRendererRequest, TuttiExternalSettingsOpenInput, TuttiExternalUploadedFile, TuttiExternalUserProjectCreateInput, TuttiExternalUserProjectPathInput, TuttiExternalUserProjectRememberDefaultSelectionInput, TuttiExternalWorkspaceAgentProvider, TuttiExternalWorkspaceFeature, TuttiExternalWorkspaceOpenFeatureInput, tuttiExternalAtProviderIds, tuttiExternalLogLevels, tuttiExternalManagedAiModelProviderIds, tuttiExternalWorkspaceAgentProviders } from './contracts/index.js';
 export { isTuttiExternalAtProviderId, isTuttiExternalManagedAiModelProviderId, isTuttiExternalWorkspaceAgentProvider, isTuttiExternalWorkspaceFeature, limitDiagnosticText, normalizeTuttiExternalAtQueryInput, normalizeTuttiExternalFileOpenInput, normalizeTuttiExternalFileSelectInput, normalizeTuttiExternalFileUploadInput, normalizeTuttiExternalLogInput, normalizeTuttiExternalPdfPrintHtmlInput, normalizeTuttiExternalPermissionRequestInput, normalizeTuttiExternalReferenceOpenInput, normalizeTuttiExternalSettingsOpenInput, normalizeTuttiExternalUserProjectCreateInput, normalizeTuttiExternalUserProjectPathInput, normalizeTuttiExternalUserProjectRememberDefaultSelectionInput, normalizeTuttiExternalUserProjectSelectionPreparationInput, normalizeTuttiExternalWorkspaceOpenFeatureInput, tuttiExternalAtDefaultMaxResults, tuttiExternalAtMaxResultsLimit, tuttiExternalLogDiagnosticTextLimit, tuttiExternalWorkspaceFeatures } from './core/index.js';
+export { CreateTuttiExternalAtRichTextTriggerProviderInput, CreateTuttiExternalAtRichTextTriggerProvidersInput, QueryTuttiExternalAtRichTextTriggerItemsInput, TuttiExternalAtRichTextBridge, createTuttiExternalAtRichTextTriggerProvider, createTuttiExternalAtRichTextTriggerProviders, queryTuttiExternalAtRichTextTriggerItems } from './rich-text/index.js';
 import '@tutti-os/workspace-file-reference/contracts';
 import '@tutti-os/workspace-user-project/contracts';
+import '@tutti-os/ui-rich-text/types';

package/dist/index.js

@@ -23,12 +23,19 @@ import {
   tuttiExternalLogDiagnosticTextLimit,
   tuttiExternalWorkspaceFeatures
 } from "./chunk-GQKGWQGE.js";
+import {
+  createTuttiExternalAtRichTextTriggerProvider,
+  createTuttiExternalAtRichTextTriggerProviders,
+  queryTuttiExternalAtRichTextTriggerItems
+} from "./chunk-B5XB2VL2.js";
 import {
   tuttiExternalAtProviderIds,
   tuttiExternalManagedAiModelProviderIds,
   tuttiExternalWorkspaceAgentProviders
 } from "./chunk-WVMOSO4W.js";
 export {
+  createTuttiExternalAtRichTextTriggerProvider,
+  createTuttiExternalAtRichTextTriggerProviders,
   isTuttiExternalAtProviderId,
   isTuttiExternalManagedAiModelProviderId,
   isTuttiExternalWorkspaceAgentProvider,
@@ -48,6 +55,7 @@ export {
   normalizeTuttiExternalUserProjectRememberDefaultSelectionInput,
   normalizeTuttiExternalUserProjectSelectionPreparationInput,
   normalizeTuttiExternalWorkspaceOpenFeatureInput,
+  queryTuttiExternalAtRichTextTriggerItems,
   tuttiExternalAtDefaultMaxResults,
   tuttiExternalAtMaxResultsLimit,
   tuttiExternalAtProviderIds,

package/dist/rich-text/index.d.ts

@@ -0,0 +1,31 @@
+import { TuttiExternalAtQueryInput, TuttiExternalAtQueryResult, TuttiExternalAtProviderId } from '../contracts/index.js';
+import { RichTextTriggerProvider } from '@tutti-os/ui-rich-text/types';
+import '@tutti-os/workspace-file-reference/contracts';
+import '@tutti-os/workspace-user-project/contracts';
+
+interface TuttiExternalAtRichTextBridge {
+    at?: {
+        query(input: TuttiExternalAtQueryInput): Promise<readonly TuttiExternalAtQueryResult[]> | readonly TuttiExternalAtQueryResult[];
+    };
+}
+interface CreateTuttiExternalAtRichTextTriggerProviderInput {
+    bridge: TuttiExternalAtRichTextBridge | null | undefined;
+    providerId: TuttiExternalAtProviderId;
+    maxResults?: number;
+}
+interface CreateTuttiExternalAtRichTextTriggerProvidersInput {
+    bridge: TuttiExternalAtRichTextBridge | null | undefined;
+    providerIds?: readonly TuttiExternalAtProviderId[];
+    maxResults?: number;
+}
+interface QueryTuttiExternalAtRichTextTriggerItemsInput {
+    bridge: TuttiExternalAtRichTextBridge | null | undefined;
+    keyword: string;
+    providerIds?: readonly TuttiExternalAtProviderId[];
+    maxResults?: number;
+}
+declare function queryTuttiExternalAtRichTextTriggerItems(input: QueryTuttiExternalAtRichTextTriggerItemsInput): Promise<readonly TuttiExternalAtQueryResult[]>;
+declare function createTuttiExternalAtRichTextTriggerProvider(input: CreateTuttiExternalAtRichTextTriggerProviderInput): RichTextTriggerProvider<TuttiExternalAtQueryResult>;
+declare function createTuttiExternalAtRichTextTriggerProviders(input: CreateTuttiExternalAtRichTextTriggerProvidersInput): readonly RichTextTriggerProvider<TuttiExternalAtQueryResult>[];
+
+export { type CreateTuttiExternalAtRichTextTriggerProviderInput, type CreateTuttiExternalAtRichTextTriggerProvidersInput, type QueryTuttiExternalAtRichTextTriggerItemsInput, type TuttiExternalAtRichTextBridge, createTuttiExternalAtRichTextTriggerProvider, createTuttiExternalAtRichTextTriggerProviders, queryTuttiExternalAtRichTextTriggerItems };

package/dist/rich-text/index.js

@@ -0,0 +1,12 @@
+import {
+  createTuttiExternalAtRichTextTriggerProvider,
+  createTuttiExternalAtRichTextTriggerProviders,
+  queryTuttiExternalAtRichTextTriggerItems
+} from "../chunk-B5XB2VL2.js";
+import "../chunk-WVMOSO4W.js";
+export {
+  createTuttiExternalAtRichTextTriggerProvider,
+  createTuttiExternalAtRichTextTriggerProviders,
+  queryTuttiExternalAtRichTextTriggerItems
+};
+//# sourceMappingURL=index.js.map

package/dist/rich-text/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tutti-os/workspace-external-core",
-  "version": "0.0.25",
+  "version": "0.0.26",
   "private": false,
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -16,6 +16,10 @@
     "./core": {
       "types": "./dist/core/index.d.ts",
       "import": "./dist/core/index.js"
+    },
+    "./rich-text": {
+      "types": "./dist/rich-text/index.d.ts",
+      "import": "./dist/rich-text/index.js"
     }
   },
   "files": [
@@ -28,8 +32,9 @@
     "directory": "packages/workspace/external-core"
   },
   "dependencies": {
-    "@tutti-os/workspace-file-reference": "0.0.25",
-    "@tutti-os/workspace-user-project": "0.0.25"
+    "@tutti-os/ui-rich-text": "0.0.26",
+    "@tutti-os/workspace-file-reference": "0.0.26",
+    "@tutti-os/workspace-user-project": "0.0.26"
   },
   "devDependencies": {
     "@types/node": "^24.0.1",
@@ -43,5 +48,18 @@
     "build": "tsup --config tsup.config.ts",
     "test": "node --test --experimental-strip-types \"./src/**/*.test.ts\"",
     "typecheck": "node ../../../tools/scripts/run-tsgo-typecheck.mjs"
+  },
+  "typesVersions": {
+    "*": {
+      "contracts": [
+        "./dist/contracts/index.d.ts"
+      ],
+      "core": [
+        "./dist/core/index.d.ts"
+      ],
+      "rich-text": [
+        "./dist/rich-text/index.d.ts"
+      ]
+    }
   }
 }