@workbuddy/piece-workbuddy-edge 1.0.19 → 1.0.21

package/src/lib/actions/jobs.ts

@@ -11,7 +11,7 @@ export const PublicApiJobController_search = createAction({
   props: {
     mode: Property.StaticDropdown({
       displayName: 'Mode',
-      description: '',
+      description: 'Search mode',
       required: false,
       options: {
         options: [
@@ -22,18 +22,18 @@ export const PublicApiJobController_search = createAction({
     }),
     limit: Property.Number({
       displayName: 'Limit',
-      description: '',
+      description: 'Maximum number of results to return',
       required: false,
       defaultValue: 50,
     }),
     cursor: Property.ShortText({
       displayName: 'Cursor',
-      description: '',
+      description: 'Pagination cursor from a previous response',
       required: false,
     }),
     sortBy: Property.StaticDropdown({
       displayName: 'Sort By',
-      description: '',
+      description: 'Field to sort results by',
       required: false,
       options: {
         options: [
@@ -46,7 +46,7 @@ export const PublicApiJobController_search = createAction({
     }),
     sortDirection: Property.StaticDropdown({
       displayName: 'Sort Direction',
-      description: '',
+      description: 'Sort direction: asc or desc',
       required: false,
       options: {
         options: [
@@ -57,7 +57,7 @@ export const PublicApiJobController_search = createAction({
     }),
     status: Property.StaticMultiSelectDropdown({
       displayName: 'Status',
-      description: '',
+      description: 'Status filter',
       required: false,
       options: {
         options: [
@@ -73,12 +73,12 @@ export const PublicApiJobController_search = createAction({
     }),
     customer: Property.Array({
       displayName: 'Customer',
-      description: '',
+      description: 'Inline customer object — alternative to customerId',
       required: false,
     }),
     site: Property.Array({
       displayName: 'Site',
-      description: '',
+      description: 'Inline site object — alternative to siteId',
       required: false,
     }),
     type: Property.Array({
@@ -149,47 +149,47 @@ export const PublicApiJobController_search = createAction({
     }),
     search: Property.ShortText({
       displayName: 'Search',
-      description: '',
+      description: 'Free-text search query',
       required: false,
     }),
     createdDate: Property.Json({
       displayName: 'Created Date',
-      description: '',
+      description: 'Date range filter for creation date',
       required: false,
     }),
     dueDate: Property.Json({
       displayName: 'Due Date',
-      description: '',
+      description: 'Due date (ISO 8601 datetime)',
       required: false,
     }),
     completedDate: Property.Json({
       displayName: 'Completed Date',
-      description: '',
+      description: 'Completion date (ISO 8601 datetime)',
       required: false,
     }),
     finalisedDate: Property.Json({
       displayName: 'Finalised Date',
-      description: '',
+      description: 'Finalisation date (ISO 8601 datetime)',
       required: false,
     }),
     stageDueDate: Property.Json({
       displayName: 'Stage Due Date',
-      description: '',
+      description: 'stage due date (ISO 8601 datetime)',
       required: false,
     }),
     stageCompletedDate: Property.Json({
       displayName: 'Stage Completed Date',
-      description: '',
+      description: 'stage completed date (ISO 8601 datetime)',
       required: false,
     }),
     fields: Property.Array({
       displayName: 'Fields',
-      description: '',
+      description: 'Field projection — array of field names to include in the response',
       required: false,
     }),
     include: Property.StaticMultiSelectDropdown({
       displayName: 'Include',
-      description: '',
+      description: 'Related entities to include in the response',
       required: false,
       options: {
         options: [
@@ -298,7 +298,7 @@ export const PublicApiJobController_delete = createAction({
     }),
     reason: Property.ShortText({
       displayName: 'Reason',
-      description: '',
+      description: 'Reason for the action (e.g. cancellation reason)',
       required: true,
     }),
   },
@@ -330,117 +330,117 @@ export const PublicApiJobController_create = createAction({
   props: {
     name: Property.ShortText({
       displayName: 'Name',
-      description: '',
+      description: 'Display name',
       required: false,
     }),
     description: Property.LongText({
       displayName: 'Description',
-      description: '',
+      description: 'Detailed description',
       required: false,
     }),
     customerId: Property.ShortText({
       displayName: 'Customer Id',
-      description: '',
+      description: 'Customer ID — use /crm/customers to look up',
       required: false,
     }),
     customer: Property.Json({
       displayName: 'Customer',
-      description: '',
+      description: 'Inline customer object — alternative to customerId',
       required: false,
     }),
     siteId: Property.ShortText({
       displayName: 'Site Id',
-      description: '',
+      description: 'Site ID — use /crm/sites to look up',
       required: false,
     }),
     site: Property.Json({
       displayName: 'Site',
-      description: '',
+      description: 'Inline site object — alternative to siteId',
       required: false,
     }),
     contactId: Property.ShortText({
       displayName: 'Contact Id',
-      description: '',
+      description: 'Contact ID — use /crm/contacts to look up',
       required: false,
     }),
     contact: Property.Json({
       displayName: 'Contact',
-      description: '',
+      description: 'Inline contact object — alternative to contactId',
       required: false,
     }),
     typeId: Property.ShortText({
       displayName: 'Type Id',
-      description: '',
+      description: 'Job type ID — use /settings/job-types to look up',
       required: false,
     }),
     priorityId: Property.ShortText({
       displayName: 'Priority Id',
-      description: '',
+      description: 'Priority ID — use /settings/priorities to look up',
       required: false,
     }),
     priceBookId: Property.ShortText({
       displayName: 'Price Book Id',
-      description: '',
+      description: 'Price book ID for job pricing',
       required: false,
     }),
     ownerId: Property.ShortText({
       displayName: 'Owner Id',
-      description: '',
+      description: 'Owner (employee) ID — use /crm/employees to look up',
       required: false,
     }),
     fieldSupervisorId: Property.ShortText({
       displayName: 'Field Supervisor Id',
-      description: '',
+      description: 'Field supervisor (employee) ID — use /crm/employees to look up',
       required: false,
     }),
     zoneId: Property.ShortText({
       displayName: 'Zone Id',
-      description: '',
+      description: 'Zone ID — use /settings/zones to look up',
       required: false,
     }),
     tagIds: Property.Array({
       displayName: 'Tag Ids',
-      description: '',
+      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: '',
+      description: 'Additional notes or comments',
       required: false,
     }),
     reference: Property.ShortText({
       displayName: 'Reference',
-      description: '',
+      description: 'External reference number',
       required: false,
     }),
     customerWO: Property.ShortText({
       displayName: 'Customer W O',
-      description: '',
+      description: 'Customer work order reference',
       required: false,
     }),
     customerPO: Property.ShortText({
       displayName: 'Customer P O',
-      description: '',
+      description: 'Customer purchase order reference',
       required: false,
     }),
     templateId: Property.ShortText({
       displayName: 'Template Id',
-      description: '',
+      description: 'Template ID to pre-populate fields from a template',
       required: false,
     }),
     startDate: Property.DateTime({
       displayName: 'Start Date',
-      description: '',
+      description: 'Start date (ISO 8601 datetime)',
       required: false,
     }),
     dueDate: Property.DateTime({
       displayName: 'Due Date',
-      description: '',
+      description: 'Due date (ISO 8601 datetime)',
       required: false,
     }),
     customFields: Property.Json({
       displayName: 'Custom Fields',
-      description: '',
+      description: 'Custom fields as key-value pairs — validated against tenant field definitions',
       required: false,
     }),
   },
@@ -505,97 +505,97 @@ export const PublicApiJobController_update = createAction({
     }),
     updatedAt: Property.DateTime({
       displayName: 'Updated At',
-      description: '',
+      description: 'For optimistic concurrency — update fails if entity was modified after this timestamp',
       required: false,
     }),
     name: Property.ShortText({
       displayName: 'Name',
-      description: '',
+      description: 'Display name',
       required: false,
     }),
     description: Property.LongText({
       displayName: 'Description',
-      description: '',
+      description: 'Detailed description',
       required: false,
     }),
     siteId: Property.ShortText({
       displayName: 'Site Id',
-      description: '',
+      description: 'Site ID — use /crm/sites to look up',
       required: false,
     }),
     contactId: Property.ShortText({
       displayName: 'Contact Id',
-      description: '',
+      description: 'Contact ID — use /crm/contacts to look up',
       required: false,
     }),
     typeId: Property.ShortText({
       displayName: 'Type Id',
-      description: '',
+      description: 'Job type ID — use /settings/job-types to look up',
       required: false,
     }),
     priorityId: Property.ShortText({
       displayName: 'Priority Id',
-      description: '',
+      description: 'Priority ID — use /settings/priorities to look up',
       required: false,
     }),
     priceBookId: Property.ShortText({
       displayName: 'Price Book Id',
-      description: '',
+      description: 'Price book ID for job pricing',
       required: false,
     }),
     ownerId: Property.ShortText({
       displayName: 'Owner Id',
-      description: '',
+      description: 'Owner (employee) ID — use /crm/employees to look up',
       required: false,
     }),
     fieldSupervisorId: Property.ShortText({
       displayName: 'Field Supervisor Id',
-      description: '',
+      description: 'Field supervisor (employee) ID — use /crm/employees to look up',
       required: false,
     }),
     zoneId: Property.ShortText({
       displayName: 'Zone Id',
-      description: '',
+      description: 'Zone ID — use /settings/zones to look up',
       required: false,
     }),
     tagIds: Property.Array({
       displayName: 'Tag Ids',
-      description: '',
+      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: '',
+      description: 'Additional notes or comments',
       required: false,
     }),
     reference: Property.ShortText({
       displayName: 'Reference',
-      description: '',
+      description: 'External reference number',
       required: false,
     }),
     customerWO: Property.ShortText({
       displayName: 'Customer W O',
-      description: '',
+      description: 'Customer work order reference',
       required: false,
     }),
     customerPO: Property.ShortText({
       displayName: 'Customer P O',
-      description: '',
+      description: 'Customer purchase order reference',
       required: false,
     }),
     startDate: Property.DateTime({
       displayName: 'Start Date',
-      description: '',
+      description: 'Start date (ISO 8601 datetime)',
       required: false,
     }),
     dueDate: Property.DateTime({
       displayName: 'Due Date',
-      description: '',
+      description: 'Due date (ISO 8601 datetime)',
       required: false,
     }),
     customFields: Property.Json({
       displayName: 'Custom Fields',
-      description: '',
+      description: 'Custom fields as key-value pairs — validated against tenant field definitions',
       required: false,
     }),
   },

package/src/lib/actions/mcp.js

@@ -47,7 +47,7 @@ exports.McpStreamableController_handlePost = (0, pieces_framework_1.createAction
         }),
         id: pieces_framework_1.Property.ShortText({
             displayName: 'Id',
-            description: '',
+            description: 'Entity ID',
             required: false,
         }),
         params: pieces_framework_1.Property.Json({

package/src/lib/actions/mcp.js.map

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

package/src/lib/actions/mcp.ts

@@ -49,7 +49,7 @@ export const McpStreamableController_handlePost = createAction({
     }),
     id: Property.ShortText({
       displayName: 'Id',
-      description: '',
+      description: 'Entity ID',
       required: false,
     }),
     params: Property.Json({

package/src/lib/actions/stages-activities.js

@@ -12,7 +12,7 @@ exports.PublicStageActivitiesController_list = (0, pieces_framework_1.createActi
     props: {
         stageId: pieces_framework_1.Property.ShortText({
             displayName: 'Stage Id',
-            description: '',
+            description: 'Stage ID or stage number',
             required: true,
         }),
         jobId: pieces_framework_1.Property.ShortText({
@@ -45,7 +45,7 @@ exports.PublicStageActivitiesController_getById = (0, pieces_framework_1.createA
     props: {
         stageId: pieces_framework_1.Property.ShortText({
             displayName: 'Stage Id',
-            description: '',
+            description: 'Stage ID or stage number',
             required: true,
         }),
         id: pieces_framework_1.Property.ShortText({
@@ -83,7 +83,7 @@ exports.PublicStageActivitiesController_delete = (0, pieces_framework_1.createAc
     props: {
         stageId: pieces_framework_1.Property.ShortText({
             displayName: 'Stage Id',
-            description: '',
+            description: 'Stage ID or stage number',
             required: true,
         }),
         id: pieces_framework_1.Property.ShortText({
@@ -121,7 +121,7 @@ exports.PublicStageActivitiesController_createNote = (0, pieces_framework_1.crea
     props: {
         stageId: pieces_framework_1.Property.ShortText({
             displayName: 'Stage Id',
-            description: '',
+            description: 'Stage ID or stage number',
             required: true,
         }),
         jobId: pieces_framework_1.Property.ShortText({
@@ -131,22 +131,22 @@ exports.PublicStageActivitiesController_createNote = (0, pieces_framework_1.crea
         }),
         body: pieces_framework_1.Property.ShortText({
             displayName: 'Body',
-            description: '',
+            description: 'Message body content (HTML supported for email)',
             required: true,
         }),
         labelIds: pieces_framework_1.Property.Array({
             displayName: 'Label Ids',
-            description: '',
+            description: 'Array of label/tag IDs to attach (comma-separated, e.g. "id1,id2")',
             required: false,
         }),
         attachmentIds: pieces_framework_1.Property.Array({
             displayName: 'Attachment Ids',
-            description: '',
+            description: 'Attachment IDs from the upload endpoint (comma-separated, e.g. "id1,id2")',
             required: false,
         }),
         sharing: pieces_framework_1.Property.Json({
             displayName: 'Sharing',
-            description: '',
+            description: 'Sharing options — control visibility to customer portal and field app',
             required: false,
         }),
     },
@@ -182,7 +182,7 @@ exports.PublicStageActivitiesController_createEmail = (0, pieces_framework_1.cre
     props: {
         stageId: pieces_framework_1.Property.ShortText({
             displayName: 'Stage Id',
-            description: '',
+            description: 'Stage ID or stage number',
             required: true,
         }),
         jobId: pieces_framework_1.Property.ShortText({
@@ -192,47 +192,47 @@ exports.PublicStageActivitiesController_createEmail = (0, pieces_framework_1.cre
         }),
         templateId: pieces_framework_1.Property.ShortText({
             displayName: 'Template Id',
-            description: '',
+            description: 'Template ID to pre-populate fields from a template',
             required: false,
         }),
         subject: pieces_framework_1.Property.ShortText({
             displayName: 'Subject',
-            description: '',
+            description: 'Email subject line',
             required: false,
         }),
         body: pieces_framework_1.Property.ShortText({
             displayName: 'Body',
-            description: '',
+            description: 'Message body content (HTML supported for email)',
             required: false,
         }),
         to: pieces_framework_1.Property.Array({
             displayName: 'To',
-            description: 'Enter email values',
+            description: 'Recipients',
             required: false,
         }),
         cc: pieces_framework_1.Property.Array({
             displayName: 'Cc',
-            description: 'Enter email values',
+            description: 'CC recipients',
             required: false,
         }),
         bcc: pieces_framework_1.Property.Array({
             displayName: 'Bcc',
-            description: 'Enter email values',
+            description: 'BCC recipients',
             required: false,
         }),
         labelIds: pieces_framework_1.Property.Array({
             displayName: 'Label Ids',
-            description: '',
+            description: 'Array of label/tag IDs to attach (comma-separated, e.g. "id1,id2")',
             required: false,
         }),
         attachmentIds: pieces_framework_1.Property.Array({
             displayName: 'Attachment Ids',
-            description: '',
+            description: 'Attachment IDs from the upload endpoint (comma-separated, e.g. "id1,id2")',
             required: false,
         }),
         sharing: pieces_framework_1.Property.Json({
             displayName: 'Sharing',
-            description: '',
+            description: 'Sharing options — control visibility to customer portal and field app',
             required: false,
         }),
     },
@@ -273,7 +273,7 @@ exports.PublicStageActivitiesController_createSms = (0, pieces_framework_1.creat
     props: {
         stageId: pieces_framework_1.Property.ShortText({
             displayName: 'Stage Id',
-            description: '',
+            description: 'Stage ID or stage number',
             required: true,
         }),
         jobId: pieces_framework_1.Property.ShortText({
@@ -283,27 +283,27 @@ exports.PublicStageActivitiesController_createSms = (0, pieces_framework_1.creat
         }),
         templateId: pieces_framework_1.Property.ShortText({
             displayName: 'Template Id',
-            description: '',
+            description: 'Template ID to pre-populate fields from a template',
             required: false,
         }),
         body: pieces_framework_1.Property.ShortText({
             displayName: 'Body',
-            description: '',
+            description: 'Message body content (HTML supported for email)',
             required: false,
         }),
         to: pieces_framework_1.Property.Array({
             displayName: 'To',
-            description: 'Enter mobile values',
+            description: 'Recipients',
             required: false,
         }),
         labelIds: pieces_framework_1.Property.Array({
             displayName: 'Label Ids',
-            description: '',
+            description: 'Array of label/tag IDs to attach (comma-separated, e.g. "id1,id2")',
             required: false,
         }),
         sharing: pieces_framework_1.Property.Json({
             displayName: 'Sharing',
-            description: '',
+            description: 'Sharing options — control visibility to customer portal and field app',
             required: false,
         }),
     },
@@ -340,7 +340,7 @@ exports.PublicStageActivitiesController_createPhone = (0, pieces_framework_1.cre
     props: {
         stageId: pieces_framework_1.Property.ShortText({
             displayName: 'Stage Id',
-            description: '',
+            description: 'Stage ID or stage number',
             required: true,
         }),
         jobId: pieces_framework_1.Property.ShortText({
@@ -382,22 +382,22 @@ exports.PublicStageActivitiesController_createPhone = (0, pieces_framework_1.cre
         }),
         callDate: pieces_framework_1.Property.DateTime({
             displayName: 'Call Date',
-            description: '',
+            description: 'call date (ISO 8601 datetime)',
             required: false,
         }),
         body: pieces_framework_1.Property.ShortText({
             displayName: 'Body',
-            description: '',
+            description: 'Message body content (HTML supported for email)',
             required: false,
         }),
         labelIds: pieces_framework_1.Property.Array({
             displayName: 'Label Ids',
-            description: '',
+            description: 'Array of label/tag IDs to attach (comma-separated, e.g. "id1,id2")',
             required: false,
         }),
         sharing: pieces_framework_1.Property.Json({
             displayName: 'Sharing',
-            description: '',
+            description: 'Sharing options — control visibility to customer portal and field app',
             required: false,
         }),
     },
@@ -436,7 +436,7 @@ exports.PublicStageActivitiesController_createIntegration = (0, pieces_framework
     props: {
         stageId: pieces_framework_1.Property.ShortText({
             displayName: 'Stage Id',
-            description: '',
+            description: 'Stage ID or stage number',
             required: true,
         }),
         jobId: pieces_framework_1.Property.ShortText({
@@ -446,7 +446,7 @@ exports.PublicStageActivitiesController_createIntegration = (0, pieces_framework
         }),
         body: pieces_framework_1.Property.ShortText({
             displayName: 'Body',
-            description: '',
+            description: 'Message body content (HTML supported for email)',
             required: true,
         }),
         integrationType: pieces_framework_1.Property.ShortText({
@@ -456,7 +456,7 @@ exports.PublicStageActivitiesController_createIntegration = (0, pieces_framework
         }),
         sharing: pieces_framework_1.Property.Json({
             displayName: 'Sharing',
-            description: '',
+            description: 'Sharing options — control visibility to customer portal and field app',
             required: false,
         }),
     },