@1mbrain/sdk 0.1.0 → 0.1.3

package/dist/hermes.d.ts

@@ -1,185 +0,0 @@
-/**
- * @1mbrain/hermes-adapter
- *
- * NOTE: This is an optional convenience wrapper tailored specifically for the Hermes
- * agent framework. It serves as a reference/blueprint. For other frameworks or gateways,
- * use the generic `OneMBrainClient` directly from '@1mbrain/sdk'.
- *
- * Hermes context objects are automatically mapped to the correct 1MBrain memory type,
- * importance score, and metadata tags, so you never have to think about them in your
- * agent code.
- *
- * Quick start:
- *
- * ```ts
- * import { HermesMemoryAdapter } from '@1mbrain/sdk/hermes';
- *
- * const memory = new HermesMemoryAdapter({
- *   apiUrl: process.env.ONEMILLION_API_URL!,
- *   apiKey: process.env.ONEMILLION_API_KEY!,
- *   agentId: 'hermes-agent-1',     // your instance name/namespace
- *   defaultImportance: 0.6,
- * });
- *
- * // Store an episodic memory from a conversation turn
- * await memory.rememberTurn({
- *   userMessage: "What is VibeAman pricing?",
- *   assistantReply: "VibeAman starts at Rp 150k/month.",
- * });
- *
- * // Store a persistent user preference
- * await memory.rememberPreference('preferred_language', 'Bahasa Indonesia');
- *
- * // Store a procedural pattern
- * await memory.rememberProcedure('push_to_github', 'Create PRD → push markdown deliverable');
- *
- * // Recall with automatic context enrichment
- * const results = await memory.recall('pricing');
- * ```
- */
-import type { AssociateInput, Memory, SearchResult } from './index.js';
-export interface HermesMemoryAdapterConfig {
-    apiUrl: string;
-    apiKey: string;
-    agentId?: string;
-    /** Default importance score for new memories (0–1). Defaults to 0.6. */
-    defaultImportance?: number;
-    /** Custom fetch implementation (useful in Cloudflare Workers / Edge). */
-    fetch?: typeof fetch;
-}
-export interface HermesTurn {
-    /** The raw user message from the current conversation turn. */
-    userMessage: string;
-    /** The assistant reply that was generated for this turn. */
-    assistantReply?: string;
-    /** Optional topic tags to attach to this episodic memory. */
-    topics?: string[];
-    /** Optional conversation / session ID for grouping. */
-    sessionId?: string;
-}
-export interface HermesRecallOptions {
-    /** Maximum number of results (default: 8). */
-    limit?: number;
-    /**
-     * Restrict recall to a specific memory type.
-     * When omitted, all types are searched.
-     */
-    type?: 'episodic' | 'semantic' | 'procedural' | 'entity' | 'warning';
-    /** Filter by tags. */
-    tags?: string[];
-    /** Number of graph hops for spreading activation (default: 2). */
-    maxHops?: number;
-    /**
-     * If provided, override the default agentId for this call.
-     * Useful when querying another Hermes instance's memory.
-     */
-    agentId?: string;
-}
-export declare class HermesMemoryAdapter {
-    private readonly client;
-    private readonly defaultImportance;
-    private readonly agentId?;
-    constructor(config: HermesMemoryAdapterConfig);
-    /**
-     * Store a conversation turn as an episodic memory.
-     * The content is formatted as a Q&A pair for rich recall later.
-     */
-    rememberTurn(turn: HermesTurn, agentId?: string): Promise<Memory>;
-    /**
-     * Store a durable user preference as a semantic memory.
-     * Semantic memories don't decay as fast and are weighted higher on recall.
-     */
-    rememberPreference(key: string, value: string, agentId?: string): Promise<Memory>;
-    /**
-     * Store a learned behavioural pattern or workflow as a procedural memory.
-     * Procedural memories carry high importance by default.
-     */
-    rememberProcedure(name: string, pattern: string, agentId?: string): Promise<Memory>;
-    /**
-     * General-purpose remember — uses sensible Hermes defaults.
-     * Delegates directly to the underlying SDK client.
-     */
-    remember(content: string, options?: {
-        type?: 'episodic' | 'semantic' | 'procedural';
-        importance?: number;
-        tags?: string[];
-        agentId?: string;
-    }): Promise<Memory>;
-    /**
-     * Recall memories relevant to the given query.
-     * Automatically uses spreading activation (2 hops) for richer results.
-     */
-    recall(query: string, options?: HermesRecallOptions): Promise<SearchResult[]>;
-    /**
-     * Recall only episodic memories (conversation history).
-     */
-    recallHistory(query: string, limit?: number, agentId?: string): Promise<SearchResult[]>;
-    /**
-     * Recall only semantic memories (facts & preferences).
-     */
-    recallFacts(query: string, limit?: number, agentId?: string): Promise<SearchResult[]>;
-    /**
-     * Recall only procedural memories (learned workflows).
-     */
-    recallProcedures(query: string, limit?: number, agentId?: string): Promise<SearchResult[]>;
-    /** Hard-delete a memory by ID. */
-    forget(memoryId: string, agentId?: string): Promise<boolean>;
-    /** Create an explicit association between two memories. */
-    associate(sourceId: string, targetId: string, strength?: number, agentId?: string, relationType?: AssociateInput['relationType']): Promise<boolean>;
-    /**
-     * Build a formatted memory context block for injection into an LLM system prompt.
-     *
-     * Returns a markdown-formatted string listing the most relevant memories
-     * so Hermes can surface them to the model without manual formatting.
-     *
-     * @example
-     * const ctx = await memory.buildContext('user preferences');
-     * systemPrompt = `${baseSystemPrompt}\n\n${ctx}`;
-     */
-    buildContext(query: string, limit?: number, agentId?: string): Promise<string>;
-    /**
-     * Ingest a web page URL and store its factual content as memories.
-     *
-     * The server-side pipeline automatically:
-     * 1. Fetches the URL
-     * 2. Converts HTML → Markdown (noise stripped)
-     * 3. Chunks the content
-     * 4. Extracts factual claims via LLM (using your configured provider)
-     * 5. Stores facts with type/importance/metadata auto-set
-     * 6. Deduplicates (won't re-ingest the same page content twice)
-     *
-     * Works from any gateway: Telegram, Discord, browser extension, CLI.
-     *
-     * @example
-     * // Telegram bot handler
-     * if (message.startsWith('/learn ')) {
-     *   const url = message.slice(7).trim();
-     *   const result = await memory.learnFromUrl(url);
-     *   return `✅ Learned ${result.storedCount} facts from "${result.title}"`;
-     * }
-     */
-    learnFromUrl(url: string, options?: {
-        agentId?: string;
-        confidenceThreshold?: number;
-        maxChunkChars?: number;
-        deduplicate?: boolean;
-    }): Promise<{
-        ok: boolean;
-        title: string;
-        url: string;
-        storedCount: number;
-        deduplicated: boolean;
-        memoryIds: string[];
-        error?: string;
-    }>;
-    /**
-     * Recall memories that were ingested from a specific source domain or URL pattern.
-     *
-     * Uses the `domain:` tag automatically added during ingestion.
-     *
-     * @example
-     * const newsFromKompas = await memory.recallFromSource('kompas.com', 'AI regulation');
-     */
-    recallFromSource(domain: string, query: string, limit?: number, agentId?: string): Promise<SearchResult[]>;
-}
-//# sourceMappingURL=hermes.d.ts.map

