@workbuddy/piece-workbuddy-edge 1.0.32 → 1.0.34

package/src/lib/actions/jobs.ts

@@ -121,6 +121,11 @@ export const PublicApiJobController_search = createAction({
       description: '',
       required: false,
     }),
+    integrationId: Property.Array({
+      displayName: 'Integration Id',
+      description: 'integration ID',
+      required: false,
+    }),
     resource: Property.Array({
       displayName: 'Resource',
       description: '',
@@ -222,6 +227,7 @@ export const PublicApiJobController_search = createAction({
       tag: context.propsValue.tag,
       priceBook: context.propsValue.priceBook,
       billingCompany: context.propsValue.billingCompany,
+      integrationId: context.propsValue.integrationId,
       resource: context.propsValue.resource,
       workCategory: context.propsValue.workCategory,
       stageStatus: context.propsValue.stageStatus,
@@ -256,11 +262,11 @@ export const PublicApiJobController_get = createAction({
   name: 'PublicApiJobController_get',
   auth: workbuddyAuth,
   displayName: 'Get job by ID or job number',
-  description: 'Retrieve a single job by its ID or human-readable job number.',
+  description: 'Retrieve a single job by its ID, human-readable job number, or external integration ID.',
   props: {
     identifier: Property.ShortText({
       displayName: 'Identifier',
-      description: 'Job ID (MongoDB ObjectId) or job number (e.g., JOB-12345)',
+      description: 'Job ID (MongoDB ObjectId), job number (e.g., JOB-12345), or external integration ID',
       required: true,
     }),
   },
@@ -338,6 +344,16 @@ export const PublicApiJobController_create = createAction({
       description: 'Display name',
       required: false,
     }),
+    integrationId: Property.ShortText({
+      displayName: 'Integration Id',
+      description: 'integration ID',
+      required: false,
+    }),
+    jobNumber: Property.ShortText({
+      displayName: 'Job Number',
+      description: '',
+      required: false,
+    }),
     description: Property.LongText({
       displayName: 'Description',
       description: 'Detailed description',
@@ -348,6 +364,11 @@ export const PublicApiJobController_create = createAction({
       description: 'Site ID — use /crm/sites to look up',
       required: false,
     }),
+    placeId: Property.ShortText({
+      displayName: 'Place Id',
+      description: 'place ID',
+      required: false,
+    }),
     site: Property.Json({
       displayName: 'Site',
       description: 'Inline site object — alternative to siteId',
@@ -418,9 +439,193 @@ export const PublicApiJobController_create = createAction({
       description: 'Customer purchase order reference',
       required: false,
     }),
+    startDate: Property.DateTime({
+      displayName: 'Start Date',
+      description: 'Start date (ISO 8601 datetime)',
+      required: false,
+    }),
+    dueDate: Property.DateTime({
+      displayName: 'Due Date',
+      description: 'Due date (ISO 8601 datetime)',
+      required: false,
+    }),
+    customFields: Property.Json({
+      displayName: 'Custom Fields',
+      description: 'Custom fields as key-value pairs — validated against tenant field definitions',
+      required: false,
+    }),
+    items: Property.Json({
+      displayName: 'Items',
+      description: '',
+      required: false,
+      defaultValue: [],
+    }),
+  },
+  async run(context) {
+    const token = await getAccessToken(context.auth);
+    const baseUrl = context.auth.props.baseUrl;
+
+    const url = `${baseUrl}/api/v2/public/jobs`;
+
+    const rawBody: Record<string, unknown> = {
+      name: context.propsValue.name,
+      integrationId: context.propsValue.integrationId,
+      jobNumber: context.propsValue.jobNumber,
+      description: context.propsValue.description,
+      customerId: context.propsValue.customerId,
+      siteId: context.propsValue.siteId,
+      placeId: context.propsValue.placeId,
+      site: context.propsValue.site,
+      contactId: context.propsValue.contactId,
+      contact: context.propsValue.contact,
+      typeId: context.propsValue.typeId,
+      priorityId: context.propsValue.priorityId,
+      priceBookId: context.propsValue.priceBookId,
+      ownerId: context.propsValue.ownerId,
+      fieldSupervisorId: context.propsValue.fieldSupervisorId,
+      zoneId: context.propsValue.zoneId,
+      tagIds: context.propsValue.tagIds,
+      notes: context.propsValue.notes,
+      reference: context.propsValue.reference,
+      customerWO: context.propsValue.customerWO,
+      customerPO: context.propsValue.customerPO,
+      startDate: context.propsValue.startDate,
+      dueDate: context.propsValue.dueDate,
+      customFields: context.propsValue.customFields,
+      items: context.propsValue.items,
+    };
+
+    const body = rawBody;
+    const response = await httpClient.sendRequest({
+      method: HttpMethod.POST,
+      url: `${baseUrl}/api/v2/public/jobs`,
+      headers: {
+        Authorization: `Bearer ${token}`,
+        'Content-Type': 'application/json',
+        'X-WorkBuddy-Version': '2026-01',
+      },
+      body: body,
+    });
+
+    return response.body;
+  },
+});
+
+export const PublicApiJobController_createFromTemplate = createAction({
+  name: 'PublicApiJobController_createFromTemplate',
+  auth: workbuddyAuth,
+  displayName: 'Create a new job from template',
+  description:
+    'Create a job using a job template. Template-owned fields win over request values before final job validation.',
+  props: {
     templateId: Property.ShortText({
       displayName: 'Template Id',
-      description: 'Template ID to pre-populate fields from a template',
+      description: 'Job template ID',
+      required: true,
+    }),
+    customerId: Property.ShortText({
+      displayName: 'Customer Id',
+      description: 'Customer ID — use /crm/customers to look up',
+      required: true,
+    }),
+    name: Property.ShortText({
+      displayName: 'Name',
+      description: 'Display name',
+      required: false,
+    }),
+    integrationId: Property.ShortText({
+      displayName: 'Integration Id',
+      description: 'integration ID',
+      required: false,
+    }),
+    jobNumber: Property.ShortText({
+      displayName: 'Job Number',
+      description: '',
+      required: false,
+    }),
+    description: Property.LongText({
+      displayName: 'Description',
+      description: 'Detailed description',
+      required: false,
+    }),
+    siteId: Property.ShortText({
+      displayName: 'Site Id',
+      description: 'Site ID — use /crm/sites to look up',
+      required: false,
+    }),
+    placeId: Property.ShortText({
+      displayName: 'Place Id',
+      description: 'place ID',
+      required: false,
+    }),
+    site: Property.Json({
+      displayName: 'Site',
+      description: 'Inline site object — alternative to siteId',
+      required: false,
+    }),
+    contactId: Property.ShortText({
+      displayName: 'Contact Id',
+      description: 'Contact ID — use /crm/contacts to look up',
+      required: false,
+    }),
+    contact: Property.Json({
+      displayName: 'Contact',
+      description: 'Inline contact object — alternative to contactId',
+      required: false,
+    }),
+    typeId: Property.ShortText({
+      displayName: 'Type Id',
+      description: 'Job type ID — use /settings/job-types to look up',
+      required: false,
+    }),
+    priorityId: Property.ShortText({
+      displayName: 'Priority Id',
+      description: 'Priority ID — use /settings/priorities to look up',
+      required: false,
+    }),
+    priceBookId: Property.ShortText({
+      displayName: 'Price Book Id',
+      description: 'Price book ID for job pricing',
+      required: false,
+    }),
+    ownerId: Property.ShortText({
+      displayName: 'Owner Id',
+      description: 'Owner (employee) ID — use /crm/employees to look up',
+      required: false,
+    }),
+    fieldSupervisorId: Property.ShortText({
+      displayName: 'Field Supervisor Id',
+      description: 'Field supervisor (employee) ID — use /crm/employees to look up',
+      required: false,
+    }),
+    zoneId: Property.ShortText({
+      displayName: 'Zone Id',
+      description: 'Zone ID — use /settings/zones to look up',
+      required: false,
+    }),
+    tagIds: Property.Array({
+      displayName: 'Tag Ids',
+      description: 'Array of tag IDs (comma-separated, e.g. "id1,id2") — use /settings/tags to look up',
+      required: false,
+    }),
+    notes: Property.LongText({
+      displayName: 'Notes',
+      description: 'Additional notes or comments',
+      required: false,
+    }),
+    reference: Property.ShortText({
+      displayName: 'Reference',
+      description: 'External reference number',
+      required: false,
+    }),
+    customerWO: Property.ShortText({
+      displayName: 'Customer W O',
+      description: 'Customer work order reference',
+      required: false,
+    }),
+    customerPO: Property.ShortText({
+      displayName: 'Customer P O',
+      description: 'Customer purchase order reference',
       required: false,
     }),
     startDate: Property.DateTime({
@@ -438,18 +643,27 @@ export const PublicApiJobController_create = createAction({
       description: 'Custom fields as key-value pairs — validated against tenant field definitions',
       required: false,
     }),
+    items: Property.Json({
+      displayName: 'Items',
+      description: '',
+      required: false,
+      defaultValue: [],
+    }),
   },
   async run(context) {
     const token = await getAccessToken(context.auth);
     const baseUrl = context.auth.props.baseUrl;
 
-    const url = `${baseUrl}/api/v2/public/jobs`;
+    const url = `${baseUrl}/api/v2/public/jobs/template/${context.propsValue.templateId}`;
 
     const rawBody: Record<string, unknown> = {
       name: context.propsValue.name,
+      integrationId: context.propsValue.integrationId,
+      jobNumber: context.propsValue.jobNumber,
       description: context.propsValue.description,
       customerId: context.propsValue.customerId,
       siteId: context.propsValue.siteId,
+      placeId: context.propsValue.placeId,
       site: context.propsValue.site,
       contactId: context.propsValue.contactId,
       contact: context.propsValue.contact,
@@ -464,16 +678,91 @@ export const PublicApiJobController_create = createAction({
       reference: context.propsValue.reference,
       customerWO: context.propsValue.customerWO,
       customerPO: context.propsValue.customerPO,
-      templateId: context.propsValue.templateId,
       startDate: context.propsValue.startDate,
       dueDate: context.propsValue.dueDate,
       customFields: context.propsValue.customFields,
+      items: context.propsValue.items,
     };
 
     const body = rawBody;
     const response = await httpClient.sendRequest({
       method: HttpMethod.POST,
-      url: `${baseUrl}/api/v2/public/jobs`,
+      url: `${baseUrl}/api/v2/public/jobs/template/${context.propsValue.templateId}`,
+      headers: {
+        Authorization: `Bearer ${token}`,
+        'Content-Type': 'application/json',
+        'X-WorkBuddy-Version': '2026-01',
+      },
+      body: body,
+    });
+
+    return response.body;
+  },
+});
+
+export const PublicApiJobController_updateStatus = createAction({
+  name: 'PublicApiJobController_updateStatus',
+  auth: workbuddyAuth,
+  displayName: 'Update job status',
+  description: 'Change an existing job status and cascade the change to stages through the job domain command.',
+  props: {
+    id: Property.ShortText({
+      displayName: 'Id',
+      description: 'Job ID',
+      required: true,
+    }),
+    status: Property.StaticDropdown({
+      displayName: 'Status',
+      description: 'Status filter',
+      required: true,
+      options: {
+        options: [
+          { label: 'open', value: 'open' },
+          { label: 'in_progress', value: 'in_progress' },
+          { label: 'on_hold', value: 'on_hold' },
+          { label: 'completed', value: 'completed' },
+          { label: 'finalised', value: 'finalised' },
+          { label: 'closed', value: 'closed' },
+          { label: 'cancelled', value: 'cancelled' },
+        ],
+      },
+    }),
+    updatedAt: Property.DateTime({
+      displayName: 'Updated At',
+      description: 'For optimistic concurrency — update fails if entity was modified after this timestamp',
+      required: false,
+    }),
+    note: Property.ShortText({
+      displayName: 'Note',
+      description: '',
+      required: false,
+    }),
+    reason: Property.ShortText({
+      displayName: 'Reason',
+      description: 'Reason for the action (e.g. cancellation reason)',
+      required: false,
+    }),
+  },
+  async run(context) {
+    const token = await getAccessToken(context.auth);
+    const baseUrl = context.auth.props.baseUrl;
+
+    const url = `${baseUrl}/api/v2/public/jobs/${context.propsValue.id}/status`;
+
+    // Build body with only defined values (for partial updates)
+    const rawBody: Record<string, unknown> = {
+      updatedAt: context.propsValue.updatedAt,
+      status: context.propsValue.status,
+      note: context.propsValue.note,
+      reason: context.propsValue.reason,
+    };
+
+    const body = Object.fromEntries(
+      Object.entries(rawBody).filter(([_, v]) => v !== undefined && v !== null && v !== '')
+    );
+    const response = await httpClient.sendRequest({
+      method: HttpMethod.PATCH,
+      url: `${baseUrl}/api/v2/public/jobs/${context.propsValue.id}/status`,
       headers: {
         Authorization: `Bearer ${token}`,
         'Content-Type': 'application/json',
@@ -507,6 +796,11 @@ export const PublicApiJobController_update = createAction({
       description: 'Display name',
       required: false,
     }),
+    integrationId: Property.ShortText({
+      displayName: 'Integration Id',
+      description: 'integration ID',
+      required: false,
+    }),
     description: Property.LongText({
       displayName: 'Description',
       description: 'Detailed description',
@@ -613,6 +907,7 @@ export const PublicApiJobController_update = createAction({
     const rawBody: Record<string, unknown> = {
       updatedAt: context.propsValue.updatedAt,
       name: context.propsValue.name,
+      integrationId: context.propsValue.integrationId,
       description: context.propsValue.description,
       siteId: context.propsValue.siteId,
       contactId: context.propsValue.contactId,
@@ -845,6 +1140,61 @@ export const PublicApiJobController_getStageItems = createAction({
   },
 });
 
+export const PublicApiJobController_createStageItems = createAction({
+  name: 'PublicApiJobController_createStageItems',
+  auth: workbuddyAuth,
+  displayName: 'Create stage items',
+  description: 'Add one or more catalogue-backed line items to a stage.',
+  props: {
+    id: Property.ShortText({
+      displayName: 'Id',
+      description: 'Job ID',
+      required: true,
+    }),
+    stageId: Property.ShortText({
+      displayName: 'Stage Id',
+      description: 'Stage ID',
+      required: true,
+    }),
+    updatedAt: Property.DateTime({
+      displayName: 'Updated At',
+      description: 'For optimistic concurrency — update fails if entity was modified after this timestamp',
+      required: true,
+    }),
+    items: Property.Json({
+      displayName: 'Items',
+      description: '',
+      required: true,
+      defaultValue: [],
+    }),
+  },
+  async run(context) {
+    const token = await getAccessToken(context.auth);
+    const baseUrl = context.auth.props.baseUrl;
+
+    const url = `${baseUrl}/api/v2/public/jobs/${context.propsValue.id}/stages/${context.propsValue.stageId}/items`;
+
+    const rawBody: Record<string, unknown> = {
+      updatedAt: context.propsValue.updatedAt,
+      items: context.propsValue.items,
+    };
+
+    const body = rawBody;
+    const response = await httpClient.sendRequest({
+      method: HttpMethod.POST,
+      url: `${baseUrl}/api/v2/public/jobs/${context.propsValue.id}/stages/${context.propsValue.stageId}/items`,
+      headers: {
+        Authorization: `Bearer ${token}`,
+        'Content-Type': 'application/json',
+        'X-WorkBuddy-Version': '2026-01',
+      },
+      body: body,
+    });
+
+    return response.body;
+  },
+});
+
 export const PublicApiJobController_getStageItem = createAction({
   name: 'PublicApiJobController_getStageItem',
   auth: workbuddyAuth,
@@ -886,3 +1236,170 @@ export const PublicApiJobController_getStageItem = createAction({
     return response.body;
   },
 });
+
+export const PublicApiJobController_updateStageItem = createAction({
+  name: 'PublicApiJobController_updateStageItem',
+  auth: workbuddyAuth,
+  displayName: 'Update stage item',
+  description: 'Update mutable fields on a stage line item.',
+  props: {
+    id: Property.ShortText({
+      displayName: 'Id',
+      description: 'Job ID',
+      required: true,
+    }),
+    stageId: Property.ShortText({
+      displayName: 'Stage Id',
+      description: 'Stage ID',
+      required: true,
+    }),
+    itemId: Property.ShortText({
+      displayName: 'Item Id',
+      description: 'Item ID',
+      required: true,
+    }),
+    updatedAt: Property.DateTime({
+      displayName: 'Updated At',
+      description: 'For optimistic concurrency — update fails if entity was modified after this timestamp',
+      required: true,
+    }),
+    quantity: Property.Number({
+      displayName: 'Quantity',
+      description: '',
+      required: false,
+    }),
+    unit: Property.ShortText({
+      displayName: 'Unit',
+      description: '',
+      required: false,
+    }),
+    location: Property.ShortText({
+      displayName: 'Location',
+      description: '',
+      required: false,
+    }),
+    note: Property.ShortText({
+      displayName: 'Note',
+      description: '',
+      required: false,
+    }),
+    buyPrice: Property.Number({
+      displayName: 'Buy Price',
+      description: '',
+      required: false,
+    }),
+    sellPrice: Property.Number({
+      displayName: 'Sell Price',
+      description: '',
+      required: false,
+    }),
+    status: Property.StaticDropdown({
+      displayName: 'Status',
+      description: 'Status filter',
+      required: false,
+      options: {
+        options: [
+          { label: 'Normal', value: 'Normal' },
+          { label: 'Variation', value: 'Variation' },
+          { label: 'Cancelled', value: 'Cancelled' },
+          { label: 'Deleted', value: 'Deleted' },
+        ],
+      },
+    }),
+    invoicingStatus: Property.StaticDropdown({
+      displayName: 'Invoicing Status',
+      description: '',
+      required: false,
+      options: {
+        options: [
+          { label: 'Billable', value: 'Billable' },
+          { label: 'No Charge', value: 'No Charge' },
+          { label: 'Not Billable', value: 'Not Billable' },
+        ],
+      },
+    }),
+    suppliedBySubcontractor: Property.Checkbox({
+      displayName: 'Supplied By Subcontractor',
+      description: '',
+      required: false,
+    }),
+  },
+  async run(context) {
+    const token = await getAccessToken(context.auth);
+    const baseUrl = context.auth.props.baseUrl;
+
+    const url = `${baseUrl}/api/v2/public/jobs/${context.propsValue.id}/stages/${context.propsValue.stageId}/items/${context.propsValue.itemId}`;
+
+    // Build body with only defined values (for partial updates)
+    const rawBody: Record<string, unknown> = {
+      updatedAt: context.propsValue.updatedAt,
+      quantity: context.propsValue.quantity,
+      unit: context.propsValue.unit,
+      location: context.propsValue.location,
+      note: context.propsValue.note,
+      buyPrice: context.propsValue.buyPrice,
+      sellPrice: context.propsValue.sellPrice,
+      status: context.propsValue.status,
+      invoicingStatus: context.propsValue.invoicingStatus,
+      suppliedBySubcontractor: context.propsValue.suppliedBySubcontractor,
+    };
+
+    const body = Object.fromEntries(
+      Object.entries(rawBody).filter(([_, v]) => v !== undefined && v !== null && v !== '')
+    );
+    const response = await httpClient.sendRequest({
+      method: HttpMethod.PATCH,
+      url: `${baseUrl}/api/v2/public/jobs/${context.propsValue.id}/stages/${context.propsValue.stageId}/items/${context.propsValue.itemId}`,
+      headers: {
+        Authorization: `Bearer ${token}`,
+        'Content-Type': 'application/json',
+        'X-WorkBuddy-Version': '2026-01',
+      },
+      body: body,
+    });
+
+    return response.body;
+  },
+});
+
+export const PublicApiJobController_deleteStageItem = createAction({
+  name: 'PublicApiJobController_deleteStageItem',
+  auth: workbuddyAuth,
+  displayName: 'Delete stage item',
+  description: 'Remove or cancel a stage item depending on tenant deletion settings.',
+  props: {
+    id: Property.ShortText({
+      displayName: 'Id',
+      description: 'Job ID',
+      required: true,
+    }),
+    stageId: Property.ShortText({
+      displayName: 'Stage Id',
+      description: 'Stage ID',
+      required: true,
+    }),
+    itemId: Property.ShortText({
+      displayName: 'Item Id',
+      description: 'Item ID',
+      required: true,
+    }),
+  },
+  async run(context) {
+    const token = await getAccessToken(context.auth);
+    const baseUrl = context.auth.props.baseUrl;
+
+    const url = `${baseUrl}/api/v2/public/jobs/${context.propsValue.id}/stages/${context.propsValue.stageId}/items/${context.propsValue.itemId}`;
+
+    const response = await httpClient.sendRequest({
+      method: HttpMethod.DELETE,
+      url: `${baseUrl}/api/v2/public/jobs/${context.propsValue.id}/stages/${context.propsValue.stageId}/items/${context.propsValue.itemId}`,
+      headers: {
+        Authorization: `Bearer ${token}`,
+        'Content-Type': 'application/json',
+        'X-WorkBuddy-Version': '2026-01',
+      },
+    });
+
+    return response.body;
+  },
+});

package/src/lib/actions/mcp.d.ts

@@ -1,9 +1,9 @@
-export declare const McpStreamableController_handleGet: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").CustomAuthProperty<{
+export declare const McpV3StreamableController_handleGet: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").CustomAuthProperty<{
     baseUrl: import("@activepieces/pieces-framework").ShortTextProperty<true>;
     clientId: import("@activepieces/pieces-framework").ShortTextProperty<true>;
     clientSecret: import("@activepieces/pieces-framework").SecretTextProperty<true>;
 }>, {}>;
-export declare const McpStreamableController_handlePost: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").CustomAuthProperty<{
+export declare const McpV3StreamableController_handlePost: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").CustomAuthProperty<{
     baseUrl: import("@activepieces/pieces-framework").ShortTextProperty<true>;
     clientId: import("@activepieces/pieces-framework").ShortTextProperty<true>;
     clientSecret: import("@activepieces/pieces-framework").SecretTextProperty<true>;
@@ -13,7 +13,7 @@ export declare const McpStreamableController_handlePost: import("@activepieces/p
     id: import("@activepieces/pieces-framework").ShortTextProperty<false>;
     params: import("@activepieces/pieces-framework").JsonProperty<false>;
 }>;
-export declare const McpStreamableController_handleDelete: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").CustomAuthProperty<{
+export declare const McpV3StreamableController_handleDelete: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").CustomAuthProperty<{
     baseUrl: import("@activepieces/pieces-framework").ShortTextProperty<true>;
     clientId: import("@activepieces/pieces-framework").ShortTextProperty<true>;
     clientSecret: import("@activepieces/pieces-framework").SecretTextProperty<true>;

package/src/lib/actions/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["mcp.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iCAAiC;;;;OAwB5C,CAAC;AAEH,eAAO,MAAM,kCAAkC;;;;;;;;;EAyD7C,CAAC;AAEH,eAAO,MAAM,oCAAoC;;;;OAwB/C,CAAC"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["mcp.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,mCAAmC;;;;OAwB9C,CAAC;AAEH,eAAO,MAAM,oCAAoC;;;;;;;;;EAyD/C,CAAC;AAEH,eAAO,MAAM,sCAAsC;;;;OAwBjD,CAAC"}