@namzu/sdk 0.1.1 → 0.1.2

package/src/types/provider/interface.ts

@@ -1,16 +1,16 @@
 import type { ChatCompletionParams, ChatCompletionResponse } from './chat.js'
-import type { StreamChunk } from './stream.js'
 import type { ModelInfo } from './model.js'
+import type { StreamChunk } from './stream.js'
 
 export interface LLMProvider {
-  readonly id: string
-  readonly name: string
+	readonly id: string
+	readonly name: string
 
-  chat(params: ChatCompletionParams): Promise<ChatCompletionResponse>
+	chat(params: ChatCompletionParams): Promise<ChatCompletionResponse>
 
-  chatStream(params: ChatCompletionParams): AsyncIterable<StreamChunk>
+	chatStream(params: ChatCompletionParams): AsyncIterable<StreamChunk>
 
-  listModels?(): Promise<ModelInfo[]>
+	listModels?(): Promise<ModelInfo[]>
 
-  healthCheck?(): Promise<boolean>
+	healthCheck?(): Promise<boolean>
 }

package/src/types/provider/model.ts

@@ -1,10 +1,10 @@
 export interface ModelInfo {
-  id: string
-  name: string
-  contextWindow: number
-  maxOutputTokens: number
-  inputPrice: number
-  outputPrice: number
-  supportsToolUse: boolean
-  supportsStreaming: boolean
+	id: string
+	name: string
+	contextWindow: number
+	maxOutputTokens: number
+	inputPrice: number
+	outputPrice: number
+	supportsToolUse: boolean
+	supportsStreaming: boolean
 }

package/src/types/provider/stream.ts

@@ -1,20 +1,20 @@
 import type { TokenUsage } from '../common/index.js'
 
 export interface StreamChunk {
-  id: string
-  delta: {
-    content?: string
-    toolCalls?: Array<{
-      index: number
-      id?: string
-      type?: 'function'
-      function?: {
-        name?: string
-        arguments?: string
-      }
-    }>
-  }
-  finishReason?: 'stop' | 'tool_calls' | 'length' | 'content_filter'
-  usage?: TokenUsage
-  error?: string
+	id: string
+	delta: {
+		content?: string
+		toolCalls?: Array<{
+			index: number
+			id?: string
+			type?: 'function'
+			function?: {
+				name?: string
+				arguments?: string
+			}
+		}>
+	}
+	finishReason?: 'stop' | 'tool_calls' | 'length' | 'content_filter'
+	usage?: TokenUsage
+	error?: string
 }

package/src/types/rag/chunking.ts

@@ -1,17 +1,17 @@
 export type ChunkingStrategy = 'fixed' | 'sentence' | 'paragraph' | 'recursive'
 
 export interface ChunkingConfig {
-  strategy: ChunkingStrategy
-  chunkSize: number
-  chunkOverlap: number
-  separators?: string[]
+	strategy: ChunkingStrategy
+	chunkSize: number
+	chunkOverlap: number
+	separators?: string[]
 }
 
 export interface Chunker {
-  chunk(content: string, config: ChunkingConfig): ChunkContent[]
+	chunk(content: string, config: ChunkingConfig): ChunkContent[]
 }
 
 export interface ChunkContent {
-  content: string
-  index: number
+	content: string
+	index: number
 }

package/src/types/rag/context.ts

