memorysync-sdk 1.3.0 → 1.5.0

package/dist/index.d.mts

@@ -64,8 +64,20 @@ declare class SlackNamespace extends Namespace {
     availableChannels(connectionId: string, query?: Json): Promise<Json>;
     /** Channels currently selected for syncing. */
     channels(connectionId: string): Promise<Json>;
-    /** Select channels for syncing. */
-    addChannels(connectionId: string, channelIds: string[]): Promise<Json>;
+    /**
+     * Select channels for syncing.
+     *
+     * Accepts bare channel ids, which is the common case, or objects carrying the
+     * name and type across so the server does not have to look them up again:
+     *
+     * ```ts
+     * await client.connections.slack.addChannels("c1", ["C0123", "C0456"]);
+     * await client.connections.slack.addChannels("c1", [
+     *   { id: "C0123", name: "support", is_private: false },
+     * ]);
+     * ```
+     */
+    addChannels(connectionId: string, channels: Array<string | Json>): Promise<Json>;
     /** Stop syncing one channel. */
     removeChannel(connectionId: string, channelId: string): Promise<Json>;
     /**
@@ -100,15 +112,38 @@ declare class S3Namespace extends Namespace {
     availablePrefixes(connectionId: string, query?: Json): Promise<Json>;
     /** Prefixes currently selected for syncing. */
     prefixes(connectionId: string): Promise<Json>;
-    /** Select prefixes for syncing. */
-    addPrefixes(connectionId: string, prefixes: string[]): Promise<Json>;
     /**
-     * Stop syncing the given prefixes.
+     * Select prefixes for syncing.
+     *
+     * Accepts bare prefixes, or objects carrying `bucket` and `label`:
      *
-     * The prefixes travel in the body rather than the path because they contain
-     * slashes, which is why this DELETE carries one.
+     * ```ts
+     * await client.connections.s3.addPrefixes("c1", ["handbook/", "policies/"]);
+     * await client.connections.s3.addPrefixes("c1", [
+     *   { prefix: "handbook/", label: "Handbook" },
+     * ]);
+     * ```
+     *
+     * An empty string means the bucket root. The bucket defaults to the one the
+     * connection's credentials were validated against, and the API rejects any
+     * other bucket rather than indexing one nobody proved access to.
      */
-    removePrefixes(connectionId: string, prefixes: string[]): Promise<Json>;
+    addPrefixes(connectionId: string, prefixes: Array<string | Json>): Promise<Json>;
+    /**
+     * Revoke one prefix approval, optionally purging what it produced.
+     *
+     * The prefix travels as a query parameter, not in the body and not as a path
+     * segment: prefixes contain slashes, which a path segment cannot carry
+     * unambiguously, and this endpoint reads no body at all.
+     *
+     * Pass `purge: true` to also delete the memories already derived from the
+     * prefix. The default leaves them in place, so revoking an approval does not
+     * silently destroy knowledge.
+     */
+    removePrefix(connectionId: string, prefix?: string, options?: {
+        bucket?: string;
+        purge?: boolean;
+    }): Promise<Json>;
     /** Keys and patterns this connection will never sync. */
     exclusionPolicy(connectionId: string): Promise<Json>;
     /** Replace this connection's additions to the exclusion policy. */
@@ -134,8 +169,14 @@ declare class GranolaNamespace extends Namespace {
     identities(connectionId: string): Promise<Json>;
     /** Map a participant to a MemorySync end user. */
     linkIdentity(connectionId: string, body: Json): Promise<Json>;
-    /** Move an existing mapping to a different end user. */
-    relinkIdentity(connectionId: string, body: Json): Promise<Json>;
+    /**
+     * Re-run identity matching for this connection.
+     *
+     * Takes no arguments: the route reads no body and re-matches the whole roster.
+     * `body` is kept optional only so a forward-compatible field can be passed
+     * once the route grows one.
+     */
+    relinkIdentity(connectionId: string, body?: Json): Promise<Json>;
     /** Effective Granola settings for this connection. */
     settings(connectionId: string): Promise<Json>;
     /** Update Granola settings for this connection. */
@@ -171,6 +212,12 @@ declare class ConnectionsNamespace extends Namespace {
     /** One connection, including its status and last sync. */
     get(connectionId: string): Promise<Json>;
     /** Connect a provider that authenticates with an API key or bot token. */
+    /**
+     * Connect a provider that authenticates with an API key or bot token.
+     *
+     * The wire field is `provider_id`; the argument is named `provider` because
+     * that is what the rest of this namespace calls it.
+     */
     createWithApiKey(provider: string, apiKey: string, body?: Json): Promise<Json>;
     /** Connect a provider that needs a credential bundle, such as S3 keys. */
     createWithCredentials(provider: string, credentials: Json, body?: Json): Promise<Json>;
@@ -399,20 +446,6 @@ interface CurrentPlanResponse {
     scheduledPlanId: string | null;
     cancelAtPeriodEnd: boolean;
 }
-interface TeamMember {
-    id: string;
-    name: string;
-    email: string;
-    role: string;
-    status: string;
-    lastActive?: string | null;
-    mfaEnabled: boolean;
-    authMethod: string;
-    loginProvider?: string;
-    devices?: number;
-    sessions: number;
-    isScimManaged?: boolean;
-}
 interface Session {
     id: number;
     isCurrent: boolean;
@@ -430,58 +463,6 @@ interface SessionListResponse {
     sessions: Session[];
     currentSessionId: number | null;
 }
-type AuditSortDirection = "asc" | "desc";
-interface AuditEventQuery {
-    limit?: number;
-    cursor?: number;
-    skip?: number;
-    sortDirection?: AuditSortDirection;
-    tenantId?: string;
-    actor?: string;
-    actorEmail?: string;
-    ip?: string;
-    action?: string;
-    resourceType?: string;
-    resourceId?: string;
-    severity?: string;
-    category?: string;
-    start?: string;
-    end?: string;
-    success?: boolean;
-    source?: string;
-    ingestMethod?: string;
-    search?: string;
-    includeStats?: boolean;
-}
-interface AuditActor {
-    id: string;
-    email: string | null;
-    name: string | null;
-    type: string;
-}
-interface AuditResource {
-    type: string;
-    id: string;
-    label: string | null;
-}
-interface AuditEvent {
-    id: number;
-    eventId: string;
-    timestamp: string;
-    category: string;
-    actor: AuditActor;
-    action: string;
-    resource: AuditResource;
-    severity: string;
-    success: boolean;
-    metadata?: Record<string, unknown> | null;
-}
-interface AuditEventListResponse {
-    events: AuditEvent[];
-    nextCursor: number | null;
-    stats?: Record<string, unknown> | null;
-    sort: AuditSortDirection;
-}
 interface IntegrationQuery {
     category?: string;
 }
@@ -505,28 +486,6 @@ interface OrganizationMembership {
     organizationId: number;
     role: string;
 }
-interface OrganizationSettingsQuery {
-    tenantId?: string;
-}
-interface OrganizationSettings {
-    tenantId: string;
-    tenantName: string;
-    tenantSlug: string;
-    description: string | null;
-    plan: string;
-    status: string;
-    createdAt: string;
-    contactEmail: string | null;
-    customDomain: string | null;
-    customDomainVerified: boolean;
-    logoUrl: string | null;
-    totalMemories: number;
-    activeUsers: number;
-    organizationName: string;
-    scheduledDeletionAt: string | null;
-    mfaEnrolled: boolean;
-    passwordEnabled: boolean;
-}
 interface Project {
     id: string;
     name: string;
@@ -537,6 +496,12 @@ interface Project {
     createdAt: string;
     updatedAt: string;
 }
+interface CreateProjectRequest {
+    name: string;
+}
+interface RenameProjectRequest {
+    name: string;
+}
 interface WebhookRetryConfig {
     enabled?: boolean;
     maxRetries?: number;
@@ -666,6 +631,81 @@ interface WebhookDeliveryListResponse {
     page: number;
     pageSize: number;
 }
+interface WebhookEventTypesResponse {
+    eventTypes: string[];
+    categories: Record<string, string[]>;
+}
+interface WebhookHealth {
+    activeWebhooks: number;
+    totalWebhooks: number;
+    totalDeliveriesAllTime: number;
+    totalDeliveries24h: number;
+    successRate7d: number;
+    failingEndpoints: number;
+    pendingRetries: number;
+    deadLetterCount: number;
+}
+interface RecentWebhookDeliveryQuery extends WebhookDeliveryQuery {
+    endpointId?: number;
+}
+type ExportFormat = "csv" | "jsonl";
+type ExportScope = "filtered" | "all" | "date_range";
+type ExportJobStatus = "queued" | "processing" | "generating" | "completed" | "failed" | "cancelled" | "expired";
+interface ExportFilters {
+    q?: string | null;
+    userId?: string | null;
+    isSummary?: boolean | null;
+    tier?: string | null;
+    source?: string | null;
+    timeRange?: string | null;
+    dateFrom?: string | null;
+    dateTo?: string | null;
+    includeSoftDeleted?: boolean;
+}
+interface CreateExportRequest {
+    format?: ExportFormat;
+    scope?: ExportScope;
+    filters?: ExportFilters | null;
+}
+interface ExportJob {
+    id: string;
+    projectId: string | null;
+    environment: string;
+    format: ExportFormat;
+    scope: ExportScope;
+    filters: ExportFilters;
+    status: ExportJobStatus;
+    errorMessage: string | null;
+    retryCount: number;
+    totalRows: number | null;
+    processedRows: number;
+    progressPercentage: number;
+    fileSizeBytes: number | null;
+    sha256Hash: string | null;
+    downloadCount: number;
+    createdAt: string | null;
+    startedAt: string | null;
+    completedAt: string | null;
+    expiresAt: string | null;
+    downloadUrl: string | null;
+}
+interface CreateExportResponse {
+    job: ExportJob;
+    estimatedTotal: number | null;
+}
+interface ExportListQuery {
+    limit?: number;
+}
+interface ExportJobListResponse {
+    jobs: ExportJob[];
+    total: number;
+}
+interface ExportDownloadUrl {
+    downloadUrl: string;
+    expiresAt: string | null;
+    fileSizeBytes: number | null;
+    filename: string;
+}
 declare class ControlPlaneClient {
     private readonly baseUrl;
     private readonly accessToken?;
@@ -679,25 +719,40 @@ declare class ControlPlaneClient {
     testApiKey(keyId: number, options?: ControlPlaneRequestOptions): Promise<ApiKeyTestResponse>;
     login(request: LoginRequest, options?: ControlPlaneRequestOptions): Promise<LoginResponse>;
     getCurrentPlan(options?: ControlPlaneRequestOptions): Promise<CurrentPlanResponse>;
-    listTeamMembers(options?: ControlPlaneRequestOptions): Promise<TeamMember[]>;
-    suspendTeamMember(memberId: number, options?: ControlPlaneRequestOptions): Promise<TeamMember>;
-    removeTeamMember(memberId: number, options?: ControlPlaneRequestOptions): Promise<void>;
     listSessions(options?: ControlPlaneRequestOptions): Promise<SessionListResponse>;
     revokeSession(sessionId: number, options?: ControlPlaneRequestOptions): Promise<void>;
-    listAuditEvents(query?: AuditEventQuery, options?: ControlPlaneRequestOptions): Promise<AuditEventListResponse>;
     listIntegrations(query?: IntegrationQuery, options?: ControlPlaneRequestOptions): Promise<Integration[]>;
     createOrganization(request: CreateOrganizationRequest, options?: ControlPlaneRequestOptions): Promise<OrganizationMembership>;
     listOrganizations(options?: ControlPlaneRequestOptions): Promise<OrganizationMembership[]>;
-    listOrganizationMembers(options?: ControlPlaneRequestOptions): Promise<TeamMember[]>;
-    getOrganizationSettings(query?: OrganizationSettingsQuery, options?: ControlPlaneRequestOptions): Promise<OrganizationSettings>;
     listProjects(options?: ControlPlaneRequestOptions): Promise<Project[]>;
+    createProject(request: CreateProjectRequest, options?: ControlPlaneRequestOptions): Promise<Project>;
+    renameProject(projectId: string, request: RenameProjectRequest, options?: ControlPlaneRequestOptions): Promise<Project>;
+    archiveProject(projectId: string, options?: ControlPlaneRequestOptions): Promise<Project>;
+    unarchiveProject(projectId: string, options?: ControlPlaneRequestOptions): Promise<Project>;
+    deleteProject(projectId: string, options?: ControlPlaneRequestOptions): Promise<void>;
     createWebhook(request: CreateWebhookRequest, options?: ControlPlaneRequestOptions): Promise<CreatedWebhook>;
     listWebhooks(options?: ControlPlaneRequestOptions): Promise<WebhookListResponse>;
+    getWebhook(endpointId: number, options?: ControlPlaneRequestOptions): Promise<Webhook>;
+    getWebhookEventTypes(options?: ControlPlaneRequestOptions): Promise<WebhookEventTypesResponse>;
+    getWebhookHealth(options?: ControlPlaneRequestOptions): Promise<WebhookHealth>;
+    pauseWebhook(endpointId: number, options?: ControlPlaneRequestOptions): Promise<Webhook>;
+    resumeWebhook(endpointId: number, options?: ControlPlaneRequestOptions): Promise<Webhook>;
+    rotateWebhookSecret(endpointId: number, options?: ControlPlaneRequestOptions): Promise<CreatedWebhook>;
     updateWebhook(endpointId: number, request: UpdateWebhookRequest, options?: ControlPlaneRequestOptions): Promise<Webhook>;
     deleteWebhook(endpointId: number, options?: ControlPlaneRequestOptions): Promise<void>;
     testWebhook(endpointId: number, request?: TestWebhookRequest, options?: ControlPlaneRequestOptions): Promise<TestWebhookResponse>;
     replayWebhookDeliveries(endpointId: number, request?: ReplayWebhookDeliveriesRequest, options?: ControlPlaneRequestOptions): Promise<ReplayWebhookDeliveriesResponse>;
     listWebhookDeliveries(endpointId: number, query?: WebhookDeliveryQuery, options?: ControlPlaneRequestOptions): Promise<WebhookDeliveryListResponse>;
+    getLatestWebhookDelivery(endpointId: number, options?: ControlPlaneRequestOptions): Promise<WebhookDelivery | null>;
+    listRecentWebhookDeliveries(query?: RecentWebhookDeliveryQuery, options?: ControlPlaneRequestOptions): Promise<WebhookDeliveryListResponse>;
+    getWebhookDelivery(deliveryId: number, options?: ControlPlaneRequestOptions): Promise<WebhookDelivery>;
+    retryWebhookDelivery(deliveryId: number, options?: ControlPlaneRequestOptions): Promise<WebhookDelivery>;
+    createExport(request: CreateExportRequest, options?: ControlPlaneRequestOptions): Promise<CreateExportResponse>;
+    listExports(query?: ExportListQuery, options?: ControlPlaneRequestOptions): Promise<ExportJobListResponse>;
+    getExport(jobId: string, options?: ControlPlaneRequestOptions): Promise<ExportJob>;
+    cancelExport(jobId: string, options?: ControlPlaneRequestOptions): Promise<ExportJob>;
+    retryExport(jobId: string, options?: ControlPlaneRequestOptions): Promise<CreateExportResponse>;
+    getExportDownloadUrl(jobId: string, options?: ControlPlaneRequestOptions): Promise<ExportDownloadUrl>;
 }
 
 /**
@@ -1173,4 +1228,4 @@ declare class MemorySyncClient {
     }): Promise<Record<string, unknown>>;
 }
 
-export { type AddRequest, type AddResponse, type AddSkippedResponse, type ApiKeyTestResponse, type ApiKeyTestStatus, type AuditActor, type AuditEvent, type AuditEventListResponse, type AuditEventQuery, type AuditResource, type AuditSortDirection, AuthError, type BatchUpdateItem, type BatchUpdateItemResult, type BatchUpdateResponse, type BulkAddItem, type BulkAddItemResult, type BulkAddResponse, type BulkRevokeApiKeyResult, type BulkRevokeApiKeysRequest, type BulkRevokeApiKeysResponse, type ComposeRequest, type ComposeResponse, ConnectionOAuthNamespace, ConnectionsNamespace, ControlPlaneClient, type ControlPlaneConfig, type ControlPlaneRequestOptions, type CreateOrganizationRequest, type CreateWebhookRequest, type CreatedWebhook, type CurrentPlanResponse, type ExportResponse, type FeedbackResponse, type FeedbackSignal, type FeedbackSummary, type FeedbackTrend, type ForgetFilters, type ForgetRequest, GoogleDriveNamespace, GranolaNamespace, type HistoryResponse, type Integration, type IntegrationQuery, IntegrationsNamespace, type LoginRequest, type LoginResponse, type MemoryRecord, MemorySyncClient, type MemorySyncConfig, MemorySyncError, NotFoundError, ObjectsNamespace, type Ontology, type OntologyUpdateRequest, type OrganizationMembership, type OrganizationSettings, type OrganizationSettingsQuery, type Plan, type PlanLimits, type Project, ProvidersNamespace, type QueryFilters, type QueryRequest, type QueryResponse, RateLimitError, type RelationCreateRequest, type RelationRecord, type RelationshipType, type ReplayWebhookDeliveriesRequest, type ReplayWebhookDeliveriesResponse, type RevisionEntry, type RevisionEvent, S3Namespace, ServerError, type Session, type SessionListResponse, SlackNamespace, type SummarizeRequest, SyncJobsNamespace, type TeamMember, type TestWebhookRequest, type TestWebhookResponse, type UpdateRequest, type UpdateWebhookRequest, type UploadRequest, ValidationError, WebCrawlerNamespace, type Webhook, type WebhookDelivery, type WebhookDeliveryListResponse, type WebhookDeliveryQuery, type WebhookListResponse, type WebhookRetryConfig, type WebhookSignatureConfig };
+export { type AddRequest, type AddResponse, type AddSkippedResponse, type ApiKeyTestResponse, type ApiKeyTestStatus, AuthError, type BatchUpdateItem, type BatchUpdateItemResult, type BatchUpdateResponse, type BulkAddItem, type BulkAddItemResult, type BulkAddResponse, type BulkRevokeApiKeyResult, type BulkRevokeApiKeysRequest, type BulkRevokeApiKeysResponse, type ComposeRequest, type ComposeResponse, ConnectionOAuthNamespace, ConnectionsNamespace, ControlPlaneClient, type ControlPlaneConfig, type ControlPlaneRequestOptions, type CreateExportRequest, type CreateExportResponse, type CreateOrganizationRequest, type CreateProjectRequest, type CreateWebhookRequest, type CreatedWebhook, type CurrentPlanResponse, type ExportDownloadUrl, type ExportFilters, type ExportFormat, type ExportJob, type ExportJobListResponse, type ExportJobStatus, type ExportListQuery, type ExportResponse, type ExportScope, type FeedbackResponse, type FeedbackSignal, type FeedbackSummary, type FeedbackTrend, type ForgetFilters, type ForgetRequest, GoogleDriveNamespace, GranolaNamespace, type HistoryResponse, type Integration, type IntegrationQuery, IntegrationsNamespace, type LoginRequest, type LoginResponse, type MemoryRecord, MemorySyncClient, type MemorySyncConfig, MemorySyncError, NotFoundError, ObjectsNamespace, type Ontology, type OntologyUpdateRequest, type OrganizationMembership, type Plan, type PlanLimits, type Project, ProvidersNamespace, type QueryFilters, type QueryRequest, type QueryResponse, RateLimitError, type RecentWebhookDeliveryQuery, type RelationCreateRequest, type RelationRecord, type RelationshipType, type RenameProjectRequest, type ReplayWebhookDeliveriesRequest, type ReplayWebhookDeliveriesResponse, type RevisionEntry, type RevisionEvent, S3Namespace, ServerError, type Session, type SessionListResponse, SlackNamespace, type SummarizeRequest, SyncJobsNamespace, type TestWebhookRequest, type TestWebhookResponse, type UpdateRequest, type UpdateWebhookRequest, type UploadRequest, ValidationError, WebCrawlerNamespace, type Webhook, type WebhookDelivery, type WebhookDeliveryListResponse, type WebhookDeliveryQuery, type WebhookEventTypesResponse, type WebhookHealth, type WebhookListResponse, type WebhookRetryConfig, type WebhookSignatureConfig };