@credal/actions 0.1.98 → 0.1.100

package/dist/actions/providers/google-oauth/listCalendars.js

@@ -0,0 +1,63 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const axiosClient_1 = require("../../util/axiosClient");
+const missingAuthConstants_1 = require("../../util/missingAuthConstants");
+const listCalendars = (_a) => __awaiter(void 0, [_a], void 0, function* ({ params, authParams, }) {
+    var _b;
+    if (!authParams.authToken) {
+        return { success: false, error: missingAuthConstants_1.MISSING_AUTH_TOKEN, calendars: [] };
+    }
+    const url = "https://www.googleapis.com/calendar/v3/users/me/calendarList";
+    const allCalendars = [];
+    let pageToken = undefined;
+    let fetchedCount = 0;
+    const max = (_b = params.maxResults) !== null && _b !== void 0 ? _b : 250; // Default to 250 if not specified, Google API max is 250
+    try {
+        while (fetchedCount < max) {
+            const res = yield axiosClient_1.axiosClient.get(url, {
+                headers: {
+                    Authorization: `Bearer ${authParams.authToken}`,
+                },
+                params: {
+                    showDeleted: false,
+                    showHidden: false,
+                    pageToken,
+                    maxResults: Math.min(250, max - fetchedCount), // Google API max is 250
+                },
+            });
+            const { items = [], nextPageToken = undefined } = res.data;
+            if (!Array.isArray(items) || items.length <= 0)
+                break;
+            const batch = items.slice(0, max - fetchedCount);
+            allCalendars.push(...batch.map(c => ({
+                id: c.id,
+                summary: c.summary,
+            })));
+            fetchedCount = allCalendars.length;
+            if (!nextPageToken || fetchedCount >= max)
+                break;
+            pageToken = nextPageToken;
+        }
+        return {
+            success: true,
+            calendars: allCalendars,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            calendars: [],
+            error: error instanceof Error ? error.message : "Unknown error listing calendars",
+        };
+    }
+});
+exports.default = listCalendars;

package/dist/actions/providers/google-oauth/listGroupMembers.d.ts

@@ -0,0 +1,3 @@
+import type { googleOauthListGroupMembersFunction } from "../../autogen/types";
+declare const listGroupMembers: googleOauthListGroupMembersFunction;
+export default listGroupMembers;

package/dist/actions/providers/google-oauth/listGroupMembers.js

@@ -0,0 +1,54 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const axiosClient_1 = require("../../util/axiosClient");
+const missingAuthConstants_1 = require("../../util/missingAuthConstants");
+const listGroupMembers = (_a) => __awaiter(void 0, [_a], void 0, function* ({ params, authParams, }) {
+    const { authToken } = authParams;
+    const { groupKey, maxResults } = params;
+    if (!authToken) {
+        return { success: false, members: [], error: missingAuthConstants_1.MISSING_AUTH_TOKEN };
+    }
+    try {
+        let members = [];
+        let pageToken = undefined;
+        const limit = Math.min(maxResults !== null && maxResults !== void 0 ? maxResults : 200, 200);
+        while (members.length < limit) {
+            const url = new URL(`https://admin.googleapis.com/admin/directory/v1/groups/${encodeURIComponent(groupKey)}/members`);
+            url.searchParams.set("maxResults", String(limit - members.length));
+            if (pageToken)
+                url.searchParams.set("pageToken", pageToken);
+            const response = yield axiosClient_1.axiosClient.get(url.toString(), {
+                headers: { Authorization: `Bearer ${authToken}` },
+            });
+            const data = response.data;
+            const batch = (data.members || []).map(({ id, email, role, type }) => ({
+                id,
+                email,
+                role,
+                type,
+            }));
+            members = members.concat(batch);
+            pageToken = data.nextPageToken;
+            if (!pageToken)
+                break;
+        }
+        return { success: true, members: members.slice(0, limit) };
+    }
+    catch (error) {
+        return {
+            success: false,
+            members: [],
+            error: error instanceof Error ? error.message : "Unknown error",
+        };
+    }
+});
+exports.default = listGroupMembers;

package/dist/actions/providers/google-oauth/listGroups.d.ts

