Araç tanımlama

import { defineSchema, defineTool } from "@pactmark/agent";
import { z } from "zod";

const input = defineSchema({
  id: "billing.invoice.lookup.input",
  semanticRevision: "1",
  schema: z.object({ invoiceId: z.string().regex(/^INV-\d{6}$/) }).strict(),
});

const output = defineSchema({
  id: "billing.invoice.lookup.output",
  semanticRevision: "1",
  schema: z
    .object({
      invoiceId: z.string(),
      status: z.enum(["draft", "issued", "paid", "void"]),
      totalMinor: z.number().int().nonnegative(),
      currency: z.string().regex(/^[A-Z]{3}$/),
    })
    .strict(),
});

export const lookupInvoice = defineTool({
  id: "billing.invoice-lookup@1",
  implementationVersion: "1.2.0",
  description: "Read one invoice by identifier from the billing service.",
  input,
  output,
  security: {
    riskClass: "R1",
    dataClasses: ["confidential"],
    reversibility: "not_applicable",
    requiredScopes: ["billing:invoice:read"],
    egress: {
      mode: "allowlist",
      destinations: ["https://billing.internal.example.com"],
      methods: ["GET"],
      credentialSlots: ["billing.api"],
    },
    networkEnforcement: "required",
    maxCallsPerRun: 8,
    timeoutMs: 4_000,
    costCeiling: 0,
  },
  operation: {
    kind: "read",
    async execute({ invoiceId }, context) {
      const response = await context.egress.fetch(
        `https://billing.internal.example.com/v1/invoices/${invoiceId}`,
        { method: "GET" },
      );
      if (!response.ok) throw new Error(`billing_lookup_failed_${response.status}`);
      return response.json();
    },
  },
});

// Yanlış: sonraki adıma hedefin karar vermesi.
const { nextAction } = await response.json();
await doWhatever(nextAction);

// Doğru: tipli veri döndürün ve kararı politikaya bırakın.
return { invoiceId, status, totalMinor, currency };

import { FakeToolExecutor, ScenarioBuilder } from "@pactmark/testing";

// En azından şunları kapsayın:
// - mutlu yol
// - hatalı biçimli girdi (KAF_SCHEMA_INVALID)
// - grant olmadan politika reddi (KAF_POLICY_DENIED)
// - maxCallsPerRun aşımı
// - bir zaman aşımı ve koşunun bundan sonra ne yaptığı
// - kayıt sapması: aynı sürüm, değişmiş şema