npm - @agent-native/core - Versions diffs - 0.114.15 → 0.115.1 - Mend

@agent-native/core 0.114.15 → 0.115.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (467) hide show

package/dist/connections/reader.d.ts CHANGED Viewed

@@ -186,6 +186,24 @@ export declare const PROVIDER_READERS: readonly [{
     }];
     readonly operations: readonly [ProviderReaderOperationDescriptor, ProviderReaderOperationDescriptor, ProviderReaderOperationDescriptor];
     readonly notes: "Templates define object allow-lists and property projections; core only documents the reader shape.";
+}, {
+    readonly providerId: "salesforce";
+    readonly label: "Salesforce reader";
+    readonly description: "Normalized metadata for CRM object lookup through template-owned Salesforce integrations.";
+    readonly implementationStatus: "template-owned";
+    readonly credentialKeys: readonly WorkspaceConnectionCredentialKey[];
+    readonly requiredCredentialKeys: readonly string[];
+    readonly capabilities: readonly [{
+        readonly capability: "search";
+        readonly label: "CRM search";
+        readonly description: "Search Salesforce CRM records with provider-native SOQL or object filters.";
+    }, {
+        readonly capability: "crm";
+        readonly label: "CRM retrieval";
+        readonly description: "Read Salesforce standard and custom CRM objects when a template owns object mapping.";
+    }];
+    readonly operations: readonly [ProviderReaderOperationDescriptor, ProviderReaderOperationDescriptor, ProviderReaderOperationDescriptor];
+    readonly notes: "Templates define object allow-lists, field projections, and API-version selection; core only documents the reader shape.";
 }, {
     readonly providerId: "gmail";
     readonly label: "Gmail reader";

package/dist/connections/reader.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../src/connections/reader.ts"],"names":[],"mappings":"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~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2X2B~~,CAAC;AAOzD,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,0BAA+B,GACvC,wBAAwB,EAAE,CA6B5B;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,GACjB,wBAAwB,GAAG,SAAS,CAKtC;AAED,wBAAgB,sBAAsB,CACpC,gBAAgB,EAAE,wBAAwB,GAAG,6BAA6B,EAC1E,aAAa,EAAE,uBAAuB,GACrC,OAAO,CAUT;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B,GACpC,qBAAqB,CAsIvB"}
1	+ {"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../src/connections/reader.ts"],"names":[],"mappings":"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"}

package/dist/connections/reader.js CHANGED Viewed

@@ -211,6 +211,47 @@ export const PROVIDER_READERS = [
         ],
         notes: "Templates define object allow-lists and property projections; core only documents the reader shape.",
     }),
