@marinoscar/platform-contract 0.0.0-stage → 0.1.0-next.3

package/dist/esm/telemetry/assistant.d.ts

@@ -0,0 +1,173 @@
+import { z } from 'zod';
+import { type TelemetryAssistantConfidence, type TelemetryAssistantReportStatus, type TelemetryAssistantSeverity, type TelemetryAssistantToolName } from './constants.js';
+/**
+ * One earlier turn of the conversation: `role` (`user` or `assistant`) and
+ * `content` (at most {@link TELEMETRY_ASSISTANT_HISTORY_CONTENT_MAX} characters).
+ *
+ * @extensionPoint schema
+ * @stability stable
+ */
+export declare const telemetryAssistantTurnSchema: z.ZodObject<{
+    role: z.ZodEnum<import("./constants.js").TelemetryEnumEntries<"user" | "assistant">>;
+    content: z.ZodString;
+}, z.core.$strip>;
+/**
+ * One earlier turn of the conversation.
+ *
+ * @stability stable
+ */
+export type TelemetryAssistantTurn = z.infer<typeof telemetryAssistantTurnSchema>;
+/**
+ * `POST /api/admin/telemetry/assistant/stream` body: `question` (trimmed,
+ * 1..{@link TELEMETRY_ASSISTANT_QUESTION_MAX} characters) and an optional
+ * `history` (oldest first, at most {@link TELEMETRY_ASSISTANT_HISTORY_MAX_TURNS}).
+ *
+ * @extensionPoint schema
+ * @stability stable
+ */
+export declare const telemetryAssistantRequestSchema: z.ZodObject<{
+    question: z.ZodString;
+    history: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<import("./constants.js").TelemetryEnumEntries<"user" | "assistant">>;
+        content: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * The `POST /api/admin/telemetry/assistant/stream` body.
+ *
+ * @stability stable
+ */
+export type TelemetryAssistantRequest = z.infer<typeof telemetryAssistantRequestSchema>;
+/**
+ * `event: step` — one tool call the assistant made.
+ *
+ * @stability stable
+ */
+export interface TelemetryAssistantStepEvent {
+    /** 0-based, across the whole turn. */
+    index: number;
+    /** The tool called. */
+    tool: TelemetryAssistantToolName;
+    /** `group` is `metrics_overview`'s metric group (#603). */
+    input?: {
+        /** `describe_table`: the table. */
+        table?: string;
+        /** `run_query`: the statement. */
+        sql?: string;
+        /** The window an overview tool looked at. */
+        window?: string;
+        /** `get_trace`: the trace. */
+        traceId?: string;
+        /** `metrics_overview`: the metric group. */
+        group?: string;
+    };
+    /** `run_query` / `get_trace` only: rows the call returned (up to the row cap). */
+    rowCount?: number;
+    /** `run_query` / `get_trace` only: more rows matched than the row cap allowed. */
+    truncated?: boolean;
+    /** Wall time of the call. */
+    durationMs: number;
+    /** Why the call failed; the model was told the same and may retry. */
+    error?: string;
+    /** The model's interim reasoning for the round this call belongs to; only on the FIRST call of a round. Bounded to 1000 chars. */
+    thought?: string;
+}
+/**
+ * One finding of a report.
+ *
+ * @stability stable
+ */
+export interface TelemetryAssistantFinding {
+    /** One line naming the finding. */
+    title: string;
+    /** How bad it is. */
+    severity: TelemetryAssistantSeverity;
+    /** What in the data shows it. */
+    evidence: string;
+    /** Index into `report.queries` of the query that shows this finding. */
+    queryIndex?: number;
+}
+/**
+ * A supporting query of a report, which the user can re-run.
+ *
+ * @stability stable
+ */
+export interface TelemetryAssistantQuery {
+    /** What the query shows. */
+    title: string;
+    /** The statement. */
+    sql: string;
+}
+/**
+ * The investigation's structured result.
+ *
+ * @stability stable
+ */
+export interface TelemetryAssistantReport {
+    /** The outcome. */
+    status: TelemetryAssistantReportStatus;
+    /** A short summary. */
+    summary: string;
+    /** What was found, most important first. */
+    findings: TelemetryAssistantFinding[];
+    /** The root cause, or null when none was established. */
+    rootCause: string | null;
+    /** How sure the report is. */
+    confidence: TelemetryAssistantConfidence;
+    /** What to do next. */
+    recommendations: string[];
+    /** Supporting queries the user can re-run (at most 5); the first is the most useful. */
+    queries: TelemetryAssistantQuery[];
+}
+/**
+ * `event: answer` — the final answer.
+ *
+ * @stability stable
+ */
+export interface TelemetryAssistantAnswerEvent {
+    /** Back-compat: queries[0].sql, or null. */
+    sql: string | null;
+    /** Back-compat: the report summary (or the raw text when the model did not return a report). */
+    explanation: string;
+    /** The structured report, or null when the model gave no parseable one. */
+    report: TelemetryAssistantReport | null;
+}
+/**
+ * `event: error` — the turn failed after the stream opened.
+ *
+ * @stability stable
+ */
+export interface TelemetryAssistantErrorEvent {
+    /** A stable error code. */
+    code: string;
+    /** A message for the user. */
+    message: string;
+}
+/**
+ * Every event of the stream, by name, with its payload.
+ *
+ * @stability stable
+ */
+export interface TelemetryAssistantEventMap {
+    /** One tool call. */
+    step: TelemetryAssistantStepEvent;
+    /** The final answer. */
+    answer: TelemetryAssistantAnswerEvent;
+    /** The turn failed. */
+    error: TelemetryAssistantErrorEvent;
+    /** The stream ends. */
+    done: Record<string, never>;
+}
+/**
+ * The name of a stream event.
+ *
+ * @stability stable
+ */
+export type TelemetryAssistantEventName = keyof TelemetryAssistantEventMap;
+/**
+ * A function that writes one stream event (the server's side of the stream).
+ *
+ * @stability stable
+ */
+export type TelemetryAssistantEmit = <E extends TelemetryAssistantEventName>(event: E, data: TelemetryAssistantEventMap[E]) => void;
+//# sourceMappingURL=assistant.d.ts.map

package/dist/esm/telemetry/assistant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant.d.ts","sourceRoot":"","sources":["../../../src/telemetry/assistant.ts"],"names":[],"mappings":"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"}

package/dist/esm/telemetry/assistant.js

@@ -0,0 +1,40 @@
+// =============================================================================
+// POST /api/admin/telemetry/assistant/stream (issue #536; moved here from the
+// API's `telemetry/dto/telemetry-assistant.dto.ts` by #702)
+// =============================================================================
+//
+// The request body is a zod schema. The response is a `text/event-stream`;
+// its frame payloads are the binding web ↔ API contract and are TYPES (the
+// API writes them, nothing parses them on the server), as they always were.
+// =============================================================================
+import { z } from 'zod';
+import { TELEMETRY_ASSISTANT_HISTORY_CONTENT_MAX, TELEMETRY_ASSISTANT_HISTORY_MAX_TURNS, TELEMETRY_ASSISTANT_QUESTION_MAX, TELEMETRY_ASSISTANT_TURN_ROLES, } from './constants.js';
+import { wireEnum } from './enum.js';
+/**
+ * One earlier turn of the conversation: `role` (`user` or `assistant`) and
+ * `content` (at most {@link TELEMETRY_ASSISTANT_HISTORY_CONTENT_MAX} characters).
+ *
+ * @extensionPoint schema
+ * @stability stable
+ */
+export const telemetryAssistantTurnSchema = z.object({
+    /** Who wrote the turn. */
+    role: wireEnum(TELEMETRY_ASSISTANT_TURN_ROLES),
+    /** The turn's text. */
+    content: z.string().max(TELEMETRY_ASSISTANT_HISTORY_CONTENT_MAX),
+});
+/**
+ * `POST /api/admin/telemetry/assistant/stream` body: `question` (trimmed,
+ * 1..{@link TELEMETRY_ASSISTANT_QUESTION_MAX} characters) and an optional
+ * `history` (oldest first, at most {@link TELEMETRY_ASSISTANT_HISTORY_MAX_TURNS}).
+ *
+ * @extensionPoint schema
+ * @stability stable
+ */
+export const telemetryAssistantRequestSchema = z.object({
+    /** The new question, in natural language. */
+    question: z.string().trim().min(1).max(TELEMETRY_ASSISTANT_QUESTION_MAX),
+    /** Earlier turns of this conversation, oldest first. */
+    history: z.array(telemetryAssistantTurnSchema).max(TELEMETRY_ASSISTANT_HISTORY_MAX_TURNS).optional(),
+});
+//# sourceMappingURL=assistant.js.map

package/dist/esm/telemetry/assistant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant.js","sourceRoot":"","sources":["../../../src/telemetry/assistant.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,8EAA8E;AAC9E,4DAA4D;AAC5D,gFAAgF;AAChF,EAAE;AACF,2EAA2E;AAC3E,2EAA2E;AAC3E,4EAA4E;AAC5E,gFAAgF;AAEhF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,uCAAuC,EACvC,qCAAqC,EACrC,gCAAgC,EAChC,8BAA8B,GAK/B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,0BAA0B;IAC1B,IAAI,EAAE,QAAQ,CAAC,8BAA8B,CAAC;IAC9C,uBAAuB;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,uCAAuC,CAAC;CACjE,CAAC,CAAC;AASH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,6CAA6C;IAC7C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,gCAAgC,CAAC;IACxE,wDAAwD;IACxD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC,QAAQ,EAAE;CACrG,CAAC,CAAC"}

package/dist/esm/telemetry/config.d.ts

@@ -0,0 +1,92 @@
+import { z } from 'zod';
+/**
+ * `PUT /api/admin/telemetry/config` body: the stored namespace, with
+ * `instanceId` optional (absent keeps the stored value).
+ *
+ * @extensionPoint schema
+ * @stability stable
+ */
+export declare const updateTelemetryConfigSchema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    retentionDays: z.ZodNumber;
+    query: z.ZodObject<{
+        maxRows: z.ZodNumber;
+        timeoutSeconds: z.ZodNumber;
+    }, z.core.$strip>;
+    assistant: z.ZodObject<{
+        enabled: z.ZodBoolean;
+        provider: z.ZodNullable<z.ZodString>;
+        modelId: z.ZodNullable<z.ZodString>;
+        shareResults: z.ZodBoolean;
+        maxResultRowsToModel: z.ZodNumber;
+        maxSteps: z.ZodNumber;
+    }, z.core.$strip>;
+    instanceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * The `PUT /api/admin/telemetry/config` body.
+ *
+ * @stability stable
+ */
+export type UpdateTelemetryConfigInput = z.infer<typeof updateTelemetryConfigSchema>;
+/**
+ * `GET /api/admin/telemetry/config` (and the `PUT` response): the stored
+ * namespace plus `available`, `retentionApplicable`, `instanceIdDefault`,
+ * `instanceIdEffective`, `version` (send it back as `If-Match`), `updatedAt`
+ * and `updatedBy`.
+ *
+ * @extensionPoint schema
+ * @stability stable
+ */
+export declare const telemetryConfigResponseSchema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    retentionDays: z.ZodNumber;
+    instanceId: z.ZodNullable<z.ZodString>;
+    query: z.ZodObject<{
+        maxRows: z.ZodNumber;
+        timeoutSeconds: z.ZodNumber;
+    }, z.core.$strip>;
+    assistant: z.ZodObject<{
+        enabled: z.ZodBoolean;
+        provider: z.ZodNullable<z.ZodString>;
+        modelId: z.ZodNullable<z.ZodString>;
+        shareResults: z.ZodBoolean;
+        maxResultRowsToModel: z.ZodNumber;
+        maxSteps: z.ZodNumber;
+    }, z.core.$strip>;
+    available: z.ZodBoolean;
+    retentionApplicable: z.ZodBoolean;
+    instanceIdDefault: z.ZodString;
+    instanceIdEffective: z.ZodString;
+    version: z.ZodNumber;
+    updatedAt: z.ZodNullable<z.ZodISODateTime>;
+    updatedBy: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        email: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * `GET /api/admin/telemetry/config`.
+ *
+ * @stability stable
+ */
+export type TelemetryConfigResponse = z.infer<typeof telemetryConfigResponseSchema>;
+/**
+ * `GET /api/telemetry/config`: the feature flag every signed-in client reads
+ * (`available`, `enabled`, `assistantEnabled`).
+ *
+ * @extensionPoint schema
+ * @stability stable
+ */
+export declare const telemetryPublicConfigSchema: z.ZodObject<{
+    available: z.ZodBoolean;
+    enabled: z.ZodBoolean;
+    assistantEnabled: z.ZodBoolean;
+}, z.core.$strip>;
+/**
+ * `GET /api/telemetry/config`.
+ *
+ * @stability stable
+ */
+export type TelemetryPublicConfig = z.infer<typeof telemetryPublicConfigSchema>;
+//# sourceMappingURL=config.d.ts.map

package/dist/esm/telemetry/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/telemetry/config.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;iBAGtC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAErF;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqCxC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B;;;;iBAUtC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}

