@bigfootai/bigfoot-types 5.4.259 → 5.4.261

package/src/metadata-change.ts

@@ -1,5 +1,6 @@
 import type { Agent } from './agent.js';
 import type { Field } from './field.js';
+import type { InstalledFunction } from './installed-function.js';
 import type { PendingMetadataChange } from './pending-metadata-change.js';
 import type { Table } from './table.js';
 import type { Tag } from './tag.js';
@@ -10,12 +11,16 @@ export const MetadataChangeTypeQL = `
     DELETE_FIELD
     DELETE_FOLDER
     UPDATE_FOLDER_TAGS
+    UNINSTALL_FUNCTION
+    UNINSTALL_QUERY
   }`;
 export enum MetadataChangeType {
 	DeleteTable = 'delete_table',
 	DeleteField = 'delete_field',
 	DeleteFolder = 'delete_folder',
 	UpdateFolderTags = 'update_folder_tags',
+	UninstallFunction = 'uninstall_function',
+	UninstallQuery = 'uninstall_query',
 }
 
 export const MetadataChangeImpactLevelQL = `
@@ -33,6 +38,8 @@ export enum MetadataChangeImpactLevel {
 export interface AssessMetadataChangeInput {
 	fieldName?: string;
 	folderId?: string;
+	functionId?: string;
+	queryId?: string;
 	tableId?: string;
 	tagIdsToRemove?: string[];
 	type: MetadataChangeType;
@@ -40,11 +47,26 @@ export interface AssessMetadataChangeInput {
 
 export interface MetadataChangeDependencies {
 	agents: AgentDependency[];
+	functions: FunctionDependency[];
+	invocations: FunctionInvocationDependency;
 	records: RecordDependency;
 	signals: SignalDependency[];
 	tags: TagDependency[];
 }
 
+// Used by `UninstallFunction` changes — surfaces other-tenant FunctionInvocation
+// blocks so reviewers can see who would lose the install. Shape mirrors
+// `RecordDependency` (count + per-tenant breakdown) since "Major when others have
+// used this" is the same impact question.
+export interface FunctionInvocationDependency {
+	count: number;
+	invokedByTenants: {
+		count: number;
+		lastInvokedAt: number;
+		tag: Tag;
+	}[];
+}
+
 export interface AgentDependency {
 	action: 'disable';
 	agent: Agent | null;
@@ -52,6 +74,17 @@ export interface AgentDependency {
 	triggerReference: string;
 }
 
+export interface FunctionDependency {
+	// `disable_and_unbind` is the only action today: we flip `enabled=false` on the
+	// function (so Nelly stops recommending it) and rewrite any inputs whose
+	// `valueSource` targeted the deleted signal back to `userInput`.
+	action: 'disable_and_unbind';
+	function: InstalledFunction | null;
+	hasInvocations: boolean;
+	inputNames: string[];
+	owner: Tag;
+}
+
 export interface SignalDependency {
 	action: 'remove_signal' | 'remove_data_reference';
 	field: Field | null;
@@ -86,6 +119,8 @@ export interface AssessMetadataChangeResult {
 
 export interface CleanupSummary {
 	agentsDisabled: number;
+	functionsDisabled: number;
+	functionInputsUnbound: number;
 	signalReferencesRemoved: number;
 	signalsRemoved: number;
 	tagsUpdated: number;
@@ -113,6 +148,8 @@ export const MetadataChangeQL = `
   input AssessMetadataChangeInput {
     fieldName: String
     folderId: String
+    functionId: String
+    queryId: String
     tableId: String
     tagIdsToRemove: [String!]
     type: MetadataChangeType!
@@ -121,6 +158,8 @@ export const MetadataChangeQL = `
   type AssessMetadataChangeSpec {
     fieldName: String
     folderId: String
+    functionId: String
+    queryId: String
     tableId: String
     tagIdsToRemove: [String!]
     type: MetadataChangeType!
@@ -133,6 +172,14 @@ export const MetadataChangeQL = `
     triggerReference: String!
   }
 
