@indemn/cli 1.5.0 → 1.7.0

package/dist/sdk/platform.js

@@ -0,0 +1,95 @@
+import { CliError, EXIT } from '../core/runtime.js';
+/** Which of them the CLI may change. Components and connectors are a global catalog with no auth on Darwin: read-only here. */
+const WRITABLE = ['agents', 'templates', 'connector-bindings', 'scenarios'];
+function assertWritable(resource) {
+    if (!WRITABLE.includes(resource)) {
+        throw new CliError(`${resource} is a shared catalog on the V2 platform; the CLI only reads it.`, EXIT.NEEDS_INPUT);
+    }
+}
+/** The V2 platform (Darwin): V2 agents, templates, scenarios, simulations and Jarvis jobs, all checked by Darwin against your org and role. */
+export class PlatformSDK {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    list(resource, query) {
+        return this.client.platformRequest('GET', `/${resource}`, { query });
+    }
+    get(resource, id) {
+        return this.client.platformRequest('GET', `/${resource}/${encodeURIComponent(id)}`);
+    }
+    async create(resource, body) {
+        assertWritable(resource);
+        return this.client.platformRequest('POST', `/${resource}`, { body });
+    }
+    async update(resource, id, body) {
+        assertWritable(resource);
+        return this.client.platformRequest('PUT', `/${resource}/${encodeURIComponent(id)}`, { body });
+    }
+    async remove(resource, id) {
+        assertWritable(resource);
+        return this.client.platformRequest('DELETE', `/${resource}/${encodeURIComponent(id)}`);
+    }
+    /** Checks a template's graph: components exist and edges point at real nodes. */
+    validateTemplate(id) {
+        return this.client.platformRequest('POST', `/templates/${encodeURIComponent(id)}/validate`);
+    }
+    /** Validates input against a connector's schema and previews the request; never calls the connector. */
+    testConnector(id, input) {
+        return this.client.platformRequest('POST', `/connectors/${encodeURIComponent(id)}/test`, { body: { test_input: input } });
+    }
+    /** Run scenarios against a V2 agent. Darwin does not check the agent's org here, so the agent is read first (that read is org-checked). */
+    async runSimulation(agentId, scenarioIds = []) {
+        await this.get('agents', agentId);
+        return this.client.platformRequest('POST', '/simulations/run', { body: { agent_id: agentId, scenario_ids: scenarioIds, triggered_by: 'user' } });
+    }
+    simulationJobs(filter = {}) {
+        const q = {};
+        if (filter.agentId)
+            q.agent_id = filter.agentId;
+        if (filter.status)
+            q.status = filter.status;
+        return this.client.platformRequest('GET', '/simulations/jobs', { query: q });
+    }
+    simulationJob(id) {
+        return this.client.platformRequest('GET', `/simulations/jobs/${encodeURIComponent(id)}`);
+    }
+    simulationResults(filter = {}) {
+        if (filter.resultId)
+            return this.client.platformRequest('GET', `/simulations/results/${encodeURIComponent(filter.resultId)}`);
+        const q = { limit: String(Math.min(filter.limit ?? 10, 100)) };
+        if (filter.agentId)
+            q.agent_id = filter.agentId;
+        return this.client.platformRequest('GET', '/simulations/results', { query: q });
+    }
+    /** Which agents of the org have a baseline evaluation, and which are stale. */
+    orgEvaluations() {
+        return this.client.platformRequest('GET', '/org-evaluations');
+    }
+    /** Ask Jarvis to generate baseline evaluations for up to 50 agents (Darwin checks they are in the org). */
+    createJarvisJob(botIds) {
+        if (botIds.length < 1 || botIds.length > 50)
+            throw new CliError('Give 1 to 50 agent ids.', EXIT.NEEDS_INPUT);
+        return this.client.platformRequest('POST', '/jarvis/jobs', { body: { job_type: 'baseline_generation', bot_ids: botIds } });
+    }
+    jarvisJobs(status) {
+        return this.client.platformRequest('GET', '/jarvis/jobs', { query: status ? { status } : undefined });
+    }
+    jarvisJob(id) {
+        return this.client.platformRequest('GET', `/jarvis/jobs/${encodeURIComponent(id)}`);
+    }
+    /** Poll a Jarvis job until it completes (Darwin never marks jobs failed; per-agent failures are in progress.results). */
+    async waitForJarvisJob(id, opts = {}) {
+        const started = Date.now();
+        for (;;) {
+            const job = await this.jarvisJob(id);
+            opts.onProgress?.(job);
+            if (job.status === 'completed' || job.status === 'failed')
+                return job;
+            if (Date.now() - started > (opts.timeoutMs ?? 30 * 60_000))
+                throw new CliError(`Jarvis job ${id} is still ${job.status}.`);
+            await new Promise((r) => setTimeout(r, opts.intervalMs ?? 5_000));
+        }
+    }
+}
+//# sourceMappingURL=platform.js.map

