@rlynjb/aptkit-core 0.1.0

package/node_modules/@aptkit/agent-diagnostic-investigation/fixtures/promoted/sp-revenue-diagnostic-fixture-promoted-2026-06-18-19-04-28.json

@@ -0,0 +1,230 @@
+{
+  "id": "sp-revenue-diagnostic-fixture-promoted",
+  "description": "Promoted deterministic diagnostic fixture from fixture replay artifact. Source fixture: sp-revenue-diagnostic. Replay created at: 2026-06-18T19:04:28.139Z.",
+  "workspace": {
+    "projectId": "olist",
+    "projectName": "Olist Brazilian ecommerce fixture",
+    "events": [
+      {
+        "name": "purchase",
+        "properties": [
+          "state",
+          "category",
+          "total_price"
+        ],
+        "eventCount": 50000
+      },
+      {
+        "name": "session_start",
+        "properties": [
+          "utm_source"
+        ],
+        "eventCount": 80000
+      },
+      {
+        "name": "checkout",
+        "properties": [
+          "state"
+        ],
+        "eventCount": 35000
+      },
+      {
+        "name": "view_item",
+        "properties": [
+          "category"
+        ],
+        "eventCount": 120000
+      }
+    ],
+    "customerProperties": [
+      "state",
+      "city"
+    ],
+    "catalogs": [],
+    "totalCustomers": 125000,
+    "totalEvents": 285000,
+    "oldestTimestamp": 1764547200000,
+    "dataHorizon": {
+      "from": "2025-12-01",
+      "to": "2026-06-01",
+      "durationDays": 182
+    }
+  },
+  "anomaly": {
+    "metric": "revenue",
+    "category": "revenue_drop",
+    "scope": [
+      "state:SP"
+    ],
+    "change": {
+      "value": 30,
+      "direction": "down",
+      "baseline": "recent 4w vs prior 12w"
+    },
+    "severity": "critical",
+    "impact": "Sao Paulo revenue is down about 30% while nearby states are stable.",
+    "evidence": [
+      {
+        "tool": "get_anomaly_context",
+        "result": {
+          "segment": "SP",
+          "pct_change": -0.300245,
+          "anomaly_value": 28550000,
+          "baseline_avg": 40800000
+        }
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "get_anomaly_context",
+      "description": "Return context for a selected anomaly window and baseline.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "metric": {
+            "type": "string"
+          },
+          "dimension": {
+            "type": "string"
+          },
+          "segment": {
+            "type": "string"
+          },
+          "anomaly_window": {
+            "type": "object"
+          },
+          "baseline_window": {
+            "type": "object"
+          }
+        },
+        "required": [
+          "metric",
+          "dimension",
+          "segment"
+        ]
+      },
+      "result": {
+        "anomaly_summary": {
+          "metric": "revenue",
+          "segment": "SP",
+          "anomaly_value": 28550000,
+          "baseline_avg": 40800000,
+          "pct_change": -0.300245
+        },
+        "related_segments": [
+          {
+            "name": "RJ",
+            "pct_change": -0.02
+          },
+          {
+            "name": "MG",
+            "pct_change": 0.01
+          }
+        ],
+        "sample_orders": [
+          {
+            "order_id": "sp-101",
+            "purchase_ts": "2026-05-10",
+            "status": "delivered",
+            "price_brl": 42000
+          },
+          {
+            "order_id": "sp-102",
+            "purchase_ts": "2026-05-23",
+            "status": "delivered",
+            "price_brl": 31000
+          }
+        ]
+      }
+    },
+    {
+      "name": "get_metric_timeseries",
+      "description": "Return metric timeseries for an optional dimension.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "metric": {
+            "type": "string"
+          },
+          "dimension": {
+            "type": "string"
+          },
+          "filter": {
+            "type": "object"
+          },
+          "time_range": {
+            "type": "object"
+          },
+          "granularity": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "metric",
+          "time_range"
+        ]
+      },
+      "result": {
+        "points": [
+          {
+            "ts": "2026-05-04",
+            "segment": "SP",
+            "value": 7400000
+          },
+          {
+            "ts": "2026-05-11",
+            "segment": "SP",
+            "value": 7200000
+          },
+          {
+            "ts": "2026-05-18",
+            "segment": "SP",
+            "value": 7050000
+          },
+          {
+            "ts": "2026-05-25",
+            "segment": "SP",
+            "value": 6900000
+          }
+        ],
+        "totalCount": 4200
+      }
+    }
+  ],
+  "modelResponses": [
+    {
+      "content": [
+        {
+          "type": "text",
+          "text": "```json\n{\n  \"conclusion\": \"The SP revenue drop is isolated to Sao Paulo and is best explained by a regional demand or operations issue rather than broad marketplace seasonality. SP revenue fell about 30% versus baseline while RJ and MG were nearly flat, and the weekly series shows a steady slide through May.\",\n  \"evidence\": [\n    \"get_anomaly_context reported SP revenue of 28,550,000 against a 40,800,000 baseline average, a -30.0245% change.\",\n    \"Related segments did not move with SP: RJ was -2% and MG was +1%.\",\n    \"The SP weekly revenue series declined from 7,400,000 to 6,900,000 across the anomaly window.\"\n  ],\n  \"hypothesesConsidered\": [\n    {\n      \"hypothesis\": \"Broad marketplace seasonality\",\n      \"supported\": false,\n      \"reasoning\": \"Related state segments were nearly flat, so the pattern is not broad.\"\n    },\n    {\n      \"hypothesis\": \"Sao Paulo-specific demand or operations issue\",\n      \"supported\": true,\n      \"reasoning\": \"The magnitude is concentrated in SP and persists across the anomaly weeks.\"\n    },\n    {\n      \"hypothesis\": \"One-week reporting gap\",\n      \"supported\": false,\n      \"reasoning\": \"The timeseries shows a gradual weekly slide rather than a sudden zero or missing week.\"\n    }\n  ],\n  \"timeSeries\": [\n    {\n      \"day\": \"w-3\",\n      \"value\": 7400000\n    },\n    {\n      \"day\": \"w-2\",\n      \"value\": 7200000\n    },\n    {\n      \"day\": \"w-1\",\n      \"value\": 7050000\n    },\n    {\n      \"day\": \"this week\",\n      \"value\": 6900000\n    }\n  ],\n  \"confidence\": \"high\"\n}\n```"
+        }
+      ],
+      "usage": {
+        "inputTokens": 2920,
+        "outputTokens": 425,
+        "estimated": true
+      },
+      "model": "promoted-fixture-replay"
+    }
+  ],
+  "expectations": {
+    "requiredEvidenceText": [
+      "get_anomaly_context reported SP revenue of 28",
+      "Related segments did not move with",
+      "The SP weekly revenue series declined"
+    ],
+    "requiredSupportedHypothesisText": [
+      "Sao Paulo-specific demand or operations issue"
+    ]
+  },
+  "promotion": {
+    "sourceArtifact": "artifacts/replays/2026-06-18T19-04-28-139Z-sp-revenue-diagnostic-fixture-studio.json",
+    "sourceProvider": {
+      "id": "fixture",
+      "model": "fixture-model"
+    },
+    "promotedAt": "2026-06-18T19:12:30.863Z",
+    "note": "This fixture captures the final diagnostic replay answer deterministically; it does not reconstruct the live provider tool loop."
+  }
+}

