feat(tools): add incremental job sync and draft postings to Ashby reads

list_jobs accepts Ashby's syncToken and returns it as nextSyncCursor, so a
scheduled sync costs O(changed reqs) instead of rescanning every req. Ashby only
returns the token once the last page is drained, which the param description
states.

The output is named as a cursor deliberately. It is an opaque resumption marker,
not a credential, so it belongs with nextCursor - and a field literally named
syncToken matches the /^.*token$/i deny-list in redaction and renders as
[REDACTED], which makes an incremental sync unusable since the operator cannot
read the value the next run needs. The wire name stays syncToken.

list_job_postings gains includeUnpublishedJobPostings, plus the posting status
field - without status a caller cannot tell a returned draft from a published
posting, which makes the flag useless.

Also widens the custom field valueLabel type, which MultiValueSelect returns as
an array, for the write operations that follow.

Author: mzxchandra

apps/sim/tools/ashby/list_job_postings.ts

@@ -6,6 +6,7 @@ interface AshbyListJobPostingsParams {
   location?: string
   department?: string
   listedOnly?: boolean
+  includeUnpublishedJobPostings?: boolean
   jobBoardId?: string
 }
 
@@ -22,6 +23,7 @@ interface AshbyJobPostingSummary {
   } | null
   workplaceType: string | null
   employmentType: string | null
+  status: string | null
   isListed: boolean
   publishedDate: string | null
   applicationDeadline: string | null
@@ -72,6 +74,13 @@ export const listJobPostingsTool: ToolConfig<
       visibility: 'user-or-llm',
       description: 'When true, only returns listed (publicly visible) job postings (default false)',
     },
+    includeUnpublishedJobPostings: {
+      type: 'boolean',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'When true, also returns unpublished (Draft) job postings. The endpoint already returns both listed and unlisted published postings by default, so this only adds drafts.',
+    },
     jobBoardId: {
       type: 'string',
       required: false,
@@ -90,6 +99,9 @@ export const listJobPostingsTool: ToolConfig<
       if (params.location) body.location = params.location
       if (params.department) body.department = params.department
       if (params.listedOnly !== undefined) body.listedOnly = params.listedOnly
+      if (params.includeUnpublishedJobPostings !== undefined) {
+        body.includeUnpublishedJobPostings = params.includeUnpublishedJobPostings
+      }
       if (params.jobBoardId) body.jobBoardId = params.jobBoardId.trim()
       return body
     },
@@ -127,6 +139,7 @@ export const listJobPostingsTool: ToolConfig<
               : null,
             workplaceType: (jp.workplaceType as string) ?? null,
             employmentType: (jp.employmentType as string) ?? null,
+            status: (jp.status as string) ?? null,
             isListed: (jp.isListed as boolean) ?? false,
             publishedDate: (jp.publishedDate as string) ?? null,
             applicationDeadline: (jp.applicationDeadline as string) ?? null,
@@ -186,6 +199,11 @@ export const listJobPostingsTool: ToolConfig<
             description: 'Employment type (FullTime, PartTime, Intern, Contract, Temporary)',
             optional: true,
           },
+          status: {
+            type: 'string',
+            description: 'Posting status (Draft or Published)',
+            optional: true,
+          },
           isListed: { type: 'boolean', description: 'Whether the posting is publicly listed' },
           publishedDate: {
             type: 'string',

apps/sim/tools/ashby/list_jobs.ts

@@ -26,7 +26,15 @@ export const listJobsTool: ToolConfig<AshbyListJobsParams, AshbyListJobsResponse
       type: 'number',
       required: false,
       visibility: 'user-or-llm',
-      description: 'Number of results per page (default 100)',
+      description:
+        'Number of results per page (default and max 100). Ashby silently caps larger values rather than erroring.',
+    },
+    syncToken: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'Opaque token from a prior sync to fetch only jobs changed since then. Ashby only returns a new syncToken on the last page, so drain moreDataAvailable/nextCursor before persisting it.',
     },
     status: {
       type: 'string',
@@ -75,6 +83,7 @@ export const listJobsTool: ToolConfig<AshbyListJobsParams, AshbyListJobsResponse
       const body: Record<string, unknown> = { expand: ['openings', 'location'] }
       if (params.cursor) body.cursor = params.cursor
       if (params.perPage) body.limit = params.perPage
+      if (params.syncToken) body.syncToken = params.syncToken
       if (params.status) body.status = [params.status]
       const isoToMs = (iso: string): number | null => {
         const ms = new Date(iso).getTime()
@@ -117,6 +126,7 @@ export const listJobsTool: ToolConfig<AshbyListJobsParams, AshbyListJobsResponse
         jobs: (data.results ?? []).map(mapJob),
         moreDataAvailable: data.moreDataAvailable ?? false,
         nextCursor: data.nextCursor ?? null,
+        nextSyncCursor: data.syncToken ?? null,
       },
     }
   },
@@ -139,5 +149,11 @@ export const listJobsTool: ToolConfig<AshbyListJobsParams, AshbyListJobsResponse
       description: 'Opaque cursor for fetching the next page',
       optional: true,
     },
+    nextSyncCursor: {
+      type: 'string',
+      description:
+        "Ashby's syncToken for the next incremental run, returned only once the last page is drained. Named as a cursor because that is what it is - an opaque resumption marker, not a credential - so it stays readable in block output alongside nextCursor.",
+      optional: true,
+    },
   },
 }

apps/sim/tools/ashby/types.ts

@@ -31,7 +31,7 @@ export interface AshbyCustomField {
   id: string | null
   title: string
   isPrivate: boolean
-  valueLabel: string | null
+  valueLabel: string | string[] | null
   value: unknown
 }
 
@@ -122,6 +122,7 @@ export interface AshbySearchCandidatesParams extends AshbyBaseParams {
 export interface AshbyListJobsParams extends AshbyBaseParams {
   cursor?: string
   perPage?: number
+  syncToken?: string
   status?: string
   createdAfter?: string
   openedAfter?: string
@@ -266,6 +267,7 @@ export interface AshbyListJobsResponse extends ToolResponse {
     jobs: AshbyJob[]
     moreDataAvailable: boolean
     nextCursor: string | null
+    nextSyncCursor: string | null
   }
 }