@ah-oh/ao-workspaces-robin-client 0.0.1-preview.39

package/README.md

@@ -0,0 +1,21 @@
+# @ah-oh/ao-workspaces-robin-client
+
+Framework-freier Kern für Clients der Robin-BFF (`apps/robin-api`): Wire-Typen,
+ein `fetch`-Client mit Bearer-Token und Idempotency-Key, die Verfolgung eines
+Runs bis zum Endzustand, Fehlertexte ohne technische Codes und das Lesen der
+Antwortteile.
+
+Genutzt von der Robin-App (`apps/robin-mobile`) und für die Typen von der
+Angular-Library `@ah-oh/ao-workspaces-robin`. Spezifikation:
+[`docs/features/robin-app/`](../../docs/features/robin-app/README.md),
+Entscheidung RA-07.
+
+```ts
+import { RobinBffClient, followRun } from '@ah-oh/ao-workspaces-robin-client';
+
+const client = new RobinBffClient({
+  baseUrl: 'https://admin.ah-oh.com/robin-api',
+  getToken: () => token,
+});
+const follower = followRun(runId, { getRun: id => client.getRun(id), onUpdate, onEnd, onError });
+```

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@ah-oh/ao-workspaces-robin-client",
+  "version": "0.0.1-preview.39",
+  "description": "Framework-free client core for the Robin BFF: wire types, fetch client, run follower, error texts.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ah-oh/ao-workspaces.git",
+    "directory": "libs/robin-client"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "sideEffects": false,
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "module": "./src/index.js"
+}

package/src/index.d.ts

@@ -0,0 +1,8 @@
+export * from './lib/types';
+export * from './lib/parts';
+export * from './lib/steps';
+export * from './lib/sessions';
+export * from './lib/confirmation';
+export * from './lib/errors';
+export * from './lib/bff-client';
+export * from './lib/run-follower';

package/src/index.js

@@ -0,0 +1,13 @@
+/*
+ * Public API of @ah-oh/ao-workspaces-robin-client: the framework-free core
+ * shared by the Angular library and the Robin-App (docs/features/robin-app, RA-07).
+ */
+export * from './lib/types';
+export * from './lib/parts';
+export * from './lib/steps';
+export * from './lib/sessions';
+export * from './lib/confirmation';
+export * from './lib/errors';
+export * from './lib/bff-client';
+export * from './lib/run-follower';
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/robin-client/src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}

package/src/lib/bff-client.d.ts

@@ -0,0 +1,70 @@
+import { RobinConfirmation, RobinDeviceRegistration, RobinRunDetail, RobinSendMessageResponse, RobinSession, RobinSessionDetail, RobinSessionListResponse, RobinShortcut, RobinStoredAttachment, RobinSurfaceContext } from './types';
+export interface RobinSendMessageRequest {
+    message: string;
+    context: {
+        surface: RobinSurfaceContext;
+    };
+    capabilityKey?: string;
+    input?: Record<string, unknown>;
+}
+export interface RobinAttachmentUpload {
+    name: string;
+    mimeType: string;
+    dataBase64: string;
+}
+export interface RobinBffClientOptions {
+    /** Address of the BFF including its prefix, e.g. `https://admin.ah-oh.com/robin-api`. */
+    baseUrl: string;
+    /** The user's token; sent as `Authorization: Bearer`. */
+    getToken: () => string | null | Promise<string | null>;
+    /** Sent as `X-Robin-App-Version`; the BFF may answer 426 below its minimum (RA-REQ-082). */
+    appVersion?: string;
+    timeoutMs?: number;
+    fetch?: typeof fetch;
+}
+/**
+ * Client of the Robin BFF on plain `fetch`, for clients without cookies such
+ * as the Robin-App (RA-07). Every call carries the bearer token and omits
+ * cookies, so no cookie can outrank the header (architektur.md, Anmeldung).
+ * Errors are thrown as {@link RobinHttpError}.
+ */
+export declare class RobinBffClient {
+    private readonly options;
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    private readonly fetchFn;
+    constructor(options: RobinBffClientOptions);
+    listSessions(): Promise<RobinSessionListResponse>;
+    getSession(sessionId: string): Promise<RobinSessionDetail>;
+    createSession(title: string | undefined, context: RobinSurfaceContext): Promise<RobinSession>;
+    /** The owner renames or pins a conversation (RS-26). */
+    updateSession(sessionId: string, changes: {
+        title?: string;
+        pinned?: boolean;
+    }): Promise<RobinSession>;
+    /** Removes a conversation from the owner's list; the platform keeps it for audit (RS-26). */
+    archiveSession(sessionId: string): Promise<RobinSession>;
+    /**
+     * Sends a message. A retry with the same `idempotencyKey` never starts a
+     * second run (RS-REQ-063, RA-REQ-023).
+     */
+    sendMessage(sessionId: string, request: RobinSendMessageRequest, idempotencyKey: string): Promise<RobinSendMessageResponse>;
+    getRun(runId: string): Promise<RobinRunDetail>;
+    cancelRun(runId: string): Promise<RobinRunDetail>;
+    listConfirmations(): Promise<RobinConfirmation[]>;
+    confirmDelegation(delegationId: string): Promise<RobinRunDetail>;
+    rejectDelegation(delegationId: string): Promise<RobinRunDetail>;
+    /** Scenarios bound to `app`; without `entityType` the ones bound to the app alone (RA-16). */
+    listShortcuts(app: string, entityType?: string): Promise<RobinShortcut[]>;
+    uploadAttachment(upload: RobinAttachmentUpload): Promise<RobinStoredAttachment>;
+    /** Registers the device's push token for the signed-in user (RA-05). */
+    registerDevice(installationId: string, registration: RobinDeviceRegistration): Promise<{
+        registered: true;
+    }>;
+    unregisterDevice(installationId: string): Promise<{
+        removed: boolean;
+    }>;
+    private request;
+}
+/** A fresh key per message; a retry of the same message reuses it (RA-REQ-023). */
+export declare const createIdempotencyKey: () => string;

package/src/lib/bff-client.js

