@misterscan/sesi 1.1.1

package/examples/14_folder_explainer.sesi

@@ -0,0 +1,58 @@
+// Example 14: Folder Explainer using native list_dir
+// Requires GEMINI_API_KEY environment variable
+
+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
+ 
+## Overview
+" overview "
+ 
+## 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 "
+ 
+**Summary**: " fsummary "
+ 
+"}
+finalMarkdown = finalMarkdown + fileEntry
+let outPath = "folder_analysis.md"
+write_file(outPath, finalMarkdown)
+print "Wrote analysis to" outPath
+}

package/examples/15_image_generation.sesi

@@ -0,0 +1,17 @@
+// Sesi Example: Batch Image Asset Generation
+// Demonstrates how to use in a practical workflow with directories.
+
+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/main/atm_deposit.sesi

@@ -0,0 +1,37 @@
+let id = "Dep_" + str(time()) + "_" + str(random())
+let locked = true
+while locked {
+  let status = "error"
+  try {
+    status = read_file("bank/lock.txt")
+  } catch (e) {
+    status = "error"
+  }
+  if status == "unlocked" {
+    try {
+      write_file("bank/lock.txt", id)
+      let i = 0
+      while i < 500 {
+        i = i + 1
+      }
+      if read_file("bank/lock.txt") == id {
+        locked = false
+      }
+    } catch (e) {
+      status = "error"
+    }
+  } else {
+    let j = 0
+    while j < 1000 {
+      j = j + 1
+    }
+  }
+}
+try {
+  write_file("bank/balance.txt", str(num(read_file("bank/balance.txt")) + 100))
+  write_file("bank/done_count.txt", str(num(read_file("bank/done_count.txt")) + 1))
+  write_file("bank/lock.txt", "unlocked")
+  print id + ": Success"
+} catch (e) {
+  write_file("bank/lock.txt", "unlocked")
+}

package/main/atm_withdraw.sesi

@@ -0,0 +1,37 @@
+let id = "With_" + str(time()) + "_" + str(random())
+let locked = true
+while locked {
+  let status = "error"
+  try {
+    status = read_file("bank/lock.txt")
+  } catch (e) {
+    status = "error"
+  }
+  if status == "unlocked" {
+    try {
+      write_file("bank/lock.txt", id)
+      let i = 0
+      while i < 500 {
+        i = i + 1
+      }
+      if read_file("bank/lock.txt") == id {
+        locked = false
+      }
+    } catch (e) {
+      status = "error"
+    }
+  } else {
+    let j = 0
+    while j < 1000 {
+      j = j + 1
+    }
+  }
+}
+try {
+  write_file("bank/balance.txt", str(num(read_file("bank/balance.txt")) - 50))
+  write_file("bank/done_count.txt", str(num(read_file("bank/done_count.txt")) + 1))
+  write_file("bank/lock.txt", "unlocked")
+  print id + ": Success"
+} catch (e) {
+  write_file("bank/lock.txt", "unlocked")
+}

package/main/data.txt

@@ -0,0 +1 @@
+Project X Status: Delayed. Reason: Scope creep. Priority: High.

package/main/math_aggregator.sesi

@@ -0,0 +1,15 @@
+// Math Swarm: Aggregator
+print "📊 Aggregator: Waiting for primes..."
+let input = ""
+while input == "" {input = read_file("swarm/primes.txt")}
+let primes = split(input, ",")
+let sum = 0
+for pStr in primes {
+  if pStr != "" {
+    sum = sum + num(pStr)
+  }
+}
+print "📊 Aggregator Result: "
+print "Count: " + str(len(primes))
+print "Sum: " + str(sum)
+write_file("swarm/final.txt", "Count:" + str(len(primes)) + " Sum:" + str(sum))

package/main/math_generator.sesi

@@ -0,0 +1,7 @@
+// Math Swarm: Generator
+print "🔢 Generator: Creating data set..."
+let data = []
+for i = 1 to 100 
+{push(data, str(i))}
+write_file("swarm/input.txt", join(data, ","))
+print "Generator: Data set of 100 numbers published."

package/main/math_processor.sesi

@@ -0,0 +1,23 @@
+// Math Swarm: Prime Processor
+fn isPrime(n: number) -> bool {
+  if n <= 1 {return false}
+  let i = 2
+  while i * i <= n {
+    if n % i == 0 {return false}
+    i = i + 1
+  }
+  return true
+}
+print "🧬 Processor: Waiting for input..."
+let input = ""
+while input == "" {input = read_file("swarm/input.txt")}
+let numbers = split(input, ",")
+let primes = []
+for nStr in numbers {
+  if nStr != "" {
+    let n = num(nStr)
+    if isPrime(n) {push(primes, nStr)}
+  }
+}
+write_file("swarm/primes.txt", join(primes, ","))
+print "Processor: Filtered " + str(len(primes)) + " primes."

