@almadar/agent 1.6.4 → 2.0.0

package/dist/persistence/index.d.ts

@@ -1,201 +0,0 @@
-import { S as SessionMetadata, e as SessionRecord, b as FirestoreDb, d as Session } from '../firestore-checkpointer-CkNKXoun.js';
-export { F as FirestoreCheckpointer, a as FirestoreCheckpointerOptions, c as FirestoreTimestamp, P as PersistenceMode } from '../firestore-checkpointer-CkNKXoun.js';
-import { BaseStore, Operation, OperationResults } from '@langchain/langgraph-checkpoint';
-import '@langchain/core/runnables';
-
-/**
- * In-Memory Persistence Backend
- *
- * Provides in-memory session metadata storage for development.
- * Data is lost on process restart.
- */
-
-/**
- * In-memory session metadata store.
- */
-declare class MemorySessionBackend {
-    private sessions;
-    /**
-     * Store session metadata.
-     */
-    store(threadId: string, metadata: SessionMetadata): void;
-    /**
-     * Get session metadata.
-     */
-    get(threadId: string): SessionMetadata | undefined;
-    /**
-     * Delete session metadata.
-     */
-    delete(threadId: string): boolean;
-    /**
-     * List all sessions.
-     */
-    list(): SessionRecord[];
-    /**
-     * Check if a session exists.
-     */
-    has(threadId: string): boolean;
-}
-
-/**
- * Firestore Session Store for DeepAgent
- *
- * Provides persistent session storage for skill-based agents.
- * Sessions are stored in Firestore and persist across server restarts.
- *
- * IMPORTANT: This module does NOT import firebase-admin directly.
- * The Firestore `db` instance must be injected via constructor options.
- */
-
-/**
- * Options for FirestoreSessionStore.
- */
-interface FirestoreSessionStoreOptions {
-    /**
-     * Firestore instance. Required — injected by consumer.
-     */
-    db: FirestoreDb;
-    /**
-     * Collection name for sessions.
-     * @default 'agent_sessions'
-     */
-    collection?: string;
-}
-/**
- * Firestore-backed session store for skill agents.
- *
- * @example
- * ```typescript
- * const sessionStore = new FirestoreSessionStore({ db: getFirestore() });
- *
- * await sessionStore.save({
- *   threadId: 'abc-123',
- *   skill: 'kflow-generating-m',
- *   workDir: '/tmp/workspace',
- *   createdAt: new Date(),
- *   lastActivityAt: new Date(),
- * });
- *
- * const session = await sessionStore.get('abc-123');
- * ```
- */
-declare class FirestoreSessionStore {
-    private db;
-    private collection;
-    constructor(options: FirestoreSessionStoreOptions);
-    /**
-     * Save a session.
-     */
-    save(session: Session): Promise<void>;
-    /**
-     * Get a session by thread ID.
-     */
-    get(threadId: string): Promise<Session | null>;
-    /**
-     * Update session's last activity timestamp.
-     */
-    touch(threadId: string): Promise<void>;
-    /**
-     * Delete a session.
-     */
-    delete(threadId: string): Promise<void>;
-    /**
-     * List sessions, optionally filtered by user ID.
-     */
-    list(options?: {
-        userId?: string;
-        limit?: number;
-    }): Promise<Session[]>;
-    /**
-     * Delete expired sessions (older than specified hours).
-     */
-    deleteExpired(maxAgeHours?: number): Promise<number>;
-}
-
-/**
- * Firestore Store for LangGraph
- *
- * Custom implementation of BaseStore using Firebase Firestore.
- * This provides persistent key-value storage for agent memories.
- *
- * IMPORTANT: This module does NOT import firebase-admin directly.
- * The Firestore `db` instance must be injected via constructor options.
- */
-
-/**
- * Options for FirestoreStore.
- */
-interface FirestoreStoreOptions {
-    /**
-     * Firestore instance. Required — injected by consumer.
-     */
-    db: FirestoreDb;
-    /**
-     * Collection name for store items.
-     * @default 'agent_memories'
-     */
-    collection?: string;
-}
-/**
- * Firestore-backed store for LangGraph agent memories.
- *
- * Provides persistent key-value storage that can be shared across threads.
- * Items are organized by hierarchical namespaces.
- *
- * @example
- * ```typescript
- * import { getFirestore } from 'firebase-admin/firestore';
- *
- * const store = new FirestoreStore({
- *   db: getFirestore(),
- *   collection: 'agent_memories',
- * });
- *
- * // Store a memory
- * await store.put(['agent', 'patterns'], 'schema-best-practices', {
- *   content: 'Always validate schemas before saving',
- * });
- *
- * // Retrieve a memory
- * const item = await store.get(['agent', 'patterns'], 'schema-best-practices');
- * ```
- */
-declare class FirestoreStore extends BaseStore {
-    private db;
-    private collection;
-    constructor(options: FirestoreStoreOptions);
-    /**
-     * Create document ID from namespace and key.
-     */
-    private makeDocId;
-    /**
-     * Create namespace key for querying.
-     */
-    private makeNamespaceKey;
-    /**
-     * Execute multiple operations in a batch.
-     */
-    batch<Op extends Operation[]>(operations: Op): Promise<OperationResults<Op>>;
-    /**
-     * Get an item by namespace and key.
-     */
-    private getItem;
-    /**
-     * Put an item.
-     */
-    private putItem;
-    /**
-     * Delete an item.
-     */
-    private deleteItem;
-    /**
-     * Search for items.
-     */
-    private searchItems;
-    /**
-     * List namespaces.
-     */
-    private listNamespacesItems;
-}
-
-export { FirestoreDb, FirestoreSessionStore, type FirestoreSessionStoreOptions, FirestoreStore, type FirestoreStoreOptions, MemorySessionBackend, Session, SessionMetadata, SessionRecord };

