@indemn/cli 1.5.0 → 1.7.0

package/dist/sdk/agent-bundle.js

@@ -0,0 +1,211 @@
+import { AgentsSDK } from './agents.js';
+import { ConfigSDK } from './config.js';
+import { FunctionsSDK } from './functions.js';
+import { transferDestination } from './skills.js';
+import { modelForAgent } from './config-change.js';
+import { KBSDK } from './kb.js';
+import { CliError, EXIT } from '../core/runtime.js';
+export const BUNDLE_FORMAT = 'indemn-agent/1';
+const REDACTED = '<redacted>';
+const SECRET_KEY = /(api[-_]?key|token|secret|password|passwd|authorization|auth|bearer|credential|private[-_]?key|client[-_]?secret)/i;
+/** Web addresses that are secrets themselves: webhooks (anyone holding one can post), and URLs with a key in the query. */
+const SECRET_URL = /^https?:\/\/\S*(hooks\.slack\.com\/|hooks\.zapier\.com\/|discord(app)?\.com\/api\/webhooks\/|\/webhooks?\/|[?&](api[-_]?key|key|token|secret|sig|signature|access_token|password)=)/i;
+/** Replace every value under a secret-looking key, and every secret web address, at any depth. */
+export function redactSecrets(value) {
+    const redacted = [];
+    const walk = (v, path) => {
+        if (Array.isArray(v))
+            return v.map((x, i) => walk(x, `${path}[${i}]`));
+        if (v && typeof v === 'object') {
+            const out = {};
+            for (const [k, x] of Object.entries(v)) {
+                const p = path ? `${path}.${k}` : k;
+                if ((SECRET_KEY.test(k) && x !== null && typeof x !== 'object' && x !== '') || (typeof x === 'string' && SECRET_URL.test(x))) {
+                    out[k] = REDACTED;
+                    redacted.push(p);
+                }
+                else {
+                    out[k] = walk(x, p);
+                }
+            }
+            return out;
+        }
+        return v;
+    };
+    return { value: walk(value, ''), redacted };
+}
+function channelNames(channels) {
+    return (channels ?? []).map((c) => (typeof c === 'string' ? c : String(c.name ?? c.type ?? c)));
+}
+/**
+ * Everything needed to rebuild an agent elsewhere: name, channels, prompt,
+ * greeting, model, skills with parameters, and the ids of linked knowledge
+ * bases. Secrets inside skill settings are redacted unless asked otherwise.
+ */
+export async function exportAgent(client, agentId, opts = {}) {
+    const agents = new AgentsSDK(client);
+    const functions = new FunctionsSDK(client);
+    const agent = await agents.getAgent(agentId);
+    const config = await new ConfigSDK(client).getConfig(agentId);
+    const skills = await functions.listFunctions(agentId);
+    const withParams = [];
+    for (const f of skills) {
+        const params = await functions.listParameters(agentId, f._id).catch(() => []);
+        withParams.push({
+            type: f.type,
+            name: f.name,
+            description: f.description,
+            configurationSchema: f.configurationSchema,
+            parameters: params.map(({ _id, ...rest }) => rest),
+        });
+    }
+    const mappings = await new KBSDK(client).listMappings(agentId).catch(() => []);
+    const llm = config.llm_config;
+    const bundle = {
+        format: BUNDLE_FORMAT,
+        exported_at: new Date().toISOString(),
+        source: { agent_id: agentId, org_id: await client.currentOrgId(), environment: client.getEnvironment() },
+        agent: { name: agent.name, description: agent.description, channels: channelNames(agent.channels) },
+        configuration: {
+            system_prompt: config.ai_config?.system_prompt,
+            first_message: config.first_message,
+            llm_config: llm ? { provider: llm.provider, model: llm.model, parameters: llm.parameters } : undefined,
+        },
+        skills: withParams,
+        knowledge_base_ids: mappings.map((m) => String(m.id ?? '')).filter(Boolean),
+        redacted: [],
+    };
+    if (opts.includeSecrets)
+        return bundle;
+    const { value, redacted } = redactSecrets(bundle.skills);
+    return { ...bundle, skills: value, redacted };
+}
+/**
+ * Create a new agent in the current org from a bundle. Skills that carry
+ * redacted secrets are still created; the report lists what must be filled in.
+ */
+export async function importAgent(client, bundle, opts = {}) {
+    if (bundle.format !== BUNDLE_FORMAT)
+        throw new CliError(`Not an agent bundle (format ${String(bundle.format)}; expected ${BUNDLE_FORMAT}).`);
+    const agents = new AgentsSDK(client);
+    const functions = new FunctionsSDK(client);
+    const name = opts.name ?? bundle.agent.name;
+    if (!opts.allowDuplicate && (await agents.findByName(name)).length) {
+        throw new CliError(`An agent named "${name}" already exists in this org. Pass a new name, or allow a duplicate explicitly.`, EXIT.NEEDS_INPUT);
+    }
+    const agent = await agents.createAgent({ name, channels: bundle.agent.channels.length ? bundle.agent.channels : ['WEB'] });
+    if (bundle.agent.description)
+        await agents.updateAgent(agent._id, { description: bundle.agent.description });
+    const config = {};
+    if (bundle.configuration.system_prompt !== undefined)
+        config.system_prompt = bundle.configuration.system_prompt;
+    if (bundle.configuration.first_message)
+        config.first_message = JSON.stringify(bundle.configuration.first_message);
+    if (bundle.configuration.llm_config?.model)
+        config.llm_config = bundle.configuration.llm_config;
+    if (Object.keys(config).length)
+        await new ConfigSDK(client).setConfig(agent._id, config);
+    const report = {
+        agent, skills_created: 0, built_in_skills_reused: [], skills_failed: [], knowledge_bases_linked: [], knowledge_bases_skipped: [], needs_secrets: bundle.redacted,
+    };
+    // A new agent comes with the built-in skills; creating them again duplicates them (or fails).
+    const builtIns = (await functions.listFunctions(agent._id)).filter((f) => f.systemDeveloped);
+    for (const skill of bundle.skills) {
+        try {
+            // Call transfers are saved the way the dashboard saves them (older exports carry the destination elsewhere).
+            const config = skill.type === 'transfer_call' && skill.configurationSchema ? transferDestination({}, skill.configurationSchema) : skill.configurationSchema;
+            const builtIn = builtIns.find((f) => f.type === skill.type);
+            if (builtIn) {
+                if (config) {
+                    await functions.updateFunction(agent._id, builtIn._id, {
+                        type: skill.type, description: skill.description ?? builtIn.description ?? '', configurationSchema: config,
+                    });
+                }
+                builtIns.splice(builtIns.indexOf(builtIn), 1);
+                report.built_in_skills_reused.push(skill.name ?? skill.type);
+                continue;
+            }
+            const created = await functions.createFunction(agent._id, { type: skill.type, name: skill.name, description: skill.description });
+            if (config) {
+                await functions.updateFunction(agent._id, created._id, {
+                    type: skill.type, description: skill.description ?? '', configurationSchema: config,
+                });
+            }
+            for (const p of skill.parameters) {
+                const allowedValues = p.isEnumsEnabled ? (p.enums ?? []).map((e) => e.payload ?? e.title ?? '').filter(Boolean) : undefined;
+                await functions.addParameter(agent._id, created._id, { name: p.name, type: p.type, description: p.description, required: p.is_required, allowedValues });
+            }
+            report.skills_created++;
+        }
+        catch (err) {
+            report.skills_failed.push({ name: skill.name, error: err instanceof Error ? err.message : String(err) });
+        }
+    }
+    if (opts.linkKnowledgeBases && bundle.knowledge_base_ids.length) {
+        const kb = new KBSDK(client);
+        for (const id of bundle.knowledge_base_ids) {
+            try {
+                await kb.linkKB(agent._id, [id]);
+                report.knowledge_bases_linked.push(id);
+            }
+            catch {
+                report.knowledge_bases_skipped.push(id);
+            }
+        }
+    }
+    else {
+        report.knowledge_bases_skipped.push(...bundle.knowledge_base_ids);
+    }
+    return report;
+}
+/** Fields a new agent should have before it is created; the caller asks for the missing ones. */
+export function missingSkeletonFields(s) {
+    const missing = [];
+    if (!s.name?.trim())
+        missing.push('name');
+    if (!s.description?.trim())
+        missing.push('description');
+    if (!s.system_prompt?.trim())
+        missing.push('system_prompt');
+    return missing;
+}
+/**
+ * Create an agent with its basics in one go: refuse a duplicate name, create
+ * it, then set the purpose, prompt and model. Returns what was set.
+ */
+export async function createAgentFromSkeleton(client, s, opts = {}) {
+    const agents = new AgentsSDK(client);
+    const name = s.name.trim();
+    if (!name)
+        throw new CliError('An agent needs a name.', EXIT.NEEDS_INPUT);
+    if (!opts.allowDuplicate) {
+        const same = await agents.findByName(name);
+        if (same.length) {
+            throw new CliError(`An agent named "${name}" already exists in this org (${same.map((a) => a._id).join(', ')}). Choose another name or allow a duplicate explicitly.`, EXIT.NEEDS_INPUT);
+        }
+    }
+    const agent = await agents.createAgent({ name, channels: s.channels?.length ? s.channels : ['WEB'] });
+    const set = ['name', 'channels'];
+    if (s.description?.trim()) {
+        await agents.updateAgent(agent._id, { description: s.description.trim() });
+        set.push('description');
+    }
+    const config = {};
+    if (s.system_prompt?.trim())
+        config.system_prompt = s.system_prompt;
+    if (s.model)
+        config.llm_config = await modelForAgent(client, s.model, s.channels ?? ['WEB']);
+    if (Object.keys(config).length) {
+        await new ConfigSDK(client).setConfig(agent._id, config);
+        set.push(...Object.keys(config).map((k) => (k === 'llm_config' ? 'model' : k)));
+    }
+    return { agent, set };
+}
+/** "openai/gpt-4.1" -> { provider: "openai", model: "gpt-4.1" }. */
+export function parseModel(value) {
+    const i = value.indexOf('/');
+    if (i <= 0 || i === value.length - 1)
+        throw new CliError(`Model must look like provider/model, for example openai/gpt-4.1 (got "${value}").`, EXIT.NEEDS_INPUT);
+    return { provider: value.slice(0, i), model: value.slice(i + 1) };
+}
+//# sourceMappingURL=agent-bundle.js.map

