@jcheesepkg/nanobot 0.1.0

package/dist/utils/helpers.d.mts

@@ -0,0 +1,26 @@
+//#region src/utils/helpers.d.ts
+/** Ensure a directory exists, creating it if necessary. */
+declare function ensureDir(dirPath: string): string;
+/** Get the nanobot data directory (~/.nanobot). */
+declare function getDataPath(): string;
+/** Get the workspace path. Defaults to ~/.nanobot/workspace. */
+declare function getWorkspacePath(workspace?: string): string;
+/** Get the sessions storage directory. */
+declare function getSessionsPath(): string;
+/** Get the memory directory within the workspace. */
+declare function getMemoryPath(workspace?: string): string;
+/** Get the skills directory within the workspace. */
+declare function getSkillsPath(workspace?: string): string;
+/** Get today's date in YYYY-MM-DD format. */
+declare function todayDate(): string;
+/** Get current timestamp in ISO format. */
+declare function timestamp(): string;
+/** Truncate a string to max length, adding suffix if truncated. */
+declare function truncateString(s: string, maxLen?: number, suffix?: string): string;
+/** Convert a string to a safe filename. */
+declare function safeFilename(name: string): string;
+/** Parse a session key into channel and chat_id. */
+declare function parseSessionKey(key: string): [string, string];
+//#endregion
+export { ensureDir, getDataPath, getMemoryPath, getSessionsPath, getSkillsPath, getWorkspacePath, parseSessionKey, safeFilename, timestamp, todayDate, truncateString };
+//# sourceMappingURL=helpers.d.mts.map

package/dist/utils/helpers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.mts","names":[],"sources":["../../src/utils/helpers.ts"],"mappings":";;iBAKgB,SAAA,CAAU,OAAA;;iBAQV,WAAA,CAAA;;iBAKA,gBAAA,CAAiB,SAAA;AALjC;AAAA,iBAagB,eAAA,CAAA;;iBAKA,aAAA,CAAc,SAAA;;iBAMd,aAAA,CAAc,SAAA;;iBAMd,SAAA,CAAA;;iBAKA,SAAA,CAAA;AAtBhB;AAAA,iBA2BgB,cAAA,CACd,CAAA,UACA,MAAA,WACA,MAAA;;iBAOc,YAAA,CAAa,IAAA;;iBAUb,eAAA,CAAgB,GAAA"}

package/dist/utils/helpers.mjs

