import type { Subsection } from "#types/document.types";

export const TOOL_SUBSECTION: Subsection = {
    blocks: [
        {
            keywords: [
                { description: "An alias for READ_RESOURCE", example: 'READ "<file>" INTO <content>', name: "READ" },
                { description: "An alias for PERSIST_ARTIFACT", example: "WRITE <content> TO <file>", name: "WRITE" },
                {
                    description: "An alias for PERSIST_ARTIFACT over a span",
                    example: 'EDIT <file> WITH before: "<span>", after: "<span>"',
                    name: "EDIT",
                },
                {
                    description: "An alias for DISCOVER_RESOURCES",
                    example: 'GLOB "<pattern>" INTO <files>',
                    name: "GLOB",
                },
                {
                    description: "An alias for SEARCH_CONTENT",
                    example: 'GREP "<term>" IN <scope> INTO <matches>',
                    name: "GREP",
                },
                {
                    description: "An alias for EXECUTE_TOOL",
                    example: 'BASH "<command>" WITH timeout: <bound>',
                    name: "BASH",
                },
                {
                    description: "An alias for READ_RESOURCE over a remote address",
                    example: 'WEB_FETCH "<address>" INTO <content>',
                    name: "WEB_FETCH",
                },
                {
                    description: "An alias for DISCOVER_RESOURCES over the web",
                    example: 'WEB_SEARCH "<query>" INTO <hits>',
                    name: "WEB_SEARCH",
                },
                {
                    description: "An alias for DELEGATE to a bounded reader",
                    example: 'TASK "<objective>" WITH agent: <role> -> <result>',
                    name: "TASK",
                },
                {
                    description: "An alias for REQUEST_DECISION",
                    example: 'ASK_USER "<question>" WITH options: [<a>, <b>]',
                    name: "ASK_USER",
                },
            ],
            kind: "keyword",
        },
    ],
    content:
        "One adapter's alias table, shown as an instance of a binding rather than as grammar. The grammar carries no tool name: a document names the operation, and the binding for a harness maps its short forms to the operation and the operation to whichever tool performs it there. Another harness ships another table and the document does not change.",
    title: "An adapter's aliases",
};