@finalai/agents 0.10.0 → 0.12.0

package/examples/release-scout/agent/tools/lookup_release_notes.ts

@@ -1,24 +0,0 @@
-import { defineTool } from '@finalai/agents';
-import { never } from '@finalai/agents/approval';
-import * as z from 'zod';
-
-const releaseSchema = z.object({ body: z.string().nullable(), published_at: z.string() });
-
-export default defineTool({
-  description: 'Fetch the release notes for a version tag.',
-  inputSchema: z.object({ tag: z.string().regex(/^\d+\.\d+\.\d+$/) }),
-  approval: never(),
-  async execute({ tag }, ctx) {
-    const token = await ctx.secrets.get('github-token');
-    if (token == null) throw new Error('Missing secret github-token');
-    const res = await fetch(`https://api.github.com/repos/final/app/releases/tags/v${tag}`, {
-      headers: { authorization: `Bearer ${token}` },
-      signal: ctx.abortSignal,
-    });
-    const text = await res.text();
-    if (res.status === 404) return { found: false };
-    if (!res.ok) throw new Error(`Release notes request failed (${res.status})`);
-    const { body, published_at } = releaseSchema.parse(JSON.parse(text));
-    return { found: true, publishedAt: published_at, notes: body ?? '' };
-  },
-});

package/examples/release-scout/client.ts

@@ -1,122 +0,0 @@
-import {
-  createClient,
-  sessionUpdateOf,
-  textOf,
-  type AgentClientIface,
-} from '@finalai/agents/client';
-import 'zod/compile';
-
-export const directSession = async (client: AgentClientIface, signal?: AbortSignal) => {
-  const { handle, response } = await client.sessions.create({
-    agent: 'release-scout',
-    message: 'Did 2.4.1 ship?',
-    signal,
-  });
-  try {
-    if (response == null) throw new Error('The initial message must create a response');
-    for await (const event of response.stream({ signal })) {
-      const update = sessionUpdateOf(event);
-      if (update?.sessionUpdate === 'agent_message_chunk') process.stdout.write(textOf(update));
-      if (event.decisionId != null) console.log('Awaiting a decision:', event.decisionId);
-    }
-    console.log((await response.result({ signal })).stopReason);
-    await handle.observe('The release was moved to Friday.', { signal });
-    return await handle.manifest({ signal });
-  } finally {
-    // Close cleanup has its own lifetime, even when the prompt was aborted.
-    await handle.close();
-  }
-};
-
-// The source must be idle on a harness with native forks, such as remote Claude Code.
-export const forkNativeSession = (
-  client: AgentClientIface,
-  args: {
-    sourceSessionId: string;
-    idempotencyKey: string;
-    signal?: AbortSignal;
-  },
-) =>
-  client.sessions.attach(args.sourceSessionId).fork({
-    idempotencyKey: args.idempotencyKey,
-    title: 'Alternative investigation',
-    signal: args.signal,
-  });
-
-export const directConversation = async (client: AgentClientIface, signal?: AbortSignal) => {
-  const direct = await client.conversations.direct({ agent: 'release-scout', signal });
-  const sent = await direct.send('Did 2.4.1 ship?', { signal });
-  // Durable delivery receipts also cover blank replies and a turn completed before subscribe.
-  for (const delivery of sent.deliveries) {
-    if (delivery.sessionId == null || delivery.turnId == null) continue;
-    const session = client.sessions.attach(delivery.sessionId);
-    const response = await session.response(delivery.turnId, { signal });
-    for await (const event of response.stream({ signal })) {
-      const update = sessionUpdateOf(event);
-      if (update?.sessionUpdate === 'agent_message_chunk') process.stdout.write(textOf(update));
-      if (event.decisionId != null) console.log('Decision required:', event.decisionId);
-    }
-    console.log((await response.result({ signal })).stopReason);
-  }
-  const page = await direct.messages({ limit: 50, signal });
-  const last = page.messages.at(-1);
-  if (last != null) await direct.markRead({ throughSeq: last.seq }, { signal });
-  return direct;
-};
-
-export const groupConversation = async (
-  client: AgentClientIface,
-  userId: string,
-  signal?: AbortSignal,
-) => {
-  const group = await client.conversations.create({
-    kind: 'group',
-    title: '#releases',
-    signal,
-    participants: [{ user: userId }, { agent: 'release-scout', routingMode: 'default' }],
-  });
-  const bot = await group.addParticipant(
-    { agent: 'deploy-bot', routingMode: 'mention' },
-    { signal },
-  );
-  await group.send('Go ahead with the release.', { mentions: [bot.id], signal });
-  return group;
-};
-
-export const publish = async (client: AgentClientIface, signal?: AbortSignal) => {
-  const report = await client.definitions.compatibility({
-    definition: 'release-scout',
-    harness: '@finalai/final-agent-provider/harnesses/serverless-pi',
-    signal,
-  });
-  const revision = await client.definitions.publish({
-    definition: 'release-scout',
-    ref: 'main',
-    signal,
-  });
-  return { report, revision, guides: await client.computerSetupGuides.list({ signal }) };
-};
-
-export const connect = (args: { host: string; apiKey: string }) =>
-  createClient({
-    host: args.host,
-    auth: { apiKey: args.apiKey },
-    headers: () => ({ 'x-request-source': 'release-scout-example' }),
-  });
-
-// Called by an external job after its work finishes; repeat the same event id on retry.
-export const postBuildResult = async (args: {
-  client: AgentClientIface;
-  conversationId: string;
-  runId: string;
-  text: string;
-  signal?: AbortSignal;
-}) =>
-  args.client.conversations.get(args.conversationId).postEvent(
-    {
-      source: { id: 'release-build', name: 'Release build' },
-      eventId: `${args.runId}:completed`,
-      text: args.text,
-    },
-    { signal: args.signal },
-  );