aiblueprint-cli 1.4.103 → 1.4.105

package/agents-config/skills/use-artifacts/assets/local-runtime.js

@@ -1,299 +0,0 @@
-/*
- * local-runtime.js: local artifact capabilities shim. No Anthropic API,
- * no claude.ai runtime, no network calls. Everything runs on plain
- * browser APIs (Blob, <a download>, timers, in-memory cache).
- *
- * It mirrors the claude.ai artifact runtime surface (contract 0.1.14):
- *   - window.claude.downloads.save({filename, data})
- *   - window.claude.mcp.callTool / watchTool / listTools / invalidate
- *
- * If a real claude.ai runtime already installed a member, the shim
- * leaves it untouched, so the same feature code is portable to a
- * genuinely published artifact without changes.
- *
- * Local data sources replace viewer connectors. Register them BEFORE
- * feature code runs:
- *
- *   window.claudeLocal.registerTool("Analytics", "get_stats",
- *     async (input) => ({ visits: 1234 }));            // live local source
- *   window.claudeLocal.registerTool("Analytics", "snapshot",
- *     { visits: 1234 }, { description: "Static snapshot 2026-07-22" });
- *
- * Then use the standard surface:
- *   const r = await window.claude.mcp.callTool("Analytics", "get_stats", { range: "7d" });
- *   render(r.payload);
- */
-(function () {
-  "use strict";
-  if (typeof window === "undefined") return;
-
-  var root = window.claude;
-  if (!root || typeof root !== "object") {
-    root = {};
-    try { window.claude = root; } catch (e) { return; }
-  }
-
-  /* ------------------------------ downloads ------------------------------ */
-
-  var EXT_ALLOWLIST = ["gif", "png", "jpg", "jpeg", "webp", "mp4", "webm", "txt", "json", "md"];
-  var MIME_BY_EXT = {
-    gif: "image/gif", png: "image/png", jpg: "image/jpeg", jpeg: "image/jpeg",
-    webp: "image/webp", mp4: "video/mp4", webm: "video/webm",
-    txt: "text/plain", json: "application/json", md: "text/markdown"
-  };
-  var MAX_BYTES = 16 * 1024 * 1024;
-  var promptOpen = false;
-
-  function downloadsError(code, message) {
-    return { code: code, message: message };
-  }
-
-  function toBlob(data, mime) {
-    if (typeof data === "string" && data.length) return new Blob([data], { type: mime });
-    if (data instanceof Blob && data.size) return new Blob([data], { type: mime });
-    if (data instanceof ArrayBuffer && data.byteLength) return new Blob([data], { type: mime });
-    if (ArrayBuffer.isView(data) && data.byteLength) return new Blob([data], { type: mime });
-    return null;
-  }
-
-  if (!root.downloads) {
-    root.downloads = {
-      save: function (request) {
-        return new Promise(function (resolve, reject) {
-          if (promptOpen) {
-            return reject(downloadsError("rate_limited", "A save prompt is already open."));
-          }
-          if (!request || typeof request !== "object") {
-            return reject(downloadsError("bad_request", "save() takes {filename, data}."));
-          }
-          var filename = request.filename;
-          if (typeof filename !== "string" || !filename || filename.length > 512) {
-            return reject(downloadsError("bad_request", "filename must be a non-empty string of at most 512 chars."));
-          }
-          var clean = filename.replace(/[\/\\:*?"<>|]+/g, "-").trim();
-          var dot = clean.lastIndexOf(".");
-          var ext = (dot > 0 ? clean.slice(dot + 1) : "").toLowerCase();
-          if (EXT_ALLOWLIST.indexOf(ext) === -1) {
-            return reject(downloadsError("rejected_extension",
-              "Extension \"." + ext + "\" is outside the allowlist: " + EXT_ALLOWLIST.join(" ")));
-          }
-          var blob = toBlob(request.data, MIME_BY_EXT[ext]);
-          if (!blob) {
-            return reject(downloadsError("bad_request",
-              "data must be a non-empty string, Blob, ArrayBuffer, or ArrayBufferView."));
-          }
-          if (blob.size > MAX_BYTES) {
-            return reject(downloadsError("too_large", "File is over 16 MiB (" + blob.size + " bytes)."));
-          }
-          promptOpen = true;
-          var accepted;
-          try {
-            accepted = window.confirm('Save "' + clean + '" (' + blob.size + " bytes)?");
-          } finally {
-            promptOpen = false;
-          }
-          if (!accepted) {
-            return reject(downloadsError("declined", "The viewer declined the save."));
-          }
-          var url = URL.createObjectURL(blob);
-          var a = document.createElement("a");
-          a.href = url;
-          a.download = clean;
-          document.body.appendChild(a);
-          a.click();
-          a.remove();
-          setTimeout(function () { URL.revokeObjectURL(url); }, 10000);
-          resolve({ status: "saved" });
-        });
-      }
-    };
-  }
-
-  /* --------------------------------- mcp --------------------------------- */
-
-  var SEP = "\u0000";
-  var registry = {};  // "server\0tool" -> {source, isStatic, description}
-  var cache = {};     // identity -> {result, storedAt}
-  var watchers = {};  // identity -> [{handler, timer, refresh}]
-
-  function key(server, tool) { return server + SEP + tool; }
-
-  function canonical(value) {
-    if (value === undefined || value === null) return "null";
-    if (Array.isArray(value)) return "[" + value.map(canonical).join(",") + "]";
-    if (typeof value === "object") {
-      return "{" + Object.keys(value).sort().map(function (k) {
-        return JSON.stringify(k) + ":" + canonical(value[k]);
-      }).join(",") + "}";
-    }
-    return JSON.stringify(value);
-  }
-
-  function identity(server, tool, input) {
-    return key(server, tool) + SEP + canonical(input);
-  }
-
-  function mcpError(code, server, message, extra) {
-    var err = { code: code, message: message };
-    if (server !== undefined) err.server = server;
-    if (extra) Object.keys(extra).forEach(function (k) { err[k] = extra[k]; });
-    return err;
-  }
-
-  function envelope(payload) {
-    var text = typeof payload === "string" ? payload : JSON.stringify(payload);
-    var result = { content: [{ type: "text", text: text }], payload: payload };
-    if (payload !== null && typeof payload === "object") result.structuredContent = payload;
-    return result;
-  }
-
-  function cachedCopy(entry, revalidating) {
-    var copy = {};
-    Object.keys(entry.result).forEach(function (k) { copy[k] = entry.result[k]; });
-    copy.cache = { storedAt: entry.storedAt, revalidating: !!revalidating };
-    return copy;
-  }
-
-  function notifyData(id, result) {
-    (watchers[id] || []).forEach(function (w) {
-      try { w.handler({ type: "data", result: result }); } catch (e) { /* page bug */ }
-    });
-  }
-
-  function execute(server, tool, input) {
-    var entry = registry[key(server, tool)];
-    if (!entry) {
-      return Promise.reject(mcpError("server_not_connected", server,
-        'No local source registered for "' + server + '" / "' + tool +
-        '". Call window.claudeLocal.registerTool(...) before feature code runs.'));
-    }
-    try { JSON.stringify(input === undefined ? null : input); } catch (e) {
-      return Promise.reject(mcpError("bad_request", server, "input must be plain JSON."));
-    }
-    return Promise.resolve()
-      .then(function () {
-        return entry.isStatic ? entry.source : entry.source(input === undefined ? null : input);
-      })
-      .then(function (payload) {
-        var result = envelope(payload);
-        cache[identity(server, tool, input)] = { result: result, storedAt: Date.now() };
-        return result;
-      })
-      .catch(function (e) {
-        if (e && e.code) throw e;
-        throw mcpError("tool_error", server, (e && e.message) || String(e), { result: e });
-      });
-  }
-
-  if (!root.mcp) {
-    root.mcp = {
-      callTool: function (server, tool, input, options) {
-        if (typeof server !== "string" || typeof tool !== "string") {
-          return Promise.reject(mcpError("bad_request", undefined, "server and tool must be strings."));
-        }
-        var opts = options || {};
-        var id = identity(server, tool, input);
-        var entry = cache[id];
-        var staleTime = 0;
-        var refresh = false;
-        if (opts.cache && typeof opts.cache === "object") {
-          staleTime = Math.min(opts.cache.staleTime || 0, 300000);
-          refresh = !!opts.cache.refresh;
-        }
-        if (opts.cache === false) entry = null;
-        if (refresh) entry = null;
-        if (entry && Date.now() - entry.storedAt < staleTime) {
-          return Promise.resolve(cachedCopy(entry, false));
-        }
-        return execute(server, tool, input).then(function (result) {
-          notifyData(id, result);
-          return result;
-        });
-      },
-
-      watchTool: function (server, tool, input, handler, options) {
-        if (typeof handler !== "function") {
-          throw new TypeError("watchTool handler must be a function.");
-        }
-        var opts = options || {};
-        var id = identity(server, tool, input);
-        var w = { handler: handler, timer: null, refresh: null };
-        (watchers[id] = watchers[id] || []).push(w);
-
-        w.refresh = function () {
-          execute(server, tool, input)
-            .then(function (result) { notifyData(id, result); })
-            .catch(function (err) {
-              try { w.handler({ type: "error", error: err }); } catch (e) { /* page bug */ }
-            });
-        };
-
-        Promise.resolve().then(function () {
-          var entry = cache[id];
-          if (entry) {
-            try { w.handler({ type: "data", result: cachedCopy(entry, false) }); } catch (e) { /* page bug */ }
-          } else {
-            w.refresh();
-          }
-        });
-
-        if (opts.refetchInterval) {
-          w.timer = setInterval(w.refresh, Math.max(5000, opts.refetchInterval));
-        }
-
-        var done = false;
-        return function unsubscribe() {
-          if (done) return;
-          done = true;
-          if (w.timer) clearInterval(w.timer);
-          watchers[id] = (watchers[id] || []).filter(function (x) { return x !== w; });
-        };
-      },
-
-      invalidate: function (server, tool, input) {
-        Object.keys(cache).forEach(function (id) {
-          var match = true;
-          if (server !== undefined) match = id.indexOf(server + SEP) === 0;
-          if (match && tool !== undefined) match = id.indexOf(key(server, tool) + SEP) === 0;
-          if (match && input !== undefined) match = id === identity(server, tool, input);
-          if (match) {
-            delete cache[id];
-            var subs = watchers[id] || [];
-            if (subs.length) subs[0].refresh();
-          }
-        });
-        return Promise.resolve();
-      },
-
-      listTools: function () {
-        var byServer = {};
-        Object.keys(registry).forEach(function (k) {
-          var parts = k.split(SEP);
-          (byServer[parts[0]] = byServer[parts[0]] || []).push({
-            name: parts[1],
-            description: registry[k].description || ""
-          });
-        });
-        return Promise.resolve({
-          servers: Object.keys(byServer).map(function (s) {
-            return { server: s, authStatus: "connected", tools: byServer[s] };
-          })
-        });
-      }
-    };
-  }
-
-  /* --------------------------- local registration ------------------------ */
-
-  window.claudeLocal = window.claudeLocal || {};
-  window.claudeLocal.registerTool = function (server, tool, source, opts) {
-    if (typeof server !== "string" || typeof tool !== "string") {
-      throw new TypeError("registerTool(server, tool, source): server and tool must be strings.");
-    }
-    registry[key(server, tool)] = {
-      source: source,
-      isStatic: typeof source !== "function",
-      description: (opts && opts.description) || ""
-    };
-  };
-})();

package/agents-config/skills/use-artifacts/scripts/create_artifact.py

@@ -1,317 +0,0 @@
-#!/usr/bin/env python3
-"""Scaffold a Claude-style local HTML artifact workspace."""
-
-from __future__ import annotations
-
-import argparse
-import json
-import re
-from datetime import datetime, timezone
-from pathlib import Path
-
-GLOBAL_ARTIFACTS_DIR = Path.home() / ".agents" / "artifacts"
-
-
-def slugify(value: str) -> str:
-    slug = re.sub(r"[^a-z0-9]+", "-", value.lower()).strip("-")
-    return slug[:48].strip("-") or "artifact"
-
-
-def unique_dir(base: Path, slug: str) -> Path:
-    candidate = base / slug
-    if not candidate.exists():
-        return candidate
-
-    stamp = datetime.now(timezone.utc).strftime("%Y%m%d-%H%M%S")
-    return base / f"{slug}-{stamp}"
-
-
-def html_template(title: str, style: str, kind: str) -> str:
-    escaped_title = (
-        title.replace("&", "&")
-        .replace("<", "&lt;")
-        .replace(">", "&gt;")
-        .replace('"', "&quot;")
-    )
-    return f"""<!doctype html>
-<html lang="en">
-<head>
-  <meta charset="utf-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>{escaped_title}</title>
-  <style>
-    :root {{
-      color-scheme: dark;
-      --bg: #000000;
-      --panel: #111111;
-      --ink: #ffffff;
-      --muted: #888888;
-      --border: #333333;
-      --accent: #0070f3;
-    }}
-    * {{ box-sizing: border-box; }}
-    body {{
-      margin: 0;
-      min-height: 100vh;
-      background: var(--bg);
-      color: var(--ink);
-      font-family: Geist, Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
-    }}
-    main {{
-      width: min(1120px, calc(100vw - 32px));
-      margin: 0 auto;
-      padding: 48px 0;
-    }}
-    .shell {{
-      display: grid;
-      gap: 24px;
-    }}
-    .header {{
-      display: flex;
-      flex-wrap: wrap;
-      align-items: end;
-      justify-content: space-between;
-      gap: 16px;
-      border-bottom: 1px solid var(--border);
-      padding-bottom: 20px;
-    }}
-    .eyebrow {{
-      margin: 0 0 8px;
-      color: var(--accent);
-      font-size: 12px;
-      font-weight: 700;
-      letter-spacing: .08em;
-      text-transform: uppercase;
-    }}
-    h1 {{
-      margin: 0;
-      max-width: 760px;
-      font-size: clamp(40px, 7vw, 88px);
-      line-height: .95;
-      letter-spacing: -.03em;
-    }}
-    .meta {{
-      color: var(--muted);
-      font-size: 14px;
-      line-height: 1.5;
-    }}
-    .panel {{
-      min-height: 420px;
-      border: 1px solid var(--border);
-      border-radius: 8px;
-      background: var(--panel);
-      padding: 28px;
-    }}
-    .panel h2 {{
-      margin: 0 0 12px;
-      font-size: 24px;
-      letter-spacing: 0;
-    }}
-    .panel p {{
-      max-width: 680px;
-      color: var(--muted);
-      font-size: 17px;
-      line-height: 1.65;
-    }}
-    button {{
-      border: 0;
-      border-radius: 6px;
-      background: var(--ink);
-      color: var(--bg);
-      cursor: pointer;
-      font: inherit;
-      font-weight: 650;
-      padding: 10px 16px;
-    }}
-    .callout {{
-      border: 1px solid var(--border);
-      border-radius: 0;
-      background: var(--panel);
-      padding: 20px;
-    }}
-    .callout h2 {{ color: var(--ink); }}
-    .grid {{
-      display: grid;
-      gap: 16px;
-      grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
-    }}
-    .croquis {{
-      min-height: 180px;
-      border: 1px solid var(--border);
-      border-radius: 0;
-      background: var(--bg);
-      padding: 14px;
-    }}
-    .bar {{
-      height: 14px;
-      border-radius: 0;
-      background: #666666;
-      margin-bottom: 10px;
-    }}
-    .box {{
-      height: 52px;
-      border: 1px solid var(--border);
-      border-radius: 0;
-      background: var(--panel);
-      margin-bottom: 10px;
-    }}
-    .note {{
-      color: var(--muted);
-      font-size: 14px;
-      line-height: 1.45;
-    }}
-    pre {{
-      overflow-x: auto;
-      border: 1px solid var(--border);
-      border-radius: 0;
-      background: var(--bg);
-      padding: 16px;
-    }}
-    code {{
-      border-radius: 0;
-      background: var(--panel);
-      padding: 2px 5px;
-      font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
-      font-size: .92em;
-    }}
-  </style>
-</head>
-<body>
-  <main>
-    <section class="shell" aria-label="{escaped_title}">
-      <div class="header">
-        <div>
-          <p class="eyebrow">{kind} artifact</p>
-          <h1>{escaped_title}</h1>
-        </div>
-        <p class="meta">Style: {style}<br>Entrypoint: index.html</p>
-      </div>
-      <div class="callout">
-        <h2>Key finding or recommendation</h2>
-        <p>
-          Put the highest-signal conclusion near the top. Use this area for the
-          main security finding, product decision, implementation warning, or
-          core recommendation that frames the rest of the artifact.
-        </p>
-      </div>
-      <div class="panel">
-        <h2>Public reasoning surface</h2>
-        <p>
-          Turn the answer into a readable page: context, model, tradeoffs,
-          examples, edge cases, rollout steps, and verification notes. Show
-          conclusions and evidence, not private chain-of-thought.
-        </p>
-        <pre><code>// Add focused snippets when they clarify the plan.
-function example() {{
-  return "replace this with the requested artifact content";
-}}</code></pre>
-      </div>
-      <div class="panel">
-        <h2>Page draft</h2>
-        <p>
-          For plan artifacts, draft the actual page or content structure here:
-          title, lede, sections, key copy, calls to action, states, and the
-          narrative blocks the user should see.
-        </p>
-      </div>
-      <div class="grid">
-        <article class="panel">
-          <h2>Page croquis A</h2>
-          <div class="croquis">
-            <div class="bar" style="width: 72%;"></div>
-            <div class="box"></div>
-            <div class="box" style="width: 64%;"></div>
-          </div>
-          <p class="note">Sketch the page hierarchy quickly. This is for seeing and understanding, not final UI.</p>
-        </article>
-        <article class="panel">
-          <h2>Page croquis B</h2>
-          <div class="croquis">
-            <div class="box" style="height: 84px;"></div>
-            <div class="bar" style="width: 46%;"></div>
-            <div class="bar" style="width: 78%; opacity: .35;"></div>
-          </div>
-          <p class="note">Annotate what changes: layout, emphasis, rhythm, audience, or tradeoff.</p>
-        </article>
-      </div>
-    </section>
-  </main>
-</body>
-</html>
-"""
-
-
-def highlogic_template(title: str, style: str, kind: str, created_at: str) -> str:
-    return f"""# {title}
-
-## Intent
-
-- Kind: {kind}
-- Style: {style}
-- Created: {created_at}
-
-## User Request
-
-TODO: Summarize the user's artifact request.
-
-## Core Logic
-
-TODO: Describe the public reasoning structure, sections, data model, interactions, and key design decisions. Capture conclusions, evidence, assumptions, and tradeoffs without private chain-of-thought.
-
-## Verification
-
-TODO: Record how the artifact was opened or tested, including browser/runtime checks when relevant.
-
-## Iteration Notes
-
-- Initial scaffold created.
-"""
-
-
-def main() -> int:
-    parser = argparse.ArgumentParser(description="Create a local HTML artifact workspace.")
-    parser.add_argument("title", help="Short artifact title or slug")
-    parser.add_argument("--style", default="custom", help="style label recorded in the manifest (requested, project:<app-name>, or subject-specific)")
-    parser.add_argument("--kind", default="thinking", help="artifact kind")
-    args = parser.parse_args()
-
-    base = GLOBAL_ARTIFACTS_DIR.resolve()
-    artifact_id = slugify(args.title)
-    artifact_dir = unique_dir(base, artifact_id)
-    created_at = datetime.now(timezone.utc).isoformat()
-
-    artifact_dir.mkdir(parents=True, exist_ok=False)
-    (artifact_dir / "versions").mkdir()
-
-    title = args.title.strip()
-    (artifact_dir / "index.html").write_text(
-        html_template(title, args.style, args.kind),
-        encoding="utf-8",
-    )
-    (artifact_dir / "HIGHLOGIC.md").write_text(
-        highlogic_template(title, args.style, args.kind, created_at),
-        encoding="utf-8",
-    )
-    manifest = {
-        "id": artifact_dir.name,
-        "title": title,
-        "kind": args.kind,
-        "style": args.style,
-        "created_at": created_at,
-        "entrypoint": "index.html",
-        "files": ["index.html", "HIGHLOGIC.md", "manifest.json"],
-    }
-    (artifact_dir / "manifest.json").write_text(
-        json.dumps(manifest, indent=2) + "\n",
-        encoding="utf-8",
-    )
-
-    index_path = artifact_dir / "index.html"
-    print(f"created={artifact_dir}")
-    print(f"index={index_path}")
-    print(f"url={index_path.as_uri()}")
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())