@@ -0,0 +1,60 @@
+import { existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+//#region src/utils/helpers.ts
+/** Ensure a directory exists, creating it if necessary. */
+function ensureDir(dirPath) {
+	if (!existsSync(dirPath)) mkdirSync(dirPath, { recursive: true });
+	return dirPath;
+}
+/** Get the nanobot data directory (~/.nanobot). */
+function getDataPath() {
+	return ensureDir(join(homedir(), ".nanobot"));
+}
+/** Get the workspace path. Defaults to ~/.nanobot/workspace. */
+function getWorkspacePath(workspace) {
+	return ensureDir(workspace ? workspace.replace(/^~/, homedir()) : join(homedir(), ".nanobot", "workspace"));
+}
+/** Get the sessions storage directory. */
+function getSessionsPath() {
+	return ensureDir(join(getDataPath(), "sessions"));
+}
+/** Get the memory directory within the workspace. */
+function getMemoryPath(workspace) {
+	return ensureDir(join(workspace ?? getWorkspacePath(), "memory"));
+}
+/** Get the skills directory within the workspace. */
+function getSkillsPath(workspace) {
+	return ensureDir(join(workspace ?? getWorkspacePath(), "skills"));
+}
+/** Get today's date in YYYY-MM-DD format. */
+function todayDate() {
+	return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+}
+/** Get current timestamp in ISO format. */
+function timestamp() {
+	return (/* @__PURE__ */ new Date()).toISOString();
+}
+/** Truncate a string to max length, adding suffix if truncated. */
+function truncateString(s, maxLen = 100, suffix = "...") {
+	if (s.length <= maxLen) return s;
+	return s.slice(0, maxLen - suffix.length) + suffix;
+}
+/** Convert a string to a safe filename. */
+function safeFilename(name) {
+	const unsafe = "<>:\"/\\|?*";
+	let result = name;
+	for (const char of unsafe) result = result.replaceAll(char, "_");
+	return result.trim();
+}
+/** Parse a session key into channel and chat_id. */
+function parseSessionKey(key) {
+	const idx = key.indexOf(":");
+	if (idx === -1) throw new Error(`Invalid session key: ${key}`);
+	return [key.slice(0, idx), key.slice(idx + 1)];
+}
+
+//#endregion
+export { ensureDir, getDataPath, getMemoryPath, getSessionsPath, getSkillsPath, getWorkspacePath, parseSessionKey, safeFilename, timestamp, todayDate, truncateString };
+//# sourceMappingURL=helpers.mjs.map

package/dist/utils/helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.mjs","names":[],"sources":["../../src/utils/helpers.ts"],"sourcesContent":["import { mkdirSync, existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { homedir } from \"node:os\";\n\n/** Ensure a directory exists, creating it if necessary. */\nexport function ensureDir(dirPath: string): string {\n  if (!existsSync(dirPath)) {\n    mkdirSync(dirPath, { recursive: true });\n  }\n  return dirPath;\n}\n\n/** Get the nanobot data directory (~/.nanobot). */\nexport function getDataPath(): string {\n  return ensureDir(join(homedir(), \".nanobot\"));\n}\n\n/** Get the workspace path. Defaults to ~/.nanobot/workspace. */\nexport function getWorkspacePath(workspace?: string): string {\n  const resolved = workspace\n    ? workspace.replace(/^~/, homedir())\n    : join(homedir(), \".nanobot\", \"workspace\");\n  return ensureDir(resolved);\n}\n\n/** Get the sessions storage directory. */\nexport function getSessionsPath(): string {\n  return ensureDir(join(getDataPath(), \"sessions\"));\n}\n\n/** Get the memory directory within the workspace. */\nexport function getMemoryPath(workspace?: string): string {\n  const ws = workspace ?? getWorkspacePath();\n  return ensureDir(join(ws, \"memory\"));\n}\n\n/** Get the skills directory within the workspace. */\nexport function getSkillsPath(workspace?: string): string {\n  const ws = workspace ?? getWorkspacePath();\n  return ensureDir(join(ws, \"skills\"));\n}\n\n/** Get today's date in YYYY-MM-DD format. */\nexport function todayDate(): string {\n  return new Date().toISOString().slice(0, 10);\n}\n\n/** Get current timestamp in ISO format. */\nexport function timestamp(): string {\n  return new Date().toISOString();\n}\n\n/** Truncate a string to max length, adding suffix if truncated. */\nexport function truncateString(\n  s: string,\n  maxLen = 100,\n  suffix = \"...\",\n): string {\n  if (s.length <= maxLen) return s;\n  return s.slice(0, maxLen - suffix.length) + suffix;\n}\n\n/** Convert a string to a safe filename. */\nexport function safeFilename(name: string): string {\n  const unsafe = '<>:\"/\\\\|?*';\n  let result = name;\n  for (const char of unsafe) {\n    result = result.replaceAll(char, \"_\");\n  }\n  return result.trim();\n}\n\n/** Parse a session key into channel and chat_id. */\nexport function parseSessionKey(key: string): [string, string] {\n  const idx = key.indexOf(\":\");\n  if (idx === -1) {\n    throw new Error(`Invalid session key: ${key}`);\n  }\n  return [key.slice(0, idx), key.slice(idx + 1)];\n}\n"],"mappings":";;;;;;AAKA,SAAgB,UAAU,SAAyB;AACjD,KAAI,CAAC,WAAW,QAAQ,CACtB,WAAU,SAAS,EAAE,WAAW,MAAM,CAAC;AAEzC,QAAO;;;AAIT,SAAgB,cAAsB;AACpC,QAAO,UAAU,KAAK,SAAS,EAAE,WAAW,CAAC;;;AAI/C,SAAgB,iBAAiB,WAA4B;AAI3D,QAAO,UAHU,YACb,UAAU,QAAQ,MAAM,SAAS,CAAC,GAClC,KAAK,SAAS,EAAE,YAAY,YAAY,CAClB;;;AAI5B,SAAgB,kBAA0B;AACxC,QAAO,UAAU,KAAK,aAAa,EAAE,WAAW,CAAC;;;AAInD,SAAgB,cAAc,WAA4B;AAExD,QAAO,UAAU,KADN,aAAa,kBAAkB,EAChB,SAAS,CAAC;;;AAItC,SAAgB,cAAc,WAA4B;AAExD,QAAO,UAAU,KADN,aAAa,kBAAkB,EAChB,SAAS,CAAC;;;AAItC,SAAgB,YAAoB;AAClC,yBAAO,IAAI,MAAM,EAAC,aAAa,CAAC,MAAM,GAAG,GAAG;;;AAI9C,SAAgB,YAAoB;AAClC,yBAAO,IAAI,MAAM,EAAC,aAAa;;;AAIjC,SAAgB,eACd,GACA,SAAS,KACT,SAAS,OACD;AACR,KAAI,EAAE,UAAU,OAAQ,QAAO;AAC/B,QAAO,EAAE,MAAM,GAAG,SAAS,OAAO,OAAO,GAAG;;;AAI9C,SAAgB,aAAa,MAAsB;CACjD,MAAM,SAAS;CACf,IAAI,SAAS;AACb,MAAK,MAAM,QAAQ,OACjB,UAAS,OAAO,WAAW,MAAM,IAAI;AAEvC,QAAO,OAAO,MAAM;;;AAItB,SAAgB,gBAAgB,KAA+B;CAC7D,MAAM,MAAM,IAAI,QAAQ,IAAI;AAC5B,KAAI,QAAQ,GACV,OAAM,IAAI,MAAM,wBAAwB,MAAM;AAEhD,QAAO,CAAC,IAAI,MAAM,GAAG,IAAI,EAAE,IAAI,MAAM,MAAM,EAAE,CAAC"}

