@loom-node/core 0.1.0

package/dist/types/memory.d.ts

@@ -0,0 +1,44 @@
+import type { Message } from './message.js';
+export interface MemoryLayer {
+    readonly name: string;
+    readonly tokenBudget: number;
+    readonly currentTokens: number;
+    store(entry: MemoryEntry): Promise<void>;
+    retrieve(query: string, limit: number): Promise<MemoryEntry[]>;
+    evict(): Promise<MemoryEntry[]>;
+    rescore?(context: Message[]): Promise<void>;
+}
+export interface MemoryEntry {
+    id: string;
+    content: string;
+    tokens: number;
+    importance: number;
+    metadata: Record<string, unknown>;
+    createdAt: number;
+}
+export interface MemoryManager {
+    buildContext(input: string): Promise<Message[]>;
+    persist(messages: Message[]): Promise<void>;
+}
+export interface PersistentStore {
+    save(entry: MemoryEntry): Promise<void>;
+    search(query: string, opts: SearchOptions): Promise<MemoryEntry[]>;
+    delete(id: string): Promise<void>;
+}
+export interface SearchOptions {
+    limit: number;
+    mode: 'semantic' | 'keyword' | 'hybrid';
+    filter?: Record<string, unknown>;
+}
+export interface MemoryCompressor {
+    /** Compress multiple entries into a single summary entry */
+    compress(entries: MemoryEntry[]): Promise<MemoryEntry>;
+}
+export interface ImportanceScorer {
+    score(entry: MemoryEntry, context: Message[]): Promise<number>;
+}
+export interface Tokenizer {
+    count(text: string): number;
+    truncate(text: string, maxTokens: number): string;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/types/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/types/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG5C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/D,KAAK,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAChC,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAGD,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACnE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAGD,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACxD;AAGD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CACnD"}

package/dist/types/memory.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memory.js.map

package/dist/types/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/types/memory.ts"],"names":[],"mappings":""}

package/dist/types/message.d.ts

@@ -0,0 +1,30 @@
+export type Message = SystemMessage | UserMessage | AssistantMessage | ToolMessage;
+export interface SystemMessage {
+    role: 'system';
+    content: string;
+}
+export interface UserMessage {
+    role: 'user';
+    content: string | ContentPart[];
+}
+export interface AssistantMessage {
+    role: 'assistant';
+    content: string;
+    toolCalls?: ToolCall[];
+}
+export interface ToolMessage {
+    role: 'tool';
+    toolCallId: string;
+    content: string;
+}
+export interface ContentPart {
+    type: 'text' | 'image';
+    text?: string;
+    imageUrl?: string;
+}
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: string;
+}
+//# sourceMappingURL=message.d.ts.map

package/dist/types/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/types/message.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,OAAO,GACf,aAAa,GACb,WAAW,GACX,gBAAgB,GAChB,WAAW,CAAC;AAEhB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/message.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=message.js.map

package/dist/types/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../src/types/message.ts"],"names":[],"mappings":""}

package/dist/types/skill.d.ts

@@ -0,0 +1,58 @@
+import type { ToolDefinition } from './tool.js';
+import type { ContextFragment } from './context.js';
+export type ActivationLevel = 'always' | 'conditional' | 'on-demand';
+export interface Skill {
+    name: string;
+    description: string;
+    instructions: string;
+    activationLevel: ActivationLevel;
+    tools?: ToolDefinition[];
+    examples?: SkillExample[];
+    trigger?: SkillTrigger;
+    priority?: number;
+    tokenBudget?: number;
+    metadata?: Record<string, unknown>;
+    onActivate?(): Promise<void> | void;
+    onDeactivate?(): Promise<void> | void;
+    provideContext?(query: string, budget: number): Promise<ContextFragment[]>;
+}
+export interface SkillExample {
+    input: string;
+    output: string;
+}
+export type SkillTrigger = KeywordTrigger | PatternTrigger | SemanticTrigger | CustomTrigger;
+export interface KeywordTrigger {
+    type: 'keyword';
+    keywords: string[];
+    matchAll?: boolean;
+}
+export interface PatternTrigger {
+    type: 'pattern';
+    pattern: string;
+}
+export interface SemanticTrigger {
+    type: 'semantic';
+    description: string;
+    threshold?: number;
+}
+export interface CustomTrigger {
+    type: 'custom';
+    match: (input: string) => boolean | Promise<boolean>;
+}
+export interface SkillActivation {
+    skill: Skill;
+    score: number;
+    reason: string;
+}
+export interface SkillRegistry {
+    register(skill: Skill): void;
+    get(name: string): Skill | undefined;
+    all(): Skill[];
+    activate(input: string): Promise<SkillActivation[]>;
+    getActive(): Skill[];
+    deactivate(name: string): Promise<void>;
+}
+export interface SkillLoader {
+    load(): Promise<Skill[]>;
+}
+//# sourceMappingURL=skill.d.ts.map

