@intent-systems/nexus 2026.1.5-3

package/skills/google-oauth/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: google-oauth
+description: OAuth client and consent configuration for Google Workspace APIs (Gmail, Calendar, Drive, etc.).
+homepage: https://console.cloud.google.com/apis/credentials
+metadata: {"nexus":{"type":"connector","provides":["oauth-management","google-apis"],"requires":{"bins":["gog"],"credentials":["google-oauth"]}}}
+---
+
+# Google OAuth Connector
+
+This connector manages the OAuth client and consent setup used by tools like `gog` (and other Google API tools).
+
+## What it enables
+
+- OAuth client creation for Google Workspace APIs.
+- OAuth consent flow for user accounts.
+- Token storage in keychain (with optional export to 1Password).
+
+## Prerequisites
+
+- Google Cloud account and project.
+- `gog` CLI installed (used to store `credentials.json` and tokens).
+- One or more Google accounts to authorize.
+
+## Setup (manual)
+
+### 1) Create OAuth client
+
+1. Go to https://console.cloud.google.com
+2. Create or select a project.
+3. Enable these APIs:
+   - Gmail API
+   - Google Calendar API
+   - Google Drive API
+   - Google People API
+   - Google Sheets API
+   - Google Tasks API
+4. Go to APIs & Services -> Credentials.
+5. Create credentials -> OAuth client ID -> Desktop app.
+6. Download the JSON file.
+7. Store it with gog:
+
+```bash
+gog auth credentials ~/Downloads/client_secret_xxx.json
+```
+
+### 2) Add test users (required for Testing mode)
+
+If your OAuth consent screen is in Testing:
+
+1. Go to https://console.cloud.google.com/auth/audience
+2. Under Test users, add each email address.
+3. Save and wait 1-2 minutes for propagation.
+
+### 3) Authorize accounts
+
+```bash
+gog auth add you@gmail.com --services gmail,calendar,drive,contacts,sheets,people,tasks
+```
+
+## Automation (CDP)
+
+If you prefer automation, use the CDP scripts:
+
+```
+skills/gog/scripts/cdp/
+```
+
+See `skills/gog/scripts/cdp/README.md` for setup and usage.
+
+## Verification
+
+```bash
+gog auth list
+gog gmail labels list --account you@gmail.com
+```
+
+## Troubleshooting
+
+### access_denied
+
+Add the account to Test users (see setup step 2).
+
+### APIs not enabled
+
+Enable Gmail, Calendar, Drive, People, Sheets, and Tasks APIs for the project.
+
+### Workspace admin approval
+
+Google Workspace admins may need to approve the app. If blocked, use a personal Gmail account.
+
+## Notes
+
+- `credentials.json` is not a secret (client config).
+- Refresh tokens are secrets; export to 1Password if you need portability.

package/skills/goplaces/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: goplaces
+description: Query Google Places API (New) via the goplaces CLI for text search, place details, resolve, and reviews. Use for human-friendly place lookup or JSON output for scripts.
+homepage: https://github.com/steipete/goplaces
+metadata: {"nexus":{"emoji":"📍","requires":{"bins":["goplaces"],"env":["GOOGLE_PLACES_API_KEY"]},"primaryEnv":"GOOGLE_PLACES_API_KEY","install":[{"id":"brew","kind":"brew","formula":"steipete/tap/goplaces","bins":["goplaces"],"label":"Install goplaces (brew)"}]}}
+---
+
+# goplaces
+
+Modern Google Places API (New) CLI. Human output by default, `--json` for scripts.
+
+Install
+- Homebrew: `brew install steipete/tap/goplaces`
+
+Config
+- `GOOGLE_PLACES_API_KEY` required.
+- Optional: `GOOGLE_PLACES_BASE_URL` for testing/proxying.
+
+Common commands
+- Search: `goplaces search "coffee" --open-now --min-rating 4 --limit 5`
+- Bias: `goplaces search "pizza" --lat 40.8 --lng -73.9 --radius-m 3000`
+- Pagination: `goplaces search "pizza" --page-token "NEXT_PAGE_TOKEN"`
+- Resolve: `goplaces resolve "Soho, London" --limit 5`
+- Details: `goplaces details <place_id> --reviews`
+- JSON: `goplaces search "sushi" --json`
+
+Notes
+- `--no-color` or `NO_COLOR` disables ANSI color.
+- Price levels: 0..4 (free → very expensive).
+- Type filter sends only the first `--type` value (API accepts one).

