@maximem/synap-js-sdk 0.1.1

package/types/index.d.ts

@@ -0,0 +1,170 @@
+export type LogLevel = 'debug' | 'error';
+
+export interface BridgeLogHandler {
+  (level: LogLevel, message: string): void;
+}
+
+export interface SynapClientOptions {
+  instanceId?: string;
+  bootstrapToken?: string;
+  baseUrl?: string;
+  grpcHost?: string;
+  grpcPort?: number;
+  grpcUseTls?: boolean;
+  pythonBin?: string;
+  bridgeScriptPath?: string;
+  sdkHome?: string;
+  venvPath?: string;
+  pythonBootstrap?: string;
+  pythonPackage?: string;
+  pythonSdkVersion?: string;
+  noDeps?: boolean;
+  noBuildIsolation?: boolean;
+  upgrade?: boolean;
+  forceRecreateVenv?: boolean;
+  autoSetup?: boolean;
+  requestTimeoutMs?: number;
+  initTimeoutMs?: number;
+  ingestTimeoutMs?: number;
+  pythonEnv?: NodeJS.ProcessEnv;
+  onLog?: BridgeLogHandler;
+}
+
+export interface ChatMessage {
+  role?: string;
+  content: string;
+}
+
+export interface AddMemoryInput {
+  userId: string;
+  messages: ChatMessage[];
+}
+
+export interface SearchMemoryInput {
+  userId: string;
+  query: string;
+  maxResults?: number;
+}
+
+export interface GetMemoriesInput {
+  userId: string;
+}
+
+export interface DeleteMemoryInput {
+  userId: string;
+  memoryId?: string | null;
+}
+
+export interface BridgeStepTiming {
+  step: string;
+  ms: number;
+}
+
+export interface BridgeTiming {
+  python_total_ms: number;
+  steps: BridgeStepTiming[];
+}
+
+export interface AddMemoryResult {
+  success: boolean;
+  latencyMs: number;
+  rawResponse: Record<string, unknown>;
+  note?: string;
+  bridgeTiming?: BridgeTiming;
+}
+
+export interface SearchMemoryItem {
+  id: string;
+  memory: string;
+  score?: number;
+}
+
+export interface SearchMemoryResult {
+  success: boolean;
+  latencyMs: number;
+  results: SearchMemoryItem[];
+  resultsCount: number;
+  rawResponse: Record<string, unknown>;
+  source?: string;
+  bridgeTiming?: BridgeTiming;
+}
+
+export interface MemoryItem {
+  id: string;
+  memory: string;
+}
+
+export interface GetMemoriesResult {
+  success: boolean;
+  latencyMs: number;
+  memories: MemoryItem[];
+  totalCount: number;
+  bridgeTiming?: BridgeTiming;
+}
+
+export interface DeleteMemoryResult {
+  success: boolean;
+  deletedCount: number;
+  note?: string;
+  bridgeTiming?: BridgeTiming;
+}
+
+export class SynapClient {
+  constructor(options?: SynapClientOptions);
+  init(): Promise<void>;
+  addMemory(input: AddMemoryInput): Promise<AddMemoryResult>;
+  searchMemory(input: SearchMemoryInput): Promise<SearchMemoryResult>;
+  getMemories(input: GetMemoriesInput): Promise<GetMemoriesResult>;
+  deleteMemory(input: DeleteMemoryInput): Promise<DeleteMemoryResult>;
+  shutdown(): Promise<void>;
+}
+
+export interface SetupPythonRuntimeOptions {
+  sdkHome?: string;
+  venvPath?: string;
+  pythonBootstrap?: string;
+  pythonPackage?: string;
+  pythonSdkVersion?: string;
+  noDeps?: boolean;
+  noBuildIsolation?: boolean;
+  upgrade?: boolean;
+  forceRecreateVenv?: boolean;
+}
+
+export interface SetupPythonRuntimeResult {
+  sdkHome: string;
+  venvPath: string;
+  pythonBin: string;
+  pythonPackage: string;
+  pythonSdkVersion: string | null;
+  installTarget: string;
+}
+
+export interface SetupTypeScriptExtensionOptions {
+  projectDir?: string;
+  packageManager?: 'npm' | 'pnpm' | 'yarn' | 'bun';
+  skipInstall?: boolean;
+  tsconfigPath?: string;
+  wrapperPath?: string;
+  force?: boolean;
+  noWrapper?: boolean;
+}
+
+export interface SetupTypeScriptExtensionResult {
+  projectDir: string;
+  packageManager: 'npm' | 'pnpm' | 'yarn' | 'bun';
+  installedDevDependencies: boolean;
+  tsconfigPath: string;
+  tsconfigCreated: boolean;
+  wrapperPath: string | null;
+  wrapperCreated: boolean;
+}
+
+export function createClient(options?: SynapClientOptions): SynapClient;
+export function resolveInstanceId(explicitInstanceId?: string): string;
+export function setupPythonRuntime(
+  options?: SetupPythonRuntimeOptions
+): Promise<SetupPythonRuntimeResult>;
+export function setupTypeScriptExtension(
+  options?: SetupTypeScriptExtensionOptions
+): Promise<SetupTypeScriptExtensionResult>;