Class Seclai

Seclai JavaScript/TypeScript client.

Provides typed methods for every Seclai API endpoint, plus higher-level abstractions for streaming, polling, and pagination.

Example

import { Seclai } from "@seclai/sdk";

const client = new Seclai({ apiKey: "sk-..." });

// List agents
const { items } = await client.listAgents();

// Run an agent
const run = await client.runAgent("agent-id", { input: "Hello!" });

// Stream an agent run
for await (const event of client.runStreamingAgent("agent-id", { input: "Hello!" })) {
  console.log(event.event, event.data);
}

Index

Constructors

constructor

Methods

acceptAiAssistantPlan acceptAiMemoryBankSuggestion acceptGovernanceAiPlan acceptMemoryBankAiSuggestion acceptSolutionAiPlan addAlertComment addSolutionConversationTurn aiAssistantKnowledgeBase aiAssistantMemoryBank aiAssistantSolution aiAssistantSource cancelAgentRun cancelSourceEmbeddingMigration cancelSourceExport changeAlertStatus compactMemoryBank createAgent createAlertConfig createEvaluationCriteria createEvaluationResult createKnowledgeBase createMemoryBank createSolution createSource createSourceExport declineAiAssistantPlan declineGovernanceAiPlan declineSolutionAiPlan deleteAgent deleteAgentRun deleteAlertConfig deleteContent deleteEvaluationCriteria deleteKnowledgeBase deleteMemoryBank deleteMemoryBankSource deleteSolution deleteSource deleteSourceExport downloadSourceExport estimateSourceExport generateAgentSteps generateGovernanceAiPlan generateMemoryBankConfig generateSolutionAiKnowledgeBase generateSolutionAiPlan generateSolutionAiSource generateStepConfig getAgent getAgentAiConversationHistory getAgentDefinition getAgentInputUploadStatus getAgentRun getAgentsUsingMemoryBank getAiAssistantMemoryBankHistory getAlert getAlertConfig getContentDetail getEvaluationCriteria getEvaluationCriteriaSummary getKnowledgeBase getMemoryBank getMemoryBankAiLastConversation getMemoryBankStats getModelRecommendations getNonManualEvaluationSummary getSolution getSource getSourceEmbeddingMigration getSourceExport getUnreadModelAlertCount linkAgentsToSolution linkKnowledgeBasesToSolution linkSourceConnectionsToSolution listAgentEvaluationResults listAgentRuns listAgents listAlertConfigs listAlerts listCompatibleRuns listContentEmbeddings listEvaluationCriteria listEvaluationResults listEvaluationRuns listGovernanceAiConversations listKnowledgeBases listMemoryBanks listMemoryBankTemplates listModelAlerts listOrganizationAlertPreferences listRunEvaluationResults listSolutionConversations listSolutions listSourceExports listSources markAgentAiSuggestion markAllModelAlertsRead markModelAlertRead markSolutionConversationTurn paginate replaceContentWithInlineText request requestRaw runAgent runAgentAndPoll runStreamingAgent runStreamingAgentAndWait search searchAgentRuns startSourceEmbeddingMigration submitAiFeedback subscribeToAlert testCompactionPromptStandalone testDraftEvaluation testMemoryBankCompaction unlinkAgentsFromSolution unlinkKnowledgeBasesFromSolution unlinkSourceConnectionsFromSolution unsubscribeFromAlert updateAgent updateAgentDefinition updateAlertConfig updateEvaluationCriteria updateKnowledgeBase updateMemoryBank updateOrganizationAlertPreference updateSolution updateSource uploadAgentInput uploadFileToContent uploadFileToSource uploadInlineTextToSource

Constructors

constructor

new Seclai(opts?: SeclaiOptions): Seclai
Create a new Seclai client.

Credentials are resolved via a chain (first match wins):
1. Explicit apiKey option
2. Explicit accessToken option (static string or provider function)
3. SECLAI_API_KEY environment variable
4. SSO profile from ~/.seclai/config + cached tokens in ~/.seclai/sso/cache/
Parameters
- opts: SeclaiOptions = {}
  Client configuration.
Returns Seclai
Throws
SeclaiConfigurationError If no fetch implementation is available.

Throws
SeclaiConfigurationError If both apiKey and accessToken are provided.
- Defined in client.ts:350

Methods

acceptAiAssistantPlan

acceptAiAssistantPlan(conversationId: string, body: {}): Promise<{}>
Accept an AI assistant suggestion.
Parameters
- conversationId: string
  Conversation identifier.
- body: {}
  Acceptance request payload.
Returns Promise<{}>
- Defined in client.ts:2377

acceptAiMemoryBankSuggestion

acceptAiMemoryBankSuggestion(conversationId: string, body: {}): Promise<unknown>
Accept/mark an AI memory bank suggestion.
Parameters
- conversationId: string
  Conversation identifier.
- body: {}
  Acceptance payload for the memory bank suggestion.
Returns Promise<unknown>
- Defined in client.ts:2396

acceptGovernanceAiPlan

acceptGovernanceAiPlan(conversationId: string): Promise<{}>
Accept a governance AI plan.
Parameters
- conversationId: string
  Conversation identifier.
Returns Promise<{}>
Acceptance result.
- Defined in client.ts:2090

acceptMemoryBankAiSuggestion

acceptMemoryBankAiSuggestion(conversationId: string, body: {}): Promise<unknown>
Accept a memory bank AI suggestion.
Parameters
- conversationId: string
  Conversation identifier.
- body: {}
  Accept request payload.
Returns Promise<unknown>
- Defined in client.ts:1557

acceptSolutionAiPlan

acceptSolutionAiPlan(
    solutionId: string,
    conversationId: string,
    body: {},
): Promise<{}>
Accept a solution AI plan.
Parameters
- solutionId: string
  Solution identifier.
- conversationId: string
  Conversation identifier.
- body: {}
  Accept request.
Returns Promise<{}>
Acceptance result with executed actions.
- Defined in client.ts:2049

addAlertComment

addAlertComment(alertId: string, body: {}): Promise<unknown>
Add a comment to an alert.
Parameters
- alertId: string
  Alert identifier.