package/node_modules/@aptkit/agent-diagnostic-investigation/fixtures/sp-revenue-diagnostic.json

@@ -0,0 +1,148 @@
+{
+  "id": "sp-revenue-diagnostic",
+  "description": "Diagnose the seeded SP revenue drop from deterministic Olist-style context and timeseries tools.",
+  "workspace": {
+    "projectId": "olist",
+    "projectName": "Olist Brazilian ecommerce fixture",
+    "events": [
+      { "name": "purchase", "properties": ["state", "category", "total_price"], "eventCount": 50000 },
+      { "name": "session_start", "properties": ["utm_source"], "eventCount": 80000 },
+      { "name": "checkout", "properties": ["state"], "eventCount": 35000 },
+      { "name": "view_item", "properties": ["category"], "eventCount": 120000 }
+    ],
+    "customerProperties": ["state", "city"],
+    "catalogs": [],
+    "totalCustomers": 125000,
+    "totalEvents": 285000,
+    "oldestTimestamp": 1764547200000,
+    "dataHorizon": { "from": "2025-12-01", "to": "2026-06-01", "durationDays": 182 }
+  },
+  "anomaly": {
+    "metric": "revenue",
+    "category": "revenue_drop",
+    "scope": ["state:SP"],
+    "change": { "value": 30, "direction": "down", "baseline": "recent 4w vs prior 12w" },
+    "severity": "critical",
+    "impact": "Sao Paulo revenue is down about 30% while nearby states are stable.",
+    "evidence": [
+      {
+        "tool": "get_anomaly_context",
+        "result": {
+          "segment": "SP",
+          "pct_change": -0.300245,
+          "anomaly_value": 28550000,
+          "baseline_avg": 40800000
+        }
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "get_anomaly_context",
+      "description": "Return context for a selected anomaly window and baseline.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "metric": { "type": "string" },
+          "dimension": { "type": "string" },
+          "segment": { "type": "string" },
+          "anomaly_window": { "type": "object" },
+          "baseline_window": { "type": "object" }
+        },
+        "required": ["metric", "dimension", "segment"]
+      },
+      "result": {
+        "anomaly_summary": {
+          "metric": "revenue",
+          "segment": "SP",
+          "anomaly_value": 28550000,
+          "baseline_avg": 40800000,
+          "pct_change": -0.300245
+        },
+        "related_segments": [
+          { "name": "RJ", "pct_change": -0.02 },
+          { "name": "MG", "pct_change": 0.01 }
+        ],
+        "sample_orders": [
+          { "order_id": "sp-101", "purchase_ts": "2026-05-10", "status": "delivered", "price_brl": 42000 },
+          { "order_id": "sp-102", "purchase_ts": "2026-05-23", "status": "delivered", "price_brl": 31000 }
+        ]
+      }
+    },
+    {
+      "name": "get_metric_timeseries",
+      "description": "Return metric timeseries for an optional dimension.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "metric": { "type": "string" },
+          "dimension": { "type": "string" },
+          "filter": { "type": "object" },
+          "time_range": { "type": "object" },
+          "granularity": { "type": "string" }
+        },
+        "required": ["metric", "time_range"]
+      },
+      "result": {
+        "points": [
+          { "ts": "2026-05-04", "segment": "SP", "value": 7400000 },
+          { "ts": "2026-05-11", "segment": "SP", "value": 7200000 },
+          { "ts": "2026-05-18", "segment": "SP", "value": 7050000 },
+          { "ts": "2026-05-25", "segment": "SP", "value": 6900000 }
+        ],
+        "totalCount": 4200
+      }
+    }
+  ],
+  "modelResponses": [
+    {
+      "content": [
+        {
+          "type": "tool_use",
+          "id": "diag-tool-1",
+          "name": "get_anomaly_context",
+          "input": {
+            "metric": "revenue",
+            "dimension": "state",
+            "segment": "SP",
+            "anomaly_window": { "from": "2026-05-04", "to": "2026-06-01" },
+            "baseline_window": { "from": "2026-02-09", "to": "2026-05-04" }
+          }
+        }
+      ],
+      "usage": { "inputTokens": 980, "outputTokens": 80 },
+      "model": "fixture-model"
+    },
+    {
+      "content": [
+        {
+          "type": "tool_use",
+          "id": "diag-tool-2",
+          "name": "get_metric_timeseries",
+          "input": {
+            "metric": "revenue",
+            "filter": { "dimension": "state", "value": "SP" },
+            "time_range": { "from": "2026-05-04", "to": "2026-06-01" },
+            "granularity": "week"
+          }
+        }
+      ],
+      "usage": { "inputTokens": 820, "outputTokens": 85 },
+      "model": "fixture-model"
+    },
+    {
+      "content": [
+        {
+          "type": "text",
+          "text": "```json\n{\"conclusion\":\"The SP revenue drop is isolated to Sao Paulo and is best explained by a regional demand or operations issue rather than broad marketplace seasonality. SP revenue fell about 30% versus baseline while RJ and MG were nearly flat, and the weekly series shows a steady slide through May.\",\"evidence\":[\"get_anomaly_context reported SP revenue of 28,550,000 against a 40,800,000 baseline average, a -30.0245% change.\",\"Related segments did not move with SP: RJ was -2% and MG was +1%.\",\"The SP weekly revenue series declined from 7,400,000 to 6,900,000 across the anomaly window.\"],\"hypothesesConsidered\":[{\"hypothesis\":\"Broad marketplace seasonality\",\"supported\":false,\"reasoning\":\"Related state segments were nearly flat, so the pattern is not broad.\"},{\"hypothesis\":\"Sao Paulo-specific demand or operations issue\",\"supported\":true,\"reasoning\":\"The magnitude is concentrated in SP and persists across the anomaly weeks.\"},{\"hypothesis\":\"One-week reporting gap\",\"supported\":false,\"reasoning\":\"The timeseries shows a gradual weekly slide rather than a sudden zero or missing week.\"}],\"timeSeries\":[{\"day\":\"w-3\",\"value\":7400000},{\"day\":\"w-2\",\"value\":7200000},{\"day\":\"w-1\",\"value\":7050000},{\"day\":\"this week\",\"value\":6900000}]}\n```"
+        }
+      ],
+      "usage": { "inputTokens": 1120, "outputTokens": 260 },
+      "model": "fixture-model"
+    }
+  ],
+  "expectations": {
+    "requiredEvidenceText": ["-30.0245%", "RJ", "weekly"],
+    "requiredSupportedHypothesisText": ["Sao Paulo"]
+  }
+}