package/dist/sdk/agent-bundle.js.map

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

package/dist/sdk/agents.d.ts

@@ -8,6 +8,59 @@ export declare class AgentsSDK {
     createAgent(input: CreateAgentInput): Promise<Agent>;
     updateAgent(id: string, input: UpdateAgentInput): Promise<Agent>;
     deleteAgent(id: string): Promise<void>;
-    cloneAgent(id: string): Promise<Agent>;
+    /** Agents in this org with the same name (case and surrounding spaces ignored). */
+    findByName(name: string): Promise<Agent[]>;
+    /**
+     * Copy an agent within the current org. copilot's clone route accepts a
+     * source from any org, so the source is first fetched through the org
+     * (copilot refuses an agent of another org) before cloning.
+     */
+    cloneAgent(id: string, opts?: {
+        name?: string;
+        channels?: string[];
+    }): Promise<Agent>;
+}
+export type Lifecycle = 'prototype' | 'beta' | 'published';
+/** An agent as the V2 platform (Darwin) describes it: lifecycle, owner, tools and knowledge. */
+export interface AgentDetail {
+    id: string;
+    name: string;
+    lifecycle?: Lifecycle;
+    owner?: {
+        id: string;
+        firstname?: string;
+        lastname?: string;
+        email?: string;
+    } | null;
+    owner_id?: string;
+    lifecycle_history?: Array<{
+        from_stage?: string;
+        to_stage?: string;
+        changed_by?: string;
+        changed_at?: string;
+    }>;
+    [key: string]: unknown;
+}
+/**
+ * Agent operations that live on the V2 platform or in analytics. Lifecycle
+ * and ownership go through Darwin because it checks the caller is the owner
+ * or an org admin; copilot only checks membership.
+ */
+export declare class AgentInsightsSDK {
+    private client;
+    constructor(client: IndemnClient);
+    detail(id: string): Promise<AgentDetail>;
+    setLifecycle(id: string, lifecycle: Lifecycle): Promise<AgentDetail>;
+    transferOwner(id: string, ownerId: string): Promise<AgentDetail>;
+    /** A compact description an AI can read before acting: `text` is one paragraph, otherwise skills and knowledge are listed. */
+    summary(id: string, opts?: {
+        text?: boolean;
+    }): Promise<unknown>;
+    /** Conversation metrics for one agent (org analytics filtered by agent). Default: the last 30 days. */
+    stats(id: string, opts?: {
+        from?: string;
+        to?: string;
+        channel?: 'web' | 'voice' | 'all';
+    }): Promise<unknown>;
 }
 //# sourceMappingURL=agents.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/sdk/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE5E,qBAAa,SAAS;IACR,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,YAAY;IAElC,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAM9B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAQpC,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC;IAOpD,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC;IAOhE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;CAM7C"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/sdk/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE5E,qBAAa,SAAS;IACR,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,YAAY;IAElC,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAM9B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAUpC,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC;IAQpD,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC;IAOhE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C,mFAAmF;IAC7E,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAKhD;;;;OAIG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO,GAAG,OAAO,CAAC,KAAK,CAAC;CAQhG;AAED,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,gGAAgG;AAChG,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,KAAK,CAAC;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD;;;;GAIG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,YAAY;IAExC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAIxC,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAIpE,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAIhE,8HAA8H;IAC9H,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpE,uGAAuG;IACvG,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,KAAK,CAAA;KAAO,GAAG,OAAO,CAAC,OAAO,CAAC;CAOlH"}