package/dist/sdk/platform.js.map

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

package/dist/sdk/session.d.ts

@@ -0,0 +1,25 @@
+import type { Environment, StoredSession } from './types.js';
+export type { StoredSession };
+export type UnauthPost = <T>(path: string, body: unknown, headers?: Record<string, string>) => Promise<T>;
+/** Expiry from the JWT `exp` claim, or null when the token has none. */
+export declare function tokenExpiry(token: string): Date | null;
+/** Renew when less than `windowMs` (default one hour) of life is left. Unknown expiry never renews. */
+export declare function needsRenewal(session: StoredSession, now?: Date, windowMs?: number): boolean;
+/** Trade the Firebase refresh token for a fresh Firebase ID token (Google secure-token API). */
+export declare function refreshIdToken(env: Environment, refreshToken: string): Promise<{
+    idToken: string;
+    refreshToken: string;
+}>;
+/**
+ * Exchange a Firebase ID token for a copilot session, exactly as the dashboard
+ * does. Accounts with MFA get an emailed code; without a way to ask for it the
+ * caller must log in interactively.
+ */
+export declare function exchangeIdToken(post: UnauthPost, idToken: string, askMfaCode?: () => Promise<string>): Promise<{
+    token: string;
+    userId: string;
+    email?: string;
+}>;
+/** Package a copilot token for storage. */
+export declare function toStoredSession(token: string, refreshToken?: string): StoredSession;
+//# sourceMappingURL=session.d.ts.map

package/dist/sdk/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/sdk/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7D,YAAY,EAAE,aAAa,EAAE,CAAC;AAM9B,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAI1G,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAStD;AAED,uGAAuG;AACvG,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,GAAE,IAAiB,EAAE,QAAQ,SAAiB,GAAG,OAAO,CAI/G;AAED,gGAAgG;AAChG,wBAAsB,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAc/H;AAMD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GACjC,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAsB5D;AAED,2CAA2C;AAC3C,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa,CAGnF"}

package/dist/sdk/session.js

