Quickstart

import { anthropic } from '@ai-sdk/anthropic';
import { GrepticonClient } from '@grepticon/sdk';
import { createVfsTools } from '@grepticon/sdk/ai-sdk';
import { generateText } from 'ai';

// Authenticate with your grp_sk_ management key. baseUrl defaults to
// https://api.grepticon.com; pass it only to point at a self-hosted server.
const client = new GrepticonClient({
  apiKey: process.env.GREPTICON_API_KEY ?? '',
});

const workspace = 'handbook';

// Create a workspace (or make one in the console under Workspaces).
await client.workspaces.create(workspace);

// Push a file. Uploads are SDK/API-only and ingest asynchronously — the call
// returns immediately with status 'pending'.
await client.files.upload(
  workspace,
  'guides/onboarding.md',
  '# Onboarding\n\nNew hires finish account setup on day one.\n',
  { contentType: 'text/markdown' },
);

// Wait for ingestion before reading. waitForReady resolves once the targeted
// paths are 'ready' or 'error', and only throws on timeout — so check each
// returned entry for an ingest failure yourself.
const [file] = await client.files.waitForReady(workspace, {
  paths: ['guides/onboarding.md'],
});
if (file?.status === 'error') {
  throw new Error(`Ingestion failed: ${file.errorDetail ?? 'unknown error'}`);
}

// Mint a scoped, read-only grp_at_ token for the agent session. The default
// claims (['*']) see every file; narrow them once you start using visibility.
const { token } = await client.tokens.mint(workspace, { ttlSeconds: 600 });

// Read AS the token. client.session() reads with the credential THIS client
// holds (your grp_sk_ key) — it does not pick up the minted token. Build a
// second client keyed by the token to read with the token's claims.
const session = new GrepticonClient({ apiKey: token }).session(workspace);

// Hand the four read tools (ls / find / cat / grep) to the agent.
const { text } = await generateText({
  model: anthropic('claude-sonnet-5'),
  tools: createVfsTools(session),
  prompt: 'When do new hires finish account setup?',
});

console.log(text);