@tikoci/centrs 0.1.6 → 0.1.8-next.0

package/src/index.ts

@@ -12,10 +12,10 @@ export {
 	type ApiSuccessEnvelope,
 	api,
 	apiEnvelope,
-	apiListen,
 	apiMethods,
 	apiOutputFormats,
 	apiRequestSummaryFromRequest,
+	apiStream,
 	buildApiBody,
 	buildApiErrorEnvelope,
 	buildApiErrorEnvelopeFromResolved,
@@ -85,6 +85,7 @@ export {
 	normalizeWarnings,
 	type SettingSource,
 	type SettingSourceKind,
+	type ValidationTrace,
 	type Warning,
 } from "./core/envelope.ts";
 export {
@@ -203,6 +204,7 @@ export {
 	type DevicesCommand,
 	type DevicesEnvelope,
 	type DevicesGroupSummary,
+	type DevicesInitData,
 	type DevicesListItem,
 	type DevicesMutationData,
 	type DevicesMutationEnvelope,
@@ -215,6 +217,7 @@ export {
 	defaultCdbPath,
 	devicesOutputFormats,
 	editInteractiveOnlyError,
+	initCdb,
 	type LoadCdbOptions,
 	type LoadedCdb,
 	listDevices,
@@ -574,24 +577,36 @@ export {
 	type TargetSelection,
 	toCoreSource,
 } from "./resolver/index.ts";
+export type { RetrieveWaitMeta, RetrieveWaitSettings } from "./retrieve.ts";
 export {
 	buildResolvedRetrieve,
 	buildRetrieveErrorEnvelope,
 	buildRetrieveErrorEnvelopeFromResolved,
+	FOLLOW_SWEEP_DEFAULT_MS,
 	type ResolvedRetrieveRequest,
 	type RetrieveEnvelope,
 	type RetrieveErrorEnvelope,
+	type RetrieveFollowCounts,
+	type RetrieveFollowSettings,
+	type RetrieveFollowStopReason,
+	type RetrieveFollowSummary,
 	type RetrieveGlobalContext,
 	type RetrieveOperationMeta,
+	type RetrieveOptions,
 	type RetrieveOutputFormat,
 	type RetrieveRequest,
 	type RetrieveRequestSummary,
+	type RetrieveSampleSettings,
+	type RetrieveSampleStopReason,
+	type RetrieveSampleSummary,
+	type RetrieveStreamMeta,
 	type RetrieveSuccessEnvelope,
 	type RetrieveWarning,
 	renderRetrieveEnvelope,
 	resolveRetrieveGlobalContext,
 	resolveRetrieveRequest,
 	retrieve,
+	retrieveEnvelope,
 	retrieveOutputFormats,
 	runResolvedRetrieve,
 	validateRetrieveRequestShape,
@@ -609,6 +624,17 @@ export {
 	retrieveFanout,
 	retrieveGroup,
 } from "./retrieve-fanout.ts";
+export {
+	FOLLOW_BUFFER_LIMIT,
+	type RetrieveFollowOptions,
+	retrieveFollow,
+} from "./retrieve-follow.ts";
+export {
+	type RetrieveSampleOptions,
+	retrieveSample,
+} from "./retrieve-sample.ts";
+export { renderRetrieveStreamLine } from "./retrieve-stream.ts";
+export { type RetrieveWaitOptions, retrieveWait } from "./retrieve-wait.ts";
 export {
 	buildSettingsErrorEnvelope,
 	renderSettingsEnvelope,
@@ -650,10 +676,12 @@ export {
 } from "./terminal.ts";
 export {
 	buildTransferErrorEnvelope,
+	buildTransferErrorEnvelopeFromResolved,
 	FILE_READ_CHUNK_BYTES,
 	isTransferWriteVerb,
 	normalizeRemotePath,
 	REST_FILE_WRITE_CAP_BYTES,
+	type ResolvedTransferRequest,
 	renderTransferEnvelope,
 	resolveTransferRequest,
 	runResolvedTransfer,
@@ -664,11 +692,13 @@ export {
 	type TransferMethod,
 	type TransferOp,
 	type TransferOperationMeta,
+	type TransferOptions,
 	type TransferOutputFormat,
 	type TransferRequest,
 	type TransferSuccessEnvelope,
 	type TransferVerb,
 	transfer,
+	transferEnvelope,
 	transferMethods,
 	transferOutputFormats,
 	transferVerbs,

package/src/mcp/tools.ts

@@ -36,7 +36,7 @@ import {
 import type { CommentKvUpdate } from "../resolver/comment-kv.ts";
 import { parseBbox, parseNear } from "../resolver/geo.ts";
 import { parseDuration } from "../resolver/settings.ts";
-import { buildRetrieveErrorEnvelope, retrieve } from "../retrieve.ts";
+import { retrieveEnvelope } from "../retrieve.ts";
 import {
 	buildRetrieveFanoutErrorEnvelope,
 	retrieveGroup,
@@ -264,11 +264,13 @@ export const retrieveInputShape = {
 		.boolean()
 		.optional()
 		.describe("Return every attribute instead of the default projection."),
-	filter: z.string().optional().describe("RouterOS-style filter expression."),
+	filter: z.string().optional().describe("Alias of `query`."),
 	query: z
-		.string()
+		.union([z.string(), z.array(z.string())])
 		.optional()
-		.describe("Raw query word(s) appended to the read."),
+		.describe(
+			"Row filter written as after `print where`, e.g. `type=ether and !disabled`; run on the router, several are AND-ed. No `~` (regex) or `in`.",
+		),
 	via: z.string().optional().describe("Override transport."),
 	timeout: z
 		.union([z.string(), z.number()])
@@ -324,18 +326,11 @@ export async function handleRetrieve(
 		cdbPassword: config.cdbPassword,
 	};
 
+	if (args.group === undefined) return await retrieveEnvelope(request);
 	try {
-		const envelope =
-			args.group !== undefined
-				? await retrieveGroup(request)
-				: await retrieve(request);
-		return envelope;
+		return await retrieveGroup(request);
 	} catch (error) {
-		const envelope =
-			args.group !== undefined
-				? buildRetrieveFanoutErrorEnvelope(request, error)
-				: buildRetrieveErrorEnvelope(request, error);
-		return envelope;
+		return buildRetrieveFanoutErrorEnvelope(request, error);
 	}
 }
 
@@ -352,7 +347,7 @@ export const executeInputShape = {
 		.boolean()
 		.optional()
 		.describe(
-			"Required true for write-shaped commands (add/set/remove). Reads ignore it.",
+			"Required true for write-shaped commands, including selector/positional and non-CRUD mutations. Reads ignore it.",
 		),
 	via: z.string().optional().describe("Override transport."),
 	timeout: z