package/node_modules/@aptkit/agent-diagnostic-investigation/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@aptkit/agent-diagnostic-investigation",
+  "version": "0.0.0",
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "files": [
+    "README.md",
+    "dist/src",
+    "fixtures"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "npm run build && node --test dist/test/*.test.js",
+    "replay:fixture": "npm run build && node dist/scripts/replay-fixture.js",
+    "replay:promoted": "npm run build && node ../../../scripts/replay-promoted-fixtures.mjs --count diagnosisPresent --empty \"no promoted diagnostic fixtures found\""
+  },
+  "dependencies": {
+    "@aptkit/context": "0.0.0",
+    "@aptkit/prompts": "0.0.0",
+    "@aptkit/runtime": "0.0.0",
+    "@aptkit/tools": "0.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0"
+  }
+}

package/node_modules/@aptkit/agent-query/README.md

@@ -0,0 +1,11 @@
+# Query Agent
+
+Extracted from the Blooming Insights free-form query agent as a reusable AptKit capability.
+
+This package answers a natural-language workspace question by using a `ToolRegistry`, then returning grounded prose instead of a structured JSON object.
+
+```ts
+import { QueryAgent } from '@aptkit/agent-query';
+```
+
+The first fixture covers revenue by state over an Olist-style ecommerce workspace.