@@ -0,0 +1,142 @@
+import { RobinHttpError } from './errors';
+/**
+ * Client of the Robin BFF on plain `fetch`, for clients without cookies such
+ * as the Robin-App (RA-07). Every call carries the bearer token and omits
+ * cookies, so no cookie can outrank the header (architektur.md, Anmeldung).
+ * Errors are thrown as {@link RobinHttpError}.
+ */
+export class RobinBffClient {
+    options;
+    baseUrl;
+    timeoutMs;
+    fetchFn;
+    constructor(options) {
+        this.options = options;
+        this.baseUrl = options.baseUrl.replace(/\/+$/, '');
+        this.timeoutMs = options.timeoutMs ?? 20_000;
+        this.fetchFn = options.fetch ?? ((input, init) => fetch(input, init));
+    }
+    listSessions() {
+        return this.request('GET', '/robin/sessions');
+    }
+    getSession(sessionId) {
+        return this.request('GET', `/robin/sessions/${encodeURIComponent(sessionId)}`);
+    }
+    createSession(title, context) {
+        return this.request('POST', '/robin/sessions', { title, context: { surface: context } });
+    }
+    /** The owner renames or pins a conversation (RS-26). */
+    updateSession(sessionId, changes) {
+        return this.request('PATCH', `/robin/sessions/${encodeURIComponent(sessionId)}`, changes);
+    }
+    /** Removes a conversation from the owner's list; the platform keeps it for audit (RS-26). */
+    archiveSession(sessionId) {
+        return this.request('DELETE', `/robin/sessions/${encodeURIComponent(sessionId)}`);
+    }
+    /**
+     * Sends a message. A retry with the same `idempotencyKey` never starts a
+     * second run (RS-REQ-063, RA-REQ-023).
+     */
+    sendMessage(sessionId, request, idempotencyKey) {
+        return this.request('POST', `/robin/sessions/${encodeURIComponent(sessionId)}/messages`, request, {
+            'Idempotency-Key': idempotencyKey,
+        });
+    }
+    getRun(runId) {
+        return this.request('GET', `/robin/runs/${encodeURIComponent(runId)}`);
+    }
+    cancelRun(runId) {
+        return this.request('POST', `/robin/runs/${encodeURIComponent(runId)}/cancel`, {});
+    }
+    listConfirmations() {
+        return this.request('GET', '/robin/confirmations');
+    }
+    confirmDelegation(delegationId) {
+        return this.request('POST', `/robin/delegations/${encodeURIComponent(delegationId)}/confirm`, {});
+    }
+    rejectDelegation(delegationId) {
+        return this.request('POST', `/robin/delegations/${encodeURIComponent(delegationId)}/reject`, {});
+    }
+    /** Scenarios bound to `app`; without `entityType` the ones bound to the app alone (RA-16). */
+    listShortcuts(app, entityType) {
+        const query = new URLSearchParams({ app });
+        if (entityType)
+            query.set('entityType', entityType);
+        return this.request('GET', `/robin/shortcuts?${query.toString()}`);
+    }
+    uploadAttachment(upload) {
+        return this.request('POST', '/robin/attachments', upload);
+    }
+    /** Registers the device's push token for the signed-in user (RA-05). */
+    registerDevice(installationId, registration) {
+        return this.request('PUT', `/robin/devices/${encodeURIComponent(installationId)}`, registration);
+    }
+    unregisterDevice(installationId) {
+        return this.request('DELETE', `/robin/devices/${encodeURIComponent(installationId)}`);
+    }
+    async request(method, path, body, extraHeaders = {}) {
+        const token = await this.options.getToken();
+        const headers = { Accept: 'application/json', ...extraHeaders };
+        if (token)
+            headers['Authorization'] = `Bearer ${token}`;
+        if (this.options.appVersion)
+            headers['X-Robin-App-Version'] = this.options.appVersion;
+        if (body !== undefined)
+            headers['Content-Type'] = 'application/json';
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        let response;
+        try {
+            response = await this.fetchFn(`${this.baseUrl}${path}`, {
+                method,
+                headers,
+                body: body === undefined ? undefined : JSON.stringify(body),
+                credentials: 'omit',
+                signal: controller.signal,
+            });
+        }
+        catch (error) {
+            throw new RobinHttpError(0, error instanceof Error ? error.message : 'Network request failed');
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        const payload = await readBody(response);
+        if (!response.ok) {
+            throw new RobinHttpError(response.status, messageOf(payload) ?? `HTTP ${response.status}`, payload);
+        }
+        return payload;
+    }
+}
+const readBody = async (response) => {
+    const text = await response.text().catch(() => '');
+    if (!text)
+        return undefined;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+};
+const messageOf = (payload) => {
+    if (payload && typeof payload === 'object' && 'message' in payload) {
+        const message = payload.message;
+        if (typeof message === 'string')
+            return message;
+        if (Array.isArray(message))
+            return message.join(', ');
+    }
+    return undefined;
+};
+/** A fresh key per message; a retry of the same message reuses it (RA-REQ-023). */
+export const createIdempotencyKey = () => {
+    const cryptoApi = globalThis.crypto;
+    if (cryptoApi?.randomUUID)
+        return cryptoApi.randomUUID();
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, char => {
+        const random = (Math.random() * 16) | 0;
+        return (char === 'x' ? random : (random & 0x3) | 0x8).toString(16);
+    });
+};
+//# sourceMappingURL=bff-client.js.map

package/src/lib/bff-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bff-client.js","sourceRoot":"","sources":["../../../../../libs/robin-client/src/lib/bff-client.ts"],"names":[],"mappings":"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"}

package/src/lib/confirmation.d.ts

@@ -0,0 +1,25 @@
+import { RobinConfirmation } from './types';
+/** An open confirmation prepared for a card (RA-REQ-040, RA-REQ-041): names, never raw keys. */
+export interface RobinConfirmationView {
+    delegationId: string;
+    /** What Robin wants to do, by the capability's name. */
+    action: string;
+    /** The record the call changes, by name. */
+    record?: string;
+    /** The change in one sentence, in Robin's words. */
+    change?: string;
+    risk: 'LOW' | 'MEDIUM' | 'HIGH';
+    riskLabel: string;
+    effects: string[];
+    /** Input with readable labels; technical ids and the context stay hidden. */
+    inputs: {
+        key: string;
+        label: string;
+        value: string;
+    }[];
+    /** Roles that may decide, by name. */
+    roles: string[];
+    /** `false` when the caller lacks the role; the card then names who can decide (RA-REQ-041). */
+    canDecide: boolean;
+}
+export declare const describeConfirmation: (confirmation: RobinConfirmation) => RobinConfirmationView;

