zilmate 1.0.0

package/dist/tools/zilo-docs.tool.js

@@ -0,0 +1,150 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { tool } from 'ai';
+import { z } from 'zod';
+import { clampText } from '../safety/limits.js';
+import { emitProgress } from '../runtime/progress.js';
+const projectRoot = path.resolve(fileURLToPath(new URL('../..', import.meta.url)));
+const docsRoot = path.join(projectRoot, 'src', 'doc');
+const ziloDocs = [
+    {
+        key: 'readme',
+        filename: 'README.md',
+        title: 'ZiloShift Support Docs Overview',
+        description: 'Core support principles, triage questions, risk warnings, and how to use the playbooks.',
+    },
+    {
+        key: 'worker-support-playbook',
+        filename: 'worker-support-playbook.md',
+        title: 'Worker Support Playbook',
+        description: 'Worker onboarding, shift discovery, applications, attendance, payouts, profile, and tone guidance.',
+    },
+    {
+        key: 'venue-support-playbook',
+        filename: 'venue-support-playbook.md',
+        title: 'Venue Support Playbook',
+        description: 'Venue setup, billing, posting, applicants, trust signals, completion, and account support.',
+    },
+    {
+        key: 'payments-and-payouts',
+        filename: 'payments-and-payouts.md',
+        title: 'Payments and Payouts',
+        description: 'Market payment providers, venue billing, worker payouts, profile promotion, refunds, and disputes.',
+    },
+    {
+        key: 'verification-and-trust',
+        filename: 'verification-and-trust.md',
+        title: 'Verification and Trust',
+        description: 'Worker, venue, Ghana owner, business, payout, and support verification guidance.',
+    },
+    {
+        key: 'shift-lifecycle-and-disputes',
+        filename: 'shift-lifecycle-and-disputes.md',
+        title: 'Shift Lifecycle and Disputes',
+        description: 'Shift posting, applying, accepting, clocking, completion, disputes, and escalation guidance.',
+    },
+    {
+        key: 'admin-tools-and-sms-campaigns',
+        filename: 'admin-tools-and-sms-campaigns.md',
+        title: 'Admin Tools and SMS Campaigns',
+        description: 'Admin dashboard, user management, coupons, SMS campaigns, and operational guardrails.',
+    },
+    {
+        key: 'support-macros',
+        filename: 'support-macros.md',
+        title: 'Support Macros',
+        description: 'Reusable replies for workers, venues, payments, verification, disputes, and SMS issues.',
+    },
+    {
+        key: 'escalation-checklist',
+        filename: 'escalation-checklist.md',
+        title: 'Escalation Checklist',
+        description: 'When to escalate support cases and what facts to collect before handing off.',
+    },
+];
+const docsByKey = new Map(ziloDocs.map((doc) => [doc.key, doc]));
+async function readZiloDocContent(key) {
+    const doc = docsByKey.get(key);
+    if (!doc) {
+        const known = ziloDocs.map((item) => item.key).join(', ');
+        throw new Error(`Unknown Zilo doc key "${key}". Known keys: ${known}`);
+    }
+    const filePath = path.join(docsRoot, doc.filename);
+    const content = await readFile(filePath, 'utf8');
+    return { ...doc, content };
+}
+function normalize(input) {
+    return input.toLowerCase().replace(/[^a-z0-9]+/g, ' ').trim();
+}
+function scoreDoc(content, terms) {
+    const normalized = normalize(content);
+    return terms.reduce((score, term) => score + (normalized.includes(term) ? 1 : 0), 0);
+}
+function createSnippet(content, terms, maxLength = 650) {
+    const lower = content.toLowerCase();
+    const firstIndex = terms
+        .map((term) => lower.indexOf(term.toLowerCase()))
+        .filter((index) => index >= 0)
+        .sort((a, b) => a - b)[0];
+    const start = Math.max(0, (firstIndex ?? 0) - 180);
+    const snippet = content.slice(start, start + maxLength).replace(/\s+/g, ' ').trim();
+    return start > 0 ? `...${snippet}` : snippet;
+}
+export const ziloDocsTools = {
+    listZiloDocs: tool({
+        description: 'List local ZiloShift support/product documentation available for on-demand reading.',
+        inputSchema: z.object({}),
+        execute: async () => {
+            emitProgress({ type: 'tool:start', label: 'Listing Zilo docs' });
+            const docs = ziloDocs.map(({ key, title, description }) => ({ key, title, description }));
+            emitProgress({ type: 'tool:end', label: 'Zilo docs listed', detail: `${docs.length} document${docs.length === 1 ? '' : 's'}` });
+            return docs;
+        },
+    }),
+    readZiloDoc: tool({
+        description: 'Read one allowlisted local ZiloShift support/product doc by key. Use this after listZiloDocs or searchZiloDocs.',
+        inputSchema: z.object({
+            key: z.string().min(2),
+            maxChars: z.number().int().min(500).max(12000).optional(),
+        }),
+        execute: async ({ key, maxChars }) => {
+            emitProgress({ type: 'fetch:start', label: 'Reading Zilo doc', detail: key });
+            const doc = await readZiloDocContent(key);
+            emitProgress({ type: 'fetch:end', label: 'Zilo doc ready', detail: doc.title });
+            return {
+                key: doc.key,
+                title: doc.title,
+                description: doc.description,
+                content: clampText(doc.content, maxChars ?? 6000),
+            };
+        },
+    }),
+    searchZiloDocs: tool({
+        description: 'Search local ZiloShift docs and return compact snippets. Prefer this before web search for ZiloShift product behavior.',
+        inputSchema: z.object({
+            query: z.string().min(2),
+            maxResults: z.number().int().min(1).max(8).optional(),
+        }),
+        execute: async ({ query, maxResults }) => {
+            emitProgress({ type: 'search:start', label: 'Searching Zilo docs', detail: query });
+            const terms = normalize(query).split(' ').filter((term) => term.length > 2);
+            const docs = await Promise.all(ziloDocs.map((doc) => readZiloDocContent(doc.key)));
+            const results = docs
+                .map((doc) => ({
+                key: doc.key,
+                title: doc.title,
+                description: doc.description,
+                score: scoreDoc(`${doc.title}\n${doc.description}\n${doc.content}`, terms),
+                snippet: createSnippet(doc.content, terms),
+            }))
+                .filter((doc) => doc.score > 0)
+                .sort((a, b) => b.score - a.score)
+                .slice(0, maxResults ?? 5)
+                .map(({ key, title, description, snippet }) => ({ key, title, description, snippet }));
+            emitProgress({ type: 'search:end', label: 'Zilo docs search complete', detail: `${results.length} match${results.length === 1 ? '' : 'es'}` });
+            return results;
+        },
+    }),
+};
+//# sourceMappingURL=zilo-docs.tool.js.map