+    defineProviderReader({
+        providerId: "salesforce",
+        label: "Salesforce reader",
+        description: "Normalized metadata for CRM object lookup through template-owned Salesforce integrations.",
+        implementationStatus: "template-owned",
+        credentialKeys: providerCredentialKeys("salesforce"),
+        requiredCredentialKeys: requiredCredentialKeys("salesforce"),
+        capabilities: [
+            {
+                capability: "search",
+                label: "CRM search",
+                description: "Search Salesforce CRM records with provider-native SOQL or object filters.",
+            },
+            {
+                capability: "crm",
+                label: "CRM retrieval",
+                description: "Read Salesforce standard and custom CRM objects when a template owns object mapping.",
+            },
+        ],
+        operations: [
+            operation("search", "Search Salesforce CRM", "Find CRM records matching text, SOQL, or provider-native filters.", "template-owned", [
+                ...searchParameters,
+                {
+                    name: "objectType",
+                    type: "string",
+                    description: "Optional Salesforce object API name such as Account, Contact, Opportunity, or a custom object.",
+                },
+            ]),
+            operation("get", "Get Salesforce CRM object", "Load one Salesforce CRM record by object API name and id.", "template-owned", [
+                ...getParameters,
+                {
+                    name: "objectType",
+                    type: "string",
+                    required: true,
+                    description: "Salesforce object API name such as Account, Contact, Opportunity, or a custom object.",
+                },
+            ]),
+            operation("listRecent", "List recent Salesforce CRM objects", "List recently updated CRM records visible to the connected Salesforce user.", "template-owned", listRecentParameters),
+        ],
+        notes: "Templates define object allow-lists, field projections, and API-version selection; core only documents the reader shape.",
+    }),
     defineProviderReader({
         providerId: "gmail",
         label: "Gmail reader",

package/dist/connections/reader.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"reader.js","sourceRoot":"","sources":["../../src/connections/reader.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n resolveWorkspaceConnectionCredentialsForApp,\n type ResolveWorkspaceConnectionCredentialsForAppOptions,\n type WorkspaceConnectionCredentialRef,\n type WorkspaceConnectionCredentialsResolution,\n type WorkspaceConnectionForApp,\n type WorkspaceConnectionPublicCredentialRef,\n} from \"../workspace-connections/index.js\";\nimport {\n resolveWorkspaceConnectionForApp,\n type ResolvedWorkspaceConnectionForApp,\n type ResolveWorkspaceConnectionForAppOptions,\n} from \"../workspace-connections/store.js\";\nimport {\n getWorkspaceConnectionProvider,\n type WorkspaceConnectionCapability,\n type WorkspaceConnectionCredentialKey,\n type WorkspaceConnectionProviderId,\n} from \"./catalog.js\";\n\nexport type ProviderReaderOperation = \"search\" \| \"get\" \| \"listRecent\";\n\nexport type ProviderReaderImplementationStatus =\n \| \"metadata-only\"\n \| \"template-owned\"\n \| \"shared\";\n\nexport interface ProviderReaderCapability {\n capability: WorkspaceConnectionCapability;\n label: string;\n description: string;\n}\n\nexport interface ProviderReaderOperationParameter {\n name: string;\n type: \"string\" \| \"number\" \| \"boolean\" \| \"string[]\";\n required?: boolean;\n description: string;\n}\n\nexport interface ProviderReaderOperationDescriptor {\n operation: ProviderReaderOperation;\n label: string;\n description: string;\n implementationStatus: ProviderReaderImplementationStatus;\n parameters: readonly ProviderReaderOperationParameter[];\n}\n\nexport interface ProviderReaderDefinition {\n providerId: WorkspaceConnectionProviderId;\n label: string;\n description: string;\n implementationStatus: ProviderReaderImplementationStatus;\n credentialKeys: readonly WorkspaceConnectionCredentialKey[];\n requiredCredentialKeys: readonly string[];\n capabilities: readonly ProviderReaderCapability[];\n operations: readonly ProviderReaderOperationDescriptor[];\n notes?: string;\n}\n\nexport interface ListProviderReadersOptions {\n providerId?: WorkspaceConnectionProviderId;\n capability?: WorkspaceConnectionCapability;\n operation?: ProviderReaderOperation;\n implementationStatus?: ProviderReaderImplementationStatus;\n}\n\nexport type ProviderReaderRuntimeErrorCode =\n \| \"unsupported_provider\"\n \| \"unsupported_operation\"\n \| \"connection_not_available\"\n \| \"credentials_unavailable\";\n\nexport interface ProviderReaderRequest<\n TParams extends Record<string, unknown> = Record<string, unknown>,\n> {\n providerId: WorkspaceConnectionProviderId;\n operation: ProviderReaderOperation;\n params?: TParams;\n connectionId?: string \| null;\n userEmail?: string \| null;\n orgId?: string \| null;\n}\n\nexport interface ProviderReaderRuntimeItem {\n id: string;\n type: string;\n title?: string;\n url?: string;\n text?: string;\n metadata?: Record<string, unknown>;\n}\n\nexport interface ProviderReaderRuntimeResponse {\n providerId: WorkspaceConnectionProviderId;\n operation: ProviderReaderOperation;\n connectionId: string;\n items?: ProviderReaderRuntimeItem[];\n item?: ProviderReaderRuntimeItem \| null;\n metadata?: Record<string, unknown>;\n}\n\nexport interface ProviderReaderRuntimeConnection {\n id: string;\n provider: string;\n label: string;\n accountId: string \| null;\n accountLabel: string \| null;\n credentialRefs: WorkspaceConnectionPublicCredentialRef[];\n}\n\nexport interface ProviderReaderCredentialRequirement {\n values: Record<string, string>;\n resolution: WorkspaceConnectionCredentialsResolution;\n}\n\nexport interface ProviderReaderRuntimeContext {\n appId: string;\n providerId: WorkspaceConnectionProviderId;\n reader: ProviderReaderDefinition;\n connection: ProviderReaderRuntimeConnection;\n resolveCredentials(\n keys?: readonly string[],\n ): Promise<WorkspaceConnectionCredentialsResolution>;\n requireCredentials(\n keys?: readonly string[],\n ): Promise<ProviderReaderCredentialRequirement>;\n}\n\nexport type ProviderReaderRuntimeHandler<\n TParams extends Record<string, unknown> = Record<string, unknown>,\n> = (\n params: TParams,\n context: ProviderReaderRuntimeContext,\n) => ProviderReaderRuntimeResponse \| Promise<ProviderReaderRuntimeResponse>;\n\nexport interface ProviderReaderRuntimeImplementation<\n TProviderId extends WorkspaceConnectionProviderId =\n WorkspaceConnectionProviderId,\n> {\n providerId: TProviderId;\n operations: Partial<\n Record<ProviderReaderOperation, ProviderReaderRuntimeHandler>\n >;\n}\n\nexport interface ProviderReaderRuntimeConnectionResolverOptions extends Pick<\n ResolveWorkspaceConnectionForAppOptions,\n \"appId\" \| \"connectionId\"\n> {\n providerId: WorkspaceConnectionProviderId;\n}\n\nexport interface ProviderReaderRuntimeCredentialsResolverOptions extends Pick<\n ResolveWorkspaceConnectionCredentialsForAppOptions,\n \"appId\" \| \"connectionId\" \| \"keys\" \| \"userEmail\" \| \"orgId\"\n> {\n providerId: WorkspaceConnectionProviderId;\n}\n\nexport interface ProviderReaderRuntimeOptions {\n appId: string;\n readers: readonly ProviderReaderRuntimeImplementation[];\n resolveConnection?: (\n options: ProviderReaderRuntimeConnectionResolverOptions,\n ) => Promise<ResolvedWorkspaceConnectionForApp>;\n resolveCredentials?: (\n options: ProviderReaderRuntimeCredentialsResolverOptions,\n ) => Promise<WorkspaceConnectionCredentialsResolution>;\n}\n\nexport interface ProviderReaderRuntime {\n read<TParams extends Record<string, unknown> = Record<string, unknown>>(\n request: ProviderReaderRequest<TParams>,\n ): Promise<ProviderReaderRuntimeResponse>;\n}\n\nexport class ProviderReaderRuntimeError extends Error {\n readonly code: ProviderReaderRuntimeErrorCode;\n readonly providerId: string;\n readonly operation?: ProviderReaderOperation;\n\n constructor(\n code: ProviderReaderRuntimeErrorCode,\n message: string,\n options: {\n providerId: string;\n operation?: ProviderReaderOperation;\n },\n ) {\n super(message);\n this.name = \"ProviderReaderRuntimeError\";\n this.code = code;\n this.providerId = options.providerId;\n this.operation = options.operation;\n }\n}\n\nexport function defineProviderReader<const T extends ProviderReaderDefinition>(\n reader: T,\n): T {\n return reader;\n}\n\nexport function defineProviderReaderImplementation<\n const T extends ProviderReaderRuntimeImplementation,\n>(implementation: T): T {\n return implementation;\n}\n\nconst searchParameters = [\n {\n name: \"query\",\n type: \"string\",\n required: true,\n description: \"Provider-native search text.\",\n },\n {\n name: \"limit\",\n type: \"number\",\n description: \"Maximum normalized results to return.\",\n },\n] as const satisfies readonly ProviderReaderOperationParameter[];\n\nconst getParameters = [\n {\n name: \"id\",\n type: \"string\",\n required: true,\n description: \"Provider-native object identifier.\",\n },\n] as const satisfies readonly ProviderReaderOperationParameter[];\n\nconst listRecentParameters = [\n {\n name: \"limit\",\n type: \"number\",\n description: \"Maximum recent objects to return.\",\n },\n] as const satisfies readonly ProviderReaderOperationParameter[];\n\nfunction operation(\n operationName: ProviderReaderOperation,\n label: string,\n description: string,\n implementationStatus: ProviderReaderImplementationStatus,\n parameters: readonly ProviderReaderOperationParameter[],\n): ProviderReaderOperationDescriptor {\n return {\n operation: operationName,\n label,\n description,\n implementationStatus,\n parameters,\n };\n}\n\nfunction providerCredentialKeys(\n providerId: WorkspaceConnectionProviderId,\n): readonly WorkspaceConnectionCredentialKey[] {\n return getWorkspaceConnectionProvider(providerId)?.credentialKeys ?? [];\n}\n\nfunction requiredCredentialKeys(\n providerId: WorkspaceConnectionProviderId,\n): readonly string[] {\n return providerCredentialKeys(providerId)\n .filter((credential) => credential.required !== false)\n .map((credential) => credential.key);\n}\n\nexport const PROVIDER_READERS = [\n defineProviderReader({\n providerId: \"slack\",\n label: \"Slack reader\",\n description:\n \"Normalized metadata for reading Slack messages and channel history through template-owned Slack implementations.\",\n implementationStatus: \"template-owned\",\n credentialKeys: providerCredentialKeys(\"slack\"),\n requiredCredentialKeys: requiredCredentialKeys(\"slack\"),\n capabilities: [\n {\n capability: \"search\",\n label: \"Message search\",\n description:\n \"Search conversation history using Slack's message search semantics.\",\n },\n {\n capability: \"messages\",\n label: \"Message retrieval\",\n description:\n \"Read individual messages or recent channel activity when a template owns the Slack client.\",\n },\n ],\n operations: [\n operation(\n \"search\",\n \"Search Slack messages\",\n \"Find Slack messages matching text and optional channel filters.\",\n \"template-owned\",\n [\n ...searchParameters,\n {\n name: \"channelId\",\n type: \"string\",\n description: \"Optional Slack channel id to narrow the search.\",\n },\n ],\n ),\n operation(\n \"get\",\n \"Get Slack message\",\n \"Load one Slack message by channel and timestamp/id.\",\n \"template-owned\",\n [\n ...getParameters,\n {\n name: \"channelId\",\n type: \"string\",\n required: true,\n description: \"Slack channel id containing the message.\",\n },\n ],\n ),\n operation(\n \"listRecent\",\n \"List recent Slack messages\",\n \"List recent messages from channels visible to the connected Slack app.\",\n \"template-owned\",\n listRecentParameters,\n ),\n ],\n notes:\n \"Core only exposes the contract; templates still own Slack API calls and provider-specific pagination.\",\n }),\n defineProviderReader({\n providerId: \"github\",\n label: \"GitHub reader\",\n description:\n \"Normalized metadata for reading repositories, issues, pull requests, and code search results.\",\n implementationStatus: \"template-owned\",\n credentialKeys: providerCredentialKeys(\"github\"),\n requiredCredentialKeys: requiredCredentialKeys(\"github\"),\n capabilities: [\n {\n capability: \"search\",\n label: \"Repository search\",\n description:\n \"Search GitHub issues, pull requests, repositories, code, or docs using template-owned clients.\",\n },\n {\n capability: \"code\",\n label: \"Code context\",\n description:\n \"Read code-oriented objects such as repositories, files, issues, and pull requests.\",\n },\n ],\n operations: [\n operation(\n \"search\",\n \"Search GitHub\",\n \"Find repositories, issues, pull requests, code, or documentation matching a query.\",\n \"template-owned\",\n [\n ...searchParameters,\n {\n name: \"owner\",\n type: \"string\",\n description: \"Optional repository owner or organization filter.\",\n },\n {\n name: \"repo\",\n type: \"string\",\n description: \"Optional repository filter.\",\n },\n ],\n ),\n operation(\n \"get\",\n \"Get GitHub object\",\n \"Load one repository, issue, pull request, or file by provider-native id or URL.\",\n \"template-owned\",\n getParameters,\n ),\n operation(\n \"listRecent\",\n \"List recent GitHub activity\",\n \"List recent issues, pull requests, or repository activity visible to the connection.\",\n \"template-owned\",\n listRecentParameters,\n ),\n ],\n notes:\n \"No shared Octokit client is exported from core in this spike; templates remain responsible for API calls.\",\n }),\n defineProviderReader({\n providerId: \"notion\",\n label: \"Notion reader\",\n description:\n \"Normalized metadata for reading Notion pages, databases, and workspace docs.\",\n implementationStatus: \"template-owned\",\n credentialKeys: providerCredentialKeys(\"notion\"),\n requiredCredentialKeys: requiredCredentialKeys(\"notion\"),\n capabilities: [\n {\n capability: \"search\",\n label: \"Page search\",\n description:\n \"Search pages and databases shared with the Notion integration.\",\n },\n {\n capability: \"docs\",\n label: \"Document retrieval\",\n description:\n \"Read Notion page or database metadata through template-owned clients.\",\n },\n ],\n operations: [\n operation(\n \"search\",\n \"Search Notion\",\n \"Find Notion pages or databases matching text and optional object type filters.\",\n \"template-owned\",\n searchParameters,\n ),\n operation(\n \"get\",\n \"Get Notion object\",\n \"Load one Notion page or database by id.\",\n \"template-owned\",\n getParameters,\n ),\n operation(\n \"listRecent\",\n \"List recent Notion objects\",\n \"List recently edited pages or databases visible to the integration.\",\n \"template-owned\",\n listRecentParameters,\n ),\n ],\n notes:\n \"Core does not traverse Notion blocks yet; templates own page hydration and rate-limit behavior.\",\n }),\n defineProviderReader({\n providerId: \"hubspot\",\n label: \"HubSpot reader\",\n description:\n \"Normalized metadata for CRM object lookup through template-owned HubSpot integrations.\",\n implementationStatus: \"template-owned\",\n credentialKeys: providerCredentialKeys(\"hubspot\"),\n requiredCredentialKeys: requiredCredentialKeys(\"hubspot\"),\n capabilities: [\n {\n capability: \"search\",\n label: \"CRM search\",\n description:\n \"Search CRM contacts, companies, deals, tickets, and engagements.\",\n },\n {\n capability: \"crm\",\n label: \"CRM retrieval\",\n description:\n \"Read CRM objects when a template owns HubSpot object mapping.\",\n },\n ],\n operations: [\n operation(\n \"search\",\n \"Search HubSpot CRM\",\n \"Find CRM records matching text or provider-native filters.\",\n \"template-owned\",\n [\n ...searchParameters,\n {\n name: \"objectType\",\n type: \"string\",\n description:\n \"Optional HubSpot object type such as contact, company, deal, or ticket.\",\n },\n ],\n ),\n operation(\n \"get\",\n \"Get HubSpot CRM object\",\n \"Load one CRM record by object type and id.\",\n \"template-owned\",\n [\n ...getParameters,\n {\n name: \"objectType\",\n type: \"string\",\n required: true,\n description:\n \"HubSpot object type such as contact, company, deal, or ticket.\",\n },\n ],\n ),\n operation(\n \"listRecent\",\n \"List recent HubSpot CRM objects\",\n \"List recently updated CRM records visible to the private app token.\",\n \"template-owned\",\n listRecentParameters,\n ),\n ],\n notes:\n \"Templates define object allow-lists and property projections; core only documents the reader shape.\",\n }),\n defineProviderReader({\n providerId: \"gmail\",\n label: \"Gmail reader\",\n description:\n \"Normalized metadata for mailbox search and thread/message reads through app-owned Google OAuth flows.\",\n implementationStatus: \"template-owned\",\n credentialKeys: providerCredentialKeys(\"gmail\"),\n requiredCredentialKeys: requiredCredentialKeys(\"gmail\"),\n capabilities: [\n {\n capability: \"search\",\n label: \"Mailbox search\",\n description: \"Search Gmail messages and threads.\",\n },\n {\n capability: \"messages\",\n label: \"Mail retrieval\",\n description:\n \"Read Gmail messages and threads when a template owns OAuth token handling.\",\n },\n ],\n operations: [\n operation(\n \"search\",\n \"Search Gmail\",\n \"Find Gmail messages or threads matching a query.\",\n \"template-owned\",\n searchParameters,\n ),\n operation(\n \"get\",\n \"Get Gmail message or thread\",\n \"Load one Gmail message or thread by provider-native id.\",\n \"template-owned\",\n getParameters,\n ),\n operation(\n \"listRecent\",\n \"List recent Gmail messages\",\n \"List recent mailbox messages visible to the connected Google account.\",\n \"template-owned\",\n listRecentParameters,\n ),\n ],\n notes:\n \"This is metadata for templates with Google OAuth; core does not expose a shared Gmail network client here.\",\n }),\n defineProviderReader({\n providerId: \"google_drive\",\n label: \"Google Drive reader\",\n description:\n \"Normalized metadata for Drive file search and document lookup through app-owned Google OAuth flows.\",\n implementationStatus: \"template-owned\",\n credentialKeys: providerCredentialKeys(\"google_drive\"),\n requiredCredentialKeys: requiredCredentialKeys(\"google_drive\"),\n capabilities: [\n {\n capability: \"search\",\n label: \"Drive search\",\n description: \"Search files visible to the connected Google account.\",\n },\n {\n capability: \"docs\",\n label: \"Drive document retrieval\",\n description:\n \"Read file metadata or exported document content through template-owned Google clients.\",\n },\n ],\n operations: [\n operation(\n \"search\",\n \"Search Google Drive\",\n \"Find Drive files matching text, MIME type, or folder filters.\",\n \"template-owned\",\n [\n ...searchParameters,\n {\n name: \"mimeType\",\n type: \"string\",\n description: \"Optional MIME type filter.\",\n },\n ],\n ),\n operation(\n \"get\",\n \"Get Google Drive file\",\n \"Load one Drive file by id.\",\n \"template-owned\",\n getParameters,\n ),\n operation(\n \"listRecent\",\n \"List recent Google Drive files\",\n \"List recently modified files visible to the connected Google account.\",\n \"template-owned\",\n listRecentParameters,\n ),\n ],\n notes:\n \"Templates still own file export formats, Docs/Sheets/Slides handling, and OAuth token refresh.\",\n }),\n defineProviderReader({\n providerId: \"generic\",\n label: \"Generic metadata reader\",\n description:\n \"Placeholder reader metadata for custom sources that expose searchable documents through a template-specific adapter.\",\n implementationStatus: \"metadata-only\",\n credentialKeys: providerCredentialKeys(\"generic\"),\n requiredCredentialKeys: requiredCredentialKeys(\"generic\"),\n capabilities: [\n {\n capability: \"search\",\n label: \"Custom search\",\n description:\n \"Describe a template-specific search interface for one-off sources.\",\n },\n {\n capability: \"docs\",\n label: \"Custom document retrieval\",\n description:\n \"Describe a template-specific document retrieval interface.\",\n },\n ],\n operations: [\n operation(\n \"search\",\n \"Search custom source\",\n \"Metadata-only descriptor for searching a custom source.\",\n \"metadata-only\",\n searchParameters,\n ),\n operation(\n \"get\",\n \"Get custom source object\",\n \"Metadata-only descriptor for loading one custom source object by id.\",\n \"metadata-only\",\n getParameters,\n ),\n ],\n notes:\n \"Use this only to document a template-owned adapter; core cannot execute generic provider reads.\",\n }),\n] as const satisfies readonly ProviderReaderDefinition[];\n\nconst READERS_BY_PROVIDER_ID = new Map<\n WorkspaceConnectionProviderId,\n ProviderReaderDefinition\n>(PROVIDER_READERS.map((reader) => [reader.providerId, reader]));\n\nexport function listProviderReaders(\n options: ListProviderReadersOptions = {},\n): ProviderReaderDefinition[] {\n return PROVIDER_READERS.filter((reader) => {\n if (options.providerId && reader.providerId !== options.providerId) {\n return false;\n }\n if (\n options.capability &&\n !reader.capabilities.some(\n (capability) => capability.capability === options.capability,\n )\n ) {\n return false;\n }\n if (\n options.operation &&\n !reader.operations.some(\n (operation) => operation.operation === options.operation,\n )\n ) {\n return false;\n }\n if (\n options.implementationStatus &&\n reader.implementationStatus !== options.implementationStatus\n ) {\n return false;\n }\n return true;\n }).map(cloneProviderReader);\n}\n\nexport function getProviderReader(\n providerId: string,\n): ProviderReaderDefinition \| undefined {\n const reader = READERS_BY_PROVIDER_ID.get(\n providerId as WorkspaceConnectionProviderId,\n );\n return reader ? cloneProviderReader(reader) : undefined;\n}\n\nexport function providerReaderSupports(\n providerOrReader: ProviderReaderDefinition \| WorkspaceConnectionProviderId,\n operationName: ProviderReaderOperation,\n): boolean {\n const reader =\n typeof providerOrReader === \"string\"\n ? getProviderReader(providerOrReader)\n : providerOrReader;\n return (\n reader?.operations.some(\n (operation) => operation.operation === operationName,\n ) ?? false\n );\n}\n\nexport function createProviderReaderRuntime(\n options: ProviderReaderRuntimeOptions,\n): ProviderReaderRuntime {\n const appId = options.appId.trim();\n if (!appId) {\n throw new Error(\"createProviderReaderRuntime appId is required.\");\n }\n\n const implementations = new Map<\n WorkspaceConnectionProviderId,\n ProviderReaderRuntimeImplementation\n >();\n for (const implementation of options.readers) {\n implementations.set(implementation.providerId, implementation);\n }\n\n const connectionResolver =\n options.resolveConnection ??\n ((resolverOptions: ProviderReaderRuntimeConnectionResolverOptions) =>\n resolveWorkspaceConnectionForApp({\n appId: resolverOptions.appId,\n provider: resolverOptions.providerId,\n connectionId: resolverOptions.connectionId,\n includeDisabled: false,\n requireConnected: true,\n }));\n const credentialsResolver =\n options.resolveCredentials ??\n ((resolverOptions: ProviderReaderRuntimeCredentialsResolverOptions) =>\n resolveWorkspaceConnectionCredentialsForApp({\n appId: resolverOptions.appId,\n provider: resolverOptions.providerId,\n connectionId: resolverOptions.connectionId,\n keys: resolverOptions.keys,\n userEmail: resolverOptions.userEmail,\n orgId: resolverOptions.orgId,\n }));\n\n return {\n async read<\n TParams extends Record<string, unknown> = Record<string, unknown>,\n >(\n request: ProviderReaderRequest<TParams>,\n ): Promise<ProviderReaderRuntimeResponse> {\n const reader = getProviderReader(request.providerId);\n if (!reader) {\n throw new ProviderReaderRuntimeError(\n \"unsupported_provider\",\n `No provider reader metadata is registered for ${request.providerId}.`,\n { providerId: request.providerId, operation: request.operation },\n );\n }\n\n const operation = reader.operations.find(\n (entry) => entry.operation === request.operation,\n );\n if (!operation) {\n throw new ProviderReaderRuntimeError(\n \"unsupported_operation\",\n `${reader.label} does not support ${request.operation}.`,\n { providerId: request.providerId, operation: request.operation },\n );\n }\n\n const implementation = implementations.get(request.providerId);\n if (!implementation) {\n throw new ProviderReaderRuntimeError(\n \"unsupported_provider\",\n `${reader.label} has no runtime implementation registered.`,\n { providerId: request.providerId, operation: request.operation },\n );\n }\n\n const handler = implementation.operations[request.operation];\n if (!handler) {\n throw new ProviderReaderRuntimeError(\n \"unsupported_operation\",\n `${reader.label} has no runtime handler for ${request.operation}.`,\n { providerId: request.providerId, operation: request.operation },\n );\n }\n\n const resolvedConnection = await connectionResolver({\n appId,\n providerId: request.providerId,\n connectionId: request.connectionId?.trim() \|\| undefined,\n });\n if (!resolvedConnection.available \|\| !resolvedConnection.connection) {\n throw new ProviderReaderRuntimeError(\n \"connection_not_available\",\n resolvedConnection.reason,\n { providerId: request.providerId, operation: request.operation },\n );\n }\n\n const connection = publicRuntimeConnection(resolvedConnection.connection);\n const context: ProviderReaderRuntimeContext = {\n appId,\n providerId: request.providerId,\n reader,\n connection,\n resolveCredentials: (keys = reader.requiredCredentialKeys) =>\n credentialsResolver({\n appId,\n providerId: request.providerId,\n connectionId: connection.id,\n keys: [...keys],\n userEmail: request.userEmail,\n orgId: request.orgId,\n }),\n requireCredentials: async (keys = reader.requiredCredentialKeys) => {\n const resolution = await credentialsResolver({\n appId,\n providerId: request.providerId,\n connectionId: connection.id,\n keys: [...keys],\n userEmail: request.userEmail,\n orgId: request.orgId,\n });\n if (!resolution.available) {\n throw new ProviderReaderRuntimeError(\n \"credentials_unavailable\",\n `Missing workspace connection credentials for ${reader.label}: ${resolution.missingKeys.join(\", \")}.`,\n {\n providerId: request.providerId,\n operation: request.operation,\n },\n );\n }\n return { values: resolution.values, resolution };\n },\n };\n\n return handler((request.params ?? {}) as TParams, context);\n },\n };\n}\n\nfunction cloneProviderReader(\n reader: ProviderReaderDefinition,\n): ProviderReaderDefinition {\n return {\n ...reader,\n credentialKeys: reader.credentialKeys.map((credential) => ({\n ...credential,\n })),\n requiredCredentialKeys: [...reader.requiredCredentialKeys],\n capabilities: reader.capabilities.map((capability) => ({\n ...capability,\n })),\n operations: reader.operations.map((operation) => ({\n ...operation,\n parameters: operation.parameters.map((parameter) => ({\n ...parameter,\n })),\n })),\n };\n}\n\nfunction publicRuntimeConnection(\n connection: WorkspaceConnectionForApp,\n): ProviderReaderRuntimeConnection {\n return {\n id: connection.id,\n provider: connection.provider,\n label: connection.label,\n accountId: connection.accountId,\n accountLabel: connection.accountLabel,\n credentialRefs: publicCredentialRefs(connection),\n };\n}\n\nfunction publicCredentialRefs(\n connection: WorkspaceConnectionForApp,\n): WorkspaceConnectionPublicCredentialRef[] {\n return [\n ...(connection.explicitGrant?.credentialRefs ?? []).map((ref) =>\n publicCredentialRef(ref, \"grant\"),\n ),\n ...connection.credentialRefs.map((ref) =>\n publicCredentialRef(ref, \"connection\"),\n ),\n ];\n}\n\nfunction publicCredentialRef(\n ref: WorkspaceConnectionCredentialRef,\n source: WorkspaceConnectionPublicCredentialRef[\"source\"],\n): WorkspaceConnectionPublicCredentialRef {\n return {\n key: ref.key,\n scope: ref.scope,\n provider: ref.provider,\n label: ref.label,\n source,\n };\n}\n"]}
1	+ {"version":3,"file":"reader.js","sourceRoot":"","sources":["../../src/connections/reader.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n resolveWorkspaceConnectionCredentialsForApp,\n type ResolveWorkspaceConnectionCredentialsForAppOptions,\n type WorkspaceConnectionCredentialRef,\n type WorkspaceConnectionCredentialsResolution,\n type WorkspaceConnectionForApp,\n type WorkspaceConnectionPublicCredentialRef,\n} from \"../workspace-connections/index.js\";\nimport {\n resolveWorkspaceConnectionForApp,\n type ResolvedWorkspaceConnectionForApp,\n type ResolveWorkspaceConnectionForAppOptions,\n} from \"../workspace-connections/store.js\";\nimport {\n getWorkspaceConnectionProvider,\n type WorkspaceConnectionCapability,\n type WorkspaceConnectionCredentialKey,\n type WorkspaceConnectionProviderId,\n} from \"./catalog.js\";\n\nexport type ProviderReaderOperation = \"search\" \| \"get\" \| \"listRecent\";\n\nexport type ProviderReaderImplementationStatus =\n \| \"metadata-only\"\n \| \"template-owned\"\n \| \"shared\";\n\nexport interface ProviderReaderCapability {\n capability: WorkspaceConnectionCapability;\n label: string;\n description: string;\n}\n\nexport interface ProviderReaderOperationParameter {\n name: string;\n type: \"string\" \| \"number\" \| \"boolean\" \| \"string[]\";\n required?: boolean;\n description: string;\n}\n\nexport interface ProviderReaderOperationDescriptor {\n operation: ProviderReaderOperation;\n label: string;\n description: string;\n implementationStatus: ProviderReaderImplementationStatus;\n parameters: readonly ProviderReaderOperationParameter[];\n}\n\nexport interface ProviderReaderDefinition {\n providerId: WorkspaceConnectionProviderId;\n label: string;\n description: string;\n implementationStatus: ProviderReaderImplementationStatus;\n credentialKeys: readonly WorkspaceConnectionCredentialKey[];\n requiredCredentialKeys: readonly string[];\n capabilities: readonly ProviderReaderCapability[];\n operations: readonly ProviderReaderOperationDescriptor[];\n notes?: string;\n}\n\nexport interface ListProviderReadersOptions {\n providerId?: WorkspaceConnectionProviderId;\n capability?: WorkspaceConnectionCapability;\n operation?: ProviderReaderOperation;\n implementationStatus?: ProviderReaderImplementationStatus;\n}\n\nexport type ProviderReaderRuntimeErrorCode =\n \| \"unsupported_provider\"\n \| \"unsupported_operation\"\n \| \"connection_not_available\"\n \| \"credentials_unavailable\";\n\nexport interface ProviderReaderRequest<\n TParams extends Record<string, unknown> = Record<string, unknown>,\n> {\n providerId: WorkspaceConnectionProviderId;\n operation: ProviderReaderOperation;\n params?: TParams;\n connectionId?: string \| null;\n userEmail?: string \| null;\n orgId?: string \| null;\n}\n\nexport interface ProviderReaderRuntimeItem {\n id: string;\n type: string;\n title?: string;\n url?: string;\n text?: string;\n metadata?: Record<string, unknown>;\n}\n\nexport interface ProviderReaderRuntimeResponse {\n providerId: WorkspaceConnectionProviderId;\n operation: ProviderReaderOperation;\n connectionId: string;\n items?: ProviderReaderRuntimeItem[];\n item?: ProviderReaderRuntimeItem \| null;\n metadata?: Record<string, unknown>;\n}\n\nexport interface ProviderReaderRuntimeConnection {\n id: string;\n provider: string;\n label: string;\n accountId: string \| null;\n accountLabel: string \| null;\n credentialRefs: WorkspaceConnectionPublicCredentialRef[];\n}\n\nexport interface ProviderReaderCredentialRequirement {\n values: Record<string, string>;\n resolution: WorkspaceConnectionCredentialsResolution;\n}\n\nexport interface ProviderReaderRuntimeContext {\n appId: string;\n providerId: WorkspaceConnectionProviderId;\n reader: ProviderReaderDefinition;\n connection: ProviderReaderRuntimeConnection;\n resolveCredentials(\n keys?: readonly string[],\n ): Promise<WorkspaceConnectionCredentialsResolution>;\n requireCredentials(\n keys?: readonly string[],\n ): Promise<ProviderReaderCredentialRequirement>;\n}\n\nexport type ProviderReaderRuntimeHandler<\n TParams extends Record<string, unknown> = Record<string, unknown>,\n> = (\n params: TParams,\n context: ProviderReaderRuntimeContext,\n) => ProviderReaderRuntimeResponse \| Promise<ProviderReaderRuntimeResponse>;\n\nexport interface ProviderReaderRuntimeImplementation<\n TProviderId extends WorkspaceConnectionProviderId =\n WorkspaceConnectionProviderId,\n> {\n providerId: TProviderId;\n operations: Partial<\n Record<ProviderReaderOperation, ProviderReaderRuntimeHandler>\n >;\n}\n\nexport interface ProviderReaderRuntimeConnectionResolverOptions extends Pick<\n ResolveWorkspaceConnectionForAppOptions,\n \"appId\" \| \"connectionId\"\n> {\n providerId: WorkspaceConnectionProviderId;\n}\n\nexport interface ProviderReaderRuntimeCredentialsResolverOptions extends Pick<\n ResolveWorkspaceConnectionCredentialsForAppOptions,\n \"appId\" \| \"connectionId\" \| \"keys\" \| \"userEmail\" \| \"orgId\"\n> {\n providerId: WorkspaceConnectionProviderId;\n}\n\nexport interface ProviderReaderRuntimeOptions {\n appId: string;\n readers: readonly ProviderReaderRuntimeImplementation[];\n resolveConnection?: (\n options: ProviderReaderRuntimeConnectionResolverOptions,\n ) => Promise<ResolvedWorkspaceConnectionForApp>;\n resolveCredentials?: (\n options: ProviderReaderRuntimeCredentialsResolverOptions,\n ) => Promise<WorkspaceConnectionCredentialsResolution>;\n}\n\nexport interface ProviderReaderRuntime {\n read<TParams extends Record<string, unknown> = Record<string, unknown>>(\n request: ProviderReaderRequest<TParams>,\n ): Promise<ProviderReaderRuntimeResponse>;\n}\n\nexport class ProviderReaderRuntimeError extends Error {\n readonly code: ProviderReaderRuntimeErrorCode;\n readonly providerId: string;\n readonly operation?: ProviderReaderOperation;\n\n constructor(\n code: ProviderReaderRuntimeErrorCode,\n message: string,\n options: {\n providerId: string;\n operation?: ProviderReaderOperation;\n },\n ) {\n super(message);\n this.name = \"ProviderReaderRuntimeError\";\n this.code = code;\n this.providerId = options.providerId;\n this.operation = options.operation;\n }\n}\n\nexport function defineProviderReader<const T extends ProviderReaderDefinition>(\n reader: T,\n): T {\n return reader;\n}\n\nexport function defineProviderReaderImplementation<\n const T extends ProviderReaderRuntimeImplementation,\n>(implementation: T): T {\n return implementation;\n}\n\nconst searchParameters = [\n {\n name: \"query\",\n type: \"string\",\n required: true,\n description: \"Provider-native search text.\",\n },\n {\n name: \"limit\",\n type: \"number\",\n description: \"Maximum normalized results to return.\",\n },\n] as const satisfies readonly ProviderReaderOperationParameter[];\n\nconst getParameters = [\n {\n name: \"id\",\n type: \"string\",\n required: true,\n description: \"Provider-native object identifier.\",\n },\n] as const satisfies readonly ProviderReaderOperationParameter[];\n\nconst listRecentParameters = [\n {\n name: \"limit\",\n type: \"number\",\n description: \"Maximum recent objects to return.\",\n },\n] as const satisfies readonly ProviderReaderOperationParameter[];\n\nfunction operation(\n operationName: ProviderReaderOperation,\n label: string,\n description: string,\n implementationStatus: ProviderReaderImplementationStatus,\n parameters: readonly ProviderReaderOperationParameter[],\n): ProviderReaderOperationDescriptor {\n return {\n operation: operationName,\n label,\n description,\n implementationStatus,\n parameters,\n };\n}\n\nfunction providerCredentialKeys(\n providerId: WorkspaceConnectionProviderId,\n): readonly WorkspaceConnectionCredentialKey[] {\n return getWorkspaceConnectionProvider(providerId)?.credentialKeys ?? [];\n}\n\nfunction requiredCredentialKeys(\n providerId: WorkspaceConnectionProviderId,\n): readonly string[] {\n return providerCredentialKeys(providerId)\n .filter((credential) => credential.required !== false)\n .map((credential) => credential.key);\n}\n\nexport const PROVIDER_READERS = [\n defineProviderReader({\n providerId: \"slack\",\n label: \"Slack reader\",\n description:\n \"Normalized metadata for reading Slack messages and channel history through template-owned Slack implementations.\",\n implementationStatus: \"template-owned\",\n credentialKeys: providerCredentialKeys(\"slack\"),\n requiredCredentialKeys: requiredCredentialKeys(\"slack\"),\n capabilities: [\n {\n capability: \"search\",\n label: \"Message search\",\n description:\n \"Search conversation history using Slack's message search semantics.\",\n },\n {\n capability: \"messages\",\n label: \"Message retrieval\",\n description:\n \"Read individual messages or recent channel activity when a template owns the Slack client.\",\n },\n ],\n operations: [\n operation(\n \"search\",\n \"Search Slack messages\",\n \"Find Slack messages matching text and optional channel filters.\",\n \"template-owned\",\n [\n ...searchParameters,\n {\n name: \"channelId\",\n type: \"string\",\n description: \"Optional Slack channel id to narrow the search.\",\n },\n ],\n ),\n operation(\n \"get\",\n \"Get Slack message\",\n \"Load one Slack message by channel and timestamp/id.\",\n \"template-owned\",\n [\n ...getParameters,\n {\n name: \"channelId\",\n type: \"string\",\n required: true,\n description: \"Slack channel id containing the message.\",\n },\n ],\n ),\n operation(\n \"listRecent\",\n \"List recent Slack messages\",\n \"List recent messages from channels visible to the connected Slack app.\",\n \"template-owned\",\n listRecentParameters,\n ),\n ],\n notes:\n \"Core only exposes the contract; templates still own Slack API calls and provider-specific pagination.\",\n }),\n defineProviderReader({\n providerId: \"github\",\n label: \"GitHub reader\",\n description:\n \"Normalized metadata for reading repositories, issues, pull requests, and code search results.\",\n implementationStatus: \"template-owned\",\n credentialKeys: providerCredentialKeys(\"github\"),\n requiredCredentialKeys: requiredCredentialKeys(\"github\"),\n capabilities: [\n {\n capability: \"search\",\n label: \"Repository search\",\n description:\n \"Search GitHub issues, pull requests, repositories, code, or docs using template-owned clients.\",\n },\n {\n capability: \"code\",\n label: \"Code context\",\n description:\n \"Read code-oriented objects such as repositories, files, issues, and pull requests.\",\n },\n ],\n operations: [\n operation(\n \"search\",\n \"Search GitHub\",\n \"Find repositories, issues, pull requests, code, or documentation matching a query.\",\n \"template-owned\",\n [\n ...searchParameters,\n {\n name: \"owner\",\n type: \"string\",\n description: \"Optional repository owner or organization filter.\",\n },\n {\n name: \"repo\",\n type: \"string\",\n description: \"Optional repository filter.\",\n },\n ],\n ),\n operation(\n \"get\",\n \"Get GitHub object\",\n \"Load one repository, issue, pull request, or file by provider-native id or URL.\",\n \"template-owned\",\n getParameters,\n ),\n operation(\n \"listRecent\",\n \"List recent GitHub activity\",\n \"List recent issues, pull requests, or repository activity visible to the connection.\",\n \"template-owned\",\n listRecentParameters,\n ),\n ],\n notes:\n \"No shared Octokit client is exported from core in this spike; templates remain responsible for API calls.\",\n }),\n defineProviderReader({\n providerId: \"notion\",\n label: \"Notion reader\",\n description:\n \"Normalized metadata for reading Notion pages, databases, and workspace docs.\",\n implementationStatus: \"template-owned\",\n credentialKeys: providerCredentialKeys(\"notion\"),\n requiredCredentialKeys: requiredCredentialKeys(\"notion\"),\n capabilities: [\n {\n capability: \"search\",\n label: \"Page search\",\n description:\n \"Search pages and databases shared with the Notion integration.\",\n },\n {\n capability: \"docs\",\n label: \"Document retrieval\",\n description:\n \"Read Notion page or database metadata through template-owned clients.\",\n },\n ],\n operations: [\n operation(\n \"search\",\n \"Search Notion\",\n \"Find Notion pages or databases matching text and optional object type filters.\",\n \"template-owned\",\n searchParameters,\n ),\n operation(\n \"get\",\n \"Get Notion object\",\n \"Load one Notion page or database by id.\",\n \"template-owned\",\n getParameters,\n ),\n operation(\n \"listRecent\",\n \"List recent Notion objects\",\n \"List recently edited pages or databases visible to the integration.\",\n \"template-owned\",\n listRecentParameters,\n ),\n ],\n notes:\n \"Core does not traverse Notion blocks yet; templates own page hydration and rate-limit behavior.\",\n }),\n defineProviderReader({\n providerId: \"hubspot\",\n label: \"HubSpot reader\",\n description:\n \"Normalized metadata for CRM object lookup through template-owned HubSpot integrations.\",\n implementationStatus: \"template-owned\",\n credentialKeys: providerCredentialKeys(\"hubspot\"),\n requiredCredentialKeys: requiredCredentialKeys(\"hubspot\"),\n capabilities: [\n {\n capability: \"search\",\n label: \"CRM search\",\n description:\n \"Search CRM contacts, companies, deals, tickets, and engagements.\",\n },\n {\n capability: \"crm\",\n label: \"CRM retrieval\",\n description:\n \"Read CRM objects when a template owns HubSpot object mapping.\",\n },\n ],\n operations: [\n operation(\n \"search\",\n \"Search HubSpot CRM\",\n \"Find CRM records matching text or provider-native filters.\",\n \"template-owned\",\n [\n ...searchParameters,\n {\n name: \"objectType\",\n type: \"string\",\n description:\n \"Optional HubSpot object type such as contact, company, deal, or ticket.\",\n },\n ],\n ),\n operation(\n \"get\",\n \"Get HubSpot CRM object\",\n \"Load one CRM record by object type and id.\",\n \"template-owned\",\n [\n ...getParameters,\n {\n name: \"objectType\",\n type: \"string\",\n required: true,\n description:\n \"HubSpot object type such as contact, company, deal, or ticket.\",\n },\n ],\n ),\n operation(\n \"listRecent\",\n \"List recent HubSpot CRM objects\",\n \"List recently updated CRM records visible to the private app token.\",\n \"template-owned\",\n listRecentParameters,\n ),\n ],\n notes:\n \"Templates define object allow-lists and property projections; core only documents the reader shape.\",\n }),\n defineProviderReader({\n providerId: \"salesforce\",\n label: \"Salesforce reader\",\n description:\n \"Normalized metadata for CRM object lookup through template-owned Salesforce integrations.\",\n implementationStatus: \"template-owned\",\n credentialKeys: providerCredentialKeys(\"salesforce\"),\n requiredCredentialKeys: requiredCredentialKeys(\"salesforce\"),\n capabilities: [\n {\n capability: \"search\",\n label: \"CRM search\",\n description:\n \"Search Salesforce CRM records with provider-native SOQL or object filters.\",\n },\n {\n capability: \"crm\",\n label: \"CRM retrieval\",\n description:\n \"Read Salesforce standard and custom CRM objects when a template owns object mapping.\",\n },\n ],\n operations: [\n operation(\n \"search\",\n \"Search Salesforce CRM\",\n \"Find CRM records matching text, SOQL, or provider-native filters.\",\n \"template-owned\",\n [\n ...searchParameters,\n {\n name: \"objectType\",\n type: \"string\",\n description:\n \"Optional Salesforce object API name such as Account, Contact, Opportunity, or a custom object.\",\n },\n ],\n ),\n operation(\n \"get\",\n \"Get Salesforce CRM object\",\n \"Load one Salesforce CRM record by object API name and id.\",\n \"template-owned\",\n [\n ...getParameters,\n {\n name: \"objectType\",\n type: \"string\",\n required: true,\n description:\n \"Salesforce object API name such as Account, Contact, Opportunity, or a custom object.\",\n },\n ],\n ),\n operation(\n \"listRecent\",\n \"List recent Salesforce CRM objects\",\n \"List recently updated CRM records visible to the connected Salesforce user.\",\n \"template-owned\",\n listRecentParameters,\n ),\n ],\n notes:\n \"Templates define object allow-lists, field projections, and API-version selection; core only documents the reader shape.\",\n }),\n defineProviderReader({\n providerId: \"gmail\",\n label: \"Gmail reader\",\n description:\n \"Normalized metadata for mailbox search and thread/message reads through app-owned Google OAuth flows.\",\n implementationStatus: \"template-owned\",\n credentialKeys: providerCredentialKeys(\"gmail\"),\n requiredCredentialKeys: requiredCredentialKeys(\"gmail\"),\n capabilities: [\n {\n capability: \"search\",\n label: \"Mailbox search\",\n description: \"Search Gmail messages and threads.\",\n },\n {\n capability: \"messages\",\n label: \"Mail retrieval\",\n description:\n \"Read Gmail messages and threads when a template owns OAuth token handling.\",\n },\n ],\n operations: [\n operation(\n \"search\",\n \"Search Gmail\",\n \"Find Gmail messages or threads matching a query.\",\n \"template-owned\",\n searchParameters,\n ),\n operation(\n \"get\",\n \"Get Gmail message or thread\",\n \"Load one Gmail message or thread by provider-native id.\",\n \"template-owned\",\n getParameters,\n ),\n operation(\n \"listRecent\",\n \"List recent Gmail messages\",\n \"List recent mailbox messages visible to the connected Google account.\",\n \"template-owned\",\n listRecentParameters,\n ),\n ],\n notes:\n \"This is metadata for templates with Google OAuth; core does not expose a shared Gmail network client here.\",\n }),\n defineProviderReader({\n providerId: \"google_drive\",\n label: \"Google Drive reader\",\n description:\n \"Normalized metadata for Drive file search and document lookup through app-owned Google OAuth flows.\",\n implementationStatus: \"template-owned\",\n credentialKeys: providerCredentialKeys(\"google_drive\"),\n requiredCredentialKeys: requiredCredentialKeys(\"google_drive\"),\n capabilities: [\n {\n capability: \"search\",\n label: \"Drive search\",\n description: \"Search files visible to the connected Google account.\",\n },\n {\n capability: \"docs\",\n label: \"Drive document retrieval\",\n description:\n \"Read file metadata or exported document content through template-owned Google clients.\",\n },\n ],\n operations: [\n operation(\n \"search\",\n \"Search Google Drive\",\n \"Find Drive files matching text, MIME type, or folder filters.\",\n \"template-owned\",\n [\n ...searchParameters,\n {\n name: \"mimeType\",\n type: \"string\",\n description: \"Optional MIME type filter.\",\n },\n ],\n ),\n operation(\n \"get\",\n \"Get Google Drive file\",\n \"Load one Drive file by id.\",\n \"template-owned\",\n getParameters,\n ),\n operation(\n \"listRecent\",\n \"List recent Google Drive files\",\n \"List recently modified files visible to the connected Google account.\",\n \"template-owned\",\n listRecentParameters,\n ),\n ],\n notes:\n \"Templates still own file export formats, Docs/Sheets/Slides handling, and OAuth token refresh.\",\n }),\n defineProviderReader({\n providerId: \"generic\",\n label: \"Generic metadata reader\",\n description:\n \"Placeholder reader metadata for custom sources that expose searchable documents through a template-specific adapter.\",\n implementationStatus: \"metadata-only\",\n credentialKeys: providerCredentialKeys(\"generic\"),\n requiredCredentialKeys: requiredCredentialKeys(\"generic\"),\n capabilities: [\n {\n capability: \"search\",\n label: \"Custom search\",\n description:\n \"Describe a template-specific search interface for one-off sources.\",\n },\n {\n capability: \"docs\",\n label: \"Custom document retrieval\",\n description:\n \"Describe a template-specific document retrieval interface.\",\n },\n ],\n operations: [\n operation(\n \"search\",\n \"Search custom source\",\n \"Metadata-only descriptor for searching a custom source.\",\n \"metadata-only\",\n searchParameters,\n ),\n operation(\n \"get\",\n \"Get custom source object\",\n \"Metadata-only descriptor for loading one custom source object by id.\",\n \"metadata-only\",\n getParameters,\n ),\n ],\n notes:\n \"Use this only to document a template-owned adapter; core cannot execute generic provider reads.\",\n }),\n] as const satisfies readonly ProviderReaderDefinition[];\n\nconst READERS_BY_PROVIDER_ID = new Map<\n WorkspaceConnectionProviderId,\n ProviderReaderDefinition\n>(PROVIDER_READERS.map((reader) => [reader.providerId, reader]));\n\nexport function listProviderReaders(\n options: ListProviderReadersOptions = {},\n): ProviderReaderDefinition[] {\n return PROVIDER_READERS.filter((reader) => {\n if (options.providerId && reader.providerId !== options.providerId) {\n return false;\n }\n if (\n options.capability &&\n !reader.capabilities.some(\n (capability) => capability.capability === options.capability,\n )\n ) {\n return false;\n }\n if (\n options.operation &&\n !reader.operations.some(\n (operation) => operation.operation === options.operation,\n )\n ) {\n return false;\n }\n if (\n options.implementationStatus &&\n reader.implementationStatus !== options.implementationStatus\n ) {\n return false;\n }\n return true;\n }).map(cloneProviderReader);\n}\n\nexport function getProviderReader(\n providerId: string,\n): ProviderReaderDefinition \| undefined {\n const reader = READERS_BY_PROVIDER_ID.get(\n providerId as WorkspaceConnectionProviderId,\n );\n return reader ? cloneProviderReader(reader) : undefined;\n}\n\nexport function providerReaderSupports(\n providerOrReader: ProviderReaderDefinition \| WorkspaceConnectionProviderId,\n operationName: ProviderReaderOperation,\n): boolean {\n const reader =\n typeof providerOrReader === \"string\"\n ? getProviderReader(providerOrReader)\n : providerOrReader;\n return (\n reader?.operations.some(\n (operation) => operation.operation === operationName,\n ) ?? false\n );\n}\n\nexport function createProviderReaderRuntime(\n options: ProviderReaderRuntimeOptions,\n): ProviderReaderRuntime {\n const appId = options.appId.trim();\n if (!appId) {\n throw new Error(\"createProviderReaderRuntime appId is required.\");\n }\n\n const implementations = new Map<\n WorkspaceConnectionProviderId,\n ProviderReaderRuntimeImplementation\n >();\n for (const implementation of options.readers) {\n implementations.set(implementation.providerId, implementation);\n }\n\n const connectionResolver =\n options.resolveConnection ??\n ((resolverOptions: ProviderReaderRuntimeConnectionResolverOptions) =>\n resolveWorkspaceConnectionForApp({\n appId: resolverOptions.appId,\n provider: resolverOptions.providerId,\n connectionId: resolverOptions.connectionId,\n includeDisabled: false,\n requireConnected: true,\n }));\n const credentialsResolver =\n options.resolveCredentials ??\n ((resolverOptions: ProviderReaderRuntimeCredentialsResolverOptions) =>\n resolveWorkspaceConnectionCredentialsForApp({\n appId: resolverOptions.appId,\n provider: resolverOptions.providerId,\n connectionId: resolverOptions.connectionId,\n keys: resolverOptions.keys,\n userEmail: resolverOptions.userEmail,\n orgId: resolverOptions.orgId,\n }));\n\n return {\n async read<\n TParams extends Record<string, unknown> = Record<string, unknown>,\n >(\n request: ProviderReaderRequest<TParams>,\n ): Promise<ProviderReaderRuntimeResponse> {\n const reader = getProviderReader(request.providerId);\n if (!reader) {\n throw new ProviderReaderRuntimeError(\n \"unsupported_provider\",\n `No provider reader metadata is registered for ${request.providerId}.`,\n { providerId: request.providerId, operation: request.operation },\n );\n }\n\n const operation = reader.operations.find(\n (entry) => entry.operation === request.operation,\n );\n if (!operation) {\n throw new ProviderReaderRuntimeError(\n \"unsupported_operation\",\n `${reader.label} does not support ${request.operation}.`,\n { providerId: request.providerId, operation: request.operation },\n );\n }\n\n const implementation = implementations.get(request.providerId);\n if (!implementation) {\n throw new ProviderReaderRuntimeError(\n \"unsupported_provider\",\n `${reader.label} has no runtime implementation registered.`,\n { providerId: request.providerId, operation: request.operation },\n );\n }\n\n const handler = implementation.operations[request.operation];\n if (!handler) {\n throw new ProviderReaderRuntimeError(\n \"unsupported_operation\",\n `${reader.label} has no runtime handler for ${request.operation}.`,\n { providerId: request.providerId, operation: request.operation },\n );\n }\n\n const resolvedConnection = await connectionResolver({\n appId,\n providerId: request.providerId,\n connectionId: request.connectionId?.trim() \|\| undefined,\n });\n if (!resolvedConnection.available \|\| !resolvedConnection.connection) {\n throw new ProviderReaderRuntimeError(\n \"connection_not_available\",\n resolvedConnection.reason,\n { providerId: request.providerId, operation: request.operation },\n );\n }\n\n const connection = publicRuntimeConnection(resolvedConnection.connection);\n const context: ProviderReaderRuntimeContext = {\n appId,\n providerId: request.providerId,\n reader,\n connection,\n resolveCredentials: (keys = reader.requiredCredentialKeys) =>\n credentialsResolver({\n appId,\n providerId: request.providerId,\n connectionId: connection.id,\n keys: [...keys],\n userEmail: request.userEmail,\n orgId: request.orgId,\n }),\n requireCredentials: async (keys = reader.requiredCredentialKeys) => {\n const resolution = await credentialsResolver({\n appId,\n providerId: request.providerId,\n connectionId: connection.id,\n keys: [...keys],\n userEmail: request.userEmail,\n orgId: request.orgId,\n });\n if (!resolution.available) {\n throw new ProviderReaderRuntimeError(\n \"credentials_unavailable\",\n `Missing workspace connection credentials for ${reader.label}: ${resolution.missingKeys.join(\", \")}.`,\n {\n providerId: request.providerId,\n operation: request.operation,\n },\n );\n }\n return { values: resolution.values, resolution };\n },\n };\n\n return handler((request.params ?? {}) as TParams, context);\n },\n };\n}\n\nfunction cloneProviderReader(\n reader: ProviderReaderDefinition,\n): ProviderReaderDefinition {\n return {\n ...reader,\n credentialKeys: reader.credentialKeys.map((credential) => ({\n ...credential,\n })),\n requiredCredentialKeys: [...reader.requiredCredentialKeys],\n capabilities: reader.capabilities.map((capability) => ({\n ...capability,\n })),\n operations: reader.operations.map((operation) => ({\n ...operation,\n parameters: operation.parameters.map((parameter) => ({\n ...parameter,\n })),\n })),\n };\n}\n\nfunction publicRuntimeConnection(\n connection: WorkspaceConnectionForApp,\n): ProviderReaderRuntimeConnection {\n return {\n id: connection.id,\n provider: connection.provider,\n label: connection.label,\n accountId: connection.accountId,\n accountLabel: connection.accountLabel,\n credentialRefs: publicCredentialRefs(connection),\n };\n}\n\nfunction publicCredentialRefs(\n connection: WorkspaceConnectionForApp,\n): WorkspaceConnectionPublicCredentialRef[] {\n return [\n ...(connection.explicitGrant?.credentialRefs ?? []).map((ref) =>\n publicCredentialRef(ref, \"grant\"),\n ),\n ...connection.credentialRefs.map((ref) =>\n publicCredentialRef(ref, \"connection\"),\n ),\n ];\n}\n\nfunction publicCredentialRef(\n ref: WorkspaceConnectionCredentialRef,\n source: WorkspaceConnectionPublicCredentialRef[\"source\"],\n): WorkspaceConnectionPublicCredentialRef {\n return {\n key: ref.key,\n scope: ref.scope,\n provider: ref.provider,\n label: ref.label,\n source,\n };\n}\n"]}

package/dist/dashboard-storage/index.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+export { createDashboardStorageSchema, type DashboardStorageSchema, type DashboardStorageSchemaOptions, } from "./schema.js";
+export { createDashboardStorage, DashboardStorageConflictError, type DashboardRecord, type DashboardRevisionRecord, type DashboardStorageOptions, type DashboardWriteInput, } from "./store.js";
+export { createPanelSourceResolverRegistry, createProgramPanelSourceResolver, parseProgramPanelDescriptor, type DashboardPanelColumn, type PanelSourceFailure, type PanelSourceRequest, type PanelSourceResolver, type PanelSourceResolverRegistry, type PanelSourceResponse, type PanelSourceResult, type ProgramPanelContext, type ProgramPanelDescriptor, } from "./panel-source.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/dashboard-storage/index.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dashboard-storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,GACnC,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iCAAiC,EACjC,gCAAgC,EAChC,2BAA2B,EAC3B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC"}