package/skills/imsg/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: imsg
+description: iMessage/SMS CLI for listing chats, history, watch, and sending.
+homepage: https://imsg.to
+metadata: {"nexus":{"emoji":"📨","type":"tool","provides":["messaging-read","messaging-send"],"os":["darwin"],"requires":{"bins":["imsg"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/imsg","bins":["imsg"],"label":"Install imsg (brew)"}]}}
+---
+
+# imsg
+
+Use `imsg` to read and send Messages.app iMessage/SMS on macOS.
+
+Requirements
+- Messages.app signed in
+- Full Disk Access for your terminal
+- Automation permission to control Messages.app (for sending)
+
+Common commands
+- List chats: `imsg chats --limit 10 --json`
+- History: `imsg history --chat-id 1 --limit 20 --attachments --json`
+- Watch: `imsg watch --chat-id 1 --attachments`
+- Send: `imsg send --to "+14155551212" --text "hi" --file /path/pic.jpg`
+
+Notes
+- `--service imessage|sms|auto` controls delivery.
+- Confirm recipient + message before sending.

package/skills/json-render/SKILL.md

@@ -0,0 +1,154 @@
+---
+name: json-render
+description: Render React UIs from JSON using Vercel json-render with an asset-backed component catalog. Use when the user asks about json-render, prompt-driven UI generation, streaming UI patches, or component registries.
+homepage: https://json-render.dev
+type: guide
+capabilities: [ui-render, json-render, component-catalog]
+license: MIT
+source:
+  repo: https://github.com/vercel-labs/json-render
+security:
+  openSource: true
+  audit: required
+metadata: {"nexus":{}}
+---
+
+# JSON Render UI
+
+Use `json-render` to stream UI trees from prompts while constraining output to a
+known component catalog. The canonical component set for this skill lives in
+`assets/components/`.
+
+## Quick start (Next.js/React)
+
+1. Install packages:
+   - `npm install @json-render/core @json-render/react zod ai`
+
+2. Copy the canonical catalog + registry:
+   - `assets/components/catalog.ts` -> `lib/json-render/catalog.ts`
+   - `assets/components/registry.tsx` -> `components/json-render/registry.tsx`
+
+3. Server route (streaming):
+
+```ts
+import { streamText } from "ai";
+import { generateCatalogPrompt } from "@json-render/core";
+import { catalog } from "@/lib/json-render/catalog";
+
+export async function POST(req: Request) {
+  const { prompt } = await req.json();
+  const system = generateCatalogPrompt(catalog);
+
+  const result = streamText({
+    model: "anthropic/claude-opus-4.5",
+    system,
+    prompt,
+  });
+
+  return new Response(result.textStream, {
+    headers: { "Content-Type": "text/plain; charset=utf-8" },
+  });
+}
+```
+
+4. Client renderer:
+
+```tsx
+"use client";
+
+import {
+  ActionProvider,
+  DataProvider,
+  Renderer,
+  useUIStream,
+} from "@json-render/react";
+import { registry } from "@/components/json-render/registry";
+
+export default function Page() {
+  const { tree, isLoading, generate } = useUIStream({
+    endpoint: "/api/generate",
+  });
+
+  return (
+    <DataProvider initialData={{}}>
+      <ActionProvider handlers={{}}>
+        <form
+          onSubmit={(e) => {
+            e.preventDefault();
+            const formData = new FormData(e.currentTarget);
+            generate(formData.get("prompt") as string);
+          }}
+        >
+          <input name="prompt" placeholder="Describe a UI..." />
+          <button type="submit" disabled={isLoading}>
+            Generate
+          </button>
+        </form>
+        <div className="mt-6">
+          <Renderer tree={tree} registry={registry} />
+        </div>
+      </ActionProvider>
+    </DataProvider>
+  );
+}
+```
+
+## Component catalog workflow
+
+- The canonical component definitions for this skill live in `assets/components/`.
+- When you need a new component or prop:
+  1. Update `assets/components/catalog.ts` (Zod schema + `hasChildren`).
+  2. Update `assets/components/registry.tsx` (React implementation).
+  3. Copy the updated files into the target project.
+- Keep component names and prop keys identical between catalog and registry.
+
+## Optional: LLM streaming mode
+
+You can wire a streaming endpoint that requires an API key:
+
+1. Run the local LLM server: `scripts/llm-server/README.md`
+2. Start the demo with `VITE_LLM_ENDPOINT` set
+3. Toggle **LLM streaming** in the UI and click **Generate with LLM**
+
+## Guardrails
+
+- Never invent components that are not in the catalog.
+- Only emit actions that are declared in the catalog.
+- Prefer small composable components (Section, Stack, Text, Button) over one-offs.
+- Use KeyValueList or DataTable for arbitrary data displays.
+- Keep trees shallow; use children lists instead of deep wrapper chains.
+
+## Example UI tree
+
+```json
+{
+  "root": "root",
+  "elements": {
+    "root": {
+      "type": "Section",
+      "props": { "title": "Weekly Summary" },
+      "children": ["summary", "cta"]
+    },
+    "summary": { "type": "Text", "props": { "content": "Revenue up 12%." } },
+    "cta": {
+      "type": "Button",
+      "props": {
+        "label": "View details",
+        "action": "navigate",
+        "actionParams": { "url": "https://example.com" }
+      }
+    }
+  }
+}
+```
+
+## References
+
+- Demo: `docs/nexus-state-demo.md`
+- shadcn preset notes: `docs/shadcn-preset.md`
+- Demo assets: `assets/demo/`
+- Scaffold script: `scripts/create-vite-demo.sh`
+- LLM server: `scripts/llm-server/README.md`
+- Component assets: `assets/components/README.md`, `assets/components/catalog.ts`, `assets/components/registry.tsx`
+- json-render docs: https://json-render.dev/docs
+- json-render repo: https://github.com/vercel-labs/json-render

package/skills/json-render/assets/components/README.md

@@ -0,0 +1,21 @@
+# JSON Render Component Assets
+
+This folder is the canonical component catalog for the `json-render` skill.
+Update these files first, then copy them into the target project.
+
+## Files
+
+- `catalog.ts` defines component props and actions with Zod.
+- `registry.tsx` maps component names to React implementations.
+
+## Workflow
+
+1. Add or update a component in `catalog.ts`.
+2. Implement the same component name in `registry.tsx`.
+3. Copy both files into the project and keep names/props in sync.
+
+## Notes
+
+- Only use components declared in the catalog.
+- Keep prop names stable; breaking changes require updating existing UI trees.
+- Current components: Section, Stack, Grid, Text, Badge, KeyValueList, DataTable, Button.

package/skills/json-render/assets/components/catalog.ts

@@ -0,0 +1,78 @@
+import { createCatalog } from "@json-render/core";
+import { z } from "zod";
+
+export const catalog = createCatalog({
+  components: {
+    Section: {
+      props: z.object({
+        title: z.string().optional(),
+        description: z.string().optional(),
+      }),
+      hasChildren: true,
+    },
+    Stack: {
+      props: z.object({
+        gap: z.number().int().min(0).optional(),
+        align: z.enum(["left", "center", "right"]).optional(),
+      }),
+      hasChildren: true,
+    },
+    Grid: {
+      props: z.object({
+        columns: z.number().int().min(1).max(4).optional(),
+        gap: z.number().int().min(0).optional(),
+      }),
+      hasChildren: true,
+    },
+    Text: {
+      props: z.object({
+        content: z.string(),
+        tone: z.enum(["default", "muted", "danger"]).optional(),
+      }),
+    },
+    Badge: {
+      props: z.object({
+        label: z.string(),
+        tone: z.enum(["default", "info", "success", "warning"]).optional(),
+      }),
+    },
+    KeyValueList: {
+      props: z.object({
+        title: z.string().optional(),
+        items: z.array(
+          z.object({
+            label: z.string(),
+            value: z.string(),
+          }),
+        ),
+      }),
+    },
+    DataTable: {
+      props: z.object({
+        title: z.string().optional(),
+        columns: z.array(z.string()).min(1),
+        rows: z.array(z.array(z.string())).min(1),
+      }),
+    },
+    Button: {
+      props: z.object({
+        label: z.string(),
+        action: z.string(),
+        actionParams: z.record(z.unknown()).optional(),
+        variant: z.enum(["primary", "secondary"]).optional(),
+      }),
+    },
+  },
+  actions: {
+    navigate: {
+      params: z.object({
+        url: z.string().url(),
+      }),
+    },
+    submit: {
+      params: z.object({
+        formId: z.string(),
+      }),
+    },
+  },
+});

package/skills/json-render/assets/components/registry.tsx

@@ -0,0 +1,172 @@
+import React from "react";
+
+type ComponentProps = {
+  element: {
+    props: Record<string, unknown>;
+  };
+  children?: React.ReactNode;
+  onAction?: (action: string, params: Record<string, unknown>) => void;
+};
+
+const toneClasses: Record<string, string> = {
+  default: "text-gray-900",
+  muted: "text-gray-500",
+  danger: "text-red-600",
+};
+
+const badgeClasses: Record<string, string> = {
+  default: "bg-slate-200 text-slate-900",
+  info: "bg-blue-100 text-blue-700",
+  success: "bg-emerald-100 text-emerald-700",
+  warning: "bg-amber-100 text-amber-700",
+};
+
+export const registry = {
+  Section: ({ element, children }: ComponentProps) => (
+    <section className="rounded-lg border border-gray-200 p-4">
+      {element.props.title ? (
+        <h2 className="text-lg font-semibold">
+          {element.props.title as string}
+        </h2>
+      ) : null}
+      {element.props.description ? (
+        <p className="text-sm text-gray-600">
+          {element.props.description as string}
+        </p>
+      ) : null}
+      <div className="mt-3 space-y-3">{children}</div>
+    </section>
+  ),
+  Stack: ({ element, children }: ComponentProps) => {
+    const gap = (element.props.gap as number | undefined) ?? 12;
+    const align = (element.props.align as string | undefined) ?? "left";
+
+    return (
+      <div className="flex flex-col" style={{ gap, textAlign: align as any }}>
+        {children}
+      </div>
+    );
+  },
+  Grid: ({ element, children }: ComponentProps) => {
+    const columns = (element.props.columns as number | undefined) ?? 2;
+    const gap = (element.props.gap as number | undefined) ?? 16;
+
+    return (
+      <div
+        className="grid"
+        style={{
+          gridTemplateColumns: `repeat(${columns}, minmax(0, 1fr))`,
+          gap,
+        }}
+      >
+        {children}
+      </div>
+    );
+  },
+  Text: ({ element }: ComponentProps) => {
+    const tone = (element.props.tone as string | undefined) ?? "default";
+
+    return (
+      <p className={toneClasses[tone] ?? toneClasses.default}>
+        {element.props.content as string}
+      </p>
+    );
+  },
+  Badge: ({ element }: ComponentProps) => {
+    const tone = (element.props.tone as string | undefined) ?? "default";
+    const className = badgeClasses[tone] ?? badgeClasses.default;
+
+    return (
+      <span className={`inline-flex items-center rounded-full px-3 py-1 text-xs font-semibold ${className}`}>
+        {element.props.label as string}
+      </span>
+    );
+  },
+  KeyValueList: ({ element }: ComponentProps) => {
+    const title = element.props.title as string | undefined;
+    const items =
+      (element.props.items as Array<{ label: string; value: string }>) ?? [];
+
+    return (
+      <div className="rounded-md border border-gray-200 bg-white px-4 py-3">
+        {title ? (
+          <p className="text-xs font-semibold uppercase tracking-wide text-gray-500">
+            {title}
+          </p>
+        ) : null}
+        <dl className="mt-2 space-y-2">
+          {items.map((item, index) => (
+            <div className="flex items-center justify-between gap-6" key={index}>
+              <dt className="text-sm text-gray-500">{item.label}</dt>
+              <dd className="text-sm font-semibold text-gray-900">
+                {item.value}
+              </dd>
+            </div>
+          ))}
+        </dl>
+      </div>
+    );
+  },
+  DataTable: ({ element }: ComponentProps) => {
+    const title = element.props.title as string | undefined;
+    const columns = (element.props.columns as string[]) ?? [];
+    const rows = (element.props.rows as string[][]) ?? [];
+
+    return (
+      <div className="overflow-hidden rounded-md border border-gray-200 bg-white">
+        {title ? (
+          <div className="border-b border-gray-200 px-4 py-2 text-sm font-semibold text-gray-700">
+            {title}
+          </div>
+        ) : null}
+        <div className="overflow-x-auto">
+          <table className="min-w-full text-left text-sm text-gray-700">
+            <thead className="bg-gray-50 text-xs uppercase tracking-wide text-gray-500">
+              <tr>
+                {columns.map((column, index) => (
+                  <th className="px-4 py-2" key={index}>
+                    {column}
+                  </th>
+                ))}
+              </tr>
+            </thead>
+            <tbody>
+              {rows.map((row, rowIndex) => (
+                <tr className="border-t border-gray-100" key={rowIndex}>
+                  {row.map((cell, cellIndex) => (
+                    <td className="px-4 py-2" key={cellIndex}>
+                      {cell}
+                    </td>
+                  ))}
+                </tr>
+              ))}
+            </tbody>
+          </table>
+        </div>
+      </div>
+    );
+  },
+  Button: ({ element, onAction }: ComponentProps) => {
+    const variant = (element.props.variant as string | undefined) ?? "primary";
+    const actionParams =
+      (element.props.actionParams as Record<string, unknown> | undefined) ?? {};
+    const base =
+      "rounded px-4 py-2 text-sm font-medium transition focus:outline-none";
+    const styles =
+      variant === "secondary"
+        ? "border border-gray-300 text-gray-700 hover:bg-gray-50"
+        : "bg-blue-600 text-white hover:bg-blue-500";
+
+    return (
+      <button
+        className={`${base} ${styles}`}
+        onClick={() =>
+          onAction?.(element.props.action as string, actionParams)
+        }
+        type="button"
+      >
+        {element.props.label as string}
+      </button>
+    );
+  },
+};