@defai.digital/session-domain 13.0.3

package/dist/store.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Session Store Implementation
+ *
+ * Provides storage for session state.
+ */
+import type { Session, CreateSessionInput } from '@defai.digital/contracts';
+import type { SessionStore, SessionFilter } from './types.js';
+/**
+ * In-memory session store implementation
+ */
+export declare class InMemorySessionStore implements SessionStore {
+    private readonly sessions;
+    /**
+     * Create a new session
+     */
+    create(input: CreateSessionInput): Promise<Session>;
+    /**
+     * Get a session by ID
+     */
+    get(sessionId: string): Promise<Session | undefined>;
+    /**
+     * Update a session
+     */
+    update(sessionId: string, session: Session): Promise<void>;
+    /**
+     * Delete a session
+     */
+    delete(sessionId: string): Promise<void>;
+    /**
+     * List sessions with optional filters
+     */
+    list(filter?: SessionFilter): Promise<Session[]>;
+    /**
+     * Find active session for an agent
+     */
+    findActiveForAgent(agentId: string, workspace?: string): Promise<Session | undefined>;
+    /**
+     * Apply a governance policy to a session
+     */
+    applyPolicy(sessionId: string, policyId: string): Promise<Session>;
+    /**
+     * Get applied policies for a session
+     */
+    getAppliedPolicies(sessionId: string): Promise<string[]>;
+    /**
+     * Clear all sessions (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Get the count of sessions
+     */
+    get size(): number;
+}
+/**
+ * Session version conflict error
+ */
+export declare class SessionVersionConflictError extends Error {
+    readonly sessionId: string;
+    readonly expectedVersion: number;
+    readonly actualVersion: number;
+    constructor(sessionId: string, expectedVersion: number, actualVersion: number);
+}
+/**
+ * Creates a new in-memory session store
+ */
+export declare function createSessionStore(): SessionStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9D;;GAEG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IAEvD;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IA6BzD;;OAEG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAI1D;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBhE;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAkDtD;;OAEG;IACG,kBAAkB,CACtB,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAsB/B;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAwBxE;;OAEG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQ9D;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;aAElC,SAAS,EAAE,MAAM;aACjB,eAAe,EAAE,MAAM;aACvB,aAAa,EAAE,MAAM;gBAFrB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM;CAOxC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAEjD"}

package/dist/store.js