package/dist/dashboard-storage/index.js ADDED Viewed

@@ -0,0 +1,4 @@
+export { createDashboardStorageSchema, } from "./schema.js";
+export { createDashboardStorage, DashboardStorageConflictError, } from "./store.js";
+export { createPanelSourceResolverRegistry, createProgramPanelSourceResolver, parseProgramPanelDescriptor, } from "./panel-source.js";
+//# sourceMappingURL=index.js.map

package/dist/dashboard-storage/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dashboard-storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,GAG7B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,sBAAsB,EACtB,6BAA6B,GAK9B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iCAAiC,EACjC,gCAAgC,EAChC,2BAA2B,GAU5B,MAAM,mBAAmB,CAAC","sourcesContent":["export {\n createDashboardStorageSchema,\n type DashboardStorageSchema,\n type DashboardStorageSchemaOptions,\n} from \"./schema.js\";\nexport {\n createDashboardStorage,\n DashboardStorageConflictError,\n type DashboardRecord,\n type DashboardRevisionRecord,\n type DashboardStorageOptions,\n type DashboardWriteInput,\n} from \"./store.js\";\nexport {\n createPanelSourceResolverRegistry,\n createProgramPanelSourceResolver,\n parseProgramPanelDescriptor,\n type DashboardPanelColumn,\n type PanelSourceFailure,\n type PanelSourceRequest,\n type PanelSourceResolver,\n type PanelSourceResolverRegistry,\n type PanelSourceResponse,\n type PanelSourceResult,\n type ProgramPanelContext,\n type ProgramPanelDescriptor,\n} from \"./panel-source.js\";\n"]}