@@ -0,0 +1,3 @@
+import type { googleOauthListGroupsFunction } from "../../autogen/types";
+declare const listGroups: googleOauthListGroupsFunction;
+export default listGroups;

package/dist/actions/providers/google-oauth/listGroups.js

@@ -0,0 +1,56 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const axiosClient_1 = require("../../util/axiosClient");
+const missingAuthConstants_1 = require("../../util/missingAuthConstants");
+const listGroups = (_a) => __awaiter(void 0, [_a], void 0, function* ({ authParams, params, }) {
+    var _b;
+    const { authToken } = authParams;
+    const maxResults = (_b = params === null || params === void 0 ? void 0 : params.maxResults) !== null && _b !== void 0 ? _b : 200;
+    if (!authToken) {
+        return { success: false, groups: [], error: missingAuthConstants_1.MISSING_AUTH_TOKEN };
+    }
+    try {
+        let groups = [];
+        let pageToken = undefined;
+        const limit = Math.min(maxResults, 200);
+        while (groups.length < limit) {
+            const url = new URL("https://admin.googleapis.com/admin/directory/v1/groups");
+            url.searchParams.set("customer", "my_customer");
+            url.searchParams.set("maxResults", String(limit - groups.length));
+            if (pageToken)
+                url.searchParams.set("pageToken", pageToken);
+            const response = yield axiosClient_1.axiosClient.get(url.toString(), {
+                headers: { Authorization: `Bearer ${authToken}` },
+            });
+            const data = response.data;
+            const batch = (data.groups || []).map(({ id, email, name, description }) => ({
+                id,
+                email,
+                name,
+                description,
+            }));
+            groups = groups.concat(batch);
+            pageToken = data.nextPageToken;
+            if (!pageToken)
+                break;
+        }
+        return { success: true, groups: groups.slice(0, limit) };
+    }
+    catch (error) {
+        return {
+            success: false,
+            groups: [],
+            error: error instanceof Error ? error.message : "Unknown error",
+        };
+    }
+});
+exports.default = listGroups;

package/dist/actions/providers/google-oauth/updateCalendarEvent.d.ts

@@ -0,0 +1,3 @@
+import type { googleOauthUpdateCalendarEventFunction } from "../../autogen/types";
+declare const updateCalendarEvent: googleOauthUpdateCalendarEventFunction;
+export default updateCalendarEvent;

package/dist/actions/providers/google-oauth/updateCalendarEvent.js

@@ -0,0 +1,59 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const axiosClient_1 = require("../../util/axiosClient");
+const missingAuthConstants_1 = require("../../util/missingAuthConstants");
+const updateCalendarEvent = (_a) => __awaiter(void 0, [_a], void 0, function* ({ params, authParams, }) {
+    if (!authParams.authToken) {
+        return { success: false, error: missingAuthConstants_1.MISSING_AUTH_TOKEN, eventId: "", eventUrl: "" };
+    }
+    const { calendarId, eventId, updates } = params;
+    const url = `https://www.googleapis.com/calendar/v3/calendars/${encodeURIComponent(calendarId)}/events/${encodeURIComponent(eventId)}`;
+    const body = {};
+    if (updates) {
+        if (updates.title != undefined)
+            body.summary = updates.title;
+        if (updates.description != undefined)
+            body.description = updates.description;
+        if (updates.start != undefined)
+            body.start = { dateTime: updates.start };
+        if (updates.end != undefined)
+            body.end = { dateTime: updates.end };
+        if (updates.location != undefined)
+            body.location = updates.location;
+        if (updates.attendees != undefined)
+            body.attendees = updates.attendees.map(email => ({ email }));
+        if (updates.status != undefined)
+            body.status = updates.status;
+        if (updates.organizer != undefined)
+            body.organizer = updates.organizer;
+    }
+    try {
+        const res = yield axiosClient_1.axiosClient.patch(url, body, {
+            headers: {
+                Authorization: `Bearer ${authParams.authToken}`,
+            },
+        });
+        const { id, htmlLink } = res.data;
+        return {
+            success: true,
+            eventId: id,
+            eventUrl: htmlLink,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : "Unknown error updating event",
+        };
+    }
+});
+exports.default = updateCalendarEvent;

