@mcoda/mswarm 0.1.57 → 0.1.61

package/dist/vendor/codali/docdex/DocdexClient.d.ts

@@ -0,0 +1,158 @@
+import type { DocdexCapabilitySnapshot } from "../cognitive/Types.js";
+export interface DocdexClientOptions {
+    baseUrl: string;
+    repoRoot?: string;
+    repoId?: string;
+    authToken?: string;
+    apiKey?: string;
+    credentialSource?: "attached_mswarm_api_key" | string;
+    required?: boolean;
+    allowedOperations?: readonly string[];
+    capabilities?: Record<string, boolean | undefined>;
+    dagSessionId?: string;
+}
+export type DocdexRuntimeErrorCode = "docdex_context_missing" | "docdex_api_key_missing" | "docdex_operation_not_allowed" | "docdex_auth_failed" | "docdex_repo_access_denied" | "docdex_unavailable";
+export type DocdexRuntimeOperation = "health" | "initialize" | "search" | "snippet" | "open" | "symbols" | "ast" | "impact_graph" | "impact_diagnostics" | "dag_export" | "tree" | "memory_save" | "memory_recall" | "profile_read" | "profile_write" | "web_research" | "chat_context" | "rerank" | "batch_search" | "capabilities" | "stats" | "files" | "repo_inspect" | "index_rebuild" | "index_ingest" | "delegate" | "hooks_validate";
+export interface DocdexRuntimeErrorOptions {
+    status?: number;
+    retryable?: boolean;
+    details?: Record<string, unknown>;
+}
+export declare class DocdexRuntimeError extends Error {
+    readonly code: DocdexRuntimeErrorCode;
+    readonly status?: number;
+    readonly retryable: boolean;
+    readonly details?: Record<string, unknown>;
+    constructor(code: DocdexRuntimeErrorCode, message: string, options?: DocdexRuntimeErrorOptions);
+}
+export interface DocdexSearchOptions {
+    limit?: number;
+    dagSessionId?: string;
+}
+export interface DocdexSnippetOptions {
+    window?: number;
+    textOnly?: boolean;
+}
+export interface DocdexImpactOptions {
+    maxDepth?: number;
+    maxEdges?: number;
+    edgeTypes?: string[];
+}
+export interface DocdexDagOptions {
+    format?: "json" | "text" | "dot";
+    maxNodes?: number;
+}
+export interface DocdexImpactDiagnosticsOptions {
+    limit?: number;
+    offset?: number;
+    file?: string;
+}
+export interface DocdexTreeOptions {
+    path?: string;
+    maxDepth?: number;
+    dirsOnly?: boolean;
+    includeHidden?: boolean;
+    extraExcludes?: string[];
+}
+export interface DocdexOpenFileOptions {
+    startLine?: number;
+    endLine?: number;
+    head?: number;
+    clamp?: boolean;
+}
+export interface DocdexChatMessage {
+    role: string;
+    content: string | Array<Record<string, unknown>>;
+    name?: string;
+    tool_call_id?: string;
+    tool_calls?: unknown;
+}
+export interface DocdexChatContextOptions {
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+    docdex?: Record<string, unknown>;
+}
+export interface DocdexWebResearchOptions {
+    forceWeb?: boolean;
+    skipLocalSearch?: boolean;
+    webLimit?: number;
+    noCache?: boolean;
+}
+export interface DocdexWriteMetadata {
+    [key: string]: unknown;
+}
+export declare const isDocdexRuntimeErrorCode: (value: unknown) => value is DocdexRuntimeErrorCode;
+export declare const normalizeDocdexRuntimeOperation: (value: string) => DocdexRuntimeOperation | undefined;
+export declare class DocdexClient {
+    private options;
+    private repoId?;
+    private dagSessionId?;
+    private healthChecked;
+    private repoInitializeAttempted;
+    private capabilitySnapshot?;
+    constructor(options: DocdexClientOptions);
+    setRepoId(repoId: string): void;
+    getRepoId(): string | undefined;
+    getRepoRoot(): string | undefined;
+    setDagSessionId(sessionId: string): void;
+    getDagSessionId(): string | undefined;
+    clearCapabilityCache(): void;
+    private runtimeAllowedOperations;
+    private runtimeCapability;
+    private redactSensitiveText;
+    private runtimeError;
+    private assertRuntimeContext;
+    private assertOperationAllowed;
+    private resolveBaseUrl;
+    private buildHeaders;
+    private ensureHealth;
+    healthCheck(): Promise<boolean>;
+    initialize(rootUri: string): Promise<{
+        repoId?: string;
+        repoRoot?: string;
+    }>;
+    private initializeRepo;
+    private ensureRepoInitialized;
+    private withRepoId;
+    private extractErrorCode;
+    private mapResponseErrorCode;
+    private throwResponseError;
+    search(query: string, options?: DocdexSearchOptions): Promise<unknown>;
+    openSnippet(docId: string, options?: DocdexSnippetOptions): Promise<unknown>;
+    impactGraph(file: string, options?: DocdexImpactOptions): Promise<unknown>;
+    impactDiagnostics(options?: DocdexImpactDiagnosticsOptions): Promise<unknown>;
+    indexRebuild(libsSources?: string): Promise<unknown>;
+    indexIngest(file: string): Promise<unknown>;
+    hooksValidate(files: string[]): Promise<unknown>;
+    delegate(payload: Record<string, unknown>): Promise<unknown>;
+    chatContext(messages: DocdexChatMessage[], options?: DocdexChatContextOptions): Promise<unknown>;
+    dagExport(sessionId: string, options?: DocdexDagOptions): Promise<unknown>;
+    callMcp<T>(method: string, params: Record<string, unknown>): Promise<T>;
+    private normalizeMcpResult;
+    private tryParseJson;
+    private buildProjectParams;
+    private defaultCapabilityMap;
+    private toCapabilityStatus;
+    private normalizeCapabilityPayload;
+    symbols(pathValue: string): Promise<unknown>;
+    ast(pathValue: string, maxNodes?: number): Promise<unknown>;
+    stats(): Promise<unknown>;
+    files(limit?: number, offset?: number): Promise<unknown>;
+    repoInspect(): Promise<unknown>;
+    memorySave(text: string, metadata?: DocdexWriteMetadata): Promise<unknown>;
+    memoryRecall(query: string, topK?: number): Promise<unknown>;
+    tree(options?: DocdexTreeOptions): Promise<unknown>;
+    openFile(pathValue: string, options?: DocdexOpenFileOptions): Promise<unknown>;
+    getProfile(agentId?: string): Promise<unknown>;
+    savePreference(agentId: string, category: string, content: string, metadata?: DocdexWriteMetadata): Promise<unknown>;
+    webResearch(query: string, options?: DocdexWebResearchOptions): Promise<unknown>;
+    private webResearchHttp;
+    rerank(query: string, candidates: unknown[], limit?: number): Promise<unknown>;
+    batchSearch(queries: string[], options?: {
+        limit?: number;
+        includeLibs?: boolean;
+    }): Promise<unknown>;
+    getCapabilities(forceRefresh?: boolean): Promise<DocdexCapabilitySnapshot>;
+}
+//# sourceMappingURL=DocdexClient.d.ts.map

package/dist/vendor/codali/docdex/DocdexClient.d.ts.map

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