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

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

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.

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,
+        syncToken: data.syncToken ?? null,
       },
     }
   },
@@ -139,5 +149,11 @@ export const listJobsTool: ToolConfig<AshbyListJobsParams, AshbyListJobsResponse
       description: 'Opaque cursor for fetching the next page',
       optional: true,
     },
+    syncToken: {
+      type: 'string',
+      description:
+        'Opaque sync token returned after the last page; pass on the next sync to fetch only changed jobs',
+      optional: true,
+    },
   },
 }