@surph_ai/cli 0.0.1 → 0.0.4

package/cli.js

@@ -17,6 +17,7 @@ const AdmZip = require('adm-zip')
 // const auth = require('./auth')
 const deploy = require('./deploy')
 const scaffold = require('./scaffold')
+const { ensureChat } = require('./toolserver/ensure-chat')
 const utils = require('./utils')
 const packageJson = require('./package.json')
 
@@ -151,7 +152,7 @@ program.command('toolserver')
 .description('run tool server')
 .action(async (cmd, options) => {
   try {
-    shell.exec('nodemon --quiet ./node_modules/@surph_ai/sdk/toolserver/app')
+    shell.exec('nodemon --quiet ./node_modules/@surph_ai/cli/toolserver/app')
   } catch (error) {
     utils.printError(error)
   }
@@ -161,7 +162,11 @@ program.command('chatserver')
 .description('run chat server')
 .action(async (cmd, options) => {
   try {
-    shell.exec('nodemon --quiet ./node_modules/@surph_ai/sdk/toolserver/chat')
+    const chatPath = await ensureChat({
+      cliVersion: VERSION,
+      log: (msg) => console.log(colors.cyan(`\n${msg}\n`))
+    })
+    shell.exec(`nodemon --quiet "${chatPath}"`)
   } catch (error) {
     utils.printError(error)
   }

package/deploy/index.js

@@ -86,7 +86,7 @@ const zipDirectory = (name = 'package.zip') => {
 
 const compile = async (deployDir, name = 'package.zip', dir = null) => {
   shell.mkdir('-p', `${deployDir}/`)
-  shell.cp('-R', `node_modules/@surph_ai/sdk/deploy/tool-handler.js`, `${deployDir}/main.js`)
+  shell.cp('-R', `node_modules/@surph_ai/cli/deploy/tool-handler.js`, `${deployDir}/main.js`)
 
   if (dir === null) {
     shell.cp('-R', '!(node_modules|deploy)', `${deployDir}/`) // copy everything but node_modules and deploy

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@surph_ai/cli",
-  "version": "0.0.1",
+  "version": "0.0.4",
   "description": "",
   "main": "index.js",
   "types": "./types.d.ts",

package/toolserver/app.js

@@ -4,7 +4,7 @@ const vinely = require('@vinely-ai/sdk')
 const app = express()
 
 vinely.configureApp(app, {
-  views: 'node_modules/@surph_ai/sdk/toolserver/templates',
+  views: 'node_modules/@surph_ai/cli/toolserver/templates',
   static: 'public',
 })
 

package/toolserver/ensure-chat.js

@@ -0,0 +1,133 @@
+const crypto = require('crypto')
+const fs = require('fs')
+const os = require('os')
+const path = require('path')
+
+const MANIFEST_URL = 'https://surph.s3.us-east-1.amazonaws.com/tools/cli/manifest.json'
+const CHAT_URL = 'https://surph.s3.us-east-1.amazonaws.com/tools/cli/chat.js'
+const CACHE_DIR = path.join(os.homedir(), '.surph', 'cache')
+const CACHE_FILE = path.join(CACHE_DIR, 'chat.js')
+const CACHE_META = path.join(CACHE_DIR, 'chat.meta.json')
+const BUNDLED_FALLBACK = path.join(__dirname, 'chat.js')
+
+const parseVersion = (value) => String(value || '0').split('.').map((part) => {
+  const n = parseInt(part, 10)
+  return Number.isFinite(n) ? n : 0
+})
+
+const isCliTooOld = (cliVersion, minCliVersion) => {
+  const current = parseVersion(cliVersion)
+  const required = parseVersion(minCliVersion)
+  const length = Math.max(current.length, required.length)
+  for (let i = 0; i < length; i++) {
+    const a = current[i] || 0
+    const b = required[i] || 0
+    if (a < b) return true
+    if (a > b) return false
+  }
+  return false
+}
+
+const sha256 = (buf) => crypto.createHash('sha256').update(buf).digest('hex')
+
+const readJsonFile = (filepath) => {
+  try {
+    return JSON.parse(fs.readFileSync(filepath, 'utf8'))
+  } catch {
+    return null
+  }
+}
+
+const cacheMatches = (manifest) => {
+  const meta = readJsonFile(CACHE_META)
+  if (!meta || meta.sha256 !== manifest.sha256) return false
+  if (!fs.existsSync(CACHE_FILE)) return false
+  if (manifest.size) {
+    const { size } = fs.statSync(CACHE_FILE)
+    if (size !== manifest.size) return false
+  }
+  return true
+}
+
+const fetchManifest = async () => {
+  const resp = await fetch(MANIFEST_URL, {
+    cache: 'no-store',
+    headers: { Accept: 'application/json' }
+  })
+  if (!resp.ok) {
+    throw new Error(`Failed to fetch chat server manifest (${resp.status})`)
+  }
+  const manifest = await resp.json()
+  if (!manifest || typeof manifest.sha256 !== 'string' || manifest.sha256.length !== 64) {
+    throw new Error('Invalid chat server manifest')
+  }
+  return manifest
+}
+
+const downloadChat = async (manifest) => {
+  const resp = await fetch(CHAT_URL, { cache: 'no-store' })
+  if (!resp.ok) {
+    throw new Error(`Failed to download chat server (${resp.status})`)
+  }
+
+  const buf = Buffer.from(await resp.arrayBuffer())
+  if (manifest.size && buf.length !== manifest.size) {
+    throw new Error(`Chat server size mismatch (expected ${manifest.size}, got ${buf.length})`)
+  }
+
+  const hash = sha256(buf)
+  if (hash !== manifest.sha256) {
+    throw new Error('Chat server checksum mismatch')
+  }
+
+  fs.mkdirSync(CACHE_DIR, { recursive: true, mode: 0o700 })
+  const tmp = `${CACHE_FILE}.tmp`
+  fs.writeFileSync(tmp, buf, { mode: 0o600 })
+  fs.renameSync(tmp, CACHE_FILE)
+  fs.writeFileSync(CACHE_META, JSON.stringify(manifest, null, 2) + '\n', { mode: 0o600 })
+}
+
+const fallbackPath = () => {
+  if (fs.existsSync(CACHE_FILE)) return CACHE_FILE
+  if (fs.existsSync(BUNDLED_FALLBACK)) return BUNDLED_FALLBACK
+  return null
+}
+
+const ensureChat = async ({ cliVersion, log } = {}) => {
+  let manifest
+  try {
+    manifest = await fetchManifest()
+  } catch (error) {
+    const fallback = fallbackPath()
+    if (fallback) {
+      if (log) log('Using cached chat server (offline).')
+      return fallback
+    }
+    throw error
+  }
+
+  if (manifest.minCliVersion && isCliTooOld(cliVersion, manifest.minCliVersion)) {
+    throw new Error(
+      `Chat server requires CLI ${manifest.minCliVersion} or newer (current: ${cliVersion}). Update with: npm i -D @surph_ai/cli@latest`
+    )
+  }
+
+  if (cacheMatches(manifest)) {
+    return CACHE_FILE
+  }
+
+  if (log) log('Downloading latest chat server...')
+  try {
+    await downloadChat(manifest)
+    return CACHE_FILE
+  } catch (error) {
+    const fallback = fallbackPath()
+    if (fallback) {
+      if (log) log('Download failed, using cached chat server.')
+      return fallback
+    }
+    throw error
+  }
+}
+
+module.exports = { ensureChat }

package/types.d.ts

@@ -1,73 +0,0 @@
-// Type definitions for @surph_ai/sdk
-// These describe the runtime contract the tool server hands to each tool's default export.
-
-export type OAuthProvider = 'google' | 'github' | (string & {});
-
-export interface GoogleOAuth {
-  accessToken: string;
-  refreshToken?: string;
-  /** ISO-8601 timestamp for when accessToken expires. */
-  expiresAt: string;
-  /** OAuth scopes granted by the user. */
-  scopes: string[];
-  /** ISO-8601 timestamp for when the user first connected the provider. */
-  connectedAt: string;
-}
-
-export interface UserOAuth {
-  google?: GoogleOAuth;
-  [provider: string]: unknown;
-}
-
-export interface UserAuth {
-  type: OAuthProvider;
-  /** Provider-issued stable identifier for the user (e.g. Google 'sub'). */
-  id: string;
-}
-
-export interface User {
-  _id: string;
-  firstName?: string;
-  lastName?: string;
-  email: string;
-  username: string;
-  avatar?: string;
-  tags?: string[];
-  following?: string[];
-  notifications?: unknown[];
-  type?: 'claimed' | 'anonymous' | (string & {});
-  auth?: UserAuth;
-  timestamp?: string;
-  lastVisit?: string;
-  identifiers?: string[];
-  tools?: string[];
-  oauth?: UserOAuth;
-}
-
-/**
- * Per-invocation context. Currently opaque — populated by the caller (chat
- * server, deployed harness, etc.). Cast to a more specific shape inside the
- * tool if you know what your caller sends.
- */
-export type ToolContext = Record<string, unknown> | null;
-
-export interface ToolHandlerInput<TArgs = Record<string, unknown>> {
-  args: TArgs;
-  context: ToolContext;
-  user: User;
-}
-
-export type ToolHandler<
-  TArgs = Record<string, unknown>,
-  TResult = unknown,
-> = (input: ToolHandlerInput<TArgs>) => Promise<TResult> | TResult;
-
-export interface Surph {
-  fetchUser(username: string): Promise<User>;
-  fetchContext(slug: string | ToolContext): Promise<unknown>;
-  searchContext(ctxSlug: string, query: string): Promise<unknown>;
-  search(query: string, ctxSlug?: string | null): Promise<unknown>;
-  toolHandler(tool: string, args?: Record<string, unknown>): Promise<unknown>;
-}
-
-export declare const surph: Surph;