Offorte Proposal Software

Instructions

Implementation Reference

• src/tools/proposals/send-proposal.ts:15-33 (handler)

  The handler function for the 'send_proposal' tool. It executes a POST request to send the proposal and validates the response using the schema.

  export const sendProposalTool: Tool<typeof parameters._type, typeof parameters> = {
  	name: 'send_proposal',
  	description: 'Send a proposal to its assigned contacts',
  	parameters,
  	annotations: {
  		title: 'Send Proposal',
  		openWorldHint: true,
  	},
  	async execute({ proposal_id, ...body }) {
  		const result = await post(`/proposals/${proposal_id}/send/`, body);
  		const parsed = sendProposalSchema.safeParse(result);
  
  		if (!parsed.success) {
  			throwApiInvalidResponseError(parsed.error);
  		}
  
  		return JSON.stringify(parsed.data);
  	},
  };

• src/schemas/proposals.ts:77-86 (schema)

  Input/output schemas for the send_proposal tool, including the response structure with receivers.

  export const sendProposalReceiverSchema = z.object({
  	email: z.string(),
  	fullname: z.string(),
  	id: z.number(),
  	proposal_link: z.string(),
  });
  
  export const sendProposalSchema = z.object({
  	receivers: z.array(sendProposalReceiverSchema),
  });

• src/tools/register.ts:17-34 (registration)

  Registration of the sendProposalTool: imported and added to the tools array for server registration.

  import { sendProposalTool } from './proposals/send-proposal.js';
  
  const tools = [
  	getInitialContextTool,
  	getAccountUsersTool,
  	getAutomationSetsTool,
  	getContactDetailsTool,
  	getDesignTemplatesTool,
  	getEmailTemplatesTool,
  	getProposalDirectoriesTool,
  	getProposalTemplatesTool,
  	getTextTemplatesTool,
  	searchContactOrganisationsTool,
  	searchContactPeopleTool,
  	searchProposalsTool,
  	createContactTool,
  	createProposalTool,
  	sendProposalTool,