Use another framework

Last updated on

npm install @paradoc/ai-tools

import { executeFill, executeGetFillState, executeRender } from "@paradoc/ai-tools"

const config = { defaultRegistryUrl: "https://public.paradoc.dev" }
const source = { source: "registry", artifact_name: "pet-addendum" } as const

const draft = await executeFill(
  {
    ...source,
    data: {
      fields: { petName: "Rex", species: "dog", weight: 30, isVaccinated: true },
      parties: { tenant: { name: "Jane Doe" } },
    },
  },
  config,
)
if (!draft.accepted) throw new Error(draft.error?.message)

const state = await executeGetFillState(
  { ...source, data: draft.data, evaluation_context: draft.evaluation_context },
  config,
)
console.log(state.next) // { kind: "party", key: "landlord", required: true, order: 1 }

const preview = await executeRender(
  { ...source, data: draft.data, evaluation_context: draft.evaluation_context, layer: "markdown" },
  config,
)
console.log(preview.content)

import {
  boundModelValue,
  configForExecution,
  operationNames,
  toolDefinitions,
  type ParadocToolsConfig,
} from "@paradoc/ai-tools"
import { z } from "zod"

export function myFrameworkTools(config?: ParadocToolsConfig) {
  return operationNames.map((name) => {
    const definition = toolDefinitions[name]
    return {
      name: definition.name,
      description: definition.description,
      parameters: z.toJSONSchema(definition.input_schema, { io: "input" }),
      async execute(input: unknown, signal?: AbortSignal) {
        // Join the framework's abort signal to the configured ones.
        const output = await definition.execute(input as never, configForExecution(config, signal))
        // Your code keeps the full result. The model gets a bounded copy.
        return { output, forModel: boundModelValue(output, config?.maxOutputBytes) }
      },
    }
  })
}