package/dist/dashboard-storage/panel-source.d.ts ADDED Viewed

@@ -0,0 +1,68 @@
+export interface DashboardPanelColumn {
+    name: string;
+    type: string;
+}
+export interface PanelSourceRequest<TSource extends string = string> {
+    source: TSource;
+    query: string;
+}
+export interface PanelSourceResult {
+    rows: Record<string, unknown>[];
+    schema?: DashboardPanelColumn[];
+    truncated?: boolean;
+    bytesProcessed?: number;
+}
+export interface PanelSourceFailure {
+    error: string;
+    message?: string;
+}
+export type PanelSourceResponse = PanelSourceResult | PanelSourceFailure;
+export interface PanelSourceResolver<TSource extends string = string, TContext = unknown> {
+    source: TSource;
+    resolve(request: PanelSourceRequest<TSource>, context: TContext): Promise<PanelSourceResponse>;
+}
+export interface PanelSourceResolverRegistry<TSource extends string = string, TContext = unknown> {
+    readonly sources: readonly TSource[];
+    resolve(request: PanelSourceRequest<TSource>, context: TContext): Promise<PanelSourceResponse>;
+}
+export declare function createPanelSourceResolverRegistry<TSource extends string = string, TContext = unknown>(options: {
+    resolvers: readonly PanelSourceResolver<TSource, TContext>[];
+}): PanelSourceResolverRegistry<TSource, TContext>;
+export interface ProgramPanelContext {
+    userEmail: string;
+    orgId?: string | null;
+}
+export interface ProgramPanelDescriptor {
+    programId: string;
+    params?: Record<string, unknown>;
+}
+export interface ProgramPanelRunResult {
+    ok: boolean;
+    rows?: Record<string, unknown>[];
+    schema?: DashboardPanelColumn[];
+    truncated?: boolean;
+    lastGoodRun?: {
+        rows: Record<string, unknown>[];
+        schema: DashboardPanelColumn[];
+        truncated?: boolean;
+    };
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export declare function parseProgramPanelDescriptor(query: string): ProgramPanelDescriptor;
+export declare function createProgramPanelSourceResolver(options: {
+    appId: string;
+    run?: (args: {
+        programId: string;
+        appId: string;
+        params?: Record<string, unknown>;
+        ctx: {
+            userEmail: string;
+            orgId: string | null;
+        };
+        triggeredBy: "panel_view";
+    }) => Promise<ProgramPanelRunResult>;
+}): PanelSourceResolver<"program", ProgramPanelContext>;
+//# sourceMappingURL=panel-source.d.ts.map

package/dist/dashboard-storage/panel-source.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"panel-source.d.ts","sourceRoot":"","sources":["../../src/dashboard-storage/panel-source.ts"],"names":[],"mappings":"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"}

