@morscherlab/mint-sdk 1.0.57 → 1.0.58

package/dist/index.js

@@ -1,4 +1,4 @@
-import { $ as AutoGroupModal_default, A as ScientificNumber_default, At as ColorSlider_default, B as BioTemplateRenderer_default, C as estimateSequenceFinishDate, Ct as AppToastContainer_default, D as sequenceProgressPercent, Dt as DropdownButton_default, E as formatSequenceRemaining, Et as Calendar_default, F as GroupAssigner_default, G as StatusIndicator_default, H as Breadcrumb_default, I as RackEditor_default, J as DoseDesignWorkspaceView_default, K as Divider_default, L as BioTemplatePresetWorkspaceView_default, M as SampleHierarchyTree_default, N as ReagentEditor_default, O as sequenceSamplesRemaining, Ot as SegmentedControl_default, P as SmartGroupModal_default, Q as SampleSelector_default, R as BioTemplatePackWorkspaceView_default, S as SequenceProgressBar_default, St as IconButton_default, T as formatSequenceEta, Tt as DataFrame_default, U as Avatar_default, V as ChartContainer_default, W as ProgressBar_default, X as ComponentBindingRenderer_default, Y as ControlWorkspaceView_default, Z as ScheduleCalendar_default, _ as lcmsWellIdFromPosition, _t as AppPluginSwitcher_default, a as ResourceCard_default, at as SampleLegend_default, b as InstrumentStateBadge_default, bt as CollapsibleCard_default, c as JobsStatusTray_default, ct as DoseCalculator_default, d as LcmsSequenceTable_default, dt as AppLayout_default, et as SmartGroupManual_default, f as DEFAULT_LCMS_SEQUENCE_COLUMNS, ft as AppSidebar_default, g as inferLcmsPlateTypeFromWellIds, gt as AppTopBar_default, h as extractLcmsSampleName, ht as StepWizard_default, i as ArtifactSelectorModal_default, it as PlateMapEditor_default, j as ProtocolStepEditor_default, k as ChemicalFormula_default, kt as BaseTabs_default, l as BatchProgressList_default, lt as PluginWorkspaceView_default, m as extractLcmsCommonPrefix, mt as FormActions_default, n as FitPanel_default, nt as LoadingSpinner_default, o as TimeRangeInput_default, ot as WellPlate_default, p as basenameFromWindowsPath, pt as FormBuilder_default, q as AppContainer_default, r as ArtifactSaveDialog_default, rt as ReagentList_default, s as ExperimentDataViewer_default, st as ExperimentTimeline_default, tt as SmartGroupFieldRecipe_default, u as AuditTrail_default, ut as MobileSupportGate_default, v as reconstructLcmsPlateCellsFromSequenceItems, vt as AppAvatarMenu_default, w as estimateSequenceRemainingSeconds, wt as AlertBox_default, x as InstrumentAlertLog_default, xt as ThemeToggle_default, y as InstrumentStatusCard_default, yt as PluginIcon_default, z as BioTemplateExperimentWorkspaceView_default } from "./components-PC3SVsaa.js";
+import { $ as AutoGroupModal_default, A as ScientificNumber_default, At as ColorSlider_default, B as BioTemplateRenderer_default, C as estimateSequenceFinishDate, Ct as AppToastContainer_default, D as sequenceProgressPercent, Dt as DropdownButton_default, E as formatSequenceRemaining, Et as Calendar_default, F as GroupAssigner_default, G as StatusIndicator_default, H as Breadcrumb_default, I as RackEditor_default, J as DoseDesignWorkspaceView_default, K as Divider_default, L as BioTemplatePresetWorkspaceView_default, M as SampleHierarchyTree_default, N as ReagentEditor_default, O as sequenceSamplesRemaining, Ot as SegmentedControl_default, P as SmartGroupModal_default, Q as SampleSelector_default, R as BioTemplatePackWorkspaceView_default, S as SequenceProgressBar_default, St as IconButton_default, T as formatSequenceEta, Tt as DataFrame_default, U as Avatar_default, V as ChartContainer_default, W as ProgressBar_default, X as ComponentBindingRenderer_default, Y as ControlWorkspaceView_default, Z as ScheduleCalendar_default, _ as lcmsWellIdFromPosition, _t as AppPluginSwitcher_default, a as ResourceCard_default, at as SampleLegend_default, b as InstrumentStateBadge_default, bt as CollapsibleCard_default, c as JobsStatusTray_default, ct as DoseCalculator_default, d as LcmsSequenceTable_default, dt as AppLayout_default, et as SmartGroupManual_default, f as DEFAULT_LCMS_SEQUENCE_COLUMNS, ft as AppSidebar_default, g as inferLcmsPlateTypeFromWellIds, gt as AppTopBar_default, h as extractLcmsSampleName, ht as StepWizard_default, i as ArtifactSelectorModal_default, it as PlateMapEditor_default, j as ProtocolStepEditor_default, k as ChemicalFormula_default, kt as BaseTabs_default, l as BatchProgressList_default, lt as PluginWorkspaceView_default, m as extractLcmsCommonPrefix, mt as FormActions_default, n as FitPanel_default, nt as LoadingSpinner_default, o as TimeRangeInput_default, ot as WellPlate_default, p as basenameFromWindowsPath, pt as FormBuilder_default, q as AppContainer_default, r as ArtifactSaveDialog_default, rt as ReagentList_default, s as ExperimentDataViewer_default, st as ExperimentTimeline_default, tt as SmartGroupFieldRecipe_default, u as AuditTrail_default, ut as MobileSupportGate_default, v as reconstructLcmsPlateCellsFromSequenceItems, vt as AppAvatarMenu_default, w as estimateSequenceRemainingSeconds, wt as AlertBox_default, x as InstrumentAlertLog_default, xt as ThemeToggle_default, y as InstrumentStatusCard_default, yt as PluginIcon_default, z as BioTemplateExperimentWorkspaceView_default } from "./components-CpnOaPbP.js";
 import { t as BaseButton_default } from "./BaseButton-Dgqrze41.js";
 import { r as BaseInput_default, t as BaseSelect_default } from "./BaseSelect-ekgr9fDo.js";
 import { $ as parseTime, A as useConcentrationUnits, B as TagsInput_default, C as controlsToViewIds, D as getTypeDefault, E as getFieldRegistryEntry, F as ATOMIC_WEIGHTS, G as findAvailableSlots, H as addMinutes, I as useChemicalFormula, J as formatTime, K as findNearestTimeSlotIndex, L as DateTimePicker_default, M as SequenceInput_default, N as useSequenceUtils, O as ConcentrationInput_default, P as FormulaInput_default, Q as isTimeInRange, R as FileUploader_default, S as controlsToTopBarSettingsConfig, T as getDefaultControlView, U as compareTime, V as TimePicker_default, W as durationMinutes, X as fromMinutes, Y as formatTimeSlot, Z as generateTimeSlots, _ as controlsToFormSchema, a as defineDoseCalculatorControlProps, at as MultiSelect_default, b as controlsToSettingsSchema, c as defineWellPlateDoseComponentBindings, ct as BaseSlider_default, d as defineControlModel, dt as BaseCheckbox_default, et as rangesOverlap, ft as Tooltip_default, h as controlValuesToComponentProps, i as useControlSchema, it as DatePicker_default, j as MoleculeInput_default, k as UnitInput_default, l as defineWellPlateDoseControlProps, lt as BaseRadioGroup_default, m as controlValuesToComponentBindingsById, n as defineControls, nt as toMinutes, o as defineDoseDesignControlModel, ot as useListSelection, p as controlValuesToComponentBindings, pt as BaseTextarea_default, q as formatDuration, r as getControlDefaults, rt as useTimeUtils, s as defineWellPlateControlProps, st as useSelectionLimit, t as defineControlComponentBindings, tt as snapToSlot, u as useControlWorkspace, ut as BaseToggle_default, v as controlsToSectionFormSchema, w as controlsToViewItems, x as controlsToSidebarPanels, y as controlsToSectionFormSchemas, z as NumberInput_default } from "./useControlSchema-BZNdalmL.js";