package/main/orchestrator.sesi

@@ -0,0 +1,15 @@
+print "🚀 Master: Launching 5-Agent Swarm..."
+make_dir("bank")
+write_file("bank/balance.txt", "1000")
+write_file("bank/lock.txt", "unlocked")
+write_file("bank/done_count.txt", "0")
+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")
+let finished = false
+while !finished {let countStr = read_file("bank/done_count.txt")
+if countStr != "" {if num(countStr) >= 5 {finished = true}}}
+print "🏦 Vault: Swarm Finished."
+print "Final Balance:" read_file("bank/balance.txt")

package/main/playground.sesi

@@ -0,0 +1 @@
+// Use this file to test controlled Sesi scripts, with logging and prompts to test model interactions.

package/main/setup_swarm.sesi

@@ -0,0 +1,5 @@
+// Sesi Swarm Setup
+make_dir("swarm")
+write_file("swarm/input.txt", "")
+write_file("swarm/primes.txt", "")
+print "🚀 Swarm Workspace Ready."

package/main/start.sesi

@@ -0,0 +1,13 @@
+// Welcome to your first Sesi program!
+
+print "Initializing..."
+
+// You can start with a simple calculation
+let a = 10
+let b = 5
+print "Math check:" a + b
+
+// Or jump straight into reasoning tasks
+let topic = "building a new programming language"
+let response = model("gemini-3.1-flash-lite") {"temperature": 0.3} {"Write a motivational 2-sentence intro about" topic}
+print "Sesi:" response

package/main/tax_calculator.sesi

@@ -0,0 +1,15 @@
+// Complex Tax Calculator in Sesi
+fn calculate_income_tax(income: number, dependents: number) -> number 
+{let standard_deduction = 14600
+let dependent_deduction = dependents * 2000
+let taxable_income = income - standard_deduction - dependent_deduction
+if taxable_income <= 0 {return 0}
+let tax = 0
+if taxable_income <= 11600 {tax = taxable_income * 0.10} else if taxable_income <= 47150 {tax = (11600 * 0.10) + ((taxable_income - 11600) * 0.12)} else if taxable_income <= 100525 {tax = (11600 * 0.10) + ((47150 - 11600) * 0.12) + ((taxable_income - 47150) * 0.22)} else {tax = (11600 * 0.10) + ((47150 - 11600) * 0.12) + ((100525 - 47150) * 0.22) + ((taxable_income - 100525) * 0.24)}
+let self_employment_tax = income * 0.153
+return tax + self_employment_tax}
+let income = 85000
+let dependents = 2
+let total_tax = calculate_income_tax(income, dependents)
+print "Total calculated tax for income" income
+print "Tax liability is:" total_tax

package/main/tests/compare.sesi

@@ -0,0 +1,23 @@
+// Sesi Complex Data Pipeline
+// Native structured outputs, tool calling, and memory.
+
+fn escalateTicket(customerId: string, reason: string) {
+  print "ESCALATION: Customer" customerId "for" reason
+  return "Escalation logged."
+}
+memory processingLog {"Pipeline Start:"}
+let rawFeedback = ["My account was charged twice for the pro plan! Fix this now!", "The new dashboard is really clean, great job team.", "I can't figure out how to export my data to CSV, it just spins."]
+for feedback in rawFeedback 
+{processingLog = processingLog + "Processing:" + feedback
+
+// 1. Structured Data Extraction (Native syntax)
+let analysis = structured_output({sentiment: string, category: string, isUrgent: bool, summary: string})
+(model("gemini-3.1-flash-lite") {"Analyze the customer feedback. Category should be Billing, UI, or Technical. Feedback: " feedback})
+print "Result for:" analysis["summary"]
+  
+// 2. Conditional Tool Calling (Native syntax)
+if analysis["isUrgent"] 
+{let resolution = tool_call(escalateTicket)(model("gemini-3.1-flash-lite") {"Call escalateTicket for customer '1234' with an exact reason based on: " feedback})
+processingLog = processingLog + "Urgent action taken: " + resolution} else {processingLog = processingLog + "Logged routinely."}}
+print "--- Final Processing Log ---"
+print processingLog

package/main/tests/compare.ts

