FlueSession — prompt, skill, task, shell

// Plain text response
const response = await session.prompt('Summarize the codebase in 3 bullet points.');
console.log(response.text);

// Typed structured result
import * as v from 'valibot';
const { data } = await session.prompt('What is 2 + 2?', {
  result: v.object({ answer: v.number() }),
});
console.log(data.answer); // 4

// Reference by frontmatter name
const { data } = await session.skill('triage', {
  args: { issueNumber: 42 },
  result: v.object({
    severity: v.picklist(['low', 'medium', 'high', 'critical']),
    reproducible: v.boolean(),
  }),
});

// Reference by relative path
await session.skill('triage/reproduce.md', { args: { issueNumber: 42 } });

const research = await session.task(
  'Research the auth flow and summarize the key files.',
  { cwd: '/workspace/project', role: 'researcher' }
);

const plan = await session.prompt(
  `Use this research to draft the implementation plan:\n\n${research.text}`
);

const { stdout, exitCode } = await session.shell('git log --oneline -5');

await session.compact();

await session.delete();