@quietloudlab/ai-interaction-atlas 1.0.12 → 1.0.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js CHANGED
@@ -2414,13 +2414,13 @@ var DATA_ARTIFACTS = [
2414
2414
  { id: "data_score", name: "Score", category: "system", icon: "gauge", description: "Numerical value (confidence, similarity, etc)", examples: ["0.85 confidence", "0.92 similarity", "Ranking score"], compatible_with: ["All"], format_notes: "Float, typically 0-1" },
2415
2415
  { id: "data_classification", name: "Classification", category: "system", icon: "tag", description: "Categorical label", examples: ["Spam/Not Spam", "Cat/Dog", "Sentiment labels"], compatible_with: ["Classify", "Verify"], format_notes: "String label from taxonomy" },
2416
2416
  { id: "data_signal", name: "Signal", category: "system", icon: "zap", description: "Control flow trigger", examples: ["Start", "Stop", "Alert", "Threshold breach"], compatible_with: ["Monitor", "Act"], format_notes: "Boolean or Enum" },
2417
- { id: "data_log", name: "Log", category: "system", icon: "list", description: "System event record", examples: ["Error trace (.log)", "Audit log", "Access logs"], compatible_with: ["Adapt"], format_notes: "Timestamped structured data" },
2418
- { id: "data_config", name: "Config", category: "system", icon: "settings", description: "System parameters", examples: ["Model settings (.json, .yaml)", "Thresholds (.yml)", "Environment vars (.env)"], compatible_with: ["Adapt"], format_notes: "JSON/YAML" },
2417
+ { id: "data_log", name: "Log", category: "system", icon: "list", description: "System event record", examples: ["Error trace (.log)", "Audit log", "Access logs"], compatible_with: ["Adapt", "Harvest", "Delegate Authority"], format_notes: "Timestamped structured data" },
2418
+ { id: "data_config", name: "Config", category: "system", icon: "settings", description: "System parameters", examples: ["Model settings (.json, .yaml)", "Thresholds (.yml)", "Environment vars (.env)"], compatible_with: ["Adapt", "Delegate Authority"], format_notes: "JSON/YAML" },
2419
2419
  { id: "data_schema", name: "Schema", category: "system", icon: "file-code", description: "Data structure definition", examples: ["JSON Schema (.json)", "SQL Schema (.sql)", "GraphQL Schema (.graphql)"], compatible_with: ["Format"], format_notes: "Formal specification" },
2420
2420
  { id: "data_db_record", name: "DB Record", category: "system", icon: "database", description: "Persisted entity", examples: ["User row", "Product item", "Transaction record"], compatible_with: ["Load", "Save"], format_notes: "ORM Object" },
2421
2421
  { id: "data_api_response", name: "API Response", category: "system", icon: "globe", description: "External service data", examples: ["Weather data (.json)", "Payment status", "REST response"], compatible_with: ["API Call"], format_notes: "JSON/XML" },
2422
2422
  { id: "data_action", name: "Action", category: "system", icon: "zap", description: "Discrete or continuous action", examples: ["Button press", "Motor command", "API call trigger"], compatible_with: ["Act", "Explore"], format_notes: "Enum or Vector" },
2423
- { id: "data_policy", name: "Policy", category: "system", icon: "shield", description: "Decision-making strategy", examples: ["Neural weights (.pt, .ckpt)", "Ruleset (.yaml)", "Decision trees"], compatible_with: ["Plan", "Act"], format_notes: "Model/Function" },
2423
+ { id: "data_policy", name: "Policy", category: "system", icon: "shield", description: "Decision-making strategy", examples: ["Neural weights (.pt, .ckpt)", "Ruleset (.yaml)", "Decision trees"], compatible_with: ["Plan", "Act", "Delegate Authority"], format_notes: "Model/Function" },
2424
2424
  { id: "data_file", name: "File", category: "system", icon: "file", description: "Binary file blob", examples: ["Uploaded document", "Image file", "Archive (.zip, .tar.gz)"], compatible_with: ["Extract", "Translate"], format_notes: "Binary data with MIME type" },
2425
2425
  { id: "data_selection", name: "Selection", category: "system", icon: "check-square", description: "User choice from options", examples: ["Dropdown value", "Checkbox state"], compatible_with: ["Select"], format_notes: "ID or value from option set" },
2426
2426
  { id: "data_group", name: "Group / Cluster", category: "system", icon: "grid", description: "A collection of items grouped by similarity or logic", examples: ["Cluster ID 1", "Folder: Invoices"], compatible_with: ["Synthesize", "Organize"], format_notes: "Object containing {id, label, items[]}" },
@@ -2434,15 +2434,15 @@ var CONSTRAINTS = [
2434
2434
  { id: "const_privacy", name: "Privacy Preserving", category: "quality_safety", icon: "shield-check", description: "Ensures PII is handled correctly.", type: "Policy", applies_to: ["Extract", "Generate"], ux_note: "Display data handling notice.", example_values: "GDPR compliant, anonymize outputs" },
2435
2435
  { id: "const_latency", name: "Latency Budget", category: "performance_resource", icon: "clock", description: "Maximum allowed time for execution.", type: "Milliseconds", applies_to: ["Generate", "Retrieve"], ux_note: "Show loading indicator if exceeded", example_values: "< 200ms for UI, < 5s for batch" },
2436
2436
  { id: "const_confidence", name: "Confidence Threshold", category: "model_technical", icon: "gauge", description: "Minimum score required to act.", type: "Float (0-1)", applies_to: ["Classify", "Detect", "Verify"], ux_note: "Route low-confidence to human review", example_values: "0.85 for automation, 0.95 for safety-critical" },
2437
- { id: "const_human_loop", name: "Human Verification", category: "quality_safety", icon: "user-check", description: "Requires human approval before action.", type: "Workflow", applies_to: ["Act", "Generate"], ux_note: "Add review step in UI.", example_values: "Always for medical/legal, optional for creative" },
2437
+ { id: "const_human_loop", name: "Human Verification", category: "quality_safety", icon: "user-check", description: "Requires human approval before action.", type: "Workflow", applies_to: ["Act", "Generate", "Harvest", "Delegate Authority"], ux_note: "Add review step in UI.", example_values: "Always for medical/legal, optional for creative" },
2438
2438
  { id: "const_rate_limit", name: "Rate Limit", category: "performance_resource", icon: "bar-chart", description: "Max requests per time window.", type: "Integer", applies_to: ["API Call", "Generate"], ux_note: "Queue or throttle requests", example_values: "100 req/min, 1000 req/hour" },
2439
2439
  { id: "const_context_window", name: "Context Window", category: "model_technical", icon: "layers", description: "Token limit for model input.", type: "Integer", applies_to: ["Generate", "Synthesize"], ux_note: "Truncate or chunk long inputs", example_values: "4k, 32k, 128k tokens" },
2440
2440
  { id: "const_tone", name: "Tone & Voice", category: "ux_interaction", icon: "message-circle", description: "Style of generated content.", type: "String", applies_to: ["Generate", "Transform"], ux_note: "Allow user selection", example_values: "Professional, Casual, Friendly, Technical" },
2441
2441
  { id: "const_format", name: "Output Format", category: "data_context", icon: "file-check", description: "Strict structure requirement.", type: "Schema", applies_to: ["Extract", "Generate"], ux_note: "Validate output before returning", example_values: "JSON Schema, Markdown, CSV" },
2442
2442
  { id: "const_authentication", name: "Authentication Required", category: "quality_safety", icon: "key", description: "User or service authentication is required for this operation.", type: "Policy", applies_to: ["API Call", "Load from Database", "Save to Database"], ux_note: "Display login prompt or return 401 if unauthenticated", example_values: "OAuth2, JWT, API key, SSO, mTLS" },
2443
- { id: "const_authorization", name: "Role-Based Access", category: "quality_safety", icon: "shield-check", description: "Access control based on user roles or permissions.", type: "Policy", applies_to: ["API Call", "Generate", "Act", "Load from Database"], ux_note: "Check user roles before allowing action, show permissions error if unauthorized", example_values: "Admin only, Editor role, View-only for guests, RBAC policy" },
2443
+ { id: "const_authorization", name: "Role-Based Access", category: "quality_safety", icon: "shield-check", description: "Access control based on user roles or permissions.", type: "Policy", applies_to: ["API Call", "Generate", "Act", "Load from Database", "Delegate Authority"], ux_note: "Check user roles before allowing action, show permissions error if unauthorized", example_values: "Admin only, Editor role, View-only for guests, RBAC policy" },
2444
2444
  { id: "const_encryption", name: "Encryption Required", category: "quality_safety", icon: "lock", description: "Data must be encrypted in transit and/or at rest.", type: "Policy", applies_to: ["Save to Database", "API Call", "Generate"], ux_note: "Use TLS/HTTPS, encrypt sensitive fields before storage", example_values: "TLS 1.3, AES-256 at rest, End-to-end encryption" },
2445
- { id: "const_cost_budget", name: "Cost Budget", category: "performance_resource", icon: "dollar-sign", description: "Maximum cost allowed per operation or time period.", type: "Currency", applies_to: ["Generate", "Train Model", "API Call", "Retrieve"], ux_note: "Track spending, alert when approaching limit, block if exceeded", example_values: "$0.01 per query, $100 per day, $1000 per month" },
2445
+ { id: "const_cost_budget", name: "Cost Budget", category: "performance_resource", icon: "dollar-sign", description: "Maximum cost allowed per operation or time period.", type: "Currency", applies_to: ["Generate", "Train Model", "API Call", "Retrieve", "Delegate Authority"], ux_note: "Track spending, alert when approaching limit, block if exceeded", example_values: "$0.01 per query, $100 per day, $1000 per month" },
2446
2446
  { id: "const_compute_budget", name: "Compute Budget", category: "performance_resource", icon: "cpu", description: "Maximum compute resources allowed (tokens, GPU hours, API calls).", type: "Integer", applies_to: ["Generate", "Train Model", "Evaluate Model"], ux_note: "Monitor usage, throttle when approaching limit", example_values: "10k tokens per request, 100 GPU hours per month, 1000 API calls per day" },
2447
2447
  { id: "const_system_instruction", name: "System Instruction", category: "ux_interaction", icon: "file-text", description: "Fixed instruction or role definition for AI model behavior.", type: "String", applies_to: ["Generate", "Classify", "Synthesize"], ux_note: "Prepend to all requests, not visible to end user", example_values: "You are a helpful customer service agent, Always respond in Spanish, Be concise and factual" },
2448
2448
  { id: "const_prompt_template", name: "Prompt Template", category: "data_context", icon: "code", description: "Structured prompt format with variable placeholders.", type: "Template String", applies_to: ["Generate", "Transform", "Synthesize"], ux_note: "Inject user data into template, validate parameters", example_values: "Summarize this {document} in {style}, Translate {text} from {source_lang} to {target_lang}" },
@@ -2452,7 +2452,7 @@ var CONSTRAINTS = [
2452
2452
  { id: "const_content_safety", name: "Content Safety Policy", category: "quality_safety", icon: "shield-alert", description: "Filters for toxicity, hate speech, violence, or inappropriate content.", type: "Policy", applies_to: ["Generate", "Classify", "Transform"], ux_note: "Display content warnings, show filtered results, allow user reporting", example_values: "Block hate speech, Flag NSFW content, Age-restrict violent imagery, Filter profanity" },
2453
2453
  { id: "const_error_handling", name: "Error Handling Strategy", category: "ux_interaction", icon: "alert-triangle", description: "How the system responds when operations fail or produce errors.", type: "Strategy", applies_to: ["Generate", "Retrieve", "API Call", "Act"], ux_note: "Show retry button, display error message, offer alternative path, escalate to support", example_values: "Auto-retry 3x with backoff, Show friendly error + support link, Fallback to cached result, Queue for manual review" },
2454
2454
  { id: "const_streaming", name: "Streaming Mode", category: "ux_interaction", icon: "activity", description: "Whether to stream partial results progressively or return complete output.", type: "Boolean", applies_to: ["Generate", "Transform", "Synthesize"], ux_note: "Show typing indicator, display tokens as they arrive, enable cancel mid-stream", example_values: "Stream for chat interfaces, Batch for reports, Progressive for long content" },
2455
- { id: "const_audit_log", name: "Audit Logging", category: "quality_safety", icon: "history", description: "What user actions and system events to log for accountability.", type: "Policy", applies_to: ["Generate", "Act", "API Call", "Train Model", "Classify"], ux_note: "Minimal UI impact, may show 'Activity tracked' notice for transparency", example_values: "Log all AI decisions, Track user prompts + outputs, Record model versions, Capture timestamps + user IDs" },
2455
+ { id: "const_audit_log", name: "Audit Logging", category: "quality_safety", icon: "history", description: "What user actions and system events to log for accountability.", type: "Policy", applies_to: ["Generate", "Act", "API Call", "Train Model", "Classify", "Harvest", "Delegate Authority"], ux_note: "Minimal UI impact, may show 'Activity tracked' notice for transparency", example_values: "Log all AI decisions, Track user prompts + outputs, Record model versions, Capture timestamps + user IDs" },
2456
2456
  { id: "const_quality_threshold", name: "Quality Threshold", category: "model_technical", icon: "award", description: "Minimum acceptable quality score for outputs before showing to users.", type: "Float (0-1)", applies_to: ["Generate", "Extract", "Transform"], ux_note: "Show 'low quality' warning, offer regenerate option, route to human review", example_values: "0.8 for production, 0.6 for drafts, 0.9 for legal/medical, Block below 0.5" },
2457
2457
  { id: "const_user_consent", name: "User Consent", category: "quality_safety", icon: "user-check", description: "When and how to obtain user permission for data processing or AI usage.", type: "Policy", applies_to: ["Generate", "Train Model", "Save to Database", "API Call"], ux_note: "Display consent dialog, provide opt-out option, link to privacy policy, record consent timestamp", example_values: "Prompt before first use, Explicit opt-in for training data, Annual re-consent, Granular per-feature consent" },
2458
2458
  { id: "const_localization", name: "Localization Requirements", category: "ux_interaction", icon: "globe", description: "Language, region, and cultural adaptation requirements for content.", type: "Locale", applies_to: ["Generate", "Transform", "Synthesize", "Classify"], ux_note: "Detect user language, provide language selector, adapt formatting (dates, currency)", example_values: "Support 10 languages, Auto-detect locale, RTL for Arabic/Hebrew, Region-specific examples" },
@@ -2460,7 +2460,7 @@ var CONSTRAINTS = [
2460
2460
  // Execution Behavior Constraints
2461
2461
  { id: "const_autonomy", name: "Autonomous Execution", category: "execution_behavior", icon: "play-circle", description: "Task runs independently in the background and returns results when complete.", type: "Mode", applies_to: ["Generate", "Retrieve", "Orchestrate"], ux_note: "Show background task indicator, provide status updates, allow cancellation", example_values: "Background agent, Async processing, Fire-and-forget, Blocking (wait for result)" },
2462
2462
  { id: "const_parallelism", name: "Parallel Execution", category: "execution_behavior", icon: "git-branch", description: "Multiple operations execute simultaneously for efficiency.", type: "Strategy", applies_to: ["Retrieve", "Generate", "API Call"], ux_note: "Show progress for parallel tasks, handle partial failures gracefully", example_values: "Parallel searches, Concurrent file reads, Batch API calls, Sequential only" },
2463
- { id: "const_timeout", name: "Timeout Limit", category: "execution_behavior", icon: "timer", description: "Maximum time allowed before operation is cancelled.", type: "Duration", applies_to: ["Generate", "Retrieve", "API Call", "Act"], ux_note: "Show timeout warning, provide extend option, handle graceful cancellation", example_values: "30 seconds, 5 minutes, No timeout, User-configurable" },
2463
+ { id: "const_timeout", name: "Timeout Limit", category: "execution_behavior", icon: "timer", description: "Maximum time allowed before operation is cancelled.", type: "Duration", applies_to: ["Generate", "Retrieve", "API Call", "Act", "Delegate Authority"], ux_note: "Show timeout warning, provide extend option, handle graceful cancellation", example_values: "30 seconds, 5 minutes, No timeout, User-configurable" },
2464
2464
  // Code Generation Philosophy Constraints
2465
2465
  { id: "const_minimalism", name: "Minimal Changes", category: "code_philosophy", icon: "minimize", description: "Prefer editing existing code over creating new files or adding unnecessary features.", type: "Principle", applies_to: ["Generate", "Transform"], ux_note: "Surface this principle in code review, show edit vs write statistics", example_values: "Edit over write, Avoid over-engineering, Only change what's needed, YAGNI (You Aren't Gonna Need It)" },
2466
2466
  { id: "const_code_style", name: "Code Style Adherence", category: "code_philosophy", icon: "code", description: "Follow existing codebase patterns and style conventions.", type: "Policy", applies_to: ["Generate", "Transform"], ux_note: "Run linter/formatter, show style violations, auto-fix when possible", example_values: "Match existing patterns, Follow style guide, Preserve indentation, Consistent naming" },