- body: {}
  Comment payload.
Returns Promise<unknown>
- Defined in client.ts:2145

addSolutionConversationTurn

addSolutionConversationTurn(solutionId: string, body: {}): Promise<{}>
Add a conversation turn to a solution.
Parameters
- solutionId: string
  Solution identifier.
- body: {}
  Conversation turn payload.
Returns Promise<{}>
Updated conversation.
- Defined in client.ts:1991

aiAssistantKnowledgeBase

aiAssistantKnowledgeBase(body: {}): Promise<{}>
Generate a knowledge base configuration via AI assistant.
Parameters
- body: {}
  Generation request.
Returns Promise<{}>
- Defined in client.ts:2333

aiAssistantMemoryBank

aiAssistantMemoryBank(body: {}): Promise<{}>
Generate a memory bank configuration via AI assistant.
Parameters
- body: {}
  Generation request.
Returns Promise<{}>
- Defined in client.ts:2360

aiAssistantSolution

aiAssistantSolution(body: {}): Promise<{}>
Generate a solution via AI assistant.
Parameters
- body: {}
  Generation request.
Returns Promise<{}>
- Defined in client.ts:2351

aiAssistantSource

aiAssistantSource(body: {}): Promise<{}>
Generate a source configuration via AI assistant.
Parameters
- body: {}
  Generation request.
Returns Promise<{}>
- Defined in client.ts:2342

cancelAgentRun

cancelAgentRun(runId: string): Promise<{}>
Cancel a running agent run.
Parameters
- runId: string
  Run identifier.
Returns Promise<{}>
Updated run (with cancelled status).
- Defined in client.ts:782

cancelSourceEmbeddingMigration

cancelSourceEmbeddingMigration(sourceId: string): Promise<{}>
Cancel a source embedding migration.
Parameters
- sourceId: string
  Source connection identifier.
Returns Promise<{}>
Updated migration status.
- Defined in client.ts:1769

cancelSourceExport

cancelSourceExport(sourceId: string, exportId: string): Promise<{}>
Cancel a source export.
Parameters
- sourceId: string
  Source connection identifier.
- exportId: string
  Export identifier.
Returns Promise<{}>
- Defined in client.ts:1702

changeAlertStatus

changeAlertStatus(alertId: string, body: {}): Promise<unknown>
Change the status of an alert.
Parameters
- alertId: string
  Alert identifier.
- body: {}
  Status change request.
Returns Promise<unknown>
- Defined in client.ts:2135

compactMemoryBank

compactMemoryBank(memoryBankId: string): Promise<void>
Compact a memory bank (trigger compaction).
Parameters
- memoryBankId: string
  Memory bank identifier.
Returns Promise<void>
- Defined in client.ts:1493

createAgent

createAgent(body: {}): Promise<{}>
Create a new agent.
Parameters
- body: {}
  Agent creation payload (name, trigger type, template, etc.).
Returns Promise<{}>
Summary of the created agent.
- Defined in client.ts:651

createAlertConfig

createAlertConfig(body: {}): Promise<unknown>
Create an alert configuration.
Parameters
- body: {}
  Alert config definition.
Returns Promise<unknown>
Created alert config.
- Defined in client.ts:2187

createEvaluationCriteria

createEvaluationCriteria(agentId: string, body: {}): Promise<{}>
Create evaluation criteria for an agent.
Parameters
- agentId: string
  Agent identifier.
- body: {}
  Criteria definition.
Returns Promise<{}>
Created evaluation criteria.
- Defined in client.ts:1230

createEvaluationResult

createEvaluationResult(criteriaId: string, body: {}): Promise<{}>
Create a manual evaluation result for a criteria.
Parameters
- criteriaId: string
  Criteria identifier.
- body: {}
  Evaluation result payload.
Returns Promise<{}>
Created evaluation result.
- Defined in client.ts:1293

createKnowledgeBase

createKnowledgeBase(body: {}): Promise<{}>
Create a new knowledge base.
Parameters
- body: {}
  Knowledge base configuration.
Returns Promise<{}>
The created knowledge base.
- Defined in client.ts:1377

createMemoryBank

createMemoryBank(body: {}): Promise<{}>
Create a new memory bank.

Memory banks give agents persistent memory across conversations. Types: conversation (chat-style history) or general (flat factual entries).
Parameters
- body: {}
  Memory bank configuration.
Returns Promise<{}>
The created memory bank.
- Defined in client.ts:1436

createSolution

createSolution(body: {}): Promise<{}>
Create a new solution.
Parameters
- body: {}
  Solution configuration.
Returns Promise<{}>
The created solution.
- Defined in client.ts:1870

createSource

createSource(body: {}): Promise<{}>
Create a new content source.
Parameters
- body: {}
  Source configuration (type, name, knowledge base link, etc.).
Returns Promise<{}>
The created source.
- Defined in client.ts:1591

createSourceExport

createSourceExport(sourceId: string, body: {}): Promise<{}>
Create a source data export.
Parameters
- sourceId: string
  Source connection identifier.
- body: {}
  Export configuration (format, etc.).
Returns Promise<{}>
Export response with job status.
- Defined in client.ts:1681

declineAiAssistantPlan

declineAiAssistantPlan(conversationId: string): Promise<void>
Decline an AI assistant suggestion.
Parameters
- conversationId: string
  Conversation identifier.
Returns Promise<void>
- Defined in client.ts:2386

declineGovernanceAiPlan

declineGovernanceAiPlan(conversationId: string): Promise<void>
Decline a governance AI plan.
Parameters
- conversationId: string
  Conversation identifier.
Returns Promise<void>
- Defined in client.ts:2099

declineSolutionAiPlan

declineSolutionAiPlan(solutionId: string, conversationId: string): Promise<void>
Decline a solution AI plan.
Parameters
- solutionId: string
  Solution identifier.
- conversationId: string
  Conversation identifier.
Returns Promise<void>
- Defined in client.ts:2059

deleteAgent