+  type FunctionDependency {
+    action: String!
+    function: InstalledFunction
+    hasInvocations: Boolean!
+    inputNames: [String!]!
+    owner: Tag!
+  }
+
   type SignalDependency {
     action: String!
     field: Field
@@ -156,8 +203,21 @@ export const MetadataChangeQL = `
     generatedByTenants: [GeneratedByTenantRecordDependency!]!
   }
 
+  type InvokedByTenantFunctionDependency {
+    count: Int!
+    lastInvokedAt: Float!
+    tag: Tag!
+  }
+
+  type FunctionInvocationDependency {
+    count: Int!
+    invokedByTenants: [InvokedByTenantFunctionDependency!]!
+  }
+
   type MetadataChangeDependencies {
     agents: [AgentDependency!]!
+    functions: [FunctionDependency!]!
+    invocations: FunctionInvocationDependency!
     records: RecordDependency!
     signals: [SignalDependency!]!
     tags: [TagDependency!]!
@@ -176,6 +236,8 @@ export const MetadataChangeQL = `
 
   type CleanupSummary {
     agentsDisabled: Int!
+    functionsDisabled: Int!
+    functionInputsUnbound: Int!
     signalReferencesRemoved: Int!
     signalsRemoved: Int!
     tagsUpdated: Int!

package/src/provider.ts

@@ -3,6 +3,7 @@ import type { Field } from './field.js';
 import type { FunctionMetadata } from './function-metadata.js';
 import { Metadata, MetadataFields } from './metadata.js';
 import { Primitive, PrimitiveFields } from './primitive.js';
+import type { QueryMetadata } from './query-metadata.js';
 import type { TableMetadata } from './table-metadata.js';
 import type { TagType } from './tag-type.js';
 
@@ -154,6 +155,11 @@ export interface ProviderApplication {
 	 * `recordTypeSubscriptions` ties tables to applications.
 	 */
 	functionTypeSubscriptions?: string[];
+	/**
+	 * Names (metadataTypes) of the queries in the parent Provider's
+	 * `queryMetadata` array that this application exposes.
+	 */
+	queryTypeSubscriptions?: string[];
 	tagTypeSubscriptions?: TagTypeSubscription[];
 	webhookSubscriptions?: WebhookSubscription[];
 	externalIds?: ExternalId[];
@@ -177,6 +183,7 @@ type ProviderApplication {
 	recordTypeSubscriptions: [String]
 	documentTypeSubscriptions: [String]
 	functionTypeSubscriptions: [String]
+	queryTypeSubscriptions: [String]
 	tagTypeSubscriptions: [TagTypeSubscription]
 	webhookSubscriptions: [WebhookSubscription]
 	externalIds: [ExternalId]
@@ -243,6 +250,7 @@ export class Provider extends Primitive {
 	tableMetadata?: TableMetadata[];
 	documentMetadata?: DocumentMetadata[];
 	functionMetadata?: FunctionMetadata[];
+	queryMetadata?: QueryMetadata[];
 	_tenantId?: string;
 
 	constructor(
@@ -275,5 +283,6 @@ type Provider {${PrimitiveFields}
 	tableMetadata: [TableMetadata]
 	documentMetadata: [DocumentMetadata]
 	functionMetadata: [FunctionMetadata]
+	queryMetadata: [QueryMetadata]
 	subscriptionPubSubType: String
 }`;

package/src/query-metadata.ts

@@ -0,0 +1,72 @@
+import type { Field } from './field.js';
+import { Metadata, MetadataFields, MetadataInputFields } from './metadata.js';
+
+export enum SearchOperator {
+	Between = 'between',
+	Contains = 'contains',
+	Equals = 'equals',
+	Gte = 'gte',
+	Lte = 'lte',
+	StartsWith = 'starts_with',
+}
+
+export const SearchOperatorQL = `
+enum SearchOperator {
+	between
+	contains
+	equals
+	gte
+	lte
+	starts_with
+}`;
+
+export type QuerySearchFieldDefaultFor = 'date_created' | 'email' | 'name' | 'title' | 'url';
+
+export interface QuerySearchField {
+	defaultFor?: QuerySearchFieldDefaultFor;
+	field: Field;
+	operators: SearchOperator[];
+}
+
+export const QuerySearchFieldQL = `
+type QuerySearchField {
+	defaultFor: String
+	field: Field!
+	operators: [SearchOperator!]!
+}`;
+
+export const QuerySearchFieldInputQL = `
+input QuerySearchFieldInput {
+	defaultFor: String
+	field: FieldInput!
+	operators: [SearchOperator!]!
+}`;
+
+export const QueryMetadataInputQL = `
+input QueryMetadataInput {${MetadataInputFields}
+	searchFields: [QuerySearchFieldInput]
+	invocationGuidance: String
+}`;
+
+export const QueryMetadataQL = `
+type QueryMetadata {${MetadataFields}
+	searchFields: [QuerySearchField!]!
+	invocationGuidance: String
+}`;
+
+export class QueryMetadata extends Metadata {
+	searchFields: QuerySearchField[];
+	invocationGuidance?: string;
+
+	constructor(
+		label: string,
+		description: string,
+		metadataType: string,
+		searchFields: QuerySearchField[],
+		classifiers: string[] = [],
+		threshold = 0,
+	) {
+		super(label, description, metadataType, classifiers, threshold);
+		this.searchFields = searchFields;
+	}
+}

package/src/recommendation.ts

@@ -164,11 +164,11 @@ export interface MetadataChangeRecommendation {
 	changedBy?: Tag; // Only used by GraphQL consumers
 	changedByTagId: string;
 	impactDescription: string;
-	metadataChangeId: string;
+	metadataChangeId: string | null;
 	status: PendingMetadataChangeStatus;
 	targetId: string;
 	targetName: string;
-	targetType: 'folder' | 'table';
+	targetType: 'folder' | 'function' | 'query' | 'table' | null;
 }
 
 export const FunctionRecommendationQL = `

package/src/signal.ts

@@ -1,3 +1,4 @@
+import type { BlockType } from './block-type.js';
 import type { Field } from './field.js';
 import type { FieldValue } from './field-value.js';
 import type { Provider, ProviderApplication } from './provider.js';
@@ -30,6 +31,33 @@ input AvailableSignalsInput {
   tableId: ID
 }`;
 
+export const SetSignalValueInputQL = `
+input SetSignalValueInput {
+  dateOverrideExpires: Float
+  overrideTriggerBlockTypes: [String!]
+  fieldName: String!
+  tableId: ID!
+  tagId: ID!
+  value: String
+}`;
+
+export const RemoveSignalOverrideInputQL = `
+input RemoveSignalOverrideInput {
+  fieldName: String!
+  tableId: ID!
+  tagId: ID!
+}`;
+
+export const SetSignalValueResultQL = `
+type SetSignalValueResult {
+  signal: Signal!
+}`;
+
+export const RemoveSignalOverrideResultQL = `
+type RemoveSignalOverrideResult {
+  signal: Signal!
+}`;
+
 export interface AvailableSignalGroup {
 	application: ProviderApplication;
 	provider: Provider;
@@ -52,3 +80,26 @@ export interface Signal {
 	field: Field;
 	value?: FieldValue | null;
 }
+
+export interface SetSignalValueInput {
+	dateOverrideExpires?: number | null;
+	overrideTriggerBlockTypes?: BlockType[] | null;
+	fieldName: string;
+	tableId: string;
+	tagId: string;
+	value?: string | null;
+}
+
+export interface RemoveSignalOverrideInput {
+	fieldName: string;
+	tableId: string;
+	tagId: string;
+}
+
+export interface SetSignalValueResult {
+	signal: Signal;
+}
+
+export interface RemoveSignalOverrideResult {
+	signal: Signal;
+}

package/src/table.ts

@@ -10,6 +10,7 @@ export const TableFields = `${BusinessObjectFields}
   records: [Record]
   metadata: TableMetadata
 	connectionId: String
+	enabled: Boolean
 	requestHash: String`;
 export const TableQL = `
 type Table implements Block & BusinessObject {${TableFields}
@@ -18,6 +19,19 @@ export class Table extends BusinessObject {
 	metadata: TableMetadata;
 	records?: Record[];
 	connectionId?: string; // This is a virtual property we provide when the table/records are loaded
+	/**
+	 * Default `true`. Flipped to `false` to pause the table — ingestion writes,
+	 * field-extraction, Nelly destination awareness, and sync targeting all skip
+	 * disabled tables. The records and configuration stay intact so the pause
+	 * is reversible without an archive/restore cycle (parallels `Field.enabled`
+	 * for signals and `InstalledFunction.enabled` for functions).
+	 *
+	 * Nullable in the type signature for backward compatibility with table
+	 * documents written before this field existed. Read sites should treat
+	 * `enabled !== false` as the active condition so absent/null/true all mean
+	 * "enabled" and only an explicit `false` pauses the table.
+	 */
+	enabled?: boolean = true;
 	requestHash?: string; // This is a virtual property, used to bust the Apollo cache for the same tables, with different records
 
 	constructor(

package/src/types.ts

@@ -27,6 +27,14 @@ import {
 	BlockActivityEmptyDetailQL,
 	BlockActivityQL,
 	BlockActivityRenamedDetailQL,
+	BlockActivitySignalOverrideChangedDetailQL,
+	BlockActivitySignalOverrideExpiredDetailQL,
+	BlockActivitySignalOverrideExpiryCancelledDetailQL,
+	BlockActivitySignalOverrideExpirySetDetailQL,
+	BlockActivitySignalOverrideRemovedDetailQL,
+	BlockActivitySignalOverrideTriggerCancelledDetailQL,
+	BlockActivitySignalOverrideTriggeredDetailQL,
+	BlockActivitySignalOverrideTriggerSetDetailQL,
 	BlockActivityStatusChangedDetailQL,
 	BlockActivityTagDetailQL,
 	BlockActivityTypeQL,
@@ -89,7 +97,7 @@ import {
 	SystemOfRecordQL,
 } from './field.js';
 import type { FieldType } from './field-type.js';
-import { type FieldValue, FieldValueInputQL, FieldValueQL } from './field-value.js';
+import { type FieldValue, FieldValueInputQL, FieldValueQL, FieldValueSourceQL } from './field-value.js';
 import type { FieldVariation } from './field-variation.js';
 import { FolderQL } from './folder.js';
 import {
@@ -141,8 +149,24 @@ import {
 
 export * from './provider.js';
 
+import {
+	ExecuteQueryInputQL,
+	ExecuteQueryResultQL,
+	QueryResultRecordQL,
+	SearchCriterionInputQL,
+} from './execute-query.js';
+import { InstalledQueryQL } from './installed-query.js';
 import { Primitive } from './primitive.js';
 import { ProcessingStage } from './processing-stage.js';
+import {
+	type QueryMetadata,
+	QueryMetadataInputQL,
+	QueryMetadataQL,
+	type QuerySearchField,
+	QuerySearchFieldInputQL,
+	QuerySearchFieldQL,
+	SearchOperatorQL,
+} from './query-metadata.js';
 import { ReactionQL } from './reaction.js';
 import {
 	ChangeRecommendationQL,
@@ -175,7 +199,15 @@ import { type SharingDomain, SharingDomainInputQL, SharingDomainQL } from './sha
 import type { SharingLevel } from './sharing-level.js';
 import { type SharingTag, SharingTagInputQL, SharingTagQL } from './sharing-tag.js';
 import { type SharingTenant, SharingTenantInputQL, SharingTenantQL } from './sharing-tenant.js';
-import { AvailableSignalsInputQL, AvailableSignalsResultQL, SignalQL } from './signal.js';
+import {
+	AvailableSignalsInputQL,
+	AvailableSignalsResultQL,
+	RemoveSignalOverrideInputQL,
+	RemoveSignalOverrideResultQL,
+	SetSignalValueInputQL,
+	SetSignalValueResultQL,
+	SignalQL,
+} from './signal.js';
 import { StatementQL } from './statement.js';
 import {
 	FieldNameSubscriptionQL,
@@ -1157,7 +1189,7 @@ input InstallProviderFunctionInput {
 	configuration: [FieldValueInput!]!
 	inputs: [FunctionInputInput!]!
 	invocationGuidance: String
-	sharingTagIds: [String!]
+	sharingTags: [SharingTagInput!]
 }`;
 export interface InstallProviderFunctionInput {
 	/**
@@ -1186,7 +1218,97 @@ export interface InstallProviderFunctionInput {
 	 * the provider's default guidance.
 	 */
 	invocationGuidance?: string;
-	sharingTagIds?: string[];
+	sharingTags?: SharingTag[];
+}
+
+export const UninstallProviderFunctionInputQL = `
+input UninstallProviderFunctionInput {
+	functionId: String!
+	confirmed: Boolean
+}`;
+export interface UninstallProviderFunctionInput {
+	functionId: string;
+	confirmed?: boolean;
+}
+
+export const UninstallProviderFunctionResultQL = `
+type UninstallProviderFunctionResult {
+	_id: String!
+	archived: Boolean!
+	metadataChange: MetadataChangeMutationResult!
+}`;
+export interface UninstallProviderFunctionResult {
+	_id: string;
+	archived: boolean;
+	metadataChange: MetadataChangeMutationResult;
+}
+
+export const InstallProviderQueryInputQL = `
+input InstallProviderQueryInput {
+	application: String!
+	connectionId: String!
+	invocationGuidance: String
+	label: String
+	provider: String!
+	queryId: String
+	queryMetadata: QueryMetadataInput!
+	searchFields: [QuerySearchFieldInput!]!
+	sharingTags: [SharingTagInput!]
+	tableMetadataType: String!
+}`;
+export interface InstallProviderQueryInput {
+	application: string;
+	connectionId: string;
+	invocationGuidance?: string;
+	label?: string;
+	provider: string;
+	queryId?: string;
+	queryMetadata: QueryMetadata;
+	searchFields: QuerySearchField[];
+	sharingTags?: SharingTag[];
+	tableMetadataType: string;
+}
+
+export const UninstallProviderQueryInputQL = `
+input UninstallProviderQueryInput {
+	confirmed: Boolean
+	queryId: String!
+}`;
+export interface UninstallProviderQueryInput {
+	confirmed?: boolean;
+	queryId: string;
+}
+
+export const UninstallProviderQueryResultQL = `
+type UninstallProviderQueryResult {
+	_id: String!
+	archived: Boolean!
+	metadataChange: MetadataChangeMutationResult!
+}`;
+export interface UninstallProviderQueryResult {
+	_id: string;
+	archived: boolean;
+	metadataChange: MetadataChangeMutationResult;
+}
+
+export const SetInstalledFunctionEnabledInputQL = `
+input SetInstalledFunctionEnabledInput {
+	functionId: String!
+	enabled: Boolean!
+}`;
+export interface SetInstalledFunctionEnabledInput {
+	functionId: string;
+	enabled: boolean;
+}
+
+export const SetInstalledTableEnabledInputQL = `
+input SetInstalledTableEnabledInput {
+	tableId: String!
+	enabled: Boolean!
+}`;
+export interface SetInstalledTableEnabledInput {
+	tableId: string;
+	enabled: boolean;
 }
 
 export const ResolveFunctionInputsInputQL = `
@@ -3204,6 +3326,7 @@ export * from './email-intent.js';
 export * from './entity-entry.js';
 export * from './event.js';
 export * from './event-status.js';
+export * from './execute-query.js';
 export * from './external-id-link.js';
 export * from './field.js';
 export * from './field-type.js';
@@ -3288,6 +3411,14 @@ ${BlockActivityDueDateChangedDetailQL}
 ${BlockActivityBlockGeneratedDetailQL}
 ${BlockActivityBusinessObjectDetailQL}
 ${BlockActivityEmptyDetailQL}
+${BlockActivitySignalOverrideChangedDetailQL}
+${BlockActivitySignalOverrideRemovedDetailQL}
+${BlockActivitySignalOverrideExpirySetDetailQL}
+${BlockActivitySignalOverrideExpiryCancelledDetailQL}
+${BlockActivitySignalOverrideExpiredDetailQL}
+${BlockActivitySignalOverrideTriggerSetDetailQL}
+${BlockActivitySignalOverrideTriggeredDetailQL}
+${BlockActivitySignalOverrideTriggerCancelledDetailQL}
 ${BlockActivityDetailQL}
 ${BlockActivityQL}
 ${FindBlockActivitiesInputQL}
@@ -3420,6 +3551,19 @@ ${FunctionMetadataInputQL}
 ${InstalledFunctionQL}
 ${FunctionInvocationQL}
 ${InstallProviderFunctionInputQL}
+${UninstallProviderFunctionInputQL}
+${UninstallProviderFunctionResultQL}
+${SearchOperatorQL}
+${QuerySearchFieldQL}
+${QuerySearchFieldInputQL}
+${QueryMetadataQL}
+${QueryMetadataInputQL}
+${InstalledQueryQL}
+${InstallProviderQueryInputQL}
+${UninstallProviderQueryInputQL}
+${UninstallProviderQueryResultQL}
+${SetInstalledFunctionEnabledInputQL}
+${SetInstalledTableEnabledInputQL}
 ${ResolveFunctionInputsInputQL}
 ${ResolveFunctionInputsOutputQL}
 ${PrepareFunctionFormInputQL}
@@ -3484,11 +3628,16 @@ ${FieldQL}
 ${FieldSourceQL}
 ${SystemOfRecordQL}
 ${FieldInputQL}
+${FieldValueSourceQL}
 ${FieldValueQL}
 ${FieldValueInputQL}
 ${SignalQL}
 ${AvailableSignalsResultQL}
 ${AvailableSignalsInputQL}
+${SetSignalValueInputQL}
+${RemoveSignalOverrideInputQL}
+${SetSignalValueResultQL}
+${RemoveSignalOverrideResultQL}
 ${TableMetadataQL}
 ${RecordQL}
 ${RecordInputQL}
@@ -3658,4 +3807,14 @@ ${RemoveUserMemoryEntryInputQL}
 ${DeleteUserMemoryInputQL}
 ${AiTraceCostMonthQL}
 ${AiTraceCostTenantQL}
-${FindAiTraceCostsInputQL}`;
+${FindAiTraceCostsInputQL}
+${InstalledQueryQL}
+${SearchOperatorQL}
+${QuerySearchFieldQL}
+${QuerySearchFieldInputQL}
+${QueryMetadataInputQL}
+${QueryMetadataQL}
+${SearchCriterionInputQL}
+${ExecuteQueryInputQL}
+${QueryResultRecordQL}
+${ExecuteQueryResultQL}`;