@blokjs/runner 0.6.21 → 0.7.0

package/dist/concurrency/RedisConcurrencyBackend.js

@@ -1,374 +0,0 @@
-/**
- * Tier C #4 follow-up · Redis-backed concurrency backend.
- *
- * Coordinates per-(workflow, concurrencyKey) lease state across processes
- * via a single Redis key per bucket. Atomicity comes from server-side Lua
- * scripts — `EVAL` runs single-threaded against the keyspace, so the
- * read → filter → check-limit → write sequence is a single round-trip
- * with no OCC retry loop (the headline win over the NATS KV backend's
- * `WATCH`/`MULTI`/`EXEC`-style optimistic concurrency).
- *
- * Storage model: one Redis string key per `(workflowName, concurrencyKey)`
- * bucket. Value is a JSON-encoded `{leases: [{runId, expiresAt}]}`
- * document. Bounded-cardinality assumption identical to NATS KV — typical
- * concurrency keys hold 1-50 active leases.
- *
- * Lease leak: each lease carries an `expiresAt`. Expired leases are
- * lazy-purged inside the Lua script that observes them; an explicit
- * `purgeExpired` SCAN sweep is also exposed for janitor use.
- *
- * Connection: ioredis is loaded via dynamic `import("ioredis")` so the
- * dependency stays optional. Matches the existing pattern used by
- * `triggers/worker`'s `RedisStreamsAdapter` and
- * `triggers/pubsub`'s `RedisStreamsPubSubAdapter`.
- */
-import { ConcurrencyMetrics } from "../monitoring/ConcurrencyMetrics";
-const DEFAULT_KEY_PREFIX = "blok-concurrency";
-/**
- * Read configuration from environment variables. Used by
- * {@link createConcurrencyBackend} when the operator opts into Redis.
- */
-export function readRedisConfigFromEnv() {
-    const url = process.env.BLOK_CONCURRENCY_REDIS_URL?.trim() || undefined;
-    const host = process.env.BLOK_CONCURRENCY_REDIS_HOST?.trim() || undefined;
-    const portRaw = process.env.BLOK_CONCURRENCY_REDIS_PORT?.trim();
-    const port = portRaw && /^\d+$/.test(portRaw) ? Number(portRaw) : undefined;
-    const dbRaw = process.env.BLOK_CONCURRENCY_REDIS_DB?.trim();
-    const db = dbRaw && /^\d+$/.test(dbRaw) ? Number(dbRaw) : undefined;
-    const tls = process.env.BLOK_CONCURRENCY_REDIS_TLS === "1" || process.env.BLOK_CONCURRENCY_REDIS_TLS === "true";
-    return {
-        url,
-        host,
-        port,
-        password: process.env.BLOK_CONCURRENCY_REDIS_PASSWORD,
-        username: process.env.BLOK_CONCURRENCY_REDIS_USERNAME,
-        db,
-        tls,
-        keyPrefix: process.env.BLOK_CONCURRENCY_REDIS_KEY_PREFIX?.trim() || DEFAULT_KEY_PREFIX,
-    };
-}
-/**
- * Atomic acquire. Returns `{acquired, currentInFlight}` as a 2-element array.
- *
- * Storage shape: the bucket is either MISSING (no active leases) or a
- * JSON string `{"leases":[{"runId":"...","expiresAt":<ms>}, ...]}`.
- * When the leases array would become empty we DEL the key — we never
- * encode the empty array (sidesteps the cjson empty-table-as-object trap).
- *
- * KEYS[1] = bucket key
- * ARGV[1] = limit (int as string)
- * ARGV[2] = runId
- * ARGV[3] = leaseExpiresAt (ms as string)
- * ARGV[4] = now (ms as string)
- *
- * Returns: {acquired, currentInFlight}
- *  - acquired: 1 = granted, 0 = denied
- *  - currentInFlight: in-flight count INCLUDING the granted slot on success,
- *                     count at denial on rejection.
- */
-const ACQUIRE_LUA = `
-local raw = redis.call('GET', KEYS[1])
-local leases = {}
-if raw and raw ~= '' then
-  local ok, parsed = pcall(cjson.decode, raw)
-  if ok and type(parsed) == 'table' and type(parsed.leases) == 'table' then
-    leases = parsed.leases
-  end
-end
-
-local now = tonumber(ARGV[4])
-local active = {}
-for i = 1, #leases do
-  local l = leases[i]
-  if type(l) == 'table' and tonumber(l.expiresAt) and tonumber(l.expiresAt) > now then
-    active[#active + 1] = { runId = tostring(l.runId), expiresAt = tonumber(l.expiresAt) }
-  end
-end
-
-local runId = ARGV[2]
-local newExpires = tonumber(ARGV[3])
-
--- Idempotent re-acquire: refresh lease, don't grow count.
-for i = 1, #active do
-  if active[i].runId == runId then
-    active[i] = { runId = runId, expiresAt = newExpires }
-    redis.call('SET', KEYS[1], cjson.encode({ leases = active }))
-    return { 1, #active }
-  end
-end
-
-local limit = tonumber(ARGV[1])
-if #active >= limit then
-  -- Persist the purge of expired entries (if any) so the bucket stays clean.
-  if #active < #leases then
-    if #active == 0 then
-      redis.call('DEL', KEYS[1])
-    else
-      redis.call('SET', KEYS[1], cjson.encode({ leases = active }))
-    end
-  end
-  return { 0, #active }
-end
-
-active[#active + 1] = { runId = runId, expiresAt = newExpires }
-redis.call('SET', KEYS[1], cjson.encode({ leases = active }))
-return { 1, #active }
-`;
-/**
- * Atomic release. Removes a lease by runId. DELs the bucket when empty.
- *
- * KEYS[1] = bucket key
- * ARGV[1] = runId
- *
- * Returns: 1 if a lease was removed, 0 if no-op (bucket missing or runId not present).
- */
-const RELEASE_LUA = `
-local raw = redis.call('GET', KEYS[1])
-if not raw or raw == '' then return 0 end
-
-local ok, parsed = pcall(cjson.decode, raw)
-if not ok or type(parsed) ~= 'table' or type(parsed.leases) ~= 'table' then return 0 end
-
-local target = ARGV[1]
-local next_leases = {}
-local removed = 0
-for i = 1, #parsed.leases do
-  local l = parsed.leases[i]
-  if type(l) == 'table' and tostring(l.runId) == target then
-    removed = 1
-  else
-    next_leases[#next_leases + 1] = { runId = tostring(l.runId), expiresAt = tonumber(l.expiresAt) }
-  end
-end
-
-if removed == 0 then return 0 end
-
-if #next_leases == 0 then
-  redis.call('DEL', KEYS[1])
-else
-  redis.call('SET', KEYS[1], cjson.encode({ leases = next_leases }))
-end
-return 1
-`;
-/**
- * Purge expired leases from a single bucket. Atomic.
- *
- * KEYS[1] = bucket key
- * ARGV[1] = now (ms as string)
- *
- * Returns: number of leases purged.
- */
-const PURGE_BUCKET_LUA = `
-local raw = redis.call('GET', KEYS[1])
-if not raw or raw == '' then return 0 end
-
-local ok, parsed = pcall(cjson.decode, raw)
-if not ok or type(parsed) ~= 'table' or type(parsed.leases) ~= 'table' then return 0 end
-
-local now = tonumber(ARGV[1])
-local active = {}
-for i = 1, #parsed.leases do
-  local l = parsed.leases[i]
-  if type(l) == 'table' and tonumber(l.expiresAt) and tonumber(l.expiresAt) > now then
-    active[#active + 1] = { runId = tostring(l.runId), expiresAt = tonumber(l.expiresAt) }
-  end
-end
-
-local purged = #parsed.leases - #active
-if purged == 0 then return 0 end
-
-if #active == 0 then
-  redis.call('DEL', KEYS[1])
-else
-  redis.call('SET', KEYS[1], cjson.encode({ leases = active }))
-end
-return purged
-`;
-export class RedisConcurrencyBackend {
-    name = "redis";
-    client = null;
-    config;
-    connected = false;
-    constructor(config) {
-        const env = readRedisConfigFromEnv();
-        this.config = {
-            url: config?.url ?? env.url,
-            host: config?.host ?? env.host,
-            port: config?.port ?? env.port,
-            password: config?.password ?? env.password,
-            username: config?.username ?? env.username,
-            db: config?.db ?? env.db,
-            tls: config?.tls ?? env.tls,
-            keyPrefix: config?.keyPrefix ?? env.keyPrefix,
-        };
-    }
-    async connect() {
-        if (this.connected)
-            return;
-        // Security review FW-5 parity — refuse to start in production with
-        // the default key prefix. Two deployments sharing a Redis instance
-        // would silently contend on the same `(workflow, key)` buckets,
-        // corrupting concurrency state across tenants.
-        const blokEnv = process.env.BLOK_ENV;
-        const nodeEnv = process.env.NODE_ENV;
-        const isProd = blokEnv === "production" || nodeEnv === "production";
-        if (isProd && this.config.keyPrefix === DEFAULT_KEY_PREFIX) {
-            throw new Error(`[blok] Redis concurrency backend refuses to start in production with the default key prefix ('${DEFAULT_KEY_PREFIX}'). Set BLOK_CONCURRENCY_REDIS_KEY_PREFIX to a deployment-unique value (e.g. 'blok-concurrency-acme-prod') to prevent cross-deployment collision on a shared Redis instance.`);
-        }
-        let ioredisModule;
-        try {
-            ioredisModule = (await import("ioredis"));
-        }
-        catch (err) {
-            throw new Error(`RedisConcurrencyBackend requires the 'ioredis' package. Install it: \`bun add ioredis\` or \`npm install ioredis\`. Underlying error: ${err instanceof Error ? err.message : String(err)}`);
-        }
-        const IORedisCtor = ioredisModule.default ?? ioredisModule.Redis;
-        if (!IORedisCtor) {
-            throw new Error("RedisConcurrencyBackend could not locate the ioredis constructor on the imported module. Reinstall ioredis or report this issue.");
-        }
-        // Production-friendly defaults: fail fast on connection trouble
-        // rather than hanging triggers on broker outage. Operators who
-        // want different semantics can layer a wrapper or fork the
-        // backend — these are intentional opinions matching the "trigger
-        // startup should not block indefinitely on broker reachability"
-        // posture of the rest of the runner.
-        const failFastDefaults = {
-            connectTimeout: 5_000,
-            maxRetriesPerRequest: 0,
-            enableOfflineQueue: false,
-            lazyConnect: true,
-        };
-        if (this.config.url) {
-            this.client = new IORedisCtor(this.config.url);
-        }
-        else {
-            const opts = { ...failFastDefaults };
-            if (this.config.host)
-                opts.host = this.config.host;
-            if (this.config.port)
-                opts.port = this.config.port;
-            if (this.config.username)
-                opts.username = this.config.username;
-            if (this.config.password)
-                opts.password = this.config.password;
-            if (typeof this.config.db === "number")
-                opts.db = this.config.db;
-            if (this.config.tls)
-                opts.tls = {};
-            this.client = new IORedisCtor(opts);
-        }
-        // Surface async errors instead of crashing the process.
-        this.client.on("error", (err) => {
-            console.warn(`[blok][concurrency][redis] client error: ${err.message}`);
-        });
-        await this.client.ping();
-        this.connected = true;
-    }
-    async disconnect() {
-        if (!this.connected)
-            return;
-        try {
-            await this.client?.quit();
-        }
-        catch {
-            // quit() can reject if the connection is already torn down; ignore.
-        }
-        finally {
-            this.client = null;
-            this.connected = false;
-        }
-    }
-    bucketKey(workflowName, concurrencyKey) {
-        // Mirror NATS KV's hex-escape scheme so workflow/key strings with
-        // special characters (`:`, `>`, etc.) round-trip without collision.
-        // Cross-backend portability matters when operators migrate between
-        // backends: the same `(workflow, key)` pair maps to the same bucket
-        // identity modulo the prefix.
-        return `${this.config.keyPrefix}:${this.encodeSegment(workflowName)}__${this.encodeSegment(concurrencyKey)}`;
-    }
-    encodeSegment(s) {
-        // Same regex as NATS KV — replace anything outside the safe set
-        // with hex escape `_HHHH_` so the encoding is lossless and matches
-        // the NATS backend byte-for-byte modulo prefix.
-        return s.replace(/[^-_=.a-zA-Z0-9]/g, (ch) => `_${ch.codePointAt(0)?.toString(16)}_`);
-    }
-    requireClient() {
-        if (!this.client) {
-            throw new Error("RedisConcurrencyBackend not connected — call connect() first.");
-        }
-        return this.client;
-    }
-    async acquireSlot(workflowName, concurrencyKey, concurrencyLimit, runId, leaseExpiresAt) {
-        const client = this.requireClient();
-        const key = this.bucketKey(workflowName, concurrencyKey);
-        const metricAttrs = { workflow_name: workflowName, concurrency_key: concurrencyKey };
-        try {
-            const raw = await client.eval(ACQUIRE_LUA, 1, key, String(concurrencyLimit), runId, String(leaseExpiresAt), String(Date.now()));
-            const [acquiredFlag, currentInFlight] = this.parsePair(raw);
-            const outcome = acquiredFlag === 1 ? "success" : "denied";
-            // Lua is single-shot — attempt depth is always 0.
-            ConcurrencyMetrics.getInstance().recordOccRetries({ ...metricAttrs, outcome }, 0);
-            return { acquired: acquiredFlag === 1, currentInFlight };
-        }
-        catch (err) {
-            console.warn(`[blok][concurrency][redis] acquireSlot eval failed for ${workflowName}:${concurrencyKey}: ${err instanceof Error ? err.message : String(err)}; failing closed`);
-            ConcurrencyMetrics.getInstance().recordOccRetries({ ...metricAttrs, outcome: "fail-closed" }, 0);
-            return { acquired: false, currentInFlight: -1 };
-        }
-    }
-    async releaseSlot(workflowName, concurrencyKey, runId) {
-        const client = this.requireClient();
-        const key = this.bucketKey(workflowName, concurrencyKey);
-        try {
-            await client.eval(RELEASE_LUA, 1, key, runId);
-        }
-        catch (err) {
-            // Lease will expire via TTL — release is best-effort. Surface
-            // the error so operators can see broker outages.
-            console.warn(`[blok][concurrency][redis] releaseSlot eval failed for ${workflowName}:${concurrencyKey} runId=${runId}: ${err instanceof Error ? err.message : String(err)}; lease will expire via TTL`);
-        }
-    }
-    async purgeExpired(now) {
-        const client = this.requireClient();
-        const pattern = `${this.config.keyPrefix}:*`;
-        let cursor = "0";
-        let purged = 0;
-        do {
-            let res;
-            try {
-                res = await client.scan(cursor, "MATCH", pattern, "COUNT", 100);
-            }
-            catch (err) {
-                console.warn(`[blok][concurrency][redis] purgeExpired SCAN failed: ${err instanceof Error ? err.message : String(err)}; aborting sweep`);
-                return purged;
-            }
-            const [nextCursor, keys] = res;
-            cursor = nextCursor;
-            for (const key of keys) {
-                try {
-                    const raw = await client.eval(PURGE_BUCKET_LUA, 1, key, String(now));
-                    const count = typeof raw === "number" ? raw : Number(raw);
-                    if (!Number.isNaN(count))
-                        purged += count;
-                }
-                catch {
-                    // Best-effort — skip this bucket; janitor will retry on next sweep.
-                }
-            }
-        } while (cursor !== "0");
-        return purged;
-    }
-    /**
-     * Decode the `{acquired, currentInFlight}` pair from a Lua eval result.
-     * ioredis returns Redis arrays as plain JS arrays of (string | number)
-     * — the script returns integers, so both elements should be numbers.
-     */
-    parsePair(raw) {
-        if (!Array.isArray(raw) || raw.length < 2)
-            return [0, -1];
-        const acquired = typeof raw[0] === "number" ? raw[0] : Number(raw[0]);
-        const current = typeof raw[1] === "number" ? raw[1] : Number(raw[1]);
-        return [Number.isFinite(acquired) ? acquired : 0, Number.isFinite(current) ? current : -1];
-    }
-}
-//# sourceMappingURL=RedisConcurrencyBackend.js.map