deleteAgent(agentId: string): Promise<void>
Delete an agent.
Parameters
- agentId: string
  Agent identifier.
Returns Promise<void>
- Defined in client.ts:681

deleteAgentRun

deleteAgentRun(runId: string): Promise<void>
Delete an agent run.
Parameters
- runId: string
  Run identifier.
Returns Promise<void>
- Defined in client.ts:772

deleteAlertConfig

deleteAlertConfig(configId: string): Promise<void>
Delete an alert configuration.
Parameters
- configId: string
  Alert config identifier.
Returns Promise<void>
- Defined in client.ts:2217

deleteContent

deleteContent(contentVersionId: string): Promise<void>
Delete a specific content version.
Parameters
- contentVersionId: string
  Content version identifier.
Returns Promise<void>
- Defined in client.ts:1808

deleteEvaluationCriteria

deleteEvaluationCriteria(criteriaId: string): Promise<void>
Delete an evaluation criteria and all associated results.
Parameters
- criteriaId: string
  Criteria identifier.
Returns Promise<void>
- Defined in client.ts:1260

deleteKnowledgeBase

deleteKnowledgeBase(knowledgeBaseId: string): Promise<void>
Delete a knowledge base.
Parameters
- knowledgeBaseId: string
  Knowledge base identifier.
Returns Promise<void>
- Defined in client.ts:1407

deleteMemoryBank

deleteMemoryBank(memoryBankId: string): Promise<void>
Delete a memory bank.
Parameters
- memoryBankId: string
  Memory bank identifier.
Returns Promise<void>
- Defined in client.ts:1466

deleteMemoryBankSource

deleteMemoryBankSource(memoryBankId: string): Promise<void>
Delete a memory bank source.
Parameters
- memoryBankId: string
  Memory bank identifier.
Returns Promise<void>
- Defined in client.ts:1502

deleteSolution

deleteSolution(solutionId: string): Promise<void>
Delete a solution.
Parameters
- solutionId: string
  Solution identifier.
Returns Promise<void>
- Defined in client.ts:1900

deleteSource

deleteSource(sourceId: string): Promise<void>
Delete a source.
Parameters
- sourceId: string
  Source connection identifier.
Returns Promise<void>
- Defined in client.ts:1621

deleteSourceExport

deleteSourceExport(sourceId: string, exportId: string): Promise<void>
Delete a source export.
Parameters
- sourceId: string
  Source connection identifier.
- exportId: string
  Export identifier.
Returns Promise<void>
- Defined in client.ts:1736

downloadSourceExport

downloadSourceExport(sourceId: string, exportId: string): Promise<Response>
Download a source export file.

Returns the raw Response so you can stream or save the binary data.
Parameters
- sourceId: string
  Source connection identifier.
- exportId: string
  Export identifier.
Returns Promise<Response>
Raw response with the export file.
- Defined in client.ts:1715

estimateSourceExport

estimateSourceExport(sourceId: string, body: {}): Promise<{}>
Estimate a source export.
Parameters
- sourceId: string
  Source connection identifier.
- body: {}
  Estimate request.
Returns Promise<{}>
Export estimate.
- Defined in client.ts:1726

generateAgentSteps

generateAgentSteps(agentId: string, body: {}): Promise<{}>
Generate agent workflow steps from natural language using AI.
Parameters
- agentId: string
  Agent identifier.
- body: {}
  Generation request with user instructions.
Returns Promise<{}>
AI-generated step configuration.
- Defined in client.ts:1171

generateGovernanceAiPlan

generateGovernanceAiPlan(body: {}): Promise<{}>
Generate governance policy suggestions using AI.
Parameters
- body: {}
  AI governance request.
Returns Promise<{}>
AI-generated governance suggestions.
- Defined in client.ts:2073

generateMemoryBankConfig

generateMemoryBankConfig(body: {}): Promise<{}>
Generate memory bank configuration using AI.
Parameters
- body: {}
  AI assistant request with user instructions.
Returns Promise<{}>
AI-generated memory bank config.
- Defined in client.ts:1540

generateSolutionAiKnowledgeBase

generateSolutionAiKnowledgeBase(solutionId: string, body: {}): Promise<{}>
Generate a knowledge base configuration via solution AI.
Parameters
- solutionId: string
  Solution identifier.
- body: {}
  Generation request.
Returns Promise<{}>
AI-generated knowledge base config.
- Defined in client.ts:2026

generateSolutionAiPlan

generateSolutionAiPlan(solutionId: string, body: {}): Promise<{}>
Generate a solution AI plan.
Parameters
- solutionId: string
  Solution identifier.
- body: {}
  Generation request.
Returns Promise<{}>
AI-generated plan.
- Defined in client.ts:2015

generateSolutionAiSource

generateSolutionAiSource(solutionId: string, body: {}): Promise<{}>
Generate a source configuration via solution AI.
Parameters
- solutionId: string
  Solution identifier.
- body: {}
  Generation request.
Returns Promise<{}>
AI-generated source config.
- Defined in client.ts:2037

generateStepConfig

generateStepConfig(agentId: string, body: {}): Promise<{}>
Generate a single step configuration using AI.
Parameters
- agentId: string
  Agent identifier.
- body: {}
  Step config generation request.
Returns Promise<{}>
AI-generated step config.
- Defined in client.ts:1182

getAgent

getAgent(agentId: string): Promise<{}>
Get agent details including its definition.
Parameters
- agentId: string
  Agent identifier.
Returns Promise<{}>
Full agent metadata.
- Defined in client.ts:661

getAgentAiConversationHistory

getAgentAiConversationHistory(agentId: string): Promise<{}>
Get AI conversation history for an agent.
Parameters
- agentId: string
  Agent identifier.
Returns Promise<{}>
Conversation history.
- Defined in client.ts:1192

getAgentDefinition

getAgentDefinition(agentId: string): Promise<{}>
Get an agent's full definition (steps, model config, etc.).
Parameters
- agentId: string
  Agent identifier.
Returns Promise<{}>
The agent definition.
- Defined in client.ts:695

getAgentInputUploadStatus

