@bluefly/openstandardagents 0.2.7 → 0.2.9

package/dist/types/policy.d.ts

@@ -0,0 +1,377 @@
+/**
+ * @fileoverview OSSA Policy DSL Type Definitions
+ * @module @openstandardagents/policy
+ * @version 1.0.0
+ *
+ * Formal type definitions for the OSSA Policy Domain-Specific Language.
+ * See docs/specs/policy-dsl.md for full specification.
+ */
+/**
+ * Variable reference in policy expressions (e.g., $cost.tokens)
+ */
+export interface Variable {
+    type: 'variable';
+    /** Dot-separated path (e.g., ['cost', 'tokens']) */
+    path: string[];
+}
+/**
+ * Primitive value types
+ */
+export type PrimitiveValue = string | number | boolean | null;
+/**
+ * Array of values (for recursive structure)
+ */
+export type ValueArray = PolicyValue[];
+/**
+ * Object of values (for recursive structure)
+ */
+export interface ValueObject {
+    [key: string]: PolicyValue;
+}
+/**
+ * Function call in policy expressions
+ */
+export interface FunctionCall {
+    type: 'function';
+    /** Function name */
+    name: string;
+    /** Function arguments */
+    args: PolicyValue[];
+}
+/**
+ * Value types supported in policy expressions
+ */
+export type PolicyValue = PrimitiveValue | ValueArray | ValueObject | Variable | FunctionCall;
+/**
+ * @deprecated Use PolicyValue instead
+ */
+export type Value = PolicyValue;
+/**
+ * Comparison operators for condition evaluation
+ */
+export type ComparisonOperator = 'equals' | 'notEquals' | 'greaterThan' | 'lessThan' | 'greaterEqual' | 'lessEqual' | 'contains' | 'matches' | 'in' | 'startsWith' | 'endsWith';
+/**
+ * Logical operators for combining conditions
+ */
+export type LogicalOperator = 'and' | 'or' | 'not';
+/**
+ * Action types that can be performed by policies
+ */
+export type ActionType = 'allow' | 'deny' | 'require_approval' | 'log' | 'escalate' | 'notify' | 'execute';
+/**
+ * Action effects (final outcome)
+ */
+export type Effect = 'allow' | 'deny' | 'escalate' | 'log';
+/**
+ * Comparison expression (e.g., $cost.tokens > 1000)
+ */
+export interface ComparisonCondition {
+    type: 'comparison';
+    /** Left-hand side value */
+    left: PolicyValue;
+    /** Comparison operator */
+    operator: ComparisonOperator;
+    /** Right-hand side value */
+    right: PolicyValue;
+}
+/**
+ * Logical expression (AND, OR, NOT)
+ */
+export interface LogicalCondition {
+    type: 'logical';
+    /** Logical operator */
+    operator: LogicalOperator;
+    /** Sub-conditions */
+    conditions: PolicyCondition[];
+}
+/**
+ * Function-based condition
+ */
+export interface FunctionCondition {
+    type: 'function';
+    /** Function name */
+    function: string;
+    /** Function arguments */
+    args: PolicyValue[];
+}
+/**
+ * Policy condition (union type)
+ */
+export type PolicyCondition = ComparisonCondition | LogicalCondition | FunctionCondition;
+/**
+ * Notification channel configuration
+ */
+export interface NotificationChannel {
+    /** Channel type */
+    type: 'email' | 'slack' | 'pagerduty' | 'webhook' | 'sms';
+    /** Channel-specific configuration */
+    config: Record<string, PolicyValue>;
+}
+/**
+ * Notification configuration
+ */
+export interface NotificationConfig {
+    /** Notification channels */
+    channels: ('email' | 'slack' | 'pagerduty' | 'webhook' | 'sms')[];
+    /** Notification message (supports template variables) */
+    message: string;
+    /** Additional notification metadata */
+    metadata?: Record<string, PolicyValue>;
+}
+/**
+ * Audit log configuration
+ */
+export interface AuditConfig {
+    /** Log level */
+    level: 'debug' | 'info' | 'warning' | 'error';
+    /** Log message (supports template variables) */
+    message: string;
+    /** Compliance frameworks */
+    compliance?: string[];
+    /** Additional audit metadata */
+    metadata?: Record<string, PolicyValue>;
+}
+/**
+ * Policy action
+ */
+export interface PolicyAction {
+    /** Action type */
+    type: ActionType;
+    /** Target resource or capability */
+    target?: string;
+    /** Action parameters */
+    params?: Record<string, PolicyValue>;
+    /** Effect of the action */
+    effect: Effect;
+    /** Notification configuration */
+    notify?: NotificationConfig;
+    /** Audit log configuration */
+    audit?: AuditConfig;
+}
+/**
+ * Complete policy rule
+ */
+export interface PolicyRule {
+    /** Unique rule identifier */
+    id: string;
+    /** Human-readable description */
+    description?: string;
+    /** Condition that triggers this rule */
+    condition: PolicyCondition;
+    /** Action to perform when condition matches */
+    action: PolicyAction;
+    /** Rule priority (higher = evaluated first) */
+    priority?: number;
+    /** Rule enabled state */
+    enabled?: boolean;
+    /** Rule metadata */
+    metadata?: Record<string, PolicyValue>;
+}
+/**
+ * Duration (timeout, delay, etc.)
+ */
+export interface Duration {
+    /** Numeric value */
+    value: number;
+    /** Time unit */
+    unit: 'seconds' | 'minutes' | 'hours' | 'days';
+}
+/**
+ * Escalation target (human or system)
+ */
+export interface EscalationTarget {
+    /** Target type */
+    type: 'user' | 'group' | 'role' | 'webhook';
+    /** Target identifier (user ID, group name, etc.) */
+    identifier: string;
+    /** Additional target metadata */
+    metadata?: Record<string, PolicyValue>;
+}
+/**
+ * Escalation policy for human-in-the-loop workflows
+ */
+export interface EscalationPolicy {
+    /** Unique escalation identifier */
+    id: string;
+    /** Human-readable description */
+    description?: string;
+    /** Condition that triggers escalation */
+    condition: PolicyCondition;
+    /** Escalation target (user, group, role) */
+    target: EscalationTarget;
+    /** Timeout for human response */
+    timeout?: Duration;
+    /** Fallback action if timeout expires */
+    fallback?: PolicyAction;
+    /** Escalation priority */
+    priority?: 'low' | 'medium' | 'high' | 'critical';
+    /** Notification channels */
+    channels?: NotificationChannel[];
+    /** Escalation metadata */
+    metadata?: Record<string, PolicyValue>;
+}
+/**
+ * Policy evaluation context
+ * Variables accessible via $ prefix in policy expressions
+ */
+export interface PolicyContext {
+    /** Agent metadata */
+    agent: {
+        name: string;
+        version: string;
+        capabilities: string[];
+    };
+    /** Current action being evaluated */
+    action: {
+        type: string;
+        target: string;
+        params: Record<string, PolicyValue>;
+    };
+    /** Cost metrics */
+    cost: {
+        tokens: number;
+        daily: number;
+        monthly: number;
+        currency: string;
+    };
+    /** Performance metrics */
+    performance: {
+        latency: number;
+        throughput: number;
+    };
+    /** Security context */
+    security: {
+        user: string;
+        role: string;
+        permissions: string[];
+    };
+    /** Compliance context */
+    compliance: {
+        frameworks: string[];
+        policies: string[];
+    };
+    /** Time context */
+    time: {
+        timestamp: number;
+        hour: number;
+        day: string;
+        timezone: string;
+    };
+    /** Custom context fields */
+    [key: string]: PolicyValue | Record<string, PolicyValue> | string[] | undefined;
+}
+/**
+ * Complete policy document
+ */
+export interface PolicyDocument {
+    /** Policy identifier */
+    id: string;
+    /** Policy version (semver) */
+    version: string;
+    /** Human-readable description */
+    description?: string;
+    /** Policy rules */
+    rules: PolicyRule[];
+    /** Escalation policies */
+    escalations?: EscalationPolicy[];
+    /** Policy metadata */
+    metadata?: Record<string, PolicyValue>;
+}
+/**
+ * Policy error types
+ */
+export type PolicyErrorType = 'SyntaxError' | 'ValidationError' | 'EvaluationError' | 'EscalationError' | 'ContextError';
+/**
+ * Policy error details
+ */
+export interface PolicyErrorDetails {
+    /** Error type */
+    type: PolicyErrorType;
+    /** Error message */
+    message: string;
+    /** Rule identifier (if applicable) */
+    rule?: string;
+    /** Source location (if applicable) */
+    location?: {
+        line: number;
+        column: number;
+    };
+    /** Additional error context */
+    context?: Record<string, PolicyValue | string[]>;
+}
+/**
+ * Policy error class
+ */
+export declare class PolicyError extends Error {
+    readonly details: PolicyErrorDetails;
+    constructor(details: PolicyErrorDetails);
+}
+/**
+ * Policy evaluation result
+ */
+export interface PolicyEvaluationResult {
+    /** Whether action is allowed */
+    allowed: boolean;
+    /** Effect applied */
+    effect: Effect;
+    /** Matched rule (if any) */
+    rule?: string;
+    /** Action taken */
+    action?: PolicyAction;
+    /** Escalation (if escalated) */
+    escalation?: EscalationPolicy;
+    /** Evaluation errors (if any) */
+    errors?: PolicyErrorDetails[];
+    /** Evaluation metadata */
+    metadata?: {
+        /** Evaluation duration (ms) */
+        duration: number;
+        /** Rules evaluated */
+        rulesEvaluated: number;
+        /** Timestamp */
+        timestamp: number;
+    };
+}
+/**
+ * Policy parser interface
+ */
+export interface PolicyParser {
+    /**
+     * Parse policy DSL string into PolicyDocument
+     */
+    parse(source: string): PolicyDocument;
+    /**
+     * Validate policy document
+     */
+    validate(policy: PolicyDocument): PolicyErrorDetails[];
+}
+/**
+ * Policy evaluator interface
+ */
+export interface PolicyEvaluator {
+    /**
+     * Evaluate policy rules against context
+     */
+    evaluate(policy: PolicyDocument, context: PolicyContext): PolicyEvaluationResult;
+    /**
+     * Evaluate single condition against context
+     */
+    evaluateCondition(condition: PolicyCondition, context: PolicyContext): boolean;
+    /**
+     * Execute policy action
+     */
+    executeAction(action: PolicyAction, context: PolicyContext): Promise<void>;
+}
+/**
+ * Parse duration string (e.g., "15m", "2h")
+ */
+export declare function parseDuration(str: string): Duration;
+/**
+ * Format duration as human-readable string
+ */
+export declare function formatDuration(duration: Duration): string;
+/**
+ * Resolve variable path in context
+ */
+export declare function resolveVariable(variable: Variable, context: PolicyContext): PolicyValue;
+//# sourceMappingURL=policy.d.ts.map

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

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