@@ -0,0 +1,104 @@
+import { GoogleGenAI, Type } from "@google/genai";
+
+const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
+
+// The tool we want the model to call
+function escalateTicket(customerId: string, reason: string): string {
+  console.log(`ESCALATION: Customer ${customerId} for ${reason}`);
+  return "Escalation logged.";
+}
+
+// 1. Tool Declaration for the SDK (Boilerplate)
+const escalateToolDeclaration = {
+  functionDeclarations: [
+    {
+      name: "escalateTicket",
+      description: "Escalate an urgent customer ticket",
+      parameters: {
+        type: Type.OBJECT,
+        properties: {
+          customerId: { type: Type.STRING, description: "ID of the customer" },
+          reason: { type: Type.STRING, description: "Reason for escalation" }
+        },
+        required: ["customerId", "reason"]
+      }
+    }
+  ]
+};
+
+async function processFeedback() {
+  let processingLog = "Pipeline Start:\n";
+  
+  const rawFeedback = [
+    "My account was charged twice for the pro plan! Fix this now!",
+    "The new dashboard is really clean, great job team.",
+    "I can't figure out how to export my data to CSV, it just spins."
+  ];
+
+  for (const feedback of rawFeedback) {
+    processingLog += `Processing: ${feedback}\n`;
+    
+    // 2. Structured Data Extraction (Boilerplate Schema)
+    const schema = {
+      type: Type.OBJECT,
+      properties: {
+        sentiment: { type: Type.STRING },
+        category: { type: Type.STRING, description: "Billing, UI, or Technical" },
+        isUrgent: { type: Type.BOOLEAN },
+        summary: { type: Type.STRING }
+      },
+      required: ["sentiment", "category", "isUrgent", "summary"]
+    };
+
+    const analysisResponse = await ai.models.generateContent({
+      model: "gemini-3.1-flash-lite",
+      contents: `Analyze the customer feedback. Category should be Billing, UI, or Technical.\nFeedback: ${feedback}`,
+      config: {
+        responseMimeType: "application/json",
+        responseSchema: schema,
+      }
+    });
+
+    // 3. Manual JSON parsing and error handling
+    let analysis;
+    try {
+      analysis = JSON.parse(analysisResponse.text || "{}");
+    } catch (e) {
+      console.error("Failed to parse JSON");
+      continue;
+    }
+
+    console.log(`Result for: ${analysis.summary}`);
+
+    // 4. Conditional Tool Calling & Response Handling
+    if (analysis.isUrgent) {
+      const escalationResponse = await ai.models.generateContent({
+        model: "gemini-3.1-flash-lite",
+        contents: `Call escalateTicket for customer '1234' with an exact reason based on:\n${feedback}`,
+        config: {
+          tools: [escalateToolDeclaration]
+        }
+      });
+
+      // 5. Manual extraction of the function call from the response object
+      if (escalationResponse.functionCalls && escalationResponse.functionCalls.length > 0) {
+        const call = escalationResponse.functionCalls[0];
+        if (call.name === "escalateTicket") {
+          const args = call.args as any;
+          // Manual invocation of our local function using the args
+          const resolution = escalateTicket(args.customerId, args.reason);
+          processingLog += `Urgent action taken: ${resolution}\n`;
+        }
+      } else {
+         processingLog += `Urgent action failed to trigger tool.\n`;
+      }
+    } else {
+      processingLog += "Logged routinely.\n";
+    }
+  }
+
+  console.log("\n--- Final Processing Log ---");
+  console.log(processingLog);
+}
+
+processFeedback().catch(console.error);

package/main/tests/debug.sesi

@@ -0,0 +1 @@
+{{print "nested"}}

package/main/tests/demo.sesi

@@ -0,0 +1,24 @@
+// Sesi Demo Script
+
+let userName = "Tony"
+
+// Define a prompt for generating a quote
+// NOTE: No '+' operator inside prompt block body
+prompt quotePrompt {"Generate a short, motivational quote for " userName ". Only return the quote text."}
+
+// Function to analyze sentiment using structured output
+fn analyzeSentiment(text: string) {return structured_output({sentiment: string, score: number, explanation: string})(model("gemini-3.1-flash-lite") {"Analyze the sentiment of the following quote, score it, and give an explanation. Return the result as JSON:" text})}
+print "--- Sesi Demo ---"
+print "Hello," userName
+
+// Call the model to get a quote
+let quote = model("gemini-3.1-flash-lite") {quotePrompt}
+print "Your quote for today:" quote
+
+// Analyze the quote's sentiment
+print "Analyzing sentiment..."
+let analysis = analyzeSentiment(quote)
+print "Sentiment:" analysis.sentiment
+print "Score:" str(analysis.score)
+print "Explanation:" analysis.explanation
+print "Done."

package/main/tests/primitive_validation.sesi

