@xynehq/jaf 0.1.2

package/dist/adk/schemas/index.js

@@ -0,0 +1,363 @@
+/**
+ * JAF ADK Layer - Schema Validation
+ *
+ * Functional schema validation system
+ */
+import { throwValidationError } from '../types';
+// Re-export createValidationError for external use
+export { createValidationError } from '../types';
+// ========== Schema Validator Creation ==========
+export const createSchemaValidator = (schema, validator) => ({
+    schema,
+    validate: (data) => {
+        try {
+            // First run the type guard
+            if (!validator(data)) {
+                return {
+                    success: false,
+                    errors: ['Data does not match expected type']
+                };
+            }
+            // Then run JSON schema validation
+            const schemaValidation = validateAgainstJsonSchema(data, schema);
+            if (!schemaValidation.success) {
+                return { success: false, errors: schemaValidation.errors };
+            }
+            return {
+                success: true,
+                data: data
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                errors: [`Validation error: ${error instanceof Error ? error.message : String(error)}`]
+            };
+        }
+    }
+});
+// ========== JSON Schema Validation ==========
+export const validateAgainstJsonSchema = (data, schema) => {
+    const errors = [];
+    // Type validation
+    if (!validateType(data, schema.type)) {
+        errors.push(`Expected type ${schema.type}, got ${typeof data}`);
+        return { success: false, errors };
+    }
+    // Specific validations based on type
+    switch (schema.type) {
+        case 'object': {
+            const objectValidation = validateObject(data, schema);
+            if (!objectValidation.success) {
+                errors.push(...(objectValidation.errors || []));
+            }
+            break;
+        }
+        case 'array': {
+            const arrayValidation = validateArray(data, schema);
+            if (!arrayValidation.success) {
+                errors.push(...(arrayValidation.errors || []));
+            }
+            break;
+        }
+        case 'string': {
+            const stringValidation = validateString(data, schema);
+            if (!stringValidation.success) {
+                errors.push(...(stringValidation.errors || []));
+            }
+            break;
+        }
+        case 'number': {
+            const numberValidation = validateNumber(data, schema);
+            if (!numberValidation.success) {
+                errors.push(...(numberValidation.errors || []));
+            }
+            break;
+        }
+    }
+    // Enum validation
+    if (schema.enum && !schema.enum.includes(data)) {
+        errors.push(`Value must be one of: ${schema.enum.join(', ')}`);
+    }
+    if (errors.length > 0) {
+        return { success: false, errors };
+    }
+    return { success: true, data };
+};
+const validateType = (data, type) => {
+    switch (type) {
+        case 'string':
+            return typeof data === 'string';
+        case 'number':
+            return typeof data === 'number';
+        case 'boolean':
+            return typeof data === 'boolean';
+        case 'object':
+            return typeof data === 'object' && data !== null && !Array.isArray(data);
+        case 'array':
+            return Array.isArray(data);
+        case 'null':
+            return data === null;
+        default:
+            return true; // Unknown types pass
+    }
+};
+const validateObject = (data, schema) => {
+    const errors = [];
+    // Check required properties
+    if (schema.required) {
+        for (const requiredProp of schema.required) {
+            if (!(requiredProp in data)) {
+                errors.push(`Missing required property: ${requiredProp}`);
+            }
+        }
+    }
+    // Validate properties
+    if (schema.properties) {
+        for (const [propName, propSchema] of Object.entries(schema.properties)) {
+            if (propName in data) {
+                const propValidation = validateAgainstJsonSchema(data[propName], propSchema);
+                if (!propValidation.success) {
+                    errors.push(`Property '${propName}': ${propValidation.errors?.join(', ')}`);
+                }
+            }
+        }
+    }
+    if (errors.length > 0) {
+        return { success: false, errors };
+    }
+    return { success: true, data };
+};
+const validateArray = (data, schema) => {
+    const errors = [];
+    // Validate items
+    if (schema.items) {
+        for (let i = 0; i < data.length; i++) {
+            const itemValidation = validateAgainstJsonSchema(data[i], schema.items);
+            if (!itemValidation.success) {
+                errors.push(`Item ${i}: ${itemValidation.errors?.join(', ')}`);
+            }
+        }
+    }
+    if (errors.length > 0) {
+        return { success: false, errors };
+    }
+    return { success: true, data };
+};
+const validateString = (data, schema) => {
+    const errors = [];
+    // Add string-specific validations here (length, pattern, etc.)
+    // For now, just basic validation
+    if (errors.length > 0) {
+        return { success: false, errors };
+    }
+    return { success: true, data };
+};
+const validateNumber = (data, schema) => {
+    const errors = [];
+    // Add number-specific validations here (min, max, etc.)
+    // For now, just basic validation
+    if (errors.length > 0) {
+        return { success: false, errors };
+    }
+    return { success: true, data };
+};
+// ========== Common Type Guards ==========
+export const isString = (value) => {
+    return typeof value === 'string';
+};
+export const isNumber = (value) => {
+    return typeof value === 'number';
+};
+export const isBoolean = (value) => {
+    return typeof value === 'boolean';
+};
+export const isObject = (value) => {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+};
+export const isArray = (value) => {
+    return Array.isArray(value);
+};
+export const isNull = (value) => {
+    return value === null;
+};
+export const isUndefined = (value) => {
+    return value === undefined;
+};
+// ========== Schema Builders ==========
+export const stringSchema = (options) => ({
+    type: 'string',
+    description: options?.description,
+    enum: options?.enum,
+    default: options?.default
+});
+export const numberSchema = (options) => ({
+    type: 'number',
+    description: options?.description,
+    enum: options?.enum,
+    default: options?.default
+});
+export const booleanSchema = (options) => ({
+    type: 'boolean',
+    description: options?.description,
+    default: options?.default
+});
+export const objectSchema = (properties, required, options) => ({
+    type: 'object',
+    properties,
+    required,
+    description: options?.description
+});
+export const arraySchema = (items, options) => ({
+    type: 'array',
+    items,
+    description: options?.description
+});
+// ========== Common Validators ==========
+export const createStringValidator = (options) => {
+    return createSchemaValidator(stringSchema(options), isString);
+};
+export const createNumberValidator = (options) => {
+    return createSchemaValidator(numberSchema(options), isNumber);
+};
+export const createBooleanValidator = (options) => {
+    return createSchemaValidator(booleanSchema(options), isBoolean);
+};
+export const createObjectValidator = (properties, required, typeGuard) => {
+    const schema = objectSchema(properties, required);
+    const guard = typeGuard || isObject;
+    return createSchemaValidator(schema, guard);
+};
+export const createArrayValidator = (items, typeGuard) => {
+    const schema = arraySchema(items);
+    const guard = typeGuard || isArray;
+    return createSchemaValidator(schema, guard);
+};
+// ========== Composite Type Guards ==========
+export const isOptional = (guard) => {
+    return (value) => {
+        return value === undefined || guard(value);
+    };
+};
+export const isNullable = (guard) => {
+    return (value) => {
+        return value === null || guard(value);
+    };
+};
+export const isUnion = (...guards) => {
+    return (value) => {
+        return guards.some(guard => guard(value));
+    };
+};
+export const hasProperty = (key) => {
+    return (value) => {
+        return isObject(value) && key in value;
+    };
+};
+export const hasProperties = (...keys) => {
+    return (value) => {
+        if (!isObject(value))
+            return false;
+        return keys.every(key => key in value);
+    };
+};
+// ========== Validation Utilities ==========
+export const validateInput = (validator, data) => {
+    return validator.validate(data);
+};
+export const validateOutput = (validator, data) => {
+    return validator.validate(data);
+};
+export const assertValid = (validator, data) => {
+    const result = validator.validate(data);
+    if (!result.success) {
+        throwValidationError(`Validation failed: ${result.errors?.join(', ')}`, result.errors || [], { data });
+    }
+    return result.data;
+};
+export const isValid = (validator, data) => {
+    const result = validator.validate(data);
+    return result.success;
+};
+// ========== Schema Transformation ==========
+export const transformAndValidate = (validator, transformer, data) => {
+    try {
+        const transformed = transformer(data);
+        return validator.validate(transformed);
+    }
+    catch (error) {
+        return {
+            success: false,
+            errors: [`Transformation failed: ${error instanceof Error ? error.message : String(error)}`]
+        };
+    }
+};
+export const validateAndTransform = (inputValidator, transformer, data) => {
+    const inputResult = inputValidator.validate(data);
+    if (!inputResult.success) {
+        return { success: false, errors: inputResult.errors };
+    }
+    try {
+        const transformed = transformer(inputResult.data);
+        return { success: true, data: transformed };
+    }
+    catch (error) {
+        return {
+            success: false,
+            errors: [`Transformation failed: ${error instanceof Error ? error.message : String(error)}`]
+        };
+    }
+};
+export const weatherQueryValidator = createObjectValidator({
+    location: stringSchema({ description: 'City or location name' }),
+    units: stringSchema({
+        description: 'Temperature units',
+        enum: ['celsius', 'fahrenheit'],
+        default: 'celsius'
+    }),
+    includeHourly: booleanSchema({
+        description: 'Include hourly forecast',
+        default: false
+    })
+}, ['location'], (value) => {
+    return isObject(value) &&
+        hasProperty('location')(value) &&
+        isString(value.location);
+});
+export const weatherResponseValidator = createObjectValidator({
+    location: stringSchema({ description: 'Location name' }),
+    temperature: numberSchema({ description: 'Current temperature' }),
+    condition: stringSchema({ description: 'Weather condition' }),
+    humidity: numberSchema({ description: 'Humidity percentage' }),
+    forecast: arraySchema(objectSchema({
+        time: stringSchema({ description: 'Forecast time' }),
+        temperature: numberSchema({ description: 'Forecast temperature' }),
+        condition: stringSchema({ description: 'Forecast condition' })
+    }, ['time', 'temperature', 'condition']))
+}, ['location', 'temperature', 'condition', 'humidity']);
+// ========== Schema Error Handling ==========
+// Note: createValidationError is now imported from types.ts as a factory function
+export const withSchemaValidation = (fn, inputValidators, outputValidator) => {
+    return (...args) => {
+        // Validate inputs
+        if (inputValidators) {
+            for (let i = 0; i < inputValidators.length && i < args.length; i++) {
+                const validation = inputValidators[i].validate(args[i]);
+                if (!validation.success) {
+                    throwValidationError(`Input validation failed for argument ${i}`, validation.errors || [], { argument: i, value: args[i] });
+                }
+            }
+        }
+        // Execute function
+        const result = fn(...args);
+        // Validate output
+        if (outputValidator) {
+            const validation = outputValidator.validate(result);
+            if (!validation.success) {
+                throwValidationError('Output validation failed', validation.errors || [], { result });
+            }
+        }
+        return result;
+    };
+};
+//# sourceMappingURL=index.js.map