getAgentInputUploadStatus(agentId: string, uploadId: string): Promise<{}>
Get the status of an agent input upload.
Parameters
- agentId: string
  Agent identifier.
- uploadId: string
  Upload identifier.
Returns Promise<{}>
Upload status and metadata.
- Defined in client.ts:1156

getAgentRun

getAgentRun(runId: string, opts?: { includeStepOutputs?: boolean }): Promise<{}>
Get details of a specific agent run.
Parameters
- runId: string
  Run identifier.
- Optionalopts: { includeStepOutputs?: boolean }
  Optional flags.
Returns Promise<{}>
Agent run details.
- Defined in client.ts:758

getAgentsUsingMemoryBank

getAgentsUsingMemoryBank(memoryBankId: string): Promise<unknown>
Get agents that are using a specific memory bank.
Parameters
- memoryBankId: string
  Memory bank identifier.
Returns Promise<unknown>
- Defined in client.ts:1475

getAiAssistantMemoryBankHistory

getAiAssistantMemoryBankHistory(): Promise<{}>
Get AI assistant memory bank conversation history.

Returns Promise<{}>
- Defined in client.ts:2367

getAlert

getAlert(alertId: string): Promise<unknown>
Get alert details by ID.
Parameters
- alertId: string
  Alert identifier.
Returns Promise<unknown>
Alert details.
- Defined in client.ts:2125

getAlertConfig

getAlertConfig(configId: string): Promise<unknown>
Get an alert configuration by ID.
Parameters
- configId: string
  Alert config identifier.
Returns Promise<unknown>
Alert config details.
- Defined in client.ts:2197

getContentDetail

getContentDetail(
contentVersionId: string,
opts?: { end?: number; start?: number },
): Promise<{}>
Get content detail for a specific content version.
Parameters
- contentVersionId: string
  Content version identifier.
- opts: { end?: number; start?: number } = {}
  Range options for slicing large content.
Returns Promise<{}>
Content details for the requested range.
- Defined in client.ts:1784

getEvaluationCriteria

getEvaluationCriteria(criteriaId: string): Promise<{}>
Get a single evaluation criteria by ID.
Parameters
- criteriaId: string
  Criteria identifier.
Returns Promise<{}>
Evaluation criteria details.
- Defined in client.ts:1240

getEvaluationCriteriaSummary

getEvaluationCriteriaSummary(criteriaId: string): Promise<{}>
Get the evaluation summary for a specific criteria.
Parameters
- criteriaId: string
  Criteria identifier.
Returns Promise<{}>
Evaluation result summary.
- Defined in client.ts:1270

getKnowledgeBase

getKnowledgeBase(knowledgeBaseId: string): Promise<{}>
Get a knowledge base by ID.
Parameters
- knowledgeBaseId: string
  Knowledge base identifier.
Returns Promise<{}>
Knowledge base details.
- Defined in client.ts:1387

getMemoryBank

getMemoryBank(memoryBankId: string): Promise<{}>
Get a memory bank by ID.
Parameters
- memoryBankId: string
  Memory bank identifier.
Returns Promise<{}>
Memory bank details.
- Defined in client.ts:1446

getMemoryBankAiLastConversation

getMemoryBankAiLastConversation(): Promise<{}>
Get the last AI conversation for memory banks.

Returns Promise<{}>
- Defined in client.ts:1547

getMemoryBankStats

getMemoryBankStats(memoryBankId: string): Promise<unknown>
Get stats for a memory bank.
Parameters
- memoryBankId: string
  Memory bank identifier.
Returns Promise<unknown>
- Defined in client.ts:1484

getModelRecommendations

getModelRecommendations(modelId: string): Promise<unknown>
Get model recommendations.
Parameters
- modelId: string
  Model identifier.
Returns Promise<unknown>
- Defined in client.ts:2288

getNonManualEvaluationSummary

getNonManualEvaluationSummary(agentId: string): Promise<{}>
Get a summary of non-manual evaluations across an agent's runs.
Parameters
- agentId: string
  Agent identifier.
Returns Promise<{}>
- Defined in client.ts:1349

getSolution

getSolution(solutionId: string): Promise<{}>
Get a solution by ID.
Parameters
- solutionId: string
  Solution identifier.
Returns Promise<{}>
Solution details.
- Defined in client.ts:1880

getSource

getSource(sourceId: string): Promise<{}>
Get a source by ID.
Parameters
- sourceId: string
  Source connection identifier.
Returns Promise<{}>
Source details.
- Defined in client.ts:1601

getSourceEmbeddingMigration

getSourceEmbeddingMigration(sourceId: string): Promise<{}>
Get the status of a source embedding migration.
Parameters
- sourceId: string
  Source connection identifier.
Returns Promise<{}>
Migration status.
- Defined in client.ts:1748

getSourceExport

getSourceExport(sourceId: string, exportId: string): Promise<{}>
Get a specific source export.
Parameters
- sourceId: string
  Source connection identifier.
- exportId: string
  Export identifier.
Returns Promise<{}>
Export details.
- Defined in client.ts:1692

getUnreadModelAlertCount

getUnreadModelAlertCount(): Promise<unknown>
Get unread model alert count.

Returns Promise<unknown>
- Defined in client.ts:2270

linkAgentsToSolution

linkAgentsToSolution(solutionId: string, body: {}): Promise<{}>
Link agents to a solution.
Parameters
- solutionId: string
  Solution identifier.
- body: {}
  Resource IDs to link.
Returns Promise<{}>
Updated solution.
- Defined in client.ts:1913

linkKnowledgeBasesToSolution

linkKnowledgeBasesToSolution(solutionId: string, body: {}): Promise<{}>
Link knowledge bases to a solution.
Parameters
- solutionId: string
  Solution identifier.
- body: {}
  Resource IDs to link.
Returns Promise<{}>
Updated solution.
- Defined in client.ts:1935

linkSourceConnectionsToSolution

linkSourceConnectionsToSolution(solutionId: string, body: {}): Promise<{}>
Link source connections to a solution.
Parameters
- solutionId: string
  Solution identifier.