package/dist/tools/zilo-docs.tool.js.map

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

package/install.ps1

@@ -0,0 +1,62 @@
+param(
+  [ValidateSet("github", "npm")]
+  [string]$Source = "github",
+  [string]$GitHubPackage = "github:zester4/zilo-manager",
+  [string]$NpmPackage = "zilmate",
+  [switch]$NoSetup,
+  [switch]$NoPing,
+  [switch]$NoTalk
+)
+
+$ErrorActionPreference = "Stop"
+
+function Require-Command($Name, $InstallHint) {
+  if (-not (Get-Command $Name -ErrorAction SilentlyContinue)) {
+    throw "$Name is required. $InstallHint"
+  }
+}
+
+function Invoke-Step($Label, $Command) {
+  Write-Host "`n$Label" -ForegroundColor Cyan
+  $program = $Command[0]
+  $arguments = @($Command | Select-Object -Skip 1)
+  & $program @arguments
+  if ($LASTEXITCODE -ne 0) {
+    throw "Command failed: $($Command -join ' ')"
+  }
+}
+
+Require-Command "node" "Install Node.js LTS from https://nodejs.org/."
+Require-Command "npm" "Install Node.js LTS from https://nodejs.org/."
+
+$target = if ($Source -eq "npm") { $NpmPackage } else { $GitHubPackage }
+Write-Host "Installing ZilMate from $target ..." -ForegroundColor Cyan
+npm install -g $target
+if ($LASTEXITCODE -ne 0) {
+  throw "ZilMate install failed."
+}
+
+Write-Host "`nZilMate installed. Checking command..." -ForegroundColor Green
+zilmate --help
+if ($LASTEXITCODE -ne 0) {
+  throw "ZilMate command check failed."
+}
+
+if (-not $NoSetup) {
+  Invoke-Step "Starting ZilMate setup..." @("zilmate", "setup")
+} else {
+  Write-Host "`nRun 'zilmate setup' later to create your .env file." -ForegroundColor Yellow
+}
+
+if (-not $NoPing) {
+  Invoke-Step "Verifying AI Gateway with zilmate ping..." @("zilmate", "ping")
+} else {
+  Write-Host "`nSkipping ping. Run 'zilmate ping' later to verify your key." -ForegroundColor Yellow
+}
+
+if (-not $NoTalk) {
+  Write-Host "`nStarting ZilMate talk. Type /exit to quit." -ForegroundColor Green
+  zilmate talk
+} else {
+  Write-Host "`nRun 'zilmate talk' when you are ready." -ForegroundColor Yellow
+}

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "zilmate",
+  "version": "1.0.0",
+  "description": "ZilMate CLI multi-agent assistant for ZiloShift workflows.",
+  "type": "module",
+  "main": "dist/server.js",
+  "types": "dist/server.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./cli": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "cli": "tsx src/index.ts",
+    "zilmate": "tsx src/index.ts",
+    "talk": "tsx src/index.ts talk",
+    "start": "node dist/index.js",
+    "models": "tsx src/index.ts models",
+    "doctor": "tsx src/index.ts doctor",
+    "config": "tsx src/index.ts config",
+    "memory": "tsx src/index.ts memory",
+    "triggers": "tsx src/index.ts triggers",
+    "test": "npm run build",
+    "prepare": "npm run build",
+    "pack:dry": "npm pack --dry-run",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ziloshift",
+    "zilmate",
+    "agents",
+    "ai-sdk",
+    "vercel-ai-gateway",
+    "cli"
+  ],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@composio/core": "^0.10.0",
+    "@composio/vercel": "^0.9.2",
+    "@tavily/core": "^0.7.5",
+    "@upstash/redis": "^1.38.0",
+    "ai": "^6.0.198",
+    "chalk": "^5.6.2",
+    "commander": "^15.0.0",
+    "dotenv": "^17.4.2",
+    "marked": "^15.0.12",
+    "marked-terminal": "^7.3.0",
+    "tsx": "^4.22.4",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.2",
+    "typescript": "^6.0.3"
+  },
+  "bin": {
+    "zilmate": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "src/doc",
+    "agent-docs.md",
+    "README.md",
+    ".env.example",
+    "install.ps1"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zester4/zilo-manager.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zester4/zilo-manager/issues"
+  },
+  "homepage": "https://github.com/zester4/zilo-manager#readme",
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/src/doc/README.md

