@d4y/agent-runtime-nuxt 0.1.2 → 0.1.4

package/README.md

@@ -108,7 +108,7 @@ The composable returns AI-SDK / Nuxt UI compatible `UIMessage` shapes, so
 | `/conversations/:id`                                 | DELETE | Delete a persisted conversation.                          |
 | `/conversations/:id/history`                         | GET    | Return the persisted conversation history.                |
 | `/conversations/:id/stream`                          | GET    | Pipes the upstream SSE stream verbatim.                  |
-| `/conversations/:id/messages`                        | POST   | Append a user turn. Body: `{ content, context? }`.       |
+| `/conversations/:id/messages`                        | POST   | Append a user turn. Body: `{ content, context?, requestOptions? }`. |
 | `/conversations/:id/abort`                           | POST   | Cancel the in-flight agent run.                          |
 | `/conversations/:id/env`                             | POST   | Patch workspace env. Body: `{ env, merge? }`.            |
 | `/conversations/:id/files`                           | GET    | List workspace files.                                    |
@@ -160,9 +160,32 @@ workspace via `POST /conversations/:id/env`, which retriggers any matching
 #### `send(text, options?)`
 
 Lazily calls `start()` if no conversation exists. The displayed user bubble
-always shows `text`; pass `options.rewriteContent` to mutate the *forwarded*
-prompt without changing what the user sees. Useful for model-specific soft
-switches:
+always shows `text`.
+
+Use `requestOptions` for provider-side controls such as Qwen/vLLM
+`chat_template_kwargs`:
+
+```ts
+await chat.start({
+  requestOptions: {
+    temperature: 0.7,
+    topP: 0.8,
+    presencePenalty: 1.5
+  }
+})
+
+await chat.send(input.value, {
+  requestOptions: {
+    extraBody: {
+      top_k: 20,
+      chat_template_kwargs: { enable_thinking: false }
+    }
+  }
+})
+```
+
+`rewriteContent` is still available as a fallback when a model expects prompt
+text toggles rather than provider payload fields:
 
 ```ts
 await chat.send(input.value, {

package/dist/module.d.mts

@@ -1,7 +1,8 @@
 import * as _nuxt_schema from '@nuxt/schema';
 export { AppAuth, AppEnvField, AppInfo, ChatStatus, FileEntry, SendOptions, UIMessage, UiAction, UseAgentRuntime } from '../dist/runtime/composables/useAgentRuntime.js';
 export { AgentRuntimeMarkdownRenderOptions } from '../dist/runtime/composables/useAgentRuntimeMarkdown.js';
-export { AgentRuntimeFileLike, AgentRuntimeFilePreviewKind } from '../dist/runtime/utils/files.js';
+export { AgentRuntimeFileLike, AgentRuntimeFilePreviewKind, AgentRuntimeResolvedAsset } from '../dist/runtime/utils/files.js';
+export { createAgentRuntimeRequestHeaders, createScopeFingerprint, normalizeAgentRuntimeBaseUrl, resolveAgentRuntimeConfig } from '../dist/runtime/shared.js';
 
 /**
  * Module options for `@d4y/agent-runtime-nuxt`.

package/dist/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": ">=3.13.0"
   },
-  "version": "0.1.2",
+  "version": "0.1.4",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "unknown"

package/dist/module.mjs

@@ -1,5 +1,6 @@
 import { defineNuxtModule, createResolver, addImportsDir, addTypeTemplate, addServerHandler } from '@nuxt/kit';
 import { defu } from 'defu';
+export { createAgentRuntimeRequestHeaders, createScopeFingerprint, normalizeAgentRuntimeBaseUrl, resolveAgentRuntimeConfig } from '../dist/runtime/shared.js';
 
 const DEFAULTS = {
   baseUrl: "http://127.0.0.1:18791",
@@ -35,7 +36,7 @@ const module$1 = defineNuxtModule({
         `// Auto-generated by @d4y/agent-runtime-nuxt`,
         `export type { UseAgentRuntime, AppInfo, AppAuth, AppEnvField, FileEntry, UiAction, SendOptions, ChatStatus } from '${resolver.resolve("./runtime/composables/useAgentRuntime")}'`,
         `export type { AgentRuntimeMarkdownRenderOptions } from '${resolver.resolve("./runtime/composables/useAgentRuntimeMarkdown")}'`,
-        `export type { AgentRuntimeFileLike, AgentRuntimeFilePreviewKind } from '${resolver.resolve("./runtime/utils/files")}'`,
+        `export type { AgentRuntimeFileLike, AgentRuntimeFilePreviewKind, AgentRuntimeResolvedAsset } from '${resolver.resolve("./runtime/utils/files")}'`,
         ""
       ].join("\n")
     });
@@ -53,6 +54,7 @@ const module$1 = defineNuxtModule({
     route("/conversations/:id/abort", "conversations/[id]/abort.post", "post");
     route("/conversations/:id/env", "conversations/[id]/env.post", "post");
     route("/conversations/:id/files", "conversations/[id]/files.get", "get");
+    route("/conversations/:id/files/preview/**", "conversations/[id]/files/preview/[...path].get", "get");
     route("/conversations/:id/files/raw/**", "conversations/[id]/files/raw/[...path].get", "get");
   }
 });

package/dist/runtime/components/AgentRuntimeArtifactDialog.d.vue.ts