- body: {}
  Resource IDs to link.
Returns Promise<{}>
Updated solution.
- Defined in client.ts:1957

listAgentEvaluationResults

listAgentEvaluationResults(agentId: string, opts?: ListOptions): Promise<{}>
List all evaluation results for an agent.
Parameters
- agentId: string
  Agent identifier.
- opts: ListOptions = {}
  Pagination options.
Returns Promise<{}>
- Defined in client.ts:1326

listAgentRuns

listAgentRuns(
agentId: string,
opts?: ListOptions & { status?: string },
): Promise<{}>
List runs for a specific agent.
Parameters
- agentId: string
  Agent identifier.
- opts: ListOptions & { status?: string } = {}
  Pagination and filter options.
Returns Promise<{}>
Paginated list of runs.
- Defined in client.ts:732

listAgents

listAgents(opts?: ListOptions): Promise<{}>
List agents.
Parameters
- opts: ListOptions = {}
  Pagination options.
Returns Promise<{}>
Paginated list of agents.
- Defined in client.ts:639

listAlertConfigs

listAlertConfigs(opts?: ListOptions): Promise<unknown>
List alert configurations.
Parameters
- opts: ListOptions = {}
  Pagination options.
Returns Promise<unknown>
Paginated list of alert configs.
- Defined in client.ts:2175

listAlerts

listAlerts(
opts?: ListOptions & { severity?: string; status?: string },
): Promise<unknown>
List alerts.
Parameters
- opts: ListOptions & { severity?: string; status?: string } = {}
  Pagination and filter options.
Returns Promise<unknown>
Paginated list of alerts.
- Defined in client.ts:2113

listCompatibleRuns

listCompatibleRuns(criteriaId: string, opts?: ListOptions): Promise<{}>
List runs compatible with a specific evaluation criteria.
Parameters
- criteriaId: string
  Criteria identifier.
- opts: ListOptions = {}
  Pagination options.
Returns Promise<{}>
- Defined in client.ts:1303

listContentEmbeddings

listContentEmbeddings(contentVersionId: string, opts?: ListOptions): Promise<{}>
List embeddings for a content version.
Parameters
- contentVersionId: string
  Content version identifier.
- opts: ListOptions = {}
  Pagination options.
Returns Promise<{}>
Paginated list of embeddings.
- Defined in client.ts:1819

listEvaluationCriteria

listEvaluationCriteria(agentId: string, opts?: ListOptions): Promise<{}[]>
List evaluation criteria for an agent.
Parameters
- agentId: string
  Agent identifier.
- opts: ListOptions = {}
  Pagination options.
Returns Promise<{}[]>
- Defined in client.ts:1217

listEvaluationResults

listEvaluationResults(criteriaId: string, opts?: ListOptions): Promise<{}>
List evaluation results for a specific criteria.
Parameters
- criteriaId: string
  Criteria identifier.
- opts: ListOptions = {}
  Pagination options.
Returns Promise<{}>
- Defined in client.ts:1280

listEvaluationRuns

listEvaluationRuns(agentId: string, opts?: ListOptions): Promise<{}>
List evaluation run summaries for an agent.
Parameters
- agentId: string
  Agent identifier.
- opts: ListOptions = {}
  Pagination options.
Returns Promise<{}>
- Defined in client.ts:1338

listGovernanceAiConversations

listGovernanceAiConversations(): Promise<{}[]>
List governance AI conversations.

Returns Promise<{}[]>
- Defined in client.ts:2080

listKnowledgeBases

listKnowledgeBases(opts?: SortableListOptions): Promise<{}>
List knowledge bases.
Parameters
- opts: SortableListOptions = {}
  Pagination and sorting options.
Returns Promise<{}>
Paginated list of knowledge bases.
- Defined in client.ts:1365

listMemoryBanks

listMemoryBanks(opts?: SortableListOptions): Promise<{}>
List memory banks.
Parameters
- opts: SortableListOptions = {}
  Pagination and sorting options.
Returns Promise<{}>
Paginated list of memory banks.
- Defined in client.ts:1421

listMemoryBankTemplates

listMemoryBankTemplates(): Promise<unknown>
List available memory bank templates.

Returns Promise<unknown>
- Defined in client.ts:1528

listModelAlerts

listModelAlerts(opts?: ListOptions): Promise<unknown>
List model alerts.
Parameters
- opts: ListOptions = {}
  Pagination options.
Returns Promise<unknown>
- Defined in client.ts:2254

listOrganizationAlertPreferences

listOrganizationAlertPreferences(): Promise<{}>
List organization alert preferences.

Returns Promise<{}>
- Defined in client.ts:2226

listRunEvaluationResults

listRunEvaluationResults(
    agentId: string,
    runId: string,
    opts?: ListOptions,
): Promise<{}>
List evaluation results for a specific agent run.
Parameters
- agentId: string
  Agent identifier.
- runId: string
  Run identifier.
- opts: ListOptions = {}
  Pagination options.
Returns Promise<{}>
Paginated list of evaluation results.
- Defined in client.ts:1114

listSolutionConversations

listSolutionConversations(solutionId: string): Promise<{}[]>
List conversations for a solution.
Parameters
- solutionId: string
  Solution identifier.
Returns Promise<{}[]>
List of conversations.
- Defined in client.ts:1980

listSolutions

listSolutions(opts?: SortableListOptions): Promise<{}>
List solutions.
Parameters
- opts: SortableListOptions = {}
  Pagination and sorting options.
Returns Promise<{}>
Paginated list of solutions.
- Defined in client.ts:1858

listSourceExports

listSourceExports(sourceId: string, opts?: ListOptions): Promise<{}>
List exports for a source.
Parameters
- sourceId: string
  Source connection identifier.
- opts: ListOptions = {}
  Pagination options.
Returns Promise<{}>
Paginated list of exports.
- Defined in client.ts:1668

listSources

listSources(opts?: SortableListOptions & { accountId?: string }): Promise<{}>
List sources.
Parameters
- opts: SortableListOptions & { accountId?: string } = {}
  Pagination, sorting, and filter options.
