crewly 1.20.29 → 1.20.31

package/dist/backend/backend/src/services/google/sheets.service.js

@@ -0,0 +1,158 @@
+/**
+ * SheetsService — Google Sheets over the owner's Workspace grant.
+ *
+ * Reads any spreadsheet the owner can see (`drive.readonly`), creates new
+ * spreadsheets and writes to the ones Crewly created (`drive.file`).
+ * Writing to a spreadsheet made elsewhere needs the `spreadsheets` scope
+ * the grant does not carry yet; Google answers 403 and the error says so.
+ *
+ * @module services/google/sheets.service
+ */
+import { GOOGLE_WORKSPACE_CONSTANTS } from '../../constants.js';
+import { GoogleWorkspaceError } from './google-workspace-token.service.js';
+import { buildGoogleUrl, googleRequest } from './google-api.client.js';
+import { requireId } from './drive.service.js';
+/**
+ * Validate rows for a write.
+ *
+ * @param rows - Candidate rows
+ * @returns The rows
+ * @throws GoogleWorkspaceError(400, validation) when empty, not rectangular-ish, or too many
+ */
+export function requireRows(rows) {
+    const CODES = GOOGLE_WORKSPACE_CONSTANTS.ERROR_CODES;
+    if (!Array.isArray(rows) || rows.length === 0)
+        throw new GoogleWorkspaceError(400, CODES.VALIDATION, '"rows" must be a non-empty array of arrays');
+    if (rows.length > GOOGLE_WORKSPACE_CONSTANTS.SHEETS_MAX_ROWS) {
+        throw new GoogleWorkspaceError(400, CODES.VALIDATION, `"rows" exceeds ${GOOGLE_WORKSPACE_CONSTANTS.SHEETS_MAX_ROWS}`);
+    }
+    for (const row of rows) {
+        if (!Array.isArray(row))
+            throw new GoogleWorkspaceError(400, CODES.VALIDATION, 'each row must be an array');
+        for (const cell of row) {
+            if (cell !== null && cell !== undefined && !['string', 'number', 'boolean'].includes(typeof cell)) {
+                throw new GoogleWorkspaceError(400, CODES.VALIDATION, 'cells must be strings, numbers or booleans');
+            }
+        }
+    }
+    return rows.map((row) => row.map((cell) => (cell === null || cell === undefined ? '' : cell)));
+}
+/**
+ * Sheets: read, create, append, update.
+ */
+export class SheetsService {
+    deps;
+    base = GOOGLE_WORKSPACE_CONSTANTS.SHEETS_API_BASE;
+    /**
+     * @param deps - Token provider and optional fetch override
+     */
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * `spreadsheets.get` (properties only) — title and the sheet tabs.
+     *
+     * @param id - Spreadsheet id
+     * @returns Metadata
+     */
+    async info(id) {
+        const spreadsheetId = requireId(id);
+        const wire = await googleRequest(this.deps, buildGoogleUrl(`${this.base}/spreadsheets/${encodeURIComponent(spreadsheetId)}`, {
+            fields: 'spreadsheetId,properties.title,spreadsheetUrl,sheets.properties(title,gridProperties(rowCount,columnCount))',
+        }));
+        return toInfo(wire);
+    }
+    /**
+     * `spreadsheets.values.get`.
+     *
+     * @param id - Spreadsheet id
+     * @param range - A1 range (default `A1:Z1000` on the first sheet)
+     * @returns The values (rows may be ragged)
+     */
+    async read(id, range) {
+        const spreadsheetId = requireId(id);
+        const a1 = (range ?? '').trim() || GOOGLE_WORKSPACE_CONSTANTS.SHEETS_DEFAULT_RANGE;
+        const data = await googleRequest(this.deps, buildGoogleUrl(`${this.base}/spreadsheets/${encodeURIComponent(spreadsheetId)}/values/${encodeURIComponent(a1)}`, {
+            valueRenderOption: 'UNFORMATTED_VALUE',
+            dateTimeRenderOption: 'FORMATTED_STRING',
+        }));
+        return { spreadsheetId, range: data.range ?? a1, rows: data.values ?? [] };
+    }
+    /**
+     * `spreadsheets.create`, then `values.update` from A1 when rows are given.
+     *
+     * @param input - Title, first-sheet name, initial rows
+     * @returns The new spreadsheet
+     * @throws GoogleWorkspaceError(400, validation) without a title
+     */
+    async create(input) {
+        const title = (input.title ?? '').trim();
+        if (!title)
+            throw new GoogleWorkspaceError(400, GOOGLE_WORKSPACE_CONSTANTS.ERROR_CODES.VALIDATION, '"title" is required');
+        const sheetTitle = (input.sheetTitle ?? '').trim() || 'Sheet1';
+        const created = await googleRequest(this.deps, `${this.base}/spreadsheets`, {
+            method: 'POST',
+            body: { properties: { title }, sheets: [{ properties: { title: sheetTitle } }] },
+        });
+        const id = created.spreadsheetId ?? '';
+        if (input.rows && input.rows.length > 0) {
+            await this.update({ spreadsheetId: id, range: `${quoteSheet(sheetTitle)}!A1`, rows: input.rows });
+        }
+        return toInfo(created);
+    }
+    /**
+     * `spreadsheets.values.append` — rows go below the last row of the
+     * table that contains `range` (default: the first sheet).
+     *
+     * @param input - Spreadsheet, range, rows
+     * @returns Updated range and counts
+     */
+    async append(input) {
+        const spreadsheetId = requireId(input.spreadsheetId);
+        const rows = requireRows(input.rows);
+        const a1 = (input.range ?? '').trim() || 'A1';
+        const data = await googleRequest(this.deps, buildGoogleUrl(`${this.base}/spreadsheets/${encodeURIComponent(spreadsheetId)}/values/${encodeURIComponent(a1)}:append`, {
+            valueInputOption: 'USER_ENTERED',
+            insertDataOption: 'INSERT_ROWS',
+        }), { method: 'POST', body: { values: rows } });
+        return { spreadsheetId, updatedRange: data.updates?.updatedRange ?? a1, updatedRows: data.updates?.updatedRows ?? rows.length };
+    }
+    /**
+     * `spreadsheets.values.update` — overwrite starting at `range`.
+     *
+     * @param input - Spreadsheet, anchor range, rows
+     * @returns Updated range and counts
+     */
+    async update(input) {
+        const spreadsheetId = requireId(input.spreadsheetId);
+        const rows = requireRows(input.rows);
+        const a1 = (input.range ?? '').trim() || 'A1';
+        const data = await googleRequest(this.deps, buildGoogleUrl(`${this.base}/spreadsheets/${encodeURIComponent(spreadsheetId)}/values/${encodeURIComponent(a1)}`, {
+            valueInputOption: 'USER_ENTERED',
+        }), { method: 'PUT', body: { values: rows } });
+        return { spreadsheetId, updatedRange: data.updatedRange ?? a1, updatedRows: data.updatedRows ?? rows.length };
+    }
+}
+function toInfo(wire) {
+    const id = wire.spreadsheetId ?? '';
+    return {
+        id,
+        title: wire.properties?.title ?? '',
+        sheets: (wire.sheets ?? []).map((s) => ({
+            title: s.properties?.title ?? '',
+            ...(s.properties?.gridProperties?.rowCount !== undefined ? { rowCount: s.properties.gridProperties.rowCount } : {}),
+            ...(s.properties?.gridProperties?.columnCount !== undefined ? { columnCount: s.properties.gridProperties.columnCount } : {}),
+        })),
+        webViewLink: wire.spreadsheetUrl ?? `https://docs.google.com/spreadsheets/d/${id}/edit`,
+    };
+}
+/**
+ * Quote a sheet name for an A1 range when it needs it.
+ *
+ * @param name - Sheet title
+ * @returns `'My Sheet'` or `Sheet1`
+ */
+export function quoteSheet(name) {
+    return /^[A-Za-z0-9_]+$/.test(name) ? name : `'${name.replace(/'/g, "''")}'`;
+}
+//# sourceMappingURL=sheets.service.js.map