@@ -0,0 +1,49 @@
+# ZiloShift Support Training Docs
+
+These docs train support staff to help workers and venues use ZiloShift confidently, safely, and consistently.
+
+## Who These Docs Are For
+
+- Customer support agents helping workers and venues.
+- Operations staff reviewing verification, payments, disputes, and shift issues.
+- Admin users handling SMS campaigns, account questions, and escalation.
+
+## Core Support Principles
+
+1. Protect user safety and money first.
+2. Verify the account, role, country, and shift before giving specific advice.
+3. Do not ask users to share passwords, full card details, full ID numbers, or private API keys.
+4. Explain next steps clearly and avoid blaming the user.
+5. Escalate when money, identity, fraud, safety, legal, or platform bugs are involved.
+
+## Platform Overview
+
+ZiloShift connects workers with venues that need shift cover. Workers create profiles, verify identity, add roles/certifications, browse shifts in their city, apply, get accepted, clock in/out, message venues, and receive payouts. Venues verify their business, connect payment/billing, post shifts, review applicants, accept workers, coordinate through messages, and confirm completion.
+
+## Support Areas
+
+- [Worker Support Playbook](./worker-support-playbook.md)
+- [Venue Support Playbook](./venue-support-playbook.md)
+- [Verification And Trust](./verification-and-trust.md)
+- [Payments And Payouts](./payments-and-payouts.md)
+- [Shift Lifecycle And Disputes](./shift-lifecycle-and-disputes.md)
+- [Admin Tools And SMS Campaigns](./admin-tools-and-sms-campaigns.md)
+- [Support Macros](./support-macros.md)
+- [Escalation Checklist](./escalation-checklist.md)
+
+## Quick Triage Questions
+
+Ask these before troubleshooting:
+
+1. Are you a worker or venue?
+2. What country are you in?
+3. What email or phone number is on the account?
+4. What page were you on when the issue happened?
+5. If it is about a shift, what is the role, date, venue/company, and city?
+6. If it is about payment, what provider was shown: Hubtel, Paystack, Razorpay, Stripe, or bank/card?
+7. What exact error message did you see?
+
+## Risk Warning
+
+Do not manually override identity verification, payment status, payout destination, worker reliability, cancellation penalties, or dispute outcomes unless an authorized admin or engineering escalation confirms it.
+