Returns Promise<{}>
Paginated list of sources.
- Defined in client.ts:1571

markAgentAiSuggestion

markAgentAiSuggestion(
    agentId: string,
    conversationId: string,
    body: {},
): Promise<void>
Mark an AI suggestion as accepted or rejected.
Parameters
- agentId: string
  Agent identifier.
- conversationId: string
  Conversation turn identifier.
- body: {}
  Mark request payload.
Returns Promise<void>
- Defined in client.ts:1203

markAllModelAlertsRead

markAllModelAlertsRead(): Promise<void>
Mark all model alerts as read.

Returns Promise<void>
- Defined in client.ts:2263

markModelAlertRead

markModelAlertRead(alertId: string): Promise<void>
Mark a specific model alert as read.
Parameters
- alertId: string
  Model alert identifier.
Returns Promise<void>
- Defined in client.ts:2279

markSolutionConversationTurn

markSolutionConversationTurn(
    solutionId: string,
    conversationId: string,
    body: {},
): Promise<void>
Mark a conversation turn (e.g. accepted/rejected).
Parameters
- solutionId: string
  Solution identifier.
- conversationId: string
  Conversation identifier.
- body: {}
  Mark payload.
Returns Promise<void>
- Defined in client.ts:2002

paginate

paginate<T>(
    fetchPage: (
        opts: { limit: number; page: number },
    ) => Promise<
        { items: T[]; pagination?: { page: number; total_pages: number } },
    >,
    opts?: { limit?: number },
): AsyncGenerator<T, void, undefined>
Auto-paginate through a list endpoint.

Yields individual items from each page, automatically fetching the next page until all items have been returned.
Type Parameters
- T
Parameters
- fetchPage: (
  opts: { limit: number; page: number },
  ) => Promise<
  { items: T[]; pagination?: { page: number; total_pages: number } },
  >
  A function that fetches a single page given { page, limit }.
- Optionalopts: { limit?: number }
  Page size (default: 50).
Returns AsyncGenerator<T, void, undefined>
Example
```
for await (const agent of client.paginate(
  (opts) => client.listAgents(opts),
)) {
  console.log(agent);
}
```
- Defined in client.ts:2422

replaceContentWithInlineText

replaceContentWithInlineText(contentVersionId: string, body: {}): Promise<{}>
Replace content with inline text.
Parameters
- contentVersionId: string
  Content version identifier.
- body: {}
  Inline text replacement payload.
Returns Promise<{}>
- Defined in client.ts:1799

request

request(
    method: string,
    path: string,
    opts?: {
        headers?: Record<string, string>;
        json?: unknown;
        query?: Record<string, unknown>;
        signal?: AbortSignal;
    },
): Promise<unknown>
Make a raw HTTP request to the Seclai API.

This is a low-level escape hatch. For most operations, prefer the typed convenience methods.
Parameters
- method: string
  HTTP method (e.g. "GET", "POST").
- path: string
  Request path relative to baseUrl (e.g. "/sources/").
- Optionalopts: {
      headers?: Record<string, string>;
      json?: unknown;
      query?: Record<string, unknown>;
      signal?: AbortSignal;
  }
  Query params, JSON body, per-request headers, and optional AbortSignal.
Returns Promise<unknown>
Parsed JSON for JSON responses, raw text for non-JSON responses, or null for empty bodies.

Throws
SeclaiAPIValidationError For validation errors (typically HTTP 422).

Throws
SeclaiAPIStatusError For other non-success HTTP status codes.
- Defined in client.ts:433

requestRaw

requestRaw(
    method: string,
    path: string,
    opts?: {
        headers?: Record<string, string>;
        json?: unknown;
        query?: Record<string, unknown>;
        signal?: AbortSignal;
    },
): Promise<Response>
Make a raw HTTP request and return the raw Response object (for binary downloads, etc.).
Parameters
- method: string
  HTTP method.
- path: string
  Request path relative to baseUrl.
- Optionalopts: {
      headers?: Record<string, string>;
      json?: unknown;
      query?: Record<string, unknown>;
      signal?: AbortSignal;
  }
  Query params, JSON body, per-request headers, and optional AbortSignal.
Returns Promise<Response>
The raw Response object.

Throws
On HTTP 422 responses.

Throws
On other non-2xx responses.
- Defined in client.ts:512

runAgent

runAgent(agentId: string, body: {}): Promise<{}>
Start an agent run.
Parameters
- agentId: string
  Agent identifier.
- body: {}
  Run request payload (input, metadata, priority, etc.).
Returns Promise<{}>
The created agent run.
- Defined in client.ts:721

runAgentAndPoll

runAgentAndPoll(
    agentId: string,
    body: {},
    opts?: {
        includeStepOutputs?: boolean;
        pollIntervalMs?: number;
        signal?: AbortSignal;
        timeoutMs?: number;
    },
): Promise<{}>
Run an agent and poll until it reaches a terminal status.

This is useful in environments where SSE streaming is unavailable.
Parameters
- agentId: string
  Agent identifier.
- body: {}
  Run request payload.
- Optionalopts: {
      includeStepOutputs?: boolean;
      pollIntervalMs?: number;
      signal?: AbortSignal;
      timeoutMs?: number;
  }
  Polling configuration and abort signal.
  - OptionalincludeStepOutputs?: boolean
    Include per-step outputs in the final result.
  - OptionalpollIntervalMs?: number
    Polling interval in ms (default: 2000).
  - Optionalsignal?: AbortSignal
  - OptionaltimeoutMs?: number
    Maximum time to wait in ms (default: 300000 = 5 min).
Returns Promise<{}>
The terminal agent run.

Throws
SeclaiStreamingError On timeout.
- Defined in client.ts:1063

runStreamingAgent

runStreamingAgent(
    agentId: string,
    body: {},
    opts?: { signal?: AbortSignal; timeoutMs?: number },
): AsyncGenerator<AgentRunEvent, void, undefined>
Run an agent in streaming mode and yield each SSE event as it arrives.

This is an AsyncGenerator suitable for real-time UIs that want to render step progress as it happens.
Parameters
- agentId: string
  Agent identifier.
