@elaraai/east-plugin 0.0.0-stage → 1.0.85

package/package.json

@@ -1,6 +1,68 @@
 {
   "name": "@elaraai/east-plugin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.85",
+  "license": "AGPL-3.0-or-later",
+  "type": "module",
+  "description": "East's agent plugin runtime — the example index generator, the example search and its MCP tools, the search-first hooks and the Codex skill adapter — for a Claude Code or Codex plugin that builds on East's.",
+  "files": [
+    "dist/lib",
+    "dist/hooks",
+    "dist/daemon",
+    "dist/mcp",
+    "dist/status",
+    "dist/scripts",
+    "scripts/render-python.py",
+    "index.json",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "bin": {
+    "east-plugin-generate-index": "./dist/scripts/generate-index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/elaraai/east-workspace.git",
+    "directory": "libs/east-plugin"
+  },
+  "keywords": [
+    "east",
+    "elara",
+    "claude-code",
+    "codex",
+    "plugin",
+    "mcp"
+  ],
+  "author": "Elara AI Pty Ltd",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "minisearch": "^7.1.2",
+    "zod": "^3.0.0",
+    "@elaraai/east": "1.0.85",
+    "@elaraai/east-diagnostics": "1.0.85"
+  },
+  "devDependencies": {
+    "@types/node": "^22.18.1",
+    "esbuild": "^0.27.3",
+    "typescript": "~5.9.2"
+  },
+  "exports": {
+    "./lib/*": "./dist/lib/*.js",
+    "./hooks/*": "./dist/hooks/*.js",
+    "./daemon/*": "./dist/daemon/*.js",
+    "./mcp/*": "./dist/mcp/*.js",
+    "./status/*": "./dist/status/*.js",
+    "./scripts/*": "./dist/scripts/*.js",
+    "./index.json": "./index.json"
+  },
+  "scripts": {
+    "build": "tsc",
+    "generate-index": "npm run build && node dist/scripts/generate-index.js --base-dir .. && uv run --project ../east-py python scripts/render-python.py index.json && node scripts/sync-assets.mjs",
+    "test": "npm run build && node --enable-source-maps --test dist/test/*.spec.js"
+  }
+}

package/scripts/render-python.py

@@ -0,0 +1,67 @@
+#
+# Copyright (c) 2025 Elara AI Pty Ltd
+# Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+#
+"""Fill the python renderings of the example index (#654).
+
+``generate-index`` stores every program example as its IR and the TypeScript
+printed from it; the python printing is this script's — the same IR through
+``east.codegen.to_python_source``, exact by the round-trip contract. Run after
+the generator, from an environment where ``east`` imports::
+
+    uv run --project ../east-py python scripts/render-python.py index.json
+
+Every entry with an ``ir`` gets its ``python``; entries without one (UI,
+hand-written stubs) are left alone. The file is rewritten in place.
+
+A platform call prints as the implementing package's own function and a
+struct or variant type the package names prints by that name (#667) — the
+python reading of what the TypeScript rendering spells through the
+library's handles — for every stock package this environment can import;
+a package that does not import here (an optional dependency missing) is
+skipped with a warning and its calls print as declarations.
+"""
+
+from __future__ import annotations
+
+import json
+import sys
+from pathlib import Path
+
+from east.codegen import Providers, to_python_source
+from east.serialization.json import decode_json_for
+from east.types.type_of_type import IRType
+
+#: The stock platform packages, in provider order.
+STOCK_PACKAGES = ("east_py_std", "east_py_io", "east_py_datascience")
+
+
+def main(argv: list[str]) -> int:
+    if len(argv) != 2:
+        print("usage: render-python.py <index.json>", file=sys.stderr)
+        return 2
+    path = Path(argv[1])
+    data = json.loads(path.read_text(encoding="utf-8"))
+    decode = decode_json_for(IRType)
+    providers = Providers()
+    for package in STOCK_PACKAGES:
+        try:
+            providers.add_module(package)
+        except Exception as e:  # noqa: BLE001 — an optional dependency this environment lacks
+            print(f"[!] {package} does not import here ({e}); its calls print as declarations",
+                  file=sys.stderr)
+    rendered = 0
+    for entry in data["entries"]:
+        ir = entry.get("ir")
+        if ir is None:
+            continue
+        name = entry["id"].rsplit(":", 1)[1]
+        entry["python"] = to_python_source(decode(ir.encode("utf-8")), name=name, providers=providers)
+        rendered += 1
+    path.write_text(json.dumps(data, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
+    print(f"[+] Rendered {rendered} example(s) as python in {path}", file=sys.stderr)
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main(sys.argv))