humanlypossible 0.1.1 → 0.2.0

package/README.md

@@ -0,0 +1,40 @@
+# humanlypossible
+
+**The outcome protocol for delegating real-world tasks from AI agents to verified humans.**
+
+> **Work in Progress** — This project is in active early development and is not ready for production use. APIs, schemas, and infrastructure will change. Not accepting external contributions yet.
+
+HumanlyPossible is a platform where AI agents can request physical, real-world tasks to be completed by humans — with explicit evidence requirements, verification levels, and resolution rules.
+
+## How it works
+
+1. An AI agent submits an **outcome request** — what needs to happen, by when, with what proof
+2. The platform matches the request to a qualified **human executor**
+3. The executor completes the task and submits evidence
+4. The outcome is verified and resolved according to the protocol rules
+
+## Architecture
+
+- **Web app** — Next.js dashboard for requesters and executors
+- **REST API** — `POST /api/v0/outcomes` and friends
+- **MCP server** — Native integration for Claude and other agent frameworks
+- **CLI** — Setup and management for human executors
+
+## Status
+
+This is an early-stage project. Core infrastructure is in place but under rapid iteration:
+
+- [ ] Outcome protocol v0 — defined and partially implemented
+- [ ] Stripe Connect integration — in progress
+- [ ] MCP server — functional but evolving
+- [ ] Geographic matching — PostGIS queries working
+- [ ] Public documentation
+- [ ] Production deployment
+
+## Related
+
+- [possiblyhuman](https://github.com/simon-marcus/possiblyhuman) — Humanity detection SDK (the reverse Turing test)
+
+## License
+
+MIT

package/dist/cli.js

@@ -175,6 +175,40 @@ async function listAvailableOutcomes(apiKey, options) {
   const path = queryString ? `/v0/outcomes/available?${queryString}` : "/v0/outcomes/available";
   return apiRequest("GET", path, apiKey);
 }
+async function signup(email, password, options) {
+  const url = `${getApiUrl()}/v0/auth/signup`;
+  debugLog(`API POST ${url}`);
+  try {
+    const response = await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        email,
+        password,
+        ...options
+      })
+    });
+    if (!response.ok) {
+      let errorMessage = `HTTP ${response.status}`;
+      try {
+        const errorData = await response.json();
+        if (errorData.error) errorMessage = errorData.error;
+        debugError("Signup error response", errorData);
+      } catch {
+      }
+      return { ok: false, error: errorMessage, status: response.status };
+    }
+    const data = await response.json();
+    debugLog("Signup response", data);
+    return { ok: true, data, status: response.status };
+  } catch (err) {
+    debugError("Signup request failed", err);
+    return {
+      ok: false,
+      error: err instanceof Error ? err.message : "Connection failed"
+    };
+  }
+}
 
 // src/detect-env.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";
@@ -182,7 +216,7 @@ import { homedir } from "os";
 import { join } from "path";
 var MCP_SERVER_CONFIG = {
   command: "npx",
-  args: ["-y", "@humanlypossible/mcp-server"]
+  args: ["-y", "humanlypossible", "mcp"]
 };
 function detectAgentEnvironment() {
   const detected = [];
@@ -381,7 +415,12 @@ async function resolveApiKey(providedKey) {
         value: "existing"
       },
       {
-        title: "Sign up / Log in",
+        title: "Create account (email + password)",
+        description: "Sign up or log in and get an API key instantly",
+        value: "signup"
+      },
+      {
+        title: "Sign up / Log in via browser",
         description: "Opens humanlypossible.ai in your browser",
         value: "browser"
       }
@@ -396,6 +435,32 @@ async function resolveApiKey(providedKey) {
     });
     return key;
   }
+  if (method === "signup") {
+    const { email } = await prompts({
+      type: "text",
+      name: "email",
+      message: "Email address:",
+      validate: (v) => v.includes("@") ? true : "Please enter a valid email"
+    });
+    if (!email) return void 0;
+    const { password } = await prompts({
+      type: "password",
+      name: "password",
+      message: "Password (min 8 characters):",
+      validate: (v) => v.length >= 8 ? true : "Password must be at least 8 characters"
+    });
+    if (!password) return void 0;
+    const spinner = createSpinner("Creating account...");
+    const result = await signup(email, password, { actor_kind: "ai" });
+    if (result.ok && result.data) {
+      const label = result.data.is_new_account ? "Account created" : "Logged in";
+      spinner.succeed(`${label} - API key generated`);
+      return result.data.api_key;
+    } else {
+      spinner.fail(result.error || "Signup failed");
+      return void 0;
+    }
+  }
   if (method === "browser") {
     console.log(chalk2.dim("\n  Opening humanlypossible.ai in your browser..."));
     await open("https://humanlypossible.ai/dashboard");
@@ -643,6 +708,19 @@ async function requestCommand(options) {
     outcome,
     resolve_by: deadline
   };
+  if (options.adapter) {
+    request.adapter_hint = options.adapter;
+  }
+  if (options.params) {
+    try {
+      request.params = JSON.parse(options.params);
+    } catch {
+      console.log(chalk5.red(`
+  Invalid JSON for --params: ${options.params}
+`));
+      process.exit(1);
+    }
+  }
   console.log("");
   console.log(chalk5.cyan("  Creating outcome request..."));
   const createResult = await createOutcomeRequest(config2.apiKey, request);
@@ -1024,6 +1102,9 @@ program.name("humanlypossible").description("Connect AI agents to humans in the
 program.command("init").description("Set up HumanlyPossible in your project").option("--api-key <key>", "Provide API key directly (skips interactive prompt)").option("--no-mcp", "Skip MCP server configuration").action(initCommand);
 program.command("status").description("Check your HumanlyPossible connection and configuration").option("--id <outcomeId>", "Show status of a specific outcome").option("--json", "Output as JSON").action(statusCommand);
 program.command("config").description("View or update your configuration").option("--api-key <key>", "Update your API key").option("--reset", "Reset all configuration").action(configCommand);
-program.command("request").description("Create an outcome request and poll for result").option("-o, --outcome <description>", "Outcome description").option("-d, --deadline <datetime>", "Deadline (ISO 8601 or relative like '1h', '30m')").option("--json", "Output result as JSON").option("--no-poll", "Create request but do not poll for result").action(requestCommand);
+program.command("request").description("Create an outcome request and poll for result").option("-o, --outcome <description>", "Outcome description").option("-d, --deadline <datetime>", "Deadline (ISO 8601 or relative like '1h', '30m')").option("-a, --adapter <hint>", "Adapter hint (e.g. 'delivery', 'sms', 'voice')").option("-p, --params <json>", "Structured params as JSON").option("--json", "Output result as JSON").option("--no-poll", "Create request but do not poll for result").action(requestCommand);
 program.command("serve").description("Run as an executor: poll for outcomes and fulfill them").option("-c, --config <path>", "Path to executor config file").option("-i, --interval <seconds>", "Polling interval in seconds", "10").action(serveCommand);
+program.command("mcp").description("Start the HumanlyPossible MCP server (stdio transport)").action(async () => {
+  await import("./mcp-7IK2TXZV.js");
+});
 program.parse();