package/dist/backend/backend/src/services/google/sheets.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheets.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/google/sheets.service.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/google/slides.service.d.ts

@@ -0,0 +1,136 @@
+/**
+ * SlidesService — Google Slides over the owner's Workspace grant.
+ *
+ * Reads any presentation the owner can see (`drive.readonly`) and builds
+ * new decks from an outline (`drive.file`). Each outline slide becomes a
+ * TITLE_AND_BODY slide with the title and bullet lines; the deck's default
+ * first slide is removed so the outline is the whole deck.
+ *
+ * @module services/google/slides.service
+ */
+import { type GoogleApiDeps } from './google-api.client.js';
+/** One slide, flattened. */
+export interface SlideText {
+    index: number;
+    objectId: string;
+    /** Every text line on the slide, in reading order. */
+    lines: string[];
+    notes?: string;
+}
+/** A presentation, flattened. */
+export interface PresentationText {
+    id: string;
+    title: string;
+    slideCount: number;
+    slides: SlideText[];
+    webViewLink: string;
+}
+/** One slide of an outline. */
+export interface SlideOutline {
+    title: string;
+    /** Body lines; each becomes one paragraph (bulleting is the layout's default). */
+    bullets?: string[];
+    /** Speaker notes are not written (the Slides API needs the notes shape id) — kept for callers' bookkeeping. */
+    notes?: string;
+}
+/** Create input. */
+export interface PresentationCreateInput {
+    title: string;
+    slides: SlideOutline[];
+}
+interface WireTextElement {
+    textRun?: {
+        content?: string;
+    };
+}
+interface WirePageElement {
+    shape?: {
+        text?: {
+            textElements?: WireTextElement[];
+        };
+    };
+    table?: {
+        tableRows?: Array<{
+            tableCells?: Array<{
+                text?: {
+                    textElements?: WireTextElement[];
+                };
+            }>;
+        }>;
+    };
+    elementGroup?: {
+        children?: WirePageElement[];
+    };
+}
+interface WirePage {
+    objectId?: string;
+    pageElements?: WirePageElement[];
+    slideProperties?: {
+        notesPage?: {
+            pageElements?: WirePageElement[];
+        };
+    };
+}
+interface WirePresentation {
+    presentationId?: string;
+    title?: string;
+    slides?: WirePage[];
+}
+/**
+ * Lines of text in a page element (shape text, table cells, groups).
+ *
+ * @param el - Page element
+ * @returns Non-empty lines
+ */
+export declare function elementLines(el: WirePageElement): string[];
+/**
+ * Flatten a presentation.
+ *
+ * @param wire - `presentations.get` payload
+ * @returns Title + slides as text
+ */
+export declare function toPresentationText(wire: WirePresentation): PresentationText;
+/**
+ * The batchUpdate requests that turn an outline into slides.
+ *
+ * @param outline - Slides to add
+ * @param removeSlideId - Object id of the default slide to delete, if any
+ * @returns Requests in order (creates, inserts, then the delete)
+ */
+export declare function buildSlideRequests(outline: SlideOutline[], removeSlideId?: string): unknown[];
+/**
+ * Slides: read, create from outline.
+ */
+export declare class SlidesService {
+    private readonly deps;
+    private readonly base;
+    /**
+     * @param deps - Token provider and optional fetch override
+     */
+    constructor(deps: GoogleApiDeps);
+    /**
+     * `presentations.get`, flattened to text per slide.
+     *
+     * @param id - Presentation id
+     * @returns Title + slides
+     */
+    read(id: string): Promise<PresentationText>;
+    /**
+     * `presentations.create` + one `batchUpdate` that adds every outline
+     * slide and removes the default blank one.
+     *
+     * @param input - Title and outline
+     * @returns The new deck, flattened (as read back from Google)
+     * @throws GoogleWorkspaceError(400, validation) without a title / slides, or too many slides
+     */
+    create(input: PresentationCreateInput): Promise<PresentationText>;
+}
+/**
+ * Browser link for a presentation.
+ *
+ * @param id - Presentation id
+ * @returns URL
+ */
+export declare function slidesLink(id: string): string;
+export {};
+//# sourceMappingURL=slides.service.d.ts.map

