@misterscan/sesi 1.2.3 → 1.3.0

package/dist/types.js

@@ -1,7 +1,7 @@
 "use strict";
 // Core type definitions and AST nodes for Sesi
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ContinueException = exports.BreakException = exports.ReturnValue = exports.Environment = void 0;
+exports.SesiRuntimeError = exports.ContinueException = exports.BreakException = exports.ReturnValue = exports.Environment = void 0;
 // Environment for variable scoping
 class Environment {
     constructor(parent = null) {
@@ -60,4 +60,36 @@ class ContinueException extends Error {
     }
 }
 exports.ContinueException = ContinueException;
+class SesiRuntimeError extends Error {
+    constructor(errorType, message, data = null, line, column, output, stackTrace = []) {
+        super(message);
+        this.name = 'SesiRuntimeError';
+        this.errorType = errorType;
+        this.data = data;
+        this.line = line;
+        this.column = column;
+        this.output = output;
+        this.stackTrace = stackTrace;
+    }
+    toRuntimeObject() {
+        const obj = Object.create(null);
+        obj.type = this.errorType;
+        obj.message = this.message;
+        obj.data = this.data;
+        if (this.line !== undefined) {
+            obj.line = this.line;
+        }
+        if (this.column !== undefined) {
+            obj.column = this.column;
+        }
+        if (this.output !== undefined) {
+            obj.output = this.output;
+        }
+        if (this.stackTrace.length > 0) {
+            obj.stack_trace = this.stackTrace;
+        }
+        return obj;
+    }
+}
+exports.SesiRuntimeError = SesiRuntimeError;
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,+CAA+C;;;AAwa/C,mCAAmC;AACnC,MAAa,WAAW;IAItB,YAAY,SAA6B,IAAI;QAHrC,SAAI,GAA8B,IAAI,GAAG,EAAE,CAAC;QAIlD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,KAAmB;QACtC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,IAAY;QACd,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;QAC9B,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,GAAG,CAAC,IAAY,EAAE,KAAmB;QACnC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACrC,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAvCD,kCAuCC;AAgCD,0BAA0B;AAC1B,MAAa,WAAY,SAAQ,KAAK;IACpC,YAAmB,KAAmB;QACpC,KAAK,EAAE,CAAC;QADS,UAAK,GAAL,KAAK,CAAc;IAEtC,CAAC;CACF;AAJD,kCAIC;AAED,MAAa,cAAe,SAAQ,KAAK;IACvC;QACE,KAAK,EAAE,CAAC;IACV,CAAC;CACF;AAJD,wCAIC;AAED,MAAa,iBAAkB,SAAQ,KAAK;IAC1C;QACE,KAAK,EAAE,CAAC;IACV,CAAC;CACF;AAJD,8CAIC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,+CAA+C;;;AA0a/C,mCAAmC;AACnC,MAAa,WAAW;IAItB,YAAY,SAA6B,IAAI;QAHrC,SAAI,GAA8B,IAAI,GAAG,EAAE,CAAC;QAIlD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,KAAmB;QACtC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,IAAY;QACd,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;QAC9B,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,GAAG,CAAC,IAAY,EAAE,KAAmB;QACnC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACrC,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAvCD,kCAuCC;AAgCD,0BAA0B;AAC1B,MAAa,WAAY,SAAQ,KAAK;IACpC,YAAmB,KAAmB;QACpC,KAAK,EAAE,CAAC;QADS,UAAK,GAAL,KAAK,CAAc;IAEtC,CAAC;CACF;AAJD,kCAIC;AAED,MAAa,cAAe,SAAQ,KAAK;IACvC;QACE,KAAK,EAAE,CAAC;IACV,CAAC;CACF;AAJD,wCAIC;AAED,MAAa,iBAAkB,SAAQ,KAAK;IAC1C;QACE,KAAK,EAAE,CAAC;IACV,CAAC;CACF;AAJD,8CAIC;AAED,MAAa,gBAAiB,SAAQ,KAAK;IAQzC,YACE,SAAiB,EACjB,OAAe,EACf,OAAqB,IAAI,EACzB,IAAa,EACb,MAAe,EACf,MAAe,EACf,aAAuB,EAAE;QAEzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,eAAe;QACb,MAAM,GAAG,GAAkB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/C,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;QAC1B,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC3B,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACrB,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC;QACpC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AA9CD,4CA8CC"}

package/docs/ARCHITECTURE.md

@@ -2,7 +2,7 @@
 
 ## Overview
 
-**Sesi** is a high-performance **Systems Language** designed for building resilient, stateful applications. It uses a tree-walking interpreter model with asynchronous host-side model execution, but no language-level `async/await` syntax in v1.2 The architecture is optimized for coordination, distributed state management, and first-class reasoning primitives.
+**Sesi** is a concise and highly legible programming language. It uses a clean tree-walking interpreter model built in TypeScript. The architecture is optimized for simplicity and eliminating the need for `async/await` syntax or heavy module imports. By acting as a minimal orchestration layer, Sesi allows developers to write clean, straightforward logic that natively handles background processes and API or Reasoning calls without SDK overhead.
 
 ## Component Stack
 
@@ -198,7 +198,7 @@ false  → false
    - Construct prompt from string concatenation
    - Make async API call to Gemini
 
-- Wait for response (blocking in v1)
+- Wait for response (blocking in v1.x)
 - Validate finish reason and non-empty text
 - Return text response to program or throw
 
@@ -213,7 +213,7 @@ false  → false
 ModelCallExpression (AST)
     │
     ├─ Evaluate prompt expression
-    ├─ Extract configuration ("thinkingLevel", "max_tokens", "cache", etc.)
+    ├─ Extract configuration (`thinkingLevel`, `max_tokens`, `cache`, etc.)
     ├─ Call AIRuntime.callModel()
     │   │
     │   ├─ Create Gemini interaction request
@@ -303,6 +303,7 @@ eslint.config.mjs         # ESLint configuration
 dist/                     # Compiled TypeScript output
 example.js                # Helper script to run basic examples
 example-ai.js             # Helper script to run Reasoning examples
+examples.sesi             # Central execution suite for examples
 package.json              # Dependencies & scripts
 tsconfig.json             # TypeScript configuration
 QUICKSTART.md             # Quick start guide
@@ -346,7 +347,10 @@ examples/
 ├── 16_modules.sesi          # Modules & std library namespaces
 ├── 17_http_client.sesi      # HTTP GET/POST client
 ├── 18_parallel_requests.sesi # Parallel requests concurrency
-└── 19_search_web.sesi        # Web search
+├── 19_search_web.sesi        # Web search
+├── 20_model_aliases.sesi     # Custom model naming via aliases
+├── 21_custom_tools.sesi      # Runtime custom tool definitions
+└── 22_reasoning_plus_custom_tools.sesi # Compose reasoning with custom tools
 
 docs/
 ├── SPECIFICATION.md      # Language spec
@@ -354,12 +358,21 @@ docs/
 ├── BUILTINS.md           # Built-in reference
 ├── IMAGE_GENERATION.md   # Image generation guide
 ├── COMPARISON.md         # Language comparison showcase
-├── SYSTEMS_REASONING.md  # Integrated reasoning guide
-├── DISTRIBUTED_SYSTEMS.md # Swarm & coordination guide
-└── ROADMAP.md            # Future plans
+├── CONCURRENCY.md        # Concurrency & coordination guide
+├── REASONING.md          # Reasoning and simple logic guide
+├── ROADMAP.md            # Future plans
+└── sesi_ai_chronicles.md # AI project history & notes
 
 tests/
-└── basic.test.ts         # Test suite
+├── basic.test.ts         # Core parsing & evaluation tests
+├── cache.test.ts         # Execution caching tests
+├── http.test.ts          # Web request builtins testing
+├── module.test.ts        # Imports & module loading tests
+├── parallel.test.ts      # Concurrent execution tests
+├── security.test.ts      # Sandbox & guardrail tests
+├── test-gemini.ts        # Base model integration test
+├── test-gemini2.ts       # Extended model integration test
+└── workflow.test.ts      # Complex sequence workflows tests
 ```
 
 ## Workspace Context File
@@ -429,6 +442,6 @@ Sesi's architecture prioritizes **clarity and simplicity** over performance. The
 - Easy debugging
 - Simple extensions
 - Clear control flow
-- Smooth Reasoning (AI) integration
+- Smooth Reasoning integration
 
 As the language matures, optimizations can be added without changing the API.

package/docs/BUILTINS.md

@@ -383,14 +383,12 @@ print "Elapsed time:" time() - start "ms"
 Concurrently execute multiple Sesi function closures or builtins in parallel and return their results as an array.
 
 ```sesi
-fn job1() {
-  sleep(100)
-  return "a"
-}
-fn job2() {
-  sleep(100)
-  return "b"
-}
+fn job1() 
+{sleep(100)
+return "a"}
+fn job2() 
+{sleep(100)
+return "b"}
 let results = multi_req([job1, job2])
 print results // ["a", "b"]
 ```
@@ -399,6 +397,106 @@ print results // ["a", "b"]
 
 ---
 
+### workflow(steps, input = "") -> object
+
+Run a multi-step reasoning workflow where each step can reference prior outputs.
+
+Default behavior is automatic and requires no special syntax:
+
+- Step 1 gets the workflow input appended to its prompt
+- Step 2+ gets the previous step output appended to its prompt
+
+Each step is an object with at minimum a `"prompt"` string. Optional keys include:
+
+- `"model"` (default: `"gemini-3.1-flash-lite"`)
+- `"temperature"`, `"max_tokens"`, `"top_k"`, `"top_p"`
+- `"thinkingLevel"`, `"cache"`, `"search"`
+
+```sesi
+let steps = [{"prompt": "Summarize:"}, {"prompt": "Critique:"}, {"prompt": "Finalize:"}]
+let result = workflow(steps, "Design a landing page brief")
+print result["final"]
+```
+
+**Returns**: `object` with keys `"input"`, `"steps"` (array of step outputs), and `"final"`.
+
+---
+
+### set_alias(alias, model) -> bool
+
+Register a custom local name for a model string. Aliases are resolved automatically by `model()`, `image()`, and `workflow()`.
+
+```sesi
+set_alias("fast", "gemini-3.1-flash-lite")
+let answer = model("fast") {"Summarize this paragraph."}
+```
+
+**Returns**: `bool` (`true` when the alias is registered)
+
+---
+
+### define_tool(name, fn, description = "") -> bool
+
+Register a custom tool name that can be called through `tool_call(name)(...)`.
+
+```sesi
+fn summarize(text) 
+{return "Summary: " + text}
+
+define_tool("summarizer", summarize, "Summarizes text")
+let result = tool_call(summarizer)("Hello")
+```
+
+**Returns**: `bool` (`true` when the tool is registered)
+
+---
+
+### list_tools() -> array
+
+List custom tool names registered by `define_tool`.
+
+```sesi
+let tools = list_tools()
+print tools
+```
+
+**Returns**: `array<string>`
+
+---
+
+### error_type(type, message, data = null) -> object
+
+Create a custom typed error object you can throw with `raise_error`.
+
+```sesi
+let err = error_type("ValidationError", "Missing email", {"field": "email"})
+```
+
+**Returns**: `object` with keys `"type"`, `"message"`, and `"data"`.
+
+---
+
+### raise_error(type_or_error, message = "", data = null) -> never
+
+Throw a custom typed error that can be handled in `try/catch`.
+
+```sesi
+try {
+  raise_error("RateLimit", "Too many requests", {"retryIn": 30})
+} catch (e) {print "type:" e["type"] "message:" e["message"]}
+```
+
+You can also pass an `error_type(...)` object directly:
+
+```sesi
+let err = error_type("ValidationError", "Invalid payload", {"field": "email"})
+raise_error(err)
+```
+
+**Returns**: never (always throws)
+
+---
+
 ### random() -> number
 
 Returns a random floating-point number between 0 (inclusive) and 1 (exclusive).
@@ -431,7 +529,7 @@ print sigmoid      // 0.6224593312018546
 
 ## Math-like Functions (v2 planned)
 
-These are not yet implemented in v1.2 but will be added:
+These are not yet implemented in v1+ but will be added:
 
 ```sesi
 // Planned for v2:
@@ -593,7 +691,7 @@ keys(obj) contains "a"    // Future: not yet supported
 
 ---
 
-## Standard Library Modules (Supported natively in v1.2+)
+## Standard Library Modules (Supported natively in v1.3+)
 
 ### std/math
 
@@ -621,7 +719,7 @@ import { parse, stringify } from "std/json"
 
 ---
 
-## Module Resolution (v1.2.2+)
+## Module Resolution (v1.3+)
 
 Sesi resolves local module imports by searching directories in priority order:
 
@@ -710,8 +808,8 @@ Tip: add a folder to SESI_PATH, or place shared modules in ~/.sesi/lib
 - [Quick Start](QUICKSTART.md)
 - [Compare to other languages](COMPARISON.md)
 - [Specification](SPECIFICATION.md)
-- [Systems Reasoning Guide](SYSTEMS_REASONING.md)
+- [Reasoning Guide](REASONING.md)
 - [Image Generation](IMAGE_GENERATION.md)
 - [Roadmap](ROADMAP.md)
-- [Distributed Systems](DISTRIBUTED_SYSTEMS.md)
+- [Concurrency Systems](CONCURRENCY.md)
 - [Examples](../examples/)

package/docs/COMPARISON.md

@@ -1,16 +1,14 @@
-# The Sesi Advantage: Why We Built a Systems & Orchestration Language
+# The Sesi Advantage: Removing Boilerplate
 
-Integrating Large Language Models (LLMs) into traditional applications today is painful. Standard programming languages treat AI as an external service requiring SDKs, manual prompt string concatenation, complex schema definitions, and fragile JSON parsing.
+Integrating API calls or reasoning blocks into traditional applications today is painful. Standard programming languages treat API calls or reasoning blocks as an external service requiring SDKs, manual prompt string concatenation, complex schema definitions, and fragile JSON parsing.
 
-**Sesi treats Reasoning as a first-class language primitive.**
-
-This document demonstrates exactly how much boilerplate and complexity Sesi eliminates compared to traditional languages like TypeScript, Python, and Go.
+This document demonstrates how much boilerplate Sesi eliminates.
 
 ---
 
 ## 📊 The Cost of Boilerplate: A Data Comparison
 
-When building a simple AI-powered data pipeline (structured data extraction + conditional function calling), traditional languages spend more than half their code managing the SDK rather than executing business logic.
+When building simple API extraction pipelines, traditional languages spend more than half their code managing SDKs.
 
 ```mermaid
 xychart-beta
@@ -248,7 +246,7 @@ In Go, statically typed strictness combined with AI responses creates massive st
 
 ---
 
-## Showcase 3: Distributed Orchestration Swarm
+## Showcase 3: Distributed Orchestration Processes
 
 This example demonstrates a complex distributed task: Spawning a background researcher, polling for completion with fault tolerance, and synthesizing results with AI.
 
@@ -330,5 +328,5 @@ Sesi isn't just syntactic sugar. By embedding the AI runtime directly into the p
 - [Image Generation](IMAGE_GENERATION.md)
 - [Built-in Functions](BUILTINS.md)
 - [Architecture](ARCHITECTURE.md)
-- [Reasoning Features](SYSTEMS_REASONING.md)
-- [Distributed Systems](DISTRIBUTED_SYSTEMS.md)
+- [Reasoning Features](REASONING.md)
+- [Concurrent Processes](CONCURRENCY.md)

package/docs/{DISTRIBUTED_SYSTEMS.md → CONCURRENCY.md}

@@ -1,22 +1,22 @@
-# Distributed Systems with Sesi
+# Concurrency 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.
+This document details how Sesi handles process concurrency and file locks.
 
-## The "Bank Swarm" Case Study
+## The "Bank" Case Study
 
-In this experiment, Sesi was used to solve a classic distributed systems problem: **Concurrent Mutual Exclusion.**
+In this experiment, Sesi was used to solve file contention.
 
 ### 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.
+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 Sesi Solution (The "Double-Check Write" Pattern)
+### The Solution (Mutex / File Locking)
 
-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.
+Sesi solves this using file locking via `try/catch` and file I/O builtins.
 
 #### 1. Unique Identity
 
-Each agent generates a globally unique ID using Sesi's native `time()` and `random()` builtins.
+Each instance generates a unique ID using Sesi's native `time()` and `random()` builtins.
 
 ```sesi
 let id = "Agent_" + str(time()) + "_" + str(random())
@@ -40,7 +40,7 @@ while locked {
 
 #### 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).
+Using `try/catch`, Sesi scripts gracefully handle filesystem contention.
 
 ```sesi
 try {
@@ -53,10 +53,10 @@ try {
 
 ## 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 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-Agent Swarm
+// Master: Launching 5 Concurrent Processes...
 spawn("main/atm_deposit.sesi")
 spawn("main/atm_withdraw.sesi")
 spawn("main/atm_deposit.sesi")

package/docs/IMAGE_GENERATION.md

@@ -1,17 +1,17 @@
 # Image Generation in Sesi
 
-Sesi provides a native, language-level primitive for generating images using AI models. This primitive is designed to interoperate seamlessly with Sesi's file system builtins, allowing you to generate and persist images with minimal boilerplate.
+Sesi provides a native, language-level primitive for image generation and manipulation, including image-to-image tasks like style transfer, upscaling, and editing. This primitive is designed to interoperate seamlessly with Sesi's file system builtins, allowing you to generate and persist images with minimal boilerplate.
 
 ## The `image` Primitive
 
-To generate an image, use the `image` keyword followed by the model name, an optional configuration block, and a prompt block.
+To generate or manipulate an image, use the `image` keyword followed by the model name, an optional configuration block, and a prompt block.
 
 ### Syntax
 
 The syntax parallels standard `model` calls:
 
 ```
-image("model-name") {"configKey": "configValue"} {"Prompt text"}
+image("model-name") {configKey: "configValue"} {"Prompt text"}
 ```
 
 ### Basic Example
@@ -23,7 +23,7 @@ Here is a simple example demonstrating how to generate a single image and save i
 prompt request {"A simple minimalist company logo for a bakery"}
 
 // 2. Call the image generation primitive
-let imageData = image("gemini-3.1-flash-image-preview") {"ratio": "1:1", "size": "1K"} {request}
+let imageData = image("gemini-3.1-flash-image-preview") {ratio: "1:1", size: "1K"} {request}
 
 // 3. Write the payload to disk
 try 
@@ -52,7 +52,7 @@ for product in products
 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 imageData = image("gemini-3.1-flash-image-preview") {ratio: "1:1", size: "1K"} {request}
 
 // Attempt local file write
 let success = write_image(filename, imageData)
@@ -69,9 +69,9 @@ print "Asset generation complete."
 
 When configuring the `image` call (specifically for models like `gemini-3.1-flash-image-preview`), the configuration block maps directly to backend SDK capabilities:
 
-- `"ratio"`: The aspect ratio of the image (e.g., `"1:1"`, `"16:9"`, `"9:16"`).
-- `"size"`: Dimensional sizing constraints (Must be `"512"`, `"1K"`, `"2K"`, or `"4K"`).
-- `"temperature"`: *Will be deprecated in Gemini 3.x+, use thinkingLevel instead.* — controls variance.
+- `ratio`: The aspect ratio of the image (e.g., `"1:1"`, `"16:9"`, `"9:16"`).
+- `size`: Dimensional sizing constraints (Must be `"512"`, `"1K"`, `"2K"`, or `"4K"`).
+- `temperature`: *Will be deprecated in Gemini 3.x+, use thinkingLevel instead.* — controls variance.
 
 ## File I/O Integration: `write_image`
 
@@ -139,11 +139,10 @@ print "Render saved."
 let dir = "frames/"
 let files = list_dir(dir)
 
-for f in files {
-  prompt p {dir f}
-  let desc = model("gemini-3.1-flash-lite") {images: p} {"Describe this frame in one sentence."}
-  print f desc
-}
+for f in files 
+{prompt p {dir f}
+let desc = model("gemini-3.1-flash-lite") {images: p} {"Describe this frame in one sentence."}
+print f desc}
 ```
 
 ### Config Reference
@@ -154,4 +153,4 @@ When used inside `model()` or `image()` config blocks, `images` is resolved at r
 |-----|---------------|-------|
 | `images` | `string` or `array<string>` | One or more local file paths. Resolved relative to `process.cwd()`. |
 
-> **Note:** Multimodal input requires a vision-capable model (e.g. `gemini-3-flash-preview`, `gemini-3.1-flash-lite`, `gemini-3.1-pro-preview`). Image-generation models that accept reference images are listed in their respective model documentation.
+> **Note:** Multimodal input requires a vision-capable model (e.g. `gemini-3-flash-preview`, `gemini-3.1-flash-lite`, `gemini-3.1-pro-preview`, `gemini-3.5-flash`). Image-generation models that accept reference images are listed in their respective model documentation.