@agent-native/core 0.16.1 → 0.16.3

package/dist/code-agents/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/code-agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,EAC9B,wBAAwB,EACxB,0BAA0B,EAC1B,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,uBAAuB,EACvB,6BAA6B,EAC7B,gCAAgC,EAChC,sBAAsB,EACtB,wBAAwB,GAYzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,uBAAuB,EACvB,iCAAiC,EACjC,iBAAiB,EACjB,wBAAwB,EACxB,+BAA+B,EAC/B,mBAAmB,EACnB,+BAA+B,GAKhC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,+BAA+B,GAEhC,MAAM,+BAA+B,CAAC","sourcesContent":["export {\n  CODE_AGENT_PERMISSION_MODES,\n  appendCodeAgentTranscriptEvent,\n  codeAgentRunArtifactsDir,\n  codeAgentRunTranscriptPath,\n  codeAgentRunsDir,\n  codeAgentStoreRoot,\n  codeAgentTranscriptsDir,\n  createCodeAgentRunRecord,\n  getCodeAgentRunRecord,\n  getLastCodeAgentRunRecord,\n  isActiveCodeAgentRun,\n  listCodeAgentRunRecords,\n  listCodeAgentTranscriptEvents,\n  normalizeCodeAgentPermissionMode,\n  queueCodeAgentFollowUp,\n  updateCodeAgentRunRecord,\n  type AppendCodeAgentTranscriptEventInput,\n  type CodeAgentPermissionMode,\n  type CodeAgentRunDetail,\n  type CodeAgentRunProgress,\n  type CodeAgentRunRecord,\n  type CodeAgentRunStatus,\n  type CodeAgentTranscriptEvent,\n  type CodeAgentTranscriptEventKind,\n  type CreateCodeAgentRunInput,\n  type CodeAgentFollowUpMode,\n  type QueueCodeAgentFollowUpInput,\n} from \"../cli/code-agent-runs.js\";\nexport {\n  findProjectSlashCommand,\n  isReservedProjectSlashCommandName,\n  listProjectSkills,\n  listProjectSlashCommands,\n  listVisibleProjectSlashCommands,\n  readProjectCodePack,\n  renderProjectSlashCommandPrompt,\n  type CodeAgentCodePack,\n  type CodeAgentProjectCommand,\n  type CodeAgentProjectSkill,\n  type ReadProjectCodePackOptions,\n} from \"../cli/code-agent-commands.js\";\nexport {\n  executeCodeAgentRun,\n  executeExistingCodeAgentRun,\n  executePendingCodeAgentApproval,\n  type ExecuteCodeAgentRunOptions,\n} from \"../cli/code-agent-executor.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/code-agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wCAAwC,EACxC,wCAAwC,EACxC,kCAAkC,GAMnC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,mCAAmC,EACnC,oBAAoB,EACpB,gCAAgC,GAQjC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,EAC9B,wBAAwB,EACxB,0BAA0B,EAC1B,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,uBAAuB,EACvB,6BAA6B,EAC7B,gCAAgC,EAChC,sBAAsB,EACtB,wBAAwB,GAYzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,uBAAuB,EACvB,iCAAiC,EACjC,iBAAiB,EACjB,wBAAwB,EACxB,+BAA+B,EAC/B,mBAAmB,EACnB,+BAA+B,GAKhC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,+BAA+B,GAEhC,MAAM,+BAA+B,CAAC","sourcesContent":["export {\n  createCompositeBackgroundAgentController,\n  createLocalCodeBackgroundAgentController,\n  localCodeBackgroundAgentController,\n  type BackgroundAgentController,\n  type BackgroundAgentControlCommand,\n  type BackgroundAgentControlInput,\n  type BackgroundAgentControlResult,\n  type BackgroundAgentFollowUpInput,\n} from \"./background-controller.js\";\nexport {\n  getBackgroundAgentRun,\n  listBackgroundAgentRuns,\n  listBackgroundAgentTranscriptEvents,\n  toBackgroundAgentRun,\n  toBackgroundAgentTranscriptEvent,\n  type BackgroundAgentRun,\n  type BackgroundAgentRunKind,\n  type BackgroundAgentRunSource,\n  type BackgroundAgentRunSourceRecord,\n  type BackgroundAgentRunStatus,\n  type BackgroundAgentTranscriptEvent,\n  type ListBackgroundAgentRunsOptions,\n} from \"./background-run.js\";\nexport {\n  CODE_AGENT_PERMISSION_MODES,\n  appendCodeAgentTranscriptEvent,\n  codeAgentRunArtifactsDir,\n  codeAgentRunTranscriptPath,\n  codeAgentRunsDir,\n  codeAgentStoreRoot,\n  codeAgentTranscriptsDir,\n  createCodeAgentRunRecord,\n  getCodeAgentRunRecord,\n  getLastCodeAgentRunRecord,\n  isActiveCodeAgentRun,\n  listCodeAgentRunRecords,\n  listCodeAgentTranscriptEvents,\n  normalizeCodeAgentPermissionMode,\n  queueCodeAgentFollowUp,\n  updateCodeAgentRunRecord,\n  type AppendCodeAgentTranscriptEventInput,\n  type CodeAgentPermissionMode,\n  type CodeAgentRunDetail,\n  type CodeAgentRunProgress,\n  type CodeAgentRunRecord,\n  type CodeAgentRunStatus,\n  type CodeAgentTranscriptEvent,\n  type CodeAgentTranscriptEventKind,\n  type CreateCodeAgentRunInput,\n  type CodeAgentFollowUpMode,\n  type QueueCodeAgentFollowUpInput,\n} from \"../cli/code-agent-runs.js\";\nexport {\n  findProjectSlashCommand,\n  isReservedProjectSlashCommandName,\n  listProjectSkills,\n  listProjectSlashCommands,\n  listVisibleProjectSlashCommands,\n  readProjectCodePack,\n  renderProjectSlashCommandPrompt,\n  type CodeAgentCodePack,\n  type CodeAgentProjectCommand,\n  type CodeAgentProjectSkill,\n  type ReadProjectCodePackOptions,\n} from \"../cli/code-agent-commands.js\";\nexport {\n  executeCodeAgentRun,\n  executeExistingCodeAgentRun,\n  executePendingCodeAgentApproval,\n  type ExecuteCodeAgentRunOptions,\n} from \"../cli/code-agent-executor.js\";\n"]}