package/src/lib/confirmation.js

@@ -0,0 +1,65 @@
+const ROLE_LABELS = {
+    'super-admin': 'Super-Admin',
+    'company-admin': 'Admin',
+    owner: 'Inhaber',
+    admin: 'Admin',
+    user: 'Nutzer',
+};
+const MAX_INPUTS = 12;
+const MAX_VALUE = 160;
+export const describeConfirmation = (confirmation) => {
+    const summary = confirmation.inputSummary;
+    const policy = confirmation.policySnapshot;
+    const { input = {}, labels = {}, hidden = [] } = summary;
+    const roleKeys = confirmation.requiredRoles ?? policy.confirmationRoles ?? [];
+    return {
+        delegationId: confirmation.delegationId,
+        action: summary.capabilityName ?? summary.capabilityKey ?? 'Aktion',
+        record: summary.record?.label || undefined,
+        change: summary.change?.trim() || undefined,
+        risk: confirmation.riskLevel,
+        riskLabel: riskLabel(confirmation.riskLevel),
+        effects: [
+            policy.writes ? 'ändert Daten' : null,
+            policy.external ? 'extern' : null,
+            policy.customerVisible ? 'für Kunden sichtbar' : null,
+            policy.destructive ? 'löscht Daten' : null,
+            policy.securitySensitive ? 'sicherheitsrelevant' : null,
+            policy.publishing ? 'veröffentlicht' : null,
+            policy.reversible === false ? 'nicht umkehrbar' : null,
+        ].filter((flag) => Boolean(flag)),
+        inputs: Object.entries(input)
+            .filter(([key]) => key !== 'context' && !hidden.includes(key))
+            .slice(0, MAX_INPUTS)
+            .map(([key, value]) => ({ key, label: labels[key] ?? key, value: formatValue(value) })),
+        // The platform's service account is nobody the user can ask.
+        roles: [
+            ...new Set(roleKeys.filter(role => role !== 'service').map(role => ROLE_LABELS[role] ?? role)),
+        ],
+        canDecide: confirmation.canDecide !== false,
+    };
+};
+const riskLabel = (risk) => {
+    switch (risk) {
+        case 'HIGH':
+            return 'Hohes Risiko';
+        case 'MEDIUM':
+            return 'Mittleres Risiko';
+        default:
+            return 'Geringes Risiko';
+    }
+};
+const formatValue = (value) => {
+    if (value === null || value === undefined)
+        return '–';
+    if (typeof value === 'string')
+        return value.length > MAX_VALUE ? `${value.slice(0, MAX_VALUE)}…` : value;
+    if (typeof value === 'boolean')
+        return value ? 'ja' : 'nein';
+    if (typeof value === 'number')
+        return String(value);
+    if (Array.isArray(value))
+        return value.length === 1 ? '1 Eintrag' : `${value.length} Einträge`;
+    return JSON.stringify(value).slice(0, MAX_VALUE);
+};
+//# sourceMappingURL=confirmation.js.map

package/src/lib/confirmation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmation.js","sourceRoot":"","sources":["../../../../../libs/robin-client/src/lib/confirmation.ts"],"names":[],"mappings":"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"}

package/src/lib/errors.d.ts

@@ -0,0 +1,27 @@
+import { RobinRunDetail } from './types';
+/**
+ * A failed call to the BFF. `status` 0 means the BFF was not reached at all
+ * (no network, timeout); `body` is the parsed JSON answer, if any.
+ */
+export declare class RobinHttpError extends Error {
+    readonly status: number;
+    readonly body?: unknown | undefined;
+    constructor(status: number, message: string, body?: unknown | undefined);
+}
+export type RobinErrorKind = 'offline' | 'unauthorized' | 'forbidden' | 'busy' | 'rate_limited' | 'quota_exhausted' | 'upgrade_required' | 'too_large' | 'unknown';
+/** What the user reads: never a technical code, always what to do instead (RA-REQ-030). */
+export interface RobinErrorDescription {
+    kind: RobinErrorKind;
+    message: string;
+}
+/** Code of the credits feature for an empty company account (Credits CR-REQ-025). */
+export declare const CREDITS_EXHAUSTED = "CREDITS_EXHAUSTED";
+/**
+ * Without purchases in the app, the message names the company's administrator
+ * and links nowhere (RA-11, RA-REQ-081).
+ */
+export declare const QUOTA_EXHAUSTED_MESSAGE = "KI-Aktionen stehen zurzeit nicht zur Verf\u00FCgung: Das Kontingent deiner Company ist aufgebraucht. Der Administrator deiner Company kann es erh\u00F6hen.";
+/** Maps transport and platform errors to what the user can do (RA-REQ-030, RS-REQ-084). */
+export declare const describeRobinError: (error: unknown) => RobinErrorDescription;
+/** Why a run ended without an answer, readable and without codes. */
+export declare const describeRunFailure: (run: Pick<RobinRunDetail, "errorMessage">) => string;

package/src/lib/errors.js

