@elaraai/east-codex-plugin 1.0.100 → 1.0.102
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.codex-plugin/plugin.json +1 -1
- package/index.json +108 -24
- package/package.json +1 -1
- package/skills/e3/SKILL.md +8 -7
- package/skills/e3/reference/cli.md +6 -3
- package/skills/e3-ui/SKILL.md +273 -3623
- package/skills/e3-ui-cli/SKILL.md +1 -5
- package/skills/east/SKILL.md +1 -5
- package/skills/east-py/SKILL.md +1 -5
- package/skills/east-py-datascience/SKILL.md +1 -5
- package/skills/east-py-io/SKILL.md +1 -5
- package/skills/east-py-std/SKILL.md +1 -5
- package/skills/east-ui/SKILL.md +220 -1332
|
@@ -1,12 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: e3-ui-cli
|
|
3
|
-
description: "
|
|
3
|
+
description: "Browses an e3 repository in the terminal and renders east-ui / e3-ui components to PNG. Use when (1) opening a repository interactively with `e3-ui [repo] [workspace]` (local path or remote server): the workspace dashboard of tasks, datasets and dataflow runs, task output trees with /find and /goto, logs with tail-follow, run history, a ui() task's manifest, editable inputs with a commit bar, records through their indexes, /run and /stop; (2) signing in to a remote e3 server (`e3-ui auth login|logout|status|token|whoami`); (3) screenshotting a component or decision surface with `e3-ui shot` from a .ts/.tsx source, serialized IR, or a live task's output; (4) rendering one example from a `*.examples.tsx` file or every UI export in a project (`e3-ui shots`); (5) setting up the headless browser on a server or CI (`e3-ui install-browser`, `e3-ui doctor`); (6) rendering PNGs from Node with renderToPng / renderTaskToPng."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
## Detailed skill scope
|
|
7
|
-
|
|
8
|
-
Browse an e3 repository in the terminal, and render east-ui / e3-ui components to PNG. Use when: (1) Opening an e3 repository interactively — `e3-ui [repo] [workspace]` (a local path, `https://host/repos/<repo>`, or a bare origin) shows a workspace dashboard (task / dataset status, the last or live dataflow run with the budget it runs under, units waiting for room and requeued, each task's peak memory — and, while a deploy runs, each file source and record at the step it has reached), task views (a lazily paged value tree of the output with /find and /goto, stdout and stderr with tail-follow, the run history, a ui() task's manifest), editable inputs with a commit bar, records (their rows, through any of their indexes, and their commits, read-only), and `/run` / `/stop`, all driven by a command box with completion, vim-style keys and the mouse, (2) Signing in to a remote e3 server for the terminal UI (`e3-ui auth login|logout|status|token|whoami` — the same device flow and store as `e3 auth`), (3) Screenshotting an east-ui component or e3-ui decision surface with `e3-ui shot` — from a .ts/.tsx source file, serialized .beast2/.json IR, or a live e3 task's computed output, (4) Rendering ONE example from a `*.examples.ts(x)` file (`--from-source <file> -e <exampleName>`) or EVERY renderable UI export in a project (`e3-ui shots`), (5) Setting up or troubleshooting the headless browser on a server or CI (`e3-ui install-browser`, `e3-ui doctor`), (6) Rendering PNGs from Node with renderToPng / renderTaskToPng / capture.
|
|
9
|
-
|
|
10
6
|
# e3-ui CLI (@elaraai/e3-ui-cli)
|
|
11
7
|
|
|
12
8
|
Two things in one command. With no subcommand, `e3-ui` is a full-screen
|
package/skills/east/SKILL.md
CHANGED
|
@@ -1,12 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: east
|
|
3
|
-
description: "East programming language
|
|
3
|
+
description: "East programming language: a statically typed, expression-based language embedded in TypeScript, compiled to portable IR that runs on Node, C and Python. Use when (1) writing East functions (East.function / East.asyncFunction) and types (IntegerType, StringType, ArrayType, StructType, VariantType, …); (2) platform functions (East.platform / East.asyncPlatform); (3) compiling and running in-process with East.compile; (4) East expressions: arithmetic, strings, dates, collections, vectors and matrices, control flow; (5) East values from TypeScript: compareFor/equalFor, SortedMap/SortedSet, isValueOf, the East-text, JSON, CSV and beast2 codecs; (6) IR (.toIR, East.toSource) and running programs from the command line (east-node / east-c / east-py run, exec) or a runner unit in your own host; (7) calling python-authored functions or exporting for python (East.importFunction, East.exportFunctions); (8) east-node check / lsp; (9) collections larger than memory; (10) JSON Schema contracts; (11) typed jq (East.jq)."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
## Detailed skill scope
|
|
7
|
-
|
|
8
|
-
East programming language - a statically typed, expression-based language embedded in TypeScript, compiled to portable IR that runs on Node, C and Python. Use when: (1) writing East functions with East.function() / East.asyncFunction(), (2) defining types (IntegerType, StringType, ArrayType, StructType, VariantType, ...), (3) platform functions with East.platform() / East.asyncPlatform(), (4) compiling and running in-process with East.compile(), (5) East expressions: arithmetic, strings, dates, collections, vectors and matrices, control flow, (6) working with East values from TypeScript: compareFor/equalFor, SortedMap/SortedSet, isValueOf, the East-text, JSON, CSV and beast2 codecs, (7) serializing IR (.toIR(), encodeEastIR) and printing it back as source (East.toSource, east-node transpile), (8) running a program from the command line (east-node / east-c / east-py run, exec, east-c ir), or a runner-protocol unit in a host of your own, such as a browser's worker (executeUnit over a UnitIO, InMemoryUnitIO), (9) calling a function authored in python, or exporting one for python (East.importFunction, East.exportFunctions, east-node export-functions), (10) checking that a module's East functions build (east-node check, east-node lsp), (11) collections larger than memory (Beast2ElementWriter, openBeast2PagesFor, blob.openBeast), (12) JSON Schema contracts (jsonSchemaFor, typeFromJsonSchema), (13) asking a question of a value in typed jq (East.jq, checkJq, evaluateJq).
|
|
9
|
-
|
|
10
6
|
# East Language
|
|
11
7
|
|
|
12
8
|
A statically typed, expression-based language embedded in TypeScript: you build
|
package/skills/east-py/SKILL.md
CHANGED
|
@@ -1,12 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: east-py
|
|
3
|
-
description: "East in Python (east-py):
|
|
3
|
+
description: "East in Python (east-py): East functions written in python (East.function / East.asyncFunction, the block `b` in place of TypeScript's `$`, the TypeScript methods snake_cased, the standard library, East.compile), and East values as ordinary python (EastArray/Set/Dict/Vector/Matrix/Struct/Variant/Ref/Blob) whose eager methods run in east-c under the same names. Use when writing python against east-py: (1) an East function in python (b.let / b.if_ / b.for_, expression methods); (2) building, validating and transforming values (coerce_to, assert_value_of, sort/map/filter/reduce/group_*, set algebra, dict merge); (3) @East.platform_function to expose python to East, and porting a plain-python POC into one; (4) beast2 files larger than memory, numpy/torch through EastVector/EastMatrix; (5) the east-py CLI (run, exec, convert, transpile, export-functions, lint, check, lsp); (6) exporting functions for TypeScript / e3 and importing TypeScript-authored ones; (7) JSON Schema contracts and typed jq queries."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
## Detailed skill scope
|
|
7
|
-
|
|
8
|
-
East in Python (east-py): (A) East EXPRESSIONS — East functions written in python with East.function / East.asyncFunction, the block `b` (TypeScript's `$`), the TypeScript methods snake_cased, the standard library, East.compile; (B) East VALUES — East data as ordinary python (EastArray/Set/Dict/Vector/Matrix/Struct/Variant/Ref/Blob) whose eager methods run in east-c under the same names. Use when writing python against east-py: (1) an East function in python (b.let/b.if_/b.for_, expression methods, the stdlib), (2) building and validating values (array/struct/variant/some/none, coerce_to/assert_value_of), (3) transforming values with eager methods (sort/map/filter/reduce/group_*/set algebra/dict merge), (4) scalar builtins via East.<Type>, (5) @East.platform_function to expose python to East, (6) beast2 files larger than memory, numpy/torch through EastVector/EastMatrix, (7) porting a plain-python POC into a platform function, (8) the east-py CLI — run, exec, convert, transpile, export-functions, lint, check, lsp, version, (9) exporting functions for TypeScript / e3 and importing TypeScript-authored ones (East.export_functions / East.import_function), (10) edit-time diagnostics (east-py lint, flake8 EAS codes, east-py check, east-py lsp), (11) JSON Schema contracts (json_schema_for, type_from_json_schema), (12) typed jq queries over East values (East.jq, and east.query's check_jq / evaluate_jq).
|
|
9
|
-
|
|
10
6
|
# East.py — East expressions and East values in Python
|
|
11
7
|
|
|
12
8
|
`east-py` is the Python runtime for East: a Cython bridge to the native **east-c**
|
|
@@ -1,12 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: east-py-datascience
|
|
3
|
-
description: "Data science and machine learning platform functions for the East language (TypeScript types
|
|
3
|
+
description: "Data science and machine learning platform functions for the East language (TypeScript types plus directly callable Python implementations). Use when an East program needs (1) optimization: MADS (derivative-free), Optuna (Bayesian), SimAnneal / ALNS (combinatorial), Scipy, coordinate descent (Optimization), Google OR-Tools (constraint programming, vehicle routing, LP/MIP, graphs); (2) machine learning: XGBoost, LightGBM, NGBoost, Gaussian processes, Torch MLP, Lightning; (3) Bayesian and hierarchical models with PyMC; (4) causal inference with DoWhy, EconML DML and ALE, or one declarative experiment with Causal.experiment (naive vs adjusted effect, overlap, robustness, an honesty verdict); (5) discrete event simulation of an economic ontology (Simulation); (6) Sklearn preprocessing, metrics and splits, MAPIE conformal intervals, SHAP explanations; (7) calling the east_py_datascience functions (xgboost_train_regressor, mads_optimize, …) from python or inside an East.function body."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
## Detailed skill scope
|
|
7
|
-
|
|
8
|
-
Data science and machine learning platform functions for the East language (TypeScript types + directly-callable Python implementations). Use when writing East programs that need optimization (MADS, Optuna, SimAnneal, ALNS, Scipy, Optimization, GoogleOr), machine learning (XGBoost, LightGBM, NGBoost, Torch MLP, Lightning, GP), Bayesian inference (PyMC), causal inference (Causal: DoWhy, EconML DML, ALE), simulation (Simulation DES), ML utilities (Sklearn preprocessing, metrics, splits), conformal prediction (MAPIE), or model explainability (SHAP). Triggers for: (1) Writing East programs with @elaraai/east-py-datascience, (2) Derivative-free optimization with MADS, (3) Bayesian optimization with Optuna, (4) Discrete/combinatorial optimization with SimAnneal or ALNS, (5) Gradient boosting with XGBoost or LightGBM, (6) Probabilistic predictions with NGBoost or GP, (7) Neural networks with Torch MLP or Lightning, (8) Data preprocessing and metrics with Sklearn, (9) Conformal prediction intervals with MAPIE, (10) Model explainability with Shap, (11) Iterative coordinate descent with Optimization, (12) Constraint programming, vehicle routing, LP/MIP, or graph algorithms with GoogleOr, (13) Bayesian regression, hierarchical models, and multi-layer estimation with PyMC, (14) Economic ontology simulation via discrete event simulation with Simulation, (15) One declarative causal experiment — naive vs adjusted effect, overlap, robustness, and an honesty verdict — with Causal.experiment, (16) Calling the east_py_datascience functions (xgboost_train_regressor, mads_optimize, …) from a project's own Python @East.platform_function, or inside an East.function body — the same object does both.
|
|
9
|
-
|
|
10
6
|
# East Data Science
|
|
11
7
|
|
|
12
8
|
Data science and machine learning platform functions for East: optimisation,
|
|
@@ -1,12 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: east-py-io
|
|
3
|
-
description: "I/O platform functions for the East language on the Python runtime
|
|
3
|
+
description: "I/O platform functions for the East language on the Python runtime: SQL databases (SQLite, PostgreSQL, MySQL, Access), NoSQL (Redis, MongoDB), S3 storage, file transfers (FTP, SFTP), file formats (XLSX, XML) and compression (Gzip, Zip, Tar). Use when writing Python (not the TypeScript DSL) that (1) calls east_py_io functions (sqlite_select, mongo_find, s3_put_object, ftp_get, xlsx_read, gzip_compress, …) from a project's own @East.platform_function or inside an East.function body — the same object does both; (2) registers the east_py_io platform list with compile(); (3) builds connection configs (SqliteConfigType, PostgresConfigType, RedisConfigType, S3ConfigType, …); (4) follows the connect → handle → operate → close lifecycle. For East programs in TypeScript against these functions, use east-node-io."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
## Detailed skill scope
|
|
7
|
-
|
|
8
|
-
I/O platform functions for the East language on the Python runtime - SQL databases (SQLite, PostgreSQL, MySQL, Access), NoSQL (Redis, MongoDB), S3 storage, file transfers (FTP, SFTP), file formats (XLSX, XML), and compression (Gzip, Zip, Tar). Use when writing Python (not the TypeScript DSL) that calls or registers these platform functions. Triggers for: (1) Calling east_py_io functions (sqlite_select, mongo_find, s3_put_object, ftp_get, xlsx_read, gzip_compress, ...) from a project's own Python @East.platform_function, or inside an East.function body — the same object does both, (2) Registering the east_py_io platform list with compile() so East programs can use SQL/NoSQL/Storage/Transfer/Format/Compression on the Python runtime, (3) Building connection configs (SqliteConfigType, PostgresConfigType, RedisConfigType, S3ConfigType, FtpConfigType, ...) in Python, (4) The connect -> handle -> operate -> close connection lifecycle. For authoring East programs in TypeScript against these functions, use the east-node-io skill instead.
|
|
9
|
-
|
|
10
6
|
# East.py I/O Platform Functions
|
|
11
7
|
|
|
12
8
|
`east_py_io` is the Python implementation of the East I/O platform: SQL and
|
|
@@ -1,12 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: east-py-std
|
|
3
|
-
description: "Standard platform functions for the East language on the Python runtime
|
|
3
|
+
description: "Standard platform functions for the East language on the Python runtime: console, environment variables, filesystem, HTTP fetch, crypto, time, path, random, large-JSON reading and testing. Use when writing Python (not the TypeScript DSL) that (1) calls east_py_std functions (env_get, fs_read_file, fetch_request, crypto_uuid, random_normal, …) from python or inside an East.function body — the same object does both; (2) registers the east_py_std platform list with compile(); (3) builds FetchRequestConfigType requests; (4) draws deterministic random streams with random_seed; (5) reads a JSON document too large to decode whole with json_open / json_more / json_next, against a published contract. For East programs in TypeScript against these functions, use east-node-std."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
## Detailed skill scope
|
|
7
|
-
|
|
8
|
-
Standard platform functions for the East language on the Python runtime - console, environment variables, filesystem, HTTP fetch, crypto, time, path, random, large-JSON reading, testing. Use when writing Python (not the TypeScript DSL) that calls or registers these platform functions. Triggers for: (1) Calling east_py_std functions (env_get, fs_read_file, fetch_request, crypto_uuid, random_normal, ...) from python or inside an East.function body — the same object does both, (2) Registering the east_py_std platform list with compile() so East programs can use Console/Env/FileSystem/Fetch/Crypto/Time/Path/Random/Json/Test on the Python runtime, (3) Building FetchRequestConfigType requests in Python, (4) Deterministic random streams with random_seed, (5) Reading a JSON document too large to decode whole — ingesting a multi-gigabyte payload from another system — with json_open / json_more / json_next, strictly against a published contract. For authoring East programs in TypeScript against these functions, use the east-node-std skill instead.
|
|
9
|
-
|
|
10
6
|
# East.py Standard Platform Functions
|
|
11
7
|
|
|
12
8
|
`east_py_std` is the Python implementation of the East standard platform:
|