openplanter 0.1.0

package/dist/tool-defs.js

@@ -0,0 +1,1029 @@
+/**
+ * Provider-neutral tool definitions for the OpenPlanter agent.
+ *
+ * Single source of truth for tool schemas. Converter helpers produce the
+ * provider-specific shapes expected by OpenAI and Anthropic APIs.
+ */
+// ---------------------------------------------------------------------------
+// Tool definitions
+// ---------------------------------------------------------------------------
+export const TOOL_DEFINITIONS = [
+    {
+        name: "list_files",
+        description: "List files in the workspace directory. Optionally filter with a glob pattern.",
+        parameters: {
+            type: "object",
+            properties: {
+                glob: {
+                    type: "string",
+                    description: "Optional glob pattern to filter files.",
+                },
+            },
+            required: [],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "search_files",
+        description: "Search file contents in the workspace for a text or regex query.",
+        parameters: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Text or regex to search for.",
+                },
+                glob: {
+                    type: "string",
+                    description: "Optional glob pattern to restrict which files are searched.",
+                },
+            },
+            required: ["query"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "repo_map",
+        description: "Build a lightweight map of source files and symbols to speed up code navigation.",
+        parameters: {
+            type: "object",
+            properties: {
+                glob: {
+                    type: "string",
+                    description: "Optional glob pattern to limit which files are scanned.",
+                },
+                max_files: {
+                    type: "integer",
+                    description: "Maximum number of files to scan (1-500, default 200).",
+                },
+            },
+            required: [],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "web_search",
+        description: "Search the web using the Exa API. Returns URLs, titles, and optional page text.",
+        parameters: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Web search query string.",
+                },
+                num_results: {
+                    type: "integer",
+                    description: "Number of results to return (1-20, default 10).",
+                },
+                include_text: {
+                    type: "boolean",
+                    description: "Whether to include page text in results.",
+                },
+            },
+            required: ["query"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "fetch_url",
+        description: "Fetch and return the text content of one or more URLs.",
+        parameters: {
+            type: "object",
+            properties: {
+                urls: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "List of URLs to fetch.",
+                },
+            },
+            required: ["urls"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "read_file",
+        description: "Read the contents of a file in the workspace. Lines are numbered LINE:HASH|content by default for use with hashline_edit. Set hashline=false for plain N|content.",
+        parameters: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "Relative or absolute path within the workspace.",
+                },
+                hashline: {
+                    type: "boolean",
+                    description: "Prefix each line with LINE:HASH| format for content verification. Default true.",
+                },
+            },
+            required: ["path"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "write_file",
+        description: "Create or overwrite a file in the workspace with the given content.",
+        parameters: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "Relative path for the file.",
+                },
+                content: {
+                    type: "string",
+                    description: "Full file content to write.",
+                },
+            },
+            required: ["path", "content"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "apply_patch",
+        description: "Apply a Codex-style patch to one or more files. " +
+            "Use the *** Begin Patch / *** End Patch format with " +
+            "Update File, Add File, and Delete File operations.",
+        parameters: {
+            type: "object",
+            properties: {
+                patch: {
+                    type: "string",
+                    description: "The full patch block in Codex patch format.",
+                },
+            },
+            required: ["patch"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "edit_file",
+        description: "Replace a specific text span in a file. Provide the exact old text " +
+            "to find and the new text to replace it with. The old text must appear " +
+            "exactly once in the file.",
+        parameters: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "Relative path to the file to edit.",
+                },
+                old_text: {
+                    type: "string",
+                    description: "The exact text to find and replace.",
+                },
+                new_text: {
+                    type: "string",
+                    description: "The replacement text.",
+                },
+            },
+            required: ["path", "old_text", "new_text"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "hashline_edit",
+        description: "Edit a file using hash-anchored line references from read_file(hashline=true). " +
+            "Operations: set_line (replace one line), replace_lines (replace a range), " +
+            "insert_after (insert new lines after an anchor).",
+        parameters: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "Relative path to the file.",
+                },
+                edits: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            set_line: {
+                                type: "string",
+                                description: "Anchor 'N:HH' for single-line replace.",
+                            },
+                            replace_lines: {
+                                type: "object",
+                                description: "Range with 'start' and 'end' anchors.",
+                                properties: {
+                                    start: { type: "string" },
+                                    end: { type: "string" },
+                                },
+                                required: ["start", "end"],
+                                additionalProperties: false,
+                            },
+                            insert_after: {
+                                type: "string",
+                                description: "Anchor 'N:HH' to insert after.",
+                            },
+                            content: {
+                                type: "string",
+                                description: "New content for the operation.",
+                            },
+                        },
+                        required: [],
+                        additionalProperties: false,
+                    },
+                    description: "Edit operations: set_line, replace_lines, or insert_after.",
+                },
+            },
+            required: ["path", "edits"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "run_shell",
+        description: "Execute a shell command from the workspace root and return its output.",
+        parameters: {
+            type: "object",
+            properties: {
+                command: {
+                    type: "string",
+                    description: "Shell command to execute.",
+                },
+                timeout: {
+                    type: "integer",
+                    description: "Timeout in seconds for this command (default: agent default, max: 600).",
+                },
+            },
+            required: ["command"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "run_shell_bg",
+        description: "Start a shell command in the background. Returns a job ID to check or kill later.",
+        parameters: {
+            type: "object",
+            properties: {
+                command: {
+                    type: "string",
+                    description: "Shell command to run in the background.",
+                },
+            },
+            required: ["command"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "check_shell_bg",
+        description: "Check the status and output of a background job started with run_shell_bg.",
+        parameters: {
+            type: "object",
+            properties: {
+                job_id: {
+                    type: "integer",
+                    description: "The job ID returned by run_shell_bg.",
+                },
+            },
+            required: ["job_id"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "kill_shell_bg",
+        description: "Kill a background job started with run_shell_bg.",
+        parameters: {
+            type: "object",
+            properties: {
+                job_id: {
+                    type: "integer",
+                    description: "The job ID returned by run_shell_bg.",
+                },
+            },
+            required: ["job_id"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "think",
+        description: "Record an internal planning thought. Use this to reason about the task before acting.",
+        parameters: {
+            type: "object",
+            properties: {
+                note: {
+                    type: "string",
+                    description: "Your planning thought or reasoning note.",
+                },
+            },
+            required: ["note"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "subtask",
+        description: "Spawn a recursive sub-agent to solve a smaller sub-problem. The result is returned as an observation.",
+        parameters: {
+            type: "object",
+            properties: {
+                objective: {
+                    type: "string",
+                    description: "Clear objective for the sub-agent to accomplish.",
+                },
+                model: {
+                    type: "string",
+                    description: "Optional model for subtask (e.g. 'claude-sonnet-4-5-20250929', 'claude-haiku-4-5-20251001').",
+                },
+                reasoning_effort: {
+                    type: "string",
+                    enum: ["xhigh", "high", "medium", "low"],
+                    description: "Optional reasoning effort for the subtask model. For OpenAI codex models, this controls the delegation level.",
+                },
+                acceptance_criteria: {
+                    type: "string",
+                    description: "Acceptance criteria for judging the subtask result. A lightweight judge evaluates the result against these criteria and appends PASS/FAIL to your observation. Be specific and verifiable.",
+                },
+            },
+            required: ["objective", "acceptance_criteria"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "execute",
+        description: "Hand an atomic sub-problem to a leaf executor agent with full tool access. " +
+            "Use this when the sub-problem requires no further decomposition and can be " +
+            "solved directly (e.g. write a file, run tests, apply a patch). The executor " +
+            "has no subtask or execute tools — it must solve the objective in one pass.",
+        parameters: {
+            type: "object",
+            properties: {
+                objective: {
+                    type: "string",
+                    description: "Clear, specific objective for the executor to accomplish.",
+                },
+                acceptance_criteria: {
+                    type: "string",
+                    description: "Acceptance criteria for judging the executor result. A lightweight judge evaluates the result against these criteria and appends PASS/FAIL to your observation. Be specific and verifiable.",
+                },
+            },
+            required: ["objective", "acceptance_criteria"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "list_artifacts",
+        description: "List artifacts from previous subagent runs. Returns ID, objective, and result summary for each.",
+        parameters: {
+            type: "object",
+            properties: {},
+            required: [],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "read_artifact",
+        description: "Read a previous subagent's conversation log artifact. " +
+            "Returns JSONL records of the subagent's full conversation.",
+        parameters: {
+            type: "object",
+            properties: {
+                artifact_id: {
+                    type: "string",
+                    description: "Artifact ID from list_artifacts.",
+                },
+                offset: {
+                    type: "integer",
+                    description: "Start line (0-indexed). Default 0.",
+                },
+                limit: {
+                    type: "integer",
+                    description: "Max lines to return. Default 100.",
+                },
+            },
+            required: ["artifact_id"],
+            additionalProperties: false,
+        },
+    },
+    // -------------------------------------------------------------------------
+    // Domain-specific tools (Australian insider-trading investigation toolkit)
+    // -------------------------------------------------------------------------
+    {
+        name: "aph_holdings",
+        description: "Scrape the Australian Parliament House Register of Members' / Senators' " +
+            "Interests to extract politician shareholdings and financial interests.",
+        parameters: {
+            type: "object",
+            properties: {
+                member: {
+                    type: "string",
+                    description: "Member name to filter (case-insensitive substring), or 'all' (default).",
+                },
+                chamber: {
+                    type: "string",
+                    enum: ["house", "senate", "both"],
+                    description: "Which chamber to scrape (default: both).",
+                },
+                cache_dir: {
+                    type: "string",
+                    description: "Directory to cache fetched pages (optional).",
+                },
+                test: {
+                    type: "boolean",
+                    description: "Run in test mode with embedded sample data (no network).",
+                },
+            },
+            required: [],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "asx_parser",
+        description: "Parse ASX announcements (Appendix 3Y director trades, 4C cashflow reports, " +
+            "trading halts) from HTML or PDF into structured JSON.",
+        parameters: {
+            type: "object",
+            properties: {
+                input: {
+                    type: "string",
+                    description: "Path or URL to the announcement file (HTML or PDF).",
+                },
+                type: {
+                    type: "string",
+                    enum: ["3y", "4c", "halt", "auto"],
+                    description: "Announcement type (default: auto-detect).",
+                },
+                test: {
+                    type: "boolean",
+                    description: "Run built-in test mode with sample data.",
+                },
+            },
+            required: [],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "entity_resolver",
+        description: "Fuzzy entity matching and normalization for Australian politicians, " +
+            "ASX companies, directors, ABNs and tickers. Supports normalize, match, and resolve modes.",
+        parameters: {
+            type: "object",
+            properties: {
+                mode: {
+                    type: "string",
+                    enum: ["normalize", "match", "resolve"],
+                    description: "Operation mode: normalize (clean names), match (find best matches), resolve (cluster duplicates).",
+                },
+                input: {
+                    type: "string",
+                    description: "Path to JSON file containing entities to process.",
+                },
+                reference: {
+                    type: "string",
+                    description: "Path to JSON file with reference entities (required for match mode).",
+                },
+                threshold: {
+                    type: "integer",
+                    description: "Fuzzy match score threshold 0-100 (default: 80).",
+                },
+                test: {
+                    type: "boolean",
+                    description: "Run built-in self-test with sample Australian data.",
+                },
+            },
+            required: [],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "hotcopper_scraper",
+        description: "Scrape HotCopper stock forum for posts related to an ASX ticker. " +
+            "Extracts sentiment, rumor flags, and post metadata for investigation.",
+        parameters: {
+            type: "object",
+            properties: {
+                ticker: {
+                    type: "string",
+                    description: "ASX ticker symbol (e.g. BHP, CBA, RIO).",
+                },
+                days: {
+                    type: "integer",
+                    description: "Look-back period in days (default: 7).",
+                },
+                pages: {
+                    type: "integer",
+                    description: "Maximum discussion list pages to scrape (default: 5).",
+                },
+                format: {
+                    type: "string",
+                    enum: ["json", "csv"],
+                    description: "Output format (default: json).",
+                },
+                test: {
+                    type: "boolean",
+                    description: "Run in test mode with embedded sample data (no network).",
+                },
+            },
+            required: ["ticker"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "insider_graph",
+        description: "Build directed graphs of people, companies, events, and tickers with relationship edges. " +
+            "Supports pathfinding, neighbourhood queries, clustering, and suspicion-path analysis.",
+        parameters: {
+            type: "object",
+            properties: {
+                input: {
+                    type: "string",
+                    description: "Input JSON file with nodes and edges.",
+                },
+                mode: {
+                    type: "string",
+                    enum: ["build", "query", "export"],
+                    description: "Operation mode (default: build).",
+                },
+                find_path: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Two node IDs to find shortest path between [source, target].",
+                },
+                connections: {
+                    type: "string",
+                    description: "Node ID to find all connections within depth hops.",
+                },
+                depth: {
+                    type: "integer",
+                    description: "Hop depth for connections query (default: 2).",
+                },
+                clusters: {
+                    type: "boolean",
+                    description: "Find connected components / communities.",
+                },
+                suspicion: {
+                    type: "string",
+                    description: "Trade event ID to trace back to information sources.",
+                },
+                export_format: {
+                    type: "string",
+                    enum: ["json", "graphml", "dot"],
+                    description: "Export format (default: json).",
+                },
+                stats: {
+                    type: "boolean",
+                    description: "Print graph statistics.",
+                },
+                test: {
+                    type: "boolean",
+                    description: "Run built-in test scenario.",
+                },
+            },
+            required: [],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "price_fetcher",
+        description: "Fetch ASX OHLCV price data from Yahoo Finance, compute derived metrics, " +
+            "and flag trading anomalies (volume spikes, price surges, gaps, volatility).",
+        parameters: {
+            type: "object",
+            properties: {
+                tickers: {
+                    type: "string",
+                    description: "Comma-separated ASX ticker symbols (e.g. BHP,RIO,CBA).",
+                },
+                period: {
+                    type: "string",
+                    description: "Look-back period (1mo, 3mo, 6mo, 1y, etc.). Default: 3mo.",
+                },
+                interval: {
+                    type: "string",
+                    description: "Bar interval (1d, 1wk, etc.). Default: 1d.",
+                },
+                format: {
+                    type: "string",
+                    enum: ["csv", "json"],
+                    description: "Output format (default: csv).",
+                },
+                anomalies_only: {
+                    type: "boolean",
+                    description: "Output only rows with anomaly flags.",
+                },
+                summary: {
+                    type: "boolean",
+                    description: "Print per-ticker summary instead of row-level data.",
+                },
+                test: {
+                    type: "boolean",
+                    description: "Use synthetic data for offline demo (no network).",
+                },
+            },
+            required: [],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "timeline_linker",
+        description: "Correlate politician/insider trade dates against ASX announcements and events " +
+            "to build evidence chains with suspicion scores for insider-trading investigations.",
+        parameters: {
+            type: "object",
+            properties: {
+                trades: {
+                    type: "string",
+                    description: "Path to JSON file containing trade events.",
+                },
+                events: {
+                    type: "string",
+                    description: "Path to JSON file containing announcements/reports.",
+                },
+                window: {
+                    type: "integer",
+                    description: "Days after trade to search for correlated events (default: 14).",
+                },
+                min_score: {
+                    type: "number",
+                    description: "Minimum suspicion score to include (default: 0).",
+                },
+                date_from: {
+                    type: "string",
+                    description: "Only analyse trades on or after this date (YYYY-MM-DD).",
+                },
+                date_to: {
+                    type: "string",
+                    description: "Only analyse trades on or before this date (YYYY-MM-DD).",
+                },
+                summary: {
+                    type: "boolean",
+                    description: "Print a high-level summary.",
+                },
+                test: {
+                    type: "boolean",
+                    description: "Run with embedded sample data demonstrating suspicious patterns.",
+                },
+            },
+            required: [],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "volume_scanner",
+        description: "Scan ASX tickers for unusual volume and price anomalies. " +
+            "Correlates anomalies with known report dates for investigation.",
+        parameters: {
+            type: "object",
+            properties: {
+                tickers: {
+                    type: "string",
+                    description: "Comma-separated ASX tickers (e.g. BHP,RIO,WES).",
+                },
+                watchlist: {
+                    type: "string",
+                    description: "Path to a watchlist.txt file (one ticker per line).",
+                },
+                days: {
+                    type: "integer",
+                    description: "Lookback window in calendar days (default: 30).",
+                },
+                threshold: {
+                    type: "number",
+                    description: "Volume multiplier vs 20-day average to flag anomalies (default: 2.0).",
+                },
+                format: {
+                    type: "string",
+                    enum: ["csv", "json"],
+                    description: "Output format (default: csv).",
+                },
+                report_dates: {
+                    type: "string",
+                    description: "Path to JSON file with report dates for correlation.",
+                },
+                test: {
+                    type: "boolean",
+                    description: "Run with synthetic sample data (no network required).",
+                },
+            },
+            required: [],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "asx_calendar_fetcher",
+        description: "Fetch scheduled ASX Appendix 4C (quarterly cashflow) due dates " +
+            "from official calendars. Returns ticker, company, quarter_end, " +
+            "due_date, lodged_date, and status (upcoming/lodged/overdue).",
+        parameters: {
+            type: "object",
+            properties: {
+                tickers: {
+                    type: "string",
+                    description: "Comma-separated ASX tickers or 'all'.",
+                },
+                period: {
+                    type: "string",
+                    description: "Period filter: 'next_30d', 'next_90d', 'Q1_2026', etc.",
+                },
+                format: {
+                    type: "string",
+                    enum: ["json", "csv"],
+                    description: "Output format (default: json).",
+                },
+                test: {
+                    type: "boolean",
+                    description: "Run with synthetic data (no network).",
+                },
+            },
+            required: ["tickers", "period"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "bulk_asx_announcements",
+        description: "Bulk fetch recent ASX announcements (Appendix 3Y director trades, " +
+            "4C cashflow reports, 3B issue of securities) for watchlist tickers. " +
+            "Auto-paginates and filters. Chains with asx_parser for mass processing.",
+        parameters: {
+            type: "object",
+            properties: {
+                tickers: {
+                    type: "string",
+                    description: "Comma-separated tickers or path to watchlist.txt.",
+                },
+                types: {
+                    type: "array",
+                    items: { type: "string", enum: ["3Y", "4C", "3B"] },
+                    description: "Announcement types to fetch.",
+                },
+                days_back: {
+                    type: "integer",
+                    description: "Lookback days (default: 90).",
+                },
+                output_dir: {
+                    type: "string",
+                    description: "Directory to save downloaded announcement files.",
+                },
+                test: {
+                    type: "boolean",
+                    description: "Run with synthetic data (no network).",
+                },
+            },
+            required: ["tickers"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "asic_officer_lookup",
+        description: "Query ASIC/ABR for company officers and directors by ABN or ASX ticker. " +
+            "Returns officer names, roles, and appointment dates. Useful for detecting " +
+            "politician-director overlaps and conflicts of interest.",
+        parameters: {
+            type: "object",
+            properties: {
+                abn_or_ticker: {
+                    type: "string",
+                    description: "ABN number or ASX ticker symbol to look up.",
+                },
+                max_results: {
+                    type: "integer",
+                    description: "Maximum officers to return (default: 20).",
+                },
+                format: {
+                    type: "string",
+                    enum: ["json"],
+                    description: "Output format (default: json).",
+                },
+                test: {
+                    type: "boolean",
+                    description: "Run with synthetic data (no network).",
+                },
+            },
+            required: ["abn_or_ticker"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "multi_forum_scraper",
+        description: "Scrape multiple forums and social media (HotCopper, Stockhead, Twitter/Nitter) " +
+            "for ASX ticker sentiment, rumors, and discussion. Extends hotcopper_scraper " +
+            "with multi-source coverage and keyword filtering.",
+        parameters: {
+            type: "object",
+            properties: {
+                ticker: {
+                    type: "string",
+                    description: "ASX ticker symbol (e.g. BHP, CBA, RIO).",
+                },
+                sites: {
+                    type: "array",
+                    items: {
+                        type: "string",
+                        enum: ["hotcopper", "stockhead", "twitter"],
+                    },
+                    description: "Sites to scrape (default: all).",
+                },
+                days: {
+                    type: "integer",
+                    description: "Look-back period in days (default: 7).",
+                },
+                keywords: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Extra keywords to search for beyond built-in rumor/sentiment terms.",
+                },
+                test: {
+                    type: "boolean",
+                    description: "Run with synthetic data (no network).",
+                },
+            },
+            required: ["ticker"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "insider_suspicion_scorer",
+        description: "Aggregate scorer combining trades, volume/price anomalies, forum rumors, " +
+            "and politician holdings into composite suspicion scores (0-100). " +
+            "Enables end-to-end insider-trading signal detection.",
+        parameters: {
+            type: "object",
+            properties: {
+                trades: {
+                    type: "string",
+                    description: "Path to trades.json.",
+                },
+                anomalies: {
+                    type: "string",
+                    description: "Path to anomalies.json.",
+                },
+                rumors: {
+                    type: "string",
+                    description: "Path to rumors.json.",
+                },
+                holdings: {
+                    type: "string",
+                    description: "Path to holdings.json.",
+                },
+                output: {
+                    type: "string",
+                    description: "Output file path (default: stdout).",
+                },
+                min_score: {
+                    type: "number",
+                    description: "Minimum suspicion score to include (default: 0).",
+                },
+                test: {
+                    type: "boolean",
+                    description: "Run with synthetic interlocking test data.",
+                },
+            },
+            required: [],
+            additionalProperties: false,
+        },
+    },
+];
+// ---------------------------------------------------------------------------
+// Internal sets
+// ---------------------------------------------------------------------------
+const _ARTIFACT_TOOLS = new Set([
+    "list_artifacts",
+    "read_artifact",
+]);
+const _DELEGATION_TOOLS = new Set([
+    "subtask",
+    "execute",
+    "list_artifacts",
+    "read_artifact",
+]);
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Remove acceptance_criteria property from subtask/execute schemas. */
+function _stripAcceptanceCriteria(defs) {
+    return defs.map((d) => {
+        if (d.name === "subtask" || d.name === "execute") {
+            const params = structuredClone(d.parameters);
+            if (params.properties) {
+                delete params.properties["acceptance_criteria"];
+            }
+            if (params.required) {
+                params.required = params.required.filter((r) => r !== "acceptance_criteria");
+            }
+            return { ...d, parameters: params };
+        }
+        return d;
+    });
+}
+/**
+ * Return tool definitions based on mode.
+ *
+ * - `includeSubtask=true` (normal recursive) → everything except execute, artifact tools.
+ * - `includeSubtask=false` (flat / executor) → no subtask, no execute, no artifact tools.
+ * - `includeArtifacts=true` → add list_artifacts + read_artifact.
+ * - `includeAcceptanceCriteria=false` → strip acceptance_criteria from schemas.
+ */
+export function get_tool_definitions(options) {
+    const includeSubtask = options?.includeSubtask ?? true;
+    const includeArtifacts = options?.includeArtifacts ?? false;
+    const includeAcceptanceCriteria = options?.includeAcceptanceCriteria ?? false;
+    let defs;
+    if (includeSubtask) {
+        defs = TOOL_DEFINITIONS.filter((d) => d.name !== "execute" && !_ARTIFACT_TOOLS.has(d.name));
+    }
+    else {
+        defs = TOOL_DEFINITIONS.filter((d) => !_DELEGATION_TOOLS.has(d.name));
+    }
+    if (includeArtifacts) {
+        defs = defs.concat(TOOL_DEFINITIONS.filter((d) => _ARTIFACT_TOOLS.has(d.name)));
+    }
+    if (!includeAcceptanceCriteria) {
+        defs = _stripAcceptanceCriteria(defs);
+    }
+    return defs;
+}
+/**
+ * Recursively enforce OpenAI strict-mode constraints on `schema` in-place.
+ *
+ * Every `type: "object"` node gets `additionalProperties: false` and a
+ * complete `required` list. Optional properties (not originally required)
+ * are made nullable via `anyOf: [{ type: original }, { type: "null" }]`.
+ */
+function _strictFixup(schema) {
+    const schemaType = schema["type"];
+    if (schemaType === "object") {
+        const properties = (schema["properties"] ?? {});
+        const required = new Set(schema["required"] ?? []);
+        const allKeys = Object.keys(properties);
+        for (const key of allKeys) {
+            const prop = properties[key];
+            if (prop != null && typeof prop === "object") {
+                _strictFixup(prop);
+            }
+            if (!required.has(key)) {
+                if ("type" in prop) {
+                    const originalType = prop["type"];
+                    delete prop["type"];
+                    const desc = prop["description"];
+                    delete prop["description"];
+                    const newProp = {
+                        anyOf: [{ type: originalType }, { type: "null" }],
+                    };
+                    if (desc !== undefined) {
+                        newProp["description"] = desc;
+                    }
+                    // Move remaining keys into first anyOf branch
+                    for (const [k, v] of Object.entries(prop)) {
+                        if (!(k in newProp)) {
+                            newProp["anyOf"][0][k] = v;
+                        }
+                    }
+                    properties[key] = newProp;
+                }
+            }
+        }
+        schema["required"] = allKeys;
+        schema["additionalProperties"] = false;
+    }
+    else if (schemaType === "array") {
+        const items = schema["items"];
+        if (items != null && typeof items === "object") {
+            _strictFixup(items);
+        }
+    }
+}
+/**
+ * For OpenAI strict mode: all properties must be required.
+ *
+ * Optional properties (not in 'required') are made nullable by wrapping
+ * their type with `anyOf [original, null]`. Recurses into nested objects
+ * and array items so that every `type: object` node has
+ * `additionalProperties: false` and a complete `required` list.
+ */
+function _makeStrictParameters(params) {
+    const out = structuredClone(params);
+    _strictFixup(out);
+    return out;
+}
+// ---------------------------------------------------------------------------
+// Provider converters
+// ---------------------------------------------------------------------------
+/** Convert provider-neutral definitions to OpenAI tools array format. */
+export function to_openai_tools(defs, strict = true) {
+    const definitions = defs ?? TOOL_DEFINITIONS;
+    const tools = [];
+    for (const d of definitions) {
+        let parameters = d.parameters;
+        if (strict) {
+            parameters = _makeStrictParameters(d.parameters);
+        }
+        const func = {
+            name: d.name,
+            description: d.description,
+            parameters: parameters,
+        };
+        if (strict) {
+            func.strict = true;
+        }
+        tools.push({ type: "function", function: func });
+    }
+    return tools;
+}
+/** Convert provider-neutral definitions to Anthropic tools array format. */
+export function to_anthropic_tools(defs) {
+    const definitions = defs ?? TOOL_DEFINITIONS;
+    return definitions.map((d) => ({
+        name: d.name,
+        description: d.description,
+        input_schema: d.parameters,
+    }));
+}
+//# sourceMappingURL=tool-defs.js.map