@@ -2,27 +2,27 @@ import type { DocumentId, KnowledgeBaseId } from '../ids/index.js'
 import type { KnowledgeBase } from './knowledge-base.js'
 
 export interface RAGToolInput {
-  query: string
-  knowledgeBaseId?: string
-  topK?: number
+	query: string
+	knowledgeBaseId?: string
+	topK?: number
 }
 
 export interface RAGContextConfig {
-  maxTokens: number
-  separator: string
-  includeMetadata: boolean
-  headerTemplate?: string
+	maxTokens: number
+	separator: string
+	includeMetadata: boolean
+	headerTemplate?: string
 }
 
 export interface RAGContext {
-  content: string
-  sources: Array<{ documentId: DocumentId; chunk: string; score: number }>
-  tokenCount: number
+	content: string
+	sources: Array<{ documentId: DocumentId; chunk: string; score: number }>
+	tokenCount: number
 }
 
 export interface RAGToolConfig {
-  knowledgeBases: Map<string, KnowledgeBase>
-  defaultKnowledgeBaseId?: KnowledgeBaseId
-  contextConfig?: Partial<RAGContextConfig>
-  topK?: number
+	knowledgeBases: Map<string, KnowledgeBase>
+	defaultKnowledgeBaseId?: KnowledgeBaseId
+	contextConfig?: Partial<RAGContextConfig>
+	topK?: number
 }

package/src/types/rag/embedding.ts

@@ -1,19 +1,19 @@
 export interface EmbeddingProvider {
-  readonly id: string
-  readonly model: string
-  readonly dimensions: number
+	readonly id: string
+	readonly model: string
+	readonly dimensions: number
 
-  embed(texts: string[]): Promise<number[][]>
-  embedQuery(query: string): Promise<number[]>
+	embed(texts: string[]): Promise<number[][]>
+	embedQuery(query: string): Promise<number[]>
 }
 
 export interface EmbeddingConfig {
-  model: string
-  dimensions?: number
-  batchSize?: number
+	model: string
+	dimensions?: number
+	batchSize?: number
 }
 
 export interface OpenRouterEmbeddingConfig extends EmbeddingConfig {
-  apiKey: string
-  baseUrl?: string
+	apiKey: string
+	baseUrl?: string
 }

package/src/types/rag/ingestion.ts

@@ -2,19 +2,19 @@ import type { DocumentId, KnowledgeBaseId } from '../ids/index.js'
 import type { DocumentMetadata, TenantScope } from './scope.js'
 
 export interface IngestionResult {
-  documentId: DocumentId
-  chunkCount: number
-  totalTokens: number
-  durationMs: number
+	documentId: DocumentId
+	chunkCount: number
+	totalTokens: number
+	durationMs: number
 }
 
 export interface IngestionPipeline {
-  ingest(
-    content: string,
-    metadata: DocumentMetadata,
-    scope: TenantScope,
-    knowledgeBaseId: KnowledgeBaseId,
-  ): Promise<IngestionResult>
+	ingest(
+		content: string,
+		metadata: DocumentMetadata,
+		scope: TenantScope,
+		knowledgeBaseId: KnowledgeBaseId,
+	): Promise<IngestionResult>
 
-  remove(documentId: DocumentId): Promise<void>
+	remove(documentId: DocumentId): Promise<void>
 }

package/src/types/rag/knowledge-base.ts

@@ -1,27 +1,27 @@
 import type { DocumentId, KnowledgeBaseId } from '../ids/index.js'
-import type { DocumentMetadata } from './scope.js'
 import type { ChunkingConfig } from './chunking.js'
 import type { EmbeddingConfig } from './embedding.js'
-import type { RetrievalConfig, RetrievalQuery, RetrievalResult } from './retrieval.js'
 import type { IngestionResult } from './ingestion.js'
+import type { RetrievalConfig, RetrievalQuery, RetrievalResult } from './retrieval.js'
+import type { DocumentMetadata } from './scope.js'
 
 export interface KnowledgeBaseConfig {
-  id?: KnowledgeBaseId
-  name: string
-  description?: string
-  tenantId: string
-  namespace?: string
-  chunking?: Partial<ChunkingConfig>
-  retrieval?: Partial<RetrievalConfig>
-  embedding?: EmbeddingConfig
+	id?: KnowledgeBaseId
+	name: string
+	description?: string
+	tenantId: string
+	namespace?: string
+	chunking?: Partial<ChunkingConfig>
+	retrieval?: Partial<RetrievalConfig>
+	embedding?: EmbeddingConfig
 }
 
 export interface KnowledgeBase {
-  readonly id: KnowledgeBaseId
-  readonly config: KnowledgeBaseConfig
+	readonly id: KnowledgeBaseId
+	readonly config: KnowledgeBaseConfig
 
-  ingest(content: string, metadata?: DocumentMetadata): Promise<IngestionResult>
-  remove(documentId: DocumentId): Promise<void>
-  query(query: RetrievalQuery): Promise<RetrievalResult>
-  clear(): Promise<void>
+	ingest(content: string, metadata?: DocumentMetadata): Promise<IngestionResult>
+	remove(documentId: DocumentId): Promise<void>
+	query(query: RetrievalQuery): Promise<RetrievalResult>
+	clear(): Promise<void>
 }

