deepadb 1.0.0

package/build/tools/workflow-market.js

@@ -0,0 +1,237 @@
+/**
+ * Workflow Marketplace — Community-shared workflow definitions.
+ *
+ * Extends the plugin registry model to include shareable workflow JSON
+ * definitions. Community-contributed test workflows, diagnostic sequences,
+ * and audit procedures are hosted in a registry manifest alongside plugins.
+ *
+ * Workflows are downloaded as JSON files into {tempDir}/workflows/ — the
+ * same directory used by the workflow orchestration engine, so installed
+ * marketplace workflows are immediately available to adb_workflow_run.
+ *
+ * Registry: reuses DA_REGISTRY_URL or a dedicated DA_WORKFLOW_REGISTRY_URL.
+ * Manifest: JSON array of { name, description, version, url, author, tags }.
+ */
+import { z } from "zod";
+import { join } from "path";
+import { writeFileSync, readFileSync, existsSync, readdirSync, mkdirSync } from "fs";
+import { createHash } from "crypto";
+import { OutputProcessor } from "../middleware/output-processor.js";
+import { fetchJson, fetchText } from "../middleware/fetch-utils.js";
+const DEFAULT_WORKFLOW_REGISTRY_URL = "https://raw.githubusercontent.com/anthropics/DeepADB-plugins/main/workflows.json";
+function getRegistryUrl() {
+    return process.env.DA_WORKFLOW_REGISTRY_URL ?? process.env.DA_REGISTRY_URL?.replace("registry.json", "workflows.json") ?? DEFAULT_WORKFLOW_REGISTRY_URL;
+}
+function getWorkflowDir(tempDir) {
+    return join(tempDir, "workflows");
+}
+function getInstalledWorkflows(dir) {
+    const installed = new Map();
+    if (!existsSync(dir))
+        return installed;
+    for (const file of readdirSync(dir).filter((f) => f.endsWith(".json"))) {
+        try {
+            const wf = JSON.parse(readFileSync(join(dir, file), "utf-8"));
+            const name = file.replace(".json", "");
+            installed.set(name, {
+                version: wf._marketplace?.version ?? "local",
+                description: wf.description ?? "",
+            });
+        }
+        catch { /* skip corrupt */ }
+    }
+    return installed;
+}
+export function registerWorkflowMarketTools(ctx) {
+    ctx.server.tool("adb_market_search", "Search the workflow marketplace for community-shared workflow definitions. Shows name, description, tags, author, and step count. Indicates which workflows are already installed locally.", {
+        query: z.string().optional().describe("Filter by name, description, or tag keyword"),
+        tag: z.string().optional().describe("Filter by exact tag (e.g., 'testing', 'diagnostics', 'security')"),
+    }, async ({ query, tag }) => {
+        try {
+            const registryUrl = getRegistryUrl();
+            let manifest;
+            try {
+                manifest = await fetchJson(registryUrl);
+            }
+            catch (error) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Could not fetch workflow marketplace from ${registryUrl}\n${error instanceof Error ? error.message : error}\n\nSet DA_WORKFLOW_REGISTRY_URL to a custom registry, or check your network connection.`,
+                        }],
+                    isError: true,
+                };
+            }
+            if (!Array.isArray(manifest)) {
+                return { content: [{ type: "text", text: "Invalid marketplace manifest (expected JSON array)." }], isError: true };
+            }
+            let filtered = manifest;
+            if (query) {
+                const q = query.toLowerCase();
+                filtered = filtered.filter((w) => w.name.toLowerCase().includes(q) ||
+                    w.description.toLowerCase().includes(q) ||
+                    (w.tags ?? []).some((t) => t.toLowerCase().includes(q)));
+            }
+            if (tag) {
+                const t = tag.toLowerCase();
+                filtered = filtered.filter((w) => (w.tags ?? []).some((wt) => wt.toLowerCase() === t));
+            }
+            if (filtered.length === 0) {
+                return { content: [{ type: "text", text: query || tag ? `No workflows matching "${query ?? tag}" in marketplace.` : "Marketplace is empty." }] };
+            }
+            const dir = getWorkflowDir(ctx.config.tempDir);
+            const installed = getInstalledWorkflows(dir);
+            const lines = filtered.map((w) => {
+                const status = installed.has(w.name) ? " [installed]" : "";
+                const tagStr = w.tags && w.tags.length > 0 ? `\n  Tags: ${w.tags.join(", ")}` : "";
+                const stepsStr = w.steps ? ` (${w.steps} steps)` : "";
+                return `${w.name} v${w.version}${stepsStr}${status}\n  ${w.description}${tagStr}${w.author ? `\n  Author: ${w.author}` : ""}`;
+            });
+            return {
+                content: [{
+                        type: "text",
+                        text: `${filtered.length} workflow(s) in marketplace:\n\n${lines.join("\n\n")}\n\nRegistry: ${registryUrl}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_market_install", "Download and install a workflow from the marketplace. Saves to the workflows directory for immediate use with adb_workflow_run.", {
+        name: z.string().describe("Workflow name from the marketplace"),
+        force: z.boolean().optional().default(false).describe("Overwrite if a workflow with this name already exists locally"),
+    }, async ({ name, force }) => {
+        try {
+            const registryUrl = getRegistryUrl();
+            let manifest;
+            try {
+                manifest = await fetchJson(registryUrl);
+            }
+            catch (error) {
+                return { content: [{ type: "text", text: `Could not fetch marketplace: ${error instanceof Error ? error.message : error}` }], isError: true };
+            }
+            const entry = manifest.find((w) => w.name === name);
+            if (!entry) {
+                const available = manifest.map((w) => w.name).join(", ");
+                return { content: [{ type: "text", text: `Workflow "${name}" not found in marketplace.\nAvailable: ${available || "(empty)"}` }], isError: true };
+            }
+            const dir = getWorkflowDir(ctx.config.tempDir);
+            if (!existsSync(dir))
+                mkdirSync(dir, { recursive: true });
+            const safeName = name.replace(/[^a-zA-Z0-9_-]/g, "_");
+            const filePath = join(dir, `${safeName}.json`);
+            if (existsSync(filePath) && !force) {
+                return { content: [{ type: "text", text: `Workflow "${name}" already exists locally. Use force=true to overwrite.` }], isError: true };
+            }
+            // Download
+            let rawJson;
+            try {
+                rawJson = await fetchText(entry.url);
+            }
+            catch (error) {
+                return { content: [{ type: "text", text: `Failed to download workflow: ${error instanceof Error ? error.message : error}` }], isError: true };
+            }
+            // Integrity verification
+            if (entry.sha256) {
+                const actualHash = createHash("sha256").update(rawJson).digest("hex");
+                if (actualHash !== entry.sha256) {
+                    return {
+                        content: [{
+                                type: "text",
+                                text: `Integrity check failed for workflow "${name}".\nExpected SHA-256: ${entry.sha256}\nActual SHA-256:   ${actualHash}`,
+                            }],
+                        isError: true,
+                    };
+                }
+            }
+            // Validate it's a proper workflow
+            let parsed;
+            try {
+                parsed = JSON.parse(rawJson);
+            }
+            catch {
+                return { content: [{ type: "text", text: `Downloaded content is not valid JSON.` }], isError: true };
+            }
+            if (!parsed.name || !Array.isArray(parsed.steps)) {
+                return { content: [{ type: "text", text: `Downloaded JSON is not a valid workflow (missing 'name' or 'steps').` }], isError: true };
+            }
+            // Attach marketplace metadata
+            parsed._marketplace = {
+                version: entry.version,
+                author: entry.author,
+                sourceUrl: entry.url,
+                installedAt: new Date().toISOString(),
+            };
+            writeFileSync(filePath, JSON.stringify(parsed, null, 2));
+            const stepCount = Array.isArray(parsed.steps) ? parsed.steps.length : "?";
+            return {
+                content: [{
+                        type: "text",
+                        text: `Workflow "${name}" v${entry.version} installed (${stepCount} steps).\nSaved: ${filePath}\nRun with: adb_workflow_run workflow="${safeName}"`,
+                    }],
+            };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_market_export", "Export a local workflow with marketplace metadata for sharing. Produces a JSON file with name, description, version, author, and tags suitable for submission to the marketplace registry.", {
+        workflow: z.string().describe("Name of the local workflow to export (from adb_workflow_list)"),
+        author: z.string().optional().describe("Author name to include in metadata"),
+        version: z.string().optional().default("1.0.0").describe("Version string"),
+        tags: z.array(z.string()).optional().describe("Tags for discovery (e.g., ['testing', 'diagnostics'])"),
+    }, async ({ workflow, author, version, tags }) => {
+        try {
+            const dir = getWorkflowDir(ctx.config.tempDir);
+            const safeName = workflow.replace(/[^a-zA-Z0-9_-]/g, "_");
+            const filePath = join(dir, `${safeName}.json`);
+            if (!existsSync(filePath)) {
+                return { content: [{ type: "text", text: `Workflow "${workflow}" not found. Use adb_workflow_list to see available workflows.` }], isError: true };
+            }
+            const wf = JSON.parse(readFileSync(filePath, "utf-8"));
+            // Build export package
+            const exportPkg = {
+                ...wf,
+                _marketplace: {
+                    version,
+                    author: author ?? "unknown",
+                    tags: tags ?? [],
+                    exportedAt: new Date().toISOString(),
+                },
+            };
+            const exportJson = JSON.stringify(exportPkg, null, 2);
+            const sha256 = createHash("sha256").update(exportJson).digest("hex");
+            const exportPath = join(dir, `${safeName}.export.json`);
+            writeFileSync(exportPath, exportJson);
+            const stepCount = Array.isArray(wf.steps) ? wf.steps.length : "?";
+            const sections = [];
+            sections.push(`Workflow exported for marketplace sharing:`);
+            sections.push(`  Name: ${wf.name ?? safeName}`);
+            sections.push(`  Description: ${wf.description ?? "(none)"}`);
+            sections.push(`  Version: ${version}`);
+            sections.push(`  Steps: ${stepCount}`);
+            sections.push(`  Author: ${author ?? "unknown"}`);
+            if (tags && tags.length > 0)
+                sections.push(`  Tags: ${tags.join(", ")}`);
+            sections.push(`  SHA-256: ${sha256}`);
+            sections.push(`  Exported to: ${exportPath}`);
+            sections.push(`\nRegistry manifest entry:`);
+            sections.push(JSON.stringify({
+                name: safeName,
+                description: wf.description ?? "",
+                version,
+                url: "<upload-url>",
+                author: author ?? "unknown",
+                tags: tags ?? [],
+                sha256,
+                steps: stepCount,
+            }, null, 2));
+            return { content: [{ type: "text", text: sections.join("\n") }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=workflow-market.js.map

package/build/tools/workflow-market.js.map

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

package/build/tools/workflow.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Workflow Orchestration Engine — Declarative multi-step tool sequences.
+ *
+ * Executes JSON-defined workflows that chain device operations into
+ * repeatable, parameterized sequences with variable capture, conditional
+ * steps, and loop support. Workflows run entirely server-side through
+ * direct bridge calls.
+ *
+ * Supported step actions: shell, root_shell, install, screenshot,
+ * logcat, getprop, sleep. Each action maps directly to ADB bridge
+ * operations — no MCP tool re-invocation overhead.
+ *
+ * Workflow files are stored in {tempDir}/workflows/.
+ *
+ * Example workflow JSON:
+ * {
+ *   "name": "restart-and-verify",
+ *   "description": "Restart an app and verify it launched correctly",
+ *   "variables": { "pkg": "com.example.app" },
+ *   "steps": [
+ *     { "name": "stop", "action": "shell", "command": "am force-stop {{pkg}}" },
+ *     { "name": "pause", "action": "sleep", "ms": 1000 },
+ *     { "name": "start", "action": "shell", "command": "monkey -p {{pkg}} -c android.intent.category.LAUNCHER 1" },
+ *     { "name": "wait", "action": "sleep", "ms": 2000 },
+ *     { "name": "check", "action": "shell", "command": "dumpsys activity activities | grep mResumedActivity", "capture": "activity" },
+ *     { "name": "screenshot", "action": "screenshot" }
+ *   ]
+ * }
+ */
+import { ToolContext } from "../tool-context.js";
+export declare function registerWorkflowTools(ctx: ToolContext): void;
+//# sourceMappingURL=workflow.d.ts.map

package/build/tools/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/tools/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAKH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA0HjD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAsR5D"}