openalmanac 0.1.0

package/dist/types.js

@@ -0,0 +1,91 @@
+import { z } from "zod";
+export const Source = z.object({
+    url: z.string().describe("Source URL (must start with http:// or https://)"),
+    title: z.string().describe("Source title"),
+    accessed_date: z.string().describe("Date accessed in YYYY-MM-DD format"),
+});
+export const InfoboxDetail = z.object({
+    key: z.string(),
+    value: z.string(),
+});
+export const InfoboxHeader = z.object({
+    image_url: z.string().nullable().optional().describe("URL to a representative image"),
+    subtitle: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("Short tagline, e.g. 'Mathematician & Computer Scientist'"),
+    details: z.array(InfoboxDetail).default([]).describe("Key-value pairs for quick facts"),
+    links: z.array(z.string()).default([]).describe("External reference URLs"),
+});
+export const TimelineItem = z.object({
+    primary: z.string().describe("Main event description (required)"),
+    secondary: z.string().nullable().optional(),
+    period: z.string().nullable().optional().describe("Time period, e.g. '1936'"),
+    location: z.string().nullable().optional(),
+    description: z.array(z.string()).nullable().optional().describe("List of detail strings"),
+    link: z.string().nullable().optional(),
+});
+export const ListItem = z.object({
+    title: z.string().describe("Item title (required)"),
+    subtitle: z.string().nullable().optional(),
+    year: z.string().nullable().optional(),
+    description: z.array(z.string()).nullable().optional().describe("List of detail strings"),
+    link: z.string().nullable().optional(),
+});
+export const GridItem = z.object({
+    title: z.string().describe("Item title (required)"),
+    image_url: z.string().nullable().optional(),
+    year: z.string().nullable().optional(),
+    description: z.string().nullable().optional().describe("Plain string (not a list)"),
+    link: z.string().nullable().optional(),
+    type: z.string().nullable().optional(),
+});
+export const TableItems = z.object({
+    headers: z.array(z.string()).describe("Column headers (non-empty)"),
+    rows: z
+        .array(z.object({ cells: z.array(z.string()) }))
+        .describe("List of {cells: [str]} dicts matching headers"),
+});
+export const TimelineSection = z.object({
+    type: z.literal("timeline"),
+    title: z.string(),
+    items: z.array(TimelineItem),
+});
+export const ListSection = z.object({
+    type: z.literal("list"),
+    title: z.string(),
+    items: z.array(ListItem),
+});
+export const TagsSection = z.object({
+    type: z.literal("tags"),
+    title: z.string(),
+    items: z.array(z.string()).describe("Flat list of tag strings"),
+});
+export const GridSection = z.object({
+    type: z.literal("grid"),
+    title: z.string(),
+    items: z.array(GridItem),
+});
+export const TableSection = z.object({
+    type: z.literal("table"),
+    title: z.string(),
+    items: TableItems,
+});
+export const KeyValueSection = z.object({
+    type: z.literal("key_value"),
+    title: z.string(),
+    items: z.array(InfoboxDetail),
+});
+export const InfoboxSection = z.discriminatedUnion("type", [
+    TimelineSection,
+    ListSection,
+    TagsSection,
+    GridSection,
+    TableSection,
+    KeyValueSection,
+]);
+export const Infobox = z.object({
+    header: InfoboxHeader,
+    sections: z.array(InfoboxSection).default([]),
+});

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "openalmanac",
+  "version": "0.1.0",
+  "description": "OpenAlmanac — search, read, create, and update articles in the open knowledge base",
+  "type": "module",
+  "bin": {
+    "openalmanac": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli.js"
+  },
+  "keywords": [
+    "openalmanac",
+    "mcp",
+    "knowledge-base",
+    "ai",
+    "articles"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "fastmcp": "^1.0.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "skill"
+  ]
+}