@@ -0,0 +1,83 @@
+import { readableRunError } from './steps';
+/**
+ * A failed call to the BFF. `status` 0 means the BFF was not reached at all
+ * (no network, timeout); `body` is the parsed JSON answer, if any.
+ */
+export class RobinHttpError extends Error {
+    status;
+    body;
+    constructor(status, message, body) {
+        super(message);
+        this.status = status;
+        this.body = body;
+        this.name = 'RobinHttpError';
+    }
+}
+/** Code of the credits feature for an empty company account (Credits CR-REQ-025). */
+export const CREDITS_EXHAUSTED = 'CREDITS_EXHAUSTED';
+/**
+ * Without purchases in the app, the message names the company's administrator
+ * and links nowhere (RA-11, RA-REQ-081).
+ */
+export const QUOTA_EXHAUSTED_MESSAGE = 'KI-Aktionen stehen zurzeit nicht zur Verfügung: Das Kontingent deiner Company ist aufgebraucht. Der Administrator deiner Company kann es erhöhen.';
+const MESSAGES = {
+    offline: 'Robin ist gerade nicht erreichbar. Deine Eingabe bleibt stehen; sende sie erneut, sobald du wieder Netz hast.',
+    unauthorized: 'Deine Anmeldung ist abgelaufen. Melde dich neu an; deine Eingabe bleibt erhalten.',
+    busy: 'Robin arbeitet noch an der letzten Aufgabe. Warte, bis sie fertig ist, oder brich sie ab.',
+    rate_limited: 'Gerade kommen zu viele Anfragen an. Versuche es in einer Minute noch einmal.',
+    upgrade_required: 'Diese Version der Robin-App wird nicht mehr unterstützt. Aktualisiere die App im App Store oder bei Google Play.',
+    too_large: 'Die Datei ist zu groß. Wähle eine kleinere Datei oder ein Foto.',
+};
+/** Maps transport and platform errors to what the user can do (RA-REQ-030, RS-REQ-084). */
+export const describeRobinError = (error) => {
+    if (!(error instanceof RobinHttpError)) {
+        return { kind: 'unknown', message: 'Etwas ist schiefgegangen. Versuche es noch einmal.' };
+    }
+    const detail = detailOf(error.body);
+    if (detail.includes(CREDITS_EXHAUSTED) || error.status === 402) {
+        return { kind: 'quota_exhausted', message: QUOTA_EXHAUSTED_MESSAGE };
+    }
+    switch (error.status) {
+        case 0:
+        case 502:
+        case 503:
+        case 504:
+            return { kind: 'offline', message: MESSAGES.offline };
+        case 401:
+            return { kind: 'unauthorized', message: MESSAGES.unauthorized };
+        case 403:
+            return {
+                kind: 'forbidden',
+                message: 'Dafür fehlt dir die Berechtigung. Wende dich an den Administrator deiner Company.',
+            };
+        case 409:
+            return { kind: 'busy', message: MESSAGES.busy };
+        case 413:
+            return { kind: 'too_large', message: MESSAGES.too_large };
+        case 426:
+            return { kind: 'upgrade_required', message: MESSAGES.upgrade_required };
+        case 429:
+            return { kind: 'rate_limited', message: MESSAGES.rate_limited };
+        default:
+            return {
+                kind: 'unknown',
+                message: 'Robin konnte die Anfrage nicht ausführen. Versuche es noch einmal.',
+            };
+    }
+};
+/** Why a run ended without an answer, readable and without codes. */
+export const describeRunFailure = (run) => {
+    const message = run.errorMessage ?? '';
+    if (message.includes(CREDITS_EXHAUSTED))
+        return QUOTA_EXHAUSTED_MESSAGE;
+    return `Die Aufgabe konnte nicht abgeschlossen werden: ${readableRunError(message)}`;
+};
+const detailOf = (body) => {
+    if (!body || typeof body !== 'object')
+        return typeof body === 'string' ? body : '';
+    const record = body;
+    return [record['code'], record['error'], record['message']]
+        .map(value => (Array.isArray(value) ? value.join(' ') : typeof value === 'string' ? value : ''))
+        .join(' ');
+};
+//# sourceMappingURL=errors.js.map

package/src/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../../libs/robin-client/src/lib/errors.ts"],"names":[],"mappings":"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"}

package/src/lib/parts.d.ts

@@ -0,0 +1,19 @@
+import { RobinMessagePart, RobinPlatformMessage, RobinTextPart } from './types';
+/** Reads `content.parts` of a platform message; anything unknown becomes text (RS-REQ-020). */
+export declare const toMessageParts: (message: Pick<RobinPlatformMessage, "contentText" | "content">) => RobinMessagePart[];
+/**
+ * Parts for a client without page context (the Robin-App): proposals, actions
+ * and summaries need a page, so they are shown as text instead of being
+ * dropped (RA-REQ-025).
+ */
+export declare const toTextParts: (parts: readonly RobinMessagePart[]) => RobinTextPart[];
+/** A message of a conversation as a chat shows it. */
+export interface RobinChatMessage {
+    id: string;
+    role: 'user' | 'assistant';
+    parts: RobinMessagePart[];
+    createdAt: string;
+    runId?: string;
+}
+/** User and assistant messages of a conversation in their order; tool and system messages stay hidden. */
+export declare const toChatMessages: (messages: readonly RobinPlatformMessage[]) => RobinChatMessage[];

package/src/lib/parts.js

@@ -0,0 +1,110 @@
+/** Reads `content.parts` of a platform message; anything unknown becomes text (RS-REQ-020). */
+export const toMessageParts = (message) => {
+    const content = message.content;
+    const rawParts = content && typeof content === 'object' && Array.isArray(content.parts)
+        ? content.parts
+        : null;
+    if (!rawParts) {
+        const text = message.contentText?.trim();
+        return text ? [{ kind: 'text', markdown: text }] : [];
+    }
+    const parts = [];
+    for (const raw of rawParts) {
+        const part = normalizePart(raw);
+        if (part)
+            parts.push(part);
+    }
+    if (parts.length === 0 && message.contentText?.trim()) {
+        parts.push({ kind: 'text', markdown: message.contentText.trim() });
+    }
+    return parts;
+};
+const normalizePart = (raw) => {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const part = raw;
+    switch (part['kind']) {
+        case 'text':
+            return typeof part['markdown'] === 'string' && part['markdown'].trim()
+                ? { kind: 'text', markdown: part['markdown'] }
+                : null;
+        case 'proposal': {
+            const changes = Array.isArray(part['changes'])
+                ? part['changes'].filter((change) => !!change &&
+                    typeof change === 'object' &&
+                    typeof change.fieldId === 'string' &&
+                    typeof change.after === 'string')
+                : [];
+            if (changes.length === 0)
+                return null;
+            return {
+                kind: 'proposal',
+                title: typeof part['title'] === 'string' ? part['title'] : undefined,
+                rationale: typeof part['rationale'] === 'string' ? part['rationale'] : undefined,
+                changes: changes.map(change => ({
+                    fieldId: change.fieldId,
+                    before: typeof change.before === 'string' ? change.before : '',
+                    after: change.after,
+                })),
+            };
+        }
+        case 'action':
+            return typeof part['actionId'] === 'string'
+                ? {
+                    kind: 'action',
+                    actionId: part['actionId'],
+                    label: typeof part['label'] === 'string' ? part['label'] : part['actionId'],
+                    reason: typeof part['reason'] === 'string' ? part['reason'] : undefined,
+                }
+                : null;
+        case 'summary':
+            return typeof part['text'] === 'string'
+                ? {
+                    kind: 'summary',
+                    text: part['text'],
+                    sources: Array.isArray(part['sources'])
+                        ? part['sources']
+                        : [],
+                }
+                : null;
+        default:
+            return { kind: 'text', markdown: '```json\n' + JSON.stringify(raw, null, 2) + '\n```' };
+    }
+};
+/**
+ * Parts for a client without page context (the Robin-App): proposals, actions
+ * and summaries need a page, so they are shown as text instead of being
+ * dropped (RA-REQ-025).
+ */
+export const toTextParts = (parts) => parts.map((part) => {
+    switch (part.kind) {
+        case 'text':
+            return part;
+        case 'summary':
+            return { kind: 'text', markdown: part.text };
+        case 'action':
+            return {
+                kind: 'text',
+                markdown: part.reason ? `**${part.label}**\n\n${part.reason}` : `**${part.label}**`,
+            };
+        case 'proposal': {
+            const lines = part.changes.map(change => change.before
+                ? `- ${change.fieldId}: ${change.before} → ${change.after}`
+                : `- ${change.fieldId}: ${change.after}`);
+            const heading = part.title ? `**${part.title}**\n\n` : '';
+            const rationale = part.rationale ? `${part.rationale}\n\n` : '';
+            return { kind: 'text', markdown: `${heading}${rationale}${lines.join('\n')}` };
+        }
+    }
+});
+/** User and assistant messages of a conversation in their order; tool and system messages stay hidden. */
+export const toChatMessages = (messages) => messages
+    .filter(message => message.role === 'USER' || message.role === 'ASSISTANT')
+    .map(message => ({
+    id: message.id,
+    role: message.role === 'USER' ? 'user' : 'assistant',
+    parts: toMessageParts(message),
+    createdAt: message.createdAt,
+    runId: message.runId ?? undefined,
+}));
+//# sourceMappingURL=parts.js.map