package/dist/utils/which.d.mts

@@ -0,0 +1,6 @@
+//#region src/utils/which.d.ts
+/** Simple `which` implementation - find a binary in PATH. */
+declare function which(name: string): string | null;
+//#endregion
+export { which };
+//# sourceMappingURL=which.d.mts.map

package/dist/utils/which.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"which.d.mts","names":[],"sources":["../../src/utils/which.ts"],"mappings":";;iBAIgB,KAAA,CAAM,IAAA"}

package/dist/utils/which.mjs

@@ -0,0 +1,20 @@
+import { accessSync, constants } from "node:fs";
+import { join } from "node:path";
+
+//#region src/utils/which.ts
+/** Simple `which` implementation - find a binary in PATH. */
+function which(name) {
+	const pathDirs = (process.env.PATH ?? "").split(":");
+	for (const dir of pathDirs) {
+		const fullPath = join(dir, name);
+		try {
+			accessSync(fullPath, constants.X_OK);
+			return fullPath;
+		} catch {}
+	}
+	return null;
+}
+
+//#endregion
+export { which };
+//# sourceMappingURL=which.mjs.map

package/dist/utils/which.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"which.mjs","names":[],"sources":["../../src/utils/which.ts"],"sourcesContent":["import { existsSync, accessSync, constants } from \"node:fs\";\nimport { join } from \"node:path\";\n\n/** Simple `which` implementation - find a binary in PATH. */\nexport function which(name: string): string | null {\n  const pathDirs = (process.env.PATH ?? \"\").split(\":\");\n  for (const dir of pathDirs) {\n    const fullPath = join(dir, name);\n    try {\n      accessSync(fullPath, constants.X_OK);\n      return fullPath;\n    } catch {\n      // not found in this dir\n    }\n  }\n  return null;\n}\n"],"mappings":";;;;;AAIA,SAAgB,MAAM,MAA6B;CACjD,MAAM,YAAY,QAAQ,IAAI,QAAQ,IAAI,MAAM,IAAI;AACpD,MAAK,MAAM,OAAO,UAAU;EAC1B,MAAM,WAAW,KAAK,KAAK,KAAK;AAChC,MAAI;AACF,cAAW,UAAU,UAAU,KAAK;AACpC,UAAO;UACD;;AAIV,QAAO"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@jcheesepkg/nanobot",
+  "version": "0.1.0",
+  "description": "Lightweight AI assistant - TypeScript port",
+  "type": "module",
+  "main": "dist/index.mjs",
+  "types": "dist/index.d.mts",
+  "bin": {
+    "nanobot": "dist/cli/index.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsx src/cli/index.ts",
+    "start": "node dist/cli/index.mjs",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "cron-parser": "^4.9.0",
+    "grammy": "^1.30.0",
+    "openai": "^4.73.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsdown": "^0.20.3",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "workspace"
+  ],
+  "license": "MIT"
+}