package/src/types/rag/retrieval.ts

@@ -1,35 +1,35 @@
-import type { ThreadId, KnowledgeBaseId } from '../ids/index.js'
+import type { KnowledgeBaseId, ThreadId } from '../ids/index.js'
 import type { TenantScope } from './scope.js'
 import type { VectorSearchResult } from './vector.js'
 
 export type RetrievalMode = 'vector' | 'keyword' | 'hybrid'
 
 export interface RetrievalConfig {
-  mode: RetrievalMode
-  topK: number
-  minScore?: number
-  hybridAlpha?: number
+	mode: RetrievalMode
+	topK: number
+	minScore?: number
+	hybridAlpha?: number
 }
 
 export interface RetrievalQuery {
-  text: string
-  threadId?: ThreadId
-  threadMessages?: string[]
-  config?: Partial<RetrievalConfig>
+	text: string
+	threadId?: ThreadId
+	threadMessages?: string[]
+	config?: Partial<RetrievalConfig>
 }
 
 export interface RetrievalResult {
-  chunks: VectorSearchResult[]
-  query: string
-  expandedQuery?: string
-  mode: RetrievalMode
-  durationMs: number
+	chunks: VectorSearchResult[]
+	query: string
+	expandedQuery?: string
+	mode: RetrievalMode
+	durationMs: number
 }
 
 export interface Retriever {
-  retrieve(
-    query: RetrievalQuery,
-    scope: TenantScope,
-    knowledgeBaseId?: KnowledgeBaseId,
-  ): Promise<RetrievalResult>
+	retrieve(
+		query: RetrievalQuery,
+		scope: TenantScope,
+		knowledgeBaseId?: KnowledgeBaseId,
+	): Promise<RetrievalResult>
 }

package/src/types/rag/scope.ts

@@ -1,13 +1,13 @@
 export interface TenantScope {
-  tenantId: string
-  namespace?: string
+	tenantId: string
+	namespace?: string
 }
 
 export interface DocumentMetadata {
-  source?: string
-  title?: string
-  mimeType?: string
-  language?: string
-  tags?: string[]
-  [key: string]: unknown
+	source?: string
+	title?: string
+	mimeType?: string
+	language?: string
+	tags?: string[]
+	[key: string]: unknown
 }

package/src/types/rag/storage.ts

@@ -1,25 +1,25 @@
-import type { DocumentId, KnowledgeBaseId, ChunkId } from '../ids/index.js'
+import type { ChunkId, DocumentId, KnowledgeBaseId } from '../ids/index.js'
 import type { DocumentMetadata } from './scope.js'
 
 export interface Document {
-  id: DocumentId
-  knowledgeBaseId: KnowledgeBaseId
-  tenantId: string
-  content: string
-  metadata: DocumentMetadata
-  createdAt: number
-  updatedAt: number
+	id: DocumentId
+	knowledgeBaseId: KnowledgeBaseId
+	tenantId: string
+	content: string
+	metadata: DocumentMetadata
+	createdAt: number
+	updatedAt: number
 }
 
 export interface Chunk {
-  id: ChunkId
-  documentId: DocumentId
-  knowledgeBaseId: KnowledgeBaseId
-  tenantId: string
-  content: string
-  index: number
-  tokenCount: number
-  embedding?: number[]
-  metadata: DocumentMetadata
-  createdAt: number
+	id: ChunkId
+	documentId: DocumentId
+	knowledgeBaseId: KnowledgeBaseId
+	tenantId: string
+	content: string
+	index: number
+	tokenCount: number
+	embedding?: number[]
+	metadata: DocumentMetadata
+	createdAt: number
 }

