@almadar/agent 1.6.4 → 2.0.1

package/dist/workspace/workspace-manager.d.ts

@@ -0,0 +1,57 @@
+/**
+ * WorkspaceManager — Lifecycle management for agent workspaces.
+ *
+ * Handles initialization (create dirs, write .orb templates, git init),
+ * file write notifications (fan out to sinks), memory read/write,
+ * and session end (final commit, tag, cleanup).
+ *
+ * @packageDocumentation
+ */
+import type { WorkspaceConfig, FileMeta, SinkResult, MemorySnapshot } from './types.js';
+import { SinkManager } from './sink-manager.js';
+export declare class WorkspaceManager {
+    private readonly config;
+    private readonly sinkManager;
+    private gitSink;
+    private initialized;
+    constructor(config: WorkspaceConfig);
+    /** Get the absolute path to a workspace-relative path. */
+    resolve(relativePath: string): string;
+    /** Get the SinkManager for direct registration of additional sinks. */
+    get sinks(): SinkManager;
+    /**
+     * Initialize the workspace: create directories, write .orb templates,
+     * optionally initialize git.
+     *
+     * Safe to call multiple times — skips if already initialized.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Notify sinks that a file was written.
+     * Call this from the server when the agent writes a file.
+     *
+     * @param relativePath - Path relative to workspace root
+     * @param content - File content as string
+     * @param meta - Optional metadata override (auto-inferred if not provided)
+     */
+    onFileWritten(relativePath: string, content: string, meta?: Partial<FileMeta>): Promise<SinkResult[]>;
+    /**
+     * Load memory from .orb files. Call at session start to provide
+     * the agent with user preferences and project context.
+     */
+    loadMemory(): Promise<MemorySnapshot>;
+    /**
+     * Update memory .orb file instances. Call at session end to
+     * persist learned preferences and discovered domain knowledge.
+     */
+    saveMemory(updates: {
+        user?: Record<string, unknown>[];
+        project?: Record<string, unknown>[];
+    }): Promise<void>;
+    /**
+     * End the session: notify all sinks, create git tag.
+     * Call from the server when the agent session completes.
+     */
+    endSession(): Promise<SinkResult[]>;
+    private writeTemplateIfMissing;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/agent",
-  "version": "1.6.4",
+  "version": "2.0.1",
   "description": "AI agent infrastructure for Almadar orbital schema generation",
   "type": "module",
   "main": "./dist/index.js",
@@ -43,13 +43,13 @@
     "access": "public"
   },
   "dependencies": {
+    "@almadar/core": ">=2.0.0",
+    "@almadar/integrations": ">=2.0.1",
+    "@almadar/llm": ">=2.0.1",
+    "@almadar/patterns": ">=2.0.0",
+    "@almadar/skills": ">=2.0.1",
     "uuid": "^9.0.0",
-    "zod": "^3.22.0",
-    "@almadar/core": "1.0.18",
-    "@almadar/integrations": "1.0.15",
-    "@almadar/patterns": "1.1.1",
-    "@almadar/llm": "1.0.17",
-    "@almadar/skills": "1.4.1"
+    "zod": "^3.22.0"
   },
   "peerDependencies": {
     "@langchain/core": ">=1.0.0",
@@ -82,12 +82,13 @@
     "deepagents": "^1.7.3",
     "tsup": "^8.0.0",
     "typescript": "^5.4.0",
-    "vitest": "^3.0.0"
+    "vitest": "^3.0.0",
+    "@types/node": "^22.0.0"
   },
   "repository": {
     "type": "git",
     "url": "https://github.com/almadar-io/almadar.git",
-    "directory": "packages/almadar-agent"
+    "directory": "docs/packages/agent"
   },
   "license": "MIT",
   "keywords": [
@@ -97,8 +98,9 @@
     "deepagent",
     "schema-generation"
   ],
+  "homepage": "https://github.com/almadar-io/almadar#readme",
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && tsc --declaration --emitDeclarationOnly --outDir dist --rootDir src --skipLibCheck || true",
     "build:watch": "tsup --watch",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",