package/dist/concurrency/RedisConcurrencyBackend.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"RedisConcurrencyBackend.js","sourceRoot":"","sources":["../../src/concurrency/RedisConcurrencyBackend.ts"],"names":[],"mappings":"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"}

package/dist/concurrency/createConcurrencyBackend.d.ts

@@ -1,24 +0,0 @@
-/**
- * Tier 2 #6 follow-up · concurrency backend factory.
- *
- * Reads `BLOK_CONCURRENCY_BACKEND` and returns the matching backend
- * instance, or `null` when the user wants the default in-process behavior.
- *
- * Trigger packages call this in `listen()` and pass the result to
- * `RunTracker.getInstance().setConcurrencyBackend(backend)`.
- */
-import type { ConcurrencyBackend } from "./ConcurrencyBackend";
-/**
- * Returns a configured `ConcurrencyBackend` based on
- * `BLOK_CONCURRENCY_BACKEND`, or `null` for the default in-process backend.
- *
- * Recognized values:
- * - unset / `""` / `"memory"` — null (use default in-process via RunStore)
- * - `"nats-kv"` — NATS KV backend (requires `nats` package + reachable NATS server)
- * - `"redis"` — Redis backend (requires `ioredis` package + reachable Redis server)
- *
- * Unknown values throw at startup with a clear error message — silently
- * falling back would be dangerous (operator thinks they configured cross-
- * process coordination but they didn't).
- */
-export declare function createConcurrencyBackend(): ConcurrencyBackend | null;