package/dist/sdk/agents.js

@@ -1,3 +1,4 @@
+import { CliError } from '../core/runtime.js';
 export class AgentsSDK {
     client;
     constructor(client) {
@@ -8,11 +9,16 @@ export class AgentsSDK {
     }
     async getAgent(id) {
         const result = await this.client.copilotGet(`/organization/:org_id/ai-studio/v2/bots/${id}`);
-        // v2 endpoint returns array even for single bot
-        return Array.isArray(result) ? result[0] : result;
+        // v2 endpoint returns array even for single bot; an empty one means deleted or not in this org
+        const agent = Array.isArray(result) ? result[0] : result;
+        if (!agent)
+            throw new CliError(`Agent ${id} was not found in this organization (deleted, or in another org).`);
+        return agent;
     }
     async createAgent(input) {
-        return this.client.copilotPost('/organization/:org_id/ai-studio/bots', { name: input.name, channels: input.channels || ['WEB'] });
+        return this.client.copilotPost('/organization/:org_id/ai-studio/bots', 
+        // copilot matches channel names exactly (WEB, VOICE, EMAIL) and fails on "voice".
+        { name: input.name, channels: (input.channels || ['WEB']).map((c) => c.toUpperCase()) });
     }
     async updateAgent(id, input) {
         return this.client.copilotPut(`/organization/:org_id/ai-studio/bots/${id}`, input);
@@ -20,8 +26,56 @@ export class AgentsSDK {
     async deleteAgent(id) {
         await this.client.copilotDelete(`/organization/:org_id/ai-studio/bots/${id}`);
     }
-    async cloneAgent(id) {
-        return this.client.copilotPost('/organization/:org_id/ai-studio/v2/bots/clone', { source_id_bot: id });
+    /** Agents in this org with the same name (case and surrounding spaces ignored). */
+    async findByName(name) {
+        const wanted = name.trim().toLowerCase();
+        return (await this.listAgents()).filter((a) => !a.trashed && (a.name ?? '').trim().toLowerCase() === wanted);
+    }
+    /**
+     * Copy an agent within the current org. copilot's clone route accepts a
+     * source from any org, so the source is first fetched through the org
+     * (copilot refuses an agent of another org) before cloning.
+     */
+    async cloneAgent(id, opts = {}) {
+        const source = await this.getAgent(id);
+        if (!source)
+            throw new Error(`Agent ${id} is not in this org.`);
+        return this.client.copilotPost('/organization/:org_id/ai-studio/v2/bots/clone', { source_id_bot: id, ...(opts.name ? { agent_name: opts.name } : {}), ...(opts.channels ? { channels: opts.channels.map((c) => c.toUpperCase()) } : {}) });
+    }
+}
+function isoDay(d) {
+    return d.toISOString().slice(0, 10);
+}
+/**
+ * Agent operations that live on the V2 platform or in analytics. Lifecycle
+ * and ownership go through Darwin because it checks the caller is the owner
+ * or an org admin; copilot only checks membership.
+ */
+export class AgentInsightsSDK {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    detail(id) {
+        return this.client.platformRequest('GET', `/v1-agents/${id}`);
+    }
+    setLifecycle(id, lifecycle) {
+        return this.client.platformRequest('PATCH', `/v1-agents/${id}/lifecycle`, { body: { lifecycle } });
+    }
+    transferOwner(id, ownerId) {
+        return this.client.platformRequest('PATCH', `/v1-agents/${id}/owner`, { body: { owner_id: ownerId } });
+    }
+    /** A compact description an AI can read before acting: `text` is one paragraph, otherwise skills and knowledge are listed. */
+    summary(id, opts = {}) {
+        return this.client.platformRequest('GET', `/v1-agents/${id}/summary${opts.text ? '/text' : ''}`);
+    }
+    /** Conversation metrics for one agent (org analytics filtered by agent). Default: the last 30 days. */
+    stats(id, opts = {}) {
+        const to = opts.to ?? isoDay(new Date());
+        const from = opts.from ?? isoDay(new Date(Date.now() - 30 * 86_400_000));
+        return this.client.copilotGet('/organization/:org_id/analytics/metrics', {
+            agent_id: id, date_from: from, date_to: to, channel: opts.channel ?? 'all',
+        });
     }
 }
 //# sourceMappingURL=agents.js.map

package/dist/sdk/agents.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/sdk/agents.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,SAAS;IACA;IAApB,YAAoB,MAAoB;QAApB,WAAM,GAAN,MAAM,CAAc;IAAG,CAAC;IAE5C,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAC3B,yCAAyC,CAC1C,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,EAAU;QACvB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CACzC,2CAA2C,EAAE,EAAE,CAChD,CAAC;QACF,gDAAgD;QAChD,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAuB;QACvC,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAC5B,sCAAsC,EACtC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,EAAE,CAC1D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,EAAU,EAAE,KAAuB;QACnD,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAC3B,wCAAwC,EAAE,EAAE,EAC5C,KAAK,CACN,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,EAAU;QAC1B,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAC7B,wCAAwC,EAAE,EAAE,CAC7C,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAU;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAC5B,+CAA+C,EAC/C,EAAE,aAAa,EAAE,EAAE,EAAE,CACtB,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/sdk/agents.ts"],"names":[],"mappings":"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"}

package/dist/sdk/analytics.d.ts

@@ -0,0 +1,158 @@
+import type { IndemnClient } from './client.js';
+export interface AnalyticsRange {
+    from?: string;
+    to?: string;
+    channel?: 'web' | 'voice' | 'all';
+    agentId?: string;
+}
+/** YYYY-MM-DD range, default the last 30 days; copilot refuses spans over 365 days. */
+export declare function rangeQuery(r: AnalyticsRange, opts?: {
+    withChannel?: boolean;
+    withAgent?: boolean;
+}): Record<string, string>;
+export type MetricKind = 'metrics' | 'model-performance' | 'model-performance/bots' | 'agent-volume' | 'handoff-precursors' | 'critical-feedback';
+/** The numbers the dashboard's analytics pages show. Test conversations are excluded by copilot. */
+export declare class AnalyticsSDK {
+    private client;
+    constructor(client: IndemnClient);
+    get(kind: MetricKind, range?: AnalyticsRange): Promise<unknown>;
+    /** Conversations behind a number, for example all with a given outcome (1-based pages, at most 200 rows). */
+    conversations(range: AnalyticsRange & {
+        dimension?: string;
+        value?: string;
+        search?: string;
+        page?: number;
+        pageSize?: number;
+    }): Promise<unknown>;
+    charts(): Promise<{
+        charts?: unknown[];
+    }>;
+    chart(id: string, range?: AnalyticsRange): Promise<unknown>;
+}
+export interface BusinessHours {
+    businessHoursEnabled: boolean;
+    businessHours?: Array<{
+        day: number;
+        slots: unknown[];
+    }>;
+    businessHoursUtterance?: string;
+}
+/**
+ * Org settings the dashboard lets members change: timezone, business hours,
+ * holidays. Handoff settings are read-only over the API. The route that
+ * deletes the whole configuration is deliberately never called.
+ */
+export declare class OrgSettingsSDK {
+    private client;
+    constructor(client: IndemnClient);
+    get(): Promise<Record<string, unknown>>;
+    /** Whether the org is inside business hours now. */
+    availability(): Promise<unknown>;
+    setTimezone(timezone: string): Promise<unknown>;
+    setBusinessHours(hours: BusinessHours): Promise<unknown>;
+    addHolidays(holidays: Array<{
+        name: string;
+        date: string;
+        type?: string;
+        holidayFallbackUtterance?: string;
+    }>): Promise<unknown>;
+    removeHolidays(dates: string[]): Promise<unknown>;
+    /** Indemn-only feature switches; copilot refuses anyone without an @indemn.ai login. */
+    setAdminSettings(settings: Record<string, unknown>): Promise<unknown>;
+    /** An Admin-tab change checked as the page checks it; reads the saved disclosure only when the change touches it. */
+    planAdmin(input: Record<string, unknown>): Promise<AdminPlan>;
+}
+/** The switches on the dashboard's Settings → Admin tab (org-settings.tsx), by the name the MCP tool takes. */
+export declare const ADMIN_SWITCHES: {
+    readonly conversation_summaries: {
+        readonly key: "summaryEnabled";
+        readonly label: "AI Conversation Summaries";
+    };
+    readonly canned_responses: {
+        readonly key: "cannedResponsesEnabled";
+        readonly label: "Canned Responses";
+    };
+    readonly indemn_branding: {
+        readonly key: "displayBranding";
+        readonly label: "Show Indemn Branding";
+    };
+    readonly underwriting_portal: {
+        readonly key: "enableUnderwritingPortal";
+        readonly label: "Underwriting Portal (Intake Manager)";
+    };
+    readonly smart_inbox: {
+        readonly key: "enableSmartInbox";
+        readonly label: "Smart Inbox";
+    };
+    readonly solutions: {
+        readonly key: "enableSolutions";
+        readonly label: "Solutions";
+    };
+    readonly tickets: {
+        readonly key: "enableTickets";
+        readonly label: "Tickets";
+    };
+    readonly agent_testing: {
+        readonly key: "enableAgentTesting";
+        readonly label: "Agent Testing Mode";
+    };
+    readonly composer_dictation: {
+        readonly key: "enableComposerDictation";
+        readonly label: "Composer Dictation";
+    };
+    readonly web_ai_disclosure: {
+        readonly key: "showAiDisclosureWeb";
+        readonly label: "Show Web AI Disclosure";
+    };
+};
+/** The conversation timers, in minutes here; copilot stores days and refuses less than these minimums (orgConfig.js). */
+export declare const ADMIN_TIMERS: {
+    readonly ongoing_to_ended_minutes: {
+        readonly key: "unassignedInactiveDays";
+        readonly label: "Ongoing → Ended";
+        readonly min: 1;
+    };
+    readonly ended_to_resolved_minutes: {
+        readonly key: "endedToResolvedDays";
+        readonly label: "Ended → Resolved";
+        readonly min: 10;
+    };
+    readonly resolved_to_archived_minutes: {
+        readonly key: "resolvedToArchivedDays";
+        readonly label: "Resolved → Archived";
+        readonly min: 1;
+    };
+};
+export interface AdminPlan {
+    /** The admin-settings body: real booleans, days for the timers, null for "the default". */
+    body: Record<string, unknown>;
+    /** The changes in the page's words, for the approval. */
+    changes: string[];
+}
+/** Refuses what the Admin tab refuses: nothing to change, a timer under its minimum, a disclosure shown without text. */
+export declare function planAdminSettings(input: Record<string, unknown>, saved?: Record<string, unknown>): AdminPlan;
+export interface AuditEntry {
+    _id?: string;
+    id_user?: string;
+    event_type?: string;
+    action?: string;
+    resource_type?: string;
+    resource_id?: string;
+    resource_display?: string;
+    status?: string;
+    createdAt?: string;
+    [key: string]: unknown;
+}
+/** Who changed what in the org. copilot returns the full history; filtering happens here. */
+export declare class AuditSDK {
+    private client;
+    constructor(client: IndemnClient);
+    list(filter?: {
+        since?: string;
+        action?: string;
+        resourceType?: string;
+        user?: string;
+        limit?: number;
+    }): Promise<AuditEntry[]>;
+}
+//# sourceMappingURL=analytics.d.ts.map

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

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