Add stub python runtime agent package

Author: intentionally-left-nil

.github/workflows/publish.yml

@@ -20,7 +20,7 @@ on:
 
 env:
   DENO_VERSION: v2.x
-  BUILD_ORDER: '["schema","lib", "ai", "pyodide-runtime-agent"]'
+  BUILD_ORDER: '["schema","lib", "ai", "pyodide-runtime-agent", "python-runtime-agent"]'
 
 jobs:
   generate-build-order:

deno.json

@@ -3,13 +3,15 @@
     "./packages/ai",
     "./packages/schema",
     "./packages/lib",
-    "./packages/pyodide-runtime-agent"
+    "./packages/pyodide-runtime-agent",
+    "./packages/python-runtime-agent"
   ],
   "imports": {
     "@runt/ai": "./packages/ai/mod.ts",
     "@runt/schema": "./packages/schema/mod.ts",
     "@runt/lib": "./packages/lib/mod.ts",
-    "@runt/pyodide-runtime-agent": "./packages/pyodide-runtime-agent/src/mod.ts"
+    "@runt/pyodide-runtime-agent": "./packages/pyodide-runtime-agent/src/mod.ts",
+    "@runt/python-runtime-agent": "./packages/python-runtime-agent/mod.ts"
   },
   "lint": {
     "rules": {

packages/python-runtime-agent/README.md

@@ -0,0 +1,10 @@
+# @runt/python-runtime-agent
+
+Stub Python runtime agent for the Runt platform.
+
+This package provides a placeholder `PythonRuntimeAgent` class that subclasses
+`RuntimeAgent` from `@runt/lib`.
+
+## Usage
+
+This package is a stub and does not implement any Python execution logic yet.

packages/python-runtime-agent/deno.json

@@ -0,0 +1,46 @@
+{
+  "name": "@runt/python-runtime-agent",
+  "version": "0.0.1",
+  "description": "Stub Python runtime agent for Runt platform.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/runtimed/anode.git"
+  },
+  "exports": {
+    ".": "./mod.ts"
+  },
+  "imports": {
+    "@runt/lib": "jsr:@runt/lib@^0.6.2",
+    "@runt/schema": "jsr:@runt/schema@^0.6.2"
+  },
+  "tasks": {
+    "test": "deno test --allow-all",
+    "check": "deno check src/**/*.ts",
+    "fmt": "deno fmt",
+    "lint": "deno lint"
+  },
+  "compilerOptions": {
+    "strict": true,
+    "exactOptionalPropertyTypes": true,
+    "noImplicitReturns": true,
+    "noUncheckedIndexedAccess": true
+  },
+  "fmt": {
+    "useTabs": false,
+    "lineWidth": 80,
+    "indentWidth": 2,
+    "semiColons": true,
+    "singleQuote": false,
+    "proseWrap": "preserve"
+  },
+  "lint": {
+    "rules": {
+      "tags": ["recommended"]
+    }
+  },
+  "publish": {
+    "include": ["mod.ts", "src/", "README.md"],
+    "exclude": ["**/*.test.ts", "**/test_*.ts"]
+  }
+}

packages/python-runtime-agent/mod.ts

@@ -0,0 +1,8 @@
+import { PythonRuntimeAgent } from "./src/python-runtime-agent.ts";
+import { runner } from "@runt/lib";
+export { PythonRuntimeAgent };
+
+if (import.meta.main) {
+  const agent = new PythonRuntimeAgent();
+  await runner(agent);
+}

packages/python-runtime-agent/src/python-runtime-agent.ts

@@ -0,0 +1,41 @@
+import {
+  createRuntimeConfig,
+  RuntimeAgent,
+  type RuntimeConfig,
+} from "@runt/lib";
+
+export class PythonRuntimeAgent extends RuntimeAgent {
+  constructor(args: string[] = Deno.args) {
+    let config: RuntimeConfig;
+    try {
+      config = createRuntimeConfig(args, {
+        runtimeType: "python3",
+        capabilities: {
+          canExecuteCode: true,
+          canExecuteSql: false,
+          canExecuteAi: false,
+          availableAiModels: [],
+        },
+      });
+    } catch (error) {
+      // Configuration errors should still go to console for CLI usability
+      console.error("❌ Configuration Error:");
+      console.error(error instanceof Error ? error.message : String(error));
+      console.error("\nExample usage:");
+      console.error(
+        '  deno run --allow-all "jsr:@runt/python-runtime-agent" --notebook my-notebook --auth-token your-token',
+      );
+      console.error("\nOr set environment variables in .env:");
+      console.error("  NOTEBOOK_ID=my-notebook");
+      console.error("  AUTH_TOKEN=your-token");
+      console.error("\nOr install globally:");
+      console.error(
+        "  deno install -gf --allow-all jsr:@runt/python-runtime-agent",
+      );
+      console.error("  pyrunt --notebook my-notebook --auth-token your-token");
+      Deno.exit(1);
+    }
+
+    super(config, config.capabilities, {});
+  }
+}

packages/python-runtime-agent/test/simple-integration.test.ts

@@ -0,0 +1,37 @@
+// Simple Integration Test for PythonRuntimeAgent
+
+import { assertEquals, assertExists } from "jsr:@std/assert";
+import { PythonRuntimeAgent } from "../src/python-runtime-agent.ts";
+
+Deno.test("PythonRuntimeAgent - Basic Functionality (Stub)", async (t) => {
+  const env = {
+    RUNTIME_ID: "test-runtime",
+    NOTEBOOK_ID: "test-notebook",
+    AUTH_TOKEN: "test-token",
+  };
+  for (const [k, v] of Object.entries(env)) {
+    Deno.env.set(k, v);
+  }
+  try {
+    await t.step("can be constructed with minimal args", () => {
+      const agent = new PythonRuntimeAgent([]);
+      assertExists(agent);
+    });
+
+    await t.step("exposes required methods (stub)", () => {
+      const agent = new PythonRuntimeAgent([]);
+      assertEquals(typeof agent.start, "function");
+      assertEquals(typeof agent.shutdown, "function");
+      assertEquals(typeof agent.keepAlive, "function");
+    });
+
+    await t.step("has a config property (stub)", () => {
+      const agent = new PythonRuntimeAgent([]);
+      assertExists(agent.config);
+    });
+  } finally {
+    for (const k of Object.keys(env)) {
+      Deno.env.delete(k);
+    }
+  }
+});