package/src/lib/parts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts.js","sourceRoot":"","sources":["../../../../../libs/robin-client/src/lib/parts.ts"],"names":[],"mappings":"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"}

package/src/lib/run-follower.d.ts

@@ -0,0 +1,25 @@
+import { RobinRunDetail } from './types';
+export interface RunFollowerOptions {
+    getRun: (runId: string) => Promise<RobinRunDetail>;
+    /** Every fresh state of the run, including the last one. */
+    onUpdate: (run: RobinRunDetail) => void;
+    /** The run reached `SUCCESS`, `FAILED` or `CANCELLED`; polling has stopped. */
+    onEnd: (run: RobinRunDetail) => void;
+    /** A poll failed. `final` is true when the follower gave up. */
+    onError: (error: unknown, final: boolean) => void;
+    /** Interval between polls; 2 seconds in the app (architektur.md, Chat). */
+    intervalMs?: number;
+    /** Offline errors in a row before giving up; other errors end at once. */
+    maxOfflineRetries?: number;
+}
+export interface RunFollower {
+    readonly runId: string;
+    stop(): void;
+    readonly stopped: boolean;
+}
+/**
+ * Polls a run until it ends (RS-REQ-030, RA-REQ-024). The caller stops it
+ * when the app leaves the foreground; the notification takes over there
+ * (architektur.md, Chat step 4).
+ */
+export declare const followRun: (runId: string, options: RunFollowerOptions) => RunFollower;

package/src/lib/run-follower.js

@@ -0,0 +1,64 @@
+import { describeRobinError } from './errors';
+import { isTerminalRunStatus } from './types';
+/**
+ * Polls a run until it ends (RS-REQ-030, RA-REQ-024). The caller stops it
+ * when the app leaves the foreground; the notification takes over there
+ * (architektur.md, Chat step 4).
+ */
+export const followRun = (runId, options) => {
+    const intervalMs = options.intervalMs ?? 2_000;
+    const maxOfflineRetries = options.maxOfflineRetries ?? 5;
+    let timer = null;
+    let stopped = false;
+    let offlineErrors = 0;
+    const stop = () => {
+        stopped = true;
+        if (timer)
+            clearTimeout(timer);
+        timer = null;
+    };
+    const schedule = () => {
+        if (!stopped)
+            timer = setTimeout(() => void poll(), intervalMs);
+    };
+    const poll = async () => {
+        if (stopped)
+            return;
+        let run;
+        try {
+            run = await options.getRun(runId);
+        }
+        catch (error) {
+            if (stopped)
+                return;
+            const offline = describeRobinError(error).kind === 'offline';
+            offlineErrors = offline ? offlineErrors + 1 : Number.POSITIVE_INFINITY;
+            const final = offlineErrors > maxOfflineRetries;
+            options.onError(error, final);
+            if (final)
+                stop();
+            else
+                schedule();
+            return;
+        }
+        if (stopped)
+            return;
+        offlineErrors = 0;
+        options.onUpdate(run);
+        if (isTerminalRunStatus(run.status)) {
+            stop();
+            options.onEnd(run);
+            return;
+        }
+        schedule();
+    };
+    void poll();
+    return {
+        runId,
+        stop,
+        get stopped() {
+            return stopped;
+        },
+    };
+};
+//# sourceMappingURL=run-follower.js.map

package/src/lib/run-follower.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-follower.js","sourceRoot":"","sources":["../../../../../libs/robin-client/src/lib/run-follower.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAkB,MAAM,SAAS,CAAC;AAsB9D;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAa,EAAE,OAA2B,EAAe,EAAE;IACnF,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC;IAC/C,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,CAAC,CAAC;IACzD,IAAI,KAAK,GAAyC,IAAI,CAAC;IACvD,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,aAAa,GAAG,CAAC,CAAC;IAEtB,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,OAAO,GAAG,IAAI,CAAC;QACf,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,GAAG,IAAI,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,IAAI,CAAC,OAAO;YAAE,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,EAAE,UAAU,CAAC,CAAC;IAClE,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;QACrC,IAAI,OAAO;YAAE,OAAO;QACpB,IAAI,GAAmB,CAAC;QACxB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO;gBAAE,OAAO;YACpB,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC;YAC7D,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;YACvE,MAAM,KAAK,GAAG,aAAa,GAAG,iBAAiB,CAAC;YAChD,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC9B,IAAI,KAAK;gBAAE,IAAI,EAAE,CAAC;;gBACb,QAAQ,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QACD,IAAI,OAAO;YAAE,OAAO;QACpB,aAAa,GAAG,CAAC,CAAC;QAClB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,IAAI,EAAE,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QACD,QAAQ,EAAE,CAAC;IACb,CAAC,CAAC;IAEF,KAAK,IAAI,EAAE,CAAC;IACZ,OAAO;QACL,KAAK;QACL,IAAI;QACJ,IAAI,OAAO;YACT,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/src/lib/sessions.d.ts