package/skills/cron/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: cron
+description: Schedule reminders and recurring tasks.
+---
+
+# Cron
+
+Use the `cron` tool to schedule reminders or recurring tasks.
+
+## Two Modes
+
+1. **Reminder** - message is sent directly to user
+2. **Task** - message is a task description, agent executes and sends result
+
+## Examples
+
+Fixed reminder:
+```
+cron(action="add", message="Time to take a break!", every_seconds=1200)
+```
+
+Dynamic task (agent executes each time):
+```
+cron(action="add", message="Check HKUDS/nanobot GitHub stars and report", every_seconds=600)
+```
+
+List/remove:
+```
+cron(action="list")
+cron(action="remove", job_id="abc123")
+```
+
+## Time Expressions
+
+| User says | Parameters |
+|-----------|------------|
+| every 20 minutes | every_seconds: 1200 |
+| every hour | every_seconds: 3600 |
+| every day at 8am | cron_expr: "0 8 * * *" |
+| weekdays at 5pm | cron_expr: "0 17 * * 1-5" |

package/skills/github/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: github
+description: "Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries."
+metadata: {"nanobot":{"emoji":"octopus","requires":{"bins":["gh"]}}}
+---
+
+# GitHub Skill
+
+Use the `gh` CLI to interact with GitHub. Always specify `--repo owner/repo` when not in a git directory, or use URLs directly.
+
+## Pull Requests
+
+Check CI status on a PR:
+```bash
+gh pr checks 55 --repo owner/repo
+```
+
+List recent workflow runs:
+```bash
+gh run list --repo owner/repo --limit 10
+```
+
+View a run and see which steps failed:
+```bash
+gh run view <run-id> --repo owner/repo
+```
+
+View logs for failed steps only:
+```bash
+gh run view <run-id> --repo owner/repo --log-failed
+```
+
+## API for Advanced Queries
+
+The `gh api` command is useful for accessing data not available through other subcommands.
+
+Get PR with specific fields:
+```bash
+gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'
+```
+
+## JSON Output
+
+Most commands support `--json` for structured output. You can use `--jq` to filter:
+
+```bash
+gh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'
+```