package/src/doc/admin-tools-and-sms-campaigns.md

@@ -0,0 +1,99 @@
+# Admin Tools And SMS Campaigns
+
+This guide trains admins to use campaign tools, verification queues, user management, shifts, payments, and disputes.
+
+## Admin SMS Campaigns
+
+SMS campaigns are for Ghana users through Hubtel SMS.
+
+Supported audiences:
+
+- Workers.
+- Venues.
+- Both workers and venues.
+
+The campaign tool should:
+
+1. Let admin choose audience.
+2. Preview real recipients.
+3. Show skipped users missing phone numbers.
+4. Send a test SMS before bulk sending.
+5. Send personalized batch SMS through Hubtel.
+6. Save campaign logs in `sms_campaigns`.
+
+## Hubtel SMS Contract
+
+The gateway follows Hubtel SMS docs:
+
+- Single test SMS: `POST /v1/messages/send`.
+- Personalized batch SMS: `POST /v1/messages/batch/personalized/send`.
+- Basic Auth is built from SMS credentials.
+- Sender ID max length is 11 characters.
+
+Supported variables:
+
+- `{{first_name}}`
+- `{{last_name}}`
+- `{{name}}`
+- `{{company_name}}`
+- `{{account_type}}`
+- `{{city}}`
+- `{{town}}`
+
+## SMS Troubleshooting
+
+If test SMS returns 400:
+
+- Check Hubtel error details.
+- Check phone format normalizes to `233...`.
+- Check sender ID is 11 characters or less.
+- Check message length is not too long.
+- Check SMS account credit.
+- Check if recipient is blacklisted.
+- Check SMS credentials.
+
+If no workers appear:
+
+- Check Ghana workers have profile phone numbers.
+- Workers without phone numbers are skipped.
+
+If venues appear but workers do not:
+
+- Venue phone may exist on `venues.phone`.
+- Worker phone must exist on `profiles.phone`.
+
+## Admin Verification Page
+
+Admins can review identity and business verification.
+
+Do not approve:
+
+- Mismatched names.
+- Blurry IDs.
+- Missing liveness.
+- Suspicious duplicate accounts.
+
+## Admin Payments Page
+
+Admins should use this for:
+
+- Captured payments.
+- Payout status.
+- Failed provider responses.
+- Refund checks.
+
+Never expose secret keys in admin notes or user replies.
+
+## Admin Disputes Page
+
+Admins should review:
+
+- Worker/venue claims.
+- Shift status.
+- Clock-in/out.
+- Messages.
+- Payment status.
+- Reliability/no-show history.
+
+Keep notes factual and timestamped.
+

package/src/doc/escalation-checklist.md