package/dist/tools/index.d.ts

@@ -1,8 +0,0 @@
-export { a as DomainOrbitalCompleteCallback, D as DomainOrbitalEventCallback, b as DomainOrbitalSpec, c as DomainOrbitalToolOptions, O as OrbitalCompleteCallback, d as OrbitalRequirements, e as OrbitalSubagentToolOptions, S as SubagentEventCallback, f as createConstructCombinedDomainTool, g as createDomainOrbitalTools, h as createGenerateOrbitalDomainTool, i as createOrbitalSubagentTool, j as createSubagentEventWrapper } from '../orbital-subagent-BdFuf77p.js';
-export { B as BatchCompleteCallback, S as BatchSubagentEventCallback, G as GitHubToolsConfig, s as OrbitalBatchSubagentToolOptions, t as OrchestratedFixingOptions, u as OrchestratedFixingResult, w as OrchestratedGenerationOptions, x as OrchestratedGenerationResult, T as TraitCompleteCallback, d as TraitEventCallback, e as TraitSpec, f as TraitSubagentToolOptions, g as createAgentTools, h as createApplyChunkTool, i as createCombineSchemasTool, y as createComplexityCheckTool, j as createExecuteTool, k as createExtractChunkTool, l as createFinishTaskTool, m as createGenerateSchemaTool, z as createGitHubTools, C as createGitHubToolsArray, D as createOrbitalBatchSubagentTool, E as createOrchestratedFixingTool, F as createOrchestratedGenerationTool, n as createQuerySchemaStructureTool, o as createSchemaChunkingTools, p as createTraitEventWrapper, q as createTraitSubagentTool, r as createValidateSchemaTool, H as createValidateTool, v as validateCommandPaths } from '../index-DW3F-Ihx.js';
-import '@langchain/core/tools';
-import 'zod';
-import '@almadar/llm';
-import '../api-types-CXrq-fts.js';
-import '@almadar/core/types';
-import '@almadar/core';

package/dist/types.d.ts