package/dist/types/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/types/skill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,aAAa,GAAG,WAAW,CAAC;AAGrE,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,eAAe,CAAC;IACjC,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtC,cAAc,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,MAAM,YAAY,GACpB,cAAc,GACd,cAAc,GACd,eAAe,GACf,aAAa,CAAC;AAElB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtD;AAGD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;IACrC,GAAG,IAAI,KAAK,EAAE,CAAC;IACf,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACpD,SAAS,IAAI,KAAK,EAAE,CAAC;IACrB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAGD,MAAM,WAAW,WAAW;IAC1B,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;CAC1B"}

package/dist/types/skill.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=skill.js.map

package/dist/types/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/types/skill.ts"],"names":[],"mappings":""}

package/dist/types/strategy.d.ts

@@ -0,0 +1,25 @@
+import type { Message } from './message.js';
+import type { AgentEvent } from './events.js';
+import type { LLMProvider } from './llm.js';
+import type { ToolDefinition, ToolExecutionConfig } from './tool.js';
+import type { InterceptorChain } from '../interceptor/interceptor.js';
+import type { TypedEventBus } from '../events/event-bus.js';
+export interface LoopContext {
+    messages: Message[];
+    provider: LLMProvider;
+    tools: ToolDefinition[];
+    interceptors?: InterceptorChain;
+    events?: TypedEventBus;
+    systemPrompt?: string;
+    maxSteps: number;
+    signal?: AbortSignal;
+    toolConfig?: ToolExecutionConfig;
+    streaming?: boolean;
+    sessionId?: string;
+    tenantId?: string;
+}
+export interface LoopStrategy {
+    readonly name: string;
+    execute(ctx: LoopContext): AsyncGenerator<AgentEvent>;
+}
+//# sourceMappingURL=strategy.d.ts.map

package/dist/types/strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../../src/types/strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;CACvD"}

package/dist/types/strategy.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=strategy.js.map

package/dist/types/strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.js","sourceRoot":"","sources":["../../src/types/strategy.ts"],"names":[],"mappings":""}

package/dist/types/tool.d.ts

@@ -0,0 +1,31 @@
+import type { JsonSchema } from './llm.js';
+export interface ToolSchema<T = unknown> {
+    parse(input: unknown): T;
+    toJsonSchema(): JsonSchema;
+}
+export interface ToolDefinition<TInput = unknown, TOutput = unknown> {
+    name: string;
+    description: string;
+    parameters: ToolSchema<TInput>;
+    execute: (input: TInput, ctx: ToolContext) => Promise<TOutput>;
+}
+export interface ToolContext {
+    signal?: AbortSignal;
+    sessionId?: string;
+    tenantId?: string;
+}
+export interface ToolExecutionConfig {
+    timeoutMs: number;
+    maxResultBytes: number;
+    maxConcurrency: number;
+}
+export interface ToolResult {
+    toolCallId: string;
+    toolName: string;
+    success: boolean;
+    result?: unknown;
+    error?: Error;
+    durationMs: number;
+    tokenCost: number;
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/types/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/types/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC;IACzB,YAAY,IAAI,UAAU,CAAC;CAC5B;AAGD,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/tool.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool.js.map

package/dist/types/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/types/tool.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@loom-node/core",
+  "version": "0.1.0",
+  "description": "Loom-Node core abstractions - zero external dependencies",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}