package/dist/types/policy.js

@@ -0,0 +1,84 @@
+/**
+ * @fileoverview OSSA Policy DSL Type Definitions
+ * @module @openstandardagents/policy
+ * @version 1.0.0
+ *
+ * Formal type definitions for the OSSA Policy Domain-Specific Language.
+ * See docs/specs/policy-dsl.md for full specification.
+ */
+/**
+ * Policy error class
+ */
+export class PolicyError extends Error {
+    details;
+    constructor(details) {
+        super(details.message);
+        this.name = 'PolicyError';
+        this.details = details;
+    }
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Parse duration string (e.g., "15m", "2h")
+ */
+export function parseDuration(str) {
+    const match = str.match(/^(\d+)(s|m|h|d)$/);
+    if (!match) {
+        throw new PolicyError({
+            type: 'ValidationError',
+            message: `Invalid duration format: ${str}`,
+        });
+    }
+    const unitMap = {
+        s: 'seconds',
+        m: 'minutes',
+        h: 'hours',
+        d: 'days',
+    };
+    return {
+        value: parseInt(match[1], 10),
+        unit: unitMap[match[2]],
+    };
+}
+/**
+ * Format duration as human-readable string
+ */
+export function formatDuration(duration) {
+    const unitLabels = {
+        seconds: 'second',
+        minutes: 'minute',
+        hours: 'hour',
+        days: 'day',
+    };
+    const label = unitLabels[duration.unit];
+    return `${duration.value} ${label}${duration.value !== 1 ? 's' : ''}`;
+}
+/**
+ * Resolve variable path in context
+ */
+export function resolveVariable(variable, context) {
+    let value = context;
+    for (const key of variable.path) {
+        if (value === null || value === undefined) {
+            throw new PolicyError({
+                type: 'ContextError',
+                message: `Cannot resolve variable: $${variable.path.join('.')}`,
+                context: { path: variable.path, availableKeys: [] },
+            });
+        }
+        if (typeof value === 'object') {
+            value = value[key];
+        }
+        else {
+            throw new PolicyError({
+                type: 'ContextError',
+                message: `Cannot resolve variable: $${variable.path.join('.')}`,
+                context: { path: variable.path, availableKeys: [] },
+            });
+        }
+    }
+    return value;
+}
+//# sourceMappingURL=policy.js.map

package/dist/types/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/types/policy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA+aH;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpB,OAAO,CAAqB;IAE5C,YAAY,OAA2B;QACrC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAuFD,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,WAAW,CAAC;YACpB,IAAI,EAAE,iBAAiB;YACvB,OAAO,EAAE,4BAA4B,GAAG,EAAE;SAC3C,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAqC;QAChD,CAAC,EAAE,SAAS;QACZ,CAAC,EAAE,SAAS;QACZ,CAAC,EAAE,OAAO;QACV,CAAC,EAAE,MAAM;KACV,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC7B,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KACxB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,QAAkB;IAC/C,MAAM,UAAU,GAAqC;QACnD,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,QAAQ;QACjB,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,KAAK;KACZ,CAAC;IAEF,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,GAAG,QAAQ,CAAC,KAAK,IAAI,KAAK,GAAG,QAAQ,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAkB,EAClB,OAAsB;IAEtB,IAAI,KAAK,GAAY,OAAO,CAAC;IAE7B,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC1C,MAAM,IAAI,WAAW,CAAC;gBACpB,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,6BAA6B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;gBAC/D,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE;aACpD,CAAC,CAAC;QACL,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,KAAK,GAAI,KAAiC,CAAC,GAAG,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,WAAW,CAAC;gBACpB,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,6BAA6B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;gBAC/D,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE;aACpD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,KAAoB,CAAC;AAC9B,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * OSSA Utilities
+ * Common utilities for OSSA CLI and library
+ */
+export * from './version.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,cAAc,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,6 @@
+/**
+ * OSSA Utilities
+ * Common utilities for OSSA CLI and library
+ */
+export * from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,cAAc,CAAC"}

package/dist/utils/version.d.ts

@@ -0,0 +1,68 @@
+/**
+ * OSSA Version Utilities
+ *
+ * Provides dynamic version detection from package.json
+ * NEVER hardcode version strings - use these utilities
+ */
+export interface VersionInfo {
+    /** Full version string (e.g., "0.2.8") */
+    version: string;
+    /** Major version (e.g., 0) */
+    major: number;
+    /** Minor version (e.g., 2) */
+    minor: number;
+    /** Patch version (e.g., 8) */
+    patch: number;
+    /** Prerelease tag if any (e.g., "RC", "beta") */
+    prerelease?: string;
+    /** Schema directory name (e.g., "v0.2.8") */
+    schemaDir: string;
+    /** Schema filename (e.g., "ossa-0.2.8.schema.json") */
+    schemaFile: string;
+    /** Full schema path relative to project root */
+    schemaPath: string;
+    /** API version string for manifests */
+    apiVersion: string;
+}
+/**
+ * Get OSSA version information dynamically from package.json
+ *
+ * @param forceRefresh - If true, bypasses cache and re-reads package.json
+ * @returns VersionInfo object with all version details
+ *
+ * @example
+ * const { version, schemaPath, apiVersion } = getVersionInfo();
+ * console.log(`Using OSSA ${version}`);
+ * console.log(`Schema at: ${schemaPath}`);
+ */
+export declare function getVersionInfo(forceRefresh?: boolean): VersionInfo;
+/**
+ * Get just the version string (convenience function)
+ */
+export declare function getVersion(): string;
+/**
+ * Get the schema path (convenience function)
+ */
+export declare function getSchemaPath(): string;
+/**
+ * Get the API version for manifests (convenience function)
+ */
+export declare function getApiVersion(): string;
+/**
+ * Get the schema directory (e.g., "v0.2.8")
+ */
+export declare function getSchemaDir(): string;
+/**
+ * Check if version is a prerelease
+ */
+export declare function isPrerelease(): boolean;
+/**
+ * Get supported schema versions (for migration, validation)
+ * Returns versions in descending order (newest first)
+ */
+export declare function getSupportedVersions(): string[];
+/**
+ * Resolve absolute path to schema file
+ */
+export declare function resolveSchemaPath(projectRoot?: string): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/utils/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;CACpB;AAoCD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,YAAY,UAAQ,GAAG,WAAW,CAiDhE;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAc/C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9D"}