@bigfootai/bigfoot-types 5.4.270 → 5.4.272

package/src/metadata/providers/zendesk.ts

@@ -0,0 +1,61 @@
+import { BlockType } from '../../block-type.js';
+import type { Provider, ProviderApplication } from '../../provider.js';
+import { TagType } from '../../tag-type.js';
+
+export const ZendeskSupport: ProviderApplication = {
+	name: 'support',
+	sobjects: {
+		calendar: false,
+		transcription: false,
+		message: false,
+		email: false,
+		table: true,
+		function: false,
+	},
+	linkSubscriptions: ['*.zendesk.com'],
+	linkToExternalIdRegex: '([a-zA-Z0-9]{15,18})(?=[^a-zA-Z0-9]|$)',
+	recordTypeSubscriptions: ['ticket'],
+	description: "Add Ticket previews and monitor changes over time so you're always up-to-date.",
+	iconUrl: 'https://upload.wikimedia.org/wikipedia/commons/c/c8/Zendesk_logo.svg',
+	label: 'Zendesk Support',
+	authentication: true,
+	externalStorage: true,
+	externalInsights: false,
+	externalIds: [
+		{
+			label: 'Organization',
+			blockType: BlockType.Record,
+			tagType: TagType.Topic,
+			tagSubType: 'organization',
+			metadataType: 'organization',
+		},
+		{
+			label: 'Requester',
+			blockType: BlockType.Record,
+			tagType: TagType.Person,
+			tagSubType: 'contact',
+			metadataType: 'user',
+		},
+		{
+			label: 'Assignee',
+			blockType: BlockType.Record,
+			tagType: TagType.Person,
+			tagSubType: 'user',
+			metadataType: 'user',
+		},
+	],
+};
+
+export const Zendesk: Provider = {
+	_id: '69324e6b52efca8f946f1b99',
+	archived: false,
+	dateCreated: 0,
+	dateUpdated: 0,
+	name: 'zendesk',
+	description: 'Zendesk automation for Noded',
+	instanceUrl: 'https://connect-zendesk-dev.getnoded.ai',
+	applications: [ZendeskSupport],
+	label: 'Zendesk',
+	iconUrl: 'https://upload.wikimedia.org/wikipedia/commons/c/c8/Zendesk_logo.svg',
+	promptMetadata: [],
+};

package/src/provider.ts