package/dist/dashboard-storage/panel-source.js ADDED Viewed

@@ -0,0 +1,76 @@
+import { runDataProgram } from "../data-programs/index.js";
+export function createPanelSourceResolverRegistry(options) {
+    const resolvers = new Map();
+    for (const resolver of options.resolvers) {
+        const source = resolver.source.trim();
+        if (!source)
+            throw new Error("Panel source resolver requires a source.");
+        if (resolvers.has(source)) {
+            throw new Error(`Duplicate panel source resolver: ${source}`);
+        }
+        resolvers.set(source, resolver);
+    }
+    return {
+        sources: [...resolvers.keys()],
+        async resolve(request, context) {
+            const resolver = resolvers.get(request.source);
+            if (!resolver) {
+                throw new Error(`Unsupported dashboard panel source: ${request.source}`);
+            }
+            return resolver.resolve(request, context);
+        },
+    };
+}
+export function parseProgramPanelDescriptor(query) {
+    let value;
+    try {
+        value = JSON.parse(query);
+    }
+    catch {
+        throw new Error("Program panel query must be a JSON object.");
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("Program panel query must be a JSON object.");
+    }
+    const descriptor = value;
+    if (typeof descriptor.programId !== "string" ||
+        !descriptor.programId.trim()) {
+        throw new Error("Program panel query requires a programId.");
+    }
+    const params = descriptor.params &&
+        typeof descriptor.params === "object" &&
+        !Array.isArray(descriptor.params)
+        ? descriptor.params
+        : undefined;
+    return { programId: descriptor.programId.trim(), params };
+}
+export function createProgramPanelSourceResolver(options) {
+    const run = options.run ?? runDataProgram;
+    return {
+        source: "program",
+        async resolve(request, context) {
+            const descriptor = parseProgramPanelDescriptor(request.query);
+            const result = await run({
+                programId: descriptor.programId,
+                appId: options.appId,
+                params: descriptor.params,
+                ctx: {
+                    userEmail: context.userEmail,
+                    orgId: context.orgId ?? null,
+                },
+                triggeredBy: "panel_view",
+            });
+            if (result.ok) {
+                return {
+                    rows: result.rows ?? [],
+                    schema: result.schema,
+                    truncated: result.truncated,
+                };
+            }
+            if (result.lastGoodRun)
+                return result.lastGoodRun;
+            throw new Error(`${result.error?.code ?? "program_failed"}: ${result.error?.message ?? "Data program failed."}`);
+        },
+    };
+}
+//# sourceMappingURL=panel-source.js.map