package/skills/skill-creator/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: skill-creator
+description: Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
+---
+
+# Skill Creator
+
+This skill provides guidance for creating effective skills.
+
+## About Skills
+
+Skills are modular, self-contained packages that extend the agent's capabilities by providing
+specialized knowledge, workflows, and tools. They transform the agent from a general-purpose
+assistant into a specialized one equipped with procedural knowledge.
+
+### What Skills Provide
+
+1. Specialized workflows - Multi-step procedures for specific domains
+2. Tool integrations - Instructions for working with specific file formats or APIs
+3. Domain expertise - Company-specific knowledge, schemas, business logic
+4. Bundled resources - Scripts, references, and assets for complex tasks
+
+## Core Principles
+
+### Concise is Key
+
+The context window is a shared resource. Only add context the agent doesn't already have. Prefer concise examples over verbose explanations.
+
+### Anatomy of a Skill
+
+```
+skill-name/
+  SKILL.md (required)
+    - YAML frontmatter: name, description
+    - Markdown instructions
+  scripts/      (optional) - Executable code
+  references/   (optional) - Documentation for context
+  assets/       (optional) - Files used in output
+```
+
+#### SKILL.md
+
+- **Frontmatter** (YAML): `name` and `description` fields. Description is the primary triggering mechanism.
+- **Body** (Markdown): Instructions loaded after the skill triggers.
+
+### Progressive Disclosure
+
+Skills use three-level loading:
+
+1. **Metadata (name + description)** - Always in context (~100 words)
+2. **SKILL.md body** - When skill triggers (<5k words)
+3. **Bundled resources** - As needed (unlimited)
+
+## Skill Creation Process
+
+1. Understand the skill with concrete examples
+2. Plan reusable contents (scripts, references, assets)
+3. Create SKILL.md with proper frontmatter
+4. Implement resources and instructions
+5. Test and iterate based on real usage
+
+### Naming
+
+- Lowercase, digits, hyphens only
+- Under 64 characters
+- Prefer short, verb-led phrases
+- Namespace by tool when helpful (e.g., `gh-address-comments`)
+
+### Frontmatter Guidelines
+
+- `name`: The skill name
+- `description`: What the skill does AND when to use it. Include trigger contexts.
+  All "when to use" info goes here since the body only loads after triggering.

package/skills/summarize/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: summarize
+description: Summarize or extract text/transcripts from URLs, podcasts, and local files (great fallback for "transcribe this YouTube/video").
+---
+
+# Summarize
+
+Fast CLI to summarize URLs, local files, and YouTube links.
+
+## When to use (trigger phrases)
+
+Use this skill immediately when the user asks any of:
+- "what's this link/video about?"
+- "summarize this URL/article"
+- "transcribe this YouTube/video" (best-effort transcript extraction)
+
+## Quick start
+
+```bash
+summarize "https://example.com" --model google/gemini-3-flash-preview
+summarize "/path/to/file.pdf" --model google/gemini-3-flash-preview
+summarize "https://youtu.be/dQw4w9WgXcQ" --youtube auto
+```
+
+## YouTube: summary vs transcript
+
+Best-effort transcript (URLs only):
+
+```bash
+summarize "https://youtu.be/dQw4w9WgXcQ" --youtube auto --extract-only
+```
+
+If the user asked for a transcript but it's huge, return a tight summary first, then ask which section/time range to expand.
+
+## Model + keys
+
+Set the API key for your chosen provider:
+- OpenAI: `OPENAI_API_KEY`
+- Anthropic: `ANTHROPIC_API_KEY`
+- Google: `GEMINI_API_KEY`
+
+## Useful flags
+
+- `--length short|medium|long|xl|xxl|<chars>`
+- `--max-output-tokens <count>`
+- `--extract-only` (URLs only)
+- `--json` (machine readable)

package/skills/weather/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: weather
+description: Get current weather and forecasts (no API key required).
+---
+
+# Weather
+
+Two free services, no API keys needed.
+
+## wttr.in (primary)
+
+Quick one-liner:
+```bash
+curl -s "wttr.in/London?format=3"
+# Output: London: +8C
+```
+
+Compact format:
+```bash
+curl -s "wttr.in/London?format=%l:+%c+%t+%h+%w"
+```
+
+Full forecast:
+```bash
+curl -s "wttr.in/London?T"
+```
+
+Format codes: `%c` condition, `%t` temp, `%h` humidity, `%w` wind, `%l` location, `%m` moon
+
+Tips:
+- URL-encode spaces: `wttr.in/New+York`
+- Airport codes: `wttr.in/JFK`
+- Units: `?m` (metric) `?u` (USCS)
+- Today only: `?1` / Current only: `?0`
+
+## Open-Meteo (fallback, JSON)
+
+Free, no key, good for programmatic use:
+```bash
+curl -s "https://api.open-meteo.com/v1/forecast?latitude=51.5&longitude=-0.12&current_weather=true"
+```
+
+Find coordinates for a city, then query. Returns JSON with temp, windspeed, weathercode.