zilmate 1.6.2 → 1.7.0

package/dist/tools/weather.tool.d.ts

@@ -0,0 +1,88 @@
+export declare const weatherTools: {
+    getWeather: import("ai").Tool<{
+        location: string;
+    }, {
+        location: string;
+        coordinates: {
+            lat: number;
+            lon: number;
+        };
+        current: {
+            temperature: {
+                value: number;
+                unit: string;
+            };
+            feelsLike: {
+                value: number;
+                unit: string;
+            };
+            humidity: {
+                value: number;
+                unit: string;
+            };
+            windSpeed: {
+                value: number;
+                unit: string;
+            };
+            condition: string;
+            emoji: string;
+        };
+        today: {
+            high: {
+                value: number;
+                unit: string;
+            };
+            low: {
+                value: number;
+                unit: string;
+            };
+            precipitationChance: {
+                value: number;
+                unit: string;
+            };
+        } | null;
+    }>;
+    getForecast: import("ai").Tool<{
+        location: string;
+        days: number;
+    }, {
+        location: string;
+        coordinates: {
+            lat: number;
+            lon: number;
+        };
+        forecast: {
+            date: string;
+            condition: string;
+            emoji: string;
+            high: {
+                value: number;
+                unit: string;
+            };
+            low: {
+                value: number;
+                unit: string;
+            };
+            precipitationChance: {
+                value: number;
+                unit: string;
+            };
+            windMax: {
+                value: number;
+                unit: string;
+            };
+        }[];
+    }>;
+    getCurrentLocation: import("ai").Tool<Record<string, never>, {
+        ip: string;
+        city: string;
+        region: string;
+        country: string;
+        coordinates: {
+            lat: number;
+            lon: number;
+        };
+        displayName: string;
+    }>;
+};
+//# sourceMappingURL=weather.tool.d.ts.map

package/dist/tools/weather.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weather.tool.d.ts","sourceRoot":"","sources":["../../src/tools/weather.tool.ts"],"names":[],"mappings":"AAwIA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6IxB,CAAC"}

package/dist/tools/weather.tool.js