package/node_modules/@aptkit/agent-query/dist/src/fixture-provider.d.ts

@@ -0,0 +1,10 @@
+import type { ModelProvider, ModelRequest, ModelResponse } from '@aptkit/runtime';
+export declare class FixtureModelProvider implements ModelProvider {
+    private readonly responses;
+    readonly id = "fixture";
+    readonly defaultModel = "fixture-model";
+    readonly requests: ModelRequest[];
+    private index;
+    constructor(responses: ModelResponse[]);
+    complete(request: ModelRequest): Promise<ModelResponse>;
+}

package/node_modules/@aptkit/agent-query/dist/src/fixture-provider.js

@@ -0,0 +1,18 @@
+export class FixtureModelProvider {
+    responses;
+    id = 'fixture';
+    defaultModel = 'fixture-model';
+    requests = [];
+    index = 0;
+    constructor(responses) {
+        this.responses = responses;
+    }
+    async complete(request) {
+        this.requests.push(request);
+        const response = this.responses[this.index];
+        this.index += 1;
+        if (!response)
+            throw new Error(`fixture model exhausted after ${this.index - 1} responses`);
+        return response;
+    }
+}

package/node_modules/@aptkit/agent-query/dist/src/index.d.ts

@@ -0,0 +1,6 @@
+export * from './fixture-provider.js';
+export * from './intent.js';
+export * from './query-agent.js';
+export * from './schema-summary.js';
+export * from './types.js';
+export * from './validate.js';