@@ -0,0 +1,11 @@
+import { RobinConfirmation, RobinSession } from './types';
+/** First line of a message, cut at a word near {@link MAX_SESSION_TITLE} characters (RS-REQ-097, RA-REQ-022). */
+export declare const sessionTitleOf: (message: string) => string;
+/** Name of a conversation in a list; a conversation without title is still recognisable. */
+export declare const sessionLabel: (session: Pick<RobinSession, "title">) => string;
+/** Pinned conversations first (last pinned on top), the rest by last activity (RA-REQ-020). */
+export declare const sortSessions: <T extends RobinSession>(sessions: readonly T[]) => T[];
+/** Search by title, case- and accent-insensitive (RA-REQ-020). */
+export declare const filterSessions: <T extends RobinSession>(sessions: readonly T[], query: string) => T[];
+/** Conversations with an open confirmation, to flag them in the list (RA-REQ-042). */
+export declare const sessionsWaitingForConfirmation: (confirmations: readonly RobinConfirmation[]) => Set<string>;

package/src/lib/sessions.js

@@ -0,0 +1,40 @@
+const MAX_SESSION_TITLE = 60;
+/** First line of a message, cut at a word near {@link MAX_SESSION_TITLE} characters (RS-REQ-097, RA-REQ-022). */
+export const sessionTitleOf = (message) => {
+    const line = message.trim().split('\n')[0]?.trim() ?? '';
+    if (line.length <= MAX_SESSION_TITLE)
+        return line;
+    const cut = line.slice(0, MAX_SESSION_TITLE);
+    const space = cut.lastIndexOf(' ');
+    return `${(space > MAX_SESSION_TITLE / 2 ? cut.slice(0, space) : cut).replace(/\s+$/, '')} …`;
+};
+/** Name of a conversation in a list; a conversation without title is still recognisable. */
+export const sessionLabel = (session) => session.title?.trim() || 'Neue Unterhaltung';
+/** Pinned conversations first (last pinned on top), the rest by last activity (RA-REQ-020). */
+export const sortSessions = (sessions) => {
+    const activity = (session) => session.lastMessageAt ?? session.createdAt;
+    const pinned = sessions
+        .filter(session => session.pinnedAt)
+        .sort((a, b) => String(b.pinnedAt).localeCompare(String(a.pinnedAt)));
+    const rest = sessions
+        .filter(session => !session.pinnedAt)
+        .sort((a, b) => activity(b).localeCompare(activity(a)));
+    return [...pinned, ...rest];
+};
+/** Search by title, case- and accent-insensitive (RA-REQ-020). */
+export const filterSessions = (sessions, query) => {
+    const wanted = normalize(query);
+    if (!wanted)
+        return [...sessions];
+    return sessions.filter(session => normalize(sessionLabel(session)).includes(wanted));
+};
+/** Conversations with an open confirmation, to flag them in the list (RA-REQ-042). */
+export const sessionsWaitingForConfirmation = (confirmations) => new Set(confirmations
+    .filter(confirmation => confirmation.status === 'PENDING' && confirmation.sessionId)
+    .map(confirmation => confirmation.sessionId));
+const normalize = (value) => value
+    .normalize('NFD')
+    .replace(/[\u0300-\u036f]/g, '')
+    .toLowerCase()
+    .trim();
+//# sourceMappingURL=sessions.js.map

package/src/lib/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../../../../libs/robin-client/src/lib/sessions.ts"],"names":[],"mappings":"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"}

package/src/lib/steps.d.ts

@@ -0,0 +1,8 @@
+import { RobinRunDetail, RobinRunStep, RobinShortcut } from './types';
+/**
+ * A failed step reads `CODE: message (details)` (tool errors); the user gets
+ * the message only (RS-REQ-084).
+ */
+export declare const readableRunError: (message: string | null | undefined) => string;
+/** Progress of the run for the panel (RS-REQ-030) from its events and delegations. */
+export declare const deriveSteps: (run: RobinRunDetail | null, shortcuts: readonly RobinShortcut[]) => RobinRunStep[];

package/src/lib/steps.js