package/dist/hermes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hermes.d.ts","sourceRoot":"","sources":["../src/hermes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAMvE,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,CAAC;IACrE,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;gBAEtB,MAAM,EAAE,yBAAyB;IAe7C;;;OAGG;IACG,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBvE;;;OAGG;IACG,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUvF;;;OAGG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUzF;;;OAGG;IACG,QAAQ,CACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC;QAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KACb,GACL,OAAO,CAAC,MAAM,CAAC;IAclB;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAUvF;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAIxF;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAItF;;OAEG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAQ3F,kCAAkC;IAC5B,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQlE,2DAA2D;IACrD,SAAS,CACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,SAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,YAAY,GAAE,cAAc,CAAC,cAAc,CAAgB,GAC1D,OAAO,CAAC,OAAO,CAAC;IAQnB;;;;;;;;;OASG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkB/E;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,YAAY,CAChB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,OAAO,CAAC;KAClB,GACL,OAAO,CAAC;QACT,EAAE,EAAE,OAAO,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,OAAO,CAAC;QACtB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAmBF;;;;;;;OAOG;IACG,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,KAAK,SAAI,EACT,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,EAAE,CAAC;CAO3B"}

package/dist/index.d.ts

@@ -1,99 +0,0 @@
-import type { CreateAssociationInput, CreateMemoryInput, Memory, SearchMemoryInput, SearchResult } from '@1mbrain/core';
-export interface OneMBrainClientConfig {
-    apiUrl: string;
-    apiKey: string;
-    agentId?: string;
-    fetch?: typeof fetch;
-}
-export type RememberInput = Omit<CreateMemoryInput, 'agentId'> & {
-    agentId?: string;
-};
-export type RecallInput = Omit<SearchMemoryInput, 'agentId'> & {
-    agentId?: string;
-};
-export type AssociateInput = Omit<CreateAssociationInput, 'sourceId' | 'agentId'> & {
-    agentId?: string;
-};
-export interface IngestUrlOptions {
-    agentId?: string;
-    confidenceThreshold?: number;
-    maxChunkChars?: number;
-    deduplicate?: boolean;
-}
-export interface IngestResult {
-    title: string;
-    url: string;
-    sourceHash: string;
-    chunkCount: number;
-    extractedCount: number;
-    storedCount: number;
-    skippedCount: number;
-    errorCount: number;
-    deduplicated: boolean;
-    memoryIds: string[];
-}
-export interface ConsolidateOptions {
-    agentId?: string;
-    dryRun?: boolean;
-    clusterStrategy?: 'tags' | 'graph' | 'hybrid';
-}
-export interface ConsolidationResult {
-    agentId: string;
-    triggerReason: 'sleep-cycle' | 'threshold';
-    dryRun: boolean;
-    storedCount: number;
-    archivedCount: number;
-    clustersProcessed: number;
-    skipped: {
-        noCandidates: number;
-        tooSmallClusters: number;
-        summarizationFailed: number;
-        dryRun: number;
-    };
-    errors: string[];
-    summaryIds: string[];
-}
-export interface ApiEnvelope<T> {
-    success: boolean;
-    data: T;
-    meta?: Record<string, unknown>;
-    message?: string;
-}
-export declare class OneMBrainError extends Error {
-    readonly status: number;
-    readonly details?: unknown | undefined;
-    constructor(message: string, status: number, details?: unknown | undefined);
-}
-export declare class OneMBrainClient {
-    private readonly apiUrl;
-    private readonly apiKey;
-    private readonly agentId?;
-    private readonly fetchFn;
-    constructor(config: OneMBrainClientConfig);
-    remember(input: RememberInput): Promise<Memory>;
-    recall(input: RecallInput): Promise<SearchResult[]>;
-    forget(id: string, options?: {
-        agentId?: string;
-    }): Promise<boolean>;
-    associate(sourceId: string, input: AssociateInput): Promise<boolean>;
-    /**
-     * Ingest a web page URL into memory.
-     *
-     * The server-side pipeline will:
-     * 1. Fetch the page HTML
-     * 2. Extract main content → Markdown
-     * 3. Chunk and extract factual claims via LLM
-     * 4. Store facts as memories (type, importance, metadata auto-set)
-     *
-     * Works from any gateway: Telegram, Discord, browser extension, CLI.
-     *
-     * @param url - The URL to ingest
-     * @param options - Optional overrides (agentId, confidenceThreshold, etc.)
-     */
-    ingestUrl(url: string, options?: IngestUrlOptions): Promise<IngestResult>;
-    consolidate(options?: ConsolidateOptions): Promise<ConsolidationResult>;
-    private resolveAgentId;
-    private request;
-}
-export type { Memory, SearchResult };
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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