- body: {}
  Streaming run request payload.
- Optionalopts: { signal?: AbortSignal; timeoutMs?: number }
  Timeout and abort signal options.
Returns AsyncGenerator<AgentRunEvent, void, undefined>
Yields
AgentRunEvent for each SSE message.
Example
```
for await (const event of client.runStreamingAgent("agent-id", { input: "Hello!" })) {
  if (event.event === "done") {
    console.log("Final:", event.data);
  }
}
```
- Defined in client.ts:935

runStreamingAgentAndWait

runStreamingAgentAndWait(
    agentId: string,
    body: {},
    opts?: { signal?: AbortSignal; timeoutMs?: number },
): Promise<{}>
Run an agent in streaming mode (SSE) and wait for the final result.

Consumes the entire SSE stream and returns only the terminal done payload. For real-time event access, use runStreamingAgent instead.
Parameters
- agentId: string
  Agent identifier.
- body: {}
  Streaming run request payload.
- Optionalopts: { signal?: AbortSignal; timeoutMs?: number }
  Timeout and abort signal options.
Returns Promise<{}>
Final agent run payload from the done event.

Throws
SeclaiStreamingError If the stream ends before a done event.
- Defined in client.ts:802

search

search(
opts: { entityType?: string; limit?: number; query: string },
): Promise<unknown>
Search across all resource types in your account.

Accepts a free-text keyword query or a UUID. Results are ranked: name-prefix > name-substring > description-substring.
Parameters
- opts: { entityType?: string; limit?: number; query: string }
  Search options.
  - OptionalentityType?: string
    Optional entity type filter (e.g. "agent", "knowledge_base").
  - Optionallimit?: number
    Maximum results (1-50, default 10).
  - query: string
    Search query string (required, 1-200 chars).
Returns Promise<unknown>
Search results.
- Defined in client.ts:2308

searchAgentRuns

searchAgentRuns(body: {}): Promise<{}>
Search agent runs (traces) across all agents.
Parameters
- body: {}
  Search query and filters.
Returns Promise<{}>
Search results with matching runs.
- Defined in client.ts:747

startSourceEmbeddingMigration

startSourceEmbeddingMigration(sourceId: string, body: {}): Promise<{}>
Start a source embedding migration.
Parameters
- sourceId: string
  Source connection identifier.
- body: {}
  Migration configuration (target embedding model, etc.).
Returns Promise<{}>
Migration status.
- Defined in client.ts:1759

submitAiFeedback

submitAiFeedback(body: {}): Promise<{}>
Submit feedback on an AI assistant interaction.
Parameters
- body: {}
  Feedback payload (thumbs up/down, optional comment).
Returns Promise<{}>
Feedback response.
- Defined in client.ts:2324

subscribeToAlert

subscribeToAlert(alertId: string): Promise<unknown>
Subscribe to an alert.
Parameters
- alertId: string
  Alert identifier.
Returns Promise<unknown>
- Defined in client.ts:2154

testCompactionPromptStandalone

testCompactionPromptStandalone(body: {}): Promise<{}>
Test compaction prompt standalone (not tied to a specific memory bank).
Parameters
- body: {}
  Standalone compaction test request.
Returns Promise<{}>
- Defined in client.ts:1521

testDraftEvaluation

testDraftEvaluation(agentId: string, body: {}): Promise<{}>
Test a draft evaluation criteria without persisting it.
Parameters
- agentId: string
  Agent identifier.
- body: {}
  Draft evaluation to test.
Returns Promise<{}>
Test evaluation response.
- Defined in client.ts:1316

testMemoryBankCompaction

testMemoryBankCompaction(memoryBankId: string, body: {}): Promise<{}>
Test compaction for a specific memory bank.
Parameters
- memoryBankId: string
  Memory bank identifier.
- body: {}
  Test compaction request.
Returns Promise<{}>
- Defined in client.ts:1512

unlinkAgentsFromSolution

unlinkAgentsFromSolution(solutionId: string, body: {}): Promise<{}>
Unlink agents from a solution.
Parameters
- solutionId: string
  Solution identifier.
- body: {}
  Resource IDs to unlink.
Returns Promise<{}>
Updated solution.
- Defined in client.ts:1924

unlinkKnowledgeBasesFromSolution

unlinkKnowledgeBasesFromSolution(solutionId: string, body: {}): Promise<{}>
Unlink knowledge bases from a solution.
Parameters
- solutionId: string
  Solution identifier.
- body: {}
  Resource IDs to unlink.
Returns Promise<{}>
Updated solution.
- Defined in client.ts:1946

unlinkSourceConnectionsFromSolution

unlinkSourceConnectionsFromSolution(solutionId: string, body: {}): Promise<{}>
Unlink source connections from a solution.
Parameters
- solutionId: string
  Solution identifier.
- body: {}
  Resource IDs to unlink.
Returns Promise<{}>
Updated solution.
- Defined in client.ts:1968

unsubscribeFromAlert

unsubscribeFromAlert(alertId: string): Promise<unknown>
Unsubscribe from an alert.
Parameters
- alertId: string
  Alert identifier.
Returns Promise<unknown>
- Defined in client.ts:2163

updateAgent

updateAgent(agentId: string, body: {}): Promise<{}>
Update an agent.
Parameters
- agentId: string
  Agent identifier.
- body: {}
  Fields to update.
Returns Promise<{}>
Updated agent summary.
- Defined in client.ts:672

updateAgentDefinition

updateAgentDefinition(agentId: string, body: {}): Promise<{}>
Update an agent's definition.
Parameters
- agentId: string
  Agent identifier.
- body: {}
  Updated definition payload.
Returns Promise<{}>
Updated agent definition.
- Defined in client.ts:706

updateAlertConfig

updateAlertConfig(configId: string, body: {}): Promise<unknown>
Update an alert configuration.
Parameters
- configId: string
  Alert config identifier.
- body: {}
  Fields to update.
Returns Promise<unknown>
Updated alert config.
- Defined in client.ts:2208

updateEvaluationCriteria

