@loom-framework/core 0.1.0-alpha.1

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * Loom Core - Main Entry Point
+ */
+// Config
+export { defineConfig, loadConfig, resolveConfigPath, getModelSchema, validateModelUniqueness, LoomConfigSchema } from './config.js';
+// DataAdapter
+export { FileSystemAdapter } from './adapter-filesystem.js';
+export { SQLiteAdapter } from './adapter-sqlite.js';
+// Capability Generator
+export { generateCapabilities } from './capability-generator.js';
+// Command Framework
+export { defineCommand } from './commands.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkCH,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAErI,cAAc;AACd,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,uBAAuB;AACvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGjE,oBAAoB;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Loom Core - Framework types and interfaces
+ *
+ * 编织 AI 能力为应用织物
+ * Skill = 纹理, CLI = 梭子, Data = 纱线, AI = 织力
+ */
+export type FieldType = 'string' | 'number' | 'boolean' | 'date' | 'string[]' | 'number[]' | 'json';
+export interface FieldDefinition {
+    name: string;
+    type: FieldType;
+    required?: boolean;
+    description?: string;
+    default?: unknown;
+    /** For string fields: enum of allowed values */
+    enum?: string[];
+}
+export interface IndexDefinition {
+    fields: string[];
+    unique?: boolean;
+}
+export interface FilesystemAdapterConfig {
+    dir: string;
+    format: 'json' | 'yaml';
+    /** Date pattern in dir path, e.g. 'YYYY-MM' for work-logs/YYYY-MM/ */
+    datePattern?: string;
+}
+export interface SQLiteAdapterConfig {
+    table: string;
+}
+export interface ModelAdapterConfig {
+    filesystem?: FilesystemAdapterConfig;
+    sqlite?: SQLiteAdapterConfig;
+}
+export interface ModelSchema {
+    name: string;
+    fields: FieldDefinition[];
+    indexes?: IndexDefinition[];
+    adapters?: ModelAdapterConfig;
+    description?: string;
+}
+export interface AIButtonConfig {
+    id: string;
+    label: string;
+    icon?: string;
+    /** Static prompt text */
+    prompt?: string;
+    /** Dynamic prompt template with {{var}} placeholders */
+    promptTemplate?: string;
+    /** Required context variables for promptTemplate */
+    contextVars?: string[];
+    /** Which page this button appears on */
+    placement?: string;
+}
+export interface ClaudeCodeConfig {
+    path?: string;
+    pluginRoot?: string;
+    timeout?: number;
+    skipPermissions?: boolean;
+    defaultModel?: string;
+}
+export interface AIConfig {
+    engine?: string;
+    claudeCode?: ClaudeCodeConfig;
+}
+export interface ServerConfig {
+    port?: number;
+    host?: string;
+    cors?: boolean;
+    staticDir?: string;
+}
+export interface DataConfig {
+    defaultAdapter: 'filesystem' | 'sqlite';
+    models: ModelSchema[];
+    /** SQLite specific config */
+    sqlite?: {
+        filename?: string;
+    };
+}
+export interface LoomConfig {
+    project: {
+        name: string;
+        description?: string;
+    };
+    data: DataConfig;
+    ai?: AIConfig;
+    server?: ServerConfig;
+    aiButtons?: AIButtonConfig[];
+}
+export interface ReadOptions {
+    id?: string;
+    filter?: Record<string, unknown>;
+    limit?: number;
+    offset?: number;
+}
+export interface DataAdapter {
+    readonly name: string;
+    read(model: string, options?: ReadOptions): Promise<unknown>;
+    write(model: string, data: Record<string, unknown>): Promise<unknown>;
+    update(model: string, id: string, data: Record<string, unknown>): Promise<unknown>;
+    delete(model: string, id: string): Promise<void>;
+    getSchema(model: string): Promise<ModelSchema | undefined>;
+    listModels(): Promise<string[]>;
+    initialize(): Promise<void>;
+    healthCheck(): Promise<boolean>;
+}
+export interface CommandOption {
+    type: 'string' | 'number' | 'boolean' | 'json' | 'string[]';
+    required?: boolean;
+    description?: string;
+    default?: unknown;
+    alias?: string;
+}
+export interface CommandDefinition {
+    name: string;
+    description: string;
+    options?: Record<string, CommandOption>;
+    execute(args: Record<string, unknown>, context: CommandContext): Promise<string | void>;
+}
+export interface CommandContext {
+    config: LoomConfig;
+    configPath: string;
+    projectRoot: string;
+    getDataAdapter(): DataAdapter;
+}
+export interface AICallOptions {
+    sessionId: string;
+    resumeSessionId?: string;
+    model?: string;
+    files?: Array<{
+        name: string;
+        path: string;
+    }>;
+    timeout?: number;
+}
+export interface AIUsage {
+    inputTokens: number;
+    outputTokens: number;
+    contextWindow: number;
+}
+export interface AIChunk {
+    type: 'content' | 'session_info' | 'error' | 'done';
+    content?: string;
+    sessionId?: string;
+    usage?: AIUsage;
+    error?: string;
+}
+export interface AIEngine {
+    readonly name: string;
+    call(prompt: string, options: AICallOptions): AsyncGenerator<AIChunk>;
+}
+export interface ActiveSession {
+    id: string;
+    claudeSessionId?: string;
+    lastActivity: number;
+    createdAt: number;
+}
+export interface UserMessageEvent {
+    type: 'user_message';
+    content: string;
+    session_id: string;
+    timestamp: string;
+    /** AI button ID — when set, server resolves prompt from config instead of using content */
+    buttonId?: string;
+    /** Context variables for promptTemplate substitution (e.g. { selectedMember: "张三" }) */
+    context?: Record<string, string>;
+    files?: Array<{
+        uid: string;
+        name: string;
+        size: number;
+        type: string;
+        content?: string;
+    }>;
+}
+export interface AssistantChunkEvent {
+    type: 'assistant_chunk';
+    content: string;
+    message_id: string;
+    session_id: string;
+    is_complete: false;
+}
+export interface AssistantCompleteEvent {
+    type: 'assistant_complete';
+    content: string;
+    message_id: string;
+    session_id: string;
+    is_complete: true;
+    structured_data?: unknown;
+    usage?: AIUsage;
+}
+export interface ToolCallEvent {
+    type: 'tool_call';
+    tool: string;
+    status: 'started' | 'completed' | 'error';
+    result?: unknown;
+    error?: string;
+}
+export type WebSocketEvent = UserMessageEvent | AssistantChunkEvent | AssistantCompleteEvent | ToolCallEvent;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Loom Core - Framework types and interfaces
+ *
+ * 编织 AI 能力为应用织物
+ * Skill = 纹理, CLI = 梭子, Data = 纱线, AI = 织力
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@loom-framework/core",
+  "version": "0.1.0-alpha.1",
+  "description": "Loom framework core - DataAdapter, Capability Generator, config system",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "jiti": "^2.6.1",
+    "zod": "^3.23.0"
+  },
+  "optionalDependencies": {
+    "better-sqlite3": "^12.8.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "typescript": "^5.6.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "lint": "tsc --noEmit"
+  }
+}