Your always-on AI coworkers that move between text, calls, and Slack.
TypeScript
import { z } from 'zod';
export interface ConnectionTool {
name: string;
title: string;
description: string;
inputSchema: Record<string, unknown>;
// The server's readOnlyHint. A hint only: approval is the owner's call.
readOnly: boolean;
enabled: boolean;
requiresApproval: boolean;
}
export interface Connection {
id: string;
dotId: string;
name: string;
url: string;
hasToken: boolean;
tools: ConnectionTool[];
error: string | null;
createdAt: number;
updatedAt: number;
}
export interface ConnectionActionResult {
isError: boolean;
text: string;
}
// What the owner reviews: the server's record of the exact connection,
// tool, and arguments, created when the Dot called the gated tool.
export interface PendingApproval {
id: string;
connection: string;
title: string;
description: string;
arguments: Record<string, unknown>;
expiresAt: number;
}
export const APPROVAL_TTL_MS = 60 * 60_000;
export const connectionActionSchema = z
.object({
approvalId: z.string().min(1).max(64),
summary: z.string().trim().min(1).max(500),
})
.strict();
export const connectionActionTool = {
name: 'request_connection_action',
description:
'Ask the owner to approve a connected-service action that changes something (sends, creates, updates, deletes). Use only after a connection tool returned approval_required. Pass its approvalId and a one-sentence summary of the effect. Call once, then wait: the result contains the service response if approved.',
parameters: z.toJSONSchema(connectionActionSchema),
};