@@ -0,0 +1,20 @@
+import { type AgentRuntimeFileLike } from '../utils/files.js';
+type __VLS_Props = {
+    open: boolean;
+    file?: AgentRuntimeFileLike | null;
+    title?: string | null;
+    previewSrc?: string | null;
+    downloadSrc?: string | null;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:open": (open: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:open"?: ((open: boolean) => any) | undefined;
+}>, {
+    file: AgentRuntimeFileLike | null;
+    title: string | null;
+    previewSrc: string | null;
+    downloadSrc: string | null;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/AgentRuntimeArtifactDialog.vue

@@ -0,0 +1,90 @@
+<script setup>
+import { computed, onBeforeUnmount, watch } from "vue";
+import AgentRuntimeArtifactPreview from "./AgentRuntimeArtifactPreview.vue";
+import { getAgentRuntimeFilePreviewKind } from "../utils/files";
+const props = defineProps({
+  open: { type: Boolean, required: true },
+  file: { type: [Object, null], required: false, default: null },
+  title: { type: [String, null], required: false, default: null },
+  previewSrc: { type: [String, null], required: false, default: null },
+  downloadSrc: { type: [String, null], required: false, default: null }
+});
+const emit = defineEmits(["update:open"]);
+const previewKind = computed(() => props.file ? getAgentRuntimeFilePreviewKind(props.file) : "download");
+const isPreviewable = computed(() => previewKind.value === "image" || previewKind.value === "html" || previewKind.value === "pdf");
+const dialogTitle = computed(() => props.title ?? props.file?.name ?? props.file?.relPath ?? "Artifact preview");
+const close = () => emit("update:open", false);
+const onBackdropClick = () => close();
+const onKeydown = (event) => {
+  if (event.key === "Escape") {
+    close();
+  }
+};
+watch(() => props.open, (open) => {
+  if (!import.meta.client) {
+    return;
+  }
+  if (open) {
+    window.addEventListener("keydown", onKeydown);
+    return;
+  }
+  window.removeEventListener("keydown", onKeydown);
+}, { immediate: true });
+onBeforeUnmount(() => {
+  if (!import.meta.client) {
+    return;
+  }
+  window.removeEventListener("keydown", onKeydown);
+});
+</script>
+
+<template>
+  <Teleport to="body">
+    <Transition
+      enter-active-class="transition duration-200 ease-out"
+      enter-from-class="opacity-0"
+      enter-to-class="opacity-100"
+      leave-active-class="transition duration-150 ease-in"
+      leave-from-class="opacity-100"
+      leave-to-class="opacity-0">
+      <div
+        v-if="open"
+        class="agent-runtime-artifact-dialog"
+        aria-modal="true"
+        role="dialog"
+        :aria-label="dialogTitle"
+        @click="onBackdropClick">
+        <div class="agent-runtime-artifact-dialog__viewport">
+          <div
+            class="agent-runtime-artifact-dialog__surface"
+            :class="{ 'agent-runtime-artifact-dialog__surface--preview': isPreviewable }"
+            @click.stop>
+            <AgentRuntimeArtifactPreview
+              v-if="file"
+              :file="file"
+              :src="previewSrc" />
+
+            <div
+              v-if="downloadSrc && isPreviewable"
+              class="agent-runtime-artifact-dialog__actions">
+              <UButton
+                size="sm"
+                color="neutral"
+                variant="soft"
+                icon="material-symbols:download-rounded"
+                label="Download"
+                :href="downloadSrc"
+                external
+                :download="file?.name ?? file?.relPath ?? void 0"
+                target="_blank" />
+            </div>
+          </div>
+        </div>
+      </div>
+    </Transition>
+  </Teleport>
+</template>
+
+<style scoped>
+.agent-runtime-artifact-dialog{backdrop-filter:blur(4px);background:rgba(24,24,27,.46);inset:0;position:fixed;z-index:200}.agent-runtime-artifact-dialog__viewport{align-items:center;display:flex;justify-content:center;min-height:100vh;padding:1rem;width:100%}.agent-runtime-artifact-dialog__surface{background:transparent;max-width:none;overflow:visible;position:relative;width:min(96vw,72rem)}.agent-runtime-artifact-dialog__surface--preview{align-items:center;display:flex;justify-content:center}.agent-runtime-artifact-dialog__actions{bottom:1rem;left:1rem;position:absolute;z-index:1}
+</style>

package/dist/runtime/components/AgentRuntimeArtifactDialog.vue.d.ts

@@ -0,0 +1,20 @@
+import { type AgentRuntimeFileLike } from '../utils/files.js';
+type __VLS_Props = {
+    open: boolean;
+    file?: AgentRuntimeFileLike | null;
+    title?: string | null;
+    previewSrc?: string | null;
+    downloadSrc?: string | null;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:open": (open: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:open"?: ((open: boolean) => any) | undefined;
+}>, {
+    file: AgentRuntimeFileLike | null;
+    title: string | null;
+    previewSrc: string | null;
+    downloadSrc: string | null;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/AgentRuntimeArtifactPreview.d.vue.ts

@@ -3,12 +3,10 @@ type __VLS_Props = {
     file: AgentRuntimeFileLike;
     src?: string | null;
     resolveSrc?: ((relPath: string) => string | null | undefined) | null;
-    textMaxChars?: number;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     src: string | null;
     resolveSrc: ((relPath: string) => string | null | undefined) | null;
-    textMaxChars: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/components/AgentRuntimeArtifactPreview.vue

@@ -1,11 +1,10 @@
 <script setup>
-import { computed, onBeforeUnmount, ref, watch } from "vue";
+import { computed } from "vue";
 import { getAgentRuntimeFilePreviewKind } from "../utils/files";
 const props = defineProps({
   file: { type: Object, required: true },
   src: { type: [String, null], required: false, default: null },
-  resolveSrc: { type: [Function, null], required: false, default: null },
-  textMaxChars: { type: Number, required: false, default: 12e4 }
+  resolveSrc: { type: [Function, null], required: false, default: null }
 });
 const kind = computed(() => getAgentRuntimeFilePreviewKind(props.file));
 const resolvedSrc = computed(() => {
@@ -17,54 +16,6 @@ const resolvedSrc = computed(() => {
   }
   return props.resolveSrc(props.file.relPath) ?? null;
 });
-const textContent = ref("");
-const textError = ref(null);
-const textLoading = ref(false);
-let textAbortController = null;
-const abortTextLoad = () => {
-  textAbortController?.abort();
-  textAbortController = null;
-};
-const loadTextPreview = async () => {
-  abortTextLoad();
-  textContent.value = "";
-  textError.value = null;
-  if (kind.value !== "text" || !resolvedSrc.value) {
-    textLoading.value = false;
-    return;
-  }
-  const controller = new AbortController();
-  textAbortController = controller;
-  textLoading.value = true;
-  try {
-    const response = await fetch(resolvedSrc.value, {
-      signal: controller.signal
-    });
-    if (!response.ok) {
-      throw new Error(`Failed to load preview (${response.status})`);
-    }
-    const body = await response.text();
-    textContent.value = body.length > props.textMaxChars ? `${body.slice(0, props.textMaxChars).trimEnd()}
-
-\u2026` : body;
-  } catch (error) {
-    if (controller.signal.aborted) {
-      return;
-    }
-    textError.value = error instanceof Error ? error.message : "Failed to load preview";
-  } finally {
-    if (textAbortController === controller) {
-      textAbortController = null;
-    }
-    textLoading.value = false;
-  }
-};
-watch([kind, resolvedSrc], () => {
-  void loadTextPreview();
-}, { immediate: true });
-onBeforeUnmount(() => {
-  abortTextLoad();
-});
 </script>
 
 <template>
@@ -76,22 +27,20 @@ onBeforeUnmount(() => {
       class="agent-runtime-artifact-preview__image">
 
     <iframe
-      v-else-if="kind === 'pdf' && resolvedSrc"
+      v-else-if="kind === 'html' && resolvedSrc"
       :src="resolvedSrc"
-      :title="file.name ?? file.relPath ?? 'PDF preview'"
+      :title="file.name ?? file.relPath ?? 'Artifact preview'"
+      sandbox=""
+      referrerpolicy="no-referrer"
       class="agent-runtime-artifact-preview__frame" />
 
-    <div v-else-if="kind === 'text'" class="agent-runtime-artifact-preview__text-shell">
-      <div v-if="textLoading" class="agent-runtime-artifact-preview__note">
-        Loading preview…
-      </div>
-      <div v-else-if="textError" class="agent-runtime-artifact-preview__note agent-runtime-artifact-preview__note--error">
-        {{ textError }}
-      </div>
-      <pre v-else class="agent-runtime-artifact-preview__text">{{ textContent }}</pre>
-    </div>
+    <iframe
+      v-else-if="kind === 'pdf' && resolvedSrc"
+      :src="resolvedSrc"
+      :title="file.name ?? file.relPath ?? 'Artifact preview'"
+      class="agent-runtime-artifact-preview__frame" />
 
-    <div v-else class="agent-runtime-artifact-preview__fallback">
+    <div v-else-if="kind !== 'blocked'" class="agent-runtime-artifact-preview__fallback">
       <p class="agent-runtime-artifact-preview__note">
         Preview unavailable for this file type.
       </p>
@@ -104,9 +53,15 @@ onBeforeUnmount(() => {
         Open file
       </a>
     </div>
+
+    <div v-else class="agent-runtime-artifact-preview__fallback">
+      <p class="agent-runtime-artifact-preview__note">
+        This file type is not available in the user-facing UI.
+      </p>
+    </div>
   </div>
 </template>
 
 <style scoped>
-.agent-runtime-artifact-preview{display:block;min-height:12rem;width:100%}.agent-runtime-artifact-preview__frame,.agent-runtime-artifact-preview__image{background:rgba(15,23,42,.04);border:0;border-radius:.875rem;display:block;width:100%}.agent-runtime-artifact-preview__image{max-height:min(70vh,48rem);-o-object-fit:contain;object-fit:contain}.agent-runtime-artifact-preview__frame{min-height:min(78vh,52rem)}.agent-runtime-artifact-preview__fallback,.agent-runtime-artifact-preview__text-shell{background:rgba(15,23,42,.03);border:1px solid rgba(15,23,42,.1);border-radius:.875rem;min-height:18rem}.agent-runtime-artifact-preview__text{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-size:.8rem;line-height:1.55;margin:0;max-height:min(72vh,52rem);overflow:auto;padding:1rem;white-space:pre-wrap;word-break:break-word}.agent-runtime-artifact-preview__note{color:rgba(15,23,42,.72);font-size:.875rem;padding:1rem}.agent-runtime-artifact-preview__note--error{color:#b91c1c}.agent-runtime-artifact-preview__link{color:inherit;display:inline-flex;margin:0 1rem 1rem;text-decoration:underline;text-underline-offset:.18em}
+.agent-runtime-artifact-preview{display:block;min-height:12rem;width:100%}.agent-runtime-artifact-preview__frame,.agent-runtime-artifact-preview__image{background:rgba(15,23,42,.04);border:0;border-radius:.875rem;display:block;width:100%}.agent-runtime-artifact-preview__image{max-height:min(70vh,48rem);-o-object-fit:contain;object-fit:contain}.agent-runtime-artifact-preview__frame{min-height:min(68vh,48rem)}.agent-runtime-artifact-preview__fallback{background:rgba(15,23,42,.03);border:1px solid rgba(15,23,42,.1);border-radius:.875rem;min-height:18rem}.agent-runtime-artifact-preview__note{color:rgba(15,23,42,.72);font-size:.875rem;padding:1rem}.agent-runtime-artifact-preview__link{color:inherit;display:inline-flex;margin:0 1rem 1rem;text-decoration:underline;text-underline-offset:.18em}
 </style>

package/dist/runtime/components/AgentRuntimeArtifactPreview.vue.d.ts

@@ -3,12 +3,10 @@ type __VLS_Props = {
     file: AgentRuntimeFileLike;
     src?: string | null;
     resolveSrc?: ((relPath: string) => string | null | undefined) | null;
-    textMaxChars?: number;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     src: string | null;
     resolveSrc: ((relPath: string) => string | null | undefined) | null;
-    textMaxChars: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/components/AgentRuntimeMarkdown.d.vue.ts

@@ -0,0 +1,19 @@
+type __VLS_Props = {
+    text: string;
+    class?: string | Record<string, boolean> | string[];
+    streaming?: boolean;
+    resolveWorkspacePath?: ((relPath: string) => string | null | undefined) | null;
+    resolveWorkspacePreviewPath?: ((relPath: string) => string | null | undefined) | null;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    renderedChange: (rendered: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onRenderedChange?: ((rendered: boolean) => any) | undefined;
+}>, {
+    class: string | Record<string, boolean> | string[];
+    streaming: boolean;
+    resolveWorkspacePath: ((relPath: string) => string | null | undefined) | null;
+    resolveWorkspacePreviewPath: ((relPath: string) => string | null | undefined) | null;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/AgentRuntimeMarkdown.vue

@@ -0,0 +1,77 @@
+<script setup>
+import { computed, nextTick, ref, watch } from "vue";
+import { useAgentRuntimeMarkdown } from "../composables/useAgentRuntimeMarkdown";
+import AgentRuntimeArtifactDialog from "./AgentRuntimeArtifactDialog.vue";
+const emit = defineEmits(["renderedChange"]);
+const props = defineProps({
+  text: { type: String, required: true },
+  class: { type: [String, Object, Array], required: false, default: "" },
+  streaming: { type: Boolean, required: false, default: false },
+  resolveWorkspacePath: { type: [Function, null], required: false, default: null },
+  resolveWorkspacePreviewPath: { type: [Function, null], required: false, default: null }
+});
+const { render } = useAgentRuntimeMarkdown({
+  resolveWorkspacePath: (relPath) => props.resolveWorkspacePath?.(relPath) ?? null,
+  resolveWorkspacePreviewPath: (relPath) => props.resolveWorkspacePreviewPath?.(relPath) ?? null
+});
+const html = computed(() => props.text ? render(props.text) : "");
+const dialogOpen = ref(false);
+const dialogFile = ref(null);
+const dialogPreviewSrc = ref(null);
+const dialogDownloadSrc = ref(null);
+const rendered = computed(() => html.value.length > 0);
+const onClick = (event) => {
+  const target = event.target instanceof HTMLElement ? event.target : null;
+  const trigger = target?.closest('[data-agent-runtime-preview="true"]');
+  if (!trigger) {
+    return;
+  }
+  const previewUrl = trigger.dataset.agentRuntimePreviewUrl;
+  const kind = trigger.dataset.agentRuntimePreviewKind;
+  const label = trigger.dataset.agentRuntimePreviewLabel;
+  if (!previewUrl || !kind) {
+    return;
+  }
+  event.preventDefault();
+  dialogFile.value = {
+    name: label ?? void 0,
+    relPath: null,
+    mimeType: kind === "image" ? "image/*" : kind === "pdf" ? "application/pdf" : "text/html",
+    kind
+  };
+  dialogPreviewSrc.value = previewUrl;
+  dialogDownloadSrc.value = trigger.dataset.agentRuntimeDownloadUrl ?? previewUrl;
+  dialogOpen.value = true;
+};
+watch(rendered, async (value) => {
+  if (!value) {
+    emit("renderedChange", false);
+    return;
+  }
+  await nextTick();
+  emit("renderedChange", true);
+}, { immediate: true });
+</script>
+
+<template>
+  <div
+    v-if="rendered"
+    class="agent-runtime-markdown"
+    :class="[props.class, streaming ? 'agent-runtime-markdown--streaming' : '']"
+    @click="onClick"
+    v-html="
+  html
+  /* eslint-disable-line vue/no-v-html -- output is escaped by markdown-it; raw HTML disabled */
+" />
+
+  <AgentRuntimeArtifactDialog
+    v-model:open="dialogOpen"
+    :file="dialogFile"
+    :title="dialogFile?.name ?? dialogFile?.relPath ?? null"
+    :preview-src="dialogPreviewSrc"
+    :download-src="dialogDownloadSrc" />
+</template>
+
+<style scoped>
+.agent-runtime-markdown{line-height:1.65}.agent-runtime-markdown--streaming{animation:agent-runtime-markdown-pulse .16s ease-out}.agent-runtime-markdown :deep(.agent-runtime-md-image-link){cursor:zoom-in;display:inline-block}.agent-runtime-markdown :deep(.agent-runtime-md-image){border-radius:.95rem;display:block;max-height:20rem;max-width:min(100%,30rem);-o-object-fit:contain;object-fit:contain}.agent-runtime-markdown :deep(.agent-runtime-md-file-link){color:inherit;text-decoration:underline;text-underline-offset:.18em}.agent-runtime-markdown :deep(.agent-runtime-md-html-shell),.agent-runtime-markdown :deep(.agent-runtime-md-pdf-shell){background:color-mix(in srgb,var(--ui-bg-elevated,rgba(248,250,252,.9)) 82%,transparent);border:1px solid color-mix(in srgb,var(--ui-border,rgba(148,163,184,.28)) 80%,transparent);border-radius:1rem;display:block;margin-top:.75rem;overflow:hidden}.agent-runtime-markdown :deep(.agent-runtime-md-embed-toolbar){align-items:center;border-bottom:1px solid color-mix(in srgb,var(--ui-border,rgba(148,163,184,.28)) 70%,transparent);display:flex;flex-wrap:wrap;font-size:.75rem;gap:.75rem;justify-content:space-between;padding:.75rem .9rem}.agent-runtime-markdown :deep(.agent-runtime-md-embed-label){font-family:var(--font-mono,ui-monospace,monospace);min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.agent-runtime-markdown :deep(.agent-runtime-md-embed-actions){display:inline-flex;flex-wrap:wrap;gap:.5rem}.agent-runtime-markdown :deep(.agent-runtime-md-download-link),.agent-runtime-markdown :deep(.agent-runtime-md-preview-link){color:inherit;text-decoration:underline;text-underline-offset:.18em}.agent-runtime-markdown :deep(.agent-runtime-md-preview-link[data-agent-runtime-preview=true]){cursor:zoom-in}.agent-runtime-markdown :deep(.agent-runtime-md-html-frame),.agent-runtime-markdown :deep(.agent-runtime-md-pdf-frame){background:color-mix(in srgb,var(--ui-bg,hsla(0,0%,100%,.94)) 85%,transparent);border:0;display:block;height:22rem;width:100%}@keyframes agent-runtime-markdown-pulse{0%{opacity:.88;transform:translateY(1px)}to{opacity:1;transform:translateY(0)}}
+</style>

package/dist/runtime/components/AgentRuntimeMarkdown.vue.d.ts

@@ -0,0 +1,19 @@
+type __VLS_Props = {
+    text: string;
+    class?: string | Record<string, boolean> | string[];
+    streaming?: boolean;
+    resolveWorkspacePath?: ((relPath: string) => string | null | undefined) | null;
+    resolveWorkspacePreviewPath?: ((relPath: string) => string | null | undefined) | null;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    renderedChange: (rendered: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onRenderedChange?: ((rendered: boolean) => any) | undefined;
+}>, {
+    class: string | Record<string, boolean> | string[];
+    streaming: boolean;
+    resolveWorkspacePath: ((relPath: string) => string | null | undefined) | null;
+    resolveWorkspacePreviewPath: ((relPath: string) => string | null | undefined) | null;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/composables/useAgentRuntime.d.ts

@@ -38,6 +38,22 @@ export interface UiAction {
     payload: unknown;
     at: number;
 }
+export interface ContextUsage {
+    tokens: number | null;
+    contextWindow: number;
+    percent: number | null;
+}
+export interface CompactionLogEntry {
+    phase: 'start' | 'end';
+    at: number;
+    reason?: string;
+    tokensBefore?: number;
+    tokensAfter?: number;
+    compacted?: boolean;
+    aborted?: boolean;
+    willRetry?: boolean;
+    error?: string;
+}
 /** Workspace file entry, mirrors the backend response. */
 export interface FileEntry {
     name: string;
@@ -45,6 +61,20 @@ export interface FileEntry {
     size: number;
     mtime: string;
     mimeType: string;
+    kind: 'image' | 'html' | 'pdf' | 'download';
+}
+/**
+ * Generic provider request options forwarded to the runtime.
+ * `extraBody` is merged verbatim into the provider payload, which makes this
+ * suitable for model-specific flags such as Qwen's `chat_template_kwargs`.
+ */
+export interface RequestOptions {
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    presencePenalty?: number;
+    frequencyPenalty?: number;
+    extraBody?: Record<string, unknown>;
 }
 /** Per-turn options for `send`. */
 export interface SendOptions {
@@ -61,11 +91,15 @@ export interface SendOptions {
     rewriteContent?: (text: string) => string;
     /** Optional language override for this turn / conversation, e.g. `en` or `de-CH`. */
     language?: string;
+    /** Optional provider request overrides for this turn only. */
+    requestOptions?: RequestOptions;
 }
 /** Options for `start`. */
 export interface StartOptions {
     /** Optional language override for the newly created conversation. */
     language?: string;
+    /** Optional default provider request options for the conversation. */
+    requestOptions?: RequestOptions;
 }
 /** Return shape of {@link useAgentRuntime}. All members are reactive. */
 export interface UseAgentRuntime {
@@ -79,6 +113,12 @@ export interface UseAgentRuntime {
     error: Ref<Error | null>;
     /** Most recent UI-action events, newest first, capped at 50. */
     uiActions: Ref<UiAction[]>;
+    /** Latest context usage sample from the active PI session. */
+    contextUsage: Ref<ContextUsage | null>;
+    /** True iff a compaction run is currently in progress. */
+    compactionInProgress: Ref<boolean>;
+    /** Most recent compaction events, newest first. */
+    compactionLog: Ref<CompactionLogEntry[]>;
     /** Active app manifest. `null` until the first `onMounted` fetch resolves. */
     app: Ref<AppInfo | null>;
     /** Current auth values (persisted in localStorage, scoped per appId). */
@@ -89,6 +129,8 @@ export interface UseAgentRuntime {
     files: Ref<FileEntry[]>;
     /** Build the proxied download URL for a workspace-relative path. */
     fileUrl: (relPath: string) => string;
+    /** Build the proxied preview URL for a workspace-relative path. */
+    filePreviewUrl: (relPath: string) => string;
     /** Manually re-fetch the workspace file listing. */
     refreshFiles: () => Promise<void>;
     /** Persist a new auth map; if a conversation is open, push the change to its env. */

package/dist/runtime/composables/useAgentRuntime.js

@@ -43,6 +43,9 @@ export const useAgentRuntime = () => {
   const status = ref("idle");
   const error = ref(null);
   const uiActions = ref([]);
+  const contextUsage = ref(null);
+  const compactionInProgress = ref(false);
+  const compactionLog = ref([]);
   const app = ref(null);
   const auth = ref(emptyAuth());
   const authReady = computed(() => computeAuthReady(auth.value, app.value));
@@ -61,6 +64,11 @@ export const useAgentRuntime = () => {
     if (!cid) return "";
     return `${apiPrefix}/conversations/${cid}/files/raw/${encodeRelPath(relPath)}`;
   };
+  const filePreviewUrl = (relPath) => {
+    const cid = conversationId.value;
+    if (!cid) return "";
+    return `${apiPrefix}/conversations/${cid}/files/preview/${encodeRelPath(relPath)}`;
+  };
   const refreshFiles = async () => {
     const cid = conversationId.value;
     if (!cid) {
@@ -116,6 +124,12 @@ export const useAgentRuntime = () => {
       return { ...msg, parts };
     });
   };
+  const normalizePercent = (value) => Math.max(0, Math.min(100, value > 1 ? value : value * 100));
+  const toNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : void 0;
+  const toNullableNumber = (value) => value === null ? null : toNumber(value);
+  const pushCompactionLog = (entry) => {
+    compactionLog.value = [entry, ...compactionLog.value].slice(0, 20);
+  };
   const onSseEvent = (eventName, data) => {
     switch (eventName) {
       case "agent_start":
@@ -143,23 +157,66 @@ export const useAgentRuntime = () => {
           type: `tool-${d.toolName}`,
           toolCallId: d.toolCallId,
           state: d.isError ? "output-error" : "output-available",
-          output: d.isError ? void 0 : "ok",
-          errorText: d.isError ? "Tool returned an error" : void 0
+          output: d.isError ? void 0 : d.output,
+          errorText: d.isError ? d.errorText ?? "Tool returned an error" : void 0
         }));
         break;
       }
+      case "context_usage": {
+        const d = data;
+        const tokens = toNullableNumber(d.tokens);
+        const contextWindow = toNumber(d.contextWindow);
+        if (tokens === void 0 || contextWindow === void 0) break;
+        const fallbackPercent = typeof tokens === "number" && contextWindow > 0 ? tokens / contextWindow * 100 : null;
+        const percent = toNullableNumber(d.percent) ?? fallbackPercent;
+        if (percent === void 0) break;
+        contextUsage.value = {
+          tokens,
+          contextWindow,
+          percent: typeof percent === "number" ? normalizePercent(percent) : null
+        };
+        break;
+      }
+      case "compaction_start": {
+        const d = data;
+        compactionInProgress.value = true;
+        pushCompactionLog({
+          phase: "start",
+          at: Date.now(),
+          reason: typeof d.reason === "string" && d.reason.trim().length > 0 ? d.reason.trim() : void 0
+        });
+        break;
+      }
+      case "compaction_end": {
+        const d = data;
+        const result = d.result && typeof d.result === "object" ? d.result : null;
+        compactionInProgress.value = false;
+        pushCompactionLog({
+          phase: "end",
+          at: Date.now(),
+          reason: typeof d.reason === "string" && d.reason.trim().length > 0 ? d.reason.trim() : void 0,
+          compacted: typeof d.aborted === "boolean" ? !d.aborted && !!result : !!result,
+          aborted: typeof d.aborted === "boolean" ? d.aborted : void 0,
+          willRetry: typeof d.willRetry === "boolean" ? d.willRetry : void 0,
+          tokensBefore: toNumber(result?.tokensBefore),
+          error: typeof d.errorMessage === "string" && d.errorMessage.trim().length > 0 ? d.errorMessage : void 0
+        });
+        break;
+      }
       case "ui_action": {
         const d = data;
         uiActions.value = [{ toolCallId: d.toolCallId, type: d.type, payload: d.payload, at: Date.now() }, ...uiActions.value].slice(0, 50);
         break;
       }
       case "end":
+        compactionInProgress.value = false;
         status.value = "ready";
         currentAssistantId = null;
         void refreshFiles();
         break;
       case "error": {
         const d = data;
+        compactionInProgress.value = false;
         error.value = new Error(d?.message ?? "stream error");
         status.value = "error";
         currentAssistantId = null;
@@ -212,7 +269,11 @@ export const useAgentRuntime = () => {
     error.value = null;
     const res = await $fetch(`${apiPrefix}/conversations`, {
       method: "POST",
-      body: { env: buildEnvFromAuth(auth.value), language: options.language }
+      body: {
+        env: buildEnvFromAuth(auth.value),
+        language: options.language,
+        requestOptions: options.requestOptions
+      }
     });
     conversationId.value = res.conversationId;
     abortController?.abort();
@@ -259,7 +320,12 @@ export const useAgentRuntime = () => {
     const wireContent = options.rewriteContent ? options.rewriteContent(text) : text;
     await $fetch(`${apiPrefix}/conversations/${conversationId.value}/messages`, {
       method: "POST",
-      body: { content: wireContent, context: options.context, language: options.language }
+      body: {
+        content: wireContent,
+        context: options.context,
+        language: options.language,
+        requestOptions: options.requestOptions
+      }
     }).catch((err) => {
       error.value = err instanceof Error ? err : new Error(String(err));
       status.value = "error";
@@ -278,6 +344,9 @@ export const useAgentRuntime = () => {
     currentAssistantId = null;
     replaceMessages([]);
     uiActions.value = [];
+    contextUsage.value = null;
+    compactionInProgress.value = false;
+    compactionLog.value = [];
     files.value = [];
     status.value = "idle";
     error.value = null;
@@ -291,11 +360,15 @@ export const useAgentRuntime = () => {
     status,
     error,
     uiActions,
+    contextUsage,
+    compactionInProgress,
+    compactionLog,
     app,
     auth,
     authReady,
     files,
     fileUrl,
+    filePreviewUrl,
     refreshFiles,
     saveAuth,
     start,

package/dist/runtime/composables/useAgentRuntimeMarkdown.d.ts

@@ -1,11 +1,6 @@
 import MarkdownIt from 'markdown-it';
-export interface AgentRuntimeMarkdownRenderOptions {
-    /**
-     * Resolve a workspace-relative path (e.g. `outputs/foo.pdf`) to a fetchable
-     * URL on the runtime backend. Returns null/empty if the path can't be
-     * resolved, in which case the renderer falls back to the original text.
-     */
-    resolveWorkspacePath?: (relPath: string) => string | null | undefined;
+import { type AgentRuntimeAssetResolverOptions } from '../utils/files.js';
+export interface AgentRuntimeMarkdownRenderOptions extends AgentRuntimeAssetResolverOptions {
 }
 export declare const createAgentRuntimeMarkdownRenderer: (options?: AgentRuntimeMarkdownRenderOptions) => MarkdownIt;
 export declare const useAgentRuntimeMarkdown: (options?: AgentRuntimeMarkdownRenderOptions) => {

package/dist/runtime/composables/useAgentRuntimeMarkdown.js

@@ -1,10 +1,70 @@
 import MarkdownIt from "markdown-it";
-import {
-  isAgentRuntimeImagePath,
-  resolveAgentRuntimeWorkspaceUri,
-  toAgentRuntimeWorkspaceRelativePath
-} from "../utils/files.js";
-const BARE_WORKSPACE_PATH_RE = /(sandbox:[^\s)\]"'<>]+|\/workspace\/[^\s)\]"'<>]+)/g;
+import { resolveAgentRuntimeWorkspaceAsset, resolveAgentRuntimeWorkspaceUri } from "../utils/files.js";
+const escapeAttr = (md, value) => md.utils.escapeHtml(value);
+const previewAttrs = (md, asset) => {
+  if (!asset.canPreview || !asset.previewUrl) {
+    return "";
+  }
+  const attrs = [
+    ["data-agent-runtime-preview", "true"],
+    ["data-agent-runtime-preview-kind", asset.kind],
+    ["data-agent-runtime-preview-label", asset.label],
+    ["data-agent-runtime-preview-url", asset.previewUrl]
+  ];
+  if (asset.canDownload && asset.rawUrl) {
+    attrs.push(["data-agent-runtime-download-url", asset.rawUrl]);
+  }
+  return attrs.map(([name, value]) => `${name}="${escapeAttr(md, value)}"`).join(" ");
+};
+const buildDownloadLinkMarkup = (md, asset, label) => {
+  if (!asset.canDownload || !asset.rawUrl) {
+    return escapeAttr(md, label);
+  }
+  return `<a href="${escapeAttr(md, asset.rawUrl)}" target="_blank" rel="noopener noreferrer" class="agent-runtime-md-file-link">${escapeAttr(md, label)}</a>`;
+};
+const buildImageMarkup = (md, asset, alt, title) => {
+  const previewUrl = asset.previewUrl ?? asset.rawUrl;
+  if (!previewUrl) {
+    return escapeAttr(md, alt || asset.label);
+  }
+  const safeAlt = escapeAttr(md, alt || asset.label);
+  const safePreviewUrl = escapeAttr(md, previewUrl);
+  const titleAttr = title ? ` title="${escapeAttr(md, title)}"` : "";
+  const attrs = previewAttrs(md, asset);
+  return `<a href="${safePreviewUrl}" target="_blank" rel="noopener noreferrer" class="agent-runtime-md-image-link" ${attrs}><img src="${safePreviewUrl}" alt="${safeAlt}" loading="lazy" class="agent-runtime-md-image"${titleAttr} /></a>`;
+};
+const buildPreviewShellMarkup = (md, asset, label) => {
+  const previewUrl = asset.previewUrl;
+  if (!previewUrl) {
+    return buildDownloadLinkMarkup(md, asset, label);
+  }
+  const safeLabel = escapeAttr(md, label);
+  const safePreviewUrl = escapeAttr(md, previewUrl);
+  const attrs = previewAttrs(md, asset);
+  const shellClass = asset.kind === "pdf" ? "agent-runtime-md-pdf-shell" : "agent-runtime-md-html-shell";
+  const frameClass = asset.kind === "pdf" ? "agent-runtime-md-pdf-frame" : "agent-runtime-md-html-frame";
+  const frameAttrs = asset.kind === "pdf" ? "" : ' sandbox="" referrerpolicy="no-referrer"';
+  const title = asset.kind === "pdf" ? `PDF preview: ${label}` : `HTML preview: ${label}`;
+  const downloadButton = asset.canDownload && asset.rawUrl ? `<a href="${escapeAttr(md, asset.rawUrl)}" target="_blank" rel="noopener noreferrer" class="agent-runtime-md-download-link">Download</a>` : "";
+  return `<span class="${shellClass}"><span class="agent-runtime-md-embed-toolbar"><span class="agent-runtime-md-embed-label">${safeLabel}</span><span class="agent-runtime-md-embed-actions"><a href="${safePreviewUrl}" target="_blank" rel="noopener noreferrer" class="agent-runtime-md-preview-link" ${attrs}>Preview</a>${downloadButton}</span></span><iframe src="${safePreviewUrl}" title="${escapeAttr(md, title)}" loading="lazy"${frameAttrs} class="${frameClass}"></iframe></span>`;
+};
+const toHtmlToken = (state, markup) => {
+  const token = new state.Token("html_inline", "", 0);
+  token.content = markup;
+  return token;
+};
+const renderWorkspaceLink = (md, asset, label) => {
+  if (asset.kind === "blocked") {
+    return escapeAttr(md, label);
+  }
+  if (asset.kind === "image") {
+    return buildImageMarkup(md, asset, label);
+  }
+  if (asset.kind === "html" || asset.kind === "pdf") {
+    return buildPreviewShellMarkup(md, asset, label);
+  }
+  return buildDownloadLinkMarkup(md, asset, label);
+};
 export const createAgentRuntimeMarkdownRenderer = (options = {}) => {
   const md = new MarkdownIt({
     html: false,
@@ -12,15 +72,15 @@ export const createAgentRuntimeMarkdownRenderer = (options = {}) => {
     breaks: true,
     typographer: false
   });
-  const resolve = (uri) => resolveAgentRuntimeWorkspaceUri(uri, options.resolveWorkspacePath);
+  const resolveAsset = (uri) => resolveAgentRuntimeWorkspaceAsset(uri, options);
   const defaultLinkOpen = md.renderer.rules.link_open ?? ((tokens, idx, opts, _env, self) => self.renderToken(tokens, idx, opts));
   md.renderer.rules.link_open = (tokens, idx, opts, env, self) => {
     const token = tokens[idx];
     if (token) {
       const href = token.attrGet("href") ?? "";
-      const rewritten = resolve(href);
-      if (rewritten) {
-        token.attrSet("href", rewritten);
+      const resolved = resolveAgentRuntimeWorkspaceUri(href, options.resolveWorkspacePath);
+      if (resolved) {
+        token.attrSet("href", resolved);
         token.attrSet("target", "_blank");
         token.attrSet("rel", "noopener noreferrer");
         token.attrSet("class", "agent-runtime-md-file-link");
@@ -34,64 +94,42 @@ export const createAgentRuntimeMarkdownRenderer = (options = {}) => {
   md.renderer.rules.image = (tokens, idx) => {
     const token = tokens[idx];
     if (!token) return "";
-    const rawSrc = token.attrGet("src") ?? "";
-    const rewritten = resolve(rawSrc);
-    const src = rewritten ?? rawSrc;
+    const src = token.attrGet("src") ?? "";
     const alt = token.content || "";
     const title = token.attrGet("title");
-    const titleAttr = title ? ` title="${md.utils.escapeHtml(title)}"` : "";
-    const safeAlt = md.utils.escapeHtml(alt);
-    const safeSrc = md.utils.escapeHtml(src);
-    const looksLikeImage = isAgentRuntimeImagePath(rawSrc) || isAgentRuntimeImagePath(src);
-    if (!looksLikeImage && rewritten) {
-      return `<a href="${safeSrc}" target="_blank" rel="noopener noreferrer" class="agent-runtime-md-file-link">${safeAlt || safeSrc}</a>`;
+    const asset = resolveAsset(src);
+    if (!asset) {
+      const safeSrc = escapeAttr(md, src);
+      const safeAlt = escapeAttr(md, alt);
+      const titleAttr = title ? ` title="${escapeAttr(md, title)}"` : "";
+      return `<img src="${safeSrc}" alt="${safeAlt}" loading="lazy" class="agent-runtime-md-image"${titleAttr} />`;
+    }
+    if (asset.kind === "image") {
+      return buildImageMarkup(md, asset, alt, title);
     }
-    return `<a href="${safeSrc}" target="_blank" rel="noopener noreferrer" class="agent-runtime-md-image-link"><img src="${safeSrc}" alt="${safeAlt}" loading="lazy" class="agent-runtime-md-image"${titleAttr} /></a>`;
+    return renderWorkspaceLink(md, asset, alt || asset.label);
   };
-  md.core.ruler.after("inline", "agent_runtime_workspace_autolink", (state) => {
+  md.core.ruler.after("inline", "agent_runtime_workspace_links", (state) => {
     for (const blockToken of state.tokens) {
       if (blockToken.type !== "inline" || !blockToken.children) continue;
       const out = [];
-      for (const child of blockToken.children) {
-        if (child.type !== "text") {
-          out.push(child);
+      const children = blockToken.children;
+      for (let idx = 0; idx < children.length; idx++) {
+        const child = children[idx];
+        if (!child) {
           continue;
         }
-        const text = child.content;
-        BARE_WORKSPACE_PATH_RE.lastIndex = 0;
-        if (!BARE_WORKSPACE_PATH_RE.test(text)) {
+        const next = children[idx + 1];
+        const nextNext = children[idx + 2];
+        const href = child.type === "link_open" && typeof child.attrGet === "function" ? child.attrGet("href") ?? "" : "";
+        const asset = href ? resolveAsset(href) : null;
+        const isWorkspaceLink = asset && child.type === "link_open" && next?.type === "text" && nextNext?.type === "link_close";
+        if (!isWorkspaceLink) {
           out.push(child);
           continue;
         }
-        BARE_WORKSPACE_PATH_RE.lastIndex = 0;
-        let lastIndex = 0;
-        let match;
-        while ((match = BARE_WORKSPACE_PATH_RE.exec(text)) !== null) {
-          const uri = match[0];
-          const url = resolve(uri);
-          if (!url) continue;
-          if (match.index > lastIndex) {
-            const before = new state.Token("text", "", 0);
-            before.content = text.slice(lastIndex, match.index);
-            out.push(before);
-          }
-          const open = new state.Token("link_open", "a", 1);
-          open.attrSet("href", url);
-          open.attrSet("target", "_blank");
-          open.attrSet("rel", "noopener noreferrer");
-          open.attrSet("class", "agent-runtime-md-file-link");
-          const inner = new state.Token("text", "", 0);
-          const relPath = toAgentRuntimeWorkspaceRelativePath(uri) ?? uri;
-          inner.content = relPath.split("/").pop() || relPath;
-          const close = new state.Token("link_close", "a", -1);
-          out.push(open, inner, close);
-          lastIndex = match.index + uri.length;
-        }
-        if (lastIndex < text.length) {
-          const tail = new state.Token("text", "", 0);
-          tail.content = text.slice(lastIndex);
-          out.push(tail);
-        }
+        out.push(toHtmlToken(state, renderWorkspaceLink(md, asset, next.content || asset.label)));
+        idx += 2;
       }
       blockToken.children = out;
     }

package/dist/runtime/frontend.d.ts

@@ -1,5 +1,7 @@
 export type { AgentRuntimeMarkdownRenderOptions } from './composables/useAgentRuntimeMarkdown.js';
-export type { AgentRuntimeFileLike, AgentRuntimeFilePreviewKind } from './utils/files.js';
+export type { AgentRuntimeFileLike, AgentRuntimeFilePreviewKind, AgentRuntimeResolvedAsset } from './utils/files.js';
+export { default as AgentRuntimeArtifactDialog } from './components/AgentRuntimeArtifactDialog.vue.js';
 export { default as AgentRuntimeArtifactPreview } from './components/AgentRuntimeArtifactPreview.vue.js';
+export { default as AgentRuntimeMarkdown } from './components/AgentRuntimeMarkdown.vue.js';
 export { createAgentRuntimeMarkdownRenderer, useAgentRuntimeMarkdown } from './composables/useAgentRuntimeMarkdown.js';
-export { canPreviewAgentRuntimeFileInline, getAgentRuntimeFilePreviewKind, isAgentRuntimeImageMimeType, isAgentRuntimeImagePath, isAgentRuntimePdfMimeType, isAgentRuntimePdfPath, isAgentRuntimeTextMimeType, isAgentRuntimeTextPath, resolveAgentRuntimeWorkspaceUri, toAgentRuntimeWorkspaceRelativePath, } from './utils/files.js';
+export { canPreviewAgentRuntimeFileInline, isAgentRuntimeBlockedMimeType, isAgentRuntimeBlockedPath, isAgentRuntimeHtmlMimeType, isAgentRuntimeHtmlPath, getAgentRuntimeFilePreviewKind, isAgentRuntimeImageMimeType, isAgentRuntimeImagePath, isAgentRuntimePdfMimeType, isAgentRuntimePdfPath, resolveAgentRuntimeFileAsset, resolveAgentRuntimeWorkspaceUri, resolveAgentRuntimeWorkspaceAsset, toAgentRuntimeWorkspaceRelativePath, } from './utils/files.js';

package/dist/runtime/frontend.js

@@ -1,14 +1,20 @@
+export { default as AgentRuntimeArtifactDialog } from "./components/AgentRuntimeArtifactDialog.vue";
 export { default as AgentRuntimeArtifactPreview } from "./components/AgentRuntimeArtifactPreview.vue";
+export { default as AgentRuntimeMarkdown } from "./components/AgentRuntimeMarkdown.vue";
 export { createAgentRuntimeMarkdownRenderer, useAgentRuntimeMarkdown } from "./composables/useAgentRuntimeMarkdown.js";
 export {
   canPreviewAgentRuntimeFileInline,
+  isAgentRuntimeBlockedMimeType,
+  isAgentRuntimeBlockedPath,
+  isAgentRuntimeHtmlMimeType,
+  isAgentRuntimeHtmlPath,
   getAgentRuntimeFilePreviewKind,
   isAgentRuntimeImageMimeType,
   isAgentRuntimeImagePath,
   isAgentRuntimePdfMimeType,
   isAgentRuntimePdfPath,
-  isAgentRuntimeTextMimeType,
-  isAgentRuntimeTextPath,
+  resolveAgentRuntimeFileAsset,
   resolveAgentRuntimeWorkspaceUri,
+  resolveAgentRuntimeWorkspaceAsset,
   toAgentRuntimeWorkspaceRelativePath
 } from "./utils/files.js";

package/dist/runtime/server/api/conversations/[id]/files/preview/[...path].get.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("h3").EventHandler<import("h3").EventHandlerRequest, Promise<void>>;
+export default _default;

package/dist/runtime/server/api/conversations/[id]/files/preview/[...path].get.js

@@ -0,0 +1,42 @@
+import { Readable } from "node:stream";
+import { useRuntimeConfig } from "#imports";
+import { createError, defineEventHandler, getRouterParam, sendStream, setHeader } from "h3";
+import { agentRuntime } from "../../../../../utils/agent-runtime.js";
+const PASS_THROUGH_HEADERS = [
+  "content-type",
+  "content-length",
+  "content-disposition",
+  "cache-control",
+  "content-security-policy",
+  "x-content-type-options"
+];
+export default defineEventHandler(async (event) => {
+  const cfg = agentRuntime();
+  const id = getRouterParam(event, "id");
+  if (!id) throw createError({ statusCode: 400, statusMessage: "missing conversation id" });
+  const apiPrefix = (useRuntimeConfig().public.agentRuntime?.apiPrefix ?? "/api/agent-runtime").replace(/\/+$/, "");
+  const marker = `${apiPrefix}/conversations/${id}/files/preview/`;
+  const idx = event.path.indexOf(marker);
+  const tail = idx >= 0 ? event.path.slice(idx + marker.length) : "";
+  if (!tail) throw createError({ statusCode: 400, statusMessage: "missing file path" });
+  const upstreamUrl = `${cfg.baseUrl}/v1/conversations/${id}/files/preview/${tail}`;
+  const controller = new AbortController();
+  event.node.req.on("close", () => controller.abort());
+  const upstream = await fetch(upstreamUrl, {
+    headers: { "X-Agent-Runtime-App-Key": cfg.appKey },
+    signal: controller.signal
+  });
+  if (!upstream.ok || !upstream.body) {
+    throw createError({
+      statusCode: upstream.status || 502,
+      statusMessage: `agent-runtime file preview failed: ${upstream.status} ${upstream.statusText}`
+    });
+  }
+  for (const name of PASS_THROUGH_HEADERS) {
+    const value = upstream.headers.get(name);
+    if (value) {
+      setHeader(event, name, value);
+    }
+  }
+  return sendStream(event, Readable.fromWeb(upstream.body));
+});

package/dist/runtime/server/api/conversations/[id]/files.get.d.ts

@@ -5,6 +5,7 @@ export interface FileEntry {
     size: number;
     mtime: string;
     mimeType: string;
+    kind: 'image' | 'html' | 'pdf' | 'download';
 }
 /**
  * GET `${apiPrefix}/conversations/:id/files` — lists the workspace files

package/dist/runtime/server/api/conversations/[id]/messages.post.js

@@ -9,7 +9,12 @@ export default defineEventHandler(async (event) => {
   const response = await fetch(`${cfg.baseUrl}/v1/conversations/${id}/messages`, {
     method: "POST",
     headers: agentRuntimeHeaders(cfg),
-    body: JSON.stringify({ content: body.content, context: body.context, language: body.language })
+    body: JSON.stringify({
+      content: body.content,
+      context: body.context,
+      requestOptions: body.requestOptions,
+      language: body.language
+    })
   });
   if (!response.ok) {
     throw createError({

package/dist/runtime/server/api/conversations.post.js

@@ -6,7 +6,13 @@ export default defineEventHandler(async (event) => {
   const response = await fetch(`${cfg.baseUrl}/v1/conversations`, {
     method: "POST",
     headers: agentRuntimeHeaders(cfg),
-    body: JSON.stringify({ appId: cfg.appId, env: body.env ?? {}, model: body.model, language: body.language })
+    body: JSON.stringify({
+      appId: cfg.appId,
+      env: body.env ?? {},
+      model: body.model,
+      requestOptions: body.requestOptions,
+      language: body.language
+    })
   });
   if (!response.ok) {
     throw createError({

package/dist/runtime/utils/files.d.ts

@@ -2,15 +2,33 @@ export interface AgentRuntimeFileLike {
     name?: string | null;
     relPath?: string | null;
     mimeType?: string | null;
+    kind?: AgentRuntimeFilePreviewKind | null;
+}
+export type AgentRuntimeFilePreviewKind = 'image' | 'html' | 'pdf' | 'download' | 'blocked';
+export interface AgentRuntimeResolvedAsset extends AgentRuntimeFileLike {
+    kind: AgentRuntimeFilePreviewKind;
+    label: string;
+    relPath: string | null;
+    rawUrl: string | null;
+    previewUrl: string | null;
+    canPreview: boolean;
+    canDownload: boolean;
+}
+export interface AgentRuntimeAssetResolverOptions {
+    resolveWorkspacePath?: (relPath: string) => string | null | undefined;
+    resolveWorkspacePreviewPath?: (relPath: string) => string | null | undefined;
 }
-export type AgentRuntimeFilePreviewKind = 'image' | 'pdf' | 'text' | 'download';
 export declare const toAgentRuntimeWorkspaceRelativePath: (uri: string) => string | null;
 export declare const resolveAgentRuntimeWorkspaceUri: (uri: string, resolveWorkspacePath?: (relPath: string) => string | null | undefined) => string | null;
+export declare const isAgentRuntimeBlockedMimeType: (mimeType: string | null | undefined) => boolean;
 export declare const isAgentRuntimeImageMimeType: (mimeType: string | null | undefined) => boolean;
+export declare const isAgentRuntimeHtmlMimeType: (mimeType: string | null | undefined) => boolean;
 export declare const isAgentRuntimePdfMimeType: (mimeType: string | null | undefined) => boolean;
-export declare const isAgentRuntimeTextMimeType: (mimeType: string | null | undefined) => boolean;
 export declare const isAgentRuntimeImagePath: (value: string | null | undefined) => boolean;
+export declare const isAgentRuntimeHtmlPath: (value: string | null | undefined) => boolean;
 export declare const isAgentRuntimePdfPath: (value: string | null | undefined) => boolean;
-export declare const isAgentRuntimeTextPath: (value: string | null | undefined) => boolean;
+export declare const isAgentRuntimeBlockedPath: (value: string | null | undefined) => boolean;
 export declare const getAgentRuntimeFilePreviewKind: (file: AgentRuntimeFileLike) => AgentRuntimeFilePreviewKind;
 export declare const canPreviewAgentRuntimeFileInline: (file: AgentRuntimeFileLike) => boolean;
+export declare const resolveAgentRuntimeFileAsset: (file: AgentRuntimeFileLike, options?: AgentRuntimeAssetResolverOptions) => AgentRuntimeResolvedAsset;
+export declare const resolveAgentRuntimeWorkspaceAsset: (uri: string, options?: AgentRuntimeAssetResolverOptions) => AgentRuntimeResolvedAsset | null;

package/dist/runtime/utils/files.js

@@ -1,42 +1,87 @@
 const IMAGE_EXT_RE = /\.(?:png|jpe?g|gif|webp|svg|avif|bmp)(?:[?#].*)?$/i;
+const HTML_EXT_RE = /\.html?(?:[?#].*)?$/i;
 const PDF_EXT_RE = /\.pdf(?:[?#].*)?$/i;
-const TEXT_EXT_RE = /\.(?:txt|md|json|csv|tsv|xml|ya?ml|log|html?|css|js|mjs|cjs|ts|tsx|jsx|vue|py|rb|sh|sql)(?:[?#].*)?$/i;
+const DOWNLOAD_EXT_RE = /\.(?:txt|md|json|csv|tsv|xml|ya?ml|log)(?:[?#].*)?$/i;
+const BLOCKED_EXT_RE = /\.(?:py|rb|pl|php|sh|bash|zsh|fish|ps1|bat|cmd|js|mjs|cjs|ts|tsx|jsx|vue)(?:[?#].*)?$/i;
+const BLOCKED_MIME_RE = /^(?:application\/javascript|application\/typescript|application\/x-httpd-php|application\/x-python-code|application\/x-sh|text\/javascript|text\/x-python|text\/x-script\.python|text\/x-shellscript|text\/x-typescript)(?:$|;)/i;
+const PREVIEWABLE_KINDS = /* @__PURE__ */ new Set(["image", "html", "pdf"]);
+const FILE_KIND_ORDER = ["image", "html", "pdf", "download", "blocked"];
+const basename = (value) => value.split("/").pop() || value;
+const normalizeKind = (value) => typeof value === "string" && FILE_KIND_ORDER.includes(value) ? value : null;
 export const toAgentRuntimeWorkspaceRelativePath = (uri) => {
-  if (!uri) return null;
-  if (uri.startsWith("sandbox:")) return uri.slice("sandbox:".length).replace(/^\/+/, "");
-  if (uri.startsWith("/workspace/")) return uri.slice("/workspace/".length);
-  if (uri === "/workspace") return "";
-  if (uri.startsWith("workspace/")) return uri.slice("workspace/".length);
-  return null;
+  if (!uri.startsWith("sandbox:")) {
+    return null;
+  }
+  const relPath = uri.slice("sandbox:".length).replace(/^\/+/, "");
+  return relPath.length > 0 ? relPath : null;
 };
 export const resolveAgentRuntimeWorkspaceUri = (uri, resolveWorkspacePath) => {
   const relPath = toAgentRuntimeWorkspaceRelativePath(uri);
-  if (relPath === null) return null;
-  const resolved = resolveWorkspacePath?.(relPath);
-  return resolved || null;
+  if (relPath === null) {
+    return null;
+  }
+  return resolveWorkspacePath?.(relPath) ?? null;
 };
+export const isAgentRuntimeBlockedMimeType = (mimeType) => typeof mimeType === "string" && BLOCKED_MIME_RE.test(mimeType);
 export const isAgentRuntimeImageMimeType = (mimeType) => typeof mimeType === "string" && /^image\//i.test(mimeType);
+export const isAgentRuntimeHtmlMimeType = (mimeType) => typeof mimeType === "string" && /^text\/html(?:$|;)/i.test(mimeType);
 export const isAgentRuntimePdfMimeType = (mimeType) => typeof mimeType === "string" && mimeType.toLowerCase() === "application/pdf";
-export const isAgentRuntimeTextMimeType = (mimeType) => {
+export const isAgentRuntimeImagePath = (value) => typeof value === "string" && IMAGE_EXT_RE.test(value);
+export const isAgentRuntimeHtmlPath = (value) => typeof value === "string" && HTML_EXT_RE.test(value);
+export const isAgentRuntimePdfPath = (value) => typeof value === "string" && PDF_EXT_RE.test(value);
+export const isAgentRuntimeBlockedPath = (value) => typeof value === "string" && BLOCKED_EXT_RE.test(value);
+const isAgentRuntimeDownloadMimeType = (mimeType) => {
   if (typeof mimeType !== "string" || !mimeType) {
     return false;
   }
   const normalized = mimeType.toLowerCase();
-  return normalized.startsWith("text/") || normalized === "application/json" || normalized === "application/ld+json" || normalized === "application/xml" || normalized === "application/yaml" || normalized === "application/x-yaml";
+  return normalized.startsWith("text/") && !isAgentRuntimeHtmlMimeType(normalized) && !isAgentRuntimeBlockedMimeType(normalized) || normalized === "application/json" || normalized === "application/ld+json" || normalized === "application/xml" || normalized === "application/yaml" || normalized === "application/x-yaml";
 };
-export const isAgentRuntimeImagePath = (value) => typeof value === "string" && IMAGE_EXT_RE.test(value);
-export const isAgentRuntimePdfPath = (value) => typeof value === "string" && PDF_EXT_RE.test(value);
-export const isAgentRuntimeTextPath = (value) => typeof value === "string" && TEXT_EXT_RE.test(value);
+const isAgentRuntimeDownloadPath = (value) => typeof value === "string" && DOWNLOAD_EXT_RE.test(value);
 export const getAgentRuntimeFilePreviewKind = (file) => {
+  const explicitKind = normalizeKind(file.kind);
+  if (explicitKind) {
+    return explicitKind;
+  }
+  if (isAgentRuntimeBlockedMimeType(file.mimeType) || isAgentRuntimeBlockedPath(file.name) || isAgentRuntimeBlockedPath(file.relPath)) {
+    return "blocked";
+  }
   if (isAgentRuntimeImageMimeType(file.mimeType) || isAgentRuntimeImagePath(file.name) || isAgentRuntimeImagePath(file.relPath)) {
     return "image";
   }
+  if (isAgentRuntimeHtmlMimeType(file.mimeType) || isAgentRuntimeHtmlPath(file.name) || isAgentRuntimeHtmlPath(file.relPath)) {
+    return "html";
+  }
   if (isAgentRuntimePdfMimeType(file.mimeType) || isAgentRuntimePdfPath(file.name) || isAgentRuntimePdfPath(file.relPath)) {
     return "pdf";
   }
-  if (isAgentRuntimeTextMimeType(file.mimeType) || isAgentRuntimeTextPath(file.name) || isAgentRuntimeTextPath(file.relPath)) {
-    return "text";
+  if (isAgentRuntimeDownloadMimeType(file.mimeType) || isAgentRuntimeDownloadPath(file.name) || isAgentRuntimeDownloadPath(file.relPath)) {
+    return "download";
   }
   return "download";
 };
-export const canPreviewAgentRuntimeFileInline = (file) => getAgentRuntimeFilePreviewKind(file) !== "download";
+export const canPreviewAgentRuntimeFileInline = (file) => PREVIEWABLE_KINDS.has(getAgentRuntimeFilePreviewKind(file));
+export const resolveAgentRuntimeFileAsset = (file, options = {}) => {
+  const relPath = file.relPath ?? null;
+  const kind = getAgentRuntimeFilePreviewKind(file);
+  const label = file.name ?? (relPath ? basename(relPath) : "Attachment");
+  const rawUrl = relPath ? options.resolveWorkspacePath?.(relPath) || null : null;
+  const previewUrl = relPath && PREVIEWABLE_KINDS.has(kind) ? options.resolveWorkspacePreviewPath?.(relPath) || rawUrl : null;
+  return {
+    ...file,
+    kind,
+    label,
+    relPath,
+    rawUrl,
+    previewUrl,
+    canPreview: kind !== "blocked" && previewUrl !== null,
+    canDownload: kind !== "blocked" && rawUrl !== null
+  };
+};
+export const resolveAgentRuntimeWorkspaceAsset = (uri, options = {}) => {
+  const relPath = toAgentRuntimeWorkspaceRelativePath(uri);
+  if (relPath === null) {
+    return null;
+  }
+  return resolveAgentRuntimeFileAsset({ relPath, name: basename(relPath) }, options);
+};

package/dist/types.d.mts

@@ -2,7 +2,9 @@ export { type AppAuth, type AppEnvField, type AppInfo, type ChatStatus, type Fil
 
 export { type AgentRuntimeMarkdownRenderOptions } from '../dist/runtime/composables/useAgentRuntimeMarkdown.js'
 
-export { type AgentRuntimeFileLike, type AgentRuntimeFilePreviewKind } from '../dist/runtime/utils/files.js'
+export { type AgentRuntimeFileLike, type AgentRuntimeFilePreviewKind, type AgentRuntimeResolvedAsset } from '../dist/runtime/utils/files.js'
+
+export { type createAgentRuntimeRequestHeaders, type createScopeFingerprint, type normalizeAgentRuntimeBaseUrl, type resolveAgentRuntimeConfig } from '../dist/runtime/shared.js'
 
 export { default } from './module.mjs'
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d4y/agent-runtime-nuxt",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Headless Nuxt module that connects a Nuxt app to an agent-runtime server. Ships server-side proxy routes (so your X-Agent-Runtime-App-Key never leaves the server) and a single composable, useAgentRuntime(), that exposes a typed chat client.",
   "license": "MIT",
   "type": "module",