package/dist/connections/index.d.ts

@@ -1,2 +1,3 @@
 export { WORKSPACE_CONNECTION_PROVIDERS, defineWorkspaceConnectionProvider, getWorkspaceConnectionProvider, isWorkspaceConnectionProviderId, listWorkspaceConnectionProviders, listWorkspaceConnectionProvidersForCapability, listWorkspaceConnectionProvidersForTemplate, workspaceConnectionProviderSupports, type ListWorkspaceConnectionProvidersOptions, type WorkspaceConnectionCapability, type WorkspaceConnectionCredentialKey, type WorkspaceConnectionProvider, type WorkspaceConnectionProviderId, type WorkspaceConnectionTemplateUse, } from "./catalog.js";
+export { PROVIDER_READERS, ProviderReaderRuntimeError, createProviderReaderRuntime, defineProviderReader, defineProviderReaderImplementation, getProviderReader, listProviderReaders, providerReaderSupports, type ListProviderReadersOptions, type ProviderReaderCredentialRequirement, type ProviderReaderCapability, type ProviderReaderDefinition, type ProviderReaderImplementationStatus, type ProviderReaderOperation, type ProviderReaderOperationDescriptor, type ProviderReaderOperationParameter, type ProviderReaderRequest, type ProviderReaderRuntime, type ProviderReaderRuntimeConnection, type ProviderReaderRuntimeConnectionResolverOptions, type ProviderReaderRuntimeContext, type ProviderReaderRuntimeCredentialsResolverOptions, type ProviderReaderRuntimeErrorCode, type ProviderReaderRuntimeHandler, type ProviderReaderRuntimeImplementation, type ProviderReaderRuntimeItem, type ProviderReaderRuntimeOptions, type ProviderReaderRuntimeResponse, } from "./reader.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/connections/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connections/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,iCAAiC,EACjC,8BAA8B,EAC9B,+BAA+B,EAC/B,gCAAgC,EAChC,6CAA6C,EAC7C,2CAA2C,EAC3C,mCAAmC,EACnC,KAAK,uCAAuC,EAC5C,KAAK,6BAA6B,EAClC,KAAK,gCAAgC,EACrC,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,EAClC,KAAK,8BAA8B,GACpC,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connections/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,iCAAiC,EACjC,8BAA8B,EAC9B,+BAA+B,EAC/B,gCAAgC,EAChC,6CAA6C,EAC7C,2CAA2C,EAC3C,mCAAmC,EACnC,KAAK,uCAAuC,EAC5C,KAAK,6BAA6B,EAClC,KAAK,gCAAgC,EACrC,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,EAClC,KAAK,8BAA8B,GACpC,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,2BAA2B,EAC3B,oBAAoB,EACpB,kCAAkC,EAClC,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,KAAK,0BAA0B,EAC/B,KAAK,mCAAmC,EACxC,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,kCAAkC,EACvC,KAAK,uBAAuB,EAC5B,KAAK,iCAAiC,EACtC,KAAK,gCAAgC,EACrC,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,+BAA+B,EACpC,KAAK,8CAA8C,EACnD,KAAK,4BAA4B,EACjC,KAAK,+CAA+C,EACpD,KAAK,8BAA8B,EACnC,KAAK,4BAA4B,EACjC,KAAK,mCAAmC,EACxC,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,GACnC,MAAM,aAAa,CAAC"}