package/dist/adk/schemas/index.js.map

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

package/dist/adk/sessions/examples/session-provider-usage.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Example usage of session providers
+ */
+import { SessionProvider } from '../../types.js';
+declare function inMemoryExample(): Promise<void>;
+declare function redisExample(): Promise<void>;
+declare function postgresExample(): Promise<void>;
+declare function useAnyProvider(provider: SessionProvider): Promise<void>;
+export { inMemoryExample, redisExample, postgresExample, useAnyProvider };
+//# sourceMappingURL=session-provider-usage.d.ts.map

package/dist/adk/sessions/examples/session-provider-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-provider-usage.d.ts","sourceRoot":"","sources":["../../../../src/adk/sessions/examples/session-provider-usage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,EAAE,eAAe,EAA+B,MAAM,gBAAgB,CAAC;AAG9E,iBAAe,eAAe,kBA0C7B;AAGD,iBAAe,YAAY,kBA2B1B;AAGD,iBAAe,eAAe,kBA0B7B;AAGD,iBAAe,cAAc,CAAC,QAAQ,EAAE,eAAe,iBA4CtD;AAuBD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC"}

package/dist/adk/sessions/examples/session-provider-usage.js

@@ -0,0 +1,145 @@
+/**
+ * Example usage of session providers
+ */
+import { createInMemorySessionProvider, createRedisSessionProvider, createPostgresSessionProvider, addMessageToSession, addArtifactToSession, getSessionStats } from '../index.js';
+import { ContentRole } from '../../types.js';
+// Example 1: In-Memory Session Provider
+async function inMemoryExample() {
+    console.log('=== In-Memory Session Provider Example ===');
+    const provider = createInMemorySessionProvider();
+    // Create a session
+    const context = {
+        appName: 'my-app',
+        userId: 'user-123',
+        sessionId: 'session-456'
+    };
+    let session = await provider.createSession(context);
+    console.log('Created session:', session.id);
+    // Add messages
+    session = addMessageToSession(session, {
+        role: ContentRole.USER,
+        parts: [{ type: 'text', text: 'Hello, AI!' }]
+    });
+    session = addMessageToSession(session, {
+        role: ContentRole.MODEL,
+        parts: [{ type: 'text', text: 'Hello! How can I help you?' }]
+    });
+    // Add artifacts
+    session = addArtifactToSession(session, 'userPreferences', {
+        theme: 'dark',
+        language: 'en'
+    });
+    // Update session
+    await provider.updateSession(session);
+    // Get session stats
+    const stats = getSessionStats(session);
+    console.log('Session stats:', stats);
+    // List user sessions
+    const sessions = await provider.listSessions('user-123');
+    console.log('User has', sessions.length, 'sessions');
+}
+// Example 2: Redis Session Provider
+async function redisExample() {
+    console.log('\n=== Redis Session Provider Example ===');
+    try {
+        const provider = createRedisSessionProvider({
+            host: process.env.REDIS_HOST || 'localhost',
+            port: parseInt(process.env.REDIS_PORT || '6379'),
+            keyPrefix: 'myapp:sessions:',
+            ttl: 3600 // 1 hour TTL
+        });
+        // Create a session
+        const context = {
+            appName: 'redis-app',
+            userId: 'redis-user-123'
+        };
+        const session = await provider.createSession(context);
+        console.log('Created Redis session:', session.id);
+        // Session will be automatically persisted to Redis
+        // and will expire after 1 hour
+    }
+    catch (error) {
+        console.error('Redis provider error:', error.message);
+        console.log('Make sure Redis is installed and running');
+    }
+}
+// Example 3: PostgreSQL Session Provider
+async function postgresExample() {
+    console.log('\n=== PostgreSQL Session Provider Example ===');
+    try {
+        const provider = createPostgresSessionProvider({
+            connectionString: process.env.DATABASE_URL || 'postgresql://localhost/myapp',
+            tableName: 'app_sessions',
+            poolSize: 10
+        });
+        // Create a session
+        const context = {
+            appName: 'postgres-app',
+            userId: 'pg-user-123'
+        };
+        const session = await provider.createSession(context);
+        console.log('Created PostgreSQL session:', session.id);
+        // Session will be automatically persisted to PostgreSQL
+        // Table will be created automatically if it doesn't exist
+    }
+    catch (error) {
+        console.error('PostgreSQL provider error:', error.message);
+        console.log('Make sure PostgreSQL is installed and database exists');
+    }
+}
+// Example 4: Provider-agnostic code
+async function useAnyProvider(provider) {
+    console.log('\n=== Provider-Agnostic Example ===');
+    const context = {
+        appName: 'universal-app',
+        userId: 'user-789'
+    };
+    // Create session
+    let session = await provider.createSession(context);
+    // Add conversation
+    session = addMessageToSession(session, {
+        role: ContentRole.USER,
+        parts: [{ type: 'text', text: 'What is the weather today?' }]
+    });
+    session = addMessageToSession(session, {
+        role: ContentRole.MODEL,
+        parts: [{
+                type: 'function_call',
+                functionCall: {
+                    id: 'call-123',
+                    name: 'getWeather',
+                    args: { location: 'current' }
+                }
+            }]
+    });
+    session = addMessageToSession(session, {
+        role: ContentRole.MODEL,
+        parts: [{ type: 'text', text: 'The weather today is sunny with a high of 75°F.' }]
+    });
+    // Save session
+    await provider.updateSession(session);
+    // Retrieve session
+    const retrieved = await provider.getSession(session.id);
+    console.log('Retrieved session with', retrieved?.messages.length, 'messages');
+    // Clean up
+    await provider.deleteSession(session.id);
+    console.log('Session deleted');
+}
+// Run examples
+async function main() {
+    // Always works - no dependencies
+    await inMemoryExample();
+    // Requires Redis
+    await redisExample();
+    // Requires PostgreSQL
+    await postgresExample();
+    // Use any provider
+    const provider = createInMemorySessionProvider();
+    await useAnyProvider(provider);
+}
+// Run if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().catch(console.error);
+}
+export { inMemoryExample, redisExample, postgresExample, useAnyProvider };
+//# sourceMappingURL=session-provider-usage.js.map