@@ -0,0 +1,228 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+import { emitProgress } from '../runtime/progress.js';
+// WMO Weather interpretation codes (https://open-meteo.com/en/docs#weathervariables)
+const weatherCodes = {
+    0: 'Clear sky',
+    1: 'Mainly clear',
+    2: 'Partly cloudy',
+    3: 'Overcast',
+    45: 'Fog',
+    48: 'Depositing rime fog',
+    51: 'Light drizzle',
+    53: 'Moderate drizzle',
+    55: 'Dense drizzle',
+    56: 'Light freezing drizzle',
+    57: 'Dense freezing drizzle',
+    61: 'Slight rain',
+    63: 'Moderate rain',
+    65: 'Heavy rain',
+    66: 'Light freezing rain',
+    67: 'Heavy freezing rain',
+    71: 'Slight snow fall',
+    73: 'Moderate snow fall',
+    75: 'Heavy snow fall',
+    77: 'Snow grains',
+    80: 'Slight rain showers',
+    81: 'Moderate rain showers',
+    82: 'Violent rain showers',
+    85: 'Slight snow showers',
+    86: 'Heavy snow showers',
+    95: 'Thunderstorm',
+    96: 'Thunderstorm with slight hail',
+    99: 'Thunderstorm with heavy hail',
+};
+function weatherDescription(code) {
+    return weatherCodes[code] ?? `Unknown (code ${code})`;
+}
+function emojiForWeather(code) {
+    if (code === 0)
+        return '☀️';
+    if (code <= 2)
+        return '⛅';
+    if (code === 3)
+        return '☁️';
+    if (code >= 45 && code <= 48)
+        return '🌫️';
+    if (code >= 51 && code <= 57)
+        return '🌦️';
+    if (code >= 61 && code <= 67)
+        return '🌧️';
+    if (code >= 71 && code <= 77)
+        return '❄️';
+    if (code >= 80 && code <= 82)
+        return '🌦️';
+    if (code >= 85 && code <= 86)
+        return '🌨️';
+    if (code >= 95)
+        return '⛈️';
+    return '🌈';
+}
+// ─── Geocode: city name → {lat, lon} via Open-Meteo Geocoding API ────────────
+async function geocodeCity(city, count = 5) {
+    const url = `https://geocoding-api.open-meteo.com/v1/search?name=${encodeURIComponent(city)}&count=${count}&language=en&format=json`;
+    const response = await fetch(url);
+    if (!response.ok)
+        throw new Error(`Geocoding failed (${response.status}): ${response.statusText}`);
+    const data = (await response.json());
+    return data.results ?? [];
+}
+async function reverseGeocode(lat, lon) {
+    const url = `https://geocoding-api.open-meteo.com/v1/reverse?latitude=${lat}&longitude=${lon}&language=en&format=json`;
+    const response = await fetch(url);
+    if (!response.ok)
+        return `${lat}, ${lon}`;
+    const data = (await response.json());
+    const result = data.results?.[0];
+    if (!result)
+        return `${lat}, ${lon}`;
+    return result.admin1 ? `${result.name}, ${result.admin1}, ${result.country}` : `${result.name}, ${result.country}`;
+}
+// ─── Fetch current weather from Open-Meteo ───────────────────────────────────
+async function fetchWeather(lat, lon) {
+    const url = `https://api.open-meteo.com/v1/forecast?latitude=${lat}&longitude=${lon}&current=temperature_2m,relative_humidity_2m,apparent_temperature,weather_code,wind_speed_10m&daily=weather_code,temperature_2m_max,temperature_2m_min,precipitation_probability_max,wind_speed_10m_max&timezone=auto&forecast_days=7`;
+    const response = await fetch(url);
+    if (!response.ok)
+        throw new Error(`Weather API failed (${response.status}): ${response.statusText}`);
+    return (await response.json());
+}
+// ─── Get approximate location from IP ────────────────────────────────────────
+// Uses ip-api.com free tier (no key, 45 req/min limit)
+// Docs: https://ip-api.com/docs/api:json
+async function ipLocation() {
+    const response = await fetch('http://ip-api.com/json/?fields=status,query,lat,lon,city,region,country');
+    if (!response.ok)
+        throw new Error(`IP geolocation failed (${response.status})`);
+    const data = (await response.json());
+    if (data.status !== 'success')
+        throw new Error('IP geolocation returned non-success status');
+    return { lat: data.lat, lon: data.lon, city: data.city, region: data.region, country: data.country, ip: data.query };
+}
+// ─── Tools ────────────────────────────────────────────────────────────────────
+export const weatherTools = {
+    getWeather: tool({
+        description: 'Get current weather conditions for a city or coordinates. Uses free Open-Meteo API — no API key needed. Returns temperature, feels-like, humidity, wind, and conditions.',
+        inputSchema: z.object({
+            location: z.string().min(1).describe('City name (e.g. "London", "Accra", "New York") or "latitude,longitude" coordinates.'),
+        }),
+        execute: async ({ location }) => {
+            emitProgress({ type: 'fetch:start', label: 'Getting weather', detail: location });
+            // Parse direct coordinates if provided
+            const coordMatch = /^(-?\d+\.?\d*),\s*(-?\d+\.?\d*)$/.exec(location.trim());
+            let lat;
+            let lon;
+            let resolvedLocation;
+            if (coordMatch) {
+                lat = parseFloat(coordMatch[1]);
+                lon = parseFloat(coordMatch[2]);
+                resolvedLocation = await reverseGeocode(lat, lon);
+            }
+            else {
+                const results = await geocodeCity(location);
+                if (results.length === 0)
+                    throw new Error(`Could not find location: "${location}". Try a different city name or use "latitude,longitude" coordinates.`);
+                lat = results[0].latitude;
+                lon = results[0].longitude;
+                resolvedLocation = results[0].admin1
+                    ? `${results[0].name}, ${results[0].admin1}, ${results[0].country}`
+                    : `${results[0].name}, ${results[0].country}`;
+            }
+            const weather = await fetchWeather(lat, lon);
+            if (!weather.current) {
+                throw new Error('No current weather data returned for this location.');
+            }
+            const { temperature_2m: temp, relative_humidity_2m: humidity, apparent_temperature: feelsLike, weather_code: code, wind_speed_10m: wind } = weather.current;
+            const today = weather.daily ? {
+                high: weather.daily.temperature_2m_max[0],
+                low: weather.daily.temperature_2m_min[0],
+                precipChance: weather.daily.precipitation_probability_max[0],
+            } : null;
+            const emoji = emojiForWeather(code);
+            const desc = weatherDescription(code);
+            emitProgress({ type: 'fetch:end', label: 'Weather fetched', detail: resolvedLocation });
+            return {
+                location: resolvedLocation,
+                coordinates: { lat, lon },
+                current: {
+                    temperature: { value: temp, unit: '°C' },
+                    feelsLike: { value: feelsLike, unit: '°C' },
+                    humidity: { value: humidity, unit: '%' },
+                    windSpeed: { value: wind, unit: 'km/h' },
+                    condition: desc,
+                    emoji,
+                },
+                today: today ? {
+                    high: { value: today.high, unit: '°C' },
+                    low: { value: today.low, unit: '°C' },
+                    precipitationChance: { value: today.precipChance, unit: '%' },
+                } : null,
+            };
+        },
+    }),
+    getForecast: tool({
+        description: 'Get a multi-day weather forecast for a city or coordinates. Returns daily highs, lows, conditions, precipitation chance, and wind. Uses free Open-Meteo API — no API key needed.',
+        inputSchema: z.object({
+            location: z.string().min(1).describe('City name or "latitude,longitude" coordinates.'),
+            days: z.number().int().min(1).max(7).optional().default(5).describe('Number of forecast days (1–7, default 5).'),
+        }),
+        execute: async ({ location, days }) => {
+            emitProgress({ type: 'fetch:start', label: 'Getting forecast', detail: `${location} (${days} days)` });
+            const coordMatch = /^(-?\d+\.?\d*),\s*(-?\d+\.?\d*)$/.exec(location.trim());
+            let lat;
+            let lon;
+            let resolvedLocation;
+            if (coordMatch) {
+                lat = parseFloat(coordMatch[1]);
+                lon = parseFloat(coordMatch[2]);
+                resolvedLocation = await reverseGeocode(lat, lon);
+            }
+            else {
+                const results = await geocodeCity(location);
+                if (results.length === 0)
+                    throw new Error(`Could not find location: "${location}".`);
+                lat = results[0].latitude;
+                lon = results[0].longitude;
+                resolvedLocation = results[0].admin1
+                    ? `${results[0].name}, ${results[0].admin1}, ${results[0].country}`
+                    : `${results[0].name}, ${results[0].country}`;
+            }
+            const weather = await fetchWeather(lat, lon);
+            if (!weather.daily) {
+                throw new Error('No forecast data returned for this location.');
+            }
+            const forecastDays = weather.daily.time.slice(0, days).map((date, i) => ({
+                date,
+                condition: weatherDescription(weather.daily.weather_code[i]),
+                emoji: emojiForWeather(weather.daily.weather_code[i]),
+                high: { value: weather.daily.temperature_2m_max[i], unit: '°C' },
+                low: { value: weather.daily.temperature_2m_min[i], unit: '°C' },
+                precipitationChance: { value: weather.daily.precipitation_probability_max[i], unit: '%' },
+                windMax: { value: weather.daily.wind_speed_10m_max[i], unit: 'km/h' },
+            }));
+            emitProgress({ type: 'fetch:end', label: 'Forecast fetched', detail: `${days} days for ${resolvedLocation}` });
+            return {
+                location: resolvedLocation,
+                coordinates: { lat, lon },
+                forecast: forecastDays,
+            };
+        },
+    }),
+    getCurrentLocation: tool({
+        description: 'Get the approximate current location (city, region, country, and coordinates) from your IP address. Uses free ip-api.com — no API key needed. Pair with getWeather to check local weather.',
+        inputSchema: z.object({}),
+        execute: async () => {
+            emitProgress({ type: 'fetch:start', label: 'Detecting location from IP' });
+            const location = await ipLocation();
+            emitProgress({ type: 'fetch:end', label: 'Location detected', detail: `${location.city}, ${location.country}` });
+            return {
+                ip: location.ip,
+                city: location.city,
+                region: location.region,
+                country: location.country,
+                coordinates: { lat: location.lat, lon: location.lon },
+                displayName: [location.city, location.region, location.country].filter(Boolean).join(', '),
+            };
+        },
+    }),
+};
+//# sourceMappingURL=weather.tool.js.map