package/dist/dashboard-storage/panel-source.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"panel-source.js","sourceRoot":"","sources":["../../src/dashboard-storage/panel-source.ts"],"names":[],"mappings":"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","sourcesContent":["import { runDataProgram } from \"../data-programs/index.js\";\n\nexport interface DashboardPanelColumn {\n name: string;\n type: string;\n}\n\nexport interface PanelSourceRequest<TSource extends string = string> {\n source: TSource;\n query: string;\n}\n\nexport interface PanelSourceResult {\n rows: Record<string, unknown>[];\n schema?: DashboardPanelColumn[];\n truncated?: boolean;\n bytesProcessed?: number;\n}\n\nexport interface PanelSourceFailure {\n error: string;\n message?: string;\n}\n\nexport type PanelSourceResponse = PanelSourceResult | PanelSourceFailure;\n\nexport interface PanelSourceResolver<\n TSource extends string = string,\n TContext = unknown,\n> {\n source: TSource;\n resolve(\n request: PanelSourceRequest<TSource>,\n context: TContext,\n ): Promise<PanelSourceResponse>;\n}\n\nexport interface PanelSourceResolverRegistry<\n TSource extends string = string,\n TContext = unknown,\n> {\n readonly sources: readonly TSource[];\n resolve(\n request: PanelSourceRequest<TSource>,\n context: TContext,\n ): Promise<PanelSourceResponse>;\n}\n\nexport function createPanelSourceResolverRegistry<\n TSource extends string = string,\n TContext = unknown,\n>(options: {\n resolvers: readonly PanelSourceResolver<TSource, TContext>[];\n}): PanelSourceResolverRegistry<TSource, TContext> {\n const resolvers = new Map<TSource, PanelSourceResolver<TSource, TContext>>();\n for (const resolver of options.resolvers) {\n const source = resolver.source.trim() as TSource;\n if (!source) throw new Error(\"Panel source resolver requires a source.\");\n if (resolvers.has(source)) {\n throw new Error(`Duplicate panel source resolver: ${source}`);\n }\n resolvers.set(source, resolver);\n }\n\n return {\n sources: [...resolvers.keys()],\n async resolve(request, context) {\n const resolver = resolvers.get(request.source);\n if (!resolver) {\n throw new Error(\n `Unsupported dashboard panel source: ${request.source}`,\n );\n }\n return resolver.resolve(request, context);\n },\n };\n}\n\nexport interface ProgramPanelContext {\n userEmail: string;\n orgId?: string | null;\n}\n\nexport interface ProgramPanelDescriptor {\n programId: string;\n params?: Record<string, unknown>;\n}\n\nexport interface ProgramPanelRunResult {\n ok: boolean;\n rows?: Record<string, unknown>[];\n schema?: DashboardPanelColumn[];\n truncated?: boolean;\n lastGoodRun?: {\n rows: Record<string, unknown>[];\n schema: DashboardPanelColumn[];\n truncated?: boolean;\n };\n error?: { code: string; message: string };\n}\n\nexport function parseProgramPanelDescriptor(\n query: string,\n): ProgramPanelDescriptor {\n let value: unknown;\n try {\n value = JSON.parse(query);\n } catch {\n throw new Error(\"Program panel query must be a JSON object.\");\n }\n if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n throw new Error(\"Program panel query must be a JSON object.\");\n }\n const descriptor = value as Record<string, unknown>;\n if (\n typeof descriptor.programId !== \"string\" ||\n !descriptor.programId.trim()\n ) {\n throw new Error(\"Program panel query requires a programId.\");\n }\n const params =\n descriptor.params &&\n typeof descriptor.params === \"object\" &&\n !Array.isArray(descriptor.params)\n ? (descriptor.params as Record<string, unknown>)\n : undefined;\n return { programId: descriptor.programId.trim(), params };\n}\n\nexport function createProgramPanelSourceResolver(options: {\n appId: string;\n run?: (args: {\n programId: string;\n appId: string;\n params?: Record<string, unknown>;\n ctx: { userEmail: string; orgId: string | null };\n triggeredBy: \"panel_view\";\n }) => Promise<ProgramPanelRunResult>;\n}): PanelSourceResolver<\"program\", ProgramPanelContext> {\n const run = options.run ?? runDataProgram;\n return {\n source: \"program\",\n async resolve(request, context) {\n const descriptor = parseProgramPanelDescriptor(request.query);\n const result = await run({\n programId: descriptor.programId,\n appId: options.appId,\n params: descriptor.params,\n ctx: {\n userEmail: context.userEmail,\n orgId: context.orgId ?? null,\n },\n triggeredBy: \"panel_view\",\n });\n if (result.ok) {\n return {\n rows: result.rows ?? [],\n schema: result.schema,\n truncated: result.truncated,\n };\n }\n if (result.lastGoodRun) return result.lastGoodRun;\n throw new Error(\n `${result.error?.code ?? \"program_failed\"}: ${result.error?.message ?? \"Data program failed.\"}`,\n );\n },\n };\n}\n"]}