package/dist/concurrency/createConcurrencyBackend.js

@@ -1,38 +0,0 @@
-/**
- * Tier 2 #6 follow-up · concurrency backend factory.
- *
- * Reads `BLOK_CONCURRENCY_BACKEND` and returns the matching backend
- * instance, or `null` when the user wants the default in-process behavior.
- *
- * Trigger packages call this in `listen()` and pass the result to
- * `RunTracker.getInstance().setConcurrencyBackend(backend)`.
- */
-import { NatsKvConcurrencyBackend } from "./NatsKvConcurrencyBackend";
-import { RedisConcurrencyBackend } from "./RedisConcurrencyBackend";
-/**
- * Returns a configured `ConcurrencyBackend` based on
- * `BLOK_CONCURRENCY_BACKEND`, or `null` for the default in-process backend.
- *
- * Recognized values:
- * - unset / `""` / `"memory"` — null (use default in-process via RunStore)
- * - `"nats-kv"` — NATS KV backend (requires `nats` package + reachable NATS server)
- * - `"redis"` — Redis backend (requires `ioredis` package + reachable Redis server)
- *
- * Unknown values throw at startup with a clear error message — silently
- * falling back would be dangerous (operator thinks they configured cross-
- * process coordination but they didn't).
- */
-export function createConcurrencyBackend() {
-    const kind = (process.env.BLOK_CONCURRENCY_BACKEND ?? "").trim().toLowerCase();
-    if (!kind || kind === "memory" || kind === "in-process")
-        return null;
-    switch (kind) {
-        case "nats-kv":
-            return new NatsKvConcurrencyBackend();
-        case "redis":
-            return new RedisConcurrencyBackend();
-        default:
-            throw new Error(`Unknown BLOK_CONCURRENCY_BACKEND='${kind}'. Expected one of: 'memory' (default), 'nats-kv', 'redis'.`);
-    }
-}
-//# sourceMappingURL=createConcurrencyBackend.js.map