package/dist/backend/backend/src/services/google/slides.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slides.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/google/slides.service.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/google/slides.service.js

@@ -0,0 +1,153 @@
+/**
+ * SlidesService — Google Slides over the owner's Workspace grant.
+ *
+ * Reads any presentation the owner can see (`drive.readonly`) and builds
+ * new decks from an outline (`drive.file`). Each outline slide becomes a
+ * TITLE_AND_BODY slide with the title and bullet lines; the deck's default
+ * first slide is removed so the outline is the whole deck.
+ *
+ * @module services/google/slides.service
+ */
+import { GOOGLE_WORKSPACE_CONSTANTS } from '../../constants.js';
+import { GoogleWorkspaceError } from './google-workspace-token.service.js';
+import { buildGoogleUrl, googleRequest } from './google-api.client.js';
+import { requireId } from './drive.service.js';
+/**
+ * Lines of text in a page element (shape text, table cells, groups).
+ *
+ * @param el - Page element
+ * @returns Non-empty lines
+ */
+export function elementLines(el) {
+    const out = [];
+    const pushText = (elements) => {
+        const raw = (elements ?? []).map((t) => t.textRun?.content ?? '').join('');
+        for (const line of raw.split('\n'))
+            if (line.trim())
+                out.push(line.trim());
+    };
+    if (el.shape?.text)
+        pushText(el.shape.text.textElements);
+    for (const row of el.table?.tableRows ?? []) {
+        const cells = (row.tableCells ?? []).map((c) => (c.text?.textElements ?? []).map((t) => t.textRun?.content ?? '').join('').trim());
+        if (cells.some(Boolean))
+            out.push(cells.join(' | '));
+    }
+    for (const child of el.elementGroup?.children ?? [])
+        out.push(...elementLines(child));
+    return out;
+}
+/**
+ * Flatten a presentation.
+ *
+ * @param wire - `presentations.get` payload
+ * @returns Title + slides as text
+ */
+export function toPresentationText(wire) {
+    const id = wire.presentationId ?? '';
+    const slides = (wire.slides ?? []).map((page, i) => {
+        const lines = (page.pageElements ?? []).flatMap(elementLines);
+        const notes = (page.slideProperties?.notesPage?.pageElements ?? []).flatMap(elementLines).join('\n');
+        return { index: i + 1, objectId: page.objectId ?? '', lines, ...(notes ? { notes } : {}) };
+    });
+    return { id, title: wire.title ?? '', slideCount: slides.length, slides, webViewLink: slidesLink(id) };
+}
+/**
+ * The batchUpdate requests that turn an outline into slides.
+ *
+ * @param outline - Slides to add
+ * @param removeSlideId - Object id of the default slide to delete, if any
+ * @returns Requests in order (creates, inserts, then the delete)
+ */
+export function buildSlideRequests(outline, removeSlideId) {
+    const requests = [];
+    outline.forEach((slide, i) => {
+        const slideId = `crewly_slide_${i + 1}`;
+        const titleId = `${slideId}_title`;
+        const bodyId = `${slideId}_body`;
+        requests.push({
+            createSlide: {
+                objectId: slideId,
+                insertionIndex: i,
+                slideLayoutReference: { predefinedLayout: 'TITLE_AND_BODY' },
+                placeholderIdMappings: [
+                    { layoutPlaceholder: { type: 'TITLE', index: 0 }, objectId: titleId },
+                    { layoutPlaceholder: { type: 'BODY', index: 0 }, objectId: bodyId },
+                ],
+            },
+        });
+        const title = (slide.title ?? '').trim();
+        if (title)
+            requests.push({ insertText: { objectId: titleId, insertionIndex: 0, text: title } });
+        const body = (slide.bullets ?? []).map((b) => String(b).trim()).filter(Boolean).join('\n');
+        if (body)
+            requests.push({ insertText: { objectId: bodyId, insertionIndex: 0, text: body } });
+    });
+    if (removeSlideId)
+        requests.push({ deleteObject: { objectId: removeSlideId } });
+    return requests;
+}
+/**
+ * Slides: read, create from outline.
+ */
+export class SlidesService {
+    deps;
+    base = GOOGLE_WORKSPACE_CONSTANTS.SLIDES_API_BASE;
+    /**
+     * @param deps - Token provider and optional fetch override
+     */
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * `presentations.get`, flattened to text per slide.
+     *
+     * @param id - Presentation id
+     * @returns Title + slides
+     */
+    async read(id) {
+        const presentationId = requireId(id);
+        const wire = await googleRequest(this.deps, buildGoogleUrl(`${this.base}/presentations/${encodeURIComponent(presentationId)}`, {
+            fields: 'presentationId,title,slides(objectId,pageElements,slideProperties.notesPage.pageElements)',
+        }));
+        return toPresentationText(wire);
+    }
+    /**
+     * `presentations.create` + one `batchUpdate` that adds every outline
+     * slide and removes the default blank one.
+     *
+     * @param input - Title and outline
+     * @returns The new deck, flattened (as read back from Google)
+     * @throws GoogleWorkspaceError(400, validation) without a title / slides, or too many slides
+     */
+    async create(input) {
+        const CODES = GOOGLE_WORKSPACE_CONSTANTS.ERROR_CODES;
+        const title = (input.title ?? '').trim();
+        if (!title)
+            throw new GoogleWorkspaceError(400, CODES.VALIDATION, '"title" is required');
+        const outline = Array.isArray(input.slides) ? input.slides.filter((s) => s && typeof s === 'object') : [];
+        if (outline.length === 0)
+            throw new GoogleWorkspaceError(400, CODES.VALIDATION, '"slides" must be a non-empty array of {title, bullets[]}');
+        if (outline.length > GOOGLE_WORKSPACE_CONSTANTS.SLIDES_MAX_SLIDES) {
+            throw new GoogleWorkspaceError(400, CODES.VALIDATION, `"slides" exceeds ${GOOGLE_WORKSPACE_CONSTANTS.SLIDES_MAX_SLIDES}`);
+        }
+        const created = await googleRequest(this.deps, `${this.base}/presentations`, { method: 'POST', body: { title } });
+        const presentationId = created.presentationId ?? '';
+        const defaultSlide = created.slides?.[0]?.objectId;
+        await googleRequest(this.deps, `${this.base}/presentations/${encodeURIComponent(presentationId)}:batchUpdate`, {
+            method: 'POST',
+            body: { requests: buildSlideRequests(outline, defaultSlide) },
+        });
+        return this.read(presentationId);
+    }
+}
+/**
+ * Browser link for a presentation.
+ *
+ * @param id - Presentation id
+ * @returns URL
+ */
+export function slidesLink(id) {
+    return `https://docs.google.com/presentation/d/${id}/edit`;
+}
+//# sourceMappingURL=slides.service.js.map