package/dist/install.js

@@ -1,4 +1,4 @@
-import { t as components_exports } from "./components-PC3SVsaa.js";
+import { t as components_exports } from "./components-CpnOaPbP.js";
 import "./BaseButton-Dgqrze41.js";
 import "./BaseSelect-ekgr9fDo.js";
 import "./useControlSchema-BZNdalmL.js";

package/dist/types/analysisArtifactTypes.d.ts

@@ -39,6 +39,8 @@ export interface AnalysisArtifactMetadataUpdate {
 }
 /** How a save payload should be applied by the plugin backend. */
 export type ArtifactSaveMode = 'create' | 'upsert' | 'update';
+/** Where file content comes from when a plugin uses ArtifactSaveDialog. */
+export type ArtifactFileSource = 'upload' | 'handler';
 interface ArtifactSavePayloadBase {
     experimentId: number;
     artifactKey: string;
@@ -85,7 +87,34 @@ export interface FileArtifactUpdatePayload extends ArtifactSavePayloadBase {
     contentType?: string;
     metadata?: Record<string, unknown>;
 }
+/**
+ * File artifact create where the plugin handler produces the bytes itself.
+ * This is intended for server-side serialization of in-memory analysis state;
+ * the browser neither fabricates nor uploads a placeholder File.
+ */
+export interface HandlerFileArtifactCreatePayload extends ArtifactSavePayloadBase {
+    kind: 'file';
+    mode: 'create';
+    source: 'handler';
+    fileKind: string;
+    displayName?: string;
+    note?: string;
+    metadata?: Record<string, unknown>;
+}
+/** File artifact replacement where the plugin handler produces the bytes itself. */
+export interface HandlerFileArtifactUpdatePayload extends ArtifactSavePayloadBase {
+    kind: 'file';
+    mode: 'update';
+    source: 'handler';
+    fileKind: string;
+    note?: string | null;
+    metadata?: Record<string, unknown>;
+}
 export type ArtifactSavePayload = JsonArtifactSavePayload | FileArtifactCreatePayload | FileArtifactUpdatePayload;
+/** Payloads accepted when `ArtifactSaveDialog.fileSource` is `handler`. */
+export type HandlerArtifactSavePayload = JsonArtifactSavePayload | HandlerFileArtifactCreatePayload | HandlerFileArtifactUpdatePayload;
+/** Every payload variant the dialog can emit across both file sources. */
+export type ArtifactSaveDialogPayload = ArtifactSavePayload | HandlerFileArtifactCreatePayload | HandlerFileArtifactUpdatePayload;
 /** Optional handler result; cleanupPending surfaces AnalysisFileArtifactUpdate.cleanup_pending. */
 export interface ArtifactSaveResult {
     artifact?: AnalysisArtifactSummary;
@@ -97,4 +126,8 @@ export interface ArtifactSaveResult {
  * save_analysis_artifact / save_analysis_file_artifact / update_analysis_file_artifact.
  */
 export type ArtifactSaveHandler = (payload: ArtifactSavePayload) => Promise<ArtifactSaveResult | void>;
+/** Save handler paired with `ArtifactSaveDialog.fileSource="handler"`. */
+export type HandlerArtifactSaveHandler = (payload: HandlerArtifactSavePayload) => Promise<ArtifactSaveResult | void>;
+/** Handler accepted by ArtifactSaveDialog; `fileSource` selects the payload family. */
+export type ArtifactSaveDialogHandler = ArtifactSaveHandler | HandlerArtifactSaveHandler;
 export {};

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
 export type { ContainerDirection, ButtonVariant, ButtonSize, InputType, ModalSize, ModalVariant, AlertType, Toast, TabItem, TabItemInput, OptionPrimitive, SelectOption, SelectOptionInput, RadioOption, RadioOptionInput, FormFieldProps, SidebarBadgeTone, SidebarToolSection, SidebarToolSectionAction, CollapsibleState, TopBarVariant, TopBarSettingsConfig, PillNavOption, PillNavOptionInput, PillNavItem, PillNavItemInput, PageSelectorItem, PageSelectorItemInput, PluginSwitcherPlugin, PluginSwitcherInfo, AccountMenuItem, WellPlateFormat, WellState, WellPlateSelectionMode, WellPlateSize, WellShape, Well, HeatmapColorScale, HeatmapConfig, SlotPosition, WellExtendedData, WellEditData, WellEditField, WellSampleDropData, WellSampleDropContext, WellSampleDropParser, WellLegendItem, PlateCondition, ColumnCondition, RowCondition, Rack, RackSampleDropContext, RackSampleDropMapper, SampleType, PlateMap, PlateMapEditorState, ProtocolStepType, ProtocolStepStatus, ProtocolStep, SampleGroup, GroupItem, FileUploaderMode, SegmentedOption, SegmentedOptionInput, SegmentedControlVariant, SegmentedControlSize, MultiSelectOption, MultiSelectOptionInput, MultiSelectSize, PillVariant, PillColor, PillSize, CalendarSelectionMode, CalendarMarker, CalendarDayContext, SortDirection, SortState, DataFrameColumn, PaginationState, SpinnerSize, SpinnerVariant, DividerSpacing, StatusType, ProgressVariant, ProgressSize, AvatarSize, EmptyStateColor, EmptyStateSize, BreadcrumbItem, BreadcrumbItemInput, TooltipPosition, ConfirmVariant, SettingsTab, SettingsTabInput, SettingsModalLayout, SettingsGroup, SettingsModalSchema, SettingsUserType, SettingsAudience, SettingsAudienceInput, NumberNotation, UnitOption, WizardStep, WizardStepState, AuditEntryType, AuditEntry, BatchItemStatus, BatchItem, BatchSummary, TimePickerFormat, TimeRange, ScheduleView, ScheduleEventStatus, ScheduleEvent, ScheduleBlockedSlot, ScheduleSlotContext, ScheduleEventCreateContext, ScheduleEventUpdateContext, SummarySectionItem, SummarySection, SummaryData, ResourceStatus, ResourceSpec, MoleculeData, ExperimentStatus, DatePreset, ExperimentSortField, ExperimentTypeOption, ExperimentSummary, ExperimentListResponse, ExperimentFilters, FitState, FitResultSummary, StorageCondition, ReagentColumn, Reagent, TreeNodeType, BadgeVariant, TreeNode, } from './components';
-export type { AnalysisArtifactStatus, AnalysisArtifactStatusFilter, AnalysisArtifactSummary, AnalysisArtifactDetail, AnalysisArtifactListResponse, AnalysisArtifactMetadataUpdate, ArtifactSaveMode, JsonArtifactSavePayload, FileArtifactCreatePayload, FileArtifactUpdatePayload, ArtifactSavePayload, ArtifactSaveResult, ArtifactSaveHandler, } from './analysisArtifactTypes';
+export type { AnalysisArtifactStatus, AnalysisArtifactStatusFilter, AnalysisArtifactSummary, AnalysisArtifactDetail, AnalysisArtifactListResponse, AnalysisArtifactMetadataUpdate, ArtifactSaveMode, ArtifactFileSource, JsonArtifactSavePayload, FileArtifactCreatePayload, FileArtifactUpdatePayload, HandlerFileArtifactCreatePayload, HandlerFileArtifactUpdatePayload, ArtifactSavePayload, HandlerArtifactSavePayload, ArtifactSaveDialogPayload, ArtifactSaveResult, ArtifactSaveHandler, HandlerArtifactSaveHandler, ArtifactSaveDialogHandler, } from './analysisArtifactTypes';
 export { ANALYSIS_FILE_ARTIFACT_SCHEMA } from './analysisArtifactTypes';
 export type { JobListPayload, JobProgress, JobSnapshotPayload, JobState, JobStateInput, JobStatus, JobStreamData, } from './jobs';
 export type { InstrumentAlert, InstrumentAlertBody, InstrumentAlertLevel, InstrumentState, InstrumentStatus, SampleInfo, SampleInfo as InstrumentSampleInfo, SequenceProgress, } from './instrument';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morscherlab/mint-sdk",
-  "version": "1.0.57",
+  "version": "1.0.58",
   "description": "MINT Platform SDK — Vue 3 components, composables, and types for plugin development. MINT = Mass-spec INtegrated Toolkit.",
   "type": "module",
   "main": "./dist/index.js",

package/src/__tests__/components/ArtifactSaveDialog.test.ts

@@ -1,11 +1,12 @@
 import { mount, flushPromises } from '@vue/test-utils'
-import { describe, it, expect, vi, beforeEach } from 'vitest'
+import { describe, it, expect, expectTypeOf, vi, beforeEach } from 'vitest'
 import ArtifactSaveDialog from '../../components/ArtifactSaveDialog.vue'
 import FileUploader from '../../components/FileUploader.vue'
 import SegmentedControl from '../../components/SegmentedControl.vue'
 import { ANALYSIS_FILE_ARTIFACT_SCHEMA } from '../../types/analysisArtifactTypes'
 import type {
   AnalysisArtifactDetail,
+  ArtifactSaveDialogPayload,
   ArtifactSavePayload,
   ArtifactSaveResult,
 } from '../../types/analysisArtifactTypes'
@@ -46,7 +47,7 @@ function makeFileDetail(overrides: Partial<AnalysisArtifactDetail> = {}): Analys
 }
 
 function mountDialog(props: Record<string, unknown> = {}) {
-  const saveHandler = vi.fn<(payload: ArtifactSavePayload) => Promise<ArtifactSaveResult | void>>()
+  const saveHandler = vi.fn<(payload: ArtifactSaveDialogPayload) => Promise<ArtifactSaveResult | void>>()
     .mockResolvedValue(undefined)
   const wrapper = mount(ArtifactSaveDialog, {
     props: {
@@ -82,6 +83,12 @@ describe('ArtifactSaveDialog', () => {
     window.history.replaceState({}, '', '/')
   })
 
+  it('should keep browser File required in the existing upload handler contract', () => {
+    type UploadFilePayload = Extract<ArtifactSavePayload, { kind: 'file' }>
+
+    expectTypeOf<UploadFilePayload['file']>().toEqualTypeOf<File>()
+  })
+
   // -------------------------------------------------------------------------
   // JSON create
   // -------------------------------------------------------------------------
@@ -131,7 +138,7 @@ describe('ArtifactSaveDialog', () => {
 
       const saved = wrapper.emitted('saved')
       expect(saved).toHaveLength(1)
-      expect((saved![0][0] as { payload: ArtifactSavePayload }).payload.kind).toBe('json')
+      expect((saved![0][0] as { payload: ArtifactSaveDialogPayload }).payload.kind).toBe('json')
       expect(wrapper.emitted('update:modelValue')?.at(-1)).toEqual([false])
     })
 
@@ -193,14 +200,16 @@ describe('ArtifactSaveDialog', () => {
 
       expect(saveHandler).toHaveBeenCalledOnce()
       const payload = saveHandler.mock.calls[0][0]
-      expect(payload).toMatchObject({
+      expect(payload).toEqual({
         kind: 'file',
         mode: 'create',
         experimentId: 42,
         artifactKey: 'default',
+        file: TEST_FILE,
         fileKind: 'file',
+        filename: 'plot.png',
+        contentType: 'image/png',
       })
-      expect((payload as { file: File }).file).toBe(TEST_FILE)
     })
 
     it('should use the defaultFileKind prop', async () => {
@@ -211,6 +220,27 @@ describe('ArtifactSaveDialog', () => {
 
       expect((saveHandler.mock.calls[0][0] as { fileKind: string }).fileKind).toBe('plot')
     })
+
+    it('should hide the uploader when file content is owned by the handler', () => {
+      const { wrapper } = mountDialog({ mode: 'file', fileSource: 'handler' })
+
+      expect(wrapper.findComponent(FileUploader).exists()).toBe(false)
+    })
+
+    it('should submit a handler-owned file create without a browser File', async () => {
+      const { wrapper, saveHandler } = mountDialog({ mode: 'file', fileSource: 'handler' })
+
+      await submit(wrapper)
+
+      expect(saveHandler.mock.calls[0][0]).toEqual({
+        kind: 'file',
+        source: 'handler',
+        mode: 'create',
+        experimentId: 42,
+        artifactKey: 'default',
+        fileKind: 'file',
+      })
+    })
   })
 
   // -------------------------------------------------------------------------
@@ -435,6 +465,26 @@ describe('ArtifactSaveDialog', () => {
 
       expect(saveHandler.mock.calls[0][0].note).toBe('re-measured')
     })
+
+    it('should submit a handler-owned file update without a browser File', async () => {
+      const { wrapper, saveHandler } = mountDialog({
+        existingArtifact: makeFileDetail(),
+        fileSource: 'handler',
+      })
+      await wrapper.get('.mint-artifact-save-dialog__note textarea').setValue('')
+
+      await submit(wrapper)
+
+      expect(saveHandler.mock.calls[0][0]).toEqual({
+        kind: 'file',
+        source: 'handler',
+        mode: 'update',
+        experimentId: 42,
+        artifactKey: 'report',
+        fileKind: 'report',
+        note: null,
+      })
+    })
   })
 
   // -------------------------------------------------------------------------

package/src/components/ArtifactSaveDialog.story.vue

@@ -4,7 +4,7 @@ import ArtifactSaveDialog from './ArtifactSaveDialog.vue'
 import {
   ANALYSIS_FILE_ARTIFACT_SCHEMA,
   type AnalysisArtifactDetail,
-  type ArtifactSavePayload,
+  type ArtifactSaveDialogPayload,
 } from '../types/analysisArtifactTypes'
 
 // -- Mock JSON result a plugin would hand the dialog --
@@ -48,10 +48,10 @@ const existingJsonArtifact: AnalysisArtifactDetail = {
 }
 
 // -- Mock handlers standing in for a generated plugin-client call --
-const lastPayload = ref<ArtifactSavePayload | null>(null)
+const lastPayload = ref<ArtifactSaveDialogPayload | null>(null)
 
 /** Files can't be JSON-serialized; show their name instead. */
-function formatPayload(payload: ArtifactSavePayload): string {
+function formatPayload(payload: ArtifactSaveDialogPayload): string {
   return JSON.stringify(
     payload,
     (_key, value) => (value instanceof File ? `File(${value.name})` : value),
@@ -63,13 +63,13 @@ function delay(ms: number) {
   return new Promise((resolve) => setTimeout(resolve, ms))
 }
 
-async function saveHandler(payload: ArtifactSavePayload) {
+async function saveHandler(payload: ArtifactSaveDialogPayload) {
   lastPayload.value = payload
   await delay(600)
   return { cleanupPending: payload.mode === 'update' }
 }
 
-async function failingHandler(payload: ArtifactSavePayload) {
+async function failingHandler(payload: ArtifactSaveDialogPayload) {
   lastPayload.value = payload
   await delay(600)
   throw new Error('Plugin backend unavailable (503)')
@@ -83,6 +83,7 @@ const isOpenUpdateFile = ref(false)
 const isOpenUpdateJson = ref(false)
 const isOpenCollision = ref(false)
 const isOpenFileConflict = ref(false)
+const isOpenHandlerFile = ref(false)
 const isOpenError = ref(false)
 </script>
 
@@ -196,6 +197,31 @@ const isOpenError = ref(false)
       </div>
     </Variant>
 
+    <Variant title="Handler-Owned File">
+      <div style="padding: 2rem;">
+        <p style="font-size: 0.8125rem; color: var(--text-muted, #94a3b8); margin: 0 0 1rem;">
+          The plugin backend serializes the file content. No browser file is requested; the handler
+          receives <code>source: 'handler'</code> with the artifact metadata.
+        </p>
+        <button
+          style="padding: 0.5rem 1rem; background: var(--color-primary, #6366F1); color: white; border: none; border-radius: 6px; cursor: pointer; font-size: 0.875rem;"
+          @click="isOpenHandlerFile = true"
+        >
+          Save Server-Generated File
+        </button>
+
+        <ArtifactSaveDialog
+          v-model="isOpenHandlerFile"
+          :experiment-id="42"
+          mode="file"
+          file-source="handler"
+          default-artifact-key="analysis-session"
+          default-file-kind="session"
+          :save-handler="saveHandler"
+        />
+      </div>
+    </Variant>
+
     <Variant title="Update JSON Artifact">
       <div style="padding: 2rem;">
         <p style="font-size: 0.8125rem; color: var(--text-muted, #94a3b8); margin: 0 0 1rem;">

package/src/components/ArtifactSaveDialog.vue

@@ -17,18 +17,23 @@ import {
 import {
   ANALYSIS_FILE_ARTIFACT_SCHEMA,
   type AnalysisArtifactDetail,
+  type ArtifactFileSource,
+  type ArtifactSaveDialogHandler,
+  type ArtifactSaveDialogPayload,
   type ArtifactSaveHandler,
-  type ArtifactSavePayload,
   type ArtifactSaveResult,
+  type HandlerArtifactSaveHandler,
 } from '../types/analysisArtifactTypes'
 import type { ModalSize } from '../types'
 
 interface Props {
   modelValue: boolean
   /** Performs the backend write; the dialog never calls the platform itself. */
-  saveHandler: ArtifactSaveHandler
+  saveHandler: ArtifactSaveDialogHandler
   /** Which artifact kinds the form offers. */
   mode?: 'json' | 'file' | 'both'
+  /** Use `handler` when the plugin backend serializes the file content itself. */
+  fileSource?: ArtifactFileSource
   /** JSON result payload supplied programmatically by the host. */
   result?: Record<string, unknown>
   /** Experiment id override; defaults to platform injection or URL. */
@@ -57,6 +62,7 @@ interface Props {
 
 const props = withDefaults(defineProps<Props>(), {
   mode: 'file',
+  fileSource: 'upload',
   experimentId: null,
   existingArtifact: null,
   size: 'md',
@@ -66,7 +72,7 @@ const props = withDefaults(defineProps<Props>(), {
 
 const emit = defineEmits<{
   'update:modelValue': [value: boolean]
-  saved: [result: ArtifactSaveResult & { payload: ArtifactSavePayload }]
+  saved: [result: ArtifactSaveResult & { payload: ArtifactSaveDialogPayload }]
   error: [message: string]
   cancel: []
 }>()
@@ -128,7 +134,9 @@ watch(
 const resolvedTitle = computed(() =>
   props.title ?? (isUpdate.value ? 'Update Analysis Artifact' : 'Save Analysis Artifact'))
 const showKindToggle = computed(() => !isUpdate.value && props.mode === 'both')
-const showFileInput = computed(() => activeKind.value === 'file')
+const showFileUploader = computed(
+  () => activeKind.value === 'file' && props.fileSource === 'upload',
+)
 // save_analysis_artifact ignores note=None (it preserves), so a JSON artifact's
 // note cannot be cleared through the save path — that belongs to updateMetadata.
 // update_analysis_file_artifact does honour the not-provided/null/value sentinel.
@@ -153,7 +161,9 @@ const keyError = computed(() => {
 
 const canSubmit = computed(() => {
   if (request.loading.value || !keyValid.value || keyBlocked.value) return false
-  if (activeKind.value === 'file') return selectedFile.value !== null
+  if (activeKind.value === 'file') {
+    return props.fileSource === 'handler' || selectedFile.value !== null
+  }
   return props.result !== undefined
 })
 
@@ -177,7 +187,7 @@ function updateNotePayload(): { note?: string | null } {
   return value ? { note: value } : { note: null }
 }
 
-function buildPayload(experimentId: number): ArtifactSavePayload | null {
+function buildPayload(experimentId: number): ArtifactSaveDialogPayload | null {
   const base = {
     experimentId,
     artifactKey: effectiveKey.value,
@@ -198,12 +208,23 @@ function buildPayload(experimentId: number): ArtifactSavePayload | null {
       result: props.result,
     }
   }
-  const file = selectedFile.value
-  if (!file) return null
   if (isUpdate.value) {
     // Metadata replaces rather than merges backend-side, so send the full intended
     // map: the caller's override, else whatever the artifact already carries.
     const metadata = props.metadata ?? existingMetadata.value
+    if (props.fileSource === 'handler') {
+      return {
+        kind: 'file',
+        source: 'handler',
+        mode: 'update',
+        ...base,
+        ...updateNotePayload(),
+        fileKind: existingFileKind.value ?? props.defaultFileKind,
+        ...(metadata ? { metadata } : {}),
+      }
+    }
+    const file = selectedFile.value
+    if (!file) return null
     return {
       kind: 'file',
       mode: 'update',
@@ -217,6 +238,20 @@ function buildPayload(experimentId: number): ArtifactSavePayload | null {
     }
   }
   const displayName = displayNameInput.value.trim()
+  if (props.fileSource === 'handler') {
+    return {
+      kind: 'file',
+      source: 'handler',
+      mode: 'create',
+      ...base,
+      ...createNotePayload(),
+      fileKind: props.defaultFileKind,
+      ...(displayName ? { displayName } : {}),
+      ...(props.metadata ? { metadata: props.metadata } : {}),
+    }
+  }
+  const file = selectedFile.value
+  if (!file) return null
   return {
     kind: 'file',
     mode: 'create',
@@ -231,6 +266,21 @@ function buildPayload(experimentId: number): ArtifactSavePayload | null {
   }
 }
 
+function runSaveHandler(
+  payload: ArtifactSaveDialogPayload,
+): Promise<ArtifactSaveResult | void> {
+  if (props.fileSource === 'handler') {
+    if (payload.kind === 'file' && !('source' in payload)) {
+      throw new Error('ArtifactSaveDialog built an upload payload for a handler-owned file.')
+    }
+    return (props.saveHandler as HandlerArtifactSaveHandler)(payload)
+  }
+  if (payload.kind === 'file' && 'source' in payload) {
+    throw new Error('ArtifactSaveDialog built a handler-owned payload for an uploaded file.')
+  }
+  return (props.saveHandler as ArtifactSaveHandler)(payload)
+}
+
 function handleFileUpload(files: File[]): void {
   selectedFile.value = files[0] ?? null
 }
@@ -251,7 +301,7 @@ async function handleSubmit(): Promise<void> {
   if (!payload) return
   try {
     const result = await request.run(
-      () => props.saveHandler(payload),
+      () => runSaveHandler(payload),
       { success: 'save', errorMessage: 'Failed to save analysis artifact.' },
     )
     emit('saved', { ...(result ?? {}), payload })
@@ -334,8 +384,9 @@ function handleCancel(): void {
         />
       </FormField>
 
-      <template v-if="showFileInput">
+      <template v-if="activeKind === 'file'">
         <FileUploader
+          v-if="showFileUploader"
           class="mint-artifact-save-dialog__file"
           :accept="accept"
           :max-size="maxFileSize"

package/src/types/analysisArtifactTypes.ts

@@ -48,6 +48,9 @@ export interface AnalysisArtifactMetadataUpdate {
 /** How a save payload should be applied by the plugin backend. */
 export type ArtifactSaveMode = 'create' | 'upsert' | 'update'
 
+/** Where file content comes from when a plugin uses ArtifactSaveDialog. */
+export type ArtifactFileSource = 'upload' | 'handler'
+
 interface ArtifactSavePayloadBase {
   experimentId: number
   artifactKey: string
@@ -98,11 +101,48 @@ export interface FileArtifactUpdatePayload extends ArtifactSavePayloadBase {
   metadata?: Record<string, unknown>
 }
 
+/**
+ * File artifact create where the plugin handler produces the bytes itself.
+ * This is intended for server-side serialization of in-memory analysis state;
+ * the browser neither fabricates nor uploads a placeholder File.
+ */
+export interface HandlerFileArtifactCreatePayload extends ArtifactSavePayloadBase {
+  kind: 'file'
+  mode: 'create'
+  source: 'handler'
+  fileKind: string
+  displayName?: string
+  note?: string
+  metadata?: Record<string, unknown>
+}
+
+/** File artifact replacement where the plugin handler produces the bytes itself. */
+export interface HandlerFileArtifactUpdatePayload extends ArtifactSavePayloadBase {
+  kind: 'file'
+  mode: 'update'
+  source: 'handler'
+  fileKind: string
+  note?: string | null
+  metadata?: Record<string, unknown>
+}
+
 export type ArtifactSavePayload =
   | JsonArtifactSavePayload
   | FileArtifactCreatePayload
   | FileArtifactUpdatePayload
 
+/** Payloads accepted when `ArtifactSaveDialog.fileSource` is `handler`. */
+export type HandlerArtifactSavePayload =
+  | JsonArtifactSavePayload
+  | HandlerFileArtifactCreatePayload
+  | HandlerFileArtifactUpdatePayload
+
+/** Every payload variant the dialog can emit across both file sources. */
+export type ArtifactSaveDialogPayload =
+  | ArtifactSavePayload
+  | HandlerFileArtifactCreatePayload
+  | HandlerFileArtifactUpdatePayload
+
 /** Optional handler result; cleanupPending surfaces AnalysisFileArtifactUpdate.cleanup_pending. */
 export interface ArtifactSaveResult {
   artifact?: AnalysisArtifactSummary
@@ -117,3 +157,11 @@ export interface ArtifactSaveResult {
 export type ArtifactSaveHandler = (
   payload: ArtifactSavePayload,
 ) => Promise<ArtifactSaveResult | void>
+
+/** Save handler paired with `ArtifactSaveDialog.fileSource="handler"`. */
+export type HandlerArtifactSaveHandler = (
+  payload: HandlerArtifactSavePayload,
+) => Promise<ArtifactSaveResult | void>
+
+/** Handler accepted by ArtifactSaveDialog; `fileSource` selects the payload family. */
+export type ArtifactSaveDialogHandler = ArtifactSaveHandler | HandlerArtifactSaveHandler

package/src/types/index.ts

@@ -184,12 +184,19 @@ export type {
   AnalysisArtifactListResponse,
   AnalysisArtifactMetadataUpdate,
   ArtifactSaveMode,
+  ArtifactFileSource,
   JsonArtifactSavePayload,
   FileArtifactCreatePayload,
   FileArtifactUpdatePayload,
+  HandlerFileArtifactCreatePayload,
+  HandlerFileArtifactUpdatePayload,
   ArtifactSavePayload,
+  HandlerArtifactSavePayload,
+  ArtifactSaveDialogPayload,
   ArtifactSaveResult,
   ArtifactSaveHandler,
+  HandlerArtifactSaveHandler,
+  ArtifactSaveDialogHandler,
 } from './analysisArtifactTypes'
 export { ANALYSIS_FILE_ARTIFACT_SCHEMA } from './analysisArtifactTypes'