package/dist/concurrency/createConcurrencyBackend.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"createConcurrencyBackend.js","sourceRoot":"","sources":["../../src/concurrency/createConcurrencyBackend.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB;IACvC,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/E,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC;IAErE,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,SAAS;YACb,OAAO,IAAI,wBAAwB,EAAE,CAAC;QACvC,KAAK,OAAO;YACX,OAAO,IAAI,uBAAuB,EAAE,CAAC;QACtC;YACC,MAAM,IAAI,KAAK,CACd,qCAAqC,IAAI,6DAA6D,CACtG,CAAC;IACJ,CAAC;AACF,CAAC"}

package/dist/graphql/GraphQLSchemaGenerator.d.ts

@@ -1,129 +0,0 @@
-/**
- * GraphQL Schema Generator for Blok Workflows
- *
- * Automatically generates GraphQL schema definitions (SDL) from workflow definitions.
- * Introspects HTTP trigger configurations and node structures to produce
- * Query/Mutation types with appropriate input/output types.
- *
- * @example
- * ```typescript
- * const generator = new GraphQLSchemaGenerator({
- *   schemaName: "BlokAPI",
- *   includeSubscriptions: true,
- * });
- *
- * generator.addWorkflow({
- *   name: "get-user",
- *   version: "1.0.0",
- *   trigger: { http: { method: "GET", path: "/users/:id" } },
- *   steps: [{ name: "fetch", node: "db-query", type: "local" }],
- *   nodes: { "db-query": {} },
- * });
- *
- * console.log(generator.generate());
- * ```
- */
-export interface GraphQLGeneratorConfig {
-    /** Schema name used in documentation */
-    schemaName?: string;
-    /** Description for the schema */
-    description?: string;
-    /** Include subscription types for WebSocket/SSE workflows */
-    includeSubscriptions?: boolean;
-    /** Include workflow metadata in type descriptions */
-    includeMetadata?: boolean;
-    /** Custom scalar definitions */
-    customScalars?: Array<{
-        name: string;
-        description: string;
-    }>;
-}
-export interface GqlWorkflowDefinition {
-    name: string;
-    version: string;
-    description?: string;
-    trigger: {
-        http?: {
-            method: string;
-            path: string;
-        };
-        grpc?: {
-            service: string;
-            method: string;
-        };
-        websocket?: {
-            path?: string;
-        };
-        sse?: {
-            path?: string;
-        };
-        [key: string]: unknown;
-    };
-    steps: Array<{
-        name: string;
-        node: string;
-        type?: string;
-        runtime?: string;
-    }>;
-    nodes: Record<string, unknown>;
-    inputs?: Record<string, GqlFieldDef>;
-    outputs?: Record<string, GqlFieldDef>;
-}
-export interface GqlFieldDef {
-    type: string;
-    required?: boolean;
-    description?: string;
-    items?: GqlFieldDef;
-    fields?: Record<string, GqlFieldDef>;
-}
-export declare class GraphQLSchemaGenerator {
-    private config;
-    private workflows;
-    private customTypes;
-    constructor(config?: GraphQLGeneratorConfig);
-    addWorkflow(workflow: GqlWorkflowDefinition): void;
-    addWorkflows(workflows: GqlWorkflowDefinition[]): void;
-    addCustomType(name: string, definition: string): void;
-    /**
-     * Generate GraphQL Schema Definition Language (SDL)
-     */
-    generate(): string;
-    /**
-     * Generate an introspection-friendly JSON representation
-     */
-    toJSON(): GraphQLSchemaJSON;
-    private resolveWorkflow;
-    private generateInputType;
-    private generateOutputType;
-    private generateFieldDefinition;
-    private generateSubscriptionField;
-    private inferOutputFields;
-    private inferInputFields;
-    private fieldDefToGraphQLType;
-    private getTriggerType;
-    private extractPathParams;
-    private toPascalCase;
-    private toFieldName;
-    private emptySchema;
-}
-export interface GraphQLSchemaJSON {
-    schemaName: string;
-    types: GraphQLTypeInfo[];
-    queries: GraphQLFieldInfo[];
-    mutations: GraphQLFieldInfo[];
-    subscriptions: GraphQLFieldInfo[];
-}
-export interface GraphQLTypeInfo {
-    name: string;
-    kind: "OBJECT" | "INPUT_OBJECT" | "ENUM" | "SCALAR";
-    fields: GraphQLFieldInfo[];
-}
-export interface GraphQLFieldInfo {
-    name: string;
-    type: string;
-    description?: string;
-    args?: Array<{
-        name: string;
-        type: string;
-    }>;
-}