@@ -0,0 +1,69 @@
+import { SessionExpiredError } from '../core/runtime.js';
+import { FIREBASE_CONFIGS } from './auth.js';
+const SECURE_TOKEN_URL = 'https://securetoken.googleapis.com/v1/token';
+const RELOGIN = 'Run `indemn login` in a terminal, then retry.';
+/** Expiry from the JWT `exp` claim, or null when the token has none. */
+export function tokenExpiry(token) {
+    const payload = token.split('.')[1];
+    if (!payload)
+        return null;
+    try {
+        const claims = JSON.parse(Buffer.from(payload, 'base64url').toString('utf8'));
+        return typeof claims.exp === 'number' ? new Date(claims.exp * 1000) : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Renew when less than `windowMs` (default one hour) of life is left. Unknown expiry never renews. */
+export function needsRenewal(session, now = new Date(), windowMs = 60 * 60 * 1000) {
+    const expiry = session.expires_at ? new Date(session.expires_at) : tokenExpiry(session.token);
+    if (!expiry || Number.isNaN(expiry.getTime()))
+        return false;
+    return expiry.getTime() - now.getTime() < windowMs;
+}
+/** Trade the Firebase refresh token for a fresh Firebase ID token (Google secure-token API). */
+export async function refreshIdToken(env, refreshToken) {
+    const url = `${SECURE_TOKEN_URL}?key=${encodeURIComponent(FIREBASE_CONFIGS[env].apiKey)}`;
+    const res = await fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: new URLSearchParams({ grant_type: 'refresh_token', refresh_token: refreshToken }).toString(),
+    });
+    if (!res.ok) {
+        // Revoked, password changed or account disabled: a real login is the right answer.
+        throw new SessionExpiredError(`Session expired and could not be renewed. ${RELOGIN}`);
+    }
+    const json = await res.json();
+    if (!json.id_token)
+        throw new SessionExpiredError(`Session renewal returned no token. ${RELOGIN}`);
+    return { idToken: json.id_token, refreshToken: json.refresh_token || refreshToken };
+}
+function stripScheme(token) {
+    return token.replace(/^JWT\s+/i, '');
+}
+/**
+ * Exchange a Firebase ID token for a copilot session, exactly as the dashboard
+ * does. Accounts with MFA get an emailed code; without a way to ask for it the
+ * caller must log in interactively.
+ */
+export async function exchangeIdToken(post, idToken, askMfaCode) {
+    const signin = await post('/auth/firebase/signin', { idToken });
+    if (signin.requiresMfa) {
+        if (!askMfaCode) {
+            throw new SessionExpiredError(`Your account needs an MFA code to renew the session. ${RELOGIN}`);
+        }
+        const code = (await askMfaCode()).trim();
+        const verified = await post('/auth/firebase/mfa/verify', { sessionId: signin.mfaSessionId, code });
+        return { token: stripScheme(verified.token), userId: verified.user._id, email: verified.user.email };
+    }
+    if (!signin.token || !signin.user)
+        throw new SessionExpiredError(`Sign-in returned no session. ${RELOGIN}`);
+    return { token: stripScheme(signin.token), userId: signin.user._id, email: signin.user.email };
+}
+/** Package a copilot token for storage. */
+export function toStoredSession(token, refreshToken) {
+    const expiry = tokenExpiry(token);
+    return { token, expires_at: expiry?.toISOString(), refresh_token: refreshToken };
+}
+//# sourceMappingURL=session.js.map

package/dist/sdk/session.js.map

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

package/dist/sdk/skills.d.ts

@@ -0,0 +1,46 @@
+/**
+ * copilot's name skeleton (utils/stringUtil.js skillNameKey), reproduced so a
+ * clash is reported before anything is sent. "FAQs Retriever",
+ * "FQ retrievers" and "F.A.Q. retrieval tool" all become "fqrtrv".
+ */
+export declare function skillNameKey(name: string): string;
+/** Throw the same error copilot would, before any request, when a name imitates a built-in skill. */
+export declare function assertSkillNameAllowed(name: string | undefined, type?: string): void;
+/**
+ * A secret passed to a flag, kept out of shell history when possible:
+ * "@path" reads a file, "env:NAME" reads an environment variable, "-" reads
+ * stdin. A plain value still works but prints a warning.
+ */
+export declare function resolveSecretArg(flag: string, value: string | undefined, warn?: (msg: string) => void): string | undefined;
+/** Find the list of proposed skills in a generate-from-doc answer. */
+/**
+ * A skill's configurationSchema from plain fields, laid over `base` (the saved one on update,
+ * since copilot replaces it whole). copilot needs an authorization type on rest_api skills;
+ * unauthenticated APIs get no-auth.
+ */
+/**
+ * A call-transfer destination the way the dashboard saves it: phoneNumber (+ intlTelObj) or sipUri
+ * (+ sipHeaders). Older skills say handoffNumber, and some exports carry the runtime's
+ * {"action":"transfer","payload":{"to":...}} as payload. copilot reads sipUri, then phoneNumber, then
+ * handoffNumber, so a new destination in `patch` must replace the saved one of either kind.
+ */
+export declare function transferDestination(base: Record<string, unknown>, patch?: Record<string, unknown>): Record<string, unknown>;
+/**
+ * The dashboard's REST form quotes a bare {{parameter}} before saving (rest-api-form.tsx quoteBareMentions):
+ * `"guests": {{guests}}` becomes `"guests": "{{guests}}"`, so the body is the valid JSON copilot requires.
+ */
+export declare function quoteBareMentions(payload: string): string;
+/** A REST body as copilot saves it: JSON text with bare placeholders quoted; refused when it is still not JSON. */
+export declare function requestBody(payload: unknown): string;
+export declare function skillConfiguration(type: string, f: {
+    url?: string;
+    method?: string;
+    payload?: unknown;
+    response_field?: string;
+    output_instructions?: string;
+    craft_response?: boolean;
+    configuration?: Record<string, unknown>;
+    transfer_to?: string;
+}, base?: Record<string, unknown>): Record<string, unknown> | undefined;
+export declare function proposedSkills(res: unknown): Array<Record<string, unknown>> | null;
+//# sourceMappingURL=skills.d.ts.map