package/dist/esm/telemetry/config.js

@@ -0,0 +1,98 @@
+// =============================================================================
+// /api/admin/telemetry/config and /api/telemetry/config (issue #534; moved
+// here from the API's `telemetry/dto/telemetry-config.dto.ts` by #702)
+// =============================================================================
+//
+// The PUT body IS the stored `telemetry` namespace, so a form can send back
+// exactly what it loaded (minus the provenance fields the response adds).
+// Full replace: `assistant.provider` / `assistant.modelId` sent as `null`
+// clear a stored value.
+//
+// ONE EXCEPTION TO "FULL": `instanceId` (#565) is OPTIONAL in the PUT body.
+// Absent keeps the stored value, `null` returns to the application-slug
+// default, a string overrides it. A client written before it existed must not
+// get a 400, nor silently reset an identity an administrator set, merely by
+// saving the page. The response always carries it, plus `instanceIdDefault` /
+// `instanceIdEffective` so a form can show what `null` currently means.
+//
+// No credential is part of any of these shapes and none may be added.
+// =============================================================================
+import { z } from 'zod';
+import { telemetrySettingsSchema } from './settings.js';
+/**
+ * `PUT /api/admin/telemetry/config` body: the stored namespace, with
+ * `instanceId` optional (absent keeps the stored value).
+ *
+ * @extensionPoint schema
+ * @stability stable
+ */
+export const updateTelemetryConfigSchema = telemetrySettingsSchema.extend({
+    /** Optional here: absent keeps the stored value, `null` returns to the default, a string overrides it. */
+    instanceId: telemetrySettingsSchema.shape.instanceId.optional(),
+});
+/**
+ * `GET /api/admin/telemetry/config` (and the `PUT` response): the stored
+ * namespace plus `available`, `retentionApplicable`, `instanceIdDefault`,
+ * `instanceIdEffective`, `version` (send it back as `If-Match`), `updatedAt`
+ * and `updatedBy`.
+ *
+ * @extensionPoint schema
+ * @stability stable
+ */
+export const telemetryConfigResponseSchema = telemetrySettingsSchema.extend({
+    /**
+     * Whether a telemetry store is configured (admin UI or deployment default):
+     * a host and the reader login with its password. While false, `enabled` is
+     * stored but nothing is exported or queryable.
+     */
+    available: z.boolean(),
+    /**
+     * Whether the GreptimeDB admin login is configured (admin UI or deployment
+     * default), which retention needs. While false, `retentionDays` is stored
+     * but not applied.
+     */
+    retentionApplicable: z.boolean(),
+    /**
+     * What a `null` `instanceId` resolves to: the application slug (`APP_SLUG`,
+     * derived from the product name). Read-only.
+     */
+    instanceIdDefault: z.string(),
+    /**
+     * The identifier currently stamped as the `app.instance.id` resource
+     * attribute on exported telemetry: `instanceId` when set, else
+     * `instanceIdDefault`. Read-only.
+     */
+    instanceIdEffective: z.string(),
+    /** The system-settings row version — send it back as `If-Match` on `PUT`. `0` when nothing is stored yet. */
+    version: z.number().int(),
+    /** When the namespace was last saved, or `null` when nothing is stored yet. */
+    updatedAt: z.iso.datetime().nullable(),
+    /** Who saved it last, or `null`. */
+    updatedBy: z
+        .object({
+        /** The user's id. */
+        id: z.string(),
+        /** The user's email. */
+        email: z.string(),
+    })
+        .nullable(),
+});
+/**
+ * `GET /api/telemetry/config`: the feature flag every signed-in client reads
+ * (`available`, `enabled`, `assistantEnabled`).
+ *
+ * @extensionPoint schema
+ * @stability stable
+ */
+export const telemetryPublicConfigSchema = z.object({
+    /** A telemetry store is configured (admin UI or deployment default). False hides every telemetry surface. */
+    available: z.boolean(),
+    /** `telemetry.enabled` — whether this deployment is currently collecting telemetry. */
+    enabled: z.boolean(),
+    /**
+     * `telemetry.assistant.enabled` — whether the telemetry AI assistant is
+     * switched on. Whether the AI platform itself is on is `GET /api/ai/config`.
+     */
+    assistantEnabled: z.boolean(),
+});
+//# sourceMappingURL=config.js.map

package/dist/esm/telemetry/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/telemetry/config.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,2EAA2E;AAC3E,uEAAuE;AACvE,gFAAgF;AAChF,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,0EAA0E;AAC1E,wBAAwB;AACxB,EAAE;AACF,4EAA4E;AAC5E,wEAAwE;AACxE,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAC9E,wEAAwE;AACxE,EAAE;AACF,sEAAsE;AACtE,gFAAgF;AAEhF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,uBAAuB,CAAC,MAAM,CAAC;IACxE,0GAA0G;IAC1G,UAAU,EAAE,uBAAuB,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE;CAChE,CAAC,CAAC;AASH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAC1E;;;;OAIG;IACH,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB;;;;OAIG;IACH,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE;IAChC;;;OAGG;IACH,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC7B;;;;OAIG;IACH,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC/B,6GAA6G;IAC7G,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACzB,+EAA+E;IAC/E,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACtC,oCAAoC;IACpC,SAAS,EAAE,CAAC;SACT,MAAM,CAAC;QACN,qBAAqB;QACrB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,wBAAwB;QACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;KAClB,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC;AASH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,6GAA6G;IAC7G,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,uFAAuF;IACvF,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB;;;OAGG;IACH,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE;CAC9B,CAAC,CAAC"}