@morscherlab/mint-sdk 1.0.63 → 1.1.0-beta.2

package/src/components/GeneratedResultRenderer.vue

@@ -0,0 +1,137 @@
+<script setup lang="ts">
+import { computed } from 'vue'
+
+import type { DataFrameColumn } from '../types'
+import type { GeneratedAnalysisResult } from '../types/generated-ui'
+import ChartContainer from './ChartContainer.vue'
+import DataFrame from './DataFrame.vue'
+import GeneratedPlotlyResult from './GeneratedPlotlyResult.vue'
+
+const props = defineProps<{
+  result: GeneratedAnalysisResult
+}>()
+
+const tableColumns = computed<DataFrameColumn[]>(() => {
+  if (props.result.kind !== 'table') return []
+  return props.result.columns.map(key => ({
+    key,
+    label: humanize(key),
+    sortable: true,
+  }))
+})
+
+const formattedJson = computed(() => (
+  props.result.kind === 'json'
+    ? JSON.stringify(props.result.value, null, 2)
+    : ''
+))
+
+const artifactHref = computed(() => {
+  if (props.result.kind !== 'artifact') return ''
+  if (props.result.download_url) return props.result.download_url
+  return props.result.data
+    ? `data:${props.result.media_type};base64,${props.result.data}`
+    : ''
+})
+
+function humanize(value: string): string {
+  return value.replace(/[_-]+/g, ' ').replace(/^\w/, character => character.toUpperCase())
+}
+</script>
+
+<template>
+  <article class="mint-generated-result" aria-live="polite">
+    <p v-if="result.kind === 'text'" class="mint-generated-result__text">
+      {{ result.text }}
+    </p>
+
+    <pre v-else-if="result.kind === 'json'" class="mint-generated-result__json">{{ formattedJson }}</pre>
+
+    <DataFrame
+      v-else-if="result.kind === 'table'"
+      :data="result.rows"
+      :columns="tableColumns"
+      sortable
+      searchable
+      sticky-header
+      max-height="32rem"
+    />
+
+    <ChartContainer v-else-if="result.kind === 'image'" title="Analysis chart">
+      <img
+        class="mint-generated-result__image"
+        :src="`data:${result.media_type};base64,${result.data}`"
+        :alt="result.alt"
+      >
+    </ChartContainer>
+
+    <GeneratedPlotlyResult
+      v-else-if="result.kind === 'plotly'"
+      :spec="result.spec"
+      :fallback="result.fallback"
+    />
+
+    <a
+      v-else
+      class="mint-generated-result__artifact"
+      :href="artifactHref"
+      :download="result.name"
+    >
+      <span>{{ result.name }}</span>
+      <small>{{ result.media_type }}</small>
+    </a>
+  </article>
+</template>
+
+<style scoped>
+.mint-generated-result {
+  width: 100%;
+}
+
+.mint-generated-result__text,
+.mint-generated-result__json {
+  margin: 0;
+  color: var(--color-text-primary);
+}
+
+.mint-generated-result__text {
+  max-width: 72ch;
+  white-space: pre-wrap;
+  line-height: 1.65;
+}
+
+.mint-generated-result__json {
+  overflow: auto;
+  padding: 1rem;
+  border: 1px solid var(--color-border);
+  border-radius: 0.75rem;
+  background: var(--color-bg-secondary);
+  font-size: 0.8125rem;
+  line-height: 1.55;
+  white-space: pre-wrap;
+}
+
+.mint-generated-result__image {
+  display: block;
+  max-width: 100%;
+  height: auto;
+  margin: 0 auto;
+}
+
+.mint-generated-result__plotly {
+  width: 100%;
+  min-height: 24rem;
+}
+
+.mint-generated-result__artifact {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 1rem;
+  padding: 1rem;
+  border: 1px solid var(--color-border);
+  border-radius: 0.75rem;
+  color: var(--color-primary);
+  text-decoration: none;
+}
+</style>

package/src/components/InstrumentAlertLog.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-/** Filterable instrument alert/event list with optional acknowledge actions. */
+/** Filterable instrument alert/event list keyed by each alert's required stable event_key. */
 import { computed, ref } from 'vue'
 import type { InstrumentAlert, InstrumentAlertLevel } from '../types'
 
