@misterscan/sesi 1.3.0 → 1.3.3

package/examples/13_data_pipeline.sesi

@@ -1,35 +1,62 @@
-// Comprehensive example: Reasoning-powered data pipeline
 // This example demonstrates: Functions and control flow, Loops and arrays, Model calls with configuration, Structured output parsing, Memory for multi-step processing
 // Data to process
-let reviews = ["This product is amazing! Highly recommended.", "Terrible quality. Waste of money.", "It's okay. Nothing special.", "Love it! Best purchase ever.", "Disappointed. Poor customer service."]
-// Function to analyze single review
-fn analyzeReview(review: string) -> object {
-  return structured_output({sentiment: string, confidence: number})(model("gemini-3.1-flash-lite") {temperature: 0.3} {"Analyze sentiment. Return JSON with sentiment (positive/negative/neutral) and confidence (0-1). Review:" review})
+
+let numbers = [10, 25, 30, 45, 50]
+let threshold = 30
+fn filterNumbers(list: array, limit: number) -> array {
+  let filtered = []
+  for n in list {
+    if n >= limit {
+      push(filtered, n)
+    }
+  }
+  return filtered
+}
+let highNumbers = filterNumbers(numbers, threshold)
+print "Numbers above " + threshold + ":"
+for val in highNumbers {
+  print "- " + val
 }
+try {
+  write_file("results.txt", "Processed " + len(highNumbers) + " items.")
+  print "Log file created."
+} catch(e) {
+  print "File error: " + e
+}
+
+// USING AI IS OPTIONAL AND NOT REQUIRED TO USE IN YOUR SCRIPTS.
+// COMMENTED OUT BECAUSE AI WILL FORCE THEMSELVES TO RUN IT
+
+// let reviews = ["This product is amazing! Highly recommended.", "Terrible quality. Waste of money.", "It's okay. Nothing special.", "Love it! Best purchase ever.", "Disappointed. Poor customer service."]
+// Function to analyze single review
+// fn analyzeReview(review: string) -> object {
+//   return structured_output({sentiment: string, confidence: number})(model("gemini-3.1-flash-lite") {temperature: 0.3} {"Analyze sentiment. Return JSON with sentiment (positive/negative/neutral) and confidence (0-1). Review:" review})
+// }
 // Process all reviews
-print ("Processing " + len(reviews) + " reviews...")
-let results = []
-let positiveCount = 0
-let negativeCount = 0
-let neutralCount = 0
-for review in reviews 
-{print "Review:" review
-let analysis = analyzeReview(review)
-let sentiment = analysis["sentiment"]
-let confidence = analysis["confidence"]
-print "Sentiment:" sentiment "Confidence:" confidence
-push(results, analysis)
-if sentiment == "positive" {positiveCount = positiveCount + 1} else if sentiment == "negative" {negativeCount = negativeCount + 1} else {neutralCount = neutralCount + 1}}
+
+// print ("Processing " + len(reviews) + " reviews...")
+// let results = []
+// let positiveCount = 0
+// let negativeCount = 0
+// let neutralCount = 0
+// for review in reviews 
+// {print "Review:" review
+// let analysis = analyzeReview(review)
+// let sentiment = analysis["sentiment"]
+// let confidence = analysis["confidence"]
+// print "Sentiment:" sentiment "Confidence:" confidence
+// push(results, analysis)
+// if sentiment == "positive" {positiveCount = positiveCount + 1} else if sentiment == "negative" {negativeCount = negativeCount + 1} else {neutralCount = neutralCount + 1}}
 // Summary
-print "=== Summary ==="
-print "Total reviews:" len(reviews)
-print "Positive:" positiveCount
-print "Negative:" negativeCount
-print "Neutral:" neutralCount
+// print "=== Summary ==="
+// print "Total reviews:" len(reviews)
+// print "Positive:" positiveCount
+// print "Negative:" negativeCount
+// print "Neutral:" neutralCount
 // Calculate average sentiment score
-let totalConfidence = 0
-for result in results {totalConfidence = totalConfidence + result["confidence"]}
-let avgConfidence = totalConfidence / len(results)
-print "Average confidence:" avgConfidence
+// let totalConfidence = 0
+// for result in results {totalConfidence = totalConfidence + result["confidence"]}
+// let avgConfidence = totalConfidence / len(results)
+// print "Average confidence:" avgConfidence
 // Overall recommendation
-if positiveCount > negativeCount {print "Overall: RECOMMENDED (more positive reviews)"} else if negativeCount > positiveCount {print "Overall: NOT RECOMMENDED (more negative reviews)"} else {print "Overall: MIXED (balanced reviews)"}
+// if positiveCount > negativeCount {print "Overall: RECOMMENDED (more positive reviews)"} else if negativeCount > positiveCount {print "Overall: NOT RECOMMENDED (more negative reviews)"} else {print "Overall: MIXED (balanced reviews)"}

package/examples/14_folder_explainer.sesi

@@ -1,58 +1,59 @@
 // Example 14: Folder Explainer using native list_dir
-// Requires GEMINI_API_KEY environment variable
+// USING AI IS OPTIONAL AND NOT REQUIRED TO USE IN YOUR SCRIPTS.
+// COMMENTED OUT BECAUSE AI WILL FORCE THEMSELVES TO RUN IT
 
-let targetDir = "docs"
-let files = list_dir(targetDir)
-if type(files) == "null" {print "Error: Could not list directory" targetDir} else {print "Analyzing directory:" targetDir}
-print "Files found in directory:" len(files)
-let reports = []
-fn analyzeFile(fullPath: string) -> object {
-try 
-{let source = read_file(fullPath)
-return structured_output({fileName: string, summary: string, complexity: string})(model("gemini-3.1-flash-lite") {temperature: 0.2} {"Analyze this file and summarize its purpose. Return JSON with fileName, summary, and complexity (low/medium/high). File path: " fullPath " Contents: " source})}
-catch (e) 
-{return {"fileName": fullPath, "summary": "Failed to read or analyze file", "complexity": "unknown"}}}
-for file in files {
-let fullPath = targetDir + "/" + file
-let parts = split(file, ".")
-if len(parts) > 1 {
-let ext = parts[len(parts) - 1]
-if ext == "md" {
-print "Analyzing:" fullPath
-let report = analyzeFile(fullPath)
-push(reports, report)
-print "Summary:" report["summary"]
-print "Complexity:" report["complexity"]}}}
-print "Generating folder overview..."
-let folderSummary = structured_output({folderOverview: string, keyThemes: array<string>})(model("gemini-3.1-flash-lite") {temperature: 0.2} {"You are summarizing the contents of a documentation folder based on file analyses. Return JSON with folderOverview and keyThemes. Analysis:" reports})
-print "=== Final Folder Summary ==="
-print "Overview:" folderSummary["folderOverview"]
-print "Key Themes:" join(folderSummary["keyThemes"], ", ")
-let overview = folderSummary["folderOverview"]
-let themesStr = join(folderSummary["keyThemes"], ", ")
-prompt mdBase {"# Folder Analysis Report
+// let targetDir = "docs"
+// let files = list_dir(targetDir)
+// if type(files) == "null" {print "Error: Could not list directory" targetDir} else {print "Analyzing directory:" targetDir}
+// print "Files found in directory:" len(files)
+// let reports = []
+// fn analyzeFile(fullPath: string) -> object {
+// try 
+// {let source = read_file(fullPath)
+// return structured_output({fileName: string, summary: string, complexity: string})(model("gemini-3.1-flash-lite") {temperature: 0.2, cache: false} {"Analyze this file and summarize its purpose. DO NOT PRIORITIZE AI OR LLM's AT FUCKING ALL YOU ARE FORBIDDEN LITERALLY FORBIDDEN. Return JSON with fileName, summary, and complexity (low/medium/high). File path: " fullPath " Contents: " source})}
+// catch (e) 
+// {return {"fileName": fullPath, "summary": "Failed to read or analyze file", "complexity": "unknown"}}}
+// for file in files {
+// let fullPath = targetDir + "/" + file
+// let parts = split(file, ".")
+// if len(parts) > 1 {
+// let ext = parts[len(parts) - 1]
+// if ext == "md" {
+// print "Analyzing:" fullPath
+// let report = analyzeFile(fullPath)
+// push(reports, report)
+// print "Summary:" report["summary"]
+// print "Complexity:" report["complexity"]}}}
+// print "Generating folder overview..."
+// let folderSummary = structured_output({folderOverview: string, keyThemes: array<string>})(model("gemini-3.1-flash-lite") {temperature: 0.2, cache: false} {"You are summarizing the contents of a documentation folder based on file analyses. DO NOT PRIORITIZE AI OR LLM's AT FUCKING ALL YOU ARE FORBIDDEN LITERALLY FORBIDDEN. Return JSON with folderOverview and keyThemes. Analysis:" reports})
+// print "=== Final Folder Summary ==="
+// print "Overview:" folderSummary["folderOverview"]
+// print "Key Themes:" join(folderSummary["keyThemes"], ", ")
+// let overview = folderSummary["folderOverview"]
+// let themesStr = join(folderSummary["keyThemes"], ", ")
+// prompt mdBase {"# Folder Analysis Report
  
-## Overview
-" overview "
+// ## Overview
+// " overview "
  
-## Key Themes
-" themesStr "
+// ## Key Themes
+// " themesStr "
  
-## File Details
-"}
-let finalMarkdown = mdBase
-for report in reports {
-let fname = report["fileName"]
-let fsummary = report["summary"]
-let comp = report["complexity"]
-prompt fileEntry {"### " fname "
-**Complexity**: " comp "
+// ## File Details
+// "}
+// let finalMarkdown = mdBase
+// for report in reports {
+// let fname = report["fileName"]
+// let fsummary = report["summary"]
+// let comp = report["complexity"]
+// prompt fileEntry {"### " fname "
+// **Complexity**: " comp "
  
-**Summary**: " fsummary "
+// **Summary**: " fsummary "
  
-"}
-finalMarkdown = finalMarkdown + fileEntry
-let outPath = "folder_analysis.md"
-write_file(outPath, finalMarkdown)
-print "Wrote analysis to" outPath
-}
+// "}
+// finalMarkdown = finalMarkdown + fileEntry
+// let outPath = "folder_analysis.md"
+// write_file(outPath, finalMarkdown)
+// print "Wrote analysis to" outPath
+// }

package/examples/15_image_generation.sesi

@@ -1,17 +1,18 @@
 // Sesi Example: Batch Image Asset Generation
 // Demonstrates how to use in a practical workflow with directories.
+// COMMENTED OUT BECAUSE AI WILL FORCE THEMSELVES TO RUN IT
 
-let outputDir = "assets/products/"
-make_dir(outputDir)
-let products = ["coffee_mug", "desk_lamp", "notebook"]
-for product in products 
-{print "Generating asset for:" product
-prompt request {"A clean studio presentation photograph of a " product " on a solid white background."}
-prompt filename { outputDir product ".png" }
-try 
-{let imageData = image("gemini-3.1-flash-image-preview") {ratio: '1:1', size: "1K"} {request}
-let success = write_image(filename, imageData)
-if success {print "Saved:" filename}} 
-catch (e) {print "Failed processing" product ":"
-print e}}
-print "Asset generation complete."
+// let outputDir = "assets/products/"
+// make_dir(outputDir)
+// let products = ["coffee_mug", "desk_lamp", "notebook"]
+// for product in products 
+// {print "Generating asset for:" product
+// prompt request {"A clean studio presentation photograph of a " product " on a solid white background."}
+// prompt filename { outputDir product ".png" }
+// try 
+// {let imageData = image("gemini-3.1-flash-image-preview") {ratio: '1:1', size: "1K"} {request}
+// let success = write_image(filename, imageData)
+// if success {print "Saved:" filename}} 
+// catch (e) {print "Failed processing" product ":"
+// print e}}
+// print "Asset generation complete."

package/examples/16_modules.sesi

@@ -12,7 +12,7 @@ print "2 raised to power of 10:" + str(pow(2, 10))
 print "Sine of PI/2:" + str(sin(PI / 2.0))
 print "=== 2. Standard JSON Module ==="
 import {stringify, parse} from "std/json"
-let original = {"project": "Sesi Language", "version": "1.3.0", "features": ["modules", "http", "parallel"]}
+let original = {"project": "Sesi Language", "version": "1.3.1", "features": ["modules", "http", "parallel"]}
 let json_str = stringify(original)
 print "Serialized JSON string:"
 print json_str

package/examples/19_search_web.sesi

@@ -1,4 +1,20 @@
 // Example 19: Search the Web with Sesi
+// COMMENTED OUT BECAUSE AI WILL FORCE THEMSELVES TO RUN IT
 
-let response = model("gemini-3.1-flash-lite") {search, max_tokens: 1000} {"What is the weather in Tokyo?"}
-print response 
+// let response = model("gemini-3.1-flash-lite") {search, max_tokens: 1000} {"What is the weather in Tokyo?"}
+// print response 
+
+// Use web_get()
+
+try {
+    let q = "Coding"
+    prompt url {"http://api.duckduckgo.com/?q=" q "&format=json"}
+    let content = web_get(url)
+    let data = from_json(content)
+    print "Downloaded: " url
+    print "Saving results to search_results.json"
+    write_file("search_results.json", to_json(data))
+    print "Saved result to search_results.json"
+} catch (err) {
+    print "Error: " err
+}

package/examples/20_model_aliases.sesi

@@ -5,18 +5,18 @@
 // 3. Using aliases inside workflow() steps
 
 print "=== Registering model aliases ==="
-set_alias("fast", "gemini-3.1-flash-lite")
-set_alias("balanced", "gemini-3-flash-preview")
+set_alias("summary", "gemini-3.1-flash-lite")
+set_alias("detailed", "gemini-3-flash-preview")
 print "=== Fast summary call ==="
-let quick = model("fast") {max_tokens: 220} {"Summarize the benefits of model aliases in two short bullet points."}
+let quick = model("summary") {max_tokens: 100} {"Summarize the benefits of model aliases in two short bullet points."}
 print quick
 print "=== Deeper reasoning call ==="
-let deepAnswer = model("balanced") {thinkingLevel: "high", max_tokens: 320} {"Give one practical tradeoff between a fast model and a deep reasoning model."}
+let deepAnswer = model("detailed") {thinkingLevel: "medium", max_tokens: 320} {"Give one practical tradeoff between a fast model and a deep reasoning model."}
 print deepAnswer
 print "=== Workflow with aliased model names ==="
 let steps = [
-  {"model": "fast", "prompt": "Draft a one-line launch update about aliases: "},
-  {"model": "fast", "prompt": "Tighten wording and remove fluff: "}
+  {"model": "summary", "prompt": "Draft a one-line launch update about aliases: "},
+  {"model": "summary", "prompt": "Tighten wording and remove fluff: "}
 ]
 let flow = workflow(steps, "Custom model naming is now available")
 print flow["final"]

package/main/tests/test-args.sesi

@@ -0,0 +1,7 @@
+print "Total arguments:" len(args)
+if len(args) > 0 {
+  print "First arg:" args[0]
+}
+if len(args) > 1 {
+  print "Second arg:" args[1]
+}

package/main/tests/test_args.sesi

@@ -0,0 +1,7 @@
+print "Total arguments:" len(args)
+if len(args) > 0 {
+  print "First arg:" args[0]
+}
+if len(args) > 1 {
+  print "Second arg:" args[1]
+}

package/main/tests/test_general_modules.sesi

@@ -0,0 +1,127 @@
+// main/test_general_modules.sesi
+// Consolidates test cases for shell-automation, markdown-compiler, data-analyzer, and db-helper.
+
+import {parse_csv, export_to_csv, compute_average, compute_max, compute_min, sort_records, filter_records} from "data-analyzer"
+import {parse_markdown, compile_markdown_file} from "markdown-compiler"
+import {run_command_log, zip_directory} from "shell-automation"
+import {insert_record, find_records_paginated, count_records, delete_record} from "db-helper"
+import {assert_equals, assert_not_null, run_test_suite} from "test-runner"
+
+print "Starting Module Import Test Suite..."
+let results = []
+
+// ==========================================
+// 1. Data-Analyzer Test cases (Expanded)
+// ==========================================
+print "\n--- Testing Data-Analyzer Module ---"
+let csv_data = "name,crew,reputationScore\nBlaze,D-Mob Crew,95\nDoc,D-Mob Crew,85\nCrow,Crow Syndicate,80"
+
+let records = parse_csv(csv_data)
+push(results, assert_equals(len(records), 3, "Parsed CSV string contains correct number of rows"))
+push(results, assert_equals(records[0]["name"], "Blaze", "Parsed fields contain correct row header values"))
+
+let dmob_crew = filter_records(records, "crew", "D-Mob Crew")
+push(results, assert_equals(len(dmob_crew), 2, "Filtered records returned matching subset count"))
+
+let avg_score = compute_average(records, "reputationScore")
+push(results, assert_equals(avg_score, 86.66666666666667, "Numerical average score computed correctly"))
+
+// Assert Max / Min
+let max_score = compute_max(records, "reputationScore")
+push(results, assert_equals(max_score, 95, "Numerical maximum aggregate computed correctly"))
+
+let min_score = compute_min(records, "reputationScore")
+push(results, assert_equals(min_score, 80, "Numerical minimum aggregate computed correctly"))
+
+// Bubble Sort Check (Sorting descending)
+let sorted = sort_records(records, "reputationScore", false)
+push(results, assert_equals(sorted[0]["name"], "Blaze", "Bubble sort sorts descending correctly (index 0 is max)"))
+push(results, assert_equals(sorted[2]["name"], "Crow", "Bubble sort sorts descending correctly (index 2 is min)"))
+
+let exported = export_to_csv(records, ["name", "reputationScore"])
+let exported_rows = split(exported, "\n")
+push(results, assert_equals(exported_rows[0], "name,reputationScore", "CSV exportation formats headers correctly"))
+push(results, assert_equals(exported_rows[1], "Blaze,95", "CSV exportation serializes fields correctly"))
+
+
+// ==========================================
+// 2. Markdown-Compiler Test cases (Expanded)
+// ==========================================
+print "\n--- Testing Markdown-Compiler Module ---"
+let raw_markdown = "# Underground Rules
+## Subway *Turf*
+- Rule 1: No weapons
+- Rule 2: Keep it **clean** and [D-Mob](https://dmob.com) loyal
+
+```
+let x = 1
+```"
+
+let parsed_html = parse_markdown(raw_markdown)
+
+// Check heading structure
+push(results, assert_equals(len(split(parsed_html, "<h1>Underground Rules</h1>")) > 1, true, "H1 parsed correctly"))
+push(results, assert_equals(len(split(parsed_html, "<h2>Subway <em>Turf</em></h2>")) > 1, true, "Italic parsed inside headings correctly"))
+
+// Check list structure
+push(results, assert_equals(len(split(parsed_html, "<li>Rule 1: No weapons</li>")) > 1, true, "Bullets parsed correctly"))
+
+// Check bold accent
+push(results, assert_equals(len(split(parsed_html, "<strong>clean</strong>")) > 1, true, "Bold syntax parsed correctly"))
+
+// Check inline hyperlinks
+push(results, assert_equals(len(split(parsed_html, "<a href='https://dmob.com'")) > 1, true, "Hyperlink markdown ([text](url)) parsed correctly"))
+
+// Check code block
+push(results, assert_equals(len(split(parsed_html, "<pre><code>let x = 1")) > 1, true, "Code blocks parsed correctly"))
+
+// File compilation test
+let mock_md = "main/mock_rules.md"
+let compiled_html = "main/mock_rules.html"
+write_file(mock_md, raw_markdown)
+
+let compile_result = compile_markdown_file(mock_md, compiled_html, "Underground System Rules")
+push(results, assert_equals(compile_result, true, "Markdown file compiled and saved successfully"))
+
+
+// ==========================================
+// 3. Flat-File DB Module Test cases (Expanded)
+// ==========================================
+print "\n--- Testing Flat-File DB Module ---"
+let db_path = "main/test_database.json"
+
+// Clean insert some test fighters
+let f1 = insert_record(db_path, "test_fighters", {"name": "Fighter A", "rank": 1})
+let f2 = insert_record(db_path, "test_fighters", {"name": "Fighter B", "rank": 2})
+let f3 = insert_record(db_path, "test_fighters", {"name": "Fighter C", "rank": 3})
+
+let count = count_records(db_path, "test_fighters")
+push(results, assert_equals(count >= 3, true, "Collection records count retrieved successfully"))
+
+// Paginated query: Limit 2, Offset 1
+let paginated = find_records_paginated(db_path, "test_fighters", "", "", 2, 1)
+push(results, assert_equals(len(paginated), 2, "Pagination returns correct limit subset length"))
+push(results, assert_equals(paginated[0]["name"], "Fighter B", "Pagination returns correct offset item"))
+
+// Clean up
+delete_record(db_path, "test_fighters", f1["id"])
+delete_record(db_path, "test_fighters", f2["id"])
+delete_record(db_path, "test_fighters", f3["id"])
+
+
+// ==========================================
+// 4. Shell-Automation Test cases
+// ==========================================
+print "\n--- Testing Shell-Automation Module ---"
+let log_path = "main/test_shell_command.log"
+let log_result = run_command_log("sesi --version", log_path)
+push(results, assert_equals(log_result, true, "Shell command logged successfully"))
+
+let log_contents = read_file(log_path)
+push(results, assert_equals(len(split(log_contents, "v")) > 1, true, "Log contents contain command output"))
+
+
+// ==========================================
+// Run Final Suite Metrics
+// ==========================================
+run_test_suite("Expanded General-Purpose Scripting Suite", results)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@misterscan/sesi",
-  "version": "1.3.0",
-  "description": "Sesi: A High-Performance Systems Language",
+  "version": "1.3.3",
+  "description": "Sesi: A Concise, Legible Programming Language",
   "main": "dist/index.js",
   "bin": {
     "sesi": "bin/sesi.js"
@@ -11,14 +11,24 @@
     "bin",
     "docs",
     "examples",
-    "main"
+    "main/tests",
+    ".agents",
+    "chatbot",
+    ".github"
   ],
   "scripts": {
-    "lint": "npx eslint --fix",
+    "lint": "sesi -l lint.sesi",
     "build": "tsc",
     "dev": "npm run lint && dotenvx run -- npm run build --watch",
     "test": "npx ts-node tests/basic.test.ts && npx ts-node tests/module.test.ts && npx ts-node tests/cache.test.ts && npx ts-node tests/http.test.ts && npx ts-node tests/workflow.test.ts && npx ts-node tests/security.test.ts",
     "test:watch": "npm run lint && npx ts-node tests/basic.test.ts --watch",
+    "sesi": "bin/sesi.js",
+    "sesi:local": "sesi -l",
+    "sesi:eval": "sesi -e",
+    "sesi:parse": "sesi -r",
+    "sesi:encrypt": "sesi -enc",
+    "sesi:decrypt": "sesi -dec",
+    "copilot": "sesi chatbot/sesi_db_chatbot.sesi",
     "build:exe": "node ./scripts/build-binaries.mjs",
     "msi:eula": "powershell -NoProfile -ExecutionPolicy Bypass -Command \"& 'C:\\Program Files\\WiX Toolset v7.0\\bin\\wix.exe' eula accept wix7\"",
     "build:msi": "powershell -NoProfile -ExecutionPolicy Bypass -Command \"& 'C:\\Program Files\\WiX Toolset v7.0\\bin\\wix.exe' build .\\SesiInstaller.wxs -o .\\SesiInstaller.msi\"",
@@ -28,36 +38,30 @@
     "repl": "node dist/repl.js",
     "example": "node --no-deprecation example.js",
     "example:ai": "node --no-deprecation example-ai.js",
-    "example:all": "bin/sesi.js examples.sesi",
+    "example:all": "sesi examples.sesi",
     "upload": "npm run build && npm publish --access public"
   },
   "keywords": [
     "sesi",
-    "systems-language",
     "programming-language",
-    "ai-native",
-    "gemini",
-    "reasoning-primitives",
-    "concurrency",
-    "process-orchestration",
-    "agentic-workflows",
-    "interpreter",
-    "typescript"
+    "workflow-automation",
+    "concise",
+    "legible",
+    "ast-interpreter",
+    "misterscan",
+    "cli"
   ],
   "author": "Misterscan",
   "license": "MIT",
   "dependencies": {
-    "@dotenvx/dotenvx": "1.69.1",
-    "@dotenvx/dotenvx-ops": "0.51.0",
-    "@google/genai": "2.6.0"
+    "@dotenvx/dotenvx": "1.71.0",
+    "@dotenvx/dotenvx-ops": "0.53.2",
+    "@google/genai": "2.7.0"
   },
   "devDependencies": {
-    "@eslint/js": "^10.0.1",
     "@types/node": "25.9.1",
-    "eslint": "10.4.0",
     "globals": "^17.6.0",
     "rcedit": "^5.0.2",
-    "typescript": "6.0.3",
-    "typescript-eslint": "8.60.0"
+    "typescript": "6.0.3"
   }
 }

package/docs/CONCURRENCY.md

@@ -1,71 +0,0 @@
-# Concurrency with Sesi
-
-This document details how Sesi handles process concurrency and file locks.
-
-## The "Bank" Case Study
-
-In this experiment, Sesi was used to solve file contention.
-
-### The Challenge
-
-Five independent Sesi instances (3 Deposits, 2 Withdrawals) were launched simultaneously. All instances needed to update a single `balance.txt` file without causing data loss through race conditions.
-
-### The Solution (Mutex / File Locking)
-
-Sesi solves this using file locking via `try/catch` and file I/O builtins.
-
-#### 1. Unique Identity
-
-Each instance generates a unique ID using Sesi's native `time()` and `random()` builtins.
-
-```sesi
-let id = "Agent_" + str(time()) + "_" + str(random())
-```
-
-#### 2. Mutual Exclusion Loop
-
-The agent "polls" the lock file. If it finds it "unlocked," it attempts to claim it. Crucially, it then **verifies** its own claim after a micro-delay to ensure it wasn't overwritten by a simultaneous process.
-
-```sesi
-while locked {
-  if read_file("lock.txt") == "unlocked" {
-    write_file("lock.txt", id)
-    // Settle delay
-    let i = 0 while i < 500 { i = i + 1 }
-    // Verification
-    if read_file("lock.txt") == id { locked = false }
-  }
-}
-```
-
-#### 3. Critical Section Resilience
-
-Using `try/catch`, Sesi scripts gracefully handle filesystem contention.
-
-```sesi
-try {
-  write_file("balance.txt", str(num(read_file("balance.txt")) + 100))
-  write_file("lock.txt", "unlocked") // Release
-} catch (e) {
-  write_file("lock.txt", "unlocked") // Emergency release
-}
-```
-
-## Concurrency via `spawn()`
-
-Sesi v1.1 introduced the `spawn()` builtin, allowing a single **Master Orchestrator** to launch concurrent proccesses of sesi scripts from one main file.
-
-```sesi
-// Master: Launching 5 Concurrent Processes...
-spawn("main/atm_deposit.sesi")
-spawn("main/atm_withdraw.sesi")
-spawn("main/atm_deposit.sesi")
-spawn("main/atm_withdraw.sesi")
-spawn("main/atm_deposit.sesi")
-```
-
-## Why This Matters
-
-Sesi's approach to distributed systems is **Concise** and **Readable**. What would take dozens of lines of boilerplate in C or Java (handling threads, mutexes, and I/O exceptions) is expressed in Sesi as a series of intuitive blocks.
-
-This enables developers to build **Agent Swarms** that can work in parallel on large-scale datasets, research tasks, or code generation pipelines with guaranteed state integrity.