@meetploy/agent-sdk 0.0.0

package/dist/tools.js

@@ -0,0 +1,328 @@
+import { saveWorkspace } from "./workspace.js";
+const memorySetTool = {
+    type: "function",
+    function: {
+        name: "memory_set",
+        description: "Store a piece of information about the user for future conversations. Use this to remember preferences, names, configurations, etc.",
+        parameters: {
+            type: "object",
+            properties: {
+                key: {
+                    type: "string",
+                    description: "The key to store the memory under (e.g., 'name', 'language', 'timezone')",
+                },
+                value: { type: "string", description: "The value to remember" },
+                secret: {
+                    type: "boolean",
+                    description: "Whether this is sensitive data that should be hidden in debug output. Default: false",
+                },
+            },
+            required: ["key", "value"],
+        },
+    },
+};
+const memoryGetTool = {
+    type: "function",
+    function: {
+        name: "memory_get",
+        description: "Retrieve a stored memory about the user.",
+        parameters: {
+            type: "object",
+            properties: {
+                key: { type: "string", description: "The key to look up" },
+            },
+            required: ["key"],
+        },
+    },
+};
+const memoryDeleteTool = {
+    type: "function",
+    function: {
+        name: "memory_delete",
+        description: "Delete a stored memory.",
+        parameters: {
+            type: "object",
+            properties: {
+                key: { type: "string", description: "The key to delete" },
+            },
+            required: ["key"],
+        },
+    },
+};
+const memoryListTool = {
+    type: "function",
+    function: {
+        name: "memory_list",
+        description: "List all stored memory keys for the user.",
+        parameters: { type: "object", properties: {} },
+    },
+};
+const artifactCreateTool = {
+    type: "function",
+    function: {
+        name: "artifact_create",
+        description: "Create a file artifact and send it to the user. Use for code, documents, data exports, etc.",
+        parameters: {
+            type: "object",
+            properties: {
+                filename: { type: "string", description: "Name of the file to create" },
+                content: { type: "string", description: "The file contents" },
+                caption: {
+                    type: "string",
+                    description: "Optional message to send with the file",
+                },
+            },
+            required: ["filename", "content"],
+        },
+    },
+};
+const scheduleTaskTool = {
+    type: "function",
+    function: {
+        name: "schedule_task",
+        description: "Schedule a task to run at a future time. The agent will be invoked with the task description at the scheduled time.",
+        parameters: {
+            type: "object",
+            properties: {
+                description: {
+                    type: "string",
+                    description: "What the agent should do when the task fires",
+                },
+                delayMs: {
+                    type: "number",
+                    description: "Delay in milliseconds from now",
+                },
+                recurring: {
+                    type: "boolean",
+                    description: "Whether this task should repeat. Default: false",
+                },
+                intervalMs: {
+                    type: "number",
+                    description: "Interval in ms for recurring tasks",
+                },
+            },
+            required: ["description", "delayMs"],
+        },
+    },
+};
+const mcpCallToolTool = {
+    type: "function",
+    function: {
+        name: "mcp_call_tool",
+        description: "Call a tool provided by an installed MCP server.",
+        parameters: {
+            type: "object",
+            properties: {
+                serverName: { type: "string", description: "Name of the MCP server" },
+                toolName: { type: "string", description: "Name of the tool to call" },
+                arguments: {
+                    type: "object",
+                    description: "Arguments to pass to the tool",
+                },
+            },
+            required: ["serverName", "toolName"],
+        },
+    },
+};
+export function buildOpenAITools(config, features, mcpServers) {
+    const tools = [];
+    if (features.memory !== false) {
+        tools.push(memorySetTool, memoryGetTool, memoryDeleteTool, memoryListTool);
+    }
+    if (features.artifacts !== false) {
+        tools.push(artifactCreateTool);
+    }
+    if (features.scheduling !== false) {
+        tools.push(scheduleTaskTool);
+    }
+    if (features.mcp !== false && mcpServers.length > 0) {
+        tools.push(mcpCallToolTool);
+    }
+    if (config.tools) {
+        for (const tool of config.tools) {
+            tools.push({
+                type: "function",
+                function: {
+                    name: tool.name,
+                    description: tool.description,
+                    parameters: tool.parameters,
+                },
+            });
+        }
+    }
+    return tools;
+}
+export async function executeTool(toolName, args, ctx) {
+    const { workspace } = ctx;
+    function buildHookContext() {
+        return {
+            userId: workspace.userId,
+            chatId: workspace.chatId,
+            env: ctx.env,
+            state: ctx.state,
+            execute: async (name, toolArgs) => {
+                const result = await executeTool(name, toolArgs, ctx);
+                return result.output;
+            },
+        };
+    }
+    switch (toolName) {
+        case "memory_set": {
+            const key = args.key;
+            const value = args.value;
+            const secret = args.secret ?? false;
+            const entry = { value, secret, createdAt: Date.now() };
+            workspace.memory[key] = entry;
+            await saveWorkspace(ctx.state, workspace);
+            if (ctx.hooks?.onMemorySet) {
+                await ctx.hooks.onMemorySet(buildHookContext(), key, secret);
+            }
+            return { output: `Stored memory: ${key}`, workspace };
+        }
+        case "memory_get": {
+            const key = args.key;
+            if (!(key in workspace.memory)) {
+                return { output: `No memory found for key: ${key}`, workspace };
+            }
+            return { output: workspace.memory[key].value, workspace };
+        }
+        case "memory_delete": {
+            const key = args.key;
+            const existed = key in workspace.memory;
+            delete workspace.memory[key];
+            await saveWorkspace(ctx.state, workspace);
+            if (existed && ctx.hooks?.onMemoryDelete) {
+                await ctx.hooks.onMemoryDelete(buildHookContext(), key);
+            }
+            return {
+                output: existed
+                    ? `Deleted memory: ${key}`
+                    : `No memory found for key: ${key}`,
+                workspace,
+            };
+        }
+        case "memory_list": {
+            const keys = Object.keys(workspace.memory);
+            if (keys.length === 0) {
+                return { output: "No memories stored.", workspace };
+            }
+            return { output: `Stored memories: ${keys.join(", ")}`, workspace };
+        }
+        case "artifact_create": {
+            const filename = args.filename;
+            const content = args.content;
+            const caption = args.caption;
+            const fileKey = `${workspace.userId}/${filename}`;
+            await ctx.env.FILES.put(fileKey, content, {
+                contentType: "application/octet-stream",
+            });
+            await ctx.messenger.sendDocument(workspace.chatId, filename, content, caption);
+            if (ctx.hooks?.onArtifactCreated) {
+                await ctx.hooks.onArtifactCreated(buildHookContext(), filename, content);
+            }
+            return { output: `Created and sent artifact: ${filename}`, workspace };
+        }
+        case "schedule_task": {
+            const description = args.description;
+            const delayMs = args.delayMs;
+            const recurring = args.recurring ?? false;
+            const intervalMs = args.intervalMs;
+            const taskId = `task_${workspace.userId}_${String(Date.now())}`;
+            const scheduledTime = Date.now() + delayMs;
+            const task = {
+                id: taskId,
+                description,
+                scheduledTime,
+                recurring,
+                intervalMs,
+            };
+            await ctx.env.SCHEDULER.set(taskId, scheduledTime, {
+                payload: {
+                    userId: workspace.userId,
+                    chatId: workspace.chatId,
+                    platform: workspace.platform,
+                    description,
+                },
+                intervalMs: recurring ? intervalMs : undefined,
+            });
+            if (ctx.hooks?.onTaskScheduled) {
+                await ctx.hooks.onTaskScheduled(buildHookContext(), task);
+            }
+            return {
+                output: `Scheduled task "${description}" for ${new Date(scheduledTime).toISOString()}`,
+                workspace,
+            };
+        }
+        case "mcp_call_tool": {
+            const serverName = args.serverName;
+            const toolNameArg = args.toolName;
+            const toolArgs = args.arguments ?? {};
+            const server = workspace.mcpServers.find((s) => s.name === serverName);
+            if (!server) {
+                return { output: `MCP server not found: ${serverName}`, workspace };
+            }
+            const tool = server.tools.find((t) => t.name === toolNameArg);
+            if (!tool) {
+                return {
+                    output: `Tool "${toolNameArg}" not found on server "${serverName}"`,
+                    workspace,
+                };
+            }
+            const response = await fetch(`${server.url}/call`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ tool: toolNameArg, arguments: toolArgs }),
+            });
+            if (!response.ok) {
+                return {
+                    output: `MCP call failed: ${String(response.status)} ${response.statusText}`,
+                    workspace,
+                };
+            }
+            const result = await response.text();
+            return { output: result, workspace };
+        }
+        default: {
+            const customTool = ctx.customTools.find((t) => t.name === toolName);
+            if (customTool) {
+                const toolCtx = {
+                    userId: workspace.userId,
+                    chatId: workspace.chatId,
+                    env: ctx.env,
+                    state: ctx.state,
+                    messenger: ctx.messenger,
+                };
+                const output = await customTool.execute(args, toolCtx);
+                return { output, workspace };
+            }
+            return { output: `Unknown tool: ${toolName}`, workspace };
+        }
+    }
+}
+export function listAllToolNames(config, features, mcpServers) {
+    const names = [];
+    if (features.memory !== false) {
+        names.push("memory_set", "memory_get", "memory_delete", "memory_list");
+    }
+    if (features.artifacts !== false) {
+        names.push("artifact_create");
+    }
+    if (features.scheduling !== false) {
+        names.push("schedule_task");
+    }
+    if (features.mcp !== false && mcpServers.length > 0) {
+        names.push("mcp_call_tool");
+    }
+    for (const server of mcpServers) {
+        for (const tool of server.tools) {
+            names.push(`${server.name}/${tool.name}`);
+        }
+    }
+    if (config.tools) {
+        for (const tool of config.tools) {
+            names.push(tool.name);
+        }
+    }
+    return names;
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,184 @@
+import type { FileStorageBinding, Ploy, StateBinding, TimerBinding, WorkflowBinding } from "@meetploy/types";
+export interface PloyEnv {
+    AI_URL: string;
+    AI_TOKEN: string;
+    STATE: StateBinding;
+    FILES: FileStorageBinding;
+    AGENT_WORKFLOW: WorkflowBinding;
+    SCHEDULER: TimerBinding;
+    vars: Record<string, string>;
+}
+export interface Messenger {
+    sendMessage: (chatId: string, text: string) => Promise<void>;
+    sendDocument: (chatId: string, filename: string, content: string | Uint8Array, caption?: string) => Promise<void>;
+    sendTypingIndicator: (chatId: string) => Promise<void>;
+}
+export interface ToolContext {
+    userId: string;
+    chatId: string;
+    env: PloyEnv;
+    state: StateManager;
+    messenger: Messenger;
+}
+export interface ToolDefinition<TArgs = Record<string, unknown>> {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    execute: (args: TArgs, ctx: ToolContext) => Promise<string>;
+}
+interface JsonTypeMap {
+    string: string;
+    number: number;
+    integer: number;
+    boolean: boolean;
+    object: Record<string, unknown>;
+    array: unknown[];
+}
+type InferPropertyType<T> = T extends {
+    type: infer U extends keyof JsonTypeMap;
+} ? JsonTypeMap[U] : unknown;
+type RequiredKeys<T> = T extends {
+    required: readonly (infer R)[];
+} ? R extends string ? R : never : never;
+type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+export type InferSchemaArgs<T> = T extends {
+    properties: infer P extends Record<string, unknown>;
+} ? Simplify<{
+    [K in keyof P as K extends RequiredKeys<T> ? K : never]: InferPropertyType<P[K]>;
+} & {
+    [K in keyof P as K extends RequiredKeys<T> ? never : K]?: InferPropertyType<P[K]>;
+}> : Record<string, unknown>;
+export interface ToolParams {
+    type: "object";
+    properties: Record<string, {
+        type: string;
+    }>;
+    required?: readonly string[];
+}
+export interface FeatureFlags {
+    memory?: boolean;
+    artifacts?: boolean;
+    scheduling?: boolean;
+    mcp?: boolean;
+}
+export interface ScheduledTask {
+    id: string;
+    description: string;
+    scheduledTime: number;
+    recurring: boolean;
+    intervalMs?: number;
+}
+export interface HookContext {
+    userId: string;
+    chatId: string;
+    env: PloyEnv;
+    state: StateManager;
+    execute: (toolName: string, args: Record<string, unknown>) => Promise<string>;
+}
+export interface AgentHooks {
+    onMemorySet?: (ctx: HookContext, key: string, secret: boolean) => Promise<void>;
+    onMemoryDelete?: (ctx: HookContext, key: string) => Promise<void>;
+    onArtifactCreated?: (ctx: HookContext, filename: string, content: string) => Promise<void>;
+    onTaskScheduled?: (ctx: HookContext, task: ScheduledTask) => Promise<void>;
+    onRunComplete?: (ctx: HookContext, response: string) => Promise<void>;
+    onRunError?: (ctx: HookContext, error: Error) => Promise<void>;
+}
+export interface HandleMessageParams {
+    userId: string;
+    chatId: string;
+    platform: string;
+    text: string;
+    messenger: Messenger;
+}
+export interface AgentCommands {
+    reset: (userId: string, chatId: string) => Promise<string>;
+    debug: (userId: string, chatId: string) => Promise<string>;
+    installMcp: (userId: string, chatId: string, url: string) => Promise<string>;
+    uninstallMcp: (userId: string, name: string) => Promise<string>;
+    listTools: (userId: string) => Promise<string>;
+}
+export interface StateManager {
+    get: (key: string) => Promise<string | null>;
+    set: (key: string, value: string) => Promise<void>;
+    delete: (key: string) => Promise<void>;
+    getJSON: <T>(key: string) => Promise<T | null>;
+    setJSON: (key: string, value: unknown) => Promise<void>;
+}
+export interface AgentContext {
+    handleMessage: (params: HandleMessageParams) => Promise<void>;
+    commands: AgentCommands;
+    state: StateManager;
+    env: PloyEnv;
+}
+export interface AgentConfig {
+    model?: string;
+    systemPrompt: string | ((userId: string) => string | Promise<string>);
+    features?: FeatureFlags;
+    tools?: ToolDefinition<any>[];
+    handle: (req: Request, env: PloyEnv, agent: AgentContext) => Response | Promise<Response>;
+    hooks?: AgentHooks;
+    maxSteps?: number;
+}
+export interface OpenAITool {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+}
+export interface ChatMessage {
+    role: "system" | "user" | "assistant" | "tool";
+    content: string | null;
+    tool_calls?: ToolCall[];
+    tool_call_id?: string;
+    name?: string;
+}
+export interface ToolCall {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface Workspace {
+    userId: string;
+    chatId: string;
+    platform: string;
+    messages: ChatMessage[];
+    memory: Record<string, MemoryEntry>;
+    mcpServers: McpServer[];
+    debugMode: boolean;
+    activeRunId: string | null;
+    queue: QueuedMessage[];
+}
+export interface MemoryEntry {
+    value: string;
+    secret: boolean;
+    createdAt: number;
+}
+export interface McpServer {
+    name: string;
+    url: string;
+    tools: McpServerTool[];
+}
+export interface McpServerTool {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+export interface QueuedMessage {
+    text: string;
+    timestamp: number;
+}
+export interface AgentRunInput {
+    userId: string;
+    chatId: string;
+    platform: string;
+    text: string;
+}
+export type AgentExport = Ploy<PloyEnv>;
+export {};

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/workflow.d.ts

@@ -0,0 +1,3 @@
+import type { AgentConfig, AgentRunInput, PloyEnv } from "./types.js";
+import type { WorkflowContext } from "@meetploy/types";
+export declare function createAgentWorkflow(config: AgentConfig): (ctx: WorkflowContext<PloyEnv, AgentRunInput>) => Promise<void>;