package/dist/tools/weather.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weather.tool.js","sourceRoot":"","sources":["../../src/tools/weather.tool.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zilmate",
-  "version": "1.6.2",
+  "version": "1.7.0",
   "description": "ZilMate CLI multi-agent assistant for ZiloShift workflows.",
   "type": "module",
   "main": "dist/server.js",
@@ -59,6 +59,7 @@
     "commander": "^15.0.0",
     "cross-fetch": "^4.1.0",
     "dotenv": "^17.4.2",
+    "log-update": "^8.0.0",
     "marked": "^15.0.12",
     "marked-terminal": "^7.3.0",
     "pdfkit": "^0.19.1",
@@ -81,6 +82,7 @@
     "scripts/",
     "agent-docs.md",
     "README.md",
+    "SDK.md",
     ".env.example",
     "install.ps1"
   ],

package/scripts/release-github.mjs

@@ -12,7 +12,7 @@ const title = `ZilMate ${tag}`;
 
 const notes = `# ${title}
 
-ZilMate ${tag} — workspace-first assistant with merge setup, documents, skills.sh, heal, and richer CLI UX.
+ZilMate ${tag} — Claude-inspired CLI, situational awareness, session handoffs, model picker, and SDK docs.
 
 ## Install
 
@@ -20,24 +20,25 @@ ZilMate ${tag} — workspace-first assistant with merge setup, documents, skills
 npm install -g zilmate@${version}
 zilmate setup
 zilmate doctor --live
+zilmate talk
 \`\`\`
 
 ## Highlights
 
-- **Merge setup** — \`zilmate setup\` preserves existing \`.env\` values; only adds missing keys.
-- **ZilMate workspace** — \`~/Downloads/ZilMate\` with notebook, knowledge graph, skills, outputs, logs.
-- **PDF & slide decks** — \`generatePdf\` / \`generateSlideDeck\` tools (Kimi-style .pptx + reports).
-- **skills.sh ecosystem** — \`searchSkillsRegistry\` + \`installRegistrySkill\` via \`npx skills\`.
-- **Powerful heal** — two-pass session review: memory, contacts, projects, action items, friction log.
-- **Desktop notifications** — agent can toast the user when approval or attention is needed.
-- **CLI UX** — spinner while thinking, arrow/space selection for agent questions.
-- **QStash + Cloudflare** — optional tunnel during setup; \`zilmate jobs listen --tunnel\`.
+- **Beautiful CLI** — welcome card, tips, boxed composer input, Claude-style tool progress (\`● tool\` / \`└ Done\`).
+- **/model pick** — interactively choose manager, coding, image, and vision models; persisted to workspace \`config/models.json\`.
+- **Situational awareness** — \`getSituationBrief\` snapshots cwd, git, workspace, jobs, memory, models, and capabilities.
+- **Session continuity** — handoff save/load/generate so ZilMate resumes where you left off.
+- **Coding intelligence** — five tools: grep, working-tree review, symbol explain, scaffold, project checks; appBuilder + qaIntegration sub-coders.
+- **Image director** — \`enhanceImagePrompt\` + generation with art-direction presets.
+- **Cloudflare setup** — dedicated tunnel section in \`zilmate setup\`; \`zilmate jobs listen --tunnel\`.
+- **SDK.md** — Next.js App Router streaming route, subagents, jobs, voice, model selection.
 
 ## Quick Checks
 
 \`\`\`powershell
-zilmate workspace
-zilmate heal "session summary"
+zilmate talk
+/model pick
 zilmate jobs listen --tunnel
 \`\`\`