@a2anet/a2a-utils 0.1.0 → 0.3.0

package/dist/artifacts/data.d.ts

@@ -0,0 +1,118 @@
+/** Data artifact operations: viewing and minimization. */
+export declare class DataArtifacts {
+    /**
+     * View structured data with optional filtering.
+     *
+     * @param data - The data to view.
+     * @param opts.jsonPath - Optional dot-separated path to extract specific fields.
+     * @param opts.rows - Optional row selection.
+     * @param opts.columns - Optional column selection.
+     * @param opts.characterLimit - Maximum output size in characters.
+     *
+     * @returns Filtered data.
+     *
+     * @throws Error if parameters are invalid.
+     */
+    static view(data: unknown, opts?: {
+        jsonPath?: string | null;
+        rows?: number | number[] | string | null;
+        columns?: string | string[] | null;
+        characterLimit?: number;
+    }): unknown;
+    /**
+     * Minimize data content for display based on type.
+     *
+     * @param data - The data to minimize.
+     * @param opts.characterLimit - Character limit above which to minimize.
+     * @param opts.minimizedObjectStringLength - Max length for string values in objects.
+     * @param opts.tip - Tip to include. Defaults to null (no tip); pass a string to include one.
+     *
+     * @returns Minimized representation with "data" or "text" key.
+     */
+    static minimize(data: unknown, opts?: {
+        characterLimit?: number;
+        minimizedObjectStringLength?: number;
+        tip?: string | null;
+    }): Record<string, unknown>;
+    /**
+     * Generate a comprehensive summary of tabular data (list of objects).
+     *
+     * @param data - List of objects representing table rows.
+     *
+     * @returns List of column summaries, or the original data if the summary
+     *     would be larger (inflation guard).
+     */
+    static summarizeTable(data: Record<string, unknown>[]): Record<string, unknown>[] | Record<string, unknown>[];
+    /**
+     * Generate a summary of a list of values (like a single column).
+     *
+     * @param values - List of values to summarize.
+     *
+     * @returns Object with column-like statistics, or the original list if
+     *     the summary would be larger (inflation guard).
+     */
+    static summarizeValues(values: unknown[]): Record<string, unknown> | unknown[];
+    /**
+     * Minimize an object for display.
+     *
+     * If JSON-stringified length is <= characterLimit chars, return it in full.
+     * If > characterLimit chars, show all keys but truncate string values and summarize lists.
+     *
+     * @param obj - The object to minimize.
+     * @param opts.characterLimit - Character limit above which to minimize.
+     * @param opts.minimizedObjectStringLength - Max length for string values.
+     * @param opts.tip - Tip to include. Defaults to null (no tip); pass a string to include one.
+     *
+     * @returns Object with "data" key containing the minimized content.
+     */
+    private static minimizeObject;
+    /**
+     * Evaluate a JSONPath-like expression for field access only.
+     *
+     * Supports:
+     * - "field" - top-level field
+     * - "field.nested" - nested field access
+     *
+     * Does NOT support array indexing - use rows/columns parameters instead.
+     *
+     * @param data - The data to query.
+     * @param path - The dot-separated field path.
+     *
+     * @returns The extracted value.
+     *
+     * @throws TypeError if trying to access field on non-object.
+     * @throws Error if field doesn't exist.
+     */
+    private static evaluateJsonPath;
+    /**
+     * Parse the row selection parameter into a list of row indices.
+     *
+     * @param rows - Can be a single row index (number), list of indices, range string ("0-10"), or "all".
+     * @param totalRows - Total number of rows in the dataset.
+     *
+     * @returns List of row indices to include.
+     */
+    private static parseRowSelection;
+    /**
+     * Parse the column selection parameter into a list of column names.
+     *
+     * @param columns - Can be a single column name (string), list of column names, or "all".
+     * @param availableColumns - List of all available column names in the dataset.
+     *
+     * @returns List of column names to include.
+     */
+    private static parseColumnSelection;
+    /**
+     * Filter data by row indices and column names.
+     *
+     * @param data - The full dataset.
+     * @param rowIndices - List of row indices to include.
+     * @param columnNames - List of column names to include.
+     *
+     * @returns Filtered data.
+     */
+    private static filterDataByRowsAndColumns;
+    /** Recursively minimize values in an object. */
+    private static minimizeObjectValues;
+}
+//# sourceMappingURL=data.d.ts.map

package/dist/artifacts/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../src/artifacts/data.ts"],"names":[],"mappings":"AAiEA,0DAA0D;AAC1D,qBAAa,aAAa;IACtB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAI,CACP,IAAI,EAAE,OAAO,EACb,IAAI,CAAC,EAAE;QACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC;QACzC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;QACnC,cAAc,CAAC,EAAE,MAAM,CAAC;KAC3B,GACF,OAAO;IA4FV;;;;;;;;;OASG;IACH,MAAM,CAAC,QAAQ,CACX,IAAI,EAAE,OAAO,EACb,IAAI,CAAC,EAAE;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,2BAA2B,CAAC,EAAE,MAAM,CAAC;QACrC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,GACF,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAuE1B;;;;;;;OAOG;IACH,MAAM,CAAC,cAAc,CACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;IAiCxD;;;;;;;OAOG;IACH,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE;IAiG9E;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAqC7B;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IA4B/B;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAiFhC;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IA8BnC;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IA2BzC,gDAAgD;IAChD,OAAO,CAAC,MAAM,CAAC,oBAAoB;CA2EtC"}