@@ -0,0 +1,97 @@
+# Escalation Checklist
+
+Use this checklist before escalating to engineering, operations, compliance, or payments.
+
+## Required Information
+
+- User type: worker or venue.
+- User email or phone.
+- Country.
+- City/town.
+- Page or feature.
+- Exact error message.
+- Time and date of issue.
+- Browser/device if relevant.
+- Screenshots if available.
+
+## Shift Escalation
+
+Include:
+
+- Shift role.
+- Shift date/time.
+- Venue/company name.
+- Worker name.
+- Application status.
+- Shift status.
+- Clock-in/out records.
+- Payment ID if available.
+
+## Verification Escalation
+
+Include:
+
+- Country.
+- Verification provider: Ghana/Hubtel or Didit.
+- Current status.
+- Whether front/back/liveness completed.
+- Whether account name matches ID name.
+- Any rejection reason.
+
+Do not include full ID number in normal support tickets.
+
+## Payment Escalation
+
+Include:
+
+- Provider: Hubtel, Paystack, Razorpay, Stripe.
+- Amount and currency.
+- Reference/checkout ID/payment ID.
+- User ID.
+- Shift ID if related.
+- Provider response.
+- Whether money was captured, pending, failed, refunded, or paid out.
+
+## SMS Escalation
+
+Include:
+
+- Audience: workers, venues, or both.
+- Test or batch.
+- Sender ID.
+- Normalized phone number.
+- Hubtel response details.
+- Gateway PM2 log line.
+- Whether account has SMS credit.
+
+## Fraud Or Abuse Escalation
+
+Escalate immediately if:
+
+- Duplicate accounts suspected.
+- Same ID used by multiple accounts.
+- Same payout account used by multiple unrelated workers.
+- Referral farming suspected.
+- Worker changes name around verification.
+- Venue asks users to pay off-platform.
+- Harassment, threats, unsafe venue, or unsafe worker behavior reported.
+
+## Engineering Escalation Format
+
+Use this format:
+
+```text
+Issue:
+User type:
+Country/city:
+User ID/email:
+Shift ID/payment ID:
+Expected behavior:
+Actual behavior:
+Exact error:
+Steps to reproduce:
+Logs/response:
+Impact:
+Urgency:
+```
+

package/src/doc/payments-and-payouts.md

@@ -0,0 +1,82 @@
+# Payments And Payouts
+
+Use this guide to support billing setup, shift payment, worker payout, profile promotion, and country-specific payment rails.
+
+## Payment Provider By Market
+
+- Ghana: Hubtel for checkout, SMS, worker payout, and Ghana-specific flows.
+- Nigeria, Kenya, South Africa: Paystack where configured.
+- India: Razorpay.
+- UK, US, and other markets: Stripe where configured.
+
+## Venue Billing
+
+Venues may need to connect billing before posting or paying for shifts.
+
+Ghana venue billing:
+
+- Uses Hubtel gateway `/api/checkout/initiate`.
+- Requires gateway `SUPABASE_SERVICE_ROLE_KEY` to be a real service_role key.
+- Requires Hubtel checkout credentials and account number.
+- Writes checkout/payment state into `payments`.
+
+Common errors:
+
+- `SUPABASE_SERVICE_ROLE_KEY must have role service_role, not anon`: gateway env uses anon key. Replace with Supabase service role key and restart PM2.
+- `Could not find worker_amount column`: live `payments` schema missing compatibility column. Add column and reload schema.
+- Upstream 500: check gateway PM2 logs and Hubtel response body.
+
+## Worker Payout
+
+Workers must have valid payout details before payout can complete.
+
+Ghana worker payout:
+
+- Mobile money or bank details.
+- Phone/account name should be verified where possible.
+- Hubtel sends money or bank transfer through gateway.
+
+Other markets:
+
+- Paystack recipients/subaccounts for supported African countries.
+- Razorpay fund accounts for India.
+- Stripe Connect for Stripe markets.
+
+## Profile Promotion
+
+Workers can pay to promote their profile for 7 days.
+
+Provider routing:
+
+- Ghana: Hubtel checkout.
+- Paystack countries: Paystack checkout.
+- India: Razorpay checkout.
+- Other markets: Stripe checkout.
+
+If profile promotion payment succeeds but profile is not promoted:
+
+- Check payment verification function for the provider.
+- Check `profile_promotions`.
+- Check `workers.promoted_until`.
+- Escalate if provider captured payment but app did not update.
+
+## Refunds And Disputes
+
+Do not promise refunds until status is confirmed.
+
+Escalate when:
+
+- Worker no-show.
+- Venue cancels after worker acceptance.
+- Worker cancels after acceptance.
+- Payment captured but shift canceled.
+- Duplicate charge.
+- Wrong amount.
+
+## Payment Safety Rules
+
+- Never ask users for full card numbers.
+- Never share service_role keys, API keys, Basic Auth tokens, or gateway tokens.
+- Never manually mark payment captured without provider evidence.
+- Always record provider, reference, amount, currency, and user ID in escalations.
+