@@ -0,0 +1,188 @@
+/**
+ * Session Store Implementation
+ *
+ * Provides storage for session state.
+ */
+/**
+ * In-memory session store implementation
+ */
+export class InMemorySessionStore {
+    sessions = new Map();
+    /**
+     * Create a new session
+     */
+    async create(input) {
+        const now = new Date().toISOString();
+        const sessionId = crypto.randomUUID();
+        const session = {
+            sessionId,
+            initiator: input.initiator,
+            task: input.task,
+            participants: [
+                {
+                    agentId: input.initiator,
+                    role: 'initiator',
+                    joinedAt: now,
+                    tasks: [],
+                },
+            ],
+            status: 'active',
+            createdAt: now,
+            updatedAt: now,
+            version: 1,
+            workspace: input.workspace,
+            metadata: input.metadata,
+            appliedPolicies: [],
+        };
+        this.sessions.set(sessionId, session);
+        return session;
+    }
+    /**
+     * Get a session by ID
+     */
+    async get(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /**
+     * Update a session
+     */
+    async update(sessionId, session) {
+        if (!this.sessions.has(sessionId)) {
+            throw new Error(`Session ${sessionId} not found`);
+        }
+        // Check version for optimistic concurrency
+        const existing = this.sessions.get(sessionId);
+        if (existing.version !== session.version - 1) {
+            throw new SessionVersionConflictError(sessionId, existing.version, session.version);
+        }
+        this.sessions.set(sessionId, {
+            ...session,
+            updatedAt: new Date().toISOString(),
+        });
+    }
+    /**
+     * Delete a session
+     */
+    async delete(sessionId) {
+        this.sessions.delete(sessionId);
+    }
+    /**
+     * List sessions with optional filters
+     */
+    async list(filter) {
+        let sessions = Array.from(this.sessions.values());
+        if (filter !== undefined) {
+            if (filter.status !== undefined) {
+                sessions = sessions.filter((s) => s.status === filter.status);
+            }
+            if (filter.initiator !== undefined) {
+                sessions = sessions.filter((s) => s.initiator === filter.initiator);
+            }
+            if (filter.participant !== undefined) {
+                sessions = sessions.filter((s) => s.participants.some((p) => p.agentId === filter.participant));
+            }
+            if (filter.workspace !== undefined) {
+                sessions = sessions.filter((s) => s.workspace === filter.workspace);
+            }
+            if (filter.createdAfter !== undefined) {
+                const after = new Date(filter.createdAfter).getTime();
+                sessions = sessions.filter((s) => new Date(s.createdAt).getTime() > after);
+            }
+            if (filter.createdBefore !== undefined) {
+                const before = new Date(filter.createdBefore).getTime();
+                sessions = sessions.filter((s) => new Date(s.createdAt).getTime() < before);
+            }
+            if (filter.limit !== undefined) {
+                sessions = sessions.slice(0, filter.limit);
+            }
+        }
+        // Sort by createdAt descending
+        sessions.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+        return sessions;
+    }
+    /**
+     * Find active session for an agent
+     */
+    async findActiveForAgent(agentId, workspace) {
+        for (const session of this.sessions.values()) {
+            if (session.status !== 'active') {
+                continue;
+            }
+            if (workspace !== undefined && session.workspace !== workspace) {
+                continue;
+            }
+            const isParticipant = session.participants.some((p) => p.agentId === agentId && p.leftAt === undefined);
+            if (isParticipant) {
+                return session;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Apply a governance policy to a session
+     */
+    async applyPolicy(sessionId, policyId) {
+        const session = this.sessions.get(sessionId);
+        if (session === undefined) {
+            throw new Error(`Session ${sessionId} not found`);
+        }
+        // Check if policy already applied
+        const appliedPolicies = session.appliedPolicies ?? [];
+        if (appliedPolicies.includes(policyId)) {
+            return session; // Already applied, return as-is
+        }
+        // Apply policy and increment version
+        const updatedSession = {
+            ...session,
+            appliedPolicies: [...appliedPolicies, policyId],
+            updatedAt: new Date().toISOString(),
+            version: session.version + 1,
+        };
+        this.sessions.set(sessionId, updatedSession);
+        return updatedSession;
+    }
+    /**
+     * Get applied policies for a session
+     */
+    async getAppliedPolicies(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (session === undefined) {
+            throw new Error(`Session ${sessionId} not found`);
+        }
+        return session.appliedPolicies ?? [];
+    }
+    /**
+     * Clear all sessions (useful for testing)
+     */
+    clear() {
+        this.sessions.clear();
+    }
+    /**
+     * Get the count of sessions
+     */
+    get size() {
+        return this.sessions.size;
+    }
+}
+/**
+ * Session version conflict error
+ */
+export class SessionVersionConflictError extends Error {
+    sessionId;
+    expectedVersion;
+    actualVersion;
+    constructor(sessionId, expectedVersion, actualVersion) {
+        super(`Version conflict for session ${sessionId}: expected ${expectedVersion}, got ${actualVersion}`);
+        this.sessionId = sessionId;
+        this.expectedVersion = expectedVersion;
+        this.actualVersion = actualVersion;
+        this.name = 'SessionVersionConflictError';
+    }
+}
+/**
+ * Creates a new in-memory session store
+ */
+export function createSessionStore() {
+    return new InMemorySessionStore();
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Session Domain Types
+ */
+import { type Session, type SessionTask, type SessionStatus, type SessionEvent, type CreateSessionInput, type JoinSessionInput, type StartTaskInput, type CompleteTaskInput, type FailTaskInput, type RunRecord, type HistoryQuery } from '@defai.digital/contracts';
+/**
+ * Session store interface
+ */
+export interface SessionStore {
+    /**
+     * Create a new session
+     */
+    create(input: CreateSessionInput): Promise<Session>;
+    /**
+     * Get a session by ID
+     */
+    get(sessionId: string): Promise<Session | undefined>;
+    /**
+     * Update a session
+     */
+    update(sessionId: string, session: Session): Promise<void>;
+    /**
+     * Delete a session
+     */
+    delete(sessionId: string): Promise<void>;
+    /**
+     * List sessions with optional filters
+     */
+    list(filter?: SessionFilter): Promise<Session[]>;
+    /**
+     * Find active session for an agent
+     */
+    findActiveForAgent(agentId: string, workspace?: string): Promise<Session | undefined>;
+    /**
+     * Apply a governance policy to a session
+     */
+    applyPolicy(sessionId: string, policyId: string): Promise<Session>;
+    /**
+     * Get applied policies for a session
+     */
+    getAppliedPolicies(sessionId: string): Promise<string[]>;
+}
+/**
+ * Filter options for listing sessions
+ */
+export interface SessionFilter {
+    status?: SessionStatus;
+    initiator?: string;
+    participant?: string;
+    workspace?: string;
+    createdAfter?: string;
+    createdBefore?: string;
+    limit?: number;
+}
+/**
+ * Session manager interface
+ */
+export interface SessionManager {
+    /**
+     * Create a new session
+     */
+    createSession(input: CreateSessionInput): Promise<Session>;
+    /**
+     * Get a session by ID
+     */
+    getSession(sessionId: string): Promise<Session | undefined>;
+    /**
+     * Join an existing session
+     */
+    joinSession(input: JoinSessionInput): Promise<Session>;
+    /**
+     * Leave a session
+     */
+    leaveSession(sessionId: string, agentId: string): Promise<Session>;
+    /**
+     * Start a task within a session
+     */
+    startTask(input: StartTaskInput): Promise<SessionTask>;
+    /**
+     * Complete a task
+     */
+    completeTask(input: CompleteTaskInput): Promise<SessionTask>;
+    /**
+     * Fail a task
+     */
+    failTask(input: FailTaskInput): Promise<SessionTask>;
+    /**
+     * Complete a session
+     */
+    completeSession(sessionId: string, summary?: string): Promise<Session>;
+    /**
+     * Fail a session
+     */
+    failSession(sessionId: string, error: SessionFailure): Promise<Session>;
+    /**
+     * List sessions
+     */
+    listSessions(filter?: SessionFilter): Promise<Session[]>;
+    /**
+     * Get run history across all sessions
+     * Aggregates tasks from all participants across sessions
+     */
+    getRunHistory(options?: HistoryQuery): Promise<RunRecord[]>;
+    /**
+     * Count active sessions
+     */
+    countActiveSessions(): Promise<number>;
+}
+/**
+ * Session failure info
+ * Matches SessionErrorSchema from contracts
+ */
+export interface SessionFailure {
+    code: string;
+    message: string;
+    taskId?: string;
+    retryable?: boolean;
+    details?: Record<string, unknown>;
+}
+/**
+ * Session event handler
+ */
+export type SessionEventHandler = (event: SessionEvent) => void | Promise<void>;
+/**
+ * Session event emitter interface
+ */
+export interface SessionEventEmitter {
+    /**
+     * Subscribe to session events
+     */
+    on(type: SessionEvent['type'] | '*', handler: SessionEventHandler): void;
+    /**
+     * Unsubscribe from session events
+     */
+    off(type: SessionEvent['type'] | '*', handler: SessionEventHandler): void;
+    /**
+     * Emit a session event
+     */
+    emit(event: SessionEvent): void;
+}
+/**
+ * Session domain configuration
+ */
+export interface SessionDomainConfig {
+    maxParticipants: number;
+    maxTasksPerParticipant: number;
+    sessionTimeout: number;
+    eventBufferSize: number;
+}
+/**
+ * Default session domain configuration
+ */
+export declare const DEFAULT_SESSION_DOMAIN_CONFIG: SessionDomainConfig;
+export type { RunRecord, RunStatus, HistoryQuery } from '@defai.digital/contracts';
+export type RunHistoryOptions = HistoryQuery;
+//# 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,16 @@
+/**
+ * Session Domain Types
+ */
+import { 
+// Constants
+TIMEOUT_SESSION, LIMIT_EVENT_BUFFER, } from '@defai.digital/contracts';
+/**
+ * Default session domain configuration
+ */
+export const DEFAULT_SESSION_DOMAIN_CONFIG = {
+    maxParticipants: 10,
+    maxTasksPerParticipant: 50,
+    sessionTimeout: TIMEOUT_SESSION,
+    eventBufferSize: LIMIT_EVENT_BUFFER,
+};
+//# 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;;GAEG;AAEH,OAAO;AAaL,YAAY;AACZ,eAAe,EACf,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AA6KlC;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAwB;IAChE,eAAe,EAAE,EAAE;IACnB,sBAAsB,EAAE,EAAE;IAC1B,cAAc,EAAE,eAAe;IAC/B,eAAe,EAAE,kBAAkB;CACpC,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@defai.digital/session-domain",
+  "version": "13.0.3",
+  "type": "module",
+  "description": "Session lifecycle management for AutomatosX",
+  "license": "Apache-2.0",
+  "author": "DEFAI Private Limited",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/defai-digital/automatosx.git",
+    "directory": "packages/core/session-domain"
+  },
+  "homepage": "https://github.com/defai-digital/automatosx#readme",
+  "bugs": {
+    "url": "https://github.com/defai-digital/automatosx/issues"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@defai.digital/contracts": "13.0.3"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2"
+  },
+  "peerDependencies": {
+    "zod": "^3.23.0"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist"
+  }
+}

package/src/index.ts

@@ -0,0 +1,75 @@
+/**
+ * @defai.digital/session-domain
+ *
+ * Session lifecycle management for AutomatosX.
+ * Tracks multi-agent collaboration, task progress, and shared state.
+ */
+
+// Types
+export type {
+  SessionStore,
+  SessionFilter,
+  SessionManager,
+  SessionFailure,
+  SessionEventHandler,
+  SessionEventEmitter,
+  SessionDomainConfig,
+  RunRecord,
+  RunHistoryOptions,
+  RunStatus,
+} from './types.js';
+
+export { DEFAULT_SESSION_DOMAIN_CONFIG } from './types.js';
+
+// Store
+export {
+  InMemorySessionStore,
+  SessionVersionConflictError,
+  createSessionStore,
+} from './store.js';
+
+// Manager
+export {
+  DefaultSessionManager,
+  SessionError,
+  createSessionManager,
+} from './manager.js';
+
+// Re-export contract types for convenience
+export type {
+  Session,
+  SessionTask,
+  SessionParticipant,
+  SessionStatus,
+  TaskStatus,
+  ParticipantRole,
+  SessionEvent,
+  SessionEventType,
+  SessionEventPayload,
+  SessionError as SessionErrorType,
+  CreateSessionInput,
+  JoinSessionInput,
+  StartTaskInput,
+  CompleteTaskInput,
+  FailTaskInput,
+} from '@defai.digital/contracts';
+
+export {
+  SessionSchema,
+  SessionTaskSchema,
+  SessionParticipantSchema,
+  SessionStatusSchema,
+  TaskStatusSchema,
+  ParticipantRoleSchema,
+  SessionEventSchema,
+  SessionErrorCode,
+  SESSION_TRANSITIONS,
+  TASK_TRANSITIONS,
+  validateSession,
+  safeValidateSession,
+  isValidSessionTransition,
+  isValidTaskTransition,
+  validateCreateSessionInput,
+  validateJoinSessionInput,
+  validateStartTaskInput,
+} from '@defai.digital/contracts';