package/node_modules/@aptkit/agent-query/dist/src/index.js

@@ -0,0 +1,6 @@
+export * from './fixture-provider.js';
+export * from './intent.js';
+export * from './query-agent.js';
+export * from './schema-summary.js';
+export * from './types.js';
+export * from './validate.js';

package/node_modules/@aptkit/agent-query/dist/src/intent.d.ts

@@ -0,0 +1,6 @@
+import type { ModelProvider } from '@aptkit/runtime';
+import type { Intent } from './types.js';
+export declare function parseIntent(raw: string): Intent;
+export declare function classifyIntent(model: ModelProvider, query: string, options?: {
+    signal?: AbortSignal;
+}): Promise<Intent>;

package/node_modules/@aptkit/agent-query/dist/src/intent.js

@@ -0,0 +1,23 @@
+export function parseIntent(raw) {
+    const text = raw.trim().toLowerCase();
+    if (text.includes('monitoring'))
+        return 'monitoring';
+    if (text.includes('recommendation'))
+        return 'recommendation';
+    if (text.includes('diagnostic'))
+        return 'diagnostic';
+    return 'diagnostic';
+}
+export async function classifyIntent(model, query, options = {}) {
+    const response = await model.complete({
+        system: 'Classify the user query as exactly one word: monitoring (what changed / what is new), diagnostic (why did something happen), or recommendation (what should I do). Reply with ONLY the one word.',
+        messages: [{ role: 'user', content: query }],
+        maxTokens: 16,
+        signal: options.signal,
+    });
+    const text = response.content
+        .filter((block) => block.type === 'text')
+        .map((block) => block.text)
+        .join('');
+    return parseIntent(text);
+}

package/node_modules/@aptkit/agent-query/dist/src/query-agent.d.ts

@@ -0,0 +1,27 @@
+import { type CapabilityTraceSink, type ModelProvider } from '@aptkit/runtime';
+import { type ToolRegistry } from '@aptkit/tools';
+import type { Intent, WorkspaceDescriptor } from './types.js';
+export declare const QUERY_CAPABILITY_ID = "query-agent";
+/** Least-privilege tool grant for answering free-form workspace questions. */
+export declare const queryToolPolicy: {
+    capabilityId: string;
+    allowedTools: readonly ["list_dashboards", "get_dashboard", "list_trends", "get_trend", "list_funnels", "get_funnel", "list_running_aggregates", "get_running_aggregate", "list_reports", "get_report", "execute_analytics", "execute_analytics_eql", "get_customer_prediction_score", "get_event_segmentation", "list_customers", "list_customer_events", "list_customers_in_segment", "list_segmentations", "list_email_campaigns", "list_sms_campaigns", "list_in_app_messages", "list_banners", "list_experiments", "list_scenarios", "list_catalog_items", "get_catalog_item", "get_scenario", "list_initiatives", "get_initiative_items", "list_recommendations", "get_recommendation", "list_voucher_pools", "get_frequency_policies", "get_metric_timeseries", "get_segments", "get_anomaly_context"];
+};
+export type QueryAgentOptions = {
+    model: ModelProvider;
+    tools: ToolRegistry;
+    workspace: WorkspaceDescriptor;
+    trace?: CapabilityTraceSink;
+    prompt?: string;
+};
+export type QueryRunOptions = {
+    intent?: Intent;
+    signal?: AbortSignal;
+};
+export declare class QueryAgent {
+    private readonly options;
+    private readonly prompt;
+    constructor(options: QueryAgentOptions);
+    /** Answers a natural-language question by using only the supplied model and allowed tools. */
+    answer(question: string, runOptions?: QueryRunOptions): Promise<string>;
+}

package/node_modules/@aptkit/agent-query/dist/src/query-agent.js

