@arbium/enterprise-agent-connect 0.1.2-dev.d2aa5ca → 0.2.1-dev.fd7a648

package/dist/packages/server/src/service.d.ts

@@ -1,8 +1,9 @@
 import { type Connector, type Provider } from "../../connector-kit/src/connector.js";
 import { type CredentialKey } from "./secrets.js";
 import type { AgentRow, ConnectionRow, Limits, ProviderRow, PublicConnection, Store } from "./store.js";
-import { type ToolContext, type Toolset } from "../../connector-kit/src/common.js";
+import { type Toolset } from "../../connector-kit/src/common.js";
 import type { TeamsAccess } from "./teams/runtime.js";
+import type { TeamsToolContext } from "../../../connectors/teams/tools.js";
 import type { BotRow } from "./teams/store.js";
 import { type ProviderClient, type Vendor, type VendorRequest } from "../../connector-kit/src/types.js";
 export type App = {
@@ -27,6 +28,7 @@ export type CheckResult = {
     label: string;
     values: string[];
     warning?: string;
+    labels?: Record<string, string>;
 };
 export declare class InvalidInput extends Error {
 }
@@ -42,6 +44,8 @@ export declare function createService(deps: {
     providers?: ProviderApp[];
     store: Store;
     key: CredentialKey;
+    internalApp?: (connector: Connector) => App;
+    reservedIds?: Iterable<string>;
     bots?: {
         botForAgent(org: string, agentId: string): Promise<BotRow | null>;
         access(bot: BotRow): TeamsAccess;
@@ -68,7 +72,7 @@ export declare function createService(deps: {
             certificate?: boolean | undefined;
             click?: string[] | undefined;
             clickUnavailable?: true | undefined;
-            siteRole?: "write" | "read" | undefined;
+            siteRole?: "read" | "write" | undefined;
             agentCheck?: boolean | undefined;
             confirm?: string | undefined;
             live?: string | undefined;
@@ -83,6 +87,7 @@ export declare function createService(deps: {
                 field: string;
                 value: string;
             } | undefined;
+            capabilities?: string[] | undefined;
         }[];
         afterConnect: {
             title: string;
@@ -97,7 +102,7 @@ export declare function createService(deps: {
             certificate?: boolean | undefined;
             click?: string[] | undefined;
             clickUnavailable?: true | undefined;
-            siteRole?: "write" | "read" | undefined;
+            siteRole?: "read" | "write" | undefined;
             agentCheck?: boolean | undefined;
             confirm?: string | undefined;
             live?: string | undefined;
@@ -112,11 +117,13 @@ export declare function createService(deps: {
                 field: string;
                 value: string;
             } | undefined;
+            capabilities?: string[] | undefined;
         }[];
         fields: {
             id: string;
             label: string;
             secret: boolean;
+            optional: boolean;
             help?: string | undefined;
             placeholder?: string | undefined;
             options?: {
@@ -160,6 +167,7 @@ export declare function createService(deps: {
             path: string;
             label: string;
             show: string;
+            name?: string | undefined;
             match?: Record<string, string | number | boolean> | undefined;
             body?: Record<string, unknown> | undefined;
             ifEmpty?: string | undefined;
@@ -187,7 +195,7 @@ export declare function createService(deps: {
                 certificate?: boolean | undefined;
                 click?: string[] | undefined;
                 clickUnavailable?: true | undefined;
-                siteRole?: "write" | "read" | undefined;
+                siteRole?: "read" | "write" | undefined;
                 agentCheck?: boolean | undefined;
                 confirm?: string | undefined;
                 live?: string | undefined;
@@ -226,6 +234,7 @@ export declare function createService(deps: {
             path: string;
             label: string;
             show: string;
+            name?: string | undefined;
             match?: Record<string, string | number | boolean> | undefined;
             body?: Record<string, unknown> | undefined;
             ifEmpty?: string | undefined;
@@ -268,7 +277,7 @@ export declare function createService(deps: {
                 params: Record<string, {
                     type: "string" | "number" | "boolean" | "array" | "integer";
                     description: string;
-                    in: "path" | "body" | "query";
+                    in: "body" | "path" | "query";
                     required: boolean;
                     name?: string | undefined;
                     default?: string | number | boolean | (string | number | boolean)[] | undefined;
@@ -383,14 +392,14 @@ export declare function createService(deps: {
                 description: string;
                 kind: "function" | "list" | "get" | "create" | "update" | "action";
                 key: Record<string, {
-                    type: "string" | "number" | "boolean" | "integer" | "decimal" | "guid" | "datetime" | "datetimeoffset";
+                    type: "string" | "number" | "boolean" | "guid" | "integer" | "decimal" | "datetime" | "datetimeoffset";
                     description: string;
                     property?: string | undefined;
                     required?: boolean | undefined;
                     limit?: string | undefined;
                 }>;
                 filters: Record<string, {
-                    type: "string" | "number" | "boolean" | "integer" | "decimal" | "guid" | "datetime" | "datetimeoffset";
+                    type: "string" | "number" | "boolean" | "guid" | "integer" | "decimal" | "datetime" | "datetimeoffset";
                     description: string;
                     op: "eq" | "ne" | "gt" | "ge" | "lt" | "le" | "contains" | "startswith";
                     property?: string | undefined;
@@ -398,14 +407,14 @@ export declare function createService(deps: {
                     limit?: string | undefined;
                 }>;
                 fields: Record<string, {
-                    type: "string" | "number" | "boolean" | "integer" | "decimal" | "guid" | "datetime" | "datetimeoffset";
+                    type: "string" | "number" | "boolean" | "guid" | "integer" | "decimal" | "datetime" | "datetimeoffset";
                     description: string;
                     property?: string | undefined;
                     required?: boolean | undefined;
                     limit?: string | undefined;
                 }>;
                 params: Record<string, {
-                    type: "string" | "number" | "boolean" | "integer" | "decimal" | "guid" | "datetime" | "datetimeoffset";
+                    type: "string" | "number" | "boolean" | "guid" | "integer" | "decimal" | "datetime" | "datetimeoffset";
                     description: string;
                     property?: string | undefined;
                     required?: boolean | undefined;
@@ -491,7 +500,7 @@ export declare function createService(deps: {
                     certificate?: boolean | undefined;
                     click?: string[] | undefined;
                     clickUnavailable?: true | undefined;
-                    siteRole?: "write" | "read" | undefined;
+                    siteRole?: "read" | "write" | undefined;
                     agentCheck?: boolean | undefined;
                     confirm?: string | undefined;
                     live?: string | undefined;
@@ -548,13 +557,1102 @@ export declare function createService(deps: {
                 deliveryId: string[];
                 types: {
                     type: string;
-                    same?: [string, string] | undefined;
+                    since?: string | undefined;
                 }[];
                 filter?: string | undefined;
                 wrap?: string | undefined;
             } | undefined;
         } | undefined;
     }[];
+    connectorsFor(org: string): Promise<{
+        id: string;
+        name: string;
+        description: string;
+        logo: string;
+        identity: string;
+        connectionKind: "guided";
+        accountKey: string;
+        setup: {
+            title: string;
+            body: string;
+            link?: {
+                label: string;
+                href: string;
+            } | undefined;
+            copy?: string[] | undefined;
+            shell?: "bash" | "powershell" | undefined;
+            permissions?: boolean | undefined;
+            certificate?: boolean | undefined;
+            click?: string[] | undefined;
+            clickUnavailable?: true | undefined;
+            siteRole?: "read" | "write" | undefined;
+            agentCheck?: boolean | undefined;
+            confirm?: string | undefined;
+            live?: string | undefined;
+            settings?: {
+                id: string;
+                label: string;
+                pattern: string;
+                help?: string | undefined;
+                placeholder?: string | undefined;
+            }[] | undefined;
+            option?: {
+                field: string;
+                value: string;
+            } | undefined;
+            capabilities?: string[] | undefined;
+        }[];
+        afterConnect: {
+            title: string;
+            body: string;
+            link?: {
+                label: string;
+                href: string;
+            } | undefined;
+            copy?: string[] | undefined;
+            shell?: "bash" | "powershell" | undefined;
+            permissions?: boolean | undefined;
+            certificate?: boolean | undefined;
+            click?: string[] | undefined;
+            clickUnavailable?: true | undefined;
+            siteRole?: "read" | "write" | undefined;
+            agentCheck?: boolean | undefined;
+            confirm?: string | undefined;
+            live?: string | undefined;
+            settings?: {
+                id: string;
+                label: string;
+                pattern: string;
+                help?: string | undefined;
+                placeholder?: string | undefined;
+            }[] | undefined;
+            option?: {
+                field: string;
+                value: string;
+            } | undefined;
+            capabilities?: string[] | undefined;
+        }[];
+        fields: {
+            id: string;
+            label: string;
+            secret: boolean;
+            optional: boolean;
+            help?: string | undefined;
+            placeholder?: string | undefined;
+            options?: {
+                value: string;
+                label: string;
+                description: string;
+                scopes?: string[] | undefined;
+            }[] | undefined;
+            requires?: {
+                field: string;
+                value: string;
+            } | undefined;
+        }[];
+        capabilities: {
+            id: string;
+            label: string;
+            description: string;
+            required: boolean;
+            destructive: boolean;
+            scopes: string[];
+            permissions: string[];
+            tools: string[];
+            costs?: boolean | undefined;
+            roles?: string[] | undefined;
+            fill?: Record<string, string> | undefined;
+            note?: string | undefined;
+            forbidden?: string | undefined;
+            claudeKey?: boolean | undefined;
+        }[];
+        limits: {
+            id: string;
+            label: string;
+            help: string;
+            kind: "text" | "map" | "list";
+            required: boolean;
+            pattern?: string | undefined;
+            keys?: string | undefined;
+        }[];
+        verify: {
+            method: "GET" | "POST";
+            path: string;
+            label: string;
+            show: string;
+            name?: string | undefined;
+            match?: Record<string, string | number | boolean> | undefined;
+            body?: Record<string, unknown> | undefined;
+            ifEmpty?: string | undefined;
+        } | {
+            label: string;
+            check: string;
+            ifEmpty?: string | undefined;
+        };
+        revoke: string;
+        signsInAs?: "agentBot" | undefined;
+        provider?: string | undefined;
+        order?: number | undefined;
+        scopes?: string[] | undefined;
+        siteAccess?: {
+            grant: {
+                title: string;
+                body: string;
+                link?: {
+                    label: string;
+                    href: string;
+                } | undefined;
+                copy?: string[] | undefined;
+                shell?: "bash" | "powershell" | undefined;
+                permissions?: boolean | undefined;
+                certificate?: boolean | undefined;
+                click?: string[] | undefined;
+                clickUnavailable?: true | undefined;
+                siteRole?: "read" | "write" | undefined;
+                agentCheck?: boolean | undefined;
+                confirm?: string | undefined;
+                live?: string | undefined;
+                settings?: {
+                    id: string;
+                    label: string;
+                    pattern: string;
+                    help?: string | undefined;
+                    placeholder?: string | undefined;
+                }[] | undefined;
+                option?: {
+                    field: string;
+                    value: string;
+                } | undefined;
+            }[];
+            request: string;
+            write: string[];
+        } | undefined;
+        agentAccess?: {
+            limit: string;
+            label: string;
+            path: string;
+            granted: string;
+            notGranted: string;
+            notFound: string;
+            probes: Record<string, {
+                method: "GET" | "POST" | "PATCH";
+                path: string;
+                allowed: number[];
+                body?: unknown;
+            }>;
+            missing?: string | undefined;
+        } | undefined;
+        discover?: {
+            method: "GET" | "POST";
+            path: string;
+            label: string;
+            show: string;
+            name?: string | undefined;
+            match?: Record<string, string | number | boolean> | undefined;
+            body?: Record<string, unknown> | undefined;
+            ifEmpty?: string | undefined;
+        } | {
+            label: string;
+            check: string;
+            ifEmpty?: string | undefined;
+        } | undefined;
+        http?: {
+            baseUrl: string;
+            auth: {
+                type: "header";
+                header: string;
+                value: string;
+                prefix?: string | undefined;
+            } | {
+                type: "bearer";
+                token: string;
+            } | {
+                type: "basic";
+                username: string;
+                password: string;
+            } | {
+                type: "oauth2";
+                tokenUrl: string;
+                clientId: string;
+                clientSecret: string;
+                scope?: string | undefined;
+            } | {
+                type: "query";
+                param: string;
+                value: string;
+            };
+            headers: Record<string, string>;
+            tools: {
+                name: string;
+                description: string;
+                method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+                path: string;
+                params: Record<string, {
+                    type: "string" | "number" | "boolean" | "array" | "integer";
+                    description: string;
+                    in: "body" | "path" | "query";
+                    required: boolean;
+                    name?: string | undefined;
+                    default?: string | number | boolean | (string | number | boolean)[] | undefined;
+                    enum?: (string | number | boolean)[] | undefined;
+                    items?: "string" | "number" | "boolean" | "integer" | undefined;
+                    join?: string | undefined;
+                    limit?: string | undefined;
+                }>;
+                destructive: boolean;
+                answerLimits: {
+                    field: string;
+                    limit: string;
+                }[];
+                result?: {
+                    items?: string | undefined;
+                    fields?: string[] | undefined;
+                } | undefined;
+                paging?: {
+                    param: string;
+                    body: string;
+                } | {
+                    param: string;
+                    header: string;
+                } | {
+                    param: string;
+                    link: true;
+                } | undefined;
+            }[];
+            allowInsecureHttp: boolean;
+        } | undefined;
+        soap?: {
+            endpoint: string;
+            version: "1.1" | "1.2";
+            namespaces: Record<string, string>;
+            tools: {
+                name: string;
+                description: string;
+                operation: string;
+                body: string;
+                params: Record<string, {
+                    type: "string" | "number" | "boolean" | "integer";
+                    description: string;
+                    required: boolean;
+                    limit?: string | undefined;
+                }>;
+                readOnly: boolean;
+                destructive: boolean;
+                answerLimits: {
+                    field: string;
+                    limit: string;
+                }[];
+                soapAction?: string | undefined;
+                result?: string | undefined;
+                fields?: string[] | undefined;
+            }[];
+            allowInsecureHttp: boolean;
+            auth?: {
+                type: "header";
+                header: string;
+                value: string;
+                prefix?: string | undefined;
+            } | {
+                type: "bearer";
+                token: string;
+            } | {
+                type: "basic";
+                username: string;
+                password: string;
+            } | undefined;
+            wsSecurity?: {
+                username: string;
+                password: string;
+                digest: boolean;
+            } | undefined;
+            verify?: {
+                tool: string;
+                args: Record<string, string | number | boolean>;
+                show: string;
+            } | undefined;
+        } | undefined;
+        odata?: {
+            serviceRoot: string;
+            version: "2" | "4";
+            auth: {
+                type: "header";
+                header: string;
+                value: string;
+                prefix?: string | undefined;
+            } | {
+                type: "bearer";
+                token: string;
+            } | {
+                type: "basic";
+                username: string;
+                password: string;
+            } | {
+                type: "oauth2";
+                tokenUrl: string;
+                clientId: string;
+                clientSecret: string;
+                scope?: string | undefined;
+            } | {
+                type: "query";
+                param: string;
+                value: string;
+            };
+            headers: Record<string, string>;
+            csrf: boolean;
+            paging: "skip" | "server";
+            tools: {
+                name: string;
+                description: string;
+                kind: "function" | "list" | "get" | "create" | "update" | "action";
+                key: Record<string, {
+                    type: "string" | "number" | "boolean" | "guid" | "integer" | "decimal" | "datetime" | "datetimeoffset";
+                    description: string;
+                    property?: string | undefined;
+                    required?: boolean | undefined;
+                    limit?: string | undefined;
+                }>;
+                filters: Record<string, {
+                    type: "string" | "number" | "boolean" | "guid" | "integer" | "decimal" | "datetime" | "datetimeoffset";
+                    description: string;
+                    op: "eq" | "ne" | "gt" | "ge" | "lt" | "le" | "contains" | "startswith";
+                    property?: string | undefined;
+                    required?: boolean | undefined;
+                    limit?: string | undefined;
+                }>;
+                fields: Record<string, {
+                    type: "string" | "number" | "boolean" | "guid" | "integer" | "decimal" | "datetime" | "datetimeoffset";
+                    description: string;
+                    property?: string | undefined;
+                    required?: boolean | undefined;
+                    limit?: string | undefined;
+                }>;
+                params: Record<string, {
+                    type: "string" | "number" | "boolean" | "guid" | "integer" | "decimal" | "datetime" | "datetimeoffset";
+                    description: string;
+                    property?: string | undefined;
+                    required?: boolean | undefined;
+                    limit?: string | undefined;
+                }>;
+                select: string[];
+                top: number;
+                destructive: boolean;
+                answerLimits: {
+                    field: string;
+                    limit: string;
+                }[];
+                entitySet?: string | undefined;
+                function?: string | undefined;
+                orderBy?: string | undefined;
+            }[];
+            allowInsecureHttp: boolean;
+        } | undefined;
+        sql?: {
+            engine: "postgres" | "sqlserver" | "mysql" | "oracle";
+            host: string;
+            database: string;
+            auth: {
+                user: string;
+                password: string;
+            };
+            tls: "verify" | "insecure" | "off";
+            timeoutSeconds: number;
+            maxRows: number;
+            tools: {
+                name: string;
+                description: string;
+                sql: string;
+                params: Record<string, {
+                    type: "string" | "number" | "boolean" | "integer";
+                    description: string;
+                    required: boolean;
+                    limit?: string | undefined;
+                }>;
+                write: boolean;
+                destructive: boolean;
+                answerLimits: {
+                    column: string;
+                    limit: string;
+                }[];
+            }[];
+            port?: number | undefined;
+        } | undefined;
+        events?: {
+            types: {
+                id: string;
+                label: string;
+            }[];
+            fields: Record<string, string>;
+            limits: Record<string, string>;
+            webhook?: {
+                verify: {
+                    type: "hmac-sha256";
+                    header: string;
+                    prefix: string;
+                } | {
+                    type: "token";
+                    header: string;
+                } | {
+                    type: "none";
+                };
+                allowInsecure: boolean;
+                type: {
+                    field: string;
+                } | {
+                    header: string;
+                };
+                setup: {
+                    title: string;
+                    body: string;
+                    link?: {
+                        label: string;
+                        href: string;
+                    } | undefined;
+                    copy?: string[] | undefined;
+                    shell?: "bash" | "powershell" | undefined;
+                    permissions?: boolean | undefined;
+                    certificate?: boolean | undefined;
+                    click?: string[] | undefined;
+                    clickUnavailable?: true | undefined;
+                    siteRole?: "read" | "write" | undefined;
+                    agentCheck?: boolean | undefined;
+                    confirm?: string | undefined;
+                    live?: string | undefined;
+                    settings?: {
+                        id: string;
+                        label: string;
+                        pattern: string;
+                        help?: string | undefined;
+                        placeholder?: string | undefined;
+                    }[] | undefined;
+                    option?: {
+                        field: string;
+                        value: string;
+                    } | undefined;
+                }[];
+                deliveryId?: {
+                    field: string;
+                } | {
+                    header: string;
+                } | undefined;
+                timestamp?: {
+                    at: {
+                        field: string;
+                    } | {
+                        header: string;
+                    };
+                    unit: "s" | "ms" | "iso";
+                    toleranceSeconds: number;
+                } | undefined;
+                register?: {
+                    method: "GET" | "POST" | "PUT";
+                    path: string;
+                    location: string;
+                    body?: unknown;
+                } | undefined;
+            } | undefined;
+            self?: {
+                request: {
+                    method: "GET" | "POST" | "PUT";
+                    path: string;
+                    body?: unknown;
+                };
+                id: string;
+                fields: string[];
+            } | undefined;
+            poll?: {
+                request: {
+                    method: "GET" | "POST" | "PUT";
+                    path: string;
+                    body?: unknown;
+                };
+                items: string;
+                cursor: string;
+                deliveryId: string[];
+                types: {
+                    type: string;
+                    since?: string | undefined;
+                }[];
+                filter?: string | undefined;
+                wrap?: string | undefined;
+            } | undefined;
+        } | undefined;
+    }[]>;
+    listInternalApps(org: string): Promise<({
+        problem: null;
+        id: string;
+        organizationId: string;
+        definition: Record<string, unknown>;
+        createdBy: string;
+        createdAt: string;
+        updatedBy: string;
+        updatedAt: string;
+    } | {
+        problem: string;
+        id: string;
+        organizationId: string;
+        definition: Record<string, unknown>;
+        createdBy: string;
+        createdAt: string;
+        updatedBy: string;
+        updatedAt: string;
+    })[]>;
+    getInternalApp(org: string, id: string): Promise<{
+        problem: null;
+        id: string;
+        organizationId: string;
+        definition: Record<string, unknown>;
+        createdBy: string;
+        createdAt: string;
+        updatedBy: string;
+        updatedAt: string;
+    } | {
+        problem: string;
+        id: string;
+        organizationId: string;
+        definition: Record<string, unknown>;
+        createdBy: string;
+        createdAt: string;
+        updatedBy: string;
+        updatedAt: string;
+    } | null>;
+    saveInternalApp(org: string, id: string, definition: Record<string, unknown>, by: string): Promise<{
+        app: {
+            problem: null;
+            id: string;
+            organizationId: string;
+            definition: Record<string, unknown>;
+            createdBy: string;
+            createdAt: string;
+            updatedBy: string;
+            updatedAt: string;
+        } | {
+            problem: string;
+            id: string;
+            organizationId: string;
+            definition: Record<string, unknown>;
+            createdBy: string;
+            createdAt: string;
+            updatedBy: string;
+            updatedAt: string;
+        };
+        connector: {
+            id: string;
+            name: string;
+            description: string;
+            logo: string;
+            identity: string;
+            connectionKind: "guided";
+            accountKey: string;
+            setup: {
+                title: string;
+                body: string;
+                link?: {
+                    label: string;
+                    href: string;
+                } | undefined;
+                copy?: string[] | undefined;
+                shell?: "bash" | "powershell" | undefined;
+                permissions?: boolean | undefined;
+                certificate?: boolean | undefined;
+                click?: string[] | undefined;
+                clickUnavailable?: true | undefined;
+                siteRole?: "read" | "write" | undefined;
+                agentCheck?: boolean | undefined;
+                confirm?: string | undefined;
+                live?: string | undefined;
+                settings?: {
+                    id: string;
+                    label: string;
+                    pattern: string;
+                    help?: string | undefined;
+                    placeholder?: string | undefined;
+                }[] | undefined;
+                option?: {
+                    field: string;
+                    value: string;
+                } | undefined;
+                capabilities?: string[] | undefined;
+            }[];
+            afterConnect: {
+                title: string;
+                body: string;
+                link?: {
+                    label: string;
+                    href: string;
+                } | undefined;
+                copy?: string[] | undefined;
+                shell?: "bash" | "powershell" | undefined;
+                permissions?: boolean | undefined;
+                certificate?: boolean | undefined;
+                click?: string[] | undefined;
+                clickUnavailable?: true | undefined;
+                siteRole?: "read" | "write" | undefined;
+                agentCheck?: boolean | undefined;
+                confirm?: string | undefined;
+                live?: string | undefined;
+                settings?: {
+                    id: string;
+                    label: string;
+                    pattern: string;
+                    help?: string | undefined;
+                    placeholder?: string | undefined;
+                }[] | undefined;
+                option?: {
+                    field: string;
+                    value: string;
+                } | undefined;
+                capabilities?: string[] | undefined;
+            }[];
+            fields: {
+                id: string;
+                label: string;
+                secret: boolean;
+                optional: boolean;
+                help?: string | undefined;
+                placeholder?: string | undefined;
+                options?: {
+                    value: string;
+                    label: string;
+                    description: string;
+                    scopes?: string[] | undefined;
+                }[] | undefined;
+                requires?: {
+                    field: string;
+                    value: string;
+                } | undefined;
+            }[];
+            capabilities: {
+                id: string;
+                label: string;
+                description: string;
+                required: boolean;
+                destructive: boolean;
+                scopes: string[];
+                permissions: string[];
+                tools: string[];
+                costs?: boolean | undefined;
+                roles?: string[] | undefined;
+                fill?: Record<string, string> | undefined;
+                note?: string | undefined;
+                forbidden?: string | undefined;
+                claudeKey?: boolean | undefined;
+            }[];
+            limits: {
+                id: string;
+                label: string;
+                help: string;
+                kind: "text" | "map" | "list";
+                required: boolean;
+                pattern?: string | undefined;
+                keys?: string | undefined;
+            }[];
+            verify: {
+                method: "GET" | "POST";
+                path: string;
+                label: string;
+                show: string;
+                name?: string | undefined;
+                match?: Record<string, string | number | boolean> | undefined;
+                body?: Record<string, unknown> | undefined;
+                ifEmpty?: string | undefined;
+            } | {
+                label: string;
+                check: string;
+                ifEmpty?: string | undefined;
+            };
+            revoke: string;
+            signsInAs?: "agentBot" | undefined;
+            provider?: string | undefined;
+            order?: number | undefined;
+            scopes?: string[] | undefined;
+            siteAccess?: {
+                grant: {
+                    title: string;
+                    body: string;
+                    link?: {
+                        label: string;
+                        href: string;
+                    } | undefined;
+                    copy?: string[] | undefined;
+                    shell?: "bash" | "powershell" | undefined;
+                    permissions?: boolean | undefined;
+                    certificate?: boolean | undefined;
+                    click?: string[] | undefined;
+                    clickUnavailable?: true | undefined;
+                    siteRole?: "read" | "write" | undefined;
+                    agentCheck?: boolean | undefined;
+                    confirm?: string | undefined;
+                    live?: string | undefined;
+                    settings?: {
+                        id: string;
+                        label: string;
+                        pattern: string;
+                        help?: string | undefined;
+                        placeholder?: string | undefined;
+                    }[] | undefined;
+                    option?: {
+                        field: string;
+                        value: string;
+                    } | undefined;
+                }[];
+                request: string;
+                write: string[];
+            } | undefined;
+            agentAccess?: {
+                limit: string;
+                label: string;
+                path: string;
+                granted: string;
+                notGranted: string;
+                notFound: string;
+                probes: Record<string, {
+                    method: "GET" | "POST" | "PATCH";
+                    path: string;
+                    allowed: number[];
+                    body?: unknown;
+                }>;
+                missing?: string | undefined;
+            } | undefined;
+            discover?: {
+                method: "GET" | "POST";
+                path: string;
+                label: string;
+                show: string;
+                name?: string | undefined;
+                match?: Record<string, string | number | boolean> | undefined;
+                body?: Record<string, unknown> | undefined;
+                ifEmpty?: string | undefined;
+            } | {
+                label: string;
+                check: string;
+                ifEmpty?: string | undefined;
+            } | undefined;
+            http?: {
+                baseUrl: string;
+                auth: {
+                    type: "header";
+                    header: string;
+                    value: string;
+                    prefix?: string | undefined;
+                } | {
+                    type: "bearer";
+                    token: string;
+                } | {
+                    type: "basic";
+                    username: string;
+                    password: string;
+                } | {
+                    type: "oauth2";
+                    tokenUrl: string;
+                    clientId: string;
+                    clientSecret: string;
+                    scope?: string | undefined;
+                } | {
+                    type: "query";
+                    param: string;
+                    value: string;
+                };
+                headers: Record<string, string>;
+                tools: {
+                    name: string;
+                    description: string;
+                    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+                    path: string;
+                    params: Record<string, {
+                        type: "string" | "number" | "boolean" | "array" | "integer";
+                        description: string;
+                        in: "body" | "path" | "query";
+                        required: boolean;
+                        name?: string | undefined;
+                        default?: string | number | boolean | (string | number | boolean)[] | undefined;
+                        enum?: (string | number | boolean)[] | undefined;
+                        items?: "string" | "number" | "boolean" | "integer" | undefined;
+                        join?: string | undefined;
+                        limit?: string | undefined;
+                    }>;
+                    destructive: boolean;
+                    answerLimits: {
+                        field: string;
+                        limit: string;
+                    }[];
+                    result?: {
+                        items?: string | undefined;
+                        fields?: string[] | undefined;
+                    } | undefined;
+                    paging?: {
+                        param: string;
+                        body: string;
+                    } | {
+                        param: string;
+                        header: string;
+                    } | {
+                        param: string;
+                        link: true;
+                    } | undefined;
+                }[];
+                allowInsecureHttp: boolean;
+            } | undefined;
+            soap?: {
+                endpoint: string;
+                version: "1.1" | "1.2";
+                namespaces: Record<string, string>;
+                tools: {
+                    name: string;
+                    description: string;
+                    operation: string;
+                    body: string;
+                    params: Record<string, {
+                        type: "string" | "number" | "boolean" | "integer";
+                        description: string;
+                        required: boolean;
+                        limit?: string | undefined;
+                    }>;
+                    readOnly: boolean;
+                    destructive: boolean;
+                    answerLimits: {
+                        field: string;
+                        limit: string;
+                    }[];
+                    soapAction?: string | undefined;
+                    result?: string | undefined;
+                    fields?: string[] | undefined;
+                }[];
+                allowInsecureHttp: boolean;
+                auth?: {
+                    type: "header";
+                    header: string;
+                    value: string;
+                    prefix?: string | undefined;
+                } | {
+                    type: "bearer";
+                    token: string;
+                } | {
+                    type: "basic";
+                    username: string;
+                    password: string;
+                } | undefined;
+                wsSecurity?: {
+                    username: string;
+                    password: string;
+                    digest: boolean;
+                } | undefined;
+                verify?: {
+                    tool: string;
+                    args: Record<string, string | number | boolean>;
+                    show: string;
+                } | undefined;
+            } | undefined;
+            odata?: {
+                serviceRoot: string;
+                version: "2" | "4";
+                auth: {
+                    type: "header";
+                    header: string;
+                    value: string;
+                    prefix?: string | undefined;
+                } | {
+                    type: "bearer";
+                    token: string;
+                } | {
+                    type: "basic";
+                    username: string;
+                    password: string;
+                } | {
+                    type: "oauth2";
+                    tokenUrl: string;
+                    clientId: string;
+                    clientSecret: string;
+                    scope?: string | undefined;
+                } | {
+                    type: "query";
+                    param: string;
+                    value: string;
+                };
+                headers: Record<string, string>;
+                csrf: boolean;
+                paging: "skip" | "server";
+                tools: {
+                    name: string;
+                    description: string;
+                    kind: "function" | "list" | "get" | "create" | "update" | "action";
+                    key: Record<string, {
+                        type: "string" | "number" | "boolean" | "guid" | "integer" | "decimal" | "datetime" | "datetimeoffset";
+                        description: string;
+                        property?: string | undefined;
+                        required?: boolean | undefined;
+                        limit?: string | undefined;
+                    }>;
+                    filters: Record<string, {
+                        type: "string" | "number" | "boolean" | "guid" | "integer" | "decimal" | "datetime" | "datetimeoffset";
+                        description: string;
+                        op: "eq" | "ne" | "gt" | "ge" | "lt" | "le" | "contains" | "startswith";
+                        property?: string | undefined;
+                        required?: boolean | undefined;
+                        limit?: string | undefined;
+                    }>;
+                    fields: Record<string, {
+                        type: "string" | "number" | "boolean" | "guid" | "integer" | "decimal" | "datetime" | "datetimeoffset";
+                        description: string;
+                        property?: string | undefined;
+                        required?: boolean | undefined;
+                        limit?: string | undefined;
+                    }>;
+                    params: Record<string, {
+                        type: "string" | "number" | "boolean" | "guid" | "integer" | "decimal" | "datetime" | "datetimeoffset";
+                        description: string;
+                        property?: string | undefined;
+                        required?: boolean | undefined;
+                        limit?: string | undefined;
+                    }>;
+                    select: string[];
+                    top: number;
+                    destructive: boolean;
+                    answerLimits: {
+                        field: string;
+                        limit: string;
+                    }[];
+                    entitySet?: string | undefined;
+                    function?: string | undefined;
+                    orderBy?: string | undefined;
+                }[];
+                allowInsecureHttp: boolean;
+            } | undefined;
+            sql?: {
+                engine: "postgres" | "sqlserver" | "mysql" | "oracle";
+                host: string;
+                database: string;
+                auth: {
+                    user: string;
+                    password: string;
+                };
+                tls: "verify" | "insecure" | "off";
+                timeoutSeconds: number;
+                maxRows: number;
+                tools: {
+                    name: string;
+                    description: string;
+                    sql: string;
+                    params: Record<string, {
+                        type: "string" | "number" | "boolean" | "integer";
+                        description: string;
+                        required: boolean;
+                        limit?: string | undefined;
+                    }>;
+                    write: boolean;
+                    destructive: boolean;
+                    answerLimits: {
+                        column: string;
+                        limit: string;
+                    }[];
+                }[];
+                port?: number | undefined;
+            } | undefined;
+            events?: {
+                types: {
+                    id: string;
+                    label: string;
+                }[];
+                fields: Record<string, string>;
+                limits: Record<string, string>;
+                webhook?: {
+                    verify: {
+                        type: "hmac-sha256";
+                        header: string;
+                        prefix: string;
+                    } | {
+                        type: "token";
+                        header: string;
+                    } | {
+                        type: "none";
+                    };
+                    allowInsecure: boolean;
+                    type: {
+                        field: string;
+                    } | {
+                        header: string;
+                    };
+                    setup: {
+                        title: string;
+                        body: string;
+                        link?: {
+                            label: string;
+                            href: string;
+                        } | undefined;
+                        copy?: string[] | undefined;
+                        shell?: "bash" | "powershell" | undefined;
+                        permissions?: boolean | undefined;
+                        certificate?: boolean | undefined;
+                        click?: string[] | undefined;
+                        clickUnavailable?: true | undefined;
+                        siteRole?: "read" | "write" | undefined;
+                        agentCheck?: boolean | undefined;
+                        confirm?: string | undefined;
+                        live?: string | undefined;
+                        settings?: {
+                            id: string;
+                            label: string;
+                            pattern: string;
+                            help?: string | undefined;
+                            placeholder?: string | undefined;
+                        }[] | undefined;
+                        option?: {
+                            field: string;
+                            value: string;
+                        } | undefined;
+                    }[];
+                    deliveryId?: {
+                        field: string;
+                    } | {
+                        header: string;
+                    } | undefined;
+                    timestamp?: {
+                        at: {
+                            field: string;
+                        } | {
+                            header: string;
+                        };
+                        unit: "s" | "ms" | "iso";
+                        toleranceSeconds: number;
+                    } | undefined;
+                    register?: {
+                        method: "GET" | "POST" | "PUT";
+                        path: string;
+                        location: string;
+                        body?: unknown;
+                    } | undefined;
+                } | undefined;
+                self?: {
+                    request: {
+                        method: "GET" | "POST" | "PUT";
+                        path: string;
+                        body?: unknown;
+                    };
+                    id: string;
+                    fields: string[];
+                } | undefined;
+                poll?: {
+                    request: {
+                        method: "GET" | "POST" | "PUT";
+                        path: string;
+                        body?: unknown;
+                    };
+                    items: string;
+                    cursor: string;
+                    deliveryId: string[];
+                    types: {
+                        type: string;
+                        since?: string | undefined;
+                    }[];
+                    filter?: string | undefined;
+                    wrap?: string | undefined;
+                } | undefined;
+            } | undefined;
+        };
+        created: boolean;
+        disconnected: boolean;
+        grantsRemoved: string[];
+    }>;
+    deleteInternalApp(org: string, id: string, by: string): Promise<boolean>;
     providers: () => {
         approval: boolean;
         id: string;
@@ -577,7 +1675,7 @@ export declare function createService(deps: {
             certificate?: boolean | undefined;
             click?: string[] | undefined;
             clickUnavailable?: true | undefined;
-            siteRole?: "write" | "read" | undefined;
+            siteRole?: "read" | "write" | undefined;
             agentCheck?: boolean | undefined;
             confirm?: string | undefined;
             live?: string | undefined;
@@ -625,7 +1723,7 @@ export declare function createService(deps: {
             certificate?: boolean | undefined;
             click?: string[] | undefined;
             clickUnavailable?: true | undefined;
-            siteRole?: "write" | "read" | undefined;
+            siteRole?: "read" | "write" | undefined;
             agentCheck?: boolean | undefined;
             confirm?: string | undefined;
             live?: string | undefined;
@@ -750,11 +1848,12 @@ export declare function createService(deps: {
         agent: AgentRow;
         toolsets: {
             toolset: Toolset;
-            ctx: ToolContext;
+            ctx: TeamsToolContext;
             allowed: Set<string>;
         }[];
         refuseUngranted(tool: string, args: unknown): Promise<void>;
     } | null>;
 };
+export declare function plainParseError(message: string): string;
 export type Service = ReturnType<typeof createService>;
 export {};