package/dist/adk/sessions/examples/session-provider-usage.js.map

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

package/dist/adk/sessions/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * JAF ADK Layer - Session Management
+ *
+ * Functional session management with pluggable providers
+ */
+import { Session, SessionContext, SessionProvider, SessionMetadata, Content, ValidationResult, createSessionError } from '../types';
+export declare const generateSessionId: () => string;
+export declare const createSession: (appName: string, userId: string, sessionId?: string, metadata?: Partial<SessionMetadata>) => Session;
+export declare const createInMemorySessionProvider: () => SessionProvider;
+export { createRedisSessionProvider, type RedisConfig } from './redis-provider.js';
+interface MockRedisConfig {
+    host: string;
+    port: number;
+    password?: string;
+    database?: number;
+    keyPrefix?: string;
+}
+export declare const createMockRedisSessionProvider: (config: MockRedisConfig) => SessionProvider;
+export { createPostgresSessionProvider, type PostgresConfig } from './postgres-provider.js';
+export declare const addMessageToSession: (session: Session, message: Content) => Session;
+export declare const addArtifactToSession: (session: Session, key: string, value: unknown) => Session;
+export declare const removeArtifactFromSession: (session: Session, key: string) => Session;
+export declare const updateSessionMetadata: (session: Session, metadata: Partial<SessionMetadata>) => Session;
+export declare const clearSessionMessages: (session: Session) => Session;
+export declare const validateSession: (session: Session) => ValidationResult<Session>;
+export declare const validateSessionContext: (context: SessionContext) => ValidationResult<SessionContext>;
+export declare const getOrCreateSession: (provider: SessionProvider, context: SessionContext) => Promise<Session>;
+export declare const getSessionStats: (session: Session) => {
+    id: string;
+    appName: string;
+    userId: string;
+    messageCount: number;
+    userMessages: number;
+    modelMessages: number;
+    systemMessages: number;
+    artifactCount: number;
+    totalTextLength: number;
+    created: Date;
+    lastAccessed: Date | undefined;
+    tags: string[] | undefined;
+};
+export declare const cloneSession: (session: Session, newId?: string) => Session;
+export declare const mergeSessionArtifacts: (session: Session, artifacts: Record<string, unknown>) => Session;
+export declare const getLastUserMessage: (session: Session) => Content | null;
+export declare const getLastModelMessage: (session: Session) => Content | null;
+export declare const getMessagesByRole: (session: Session, role: Content["role"]) => Content[];
+export declare const hasArtifact: (session: Session, key: string) => boolean;
+export declare const getArtifact: (session: Session, key: string) => unknown | null;
+export declare const getArtifactKeys: (session: Session) => string[];
+export { createSessionError };
+export declare const withSessionErrorHandling: <T extends unknown[], R>(fn: (...args: T) => Promise<R>, sessionId?: string) => (...args: T) => Promise<R>;
+export declare const createMemoryProviderBridge: (memoryProvider: any) => SessionProvider;
+//# sourceMappingURL=index.d.ts.map

package/dist/adk/sessions/index.d.ts.map

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