@@ -0,0 +1,81 @@
+import { buildSynthesisInstruction, runAgentLoop } from '@aptkit/runtime';
+import { queryPromptPackage, renderPromptTemplate } from '@aptkit/prompts';
+import { filterToolsForPolicy } from '@aptkit/tools';
+import { schemaSummary } from './schema-summary.js';
+export const QUERY_CAPABILITY_ID = 'query-agent';
+/** Least-privilege tool grant for answering free-form workspace questions. */
+export const queryToolPolicy = {
+    capabilityId: QUERY_CAPABILITY_ID,
+    allowedTools: [
+        'list_dashboards',
+        'get_dashboard',
+        'list_trends',
+        'get_trend',
+        'list_funnels',
+        'get_funnel',
+        'list_running_aggregates',
+        'get_running_aggregate',
+        'list_reports',
+        'get_report',
+        'execute_analytics',
+        'execute_analytics_eql',
+        'get_customer_prediction_score',
+        'get_event_segmentation',
+        'list_customers',
+        'list_customer_events',
+        'list_customers_in_segment',
+        'list_segmentations',
+        'list_email_campaigns',
+        'list_sms_campaigns',
+        'list_in_app_messages',
+        'list_banners',
+        'list_experiments',
+        'list_scenarios',
+        'list_catalog_items',
+        'get_catalog_item',
+        'get_scenario',
+        'list_initiatives',
+        'get_initiative_items',
+        'list_recommendations',
+        'get_recommendation',
+        'list_voucher_pools',
+        'get_frequency_policies',
+        'get_metric_timeseries',
+        'get_segments',
+        'get_anomaly_context',
+    ],
+};
+const FALLBACK_ANSWER = 'I was unable to find enough data to answer that question.';
+export class QueryAgent {
+    options;
+    prompt;
+    constructor(options) {
+        this.options = options;
+        this.prompt = options.prompt ?? queryPromptPackage.system;
+    }
+    /** Answers a natural-language question by using only the supplied model and allowed tools. */
+    async answer(question, runOptions = {}) {
+        const allTools = await this.options.tools.listTools();
+        const toolSchemas = filterToolsForPolicy(allTools, queryToolPolicy);
+        const intent = runOptions.intent ?? 'diagnostic';
+        const system = renderPromptTemplate(this.prompt, {
+            schema: schemaSummary(this.options.workspace),
+            project_id: this.options.workspace.projectId,
+            intent,
+        });
+        const { finalText } = await runAgentLoop({
+            capabilityId: QUERY_CAPABILITY_ID,
+            model: this.options.model,
+            tools: this.options.tools,
+            system,
+            userPrompt: question,
+            toolSchemas,
+            trace: this.options.trace,
+            signal: runOptions.signal,
+            maxTurns: 8,
+            maxToolCalls: 6,
+            synthesisInstruction: buildSynthesisInstruction('Now answer the user question directly and concisely in plain prose, citing the key numbers you found.'),
+        });
+        return finalText.trim() || FALLBACK_ANSWER;
+    }
+}

package/node_modules/@aptkit/agent-query/dist/src/schema-summary.d.ts

@@ -0,0 +1 @@
+export { schemaSummary } from '@aptkit/context';

package/node_modules/@aptkit/agent-query/dist/src/schema-summary.js

@@ -0,0 +1 @@
+export { schemaSummary } from '@aptkit/context';

package/node_modules/@aptkit/agent-query/dist/src/types.d.ts

@@ -0,0 +1,5 @@
+export type { WorkspaceDescriptor } from '@aptkit/context';
+export type Intent = 'monitoring' | 'diagnostic' | 'recommendation';
+export type QueryAnswer = {
+    answer: string;
+};

package/node_modules/@aptkit/agent-query/dist/src/types.js

@@ -0,0 +1 @@
+export {};

package/node_modules/@aptkit/agent-query/dist/src/validate.d.ts

@@ -0,0 +1,7 @@
+export type QueryAnswerValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function validateQueryAnswer(answer: unknown): QueryAnswerValidationResult;

package/node_modules/@aptkit/agent-query/dist/src/validate.js

@@ -0,0 +1,9 @@
+export function validateQueryAnswer(answer) {
+    if (typeof answer !== 'string')
+        return { ok: false, error: 'answer must be a string' };
+    if (answer.trim().length === 0)
+        return { ok: false, error: 'answer must not be empty' };
+    if (answer.trim().length < 20)
+        return { ok: false, error: 'answer is too short to be useful' };
+    return { ok: true };
+}