@@ -1,170 +0,0 @@
-import { FullOrbitalUnit, OrbitalSchema, OrbitalDefinition } from '@almadar/core/types';
-import { LLMClient } from '@almadar/llm';
-
-/**
- * @almadar/agent Types
- *
- * Core types for the agent package.
- *
- * LLM access is provided by @almadar/llm (imported directly).
- * Skill prompts are provided by @almadar/skills (imported directly).
- *
- * Only builder-specific modules that don't exist as almadar packages
- * use dependency injection via AgentDependencies.
- *
- * @packageDocumentation
- */
-
-/**
- * Options for combining orbitals into a schema.
- */
-interface CombinerOptions {
-    name: string;
-    description?: string;
-    version?: string;
-    theme?: string;
-    defaultRoute?: string;
-    validate?: boolean;
-}
-/**
- * Result from combining orbitals.
- */
-interface CombinerResult {
-    success: boolean;
-    schema?: OrbitalSchema;
-    error?: string;
-    stats?: {
-        totalOrbitals: number;
-        totalEntities: number;
-        totalPages: number;
-        totalTraits: number;
-    };
-    validation?: {
-        valid: boolean;
-        errors: Array<{
-            code: string;
-            path: string;
-            message: string;
-        }>;
-        warnings: Array<{
-            code: string;
-            path: string;
-            message: string;
-        }>;
-    };
-}
-/**
- * Function signature for combining orbitals.
- */
-type CombineOrbitalsFn = (orbitals: FullOrbitalUnit[], options: CombinerOptions) => CombinerResult;
-/**
- * Result from converting domain language to schema.
- */
-interface DomainConversionResult {
-    success: boolean;
-    schema?: OrbitalSchema;
-    errors?: Array<{
-        message: string;
-    }>;
-}
-/**
- * Function signature for converting domain text to schema.
- */
-type ConvertDomainToSchemaFn = (domainText: string, baseSchema: {
-    name: string;
-    orbitals: unknown[];
-}) => DomainConversionResult;
-/**
- * Log entry from orbital generation.
- */
-interface GenerationLog {
-    level: 'info' | 'warn' | 'error' | 'debug';
-    message: string;
-    data?: Record<string, unknown>;
-}
-/**
- * Result from orbital generation.
- */
-interface OrbitalGenerationResult {
-    orbital: unknown;
-    fingerprint?: string;
-    usedTemplate?: boolean;
-    usage?: {
-        totalTokens: number;
-        inputTokens?: number;
-        outputTokens?: number;
-    };
-    validation?: {
-        valid: boolean;
-        errors?: Array<{
-            code: string;
-            path: string;
-            message: string;
-        }>;
-    };
-}
-/**
- * Options for orbital generation.
- */
-interface OrbitalGenerationOptions {
-    validate?: boolean;
-    requirements?: {
-        entities?: string[];
-        states?: string[];
-        events?: string[];
-        guards?: string[];
-        pages?: string[];
-        effects?: string[];
-        rawRequirements?: string[];
-    };
-    onLog?: (log: GenerationLog) => void;
-}
-/**
- * Function signature for generating a full orbital.
- * Accepts LLMClient from @almadar/llm directly.
- */
-type GenerateFullOrbitalFn = (client: LLMClient, orbital: OrbitalDefinition, options?: OrbitalGenerationOptions) => Promise<OrbitalGenerationResult>;
-/**
- * @deprecated AgentDependencies is no longer needed. All functions are now
- * internal to @almadar/agent. Import them directly:
- * - combineOrbitals from '@almadar/agent'
- * - convertDomainToSchema from '@almadar/agent'
- * - generateFullOrbital from '@almadar/agent'
- *
- * @example Old (deprecated):
- * ```typescript
- * const deps: AgentDependencies = { ... };
- * const tools = createAgentTools('/workspace', deps);
- * ```
- *
- * @example New:
- * ```typescript
- * import { createAgentTools } from '@almadar/agent';
- * const tools = createAgentTools('/workspace');
- * ```
- */
-interface AgentDependencies {
-    /**
-     * @deprecated Use combineOrbitals from '@almadar/agent' instead
-     */
-    combineOrbitals: CombineOrbitalsFn;
-    /**
-     * @deprecated Use convertDomainToSchema from '@almadar/agent' instead
-     */
-    convertDomainToSchema: ConvertDomainToSchemaFn;
-    /**
-     * @deprecated Use generateFullOrbital from '@almadar/agent' instead
-     */
-    generateFullOrbital: GenerateFullOrbitalFn;
-}
-/**
- * Subagent configuration.
- * Compatible with the deepagents library SubAgent type.
- */
-interface SubAgent {
-    name: string;
-    description: string;
-    systemPrompt: string;
-}
-
-export type { AgentDependencies, CombineOrbitalsFn, CombinerOptions, CombinerResult, ConvertDomainToSchemaFn, DomainConversionResult, GenerateFullOrbitalFn, GenerationLog, OrbitalGenerationOptions, OrbitalGenerationResult, SubAgent };