@@ -0,0 +1,99 @@
+/**
+ * A failed step reads `CODE: message (details)` (tool errors); the user gets
+ * the message only (RS-REQ-084).
+ */
+export const readableRunError = (message) => {
+    const text = (message ?? '').trim();
+    if (!text)
+        return 'unbekannter Fehler';
+    const readable = text
+        .replace(/^(?:[A-Z][A-Z0-9_]{2,}:\s+)+/, '')
+        .replace(/\s+\((?:\{.*\}|\[.*\])\)$/s, '')
+        .trim();
+    return readable || text;
+};
+/** Progress of the run for the panel (RS-REQ-030) from its events and delegations. */
+export const deriveSteps = (run, shortcuts) => {
+    if (!run)
+        return [];
+    const names = new Map();
+    for (const shortcut of shortcuts) {
+        for (const step of shortcut.steps)
+            names.set(step.capabilityKey, step.name);
+    }
+    const steps = new Map();
+    const delegationKeys = new Map();
+    for (const event of run.events) {
+        const payload = event.payload ?? {};
+        const key = typeof payload['capabilityKey'] === 'string' ? payload['capabilityKey'] : undefined;
+        const delegationId = typeof payload['delegationId'] === 'string' ? payload['delegationId'] : undefined;
+        const name = typeof payload['capabilityName'] === 'string' ? payload['capabilityName'] : undefined;
+        if (key && name && !names.has(key))
+            names.set(key, name);
+        switch (event.type) {
+            case 'capability_selected':
+                if (key && delegationId)
+                    delegationKeys.set(delegationId, key);
+                if (key && !steps.has(key)) {
+                    steps.set(key, { key, label: names.get(key) ?? prettify(key), state: 'planned' });
+                }
+                break;
+            case 'confirmation_required':
+                if (key) {
+                    if (delegationId)
+                        delegationKeys.set(delegationId, key);
+                    setState(steps, key, 'waiting_confirmation', names);
+                }
+                break;
+            case 'delegation_started': {
+                const stepKey = key ??
+                    (delegationId ? delegationKeys.get(delegationId) : undefined) ??
+                    lastPlanned(steps);
+                if (stepKey) {
+                    if (delegationId)
+                        delegationKeys.set(delegationId, stepKey);
+                    setState(steps, stepKey, 'running', names);
+                }
+                break;
+            }
+            case 'child_completed': {
+                const stepKey = delegationId ? delegationKeys.get(delegationId) : undefined;
+                if (stepKey)
+                    setState(steps, stepKey, 'done', names);
+                break;
+            }
+            case 'run_failed':
+                for (const step of steps.values()) {
+                    if (step.state === 'running' || step.state === 'waiting_confirmation')
+                        step.state = 'failed';
+                }
+                break;
+            default:
+                break;
+        }
+    }
+    return [...steps.values()];
+};
+const setState = (steps, key, state, names) => {
+    const step = steps.get(key);
+    if (step) {
+        step.state = state;
+    }
+    else {
+        steps.set(key, { key, label: names.get(key) ?? prettify(key), state });
+    }
+};
+const lastPlanned = (steps) => {
+    let candidate;
+    for (const step of steps.values()) {
+        if (step.state === 'planned')
+            candidate = step.key;
+    }
+    return candidate;
+};
+const prettify = (key) => key
+    .split(/[._-]+/)
+    .filter(Boolean)
+    .map(part => part.charAt(0).toUpperCase() + part.slice(1))
+    .join(' ');
+//# sourceMappingURL=steps.js.map

package/src/lib/steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.js","sourceRoot":"","sources":["../../../../../libs/robin-client/src/lib/steps.ts"],"names":[],"mappings":"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"}

package/src/lib/types.d.ts