@@ -146,7 +146,7 @@ function alertDetail(alert: InstrumentAlert): string {
     <TransitionGroup name="mint-instrument-alert" tag="div" class="mint-instrument-alert-log__list">
       <div
         v-for="alert in filteredAlerts"
-        :key="alert.id ?? `${alert.instrument_id}-${alert.rule ?? alert.message}-${alert.timestamp ?? ''}`"
+        :key="alert.event_key"
         class="mint-instrument-alert"
         :class="[
           levelConfig[alert.level]?.cssClass,

package/src/components/JobsStatusTray.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-/** Floating, adapter-driven job status tray for plugin and platform workflows. */
+/** Floating, source-driven job status tray for plugin and platform workflows. */
 import { computed, nextTick, ref, toRef, useId } from 'vue'
 
 import {
@@ -7,8 +7,9 @@ import {
   normalizeJobPercent,
 } from '../jobs'
 import {
-  useJobsStatusTray,
+  usePluginJobCenter,
   type JobsStatusTrayAdapter,
+  type PluginJobCenterSource,
 } from '../composables/useJobsStatusTray'
 import type { UsePluginEventStreamReturn } from '../composables/usePluginClient'
 import type {
@@ -18,8 +19,12 @@ import type {
 } from '../types/jobs'
 
 interface Props {
+  source?: PluginJobCenterSource
+  /** @deprecated Pass a source instead. */
   jobs?: readonly JobStateInput[]
+  /** @deprecated Pass source actions instead. */
   adapter?: JobsStatusTrayAdapter
+  /** @deprecated Event streams belong to the source runtime. */
   eventStream?: UsePluginEventStreamReturn<JobStreamData>
   loadOnMount?: boolean
   title?: string
@@ -42,7 +47,8 @@ const titleId = `${panelId}-title`
 const triggerRef = ref<HTMLButtonElement | null>(null)
 const panelRef = ref<HTMLElement | null>(null)
 const teleportTarget = computed(() => props.teleportTo || 'body')
-const tray = useJobsStatusTray({
+const tray = usePluginJobCenter({
+  source: toRef(props, 'source'),
   jobs: toRef(props, 'jobs'),
   adapter: toRef(props, 'adapter'),
   eventStream: toRef(props, 'eventStream'),
@@ -50,7 +56,7 @@ const tray = useJobsStatusTray({
 })
 const canClear = computed(() => (
   tray.deletableJobs.value.length > 0
-  && Boolean(props.adapter?.clearFinishedJobs || props.adapter?.deleteJob)
+  && tray.canClearFinished.value
 ))
 
 async function openTray(): Promise<void> {
@@ -201,7 +207,7 @@ async function clearFinished(): Promise<void> {
             </div>
             <div class="mint-jobs-tray__header-actions">
               <button
-                v-if="adapter?.listJobs"
+                v-if="tray.canRefresh.value"
                 type="button"
                 class="mint-jobs-tray__icon-button"
                 aria-label="Refresh jobs"
@@ -297,7 +303,7 @@ async function clearFinished(): Promise<void> {
                   <span>{{ progressText(job) }}</span>
                   <div class="mint-jobs-tray__job-actions">
                     <button
-                      v-if="job.can_cancel && adapter?.cancelJob"
+                      v-if="job.can_cancel && tray.canCancel.value"
                       type="button"
                       class="mint-jobs-tray__action mint-jobs-tray__action--danger"
                       aria-label="Cancel job"
@@ -307,7 +313,7 @@ async function clearFinished(): Promise<void> {
                       Cancel
                     </button>
                     <button
-                      v-if="job.can_delete && adapter?.deleteJob"
+                      v-if="job.can_delete && tray.canDelete.value"
                       type="button"
                       class="mint-jobs-tray__icon-button mint-jobs-tray__icon-button--danger"
                       aria-label="Delete job"
@@ -359,7 +365,7 @@ async function clearFinished(): Promise<void> {
                 <div class="mint-jobs-tray__job-footer">
                   <span>{{ formatTimestamp(job.completed_at || job.created_at) }}</span>
                   <button
-                    v-if="job.can_delete && adapter?.deleteJob"
+                    v-if="job.can_delete && tray.canDelete.value"
                     type="button"
                     class="mint-jobs-tray__icon-button mint-jobs-tray__icon-button--danger"
                     aria-label="Delete job"

package/src/components/index.ts

@@ -42,6 +42,9 @@ export { default as AppSidebar } from './AppSidebar.vue'
 export { default as AppLayout } from './AppLayout.vue'
 export { default as MobileSupportGate } from './MobileSupportGate.vue'
 export { default as PluginWorkspaceView } from './PluginWorkspaceView.vue'
+export { default as GeneratedPluginView } from './GeneratedPluginView.vue'
+export { default as GeneratedResultRenderer } from './GeneratedResultRenderer.vue'
+export { default as GeneratedPlotlyResult } from './GeneratedPlotlyResult.vue'
 export { default as ComponentBindingRenderer } from './ComponentBindingRenderer.vue'
 export { default as ControlWorkspaceView } from './ControlWorkspaceView.vue'
 export { default as DoseDesignWorkspaceView } from './DoseDesignWorkspaceView.vue'
@@ -127,6 +130,7 @@ export { default as ResourceCard } from './ResourceCard.vue'
 // Experiment / analysis components
 export { default as ExperimentSelectorModal } from './ExperimentSelectorModal.vue'
 export { default as ArtifactSelectorModal } from './ArtifactSelectorModal.vue'
+export { default as GeneratedPathInput } from './GeneratedPathInput.vue'
 export { default as ArtifactSaveDialog } from './ArtifactSaveDialog.vue'
 export { default as ExperimentPopover } from './ExperimentPopover.vue'
 export { default as FitPanel } from './FitPanel.vue'

package/src/composables/formBuilderRegistry.ts

@@ -15,6 +15,7 @@ import DatePicker from '../components/DatePicker.vue'
 import TimePicker from '../components/TimePicker.vue'
 import DateTimePicker from '../components/DateTimePicker.vue'
 import FileUploader from '../components/FileUploader.vue'
+import GeneratedPathInput from '../components/GeneratedPathInput.vue'
 import FormulaInput from '../components/FormulaInput.vue'
 import SequenceInput from '../components/SequenceInput.vue'
 import MoleculeInput from '../components/MoleculeInput.vue'
@@ -49,6 +50,7 @@ const registry: Record<FormFieldType, RegistryEntry> = {
   time: { component: TimePicker, defaults: {}, vModel: true },
   datetime: { component: DateTimePicker, defaults: {}, vModel: true },
   file: { component: FileUploader, defaults: {}, vModel: false },
+  path: { component: GeneratedPathInput, defaults: {}, vModel: true },
   formula: { component: FormulaInput, defaults: {}, vModel: true },
   sequence: { component: SequenceInput, defaults: {}, vModel: true },
   molecule: { component: MoleculeInput, defaults: {}, vModel: true },

package/src/composables/index.ts

@@ -125,6 +125,18 @@ export {
   type UseDebouncedWatchReturn,
 } from './useDebouncedWatch'
 export { useFormBuilder, evaluateCondition } from './useFormBuilder'
+export {
+  createGeneratedAnalysisTransport,
+  useGeneratedAnalysis,
+  usePluginJobs,
+  type GeneratedAnalysisTransport,
+  type GeneratedAnalysisOptions,
+  type PluginJobRequestOptions,
+  type PluginJobWaitOptions,
+  type UsePluginJobsOptions,
+  type UsePluginJobsReturn,
+  type UseGeneratedAnalysisReturn,
+} from './useGeneratedAnalysis'
 export { useAutoGroup, DEFAULT_COLORS, extractSamplesFromDesignData } from './useAutoGroup'
 export {
   useReagentSeries,
@@ -147,11 +159,6 @@ export {
   type UseAnalysisArtifactsOptions,
   type UseAnalysisArtifactsReturn,
 } from './useAnalysisArtifacts'
-export {
-  buildAnalysisArtifactTargetQuery,
-  parseAnalysisArtifactTarget,
-} from './analysisArtifactTarget'
-export { resolveCurrentPluginId } from './platformContextHelpers'
 export {
   formatExperimentDate,
   formatExperimentStatus,
@@ -487,10 +494,16 @@ export {
   type UsePluginSettingsReturn,
 } from './usePluginClient'
 export {
+  combinePluginJobSources,
+  usePluginJobCenter,
   useJobsStatusTray,
+  type CombinedPluginJobCenterSource,
+  type PluginJobCenterSource,
   type JobsStatusTrayAdapter,
   type JobsStatusTrayTab,
   type JobStreamMessage,
+  type UsePluginJobCenterOptions,
+  type UsePluginJobCenterReturn,
   type UseJobsStatusTrayOptions,
   type UseJobsStatusTrayReturn,
 } from './useJobsStatusTray'

package/src/composables/platformContextHelpers.ts

@@ -12,12 +12,6 @@ export function getInjectedPlatformContext(): PlatformContext | undefined {
   return (window as unknown as { __MINT_PLATFORM__?: PlatformContext }).__MINT_PLATFORM__
 }
 
-/** Return the platform's canonical plugin identity for the mounted frontend. */
-export function resolveCurrentPluginId(): string | undefined {
-  const pluginId = getInjectedPlatformContext()?.plugin?.id
-  return typeof pluginId === 'string' && pluginId ? pluginId : undefined
-}
-
 export function getInjectedExperimentContext(): ExperimentAwarePlatformContext | undefined {
   return getInjectedPlatformContext() as ExperimentAwarePlatformContext | undefined
 }
@@ -44,11 +38,10 @@ export function currentExperimentIdFromContext(
 
 export function currentExperimentIdFromUrl(): number | undefined {
   if (typeof window === 'undefined') return undefined
-  const location = window.location
-  const params = new URLSearchParams(location?.search ?? '')
+  const params = new URLSearchParams(window.location.search)
   return parseExperimentId(params.get('experimentId') ?? params.get('experiment_id'))
-    ?? experimentIdFromPath(location?.pathname ?? '')
-    ?? experimentIdFromPath((location?.hash ?? '').replace(/^#\/?/, '/'))
+    ?? experimentIdFromPath(window.location.pathname)
+    ?? experimentIdFromPath(window.location.hash.replace(/^#\/?/, '/'))
 }
 
 export function resolveCurrentExperimentId(

package/src/composables/useAnalysisArtifacts.ts

@@ -19,7 +19,6 @@ import type {
   AnalysisArtifactMetadataUpdate,
   AnalysisArtifactStatusFilter,
   AnalysisArtifactSummary,
-  AnalysisArtifactTarget,
 } from '../types/analysisArtifactTypes'
 
 export { ANALYSIS_FILE_ARTIFACT_SCHEMA } from '../types/analysisArtifactTypes'
@@ -68,8 +67,6 @@ export interface UseAnalysisArtifactsReturn {
   refresh: () => Promise<AnalysisArtifactSummary[]>
   /** Fetch one artifact with its result payload; null when it fails or is superseded. */
   getDetail: (artifactId: number) => Promise<AnalysisArtifactDetail | null>
-  /** Resolve and fetch the exact stable artifact identity. */
-  resolveTarget: (target: AnalysisArtifactTarget) => Promise<AnalysisArtifactDetail | null>
   /** Update display_name and/or note; resolves to the updated summary or null. */
   updateMetadata: (
     artifactId: number,
@@ -209,50 +206,6 @@ export function useAnalysisArtifacts(
     }
   }
 
-  async function resolveTarget(
-    target: AnalysisArtifactTarget,
-  ): Promise<AnalysisArtifactDetail | null> {
-    const experimentId = currentExperimentId.value
-    if (experimentId !== target.experimentId) {
-      request.setError(
-        `Analysis artifact target belongs to experiment ${target.experimentId}, not `
-        + `${experimentId ?? 'the current selection'}.`,
-      )
-      return null
-    }
-
-    const available = await list()
-    const summary = available.find((artifact) => (
-      artifact.plugin_id === target.artifactPluginId
-      && artifact.artifact_key === target.artifactKey
-      && artifact.status === 'active'
-    ))
-    if (!summary) {
-      request.setError(
-        `Analysis artifact ${target.artifactPluginId}/${target.artifactKey} is not available.`,
-      )
-      return null
-    }
-
-    const detail = await getDetail(summary.id)
-    if (
-      detail
-      && (
-        detail.experiment_id !== target.experimentId
-        || detail.plugin_id !== target.artifactPluginId
-        || detail.artifact_key !== target.artifactKey
-      )
-    ) {
-      selectedDetail.value = null
-      request.setError(
-        `Analysis artifact ${target.artifactPluginId}/${target.artifactKey} did not `
-        + 'match the requested identity.',
-      )
-      return null
-    }
-    return detail
-  }
-
   async function mutate(
     action: string,
     operation: (experimentId: number) => Promise<AnalysisArtifactSummary>,
@@ -343,7 +296,6 @@ export function useAnalysisArtifacts(
     list,
     refresh: list,
     getDetail,
-    resolveTarget,
     updateMetadata,
     archive,
     restore,

package/src/composables/useApi.ts

@@ -22,6 +22,7 @@ type MutableHeaders = Record<string, unknown> & {
 }
 
 function joinUrlPath(baseUrl: string, path: string): string {
+  if (/^https?:\/\//i.test(path)) return path
   if (!path) return baseUrl
   if (path.startsWith('?') || path.startsWith('#')) return `${baseUrl.replace(/\/+$/, '')}${path}`
   const normalizedBase = baseUrl.replace(/\/+$/, '')