package/dist/connections/index.js

@@ -1,2 +1,3 @@
 export { WORKSPACE_CONNECTION_PROVIDERS, defineWorkspaceConnectionProvider, getWorkspaceConnectionProvider, isWorkspaceConnectionProviderId, listWorkspaceConnectionProviders, listWorkspaceConnectionProvidersForCapability, listWorkspaceConnectionProvidersForTemplate, workspaceConnectionProviderSupports, } from "./catalog.js";
+export { PROVIDER_READERS, ProviderReaderRuntimeError, createProviderReaderRuntime, defineProviderReader, defineProviderReaderImplementation, getProviderReader, listProviderReaders, providerReaderSupports, } from "./reader.js";
 //# sourceMappingURL=index.js.map

package/dist/connections/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/connections/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,iCAAiC,EACjC,8BAA8B,EAC9B,+BAA+B,EAC/B,gCAAgC,EAChC,6CAA6C,EAC7C,2CAA2C,EAC3C,mCAAmC,GAOpC,MAAM,cAAc,CAAC","sourcesContent":["export {\n  WORKSPACE_CONNECTION_PROVIDERS,\n  defineWorkspaceConnectionProvider,\n  getWorkspaceConnectionProvider,\n  isWorkspaceConnectionProviderId,\n  listWorkspaceConnectionProviders,\n  listWorkspaceConnectionProvidersForCapability,\n  listWorkspaceConnectionProvidersForTemplate,\n  workspaceConnectionProviderSupports,\n  type ListWorkspaceConnectionProvidersOptions,\n  type WorkspaceConnectionCapability,\n  type WorkspaceConnectionCredentialKey,\n  type WorkspaceConnectionProvider,\n  type WorkspaceConnectionProviderId,\n  type WorkspaceConnectionTemplateUse,\n} from \"./catalog.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/connections/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,iCAAiC,EACjC,8BAA8B,EAC9B,+BAA+B,EAC/B,gCAAgC,EAChC,6CAA6C,EAC7C,2CAA2C,EAC3C,mCAAmC,GAOpC,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,2BAA2B,EAC3B,oBAAoB,EACpB,kCAAkC,EAClC,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,GAqBvB,MAAM,aAAa,CAAC","sourcesContent":["export {\n  WORKSPACE_CONNECTION_PROVIDERS,\n  defineWorkspaceConnectionProvider,\n  getWorkspaceConnectionProvider,\n  isWorkspaceConnectionProviderId,\n  listWorkspaceConnectionProviders,\n  listWorkspaceConnectionProvidersForCapability,\n  listWorkspaceConnectionProvidersForTemplate,\n  workspaceConnectionProviderSupports,\n  type ListWorkspaceConnectionProvidersOptions,\n  type WorkspaceConnectionCapability,\n  type WorkspaceConnectionCredentialKey,\n  type WorkspaceConnectionProvider,\n  type WorkspaceConnectionProviderId,\n  type WorkspaceConnectionTemplateUse,\n} from \"./catalog.js\";\n\nexport {\n  PROVIDER_READERS,\n  ProviderReaderRuntimeError,\n  createProviderReaderRuntime,\n  defineProviderReader,\n  defineProviderReaderImplementation,\n  getProviderReader,\n  listProviderReaders,\n  providerReaderSupports,\n  type ListProviderReadersOptions,\n  type ProviderReaderCredentialRequirement,\n  type ProviderReaderCapability,\n  type ProviderReaderDefinition,\n  type ProviderReaderImplementationStatus,\n  type ProviderReaderOperation,\n  type ProviderReaderOperationDescriptor,\n  type ProviderReaderOperationParameter,\n  type ProviderReaderRequest,\n  type ProviderReaderRuntime,\n  type ProviderReaderRuntimeConnection,\n  type ProviderReaderRuntimeConnectionResolverOptions,\n  type ProviderReaderRuntimeContext,\n  type ProviderReaderRuntimeCredentialsResolverOptions,\n  type ProviderReaderRuntimeErrorCode,\n  type ProviderReaderRuntimeHandler,\n  type ProviderReaderRuntimeImplementation,\n  type ProviderReaderRuntimeItem,\n  type ProviderReaderRuntimeOptions,\n  type ProviderReaderRuntimeResponse,\n} from \"./reader.js\";\n"]}