package/dist/backend/backend/src/services/google/slides.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slides.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/google/slides.service.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/utils/tool-call-markup.utils.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Strip tool-call markup an LLM emitted as prose.
+ *
+ * Models occasionally write their function-call envelope into the *text*
+ * part of a turn instead of (or as well as) making a real tool call. For a
+ * PTY runtime nobody sees it, but the in-process Crewly Agent forwards its
+ * text straight to Slack and chat, so the user gets a wall of
+ * `<invoke name="Bash">…` instead of an answer (2026-09-19, #crewly-support).
+ *
+ * This removes those envelopes — `function_calls` wrappers, `invoke`
+ * blocks and stray `parameter` tags, with or without a namespace prefix —
+ * while leaving fenced code blocks untouched, so an agent that is
+ * deliberately *explaining* the syntax keeps its example.
+ *
+ * @module utils/tool-call-markup
+ */
+/** Result of {@link stripToolCallMarkup}. */
+export interface StrippedText {
+    /** The text with tool-call envelopes removed and whitespace tidied. */
+    text: string;
+    /** True when something was removed. */
+    stripped: boolean;
+}
+/**
+ * Whether a string contains something that looks like a tool-call envelope.
+ *
+ * @param raw - Candidate text
+ * @returns True when an `invoke` / `function_calls` tag is present
+ */
+export declare function hasToolCallMarkup(raw: string): boolean;
+/**
+ * Remove tool-call markup from an agent's text response.
+ *
+ * Fenced code blocks (``` … ```) are passed through untouched: markup
+ * inside them is an example the agent meant to show.
+ *
+ * @param raw - The agent's text
+ * @returns The cleaned text and whether anything was removed
+ *
+ * @example
+ * stripToolCallMarkup('Working on it.\n<invoke name="Bash">…</invoke>')
+ * // → { text: 'Working on it.', stripped: true }
+ */
+export declare function stripToolCallMarkup(raw: string): StrippedText;
+//# sourceMappingURL=tool-call-markup.utils.d.ts.map

package/dist/backend/backend/src/utils/tool-call-markup.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call-markup.utils.d.ts","sourceRoot":"","sources":["../../../../../backend/src/utils/tool-call-markup.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA+BH,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAwB7D"}

package/dist/backend/backend/src/utils/tool-call-markup.utils.js

@@ -0,0 +1,83 @@
+/**
+ * Strip tool-call markup an LLM emitted as prose.
+ *
+ * Models occasionally write their function-call envelope into the *text*
+ * part of a turn instead of (or as well as) making a real tool call. For a
+ * PTY runtime nobody sees it, but the in-process Crewly Agent forwards its
+ * text straight to Slack and chat, so the user gets a wall of
+ * `<invoke name="Bash">…` instead of an answer (2026-09-19, #crewly-support).
+ *
+ * This removes those envelopes — `function_calls` wrappers, `invoke`
+ * blocks and stray `parameter` tags, with or without a namespace prefix —
+ * while leaving fenced code blocks untouched, so an agent that is
+ * deliberately *explaining* the syntax keeps its example.
+ *
+ * @module utils/tool-call-markup
+ */
+/** Tag names that only ever appear in a tool-call envelope. */
+const ENVELOPE_TAGS = ['function_calls', 'invoke', 'parameter'];
+/**
+ * A tag like `<invoke …>`, `</invoke>`, `<｜｜antml｜｜invoke>` —
+ * any junk/namespace before the name, anything but `<`/`>` after it.
+ *
+ * @param name - Tag name
+ * @param closing - Match the closing form
+ * @returns The pattern source
+ */
+function tagSource(name, closing) {
+    return `<${closing ? '\\s*/' : ''}[^<>]{0,40}?\\b${name}\\b[^<>]*>`;
+}
+/** Well-formed `<x>…</x>` blocks for the wrapper tags. */
+const BLOCK_PATTERNS = ['function_calls', 'invoke'].map((name) => new RegExp(`${tagSource(name, false)}[\\s\\S]*?${tagSource(name, true)}`, 'gi'));
+/** An opening wrapper tag with no close — the output was cut off mid-call. */
+const UNCLOSED_PATTERN = new RegExp(`(?:${tagSource('function_calls', false)}|${tagSource('invoke', false)})[\\s\\S]*$`, 'i');
+/** Any leftover lone tag. */
+const LONE_TAG_PATTERN = new RegExp(ENVELOPE_TAGS.map((name) => `${tagSource(name, false)}|${tagSource(name, true)}`).join('|'), 'gi');
+/**
+ * Whether a string contains something that looks like a tool-call envelope.
+ *
+ * @param raw - Candidate text
+ * @returns True when an `invoke` / `function_calls` tag is present
+ */
+export function hasToolCallMarkup(raw) {
+    return new RegExp(`${tagSource('function_calls', false)}|${tagSource('invoke', false)}`, 'i').test(raw ?? '');
+}
+/**
+ * Remove tool-call markup from an agent's text response.
+ *
+ * Fenced code blocks (``` … ```) are passed through untouched: markup
+ * inside them is an example the agent meant to show.
+ *
+ * @param raw - The agent's text
+ * @returns The cleaned text and whether anything was removed
+ *
+ * @example
+ * stripToolCallMarkup('Working on it.\n<invoke name="Bash">…</invoke>')
+ * // → { text: 'Working on it.', stripped: true }
+ */
+export function stripToolCallMarkup(raw) {
+    const input = raw ?? '';
+    if (!input)
+        return { text: '', stripped: false };
+    // Split on fences so the segments at odd indexes are fenced code.
+    const segments = input.split(/(```[\s\S]*?```)/g);
+    const cleaned = segments
+        .map((segment, i) => {
+        if (i % 2 === 1)
+            return segment; // fenced code — leave alone
+        let out = segment;
+        for (const pattern of BLOCK_PATTERNS)
+            out = out.replace(pattern, '');
+        out = out.replace(UNCLOSED_PATTERN, '');
+        return out.replace(LONE_TAG_PATTERN, '');
+    })
+        .join('');
+    const text = cleaned
+        .split('\n')
+        .map((line) => line.replace(/[ \t]+$/, ''))
+        .join('\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+    return { text, stripped: text !== input.trim() };
+}
+//# sourceMappingURL=tool-call-markup.utils.js.map

package/dist/backend/backend/src/utils/tool-call-markup.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call-markup.utils.js","sourceRoot":"","sources":["../../../../../backend/src/utils/tool-call-markup.utils.ts"],"names":[],"mappings":"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"}

package/dist/backend/build-info.json

@@ -1,4 +1,4 @@
 {
-  "commit": "fb54dda0432bc8611a3475f7e86ac3e5e43a1079",
-  "builtAt": "2026-09-19T19:38:05.718Z"
+  "commit": "560772191ade1710fd9e96295a26777158023b19",
+  "builtAt": "2026-09-19T21:21:42.464Z"
 }