package/dist/sdk/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/sdk/skills.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWjD;AAED,qGAAqG;AACrG,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CASpF;AAQD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAA4C,GAAG,MAAM,GAAG,SAAS,CAkBjK;AAED,sEAAsE;AACtE;;;;GAIG;AACH;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2B/H;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAwBzD;AAED,mHAAmH;AACnH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAUpD;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,CAAC,EAAE;IACD,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAC1E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChG,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,EACD,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAerC;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAUlF"}

package/dist/sdk/skills.js

@@ -0,0 +1,203 @@
+import { readFileSync } from 'node:fs';
+import { CliError, EXIT } from '../core/runtime.js';
+const FILLER_WORDS = new Set(['tool', 'tools', 'skill', 'skills', 'function', 'functions']);
+/** Built-in skills a user skill must not imitate (copilot utils/constants.js INTERNAL_FUNCTIONS_LIST). */
+const INTERNAL_SKILLS = ['faqs-retriever'];
+/**
+ * copilot's name skeleton (utils/stringUtil.js skillNameKey), reproduced so a
+ * clash is reported before anything is sent. "FAQs Retriever",
+ * "FQ retrievers" and "F.A.Q. retrieval tool" all become "fqrtrv".
+ */
+export function skillNameKey(name) {
+    const joined = String(name || '')
+        .replace(/[.']/g, '')
+        .replace(/([a-z])([A-Z])/g, '$1 $2')
+        .toLowerCase()
+        .split(/[^a-z]+/)
+        .filter((word) => word && !FILLER_WORDS.has(word))
+        .map((word) => (word.length > 4 ? word.replace(/(ers|er|als|al|ings|ing|e)$/, '') : word))
+        .sort()
+        .join('');
+    return joined.charAt(0) + joined.slice(1).replace(/[aeious]/g, '');
+}
+/** Throw the same error copilot would, before any request, when a name imitates a built-in skill. */
+export function assertSkillNameAllowed(name, type) {
+    if (!name || (type && INTERNAL_SKILLS.includes(type)))
+        return;
+    const key = skillNameKey(name);
+    if (INTERNAL_SKILLS.some((reserved) => skillNameKey(reserved) === key)) {
+        throw new CliError(`"${name}" is too similar to the built-in skill "${INTERNAL_SKILLS.join('", "')}", which every agent already has. Choose a different name.`, EXIT.NEEDS_INPUT);
+    }
+}
+let stdinCache;
+function readStdin() {
+    if (stdinCache === undefined)
+        stdinCache = readFileSync(0, 'utf8');
+    return stdinCache;
+}
+/**
+ * A secret passed to a flag, kept out of shell history when possible:
+ * "@path" reads a file, "env:NAME" reads an environment variable, "-" reads
+ * stdin. A plain value still works but prints a warning.
+ */
+export function resolveSecretArg(flag, value, warn = (m) => process.stderr.write(m + '\n')) {
+    if (value === undefined)
+        return undefined;
+    if (value === '-')
+        return readStdin().trim();
+    if (value.startsWith('@')) {
+        try {
+            return readFileSync(value.slice(1), 'utf8').trim();
+        }
+        catch {
+            throw new CliError(`${flag}: cannot read ${value.slice(1)}.`);
+        }
+    }
+    if (value.startsWith('env:')) {
+        const name = value.slice(4);
+        const v = process.env[name];
+        if (v === undefined || v === '')
+            throw new CliError(`${flag}: environment variable ${name} is not set.`);
+        return v;
+    }
+    warn(`Warning: ${flag} was typed on the command line and is now in your shell history. Next time use ${flag} @file, ${flag} env:NAME or ${flag} - (stdin).`);
+    return value;
+}
+/** Find the list of proposed skills in a generate-from-doc answer. */
+/**
+ * A skill's configurationSchema from plain fields, laid over `base` (the saved one on update,
+ * since copilot replaces it whole). copilot needs an authorization type on rest_api skills;
+ * unauthenticated APIs get no-auth.
+ */
+/**
+ * A call-transfer destination the way the dashboard saves it: phoneNumber (+ intlTelObj) or sipUri
+ * (+ sipHeaders). Older skills say handoffNumber, and some exports carry the runtime's
+ * {"action":"transfer","payload":{"to":...}} as payload. copilot reads sipUri, then phoneNumber, then
+ * handoffNumber, so a new destination in `patch` must replace the saved one of either kind.
+ */
+export function transferDestination(base, patch = {}) {
+    const str = (v) => (typeof v === 'string' && v ? v : undefined);
+    const legacyTo = (c) => {
+        if (typeof c.payload !== 'string')
+            return undefined;
+        try {
+            const p = JSON.parse(c.payload);
+            return p?.action === 'transfer' ? str(p.payload?.to) : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    };
+    const pick = (c) => {
+        const to = legacyTo(c);
+        const sip = str(c.sipUri) ?? (to?.startsWith('sip:') ? to : undefined);
+        const phone = str(c.phoneNumber) ?? str(c.handoffNumber) ?? (to && !to.startsWith('sip:') ? to : undefined);
+        return sip ? { sip, headers: c.sipHeaders } : phone ? { phone } : undefined;
+    };
+    const dest = pick(patch) ?? pick(base);
+    const out = { ...base, ...patch };
+    if (legacyTo(out) !== undefined) {
+        delete out.payload;
+        delete out.payloadOps;
+    }
+    for (const k of ['sipUri', 'sipHeaders', 'phoneNumber', 'intlTelObj', 'handoffNumber'])
+        delete out[k];
+    if (dest && 'sip' in dest) {
+        out.sipUri = dest.sip;
+        if (dest.headers && typeof dest.headers === 'object' && Object.keys(dest.headers).length)
+            out.sipHeaders = dest.headers;
+    }
+    else if (dest?.phone) {
+        out.phoneNumber = dest.phone;
+        out.intlTelObj = { number: dest.phone, e164Number: dest.phone };
+    }
+    return out;
+}
+/**
+ * The dashboard's REST form quotes a bare {{parameter}} before saving (rest-api-form.tsx quoteBareMentions):
+ * `"guests": {{guests}}` becomes `"guests": "{{guests}}"`, so the body is the valid JSON copilot requires.
+ */
+export function quoteBareMentions(payload) {
+    let out = '';
+    let inString = false;
+    for (let i = 0; i < payload.length; i++) {
+        const ch = payload[i];
+        if (inString) {
+            out += ch;
+            if (ch === '\\')
+                out += payload[++i] ?? '';
+            else if (ch === '"')
+                inString = false;
+            continue;
+        }
+        if (ch === '"') {
+            inString = true;
+        }
+        else if (ch === '{' && payload[i + 1] === '{') {
+            const close = payload.indexOf('}}', i + 2);
+            if (close !== -1) {
+                out += JSON.stringify(payload.slice(i, close + 2));
+                i = close + 1;
+                continue;
+            }
+        }
+        out += ch;
+    }
+    return out;
+}
+/** A REST body as copilot saves it: JSON text with bare placeholders quoted; refused when it is still not JSON. */
+export function requestBody(payload) {
+    if (typeof payload !== 'string')
+        return JSON.stringify(payload);
+    if (!payload.trim())
+        return payload;
+    const body = quoteBareMentions(payload);
+    try {
+        JSON.parse(body);
+    }
+    catch (err) {
+        throw new CliError(`The request body is not valid JSON (${err instanceof Error ? err.message : String(err)}). Nothing was saved. Send it as JSON text, e.g. {"event_date": "{{event_date}}"}.`, EXIT.ERROR);
+    }
+    return body;
+}
+export function skillConfiguration(type, f, base = {}) {
+    const patch = { ...(f.configuration ?? {}) };
+    if (f.url !== undefined)
+        patch.endpoint = f.url;
+    if (f.method !== undefined)
+        patch.method = f.method.toUpperCase();
+    if (f.payload !== undefined)
+        patch.payload = f.payload;
+    if (patch.payload !== undefined)
+        patch.payload = requestBody(patch.payload);
+    if (f.response_field !== undefined)
+        patch.responseField = f.response_field;
+    if (f.output_instructions !== undefined)
+        patch.outputInstructions = f.output_instructions;
+    if (f.craft_response !== undefined)
+        patch.craftResponse = f.craft_response;
+    if (f.transfer_to !== undefined)
+        patch[f.transfer_to.startsWith('sip:') ? 'sipUri' : 'phoneNumber'] = f.transfer_to;
+    if (!Object.keys(patch).length)
+        return undefined;
+    if (type === 'transfer_call')
+        return transferDestination(base, patch);
+    const merged = { ...base, ...patch };
+    if (type === 'rest_api' && merged.authorization === undefined)
+        merged.authorization = { type: 'no-auth' };
+    return merged;
+}
+export function proposedSkills(res) {
+    if (Array.isArray(res))
+        return res;
+    if (res && typeof res === 'object') {
+        const r = res;
+        for (const key of ['functions', 'skills', 'tools', 'data', 'result']) {
+            const found = proposedSkills(r[key]);
+            if (found)
+                return found;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=skills.js.map

package/dist/sdk/skills.js.map

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

package/dist/sdk/test-chat.d.ts

@@ -0,0 +1,52 @@
+import { IndemnClient } from './client.js';
+import { ChatSession } from './chat.js';
+import type { Agent } from './types.js';
+/** Who is testing: the login email, else the email inside a host-supplied session token. */
+export declare function testerIdentity(client: IndemnClient): string | null;
+/**
+ * The dashboard's "Talk to agent" preview record for this person and agent.
+ * Reused when it exists (never overwritten, it may hold context they saved in
+ * the dashboard); created empty otherwise. Optional: failure only means the
+ * dashboard cannot show the tester card.
+ */
+export declare function ensurePreview(client: IndemnClient, agentId: string): Promise<string | null>;
+export interface OpenedTestChat {
+    session: ChatSession;
+    sessionId: string;
+    agent: Agent;
+    orgId: string;
+    projectId: string;
+    url: string;
+    tester: string | null;
+    preview: string | null;
+    resumed: boolean;
+    /** Every complete agent message so far, greeting included. */
+    transcript: string[];
+    /** True while the agent is streaming a message. */
+    isReceiving: () => boolean;
+}
+/**
+ * Open a chat that is guaranteed to be a test conversation in the chosen org:
+ * the agent is fetched through copilot (which refuses an agent from another
+ * org), the session is opened with isTestMode, and the stored conversation is
+ * read back before the caller may send anything.
+ */
+export declare function openTestChat(client: IndemnClient, agentId: string, opts?: {
+    sessionId?: string;
+    verifyTimeoutMs?: number;
+    onSession?: (session: ChatSession) => void;
+}): Promise<OpenedTestChat>;
+/**
+ * Send one message and collect the reply. A new conversation first waits for
+ * the greeting. The reply is complete when the agent has been quiet for
+ * `settleMs` after its last message.
+ */
+export declare function exchange(chat: OpenedTestChat, message: string, opts?: {
+    greetingWaitMs?: number;
+    timeoutMs?: number;
+    settleMs?: number;
+}): Promise<{
+    greeting: string;
+    response: string;
+}>;
+//# sourceMappingURL=test-chat.d.ts.map

package/dist/sdk/test-chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-chat.d.ts","sourceRoot":"","sources":["../../src/sdk/test-chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAelE;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUjG;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,mDAAmD;IACnD,WAAW,EAAE,MAAM,OAAO,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAA;CAAO,GACtG,OAAO,CAAC,cAAc,CAAC,CAyCzB;AAcD;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5E,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBjD"}