@alia.onl/sdk 21.1.0 → 21.2.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @alia.onl/sdk
 
+## 21.2.0
+
+### Added
+
+- **`parseCatalogueTool` and `toolRendererKey` from `@alia.onl/sdk/tools`.** Which app a tool call
+  belongs to (`oxy_<app>__<tool>` / `self_<app>__<tool>`) is now readable without loading React
+  Native, so a host's own pure models and tests — the code that decides what a screen shows —
+  can tell its catalogue's results apart. The main entry exports the same two functions as before.
+
 ## 21.1.0
 
 A shared conversation has one address, Alia's, whichever app minted it (`docs/agent-embedding.md`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alia.onl/sdk",
-  "version": "21.1.0",
+  "version": "21.2.0",
   "description": "Alia AI chat SDK — the conversation runtime, chat UI, voice calls and dictation for Oxy apps",
   "main": "src/index.ts",
   "react-native": "src/index.ts",

package/src/index.ts

@@ -17,7 +17,7 @@ export type { AliaParticipantsHeaderProps } from './components/AliaParticipantsH
 export { ALIA_LEAD, leadOf } from './lib/participants';
 export type { AliaChatParticipants, AliaLead, AliaParticipant } from './lib/participants';
 export { ANCHORS, leadToProfile } from './lib/flights';
-export { parseCatalogueTool, toolRendererKey } from './lib/tool-renderers';
+export { parseCatalogueTool, toolRendererKey } from './lib/catalogue-tool';
 export type { AliaToolRenderers, AliaToolResult } from './lib/tool-renderers';
 export { AliaAskProvider, useAskAgent } from './components/AliaAskProvider';
 export type { AliaAsk, AliaAskAgents, AliaAskProviderProps } from './components/AliaAskProvider';

package/src/lib/catalogue-tool.ts

@@ -0,0 +1,22 @@
+/**
+ * The canonical name of an app's catalogue tool — `oxy_<app>__<tool>` for the person's
+ * account, `self_<app>__<tool>` for the agent's own — read back into its app and tool.
+ *
+ * Pure (no React, no React Native), so a host's own models and tests can tell which
+ * app a tool call belongs to: it is the `@alia.onl/sdk/tools` entry's, and the renderers
+ * (`tool-renderers.tsx`) key on it. The app part is an Oxy app slug; the tool part is
+ * whatever follows the separator. Nothing else names a renderer — never the model's text.
+ */
+const CANONICAL_TOOL = /^(?:oxy|self)_([a-z][a-z0-9-]{0,63})__([A-Za-z0-9_-]+)$/;
+
+/** The app and tool of a canonical catalogue tool name, or `null` for any other name. */
+export function parseCatalogueTool(toolName: string): { app: string; tool: string } | null {
+  const match = CANONICAL_TOOL.exec(toolName);
+  return match ? { app: match[1], tool: match[2] } : null;
+}
+
+/** The renderer key of a tool name (`<app>:<tool>`), or `null` when it is not a catalogue tool. */
+export function toolRendererKey(toolName: string): string | null {
+  const parsed = parseCatalogueTool(toolName);
+  return parsed ? `${parsed.app}:${parsed.tool}` : null;
+}

package/src/lib/tool-renderers.tsx

@@ -22,23 +22,7 @@ export interface AliaToolResult {
  */
 export type AliaToolRenderers = Readonly<Record<string, (result: AliaToolResult) => ReactNode>>;
 
-/**
- * `oxy_<app>__<tool>` or `self_<app>__<tool>`: the only names a renderer is keyed from. The app
- * part is an Oxy app slug; the tool part is whatever follows the separator.
- */
-const CANONICAL_TOOL = /^(?:oxy|self)_([a-z][a-z0-9-]{0,63})__([A-Za-z0-9_-]+)$/;
-
-/** The app and tool of a canonical catalogue tool name, or `null` for any other name. */
-export function parseCatalogueTool(toolName: string): { app: string; tool: string } | null {
-  const match = CANONICAL_TOOL.exec(toolName);
-  return match ? { app: match[1], tool: match[2] } : null;
-}
-
-/** The renderer key of a tool name (`<app>:<tool>`), or `null` when it is not a catalogue tool. */
-export function toolRendererKey(toolName: string): string | null {
-  const parsed = parseCatalogueTool(toolName);
-  return parsed ? `${parsed.app}:${parsed.tool}` : null;
-}
+export { parseCatalogueTool, toolRendererKey } from './catalogue-tool';
 
 const RenderersContext = createContext<AliaToolRenderers>({});
 

package/src/tools.ts

@@ -9,6 +9,7 @@ export {
   normalizeCitationMarkers,
 } from './lib/citations';
 export { domainOf } from './lib/domain';
+export { parseCatalogueTool, toolRendererKey } from './lib/catalogue-tool';
 export type { CitationSource } from './lib/citations';
 export { getToolDoneLabel, getToolPillLabel } from './lib/task-labels';
 export {