updateEvaluationCriteria(criteriaId: string, body: {}): Promise<{}>
Update an evaluation criteria.
Parameters
- criteriaId: string
  Criteria identifier.
- body: {}
  Fields to update.
Returns Promise<{}>
Updated evaluation criteria.
- Defined in client.ts:1251

updateKnowledgeBase

updateKnowledgeBase(knowledgeBaseId: string, body: {}): Promise<{}>
Update a knowledge base.
Parameters
- knowledgeBaseId: string
  Knowledge base identifier.
- body: {}
  Fields to update.
Returns Promise<{}>
Updated knowledge base.
- Defined in client.ts:1398

updateMemoryBank

updateMemoryBank(memoryBankId: string, body: {}): Promise<{}>
Update a memory bank.
Parameters
- memoryBankId: string
  Memory bank identifier.
- body: {}
  Fields to update.
Returns Promise<{}>
Updated memory bank.
- Defined in client.ts:1457

updateOrganizationAlertPreference

updateOrganizationAlertPreference(
    organizationId: string,
    alertType: string,
    body: {},
): Promise<unknown>
Update an organization alert preference.
Parameters
- organizationId: string
  Organization identifier.
- alertType: string
  Alert type.
- body: {}
  Preference update.
Returns Promise<unknown>
- Defined in client.ts:2237

updateSolution

updateSolution(solutionId: string, body: {}): Promise<{}>
Update a solution.
Parameters
- solutionId: string
  Solution identifier.
- body: {}
  Fields to update.
Returns Promise<{}>
Updated solution.
- Defined in client.ts:1891

updateSource

updateSource(sourceId: string, body: {}): Promise<{}>
Update a source.
Parameters
- sourceId: string
  Source connection identifier.
- body: {}
  Fields to update.
Returns Promise<{}>
Updated source.
- Defined in client.ts:1612

uploadAgentInput

uploadAgentInput(
    agentId: string,
    opts: {
        file: Blob | Uint8Array<ArrayBufferLike> | BufferSource;
        fileName?: string;
        mimeType?: string;
    },
): Promise<{}>
Upload a file to use as input for a dynamic_input agent run.

After uploading, poll getAgentInputUploadStatus until status is ready, then pass input_upload_id to runAgent.
Parameters
- agentId: string
  Agent identifier.
- opts: {
      file: Blob | Uint8Array<ArrayBufferLike> | BufferSource;
      fileName?: string;
      mimeType?: string;
  }
  File payload and optional metadata.
Returns Promise<{}>
Upload response with the upload ID and status.
- Defined in client.ts:1138

uploadFileToContent

uploadFileToContent(
    contentVersionId: string,
    opts: {
        file: Blob | Uint8Array<ArrayBufferLike> | BufferSource;
        fileName?: string;
        metadata?: Record<string, unknown>;
        mimeType?: string;
        title?: string;
    },
): Promise<{}>
Upload a file to replace content for an existing content version.
Parameters
- contentVersionId: string
  Content version identifier.
- opts: {
      file: Blob | Uint8Array<ArrayBufferLike> | BufferSource;
      fileName?: string;
      metadata?: Record<string, unknown>;
      mimeType?: string;
      title?: string;
  }
  File payload and optional metadata.
Returns Promise<{}>
Upload response.
- Defined in client.ts:1835

uploadFileToSource

uploadFileToSource(
    sourceId: string,
    opts: {
        file: Blob | Uint8Array<ArrayBufferLike> | BufferSource;
        fileName?: string;
        metadata?: Record<string, unknown>;
        mimeType?: string;
        title?: string;
    },
): Promise<{}>
Upload a file to a source.

Maximum file size: 200 MiB. Supports text, PDF, DOCX, audio, video, images, and more. If mimeType is omitted, it will be inferred from the fileName extension when possible.
Parameters
- sourceId: string
  Source connection identifier.
- opts: {
      file: Blob | Uint8Array<ArrayBufferLike> | BufferSource;
      fileName?: string;
      metadata?: Record<string, unknown>;
      mimeType?: string;
      title?: string;
  }
  File payload and optional metadata.
Returns Promise<{}>
Upload response details.
- Defined in client.ts:1635

uploadInlineTextToSource

uploadInlineTextToSource(sourceId: string, body: {}): Promise<{}>
Upload inline text to a source.
Parameters
- sourceId: string
  Source connection identifier.
- body: {}
  Inline text upload payload.
Returns Promise<{}>
Upload response.
- Defined in client.ts:1655

Class Seclai

Example

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns Seclai

Throws

Throws

Methods

acceptAiAssistantPlan

Parameters

Returns Promise<{}>

acceptAiMemoryBankSuggestion

Parameters

Returns Promise<unknown>

acceptGovernanceAiPlan

Parameters

Returns Promise<{}>

acceptMemoryBankAiSuggestion

Parameters

Returns Promise<unknown>

acceptSolutionAiPlan

Parameters

Returns Promise<{}>

addAlertComment

Parameters

Returns Promise<unknown>

addSolutionConversationTurn

Parameters

Returns Promise<{}>

aiAssistantKnowledgeBase

Parameters

Returns Promise<{}>

aiAssistantMemoryBank

Parameters

Returns Promise<{}>

aiAssistantSolution

Parameters

Returns Promise<{}>

aiAssistantSource

Parameters

Returns Promise<{}>

cancelAgentRun

Parameters

Returns Promise<{}>

cancelSourceEmbeddingMigration

Parameters

Returns Promise<{}>

cancelSourceExport

Parameters

Returns Promise<{}>

changeAlertStatus

Parameters

Returns Promise<unknown>

compactMemoryBank

Parameters

Returns Promise<void>

createAgent

Parameters

Returns Promise<{}>

createAlertConfig

Parameters

Returns Promise<unknown>

createEvaluationCriteria

Parameters

Returns Promise<{}>

createEvaluationResult

Parameters

Returns Promise<{}>

createKnowledgeBase

Parameters

Returns Promise<{}>

createMemoryBank

Parameters

Returns Promise<{}>

createSolution

Parameters