@@ -0,0 +1,272 @@
+/**
+ * Wire types of the Robin BFF (`apps/robin-api`) shared by the Angular library
+ * `libs/robin` and the Robin-App `apps/robin-mobile` (docs/features/robin-app,
+ * RA-07). They mirror the shared types of the AI platform
+ * (`@ai/shared/types`, `agents-robin*.types.ts`); the platform is the source
+ * of truth, the BFF passes the shapes through unchanged.
+ */
+export type RobinSurfaceFieldType = 'text' | 'multiline' | 'number' | 'select' | 'date';
+/** How the library shows a field value in previews and cards; never sent to Robin. */
+export type RobinFieldFormat = 'text' | 'html';
+export interface RobinSurfaceEntity {
+    type: string;
+    id: string;
+    label: string;
+    version?: string;
+}
+export interface RobinSurfaceFocus {
+    kind: 'field' | 'section';
+    id: string;
+}
+/** A value a `select` field accepts and the name shown for it in previews and cards. */
+export interface RobinFieldOption {
+    value: string;
+    label?: string;
+}
+export interface RobinSurfaceField {
+    id: string;
+    label: string;
+    type?: RobinSurfaceFieldType;
+    value?: string;
+    sectionId?: string;
+    /** Allowed values of a `select` field with the names the user sees (RS-23). */
+    options?: RobinFieldOption[];
+    /** Several options at once, as a comma-separated list of values (RS-23). */
+    multiple?: boolean;
+    /** What Robin should know about the field (format, limits); never shown. */
+    hint?: string;
+}
+export interface RobinSurfaceSection {
+    id: string;
+    type: string;
+    label: string;
+}
+export interface RobinActionEffect {
+    writes?: boolean;
+    external?: boolean;
+    customerVisible?: boolean;
+    destructive?: boolean;
+    securitySensitive?: boolean;
+    publishing?: boolean;
+    reversible?: boolean;
+}
+export interface RobinSurfaceAction {
+    id: string;
+    label: string;
+    effect?: RobinActionEffect;
+}
+export interface RobinSurfaceAttachment {
+    id: string;
+    name: string;
+    mimeType: string;
+    url: string;
+}
+export interface RobinSurfaceContext {
+    app: string;
+    route?: string;
+    capabilityKeys?: string[];
+    scenarioKey?: string;
+    entity?: RobinSurfaceEntity;
+    focus?: RobinSurfaceFocus;
+    fields?: RobinSurfaceField[];
+    sections?: RobinSurfaceSection[];
+    actions?: RobinSurfaceAction[];
+    attachments?: RobinSurfaceAttachment[];
+}
+/** A quick action on a field: calls `capabilityKey` directly with an instruction (RS-14). */
+export interface RobinQuickAction {
+    id: string;
+    label: string;
+    instruction: string;
+    capabilityKey?: string;
+}
+export interface RobinProposalChange {
+    fieldId: string;
+    before: string;
+    after: string;
+}
+export interface RobinSummarySource {
+    delegationId: string;
+    capabilityKey: string;
+    label: string;
+}
+export interface RobinTextPart {
+    kind: 'text';
+    markdown: string;
+}
+export interface RobinProposalPart {
+    kind: 'proposal';
+    title?: string;
+    rationale?: string;
+    changes: RobinProposalChange[];
+}
+export interface RobinActionPart {
+    kind: 'action';
+    actionId: string;
+    label: string;
+    reason?: string;
+}
+export interface RobinSummaryPart {
+    kind: 'summary';
+    text: string;
+    sources: RobinSummarySource[];
+}
+export type RobinMessagePart = RobinTextPart | RobinProposalPart | RobinActionPart | RobinSummaryPart;
+export type RobinRunStatus = 'QUEUED' | 'RUNNING' | 'WAITING_FOR_CHILD' | 'WAITING_FOR_CONFIRMATION' | 'NEEDS_INPUT' | 'RESUMING' | 'SUCCESS' | 'FAILED' | 'CANCELLED';
+export declare const TERMINAL_RUN_STATUSES: readonly RobinRunStatus[];
+export declare const isTerminalRunStatus: (status: RobinRunStatus | string) => boolean;
+export interface RobinRunEvent {
+    id: string;
+    seq: number;
+    type: string;
+    payload?: Record<string, unknown> | null;
+    createdAt: string;
+}
+export interface RobinDelegation {
+    id: string;
+    status: string;
+    capabilityId?: string | null;
+    riskLevel?: string | null;
+    errorMessage?: string | null;
+    /** Effective policy of the delegated capability; `writes` marks a data change. */
+    effectPolicy?: RobinActionEffect | null;
+}
+/** A finished run changed data of the entity it was started on (host apps reload). */
+export interface RobinEntityDataChange {
+    runId: string;
+    entity: RobinSurfaceEntity;
+    /** Ids of the successful delegations with a writing effect. */
+    delegationIds: string[];
+}
+export interface RobinPlatformMessage {
+    id: string;
+    role: 'USER' | 'ASSISTANT' | 'TOOL' | 'SYSTEM';
+    contentText?: string | null;
+    content?: unknown;
+    runId?: string | null;
+    createdAt: string;
+}
+export interface RobinRunDetail {
+    id: string;
+    status: RobinRunStatus;
+    errorMessage?: string | null;
+    /** What the run was started with; the surface snapshot names its entity. */
+    input?: {
+        context?: {
+            surface?: RobinSurfaceContext;
+        };
+    } | null;
+    messages: RobinPlatformMessage[];
+    events: RobinRunEvent[];
+    delegations: RobinDelegation[];
+}
+export interface RobinSession {
+    id: string;
+    title?: string | null;
+    lastMessageAt?: string | null;
+    /** Pinned by its owner in the chat list (RS-26). */
+    pinnedAt?: string | null;
+    createdAt: string;
+}
+export interface RobinSessionListResponse {
+    items: RobinSession[];
+    total: number;
+}
+export interface RobinSessionDetail extends RobinSession {
+    messages: RobinPlatformMessage[];
+    latestRun: RobinRunDetail | null;
+}
+export interface RobinSendMessageResponse {
+    sessionId: string;
+    messageId: string;
+    runId: string;
+    status: RobinRunStatus;
+    message: string;
+}
+export interface RobinConfirmationPolicy extends RobinActionEffect {
+    confirmationRoles?: string[];
+}
+/**
+ * The record a confirmed call changes: the open page's entity when the input
+ * names it, else Robin's description; `matchesPage: false` when the call is
+ * about another record than the open page (`page`).
+ */
+export interface RobinConfirmationRecord {
+    label?: string;
+    page?: string;
+    matchesPage?: boolean;
+}
+export interface RobinConfirmation {
+    id: string;
+    delegationId: string;
+    robinRunId: string;
+    capabilityId?: string | null;
+    status: 'PENDING' | 'CONFIRMED' | 'REJECTED' | 'CANCELLED';
+    riskLevel: 'LOW' | 'MEDIUM' | 'HIGH';
+    policySnapshot: RobinConfirmationPolicy;
+    inputSummary: {
+        capabilityKey?: string;
+        capabilityName?: string;
+        input?: Record<string, unknown>;
+        /** Readable label per input key, from the capability's input schema. */
+        labels?: Record<string, string>;
+        /** Input keys with technical ids the person cannot check; not shown. */
+        hidden?: string[];
+        /** The record the call changes (RS-25). */
+        record?: RobinConfirmationRecord;
+        /** What the call changes, in Robin's words with names and values ("Neue Position: 2 × 1014 Test"). */
+        change?: string;
+    };
+    /** Roles that may decide, from the policy; filled by the platform's list of open confirmations. */
+    requiredRoles?: string[];
+    /** Whether the caller holds one of {@link requiredRoles} (RA-REQ-041). */
+    canDecide?: boolean;
+    /** Conversation of the run, so a chat list can flag waiting conversations (RA-REQ-042). */
+    sessionId?: string | null;
+    createdAt: string;
+}
+export interface RobinShortcutStep {
+    capabilityKey: string;
+    name: string;
+    requiresConfirmation: boolean;
+}
+export interface RobinShortcut {
+    key: string;
+    name: string;
+    description: string;
+    goal: string;
+    steps: RobinShortcutStep[];
+    confirmations: number;
+}
+export interface RobinStoredAttachment extends RobinSurfaceAttachment {
+    size: number;
+    expiresAt: string;
+}
+/** One subagent step of a run as the chat shows it, by name (RS-REQ-030, RA-REQ-024). */
+export interface RobinRunStep {
+    key: string;
+    label: string;
+    state: 'planned' | 'running' | 'waiting_confirmation' | 'done' | 'failed';
+}
+/** Body of `PUT /robin/devices/:installationId` (RA-05). */
+export interface RobinDeviceRegistration {
+    /** Expo push token, `ExponentPushToken[…]`. */
+    pushToken: string;
+    platform: 'ios' | 'android';
+    appVersion: string;
+}
+/** Statuses of a run the platform announces as `robin.run.status` (RA-05). */
+export type RobinNotifiedRunStatus = Extract<RobinRunStatus, 'SUCCESS' | 'FAILED' | 'WAITING_FOR_CONFIRMATION'>;
+/** Data a Robin notification carries (RA-06); never the answer or confirmation values. */
+export interface RobinPushData {
+    sessionId: string;
+    runId: string;
+    status: RobinNotifiedRunStatus;
+    url: string;
+}
+/** Body of a `426` answer: the app version is below the BFF's minimum (RA-REQ-082). */
+export interface RobinUpgradeRequired {
+    statusCode: 426;
+    message: string;
+    minVersion: string;
+}

package/src/lib/types.js

@@ -0,0 +1,10 @@
+/**
+ * Wire types of the Robin BFF (`apps/robin-api`) shared by the Angular library
+ * `libs/robin` and the Robin-App `apps/robin-mobile` (docs/features/robin-app,
+ * RA-07). They mirror the shared types of the AI platform
+ * (`@ai/shared/types`, `agents-robin*.types.ts`); the platform is the source
+ * of truth, the BFF passes the shapes through unchanged.
+ */
+export const TERMINAL_RUN_STATUSES = ['SUCCESS', 'FAILED', 'CANCELLED'];
+export const isTerminalRunStatus = (status) => TERMINAL_RUN_STATUSES.includes(status);
+//# sourceMappingURL=types.js.map

package/src/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../libs/robin-client/src/lib/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2JH,MAAM,CAAC,MAAM,qBAAqB,GAA8B,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAEnG,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAA+B,EAAW,EAAE,CAC7E,qBAA2C,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC"}