package/src/types/rag/vector.ts

@@ -2,23 +2,23 @@ import type { ChunkId, DocumentId, KnowledgeBaseId } from '../ids/index.js'
 import type { Chunk } from './storage.js'
 
 export interface VectorSearchResult {
-  chunk: Chunk
-  score: number
+	chunk: Chunk
+	score: number
 }
 
 export interface VectorStoreQuery {
-  embedding: number[]
-  topK: number
-  tenantId: string
-  knowledgeBaseId?: KnowledgeBaseId
-  filter?: Record<string, unknown>
-  minScore?: number
+	embedding: number[]
+	topK: number
+	tenantId: string
+	knowledgeBaseId?: KnowledgeBaseId
+	filter?: Record<string, unknown>
+	minScore?: number
 }
 
 export interface VectorStore {
-  upsert(chunks: Chunk[]): Promise<void>
-  search(query: VectorStoreQuery): Promise<VectorSearchResult[]>
-  delete(chunkIds: ChunkId[]): Promise<void>
-  deleteByDocument(documentId: DocumentId): Promise<void>
-  deleteByKnowledgeBase(knowledgeBaseId: KnowledgeBaseId, tenantId: string): Promise<void>
+	upsert(chunks: Chunk[]): Promise<void>
+	search(query: VectorStoreQuery): Promise<VectorSearchResult[]>
+	delete(chunkIds: ChunkId[]): Promise<void>
+	deleteByDocument(documentId: DocumentId): Promise<void>
+	deleteByKnowledgeBase(knowledgeBaseId: KnowledgeBaseId, tenantId: string): Promise<void>
 }

package/src/types/run/config.ts

@@ -1,46 +1,46 @@
-import type { PermissionMode } from '../permission/index.js'
-import type { RunId } from '../ids/index.js'
 import type { ModelPricing } from '../../utils/cost.js'
 import type { Logger } from '../../utils/logger.js'
+import type { RunId } from '../ids/index.js'
+import type { PermissionMode } from '../permission/index.js'
 
 export interface AgentRunConfig {
-  model: string
-  timeoutMs: number
-  maxResponseTokens?: number
-  tokenBudget: number
-  costLimitUsd?: number
-  maxIterations?: number
-  temperature?: number
-  env?: Record<string, string>
-  permissionMode?: PermissionMode
+	model: string
+	timeoutMs: number
+	maxResponseTokens?: number
+	tokenBudget: number
+	costLimitUsd?: number
+	maxIterations?: number
+	temperature?: number
+	env?: Record<string, string>
+	permissionMode?: PermissionMode
 }
 
 export interface RunPersistenceConfig {
-  runId: RunId
-  agentId: string
-  agentName: string
-  sessionConfig: AgentRunConfig
-  providerId: string
-  outputDir: string
-  pricing?: ModelPricing
-  log: Logger
-
-  parentRunId?: RunId
-
-  depth?: number
+	runId: RunId
+	agentId: string
+	agentName: string
+	sessionConfig: AgentRunConfig
+	providerId: string
+	outputDir: string
+	pricing?: ModelPricing
+	log: Logger
+
+	parentRunId?: RunId
+
+	depth?: number
 }
 
 export interface RunStoreConfig {
-  baseDir: string
-  logger?: Logger
+	baseDir: string
+	logger?: Logger
 }
 
 export interface LimitCheckerConfig {
-  tokenBudget: number
-  timeoutMs: number
-  costLimitUsd?: number
-  maxIterations: number
-  budgetWarningThreshold: number
+	tokenBudget: number
+	timeoutMs: number
+	costLimitUsd?: number
+	maxIterations: number
+	budgetWarningThreshold: number
 }
 
 export type SessionConfig = AgentRunConfig