package/dist/actions/providers/googlemail/listGmailThreads.d.ts

@@ -0,0 +1,3 @@
+import type { googlemailListGmailThreadsFunction } from "../../autogen/types";
+declare const listGmailThreads: googlemailListGmailThreadsFunction;
+export default listGmailThreads;

package/dist/actions/providers/{google-oauth → googlemail}/listGmailThreads.js

@@ -11,7 +11,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 const axiosClient_1 = require("../../util/axiosClient");
 const missingAuthConstants_1 = require("../../util/missingAuthConstants");
-const decodeMessage_1 = require("./utils/decodeMessage");
+const decodeMessage_1 = require("../google-oauth/utils/decodeMessage");
 const listGmailThreads = (_a) => __awaiter(void 0, [_a], void 0, function* ({ params, authParams, }) {
     if (!authParams.authToken) {
         return { success: false, error: missingAuthConstants_1.MISSING_AUTH_TOKEN, threads: [] };

package/dist/actions/providers/googlemail/searchGmailMessages.d.ts

@@ -0,0 +1,3 @@
+import type { googlemailSearchGmailMessagesFunction } from "../../autogen/types";
+declare const searchGmailMessages: googlemailSearchGmailMessagesFunction;
+export default searchGmailMessages;

package/dist/actions/providers/{google-oauth → googlemail}/searchGmailMessages.js

@@ -11,7 +11,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 const axiosClient_1 = require("../../util/axiosClient");
 const missingAuthConstants_1 = require("../../util/missingAuthConstants");
-const decodeMessage_1 = require("./utils/decodeMessage");
+const decodeMessage_1 = require("../google-oauth/utils/decodeMessage");
 const searchGmailMessages = (_a) => __awaiter(void 0, [_a], void 0, function* ({ params, authParams, }) {
     if (!authParams.authToken) {
         return { success: false, error: missingAuthConstants_1.MISSING_AUTH_TOKEN, messages: [] };

package/dist/actions/providers/slack/listConversations.d.ts

@@ -1,3 +1,3 @@
-import { slackListConversationsFunction } from "../../autogen/types";
+import type { slackListConversationsFunction } from "../../autogen/types";
 declare const slackListConversations: slackListConversationsFunction;
 export default slackListConversations;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@credal/actions",
-  "version": "0.1.98",
+  "version": "0.1.100",
   "description": "AI Actions by Credal AI",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/dist/actions/autogen/definitions.d.ts

@@ -1,5 +0,0 @@
-import { ActionTemplate } from "@/actions/parse";
-export declare const slackSendMessageDefinition: ActionTemplate;
-export declare const slackListConversationsDefinition: ActionTemplate;
-export declare const mathAddDefinition: ActionTemplate;
-export declare const confluenceUpdatePageDefinition: ActionTemplate;

package/dist/actions/autogen/definitions.js

@@ -1,132 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.confluenceUpdatePageDefinition = exports.mathAddDefinition = exports.slackListConversationsDefinition = exports.slackSendMessageDefinition = void 0;
-exports.slackSendMessageDefinition = {
-    provider: "slack",
-    name: "send_message",
-    description: "Sends a message to a Slack channel",
-    scopes: ["chat:write"],
-    parameters: {
-        channel: {
-            type: "string",
-            description: "The Slack channel to send the message to (e.g., \\#general, \\#alerts)",
-            required: true,
-        },
-        message: {
-            type: "string",
-            description: "The message content to send to Slack. Can include markdown formatting.",
-            required: true,
-        },
-    },
-    output: {},
-};
-exports.slackListConversationsDefinition = {
-    provider: "slack",
-    name: "list_conversations",
-    description: "Lists all conversations in a Slack workspace",
-    scopes: ["channels:read", "groups:read", "im:read", "mpim:read"],
-    authToken: {
-        type: "string",
-        description: "The Slack access token to use",
-        required: true,
-    },
-    parameters: {},
-    output: {
-        channels: {
-            type: "array",
-            description: "A list of channels in Slack",
-            required: true,
-            items: {
-                type: "object",
-                description: "A channel in Slack",
-                required: true,
-                properties: {
-                    id: {
-                        type: "string",
-                        description: "The ID of the channel",
-                        required: true,
-                    },
-                    name: {
-                        type: "string",
-                        description: "The name of the channel",
-                        required: true,
-                    },
-                    topic: {
-                        type: "string",
-                        description: "The topic of the channel",
-                        required: true,
-                    },
-                    purpose: {
-                        type: "string",
-                        description: "The purpose of the channel",
-                        required: true,
-                    },
-                },
-            },
-        },
-    },
-};
-exports.mathAddDefinition = {
-    provider: "math",
-    name: "add",
-    description: "Adds two numbers together",
-    scopes: [],
-    parameters: {
-        a: {
-            type: "number",
-            description: "The first number to add",
-            required: true,
-        },
-        b: {
-            type: "number",
-            description: "The second number to add",
-            required: true,
-        },
-    },
-    output: {
-        result: {
-            type: "number",
-            description: "The sum of the two numbers",
-            required: true,
-        },
-    },
-};
-exports.confluenceUpdatePageDefinition = {
-    provider: "confluence",
-    name: "updatePage",
-    description: "Updates a confluence page with the new content specified",
-    scopes: [],
-    authToken: {
-        type: "string",
-        description: "The access token to use for confluence",
-        required: true,
-    },
-    baseUrl: {
-        type: "string",
-        description: "The base url required to access the confluence instance",
-        required: true,
-    },
-    parameters: {
-        pageId: {
-            type: "string",
-            description: "The page id that should be updated",
-            required: true,
-        },
-        title: {
-            type: "string",
-            description: "The title of the page that should be updated",
-            required: true,
-        },
-        username: {
-            type: "string",
-            description: "The username of the person updating the page",
-            required: true,
-        },
-        content: {
-            type: "string",
-            description: "The new content for the page",
-            required: true,
-        },
-    },
-    output: {},
-};

package/dist/actions/definitions.js

@@ -1,35 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mathAddDefinition = exports.slackSendMessageDefinition = void 0;
-exports.slackSendMessageDefinition = {
-    name: "send_message",
-    description: "Sends a message to a Slack channel",
-    parameters: {
-        "channel": {
-            "type": "string",
-            "description": "The Slack channel to send the message to (e.g., \\#general, \\#alerts)",
-            "required": true
-        },
-        "message": {
-            "type": "string",
-            "description": "The message content to send to Slack. Can include markdown formatting.",
-            "required": true
-        }
-    }
-};
-exports.mathAddDefinition = {
-    name: "add",
-    description: "Adds two numbers together",
-    parameters: {
-        "a": {
-            "type": "number",
-            "description": "The first number to add",
-            "required": true
-        },
-        "b": {
-            "type": "number",
-            "description": "The second number to add",
-            "required": true
-        }
-    }
-};

package/dist/actions/invokeMapper.d.ts

@@ -1,9 +0,0 @@
-import { type ActionFunction } from "./autogen/types";
-import { z } from "zod";
-interface ActionFunctionComponents {
-    fn: ActionFunction<any, any, any>;
-    paramsSchema: z.ZodSchema;
-    outputSchema: z.ZodSchema;
-}
-export declare const FunctionMapper: Record<string, Record<string, ActionFunctionComponents>>;
-export {};

package/dist/actions/invokeMapper.js

@@ -1,33 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FunctionMapper = void 0;
-const add_1 = __importDefault(require("./providers/math/add"));
-const list_conversations_1 = __importDefault(require("./providers/slack/list_conversations"));
-const updatePage_1 = __importDefault(require("./providers/confluence/updatePage"));
-const types_1 = require("./autogen/types");
-exports.FunctionMapper = {
-    math: {
-        add: {
-            fn: add_1.default,
-            paramsSchema: types_1.mathAddParamsSchema,
-            outputSchema: types_1.mathAddOutputSchema,
-        },
-    },
-    slack: {
-        listConversations: {
-            fn: list_conversations_1.default,
-            paramsSchema: types_1.slackListConversationsParamsSchema,
-            outputSchema: types_1.slackListConversationsOutputSchema,
-        },
-    },
-    confluence: {
-        updatePage: {
-            fn: updatePage_1.default,
-            paramsSchema: types_1.confluenceUpdatePageParamsSchema,
-            outputSchema: types_1.confluenceUpdatePageOutputSchema,
-        },
-    },
-};

package/dist/actions/providers/google-oauth/listGmailThreads.d.ts

@@ -1,3 +0,0 @@
-import type { googleOauthListGmailThreadsFunction } from "../../autogen/types";
-declare const listGmailThreads: googleOauthListGmailThreadsFunction;
-export default listGmailThreads;

package/dist/actions/providers/google-oauth/searchGmailMessages.d.ts

@@ -1,3 +0,0 @@
-import type { googleOauthSearchGmailMessagesFunction } from "../../autogen/types";
-declare const searchGmailMessages: googleOauthSearchGmailMessagesFunction;
-export default searchGmailMessages;

package/dist/actions/providers/googlemaps/nearbysearch.d.ts

@@ -1,3 +0,0 @@
-import { googlemapsNearbysearchFunction } from "../../autogen/types";
-declare const nearbysearch: googlemapsNearbysearchFunction;
-export default nearbysearch;

package/dist/actions/providers/googlemaps/nearbysearch.js

@@ -1,96 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const axios_1 = __importDefault(require("axios"));
-const types_1 = require("../../autogen/types");
-const INCLUDED_TYPES = [
-    // "monument",
-    // "museum",
-    // "art_gallery",
-    // "sculpture",
-    // "cultural_landmark",
-    // "historical_place",
-    // "performing_arts_theater",
-    // "university",
-    // "aquarium",
-    // "botanical_garden",
-    // "comedy_club",
-    // "park",
-    // "movie_theater",
-    // "national_park",
-    // "garden",
-    // "night_club",
-    // "tourist_attraction",
-    // "water_park",
-    // "zoo",
-    // "bar",
-    "restaurant",
-    // "food_court",
-    // "bakery",
-    // "cafe",
-    // "coffee_shop",
-    // "pub",
-    // "wine_bar",
-    // "spa",
-    // "beach",
-    // "market",
-    // "shopping_mall",
-    // "stadium",
-];
-const nearbysearch = (_a) => __awaiter(void 0, [_a], void 0, function* ({ params, authParams, }) {
-    const url = `https://places.googleapis.com/v1/places:searchNearby`;
-    const fieldMask = [
-        "places.displayName",
-        "places.formattedAddress",
-        "places.priceLevel",
-        "places.rating",
-        "places.primaryTypeDisplayName",
-        "places.editorialSummary",
-        "places.regularOpeningHours",
-    ].join(",");
-    const response = yield axios_1.default.post(url, {
-        maxResultCount: 20,
-        includedTypes: INCLUDED_TYPES,
-        locationRestriction: {
-            circle: {
-                center: {
-                    latitude: params.latitude,
-                    longitude: params.longitude,
-                },
-                radius: 10000,
-            },
-        },
-    }, {
-        headers: {
-            "X-Goog-Api-Key": authParams.apiKey,
-            "X-Goog-FieldMask": fieldMask,
-            "Content-Type": "application/json",
-        },
-    });
-    return types_1.googlemapsNearbysearchOutputSchema.parse({
-        results: response.data.places.map((place) => {
-            var _a, _b;
-            return ({
-                name: place.displayName.text,
-                address: place.formattedAddress,
-                priceLevel: place.priceLevel,
-                rating: place.rating,
-                primaryType: place.primaryTypeDisplayName.text,
-                editorialSummary: ((_a = place.editorialSummary) === null || _a === void 0 ? void 0 : _a.text) || "",
-                openingHours: ((_b = place.regularOpeningHours) === null || _b === void 0 ? void 0 : _b.weekdayDescriptions.join("\n")) || "",
-            });
-        }),
-    });
-});
-exports.default = nearbysearch;

package/dist/actions/providers/jira/createTicket.d.ts

@@ -1,3 +0,0 @@
-import { jiraCreateTicketFunction } from "../../autogen/types";
-declare const createTicket: jiraCreateTicketFunction;
-export default createTicket;