@@ -140,6 +140,16 @@ export interface ProviderApplication {
 	iconUrl?: string;
 	sobjects: StandardObjects;
 	agentMetadata?: AgentMetadata;
+	/**
+	 * Regex patterns (one per supported URL shape) used to decide whether a pasted link should be
+	 * routed to this application for ingestion. Patterns are tested case-insensitively against the
+	 * full URL (`URL.href`), so authors should anchor with `^https://` and escape literal dots.
+	 *
+	 * Example — Jira tickets only, not Confluence pages on the same host:
+	 *   `^https://[^/]+\\.atlassian\\.net/browse/[A-Z][A-Z0-9]+-\\d+`
+	 *
+	 * A URL that does not match any pattern falls through to generic website ingestion.
+	 */
 	linkSubscriptions?: string[];
 	linkToExternalIdRegex?: string;
 	emailComposerLink?: string;

package/src/recommendation.ts

@@ -6,6 +6,7 @@ import type { BusinessObjectLink } from './business-object-link.js';
 import type { ConnectedProvider } from './connected-provider.js';
 import type { Document } from './document.js';
 import type { Email } from './email.js';
+import type { Field } from './field.js';
 import type { FieldValue } from './field-value.js';
 import type { Folder } from './folder.js';
 import type { InstalledFunction } from './installed-function.js';
@@ -45,6 +46,7 @@ export enum RecommendationType {
 	SyncFailure = 'sync_failure',
 	SyncPaused = 'sync_paused',
 	MetadataChange = 'metadata_change',
+	TaskHousekeeping = 'task_housekeeping',
 	Thread = 'thread',
 	Upsert = 'upsert',
 }
@@ -99,15 +101,22 @@ export interface ChangeRecommendation {
 
 export const RecommendationValueChangeQL = `
 type RecommendationValueChange {
+	field: Field
 	fieldName: String!
 	previousValue: String
 	currentValue: String
+	table: Table
 }`;
 
 export interface RecommendationValueChange {
 	currentValue?: string;
+	// GraphQL-resolved — not stored in MongoDB
+	field?: Field;
 	fieldName: string;
 	previousValue?: string;
+	// GraphQL-resolved — not stored in MongoDB
+	table?: Table;
+	tableId?: string;
 }
 
 export const NotificationRecommendationQL = `

package/src/signal.ts

@@ -38,6 +38,7 @@ input SetSignalValueInput {
   fieldName: String!
   tableId: ID!
   tagId: ID!
+  reason: String
   value: String
 }`;
 
@@ -87,6 +88,7 @@ export interface SetSignalValueInput {
 	fieldName: string;
 	tableId: string;
 	tagId: string;
+	reason?: string | null;
 	value?: string | null;
 }
 

package/src/tag.ts

@@ -53,19 +53,19 @@ export class Tag extends Primitive {
 	sharingDomains?: SharingDomain[]; // The domains this tag is shared with plus domain settings for the tag
 	sharingTenants?: SharingTenant[]; // The tenants this tag is shared with plus tenant settings for the tag
 	tenantSettings?: TagTenantSetting[]; // The settings for individual tenants
-	url?: string;
+	url?: string | null;
 	urls: string[]; // All URLs associated with this tag
 	phoneNumber?: string;
 	favicon?: string;
 	email?: string;
-	emailDomain?: string;
+	emailDomain?: string | null;
 	avatar?: string;
 	description?: string; // An arbirary field to give additional descriptive information that doesn't have any validation
 	uri?: string; // This is used for external tags so we can open them
 	externalId?: string; // This is used for external tags that match with records
 	inviteStatus?: InviteStatus;
 	tenantIdInvite?: string;
-	tenantIdVerified?: string; // The tenant._id that claimed/verified this tag as being them
+	tenantIdVerified?: string | null; // The tenant._id that claimed/verified this tag as being them
 	private?: boolean; // Indicates if the tag exists, but the user can't see it
 	autoTag?: boolean; // This is really a virtualized property
 	favorite?: boolean; // This is really a virtualized property

package/src/transcription-section.ts

@@ -20,6 +20,6 @@ export interface TranscriptionSection {
 	name: string;
 	label?: string;
 	summaryHtml?: string;
-	summaryDocument?: string;
+	summaryDocument?: string | null;
 	timedEntries?: TimedEntry[];
 }

package/src/types.ts

@@ -35,6 +35,7 @@ import {
 	BlockActivitySignalOverrideTriggerCancelledDetailQL,
 	BlockActivitySignalOverrideTriggeredDetailQL,
 	BlockActivitySignalOverrideTriggerSetDetailQL,
+	BlockActivitySignalValueChangedDetailQL,
 	BlockActivityStatusChangedDetailQL,
 	BlockActivityTagDetailQL,
 	BlockActivityTypeQL,
@@ -295,6 +296,7 @@ export enum RecommendationType {
 	SyncFailure = 'sync_failure',
 	SyncPaused = 'sync_paused',
 	MetadataChange = 'metadata_change',
+	TaskHousekeeping = 'task_housekeeping',
 	Thread = 'thread',
 	Upsert = 'upsert',
 }
@@ -1253,7 +1255,7 @@ export interface UninstallProviderFunctionResult {
 export const InstallProviderQueryInputQL = `
 input InstallProviderQueryInput {
 	application: String!
-	connectionId: String!
+	connectionId: String
 	invocationGuidance: String
 	label: String
 	provider: String!
@@ -1264,7 +1266,10 @@ input InstallProviderQueryInput {
 }`;
 export interface InstallProviderQueryInput {
 	application: string;
-	connectionId: string;
+	// Required when installing a new query (used to pick the connection at design
+	// time and derive the stable `instanceId`). Optional on edit (queryId present):
+	// the existing query's `instanceId` is reused, so the editor need not re-pick.
+	connectionId?: string;
 	invocationGuidance?: string;
 	label?: string;
 	provider: string;
@@ -1618,6 +1623,7 @@ input UpsertNoteInput {
 	templateReferenceBlock: ReferenceBlockInput
   title: String
   templateInstructions: String
+  recommendationId: String
 }`;
 export interface UpsertNoteInput {
 	_id?: string;
@@ -1629,6 +1635,7 @@ export interface UpsertNoteInput {
 	templateReferenceBlock?: ReferenceBlock;
 	title?: string;
 	templateInstructions?: string;
+	recommendationId?: string;
 }
 
 export const FindBlockInputQL = `
@@ -2232,10 +2239,10 @@ input UpsertTaskInput {${BlockFieldsForUpsert}
   proposed: Boolean
 }`;
 export interface UpsertTaskInput {
-	_id?: string;
+	_id?: string | null;
 	dateDue?: number | null;
 	dateRemindMe?: number | null;
-	document?: string;
+	document?: string | null;
 	favorite?: boolean;
 	parentReferenceBlock?: ReferenceBlock;
 	parentId?: string;
@@ -2816,6 +2823,7 @@ export const GraphSearchInputFields = `
 	tags: [TagFilterItemInput]
 	scopeToOwnTasks: Boolean
 	scopeToPriorityTasks: Boolean
+	scopeToHousekeepingTasks: Boolean
 `;
 export const GraphSearchFields = `
 	search: String
@@ -2908,6 +2916,12 @@ export interface GraphSearchInput extends PaginatedInput {
 	 * assigned to. Composes with tag/folder constraints for topic scoping.
 	 */
 	scopeToPriorityTasks?: boolean;
+	/**
+	 * When true, applies the "task housekeeping" preset: restricts to non-completed, non-generated
+	 * Task blocks created 7 or more days ago (in tenant timezone), scoped to tasks the tenant created
+	 * or is assigned to. This is the same preset used by the task housekeeping recommendation system.
+	 */
+	scopeToHousekeepingTasks?: boolean;
 }
 
 export const GraphSearchChangedPayloadQL = `
@@ -3446,6 +3460,7 @@ ${BlockActivitySignalOverrideExpiryCancelledDetailQL}
 ${BlockActivitySignalOverrideExpiredDetailQL}
 ${BlockActivitySignalOverrideTriggerSetDetailQL}
 ${BlockActivitySignalOverrideTriggeredDetailQL}
+${BlockActivitySignalValueChangedDetailQL}
 ${BlockActivitySignalOverrideTriggerCancelledDetailQL}
 ${BlockActivityDetailQL}
 ${BlockActivityQL}