quartermaster-code-runner 0.0.1__py3-none-any.whl

quartermaster_code_runner/runtime/bun/entrypoint.sh

@@ -0,0 +1,32 @@
+#!/bin/sh
+set -e
+
+chown runner:runner /tmp
+chown runner:runner /metadata 2>/dev/null || true
+
+exec su -p -s /bin/sh -c '
+    set -e
+    cd /tmp
+    export HOME=/home/runner
+    export BUN_INSTALL=/home/runner/.bun
+
+    # Copy SDK for user code access
+    cp /app/sdk.ts /tmp/sdk.ts
+
+    # Decode code to default filename
+    if [ -n "$ENCODED_CODE" ]; then
+        echo "$ENCODED_CODE" | base64 -d > main.ts
+    fi
+
+    # Extract additional files if provided
+    if [ -n "$ENCODED_FILES" ]; then
+        echo "$ENCODED_FILES" | base64 -d | tar -xz
+    fi
+
+    # Execute custom entrypoint or default
+    if [ -n "$CUSTOM_ENTRYPOINT" ]; then
+        exec sh -c "$CUSTOM_ENTRYPOINT"
+    else
+        exec bun main.ts
+    fi
+' runner

quartermaster_code_runner/runtime/bun/sdk.ts

@@ -0,0 +1,87 @@
+/**
+ * quartermaster-code-runner SDK for Bun runtime.
+ */
+
+const METADATA_FILE = "/metadata/.quartermaster_metadata.json";
+
+/**
+ * Set the result metadata to be returned to the backend.
+ *
+ * This separates structured results from stdout/stderr logs.
+ *
+ * @param data - Any JSON-serializable data (object, array, string, number, etc.)
+ *
+ * @example
+ * import { setMetadata } from './sdk';
+ *
+ * const result = { status: 'success', count: 42 };
+ * setMetadata(result);
+ */
+export function setMetadata(data: unknown): void {
+  Bun.write(METADATA_FILE, JSON.stringify(data));
+}
+
+/**
+ * Get previously set metadata (useful for reading/modifying).
+ *
+ * @returns The previously set metadata, or null if not set.
+ */
+export function getMetadata(): unknown {
+  const file = Bun.file(METADATA_FILE);
+  if (!file.size) {
+    return null;
+  }
+  return JSON.parse(file.text() as unknown as string);
+}
+
+/**
+ * Load a file from the flow's environment.
+ * Only available during flow execution, not test runs.
+ *
+ * @param path - Path to the file within the environment.
+ * @returns The file content as a string.
+ */
+export async function loadFile(path: string): Promise<string> {
+  const webdavUrl = process.env.QM_WEBDAV_URL;
+  if (!webdavUrl) {
+    throw new Error(
+      "loadFile() is only available during flow execution. " +
+        "For test runs, use mounted environments instead.",
+    );
+  }
+  const url = webdavUrl.replace(/\/?$/, "/") + path.replace(/^\//, "");
+  const resp = await fetch(url, { method: "GET" });
+  if (resp.status === 404) {
+    throw new Error(`File not found: ${path}`);
+  }
+  if (!resp.ok) {
+    throw new Error(`Failed to load file: HTTP ${resp.status}`);
+  }
+  return await resp.text();
+}
+
+/**
+ * Save a file to the flow's environment.
+ * Only available during flow execution, not test runs.
+ *
+ * @param path - Path to the file within the environment.
+ * @param content - The file content to save.
+ */
+export async function saveFile(path: string, content: string): Promise<void> {
+  const webdavUrl = process.env.QM_WEBDAV_URL;
+  if (!webdavUrl) {
+    throw new Error(
+      "saveFile() is only available during flow execution. " +
+        "For test runs, use mounted environments instead.",
+    );
+  }
+  const url = webdavUrl.replace(/\/?$/, "/") + path.replace(/^\//, "");
+  const resp = await fetch(url, {
+    method: "PUT",
+    headers: { "Content-Type": "application/octet-stream" },
+    body: content,
+  });
+  if (!resp.ok) {
+    throw new Error(`Failed to save file: HTTP ${resp.status}`);
+  }
+}

quartermaster_code_runner/runtime/deno/Dockerfile

@@ -0,0 +1,22 @@
+FROM denoland/deno:latest
+
+LABEL qm.name="Deno"
+LABEL qm.description="Deno runtime with TypeScript support"
+LABEL qm.default_entrypoint="deno run main.ts"
+LABEL qm.file_extension=".ts"
+LABEL qm.main_file="main.ts"
+
+WORKDIR /app
+
+RUN apt-get update && \
+    apt-get install -y tar && \
+    rm -rf /var/lib/apt/lists/* && \
+    useradd --uid 1001 --no-create-home --shell /bin/sh runner && \
+    mkdir -p /home/runner/.cache/deno && \
+    chown -R runner:runner /home/runner
+
+COPY entrypoint.sh .
+COPY sdk.ts /app/sdk.ts
+RUN chmod +x entrypoint.sh
+
+ENTRYPOINT ["/app/entrypoint.sh"]

quartermaster_code_runner/runtime/deno/completions.json

@@ -0,0 +1,34 @@
+[
+    {
+        "caption": "import { setMetadata } from './sdk.ts'",
+        "value": "import { setMetadata } from './sdk.ts';",
+        "meta": "import",
+        "score": 1000
+    },
+    {
+        "caption": "import { getMetadata } from './sdk.ts'",
+        "value": "import { getMetadata } from './sdk.ts';",
+        "meta": "import",
+        "score": 1000
+    },
+    {
+        "caption": "import { setMetadata, getMetadata } from './sdk.ts'",
+        "value": "import { setMetadata, getMetadata } from './sdk.ts';",
+        "meta": "import",
+        "score": 1000
+    },
+    {
+        "caption": "setMetadata",
+        "snippet": "setMetadata($1)",
+        "meta": "sdk",
+        "score": 1000,
+        "docText": "Set structured result metadata to be returned to the backend. Accepts any JSON-serializable data."
+    },
+    {
+        "caption": "getMetadata",
+        "snippet": "getMetadata()",
+        "meta": "sdk",
+        "score": 1000,
+        "docText": "Get previously set metadata. Returns null if not set."
+    }
+]

quartermaster_code_runner/runtime/deno/entrypoint.sh

@@ -0,0 +1,32 @@
+#!/bin/sh
+set -e
+
+chown runner:runner /tmp
+chown runner:runner /metadata 2>/dev/null || true
+
+exec su -p -s /bin/sh -c '
+    set -e
+    cd /tmp
+    export HOME=/home/runner
+    export DENO_DIR=/home/runner/.cache/deno
+
+    # Copy SDK for user code access
+    cp /app/sdk.ts /tmp/sdk.ts
+
+    # Decode code to default filename
+    if [ -n "$ENCODED_CODE" ]; then
+        echo "$ENCODED_CODE" | base64 -d > main.ts
+    fi
+
+    # Extract additional files if provided
+    if [ -n "$ENCODED_FILES" ]; then
+        echo "$ENCODED_FILES" | base64 -d | tar -xz
+    fi
+
+    # Execute custom entrypoint or default (allow all permissions for simplicity)
+    if [ -n "$CUSTOM_ENTRYPOINT" ]; then
+        exec sh -c "$CUSTOM_ENTRYPOINT"
+    else
+        exec deno run --allow-all main.ts
+    fi
+' runner

quartermaster_code_runner/runtime/deno/sdk.ts

@@ -0,0 +1,88 @@
+/**
+ * quartermaster-code-runner SDK for Deno runtime.
+ */
+
+const METADATA_FILE = "/metadata/.quartermaster_metadata.json";
+
+/**
+ * Set the result metadata to be returned to the backend.
+ *
+ * This separates structured results from stdout/stderr logs.
+ *
+ * @param data - Any JSON-serializable data (object, array, string, number, etc.)
+ *
+ * @example
+ * import { setMetadata } from './sdk.ts';
+ *
+ * const result = { status: 'success', count: 42 };
+ * setMetadata(result);
+ */
+export function setMetadata(data: unknown): void {
+  Deno.writeTextFileSync(METADATA_FILE, JSON.stringify(data));
+}
+
+/**
+ * Get previously set metadata (useful for reading/modifying).
+ *
+ * @returns The previously set metadata, or null if not set.
+ */
+export function getMetadata(): unknown {
+  try {
+    const content = Deno.readTextFileSync(METADATA_FILE);
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Load a file from the flow's environment.
+ * Only available during flow execution, not test runs.
+ *
+ * @param path - Path to the file within the environment.
+ * @returns The file content as a string.
+ */
+export async function loadFile(path: string): Promise<string> {
+  const webdavUrl = Deno.env.get("QM_WEBDAV_URL");
+  if (!webdavUrl) {
+    throw new Error(
+      "loadFile() is only available during flow execution. " +
+        "For test runs, use mounted environments instead.",
+    );
+  }
+  const url = webdavUrl.replace(/\/?$/, "/") + path.replace(/^\//, "");
+  const resp = await fetch(url, { method: "GET" });
+  if (resp.status === 404) {
+    throw new Error(`File not found: ${path}`);
+  }
+  if (!resp.ok) {
+    throw new Error(`Failed to load file: HTTP ${resp.status}`);
+  }
+  return await resp.text();
+}
+
+/**
+ * Save a file to the flow's environment.
+ * Only available during flow execution, not test runs.
+ *
+ * @param path - Path to the file within the environment.
+ * @param content - The file content to save.
+ */
+export async function saveFile(path: string, content: string): Promise<void> {
+  const webdavUrl = Deno.env.get("QM_WEBDAV_URL");
+  if (!webdavUrl) {
+    throw new Error(
+      "saveFile() is only available during flow execution. " +
+        "For test runs, use mounted environments instead.",
+    );
+  }
+  const url = webdavUrl.replace(/\/?$/, "/") + path.replace(/^\//, "");
+  const resp = await fetch(url, {
+    method: "PUT",
+    headers: { "Content-Type": "application/octet-stream" },
+    body: content,
+  });
+  if (!resp.ok) {
+    throw new Error(`Failed to save file: HTTP ${resp.status}`);
+  }
+}

quartermaster_code_runner/runtime/go/Dockerfile

@@ -0,0 +1,18 @@
+FROM golang:1.22-alpine
+
+LABEL qm.name="Go"
+LABEL qm.description="Go 1.22 runtime"
+LABEL qm.default_entrypoint="go run main.go"
+LABEL qm.file_extension=".go"
+LABEL qm.main_file="main.go"
+
+WORKDIR /app
+
+RUN apk add --no-cache tar && \
+    adduser -D -u 1001 -s /bin/sh runner
+
+COPY entrypoint.sh .
+COPY sdk.go .
+RUN chmod +x entrypoint.sh
+
+ENTRYPOINT ["/app/entrypoint.sh"]

quartermaster_code_runner/runtime/go/completions.json

@@ -0,0 +1,22 @@
+[
+    {
+        "caption": "import \"sdk\"",
+        "value": "import \"sdk\"",
+        "meta": "import",
+        "score": 1000
+    },
+    {
+        "caption": "sdk.SetMetadata",
+        "snippet": "sdk.SetMetadata($1)",
+        "meta": "sdk",
+        "score": 1000,
+        "docText": "Set structured result metadata to be returned to the backend. Accepts any JSON-serializable data."
+    },
+    {
+        "caption": "sdk.GetMetadata",
+        "snippet": "sdk.GetMetadata(&$1)",
+        "meta": "sdk",
+        "score": 1000,
+        "docText": "Get previously set metadata into the provided destination. Returns nil if no metadata has been set."
+    }
+]

quartermaster_code_runner/runtime/go/entrypoint.sh

@@ -0,0 +1,50 @@
+#!/bin/sh
+set -e
+
+chown runner:runner /tmp
+chown runner:runner /metadata 2>/dev/null || true
+chown runner:runner /workspace 2>/dev/null || true
+
+exec su -p -s /bin/sh -c '
+    set -e
+    cd /workspace
+    export HOME=/workspace
+    export GOCACHE=/workspace/.cache/go-build
+    export GOFLAGS="-buildvcs=false"
+    mkdir -p $GOCACHE
+
+    # Copy SDK for user code access and create go module structure
+    mkdir -p /workspace/sdk
+    cp /app/sdk.go /workspace/sdk/sdk.go
+
+    # Decode code to default filename
+    if [ -n "$ENCODED_CODE" ]; then
+        echo "$ENCODED_CODE" | base64 -d > main.go
+    fi
+
+    # Extract additional files if provided
+    if [ -n "$ENCODED_FILES" ]; then
+        echo "$ENCODED_FILES" | base64 -d | tar -xz
+    fi
+
+    # Create go.mod for the user code with local SDK
+    cat > go.mod << EOF
+module main
+go 1.22
+require sdk v0.0.0
+replace sdk => ./sdk
+EOF
+
+    # Create go.mod for the SDK
+    cat > /workspace/sdk/go.mod << EOF
+module sdk
+go 1.22
+EOF
+
+    # Execute custom entrypoint or default
+    if [ -n "$CUSTOM_ENTRYPOINT" ]; then
+        exec sh -c "$CUSTOM_ENTRYPOINT"
+    else
+        exec go run main.go
+    fi
+' runner

quartermaster_code_runner/runtime/go/sdk.go

@@ -0,0 +1,101 @@
+// Package sdk provides quartermaster-code-runner SDK for Go runtime.
+package sdk
+
+import (
+	"encoding/json"
+	"errors"
+	"fmt"
+	"io"
+	"net/http"
+	"os"
+	"strings"
+)
+
+const metadataFile = "/metadata/.quartermaster_metadata.json"
+
+// SetMetadata sets the result metadata to be returned to the backend.
+//
+// This separates structured results from stdout/stderr logs.
+//
+// Example:
+//
+//	import "sdk"
+//
+//	result := map[string]interface{}{"status": "success", "count": 42}
+//	sdk.SetMetadata(result)
+func SetMetadata(data interface{}) error {
+	jsonData, err := json.Marshal(data)
+	if err != nil {
+		return err
+	}
+	return os.WriteFile(metadataFile, jsonData, 0644)
+}
+
+// GetMetadata gets previously set metadata (useful for reading/modifying).
+//
+// Returns nil if no metadata has been set.
+func GetMetadata(dest interface{}) error {
+	data, err := os.ReadFile(metadataFile)
+	if err != nil {
+		if os.IsNotExist(err) {
+			return nil
+		}
+		return err
+	}
+	return json.Unmarshal(data, dest)
+}
+
+var errNoWebDAV = errors.New(
+	"LoadFile/SaveFile is only available during flow execution. " +
+		"For test runs, use mounted environments instead",
+)
+
+// LoadFile loads a file from the flow's environment.
+// Only available during flow execution, not test runs.
+func LoadFile(path string) (string, error) {
+	webdavURL := os.Getenv("QM_WEBDAV_URL")
+	if webdavURL == "" {
+		return "", errNoWebDAV
+	}
+	url := strings.TrimRight(webdavURL, "/") + "/" + strings.TrimLeft(path, "/")
+	resp, err := http.Get(url)
+	if err != nil {
+		return "", fmt.Errorf("failed to load file: %w", err)
+	}
+	defer resp.Body.Close()
+	if resp.StatusCode == 404 {
+		return "", fmt.Errorf("file not found: %s", path)
+	}
+	if resp.StatusCode < 200 || resp.StatusCode >= 300 {
+		return "", fmt.Errorf("failed to load file: HTTP %d", resp.StatusCode)
+	}
+	body, err := io.ReadAll(resp.Body)
+	if err != nil {
+		return "", fmt.Errorf("failed to read response: %w", err)
+	}
+	return string(body), nil
+}
+
+// SaveFile saves a file to the flow's environment.
+// Only available during flow execution, not test runs.
+func SaveFile(path, content string) error {
+	webdavURL := os.Getenv("QM_WEBDAV_URL")
+	if webdavURL == "" {
+		return errNoWebDAV
+	}
+	url := strings.TrimRight(webdavURL, "/") + "/" + strings.TrimLeft(path, "/")
+	req, err := http.NewRequest("PUT", url, strings.NewReader(content))
+	if err != nil {
+		return fmt.Errorf("failed to create request: %w", err)
+	}
+	req.Header.Set("Content-Type", "application/octet-stream")
+	resp, err := http.DefaultClient.Do(req)
+	if err != nil {
+		return fmt.Errorf("failed to save file: %w", err)
+	}
+	defer resp.Body.Close()
+	if resp.StatusCode < 200 || resp.StatusCode >= 300 {
+		return fmt.Errorf("failed to save file: HTTP %d", resp.StatusCode)
+	}
+	return nil
+}

quartermaster_code_runner/runtime/node/Dockerfile

@@ -0,0 +1,31 @@
+FROM node:22-slim
+
+LABEL qm.name="Node.js"
+LABEL qm.description="Node.js 22 with npm, npx, and bun"
+LABEL qm.default_entrypoint="node main.js"
+LABEL qm.file_extension=".js"
+LABEL qm.main_file="main.js"
+
+WORKDIR /app
+
+RUN apt-get update && \
+    apt-get install -y tar curl unzip git && \
+    rm -rf /var/lib/apt/lists/* && \
+    useradd --uid 1001 --no-create-home --shell /bin/sh runner && \
+    mkdir -p /home/runner/.npm /home/runner/.bun && \
+    chown -R runner:runner /home/runner
+
+# Install bun globally accessible
+ENV BUN_INSTALL=/usr/local
+RUN curl -fsSL https://bun.sh/install | bash
+
+# Pre-install common packages globally for faster startup
+RUN npm install -g typescript ts-node
+RUN npm install -g @gongrzhe/server-gmail-autoauth-mcp
+
+COPY entrypoint.sh .
+COPY sdk.js .
+COPY mcp-client.js .
+RUN chmod +x entrypoint.sh
+
+ENTRYPOINT ["/app/entrypoint.sh"]

quartermaster_code_runner/runtime/node/completions.json

@@ -0,0 +1,34 @@
+[
+    {
+        "caption": "const { setMetadata } = require('./sdk')",
+        "value": "const { setMetadata } = require('./sdk');",
+        "meta": "import",
+        "score": 1000
+    },
+    {
+        "caption": "const { getMetadata } = require('./sdk')",
+        "value": "const { getMetadata } = require('./sdk');",
+        "meta": "import",
+        "score": 1000
+    },
+    {
+        "caption": "const { setMetadata, getMetadata } = require('./sdk')",
+        "value": "const { setMetadata, getMetadata } = require('./sdk');",
+        "meta": "import",
+        "score": 1000
+    },
+    {
+        "caption": "setMetadata",
+        "snippet": "setMetadata($1)",
+        "meta": "sdk",
+        "score": 1000,
+        "docText": "Set structured result metadata to be returned to the backend. Accepts any JSON-serializable data."
+    },
+    {
+        "caption": "getMetadata",
+        "snippet": "getMetadata()",
+        "meta": "sdk",
+        "score": 1000,
+        "docText": "Get previously set metadata. Returns null if not set."
+    }
+]

quartermaster_code_runner/runtime/node/entrypoint.sh

@@ -0,0 +1,33 @@
+#!/bin/sh
+set -e
+
+chown runner:runner /tmp
+chown runner:runner /metadata 2>/dev/null || true
+
+exec su -p -s /bin/sh -c '
+    set -e
+    cd /tmp
+    export HOME=/home/runner
+    export NPM_CONFIG_CACHE=/tmp/.npm
+
+    # Copy SDK and MCP client for user code access
+    cp /app/sdk.js /tmp/sdk.js
+    cp /app/mcp-client.js /tmp/mcp-client.js
+
+    # Decode code to default filename
+    if [ -n "$ENCODED_CODE" ]; then
+        echo "$ENCODED_CODE" | base64 -d > main.js
+    fi
+
+    # Extract additional files if provided
+    if [ -n "$ENCODED_FILES" ]; then
+        echo "$ENCODED_FILES" | base64 -d | tar -xz
+    fi
+
+    # Execute custom entrypoint or default
+    if [ -n "$CUSTOM_ENTRYPOINT" ]; then
+        exec sh -c "$CUSTOM_ENTRYPOINT"
+    else
+        exec node main.js
+    fi
+' runner