@misterscan/sesi 1.2.3 → 1.3.2

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

@@ -1,28 +1,28 @@
-// Example 16: Modules and Standard Library Namespace
-// Demonstrates:
-// 1. Importing named variables/functions from standard library modules.
-// 2. Importing custom Sesi modules using relative paths.
-
-print "=== 1. Standard Math Module ==="
-import {PI, E, sqrt, pow, sin} from "std/math"
-print "PI constant:" + str(PI)
-print "Euler's number:" + str(E)
-print "Square root of 144:" + str(sqrt(144))
-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.2.2", "features": ["modules", "http", "parallel"]}
-let json_str = stringify(original)
-print "Serialized JSON string:"
-print json_str
-let restored = parse(json_str)
-print "Deserialized Project Name:" restored["project"]
-print "Deserialized Version:" restored["version"]
-print "=== 3. Custom Sesi Module ==="
-
-// Relative imports let you reuse Sesi code across files cleanly.
-// We will import custom exported variables and functions from a local module.
-import {magic_number, multiply} from "main/tests/temp_math_mod"
-print "Imported magic number from local module:" + str(magic_number)
+// Example 16: Modules and Standard Library Namespace
+// Demonstrates:
+// 1. Importing named variables/functions from standard library modules.
+// 2. Importing custom Sesi modules using relative paths.
+
+print "=== 1. Standard Math Module ==="
+import {PI, E, sqrt, pow, sin} from "std/math"
+print "PI constant:" + str(PI)
+print "Euler's number:" + str(E)
+print "Square root of 144:" + str(sqrt(144))
+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.1", "features": ["modules", "http", "parallel"]}
+let json_str = stringify(original)
+print "Serialized JSON string:"
+print json_str
+let restored = parse(json_str)
+print "Deserialized Project Name:" restored["project"]
+print "Deserialized Version:" restored["version"]
+print "=== 3. Custom Sesi Module ==="
+
+// Relative imports let you reuse Sesi code across files cleanly.
+// We will import custom exported variables and functions from a local module.
+import {magic_number, multiply} from "main/tests/temp_math_mod"
+print "Imported magic number from local module:" + str(magic_number)
 print "Running imported multiply(5, 5):" + str(multiply(5, 5))

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

@@ -0,0 +1,22 @@
+// Example 20: Model Aliases
+// Demonstrates:
+// 1. set_alias(alias, model)
+// 2. Using aliases with model()
+// 3. Using aliases inside workflow() steps
+
+print "=== Registering model aliases ==="
+set_alias("summary", "gemini-3.1-flash-lite")
+set_alias("detailed", "gemini-3-flash-preview")
+print "=== Fast summary call ==="
+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("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": "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/examples/21_custom_tools.sesi

@@ -0,0 +1,27 @@
+// Example 21: Custom Tool Definitions
+// Demonstrates:
+// 1. define_tool(name, fn, description)
+// 2. list_tools()
+// 3. tool_call(customTool)(...)
+
+fn normalizeText(text) {
+  return "normalized: " + text
+}
+fn classifyLength(text) {
+  if len(text) > 30 {
+    return "long"
+  } else {
+    return "short"
+  }
+}
+print "=== Registering custom tools ==="
+define_tool("normalize_text", normalizeText, "Normalize input text for downstream steps")
+define_tool("classify_length", classifyLength, "Classify text by length")
+print "=== Custom tool names ==="
+let names = list_tools()
+print names
+let raw = "Sesi can define and call custom tools at runtime."
+let normalized = tool_call(normalize_text)(raw)
+let label = tool_call(classify_length)(normalized)
+print "normalized -> " normalized
+print "label -> " label

package/examples/22_reasoning_plus_custom_tools.sesi

@@ -0,0 +1,19 @@
+// Example 22: Reasoning + Custom Tools
+// Demonstrates composing model() output with define_tool and tool_call.
+
+set_alias("fast", "gemini-3.1-flash-lite")
+fn toBullet(text) {
+  return "- " + text
+}
+fn addTag(text) {
+  return text + " [ready]"
+}
+define_tool("to_bullet", toBullet, "Convert text to bullet format")
+define_tool("add_tag", addTag, "Append release tag")
+let draft = model("fast") {max_tokens: 180} {"Write one concise launch note for model aliases and custom tools."}
+let bullet = tool_call(to_bullet)(draft)
+let tagged = tool_call(add_tag)(bullet)
+print "Raw draft:"
+print draft
+print "Processed output:"
+print tagged

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/main/tests/test_grounding.sesi

@@ -0,0 +1,2 @@
+let raw = model("gemini-3.1-flash-lite") {search} {"What are the next technological advancements made by Apple? Return JSON with company and advancement"}
+print raw

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@misterscan/sesi",
-  "version": "1.2.3",
-  "description": "Sesi: A High-Performance Systems Language",
+  "version": "1.3.2",
+  "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/security.test.ts",
+    "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/DISTRIBUTED_SYSTEMS.md

@@ -1,71 +0,0 @@
-# Distributed Systems with Sesi
-
-Sesi is a robust systems-level environment capable of orchestrating complex, multi-process agent swarms. This document details how Sesi handles concurrency, race conditions, and distributed state.
-
-## The "Bank Swarm" Case Study
-
-In this experiment, Sesi was used to solve a classic distributed systems problem: **Concurrent Mutual Exclusion.**
-
-### The Challenge
-
-Five independent Sesi agents (3 Deposits, 2 Withdrawals) were launched simultaneously. All agents needed to update a single `balance.txt` file without causing data loss through race conditions.
-
-### The Sesi Solution (The "Double-Check Write" Pattern)
-
-Sesi solves this using a high-level implementation of a filesystem lock. Even without low-level semaphores, Sesi's `try/catch` and file I/O builtins allow for an "indestructible" locking logic.
-
-#### 1. Unique Identity
-
-Each agent generates a globally 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 agents gracefully handle filesystem contention (when the OS prevents two processes from reading the same file at the exact same micro-second).
-
-```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 an entire swarm of agents from one file.
-
-```sesi
-// Master: Launching 5-Agent Swarm
-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.