@@ -0,0 +1,18 @@
+// Systems Primitive Validation Script
+print "--- Sesi Primitive Validation ---"
+
+// 1. to_json test
+let data = {"key": "value", "items": [1, 2, 3]}
+let json = to_json(data)
+print "to_json output:" 
+print json
+
+// 2. Side-effect function test (No return)
+let state = "initial"
+fn update_state(new_val) {state = new_val}
+print "State before:" state
+update_state("updated")
+print "State after:" state
+
+// 3. Sequential string test (No +)
+print "Final Status:" "Validation Complete"

package/main/tests/test_connection.sesi

@@ -0,0 +1,4 @@
+// test_connection.sesi
+print "Testing connection..."
+let response = model("gemini-3.1-flash-lite") {"temperature": 0.1} {"Say 'Connection Successful'"}
+print response

package/main/tests/test_failure_debug.sesi

@@ -0,0 +1,2 @@
+fn add(a, b) {print a + b}
+add(5, 3)

package/main/tests/test_image.sesi

@@ -0,0 +1,3 @@
+let logo = image("gemini-3.1-flash-image-preview") { "ratio": '1:1', "size": '512', "temperature": 0.3, "max_tokens": 512 } {"make a beautiful logo for the word Sesi"}
+print("Generated image successfully! Open it here! main/logo.png")
+write_image("main/logo.png", logo)

package/main/tests/test_parser_config.sesi

@@ -0,0 +1,2 @@
+let result = model("gemini-3.1-flash-lite"){"Hello"}
+print result

package/main/tests/test_syntax.sesi

@@ -0,0 +1,3 @@
+prompt generateCode {"test"}
+let code = model("gemini-3-flash-preview") {generateCode}
+print code

package/main/tests/test_tool_call.sesi

@@ -0,0 +1,14 @@
+// Tool Call Demo
+// This script lets the AI decide what to log.
+
+memory discoveries {"Discoveries:"}
+fn recordDiscovery(item: string) {print "Recording discovery..."
+discoveries = discoveries + "- " + item}
+print "AI is deciding what to record..."
+recordDiscovery
+
+// The AI will call recordDiscovery with a summary of its findings
+// We use the 'Most capable' model as suggested by the docs
+tool_call(recordDiscovery)(model("gemini-3.1-flash-lite") {"temperature": 0} {"Analyze the file src/interpreter.ts and record one major architectural pattern you find." "Source code snippet: "read_file("src/interpreter.ts")})
+print "--- Final Log:"
+print discoveries

package/main/tests/try.sesi

@@ -0,0 +1,7 @@
+try 
+{print "Inside Try Block"
+print noSuchVariable
+print "This should not print"
+} catch (e) {
+print "Inside Catch Block!"
+print e}

package/main/vault.sesi

@@ -0,0 +1,15 @@
+// Sesi Bank: Vault & Audit
+// This script initializes the balance and lock state.
+
+fn init() {
+  print "🏦 Vault: Initializing bank database..."
+  write_file("bank/balance.txt", "1000")
+  write_file("bank/lock.txt", "unlocked")
+  print "Vault: System Ready. Initial Balance: 1000"
+}
+fn audit() {
+  let balance = read_file("bank/balance.txt")
+  print "🏦 Vault Audit: Final Balance is: " + balance
+}
+make_dir("bank")
+init()

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@misterscan/sesi",
+  "version": "1.1.1",
+  "description": "Sesi: A High-Performance Systems Language",
+  "main": "dist/index.js",
+  "bin": {
+    "sesi": "bin/sesi.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "docs",
+    "examples",
+    "main"
+  ],
+  "scripts": {
+    "lint": "npx eslint --fix",
+    "build": "tsc",
+    "dev": "npm run lint &&dotenvx run -- npm run build --watch",
+    "test": "npx ts-node tests/basic.test.ts",
+    "test:watch": "npm run lint && npx ts-node tests/basic.test.ts --watch",
+    "build:exe": "npx pkg . --targets node18-win-x64,node18-macos-x64,node18-linux-x64 --out-path releases",
+    "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"
+  },
+  "keywords": [
+    "ai",
+    "language",
+    "programming",
+    "gemini",
+    "interpreter"
+  ],
+  "author": "Sesi Community",
+  "license": "MIT",
+  "dependencies": {
+    "@dotenvx/dotenvx": "^1.65.0",
+    "@dotenvx/dotenvx-ops": "^0.45.3",
+    "@google/genai": "2.0.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^25.7.0",
+    "eslint": "^10.3.0",
+    "globals": "^17.6.0",
+    "typescript": "6.0.3",
+    "typescript-eslint": "^8.59.3"
+  }
+}