package/dist/connections/reader.d.ts

@@ -0,0 +1,248 @@
+import { type WorkspaceConnectionCapability, type WorkspaceConnectionCredentialKey, type WorkspaceConnectionProviderId } from "./catalog.js";
+import { type ResolveWorkspaceConnectionCredentialsForAppOptions, type WorkspaceConnectionCredentialsResolution, type WorkspaceConnectionPublicCredentialRef } from "../workspace-connections/index.js";
+import { type ResolvedWorkspaceConnectionForApp, type ResolveWorkspaceConnectionForAppOptions } from "../workspace-connections/store.js";
+export type ProviderReaderOperation = "search" | "get" | "listRecent";
+export type ProviderReaderImplementationStatus = "metadata-only" | "template-owned" | "shared";
+export interface ProviderReaderCapability {
+    capability: WorkspaceConnectionCapability;
+    label: string;
+    description: string;
+}
+export interface ProviderReaderOperationParameter {
+    name: string;
+    type: "string" | "number" | "boolean" | "string[]";
+    required?: boolean;
+    description: string;
+}
+export interface ProviderReaderOperationDescriptor {
+    operation: ProviderReaderOperation;
+    label: string;
+    description: string;
+    implementationStatus: ProviderReaderImplementationStatus;
+    parameters: readonly ProviderReaderOperationParameter[];
+}
+export interface ProviderReaderDefinition {
+    providerId: WorkspaceConnectionProviderId;
+    label: string;
+    description: string;
+    implementationStatus: ProviderReaderImplementationStatus;
+    credentialKeys: readonly WorkspaceConnectionCredentialKey[];
+    requiredCredentialKeys: readonly string[];
+    capabilities: readonly ProviderReaderCapability[];
+    operations: readonly ProviderReaderOperationDescriptor[];
+    notes?: string;
+}
+export interface ListProviderReadersOptions {
+    providerId?: WorkspaceConnectionProviderId;
+    capability?: WorkspaceConnectionCapability;
+    operation?: ProviderReaderOperation;
+    implementationStatus?: ProviderReaderImplementationStatus;
+}
+export type ProviderReaderRuntimeErrorCode = "unsupported_provider" | "unsupported_operation" | "connection_not_available" | "credentials_unavailable";
+export interface ProviderReaderRequest<TParams extends Record<string, unknown> = Record<string, unknown>> {
+    providerId: WorkspaceConnectionProviderId;
+    operation: ProviderReaderOperation;
+    params?: TParams;
+    connectionId?: string | null;
+    userEmail?: string | null;
+    orgId?: string | null;
+}
+export interface ProviderReaderRuntimeItem {
+    id: string;
+    type: string;
+    title?: string;
+    url?: string;
+    text?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ProviderReaderRuntimeResponse {
+    providerId: WorkspaceConnectionProviderId;
+    operation: ProviderReaderOperation;
+    connectionId: string;
+    items?: ProviderReaderRuntimeItem[];
+    item?: ProviderReaderRuntimeItem | null;
+    metadata?: Record<string, unknown>;
+}
+export interface ProviderReaderRuntimeConnection {
+    id: string;
+    provider: string;
+    label: string;
+    accountId: string | null;
+    accountLabel: string | null;
+    credentialRefs: WorkspaceConnectionPublicCredentialRef[];
+}
+export interface ProviderReaderCredentialRequirement {
+    values: Record<string, string>;
+    resolution: WorkspaceConnectionCredentialsResolution;
+}
+export interface ProviderReaderRuntimeContext {
+    appId: string;
+    providerId: WorkspaceConnectionProviderId;
+    reader: ProviderReaderDefinition;
+    connection: ProviderReaderRuntimeConnection;
+    resolveCredentials(keys?: readonly string[]): Promise<WorkspaceConnectionCredentialsResolution>;
+    requireCredentials(keys?: readonly string[]): Promise<ProviderReaderCredentialRequirement>;
+}
+export type ProviderReaderRuntimeHandler<TParams extends Record<string, unknown> = Record<string, unknown>> = (params: TParams, context: ProviderReaderRuntimeContext) => ProviderReaderRuntimeResponse | Promise<ProviderReaderRuntimeResponse>;
+export interface ProviderReaderRuntimeImplementation<TProviderId extends WorkspaceConnectionProviderId = WorkspaceConnectionProviderId> {
+    providerId: TProviderId;
+    operations: Partial<Record<ProviderReaderOperation, ProviderReaderRuntimeHandler>>;
+}
+export interface ProviderReaderRuntimeConnectionResolverOptions extends Pick<ResolveWorkspaceConnectionForAppOptions, "appId" | "connectionId"> {
+    providerId: WorkspaceConnectionProviderId;
+}
+export interface ProviderReaderRuntimeCredentialsResolverOptions extends Pick<ResolveWorkspaceConnectionCredentialsForAppOptions, "appId" | "connectionId" | "keys" | "userEmail" | "orgId"> {
+    providerId: WorkspaceConnectionProviderId;
+}
+export interface ProviderReaderRuntimeOptions {
+    appId: string;
+    readers: readonly ProviderReaderRuntimeImplementation[];
+    resolveConnection?: (options: ProviderReaderRuntimeConnectionResolverOptions) => Promise<ResolvedWorkspaceConnectionForApp>;
+    resolveCredentials?: (options: ProviderReaderRuntimeCredentialsResolverOptions) => Promise<WorkspaceConnectionCredentialsResolution>;
+}
+export interface ProviderReaderRuntime {
+    read<TParams extends Record<string, unknown> = Record<string, unknown>>(request: ProviderReaderRequest<TParams>): Promise<ProviderReaderRuntimeResponse>;
+}
+export declare class ProviderReaderRuntimeError extends Error {
+    readonly code: ProviderReaderRuntimeErrorCode;
+    readonly providerId: string;
+    readonly operation?: ProviderReaderOperation;
+    constructor(code: ProviderReaderRuntimeErrorCode, message: string, options: {
+        providerId: string;
+        operation?: ProviderReaderOperation;
+    });
+}
+export declare function defineProviderReader<const T extends ProviderReaderDefinition>(reader: T): T;
+export declare function defineProviderReaderImplementation<const T extends ProviderReaderRuntimeImplementation>(implementation: T): T;
+export declare const PROVIDER_READERS: readonly [{
+    readonly providerId: "slack";
+    readonly label: "Slack reader";
+    readonly description: "Normalized metadata for reading Slack messages and channel history through template-owned Slack implementations.";
+    readonly implementationStatus: "template-owned";
+    readonly credentialKeys: readonly WorkspaceConnectionCredentialKey[];
+    readonly requiredCredentialKeys: readonly string[];
+    readonly capabilities: readonly [{
+        readonly capability: "search";
+        readonly label: "Message search";
+        readonly description: "Search conversation history using Slack's message search semantics.";
+    }, {
+        readonly capability: "messages";
+        readonly label: "Message retrieval";
+        readonly description: "Read individual messages or recent channel activity when a template owns the Slack client.";
+    }];
+    readonly operations: readonly [ProviderReaderOperationDescriptor, ProviderReaderOperationDescriptor, ProviderReaderOperationDescriptor];
+    readonly notes: "Core only exposes the contract; templates still own Slack API calls and provider-specific pagination.";
+}, {
+    readonly providerId: "github";
+    readonly label: "GitHub reader";
+    readonly description: "Normalized metadata for reading repositories, issues, pull requests, and code search results.";
+    readonly implementationStatus: "template-owned";
+    readonly credentialKeys: readonly WorkspaceConnectionCredentialKey[];
+    readonly requiredCredentialKeys: readonly string[];
+    readonly capabilities: readonly [{
+        readonly capability: "search";
+        readonly label: "Repository search";
+        readonly description: "Search GitHub issues, pull requests, repositories, code, or docs using template-owned clients.";
+    }, {
+        readonly capability: "code";
+        readonly label: "Code context";
+        readonly description: "Read code-oriented objects such as repositories, files, issues, and pull requests.";
+    }];
+    readonly operations: readonly [ProviderReaderOperationDescriptor, ProviderReaderOperationDescriptor, ProviderReaderOperationDescriptor];
+    readonly notes: "No shared Octokit client is exported from core in this spike; templates remain responsible for API calls.";
+}, {
+    readonly providerId: "notion";
+    readonly label: "Notion reader";
+    readonly description: "Normalized metadata for reading Notion pages, databases, and workspace docs.";
+    readonly implementationStatus: "template-owned";
+    readonly credentialKeys: readonly WorkspaceConnectionCredentialKey[];
+    readonly requiredCredentialKeys: readonly string[];
+    readonly capabilities: readonly [{
+        readonly capability: "search";
+        readonly label: "Page search";
+        readonly description: "Search pages and databases shared with the Notion integration.";
+    }, {
+        readonly capability: "docs";
+        readonly label: "Document retrieval";
+        readonly description: "Read Notion page or database metadata through template-owned clients.";
+    }];
+    readonly operations: readonly [ProviderReaderOperationDescriptor, ProviderReaderOperationDescriptor, ProviderReaderOperationDescriptor];
+    readonly notes: "Core does not traverse Notion blocks yet; templates own page hydration and rate-limit behavior.";
+}, {
+    readonly providerId: "hubspot";
+    readonly label: "HubSpot reader";
+    readonly description: "Normalized metadata for CRM object lookup through template-owned HubSpot 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 CRM contacts, companies, deals, tickets, and engagements.";
+    }, {
+        readonly capability: "crm";
+        readonly label: "CRM retrieval";
+        readonly description: "Read CRM objects when a template owns HubSpot object mapping.";
+    }];
+    readonly operations: readonly [ProviderReaderOperationDescriptor, ProviderReaderOperationDescriptor, ProviderReaderOperationDescriptor];
+    readonly notes: "Templates define object allow-lists and property projections; core only documents the reader shape.";
+}, {
+    readonly providerId: "gmail";
+    readonly label: "Gmail reader";
+    readonly description: "Normalized metadata for mailbox search and thread/message reads through app-owned Google OAuth flows.";
+    readonly implementationStatus: "template-owned";
+    readonly credentialKeys: readonly WorkspaceConnectionCredentialKey[];
+    readonly requiredCredentialKeys: readonly string[];
+    readonly capabilities: readonly [{
+        readonly capability: "search";
+        readonly label: "Mailbox search";
+        readonly description: "Search Gmail messages and threads.";
+    }, {
+        readonly capability: "messages";
+        readonly label: "Mail retrieval";
+        readonly description: "Read Gmail messages and threads when a template owns OAuth token handling.";
+    }];
+    readonly operations: readonly [ProviderReaderOperationDescriptor, ProviderReaderOperationDescriptor, ProviderReaderOperationDescriptor];
+    readonly notes: "This is metadata for templates with Google OAuth; core does not expose a shared Gmail network client here.";
+}, {
+    readonly providerId: "google_drive";
+    readonly label: "Google Drive reader";
+    readonly description: "Normalized metadata for Drive file search and document lookup through app-owned Google OAuth flows.";
+    readonly implementationStatus: "template-owned";
+    readonly credentialKeys: readonly WorkspaceConnectionCredentialKey[];
+    readonly requiredCredentialKeys: readonly string[];
+    readonly capabilities: readonly [{
+        readonly capability: "search";
+        readonly label: "Drive search";
+        readonly description: "Search files visible to the connected Google account.";
+    }, {
+        readonly capability: "docs";
+        readonly label: "Drive document retrieval";
+        readonly description: "Read file metadata or exported document content through template-owned Google clients.";
+    }];
+    readonly operations: readonly [ProviderReaderOperationDescriptor, ProviderReaderOperationDescriptor, ProviderReaderOperationDescriptor];
+    readonly notes: "Templates still own file export formats, Docs/Sheets/Slides handling, and OAuth token refresh.";
+}, {
+    readonly providerId: "generic";
+    readonly label: "Generic metadata reader";
+    readonly description: "Placeholder reader metadata for custom sources that expose searchable documents through a template-specific adapter.";
+    readonly implementationStatus: "metadata-only";
+    readonly credentialKeys: readonly WorkspaceConnectionCredentialKey[];
+    readonly requiredCredentialKeys: readonly string[];
+    readonly capabilities: readonly [{
+        readonly capability: "search";
+        readonly label: "Custom search";
+        readonly description: "Describe a template-specific search interface for one-off sources.";
+    }, {
+        readonly capability: "docs";
+        readonly label: "Custom document retrieval";
+        readonly description: "Describe a template-specific document retrieval interface.";
+    }];
+    readonly operations: readonly [ProviderReaderOperationDescriptor, ProviderReaderOperationDescriptor];
+    readonly notes: "Use this only to document a template-owned adapter; core cannot execute generic provider reads.";
+}];
+export declare function listProviderReaders(options?: ListProviderReadersOptions): ProviderReaderDefinition[];
+export declare function getProviderReader(providerId: string): ProviderReaderDefinition | undefined;
+export declare function providerReaderSupports(providerOrReader: ProviderReaderDefinition | WorkspaceConnectionProviderId, operationName: ProviderReaderOperation): boolean;
+export declare function createProviderReaderRuntime(options: ProviderReaderRuntimeOptions): ProviderReaderRuntime;
+//# sourceMappingURL=reader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../src/connections/reader.ts"],"names":[],"mappings":"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"}