@d4y/agent-runtime-nuxt 0.1.7 → 0.1.8

package/dist/module.d.mts

@@ -1,5 +1,5 @@
 import * as _nuxt_schema from '@nuxt/schema';
-export { AppAuth, AppEnvField, AppInfo, ChatStatus, FileEntry, SendOptions, UIMessage, UiAction, UseAgentRuntime } from '../dist/runtime/composables/useAgentRuntime.js';
+export { AppAuth, AppEnvField, AppInfo, AppStartField, AppStartSpec, ChatStatus, FileEntry, RunKind, RunRecord, RunStatus, SendOptions, UIMessage, UiAction, UploadFilesOptions, UseAgentRuntime, UseAgentRuntimeOptions, WorkflowStartOptions } from '../dist/runtime/composables/useAgentRuntime.js';
 export { AgentRuntimeMarkdownRenderOptions } from '../dist/runtime/composables/useAgentRuntimeMarkdown.js';
 export { AgentRuntimeFileLike, AgentRuntimeFilePreviewKind, AgentRuntimeResolvedAsset } from '../dist/runtime/utils/files.js';
 export { createAgentRuntimeRequestHeaders, createScopeFingerprint, normalizeAgentRuntimeBaseUrl, resolveAgentRuntimeConfig } from '../dist/runtime/shared.js';
@@ -35,6 +35,15 @@ interface ModuleOptions {
      * Falls back to `process.env.AGENT_RUNTIME_APP_ID` then `omnisearch`.
      */
     appId?: string;
+    /**
+     * Additional server-side app bindings. This lets one Nuxt app render chats
+     * for multiple agent-runtime apps without exposing app keys to the browser.
+     */
+    apps?: Record<string, {
+        baseUrl?: string;
+        appKey?: string;
+        appId?: string;
+    }>;
     /**
      * URL prefix for the auto-registered Nitro proxy routes. Change it if you
      * need to disambiguate from another module on the same `/api/...` namespace.
@@ -55,6 +64,11 @@ interface PrivateAgentRuntimeConfig {
     baseUrl: string;
     appKey: string;
     appId: string;
+    apps?: Record<string, {
+        baseUrl?: string;
+        appKey?: string;
+        appId?: string;
+    }>;
 }
 declare module '@nuxt/schema' {
     interface RuntimeConfig {

package/dist/module.json

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

package/dist/module.mjs

@@ -20,10 +20,12 @@ const module$1 = defineNuxtModule({
     const appKey = userOptions.appKey ?? process.env.AGENT_RUNTIME_APP_KEY ?? "";
     const appId = userOptions.appId ?? process.env.AGENT_RUNTIME_APP_ID ?? DEFAULTS.appId;
     const apiPrefix = (userOptions.apiPrefix ?? DEFAULTS.apiPrefix).replace(/\/+$/, "");
+    const apps = userOptions.apps ?? {};
     nuxt.options.runtimeConfig.agentRuntime = defu(nuxt.options.runtimeConfig.agentRuntime, {
       baseUrl,
       appKey,
-      appId
+      appId,
+      apps
     });
     nuxt.options.runtimeConfig.public.agentRuntime = defu(nuxt.options.runtimeConfig.public.agentRuntime, {
       apiPrefix,
@@ -34,7 +36,7 @@ const module$1 = defineNuxtModule({
       filename: "types/agent-runtime.d.ts",
       getContents: () => [
         `// 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 { UseAgentRuntime, UseAgentRuntimeOptions, AppInfo, AppStartSpec, AppStartField, AppAuth, AppEnvField, FileEntry, UiAction, RunKind, RunStatus, RunRecord, SendOptions, WorkflowStartOptions, UploadFilesOptions, ChatStatus } from '${resolver.resolve("./runtime/composables/useAgentRuntime")}'`,
         `export type { AgentRuntimeMarkdownRenderOptions } from '${resolver.resolve("./runtime/composables/useAgentRuntimeMarkdown")}'`,
         `export type { AgentRuntimeFileLike, AgentRuntimeFilePreviewKind, AgentRuntimeResolvedAsset } from '${resolver.resolve("./runtime/utils/files")}'`,
         ""
@@ -51,9 +53,14 @@ const module$1 = defineNuxtModule({
     route("/conversations/:id/history", "conversations/[id]/history.get", "get");
     route("/conversations/:id/stream", "conversations/[id]/stream.get", "get");
     route("/conversations/:id/messages", "conversations/[id]/messages.post", "post");
+    route("/conversations/:id/workflows", "conversations/[id]/workflows.post", "post");
     route("/conversations/:id/abort", "conversations/[id]/abort.post", "post");
     route("/conversations/:id/env", "conversations/[id]/env.post", "post");
+    route("/conversations/:id/workflow", "conversations/[id]/workflow.get", "get");
+    route("/conversations/:id/runs", "conversations/[id]/runs.get", "get");
+    route("/conversations/:id/runs/:runId", "conversations/[id]/runs/[runId].get", "get");
     route("/conversations/:id/files", "conversations/[id]/files.get", "get");
+    route("/conversations/:id/files", "conversations/[id]/files.post", "post");
     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/composables/useAgentRuntime.d.ts

@@ -16,12 +16,47 @@ export interface AppEnvField {
     required: boolean;
     secret: boolean;
     description?: string;
+    default?: string;
+}
+export interface AppStartField {
+    type?: 'string' | 'number' | 'boolean' | 'array';
+    items?: 'string' | 'number' | 'boolean';
+    title?: string;
+    description?: string;
+    placeholder?: string;
+    enum?: string[];
+    options?: Array<{
+        label: string;
+        value: string;
+        description?: string;
+        disabled?: boolean;
+        disabledReason?: string;
+    }>;
+    default?: string | number | boolean | Array<string | number | boolean>;
+}
+export interface AppStartSpec {
+    mode: 'interactive' | 'workflow';
+    label?: string;
+    description?: string;
+    inputSchema?: {
+        type?: 'object';
+        required?: string[];
+        properties?: Record<string, AppStartField>;
+    };
+    workflow?: {
+        name?: string;
+        initialPrompt?: string;
+        runner?: 'autonomous' | 'supervisor';
+        maxIterations?: number;
+    };
 }
 /** Manifest summary for the active app, as returned by `${apiPrefix}/app`. */
 export interface AppInfo {
     appId: string;
     name: string;
     envSchema: Record<string, AppEnvField>;
+    start?: AppStartSpec;
+    workflows?: Record<string, unknown>;
 }
 /**
  * Generic auth state. Keys are app-defined (whatever the active app declares
@@ -43,6 +78,38 @@ export interface ContextUsage {
     contextWindow: number;
     percent: number | null;
 }
+export type RunKind = 'workflow' | 'subagent';
+export type RunStatus = 'queued' | 'running' | 'completed' | 'failed' | 'aborted';
+export interface RunRecord {
+    schemaVersion: 1;
+    runId: string;
+    conversationId: string;
+    appId: string;
+    kind: RunKind;
+    status: RunStatus;
+    createdAt: string;
+    updatedAt: string;
+    startedAt?: string;
+    finishedAt?: string;
+    workflow?: string;
+    runner?: string;
+    iteration?: number;
+    maxIterations?: number;
+    agent?: string;
+    step?: string;
+    task?: string;
+    mode?: string;
+    parentRunId?: string;
+    parentToolCallId?: string;
+    parentToolName?: string;
+    edgeKind?: string;
+    edgeLabel?: string;
+    graphOrder?: number;
+    result?: unknown;
+    reason?: string;
+    error?: string;
+    sessionFile?: string;
+}
 export interface CompactionLogEntry {
     phase: 'start' | 'end';
     at: number;
@@ -96,11 +163,50 @@ export interface SendOptions {
 }
 /** Options for `start`. */
 export interface StartOptions {
+    /** Conversation mode. `workflow` starts an autonomous run from `initialPrompt` or `workflow` input. */
+    chatType?: 'interactive' | 'workflow';
+    /** Initial autonomous workflow prompt. Used when `chatType` is `workflow`. */
+    initialPrompt?: string;
+    /** Optional named workflow input for autonomous conversations. */
+    workflow?: {
+        name?: string;
+        input?: unknown;
+        runner?: 'autonomous' | 'supervisor';
+        maxIterations?: number;
+    };
+    /** Optional previous conversation to use as context for a follow-up chat. */
+    parentConversationId?: string;
+    /** How much previous-conversation context to inject. */
+    parentContextMode?: 'summary+artifacts' | 'full-history' | 'artifacts-only';
     /** Optional language override for the newly created conversation. */
     language?: string;
     /** Optional default provider request options for the conversation. */
     requestOptions?: RequestOptions;
 }
+export interface WorkflowStartOptions {
+    workflow: {
+        name?: string;
+        input?: unknown;
+        runner?: 'autonomous' | 'supervisor';
+        maxIterations?: number;
+    };
+    initialPrompt?: string;
+    /** Optional language override for the workflow turn. */
+    language?: string;
+    /** Optional provider request overrides for the workflow turn. */
+    requestOptions?: RequestOptions;
+    model?: unknown;
+}
+export interface UploadFilesOptions {
+    targetDir?: string;
+}
+type MaybeRef<T> = T | Ref<T> | ComputedRef<T>;
+export interface UseAgentRuntimeOptions {
+    /** Override the proxy prefix. Admin pages can point this at an admin-backed proxy. */
+    apiPrefix?: MaybeRef<string | null | undefined>;
+    /** Optional active app id. When it changes, the composable loads that app and starts fresh chat state. */
+    appId?: MaybeRef<string | null | undefined>;
+}
 /** Return shape of {@link useAgentRuntime}. All members are reactive. */
 export interface UseAgentRuntime {
     /** Active conversation id, or `null` until `start()` (or the first `send()`) succeeds. */
@@ -127,12 +233,22 @@ export interface UseAgentRuntime {
     authReady: ComputedRef<boolean>;
     /** Workspace files for the current conversation. Refreshed on every stream `end` event. */
     files: Ref<FileEntry[]>;
+    /** Persisted workflow/subagent runs for the current conversation. */
+    runs: Ref<RunRecord[]>;
     /** 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>;
+    /** Manually re-fetch persisted run records. */
+    refreshRuns: () => Promise<void>;
+    /** Open an existing conversation, load its history, and attach to the live event stream. */
+    open: (conversationId: string) => Promise<void>;
+    /** Upload user files into this conversation workspace. */
+    uploadFiles: (files: File | File[] | FileList, options?: UploadFilesOptions) => Promise<FileEntry[]>;
+    /** Start a named workflow inside the active conversation. */
+    startWorkflow: (options: WorkflowStartOptions) => Promise<void>;
     /** Persist a new auth map; if a conversation is open, push the change to its env. */
     saveAuth: (next: AppAuth) => Promise<void>;
     /** Open a fresh conversation with the current auth. Returns the new id. */
@@ -169,4 +285,5 @@ export interface UseAgentRuntime {
  * </template>
  * ```
  */
-export declare const useAgentRuntime: () => UseAgentRuntime;
+export declare const useAgentRuntime: (options?: UseAgentRuntimeOptions) => UseAgentRuntime;
+export {};

package/dist/runtime/composables/useAgentRuntime.js

@@ -1,4 +1,4 @@
-import { computed, onMounted, ref, shallowRef } from "vue";
+import { computed, onMounted, ref, shallowRef, unref, watch } from "vue";
 import { useRuntimeConfig } from "nuxt/app";
 const newId = () => typeof crypto !== "undefined" && "randomUUID" in crypto ? crypto.randomUUID() : `id-${Date.now()}-${Math.random().toString(36).slice(2)}`;
 const authStorageKey = (appId) => `agent-runtime.app-auth.${appId}`;
@@ -35,9 +35,21 @@ const computeAuthReady = (auth, app) => {
   return required.every((k) => (auth.values[k] ?? "").trim().length > 0);
 };
 const encodeRelPath = (relPath) => relPath.split("/").map(encodeURIComponent).join("/");
-export const useAgentRuntime = () => {
+export const useAgentRuntime = (options = {}) => {
   const cfg = useRuntimeConfig().public.agentRuntime;
-  const apiPrefix = (cfg?.apiPrefix ?? "/api/agent-runtime").replace(/\/+$/, "");
+  const apiPrefix = computed(() => {
+    const raw = options.apiPrefix === void 0 ? cfg?.apiPrefix : unref(options.apiPrefix);
+    return `${raw || "/api/agent-runtime"}`.replace(/\/+$/, "");
+  });
+  const selectedAppId = computed(() => {
+    const raw = options.appId === void 0 ? cfg?.appId : unref(options.appId);
+    return `${raw ?? ""}`.trim();
+  });
+  const withAppQuery = (url) => {
+    const appId = selectedAppId.value;
+    if (!appId) return url;
+    return `${url}${url.includes("?") ? "&" : "?"}appId=${encodeURIComponent(appId)}`;
+  };
   const conversationId = ref(null);
   const messages = shallowRef([]);
   const status = ref("idle");
@@ -49,25 +61,69 @@ export const useAgentRuntime = () => {
   const app = ref(null);
   const auth = ref(emptyAuth());
   const authReady = computed(() => computeAuthReady(auth.value, app.value));
-  onMounted(async () => {
+  let abortController = null;
+  let messageAbortController = null;
+  let currentAssistantId = null;
+  const clearLocalConversation = () => {
+    abortController?.abort();
+    abortController = null;
+    messageAbortController?.abort();
+    messageAbortController = null;
+    conversationId.value = null;
+    currentAssistantId = null;
+    replaceMessages([]);
+    uiActions.value = [];
+    contextUsage.value = null;
+    compactionInProgress.value = false;
+    compactionLog.value = [];
+    files.value = [];
+    runs.value = [];
+    status.value = "idle";
+    error.value = null;
+  };
+  const appUrl = () => {
+    const appId = selectedAppId.value;
+    const suffix = appId ? `?appId=${encodeURIComponent(appId)}` : "";
+    return `${apiPrefix.value}/app${suffix}`;
+  };
+  let appLoadSeq = 0;
+  const loadApp = async () => {
+    const seq = ++appLoadSeq;
+    if (options.appId !== void 0 && !selectedAppId.value) {
+      app.value = null;
+      auth.value = emptyAuth();
+      clearLocalConversation();
+      return;
+    }
     try {
-      const info = await $fetch(`${apiPrefix}/app`);
+      const info = await $fetch(appUrl());
+      if (seq !== appLoadSeq) return;
       app.value = info;
       auth.value = loadAuth(info.appId);
     } catch (err) {
+      if (seq !== appLoadSeq) return;
       console.warn("[agent-runtime] failed to load app manifest", err);
+      app.value = null;
+      auth.value = emptyAuth();
     }
+  };
+  onMounted(loadApp);
+  watch(selectedAppId, async (next, previous) => {
+    if (next === previous) return;
+    clearLocalConversation();
+    await loadApp();
   });
   const files = ref([]);
+  const runs = ref([]);
   const fileUrl = (relPath) => {
     const cid = conversationId.value;
     if (!cid) return "";
-    return `${apiPrefix}/conversations/${cid}/files/raw/${encodeRelPath(relPath)}`;
+    return withAppQuery(`${apiPrefix.value}/conversations/${cid}/files/raw/${encodeRelPath(relPath)}`);
   };
   const filePreviewUrl = (relPath) => {
     const cid = conversationId.value;
     if (!cid) return "";
-    return `${apiPrefix}/conversations/${cid}/files/preview/${encodeRelPath(relPath)}`;
+    return withAppQuery(`${apiPrefix.value}/conversations/${cid}/files/preview/${encodeRelPath(relPath)}`);
   };
   const refreshFiles = async () => {
     const cid = conversationId.value;
@@ -76,14 +132,29 @@ export const useAgentRuntime = () => {
       return;
     }
     try {
-      const res = await $fetch(`${apiPrefix}/conversations/${cid}/files`);
+      const res = await $fetch(withAppQuery(`${apiPrefix.value}/conversations/${cid}/files`));
       files.value = res.items;
     } catch (err) {
       console.warn("[agent-runtime] file list failed", err);
     }
   };
-  let abortController = null;
-  let currentAssistantId = null;
+  const refreshRuns = async () => {
+    const cid = conversationId.value;
+    if (!cid) {
+      runs.value = [];
+      return;
+    }
+    try {
+      const res = await $fetch(withAppQuery(`${apiPrefix.value}/conversations/${cid}/runs`));
+      runs.value = res.runs;
+    } catch (err) {
+      console.warn("[agent-runtime] run list failed", err);
+    }
+  };
+  const upsertRun = (run) => {
+    const next = [run, ...runs.value.filter((item) => item.runId !== run.runId)];
+    runs.value = next.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+  };
   const replaceMessages = (next) => {
     messages.value = next;
   };
@@ -114,13 +185,24 @@ export const useAgentRuntime = () => {
     });
   };
   const upsertToolPart = (toolName, toolCallId, mut) => {
+    let found = false;
+    const nextMessages = messages.value.map((message) => {
+      if (message.role !== "assistant") return message;
+      const parts = message.parts.slice();
+      const idx = parts.findIndex((p) => p.type === `tool-${toolName}` && p.toolCallId === toolCallId);
+      if (idx < 0) return message;
+      found = true;
+      parts[idx] = mut(parts[idx]);
+      return { ...message, parts };
+    });
+    if (found) {
+      replaceMessages(nextMessages);
+      return;
+    }
     ensureAssistant();
     updateAssistant((msg) => {
       const parts = msg.parts.slice();
-      const idx = parts.findIndex((p) => p.type === `tool-${toolName}` && p.toolCallId === toolCallId);
-      const next = mut(idx >= 0 ? parts[idx] : void 0);
-      if (idx >= 0) parts[idx] = next;
-      else parts.push(next);
+      parts.push(mut(void 0));
       return { ...msg, parts };
     });
   };
@@ -208,11 +290,21 @@ export const useAgentRuntime = () => {
         uiActions.value = [{ toolCallId: d.toolCallId, type: d.type, payload: d.payload, at: Date.now() }, ...uiActions.value].slice(0, 50);
         break;
       }
+      case "run_started":
+      case "run_updated":
+      case "run_completed":
+      case "run_failed":
+      case "run_aborted": {
+        const d = data;
+        if (d.run?.runId) upsertRun(d.run);
+        break;
+      }
       case "end":
         compactionInProgress.value = false;
         status.value = "ready";
         currentAssistantId = null;
         void refreshFiles();
+        void refreshRuns();
         break;
       case "error": {
         const d = data;
@@ -227,7 +319,7 @@ export const useAgentRuntime = () => {
     }
   };
   const consume = async (signal) => {
-    const res = await fetch(`${apiPrefix}/conversations/${conversationId.value}/stream`, { signal });
+    const res = await fetch(withAppQuery(`${apiPrefix.value}/conversations/${conversationId.value}/stream`), { signal });
     if (!res.ok || !res.body) throw new Error(`stream failed: ${res.status}`);
     const reader = res.body.getReader();
     const decoder = new TextDecoder();
@@ -259,7 +351,17 @@ export const useAgentRuntime = () => {
       }
     }
   };
-  const start = async (options = {}) => {
+  const openStream = () => {
+    abortController?.abort();
+    abortController = new AbortController();
+    const signal = abortController.signal;
+    consume(signal).catch((err) => {
+      if (signal.aborted) return;
+      error.value = err instanceof Error ? err : new Error(String(err));
+      status.value = "error";
+    });
+  };
+  const start = async (options2 = {}) => {
     if (!authReady.value) {
       const missing = app.value ? Object.entries(app.value.envSchema).filter(([k, f]) => f.required && !(auth.value.values[k] ?? "").trim()).map(([k]) => k) : [];
       throw new Error(
@@ -267,31 +369,79 @@ export const useAgentRuntime = () => {
       );
     }
     error.value = null;
-    const res = await $fetch(`${apiPrefix}/conversations`, {
+    const res = await $fetch(`${apiPrefix.value}/conversations`, {
       method: "POST",
       body: {
         env: buildEnvFromAuth(auth.value),
-        language: options.language,
-        requestOptions: options.requestOptions
+        appId: (app.value?.appId ?? selectedAppId.value) || void 0,
+        chatType: options2.chatType,
+        initialPrompt: options2.initialPrompt,
+        workflow: options2.workflow,
+        parentConversationId: options2.parentConversationId,
+        parentContextMode: options2.parentContextMode,
+        language: options2.language,
+        requestOptions: options2.requestOptions
       }
     });
     conversationId.value = res.conversationId;
-    abortController?.abort();
-    abortController = new AbortController();
-    const signal = abortController.signal;
-    consume(signal).catch((err) => {
-      if (signal.aborted) return;
-      error.value = err instanceof Error ? err : new Error(String(err));
-      status.value = "error";
-    });
+    openStream();
     void refreshFiles();
+    void refreshRuns();
     return res.conversationId;
   };
+  const open = async (id) => {
+    const nextId = id.trim();
+    if (!nextId) return;
+    abortController?.abort();
+    abortController = null;
+    messageAbortController?.abort();
+    messageAbortController = null;
+    error.value = null;
+    status.value = "ready";
+    currentAssistantId = null;
+    conversationId.value = nextId;
+    uiActions.value = [];
+    contextUsage.value = null;
+    compactionInProgress.value = false;
+    compactionLog.value = [];
+    const history = await $fetch(
+      withAppQuery(`${apiPrefix.value}/conversations/${nextId}/history`)
+    );
+    replaceMessages(history.messages ?? []);
+    openStream();
+    await Promise.all([refreshFiles(), refreshRuns()]);
+  };
+  const uploadFiles = async (filesInput, options2 = {}) => {
+    const cid = conversationId.value;
+    if (!cid) throw new Error("Start or open a conversation before uploading files.");
+    const filesArray = typeof FileList !== "undefined" && filesInput instanceof FileList ? Array.from(filesInput) : Array.isArray(filesInput) ? filesInput : [filesInput];
+    const form = new FormData();
+    if (options2.targetDir) form.append("targetDir", options2.targetDir);
+    for (const file of filesArray) form.append("files", file, file.name);
+    const res = await $fetch(withAppQuery(`${apiPrefix.value}/conversations/${cid}/files`), {
+      method: "POST",
+      body: form
+    });
+    await refreshFiles();
+    return res.items;
+  };
+  const startWorkflow = async (options2) => {
+    const cid = conversationId.value;
+    if (!cid) throw new Error("Start or open a conversation before running a workflow.");
+    error.value = null;
+    status.value = "submitted";
+    if (!abortController) openStream();
+    await $fetch(withAppQuery(`${apiPrefix.value}/conversations/${cid}/workflows`), {
+      method: "POST",
+      body: options2
+    });
+    await refreshRuns();
+  };
   const saveAuth = async (next) => {
     auth.value = { values: { ...next.values } };
     if (app.value) persistAuth(app.value.appId, auth.value);
     if (conversationId.value) {
-      await $fetch(`${apiPrefix}/conversations/${conversationId.value}/env`, {
+      await $fetch(withAppQuery(`${apiPrefix.value}/conversations/${conversationId.value}/env`), {
         method: "POST",
         body: { env: buildEnvFromAuth(auth.value), merge: true }
       }).catch((err) => {
@@ -299,43 +449,63 @@ export const useAgentRuntime = () => {
       });
     }
   };
-  const send = async (text, options = {}) => {
+  const send = async (text, options2 = {}) => {
     if (!text.trim()) return;
     if (!conversationId.value) {
       try {
-        await start({ language: options.language });
+        await start({ language: options2.language });
       } catch (err) {
         error.value = err instanceof Error ? err : new Error(String(err));
         status.value = "error";
         return;
       }
+    } else if (!abortController) {
+      openStream();
     }
     error.value = null;
     status.value = "submitted";
     currentAssistantId = null;
+    messageAbortController?.abort();
+    const messageController = new AbortController();
+    messageAbortController = messageController;
     replaceMessages([
       ...messages.value,
       { id: newId(), role: "user", parts: [{ type: "text", text }] }
     ]);
-    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,
-        requestOptions: options.requestOptions
-      }
-    }).catch((err) => {
+    const wireContent = options2.rewriteContent ? options2.rewriteContent(text) : text;
+    try {
+      await $fetch(withAppQuery(`${apiPrefix.value}/conversations/${conversationId.value}/messages`), {
+        method: "POST",
+        signal: messageController.signal,
+        body: {
+          content: wireContent,
+          context: options2.context,
+          language: options2.language,
+          requestOptions: options2.requestOptions
+        }
+      });
+    } catch (err) {
+      if (messageController.signal.aborted) return;
       error.value = err instanceof Error ? err : new Error(String(err));
       status.value = "error";
-    });
+    } finally {
+      if (messageAbortController === messageController) {
+        messageAbortController = null;
+      }
+    }
   };
   const abort = async () => {
-    if (!conversationId.value) return;
-    await $fetch(`${apiPrefix}/conversations/${conversationId.value}/abort`, { method: "POST" }).catch(() => {
-    });
+    const cid = conversationId.value;
+    if (!cid) return;
+    abortController?.abort();
+    abortController = null;
+    messageAbortController?.abort();
+    messageAbortController = null;
+    compactionInProgress.value = false;
     status.value = "ready";
+    currentAssistantId = null;
+    void $fetch(withAppQuery(`${apiPrefix.value}/conversations/${cid}/abort`), { method: "POST" }).catch(() => {
+    });
   };
   const reset = async () => {
     abortController?.abort();
@@ -348,6 +518,7 @@ export const useAgentRuntime = () => {
     compactionInProgress.value = false;
     compactionLog.value = [];
     files.value = [];
+    runs.value = [];
     status.value = "idle";
     error.value = null;
   };
@@ -367,9 +538,14 @@ export const useAgentRuntime = () => {
     auth,
     authReady,
     files,
+    runs,
     fileUrl,
     filePreviewUrl,
     refreshFiles,
+    refreshRuns,
+    open,
+    uploadFiles,
+    startWorkflow,
     saveAuth,
     start,
     send,

package/dist/runtime/server/api/app.get.d.ts

@@ -2,6 +2,7 @@ interface AppEnvField {
     required?: boolean;
     secret?: boolean;
     description?: string;
+    default?: string;
 }
 /**
  * GET `${apiPrefix}/app` — returns the manifest of the configured app
@@ -11,5 +12,7 @@ declare const _default: import("h3").EventHandler<import("h3").EventHandlerReque
     appId: string;
     name: string;
     envSchema: Record<string, AppEnvField>;
+    start: unknown;
+    workflows: Record<string, unknown>;
 }>>;
 export default _default;

package/dist/runtime/server/api/app.get.js

@@ -1,7 +1,7 @@
 import { createError, defineEventHandler } from "h3";
 import { agentRuntime, agentRuntimeHeaders } from "../utils/agent-runtime.js";
-export default defineEventHandler(async () => {
-  const cfg = agentRuntime();
+export default defineEventHandler(async (event) => {
+  const cfg = agentRuntime(event);
   const response = await fetch(`${cfg.baseUrl}/v1/apps`, {
     headers: agentRuntimeHeaders(cfg)
   });
@@ -22,6 +22,8 @@ export default defineEventHandler(async () => {
   return {
     appId: app.appId,
     name: app.name,
-    envSchema: app.envSchema ?? {}
+    envSchema: app.envSchema ?? {},
+    start: app.start,
+    workflows: app.workflows ?? {}
   };
 });

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

@@ -1,7 +1,7 @@
 import { createError, defineEventHandler, getRouterParam, setResponseStatus } from "h3";
 import { agentRuntime, agentRuntimeHeaders } from "../../../utils/agent-runtime.js";
 export default defineEventHandler(async (event) => {
-  const cfg = agentRuntime();
+  const cfg = agentRuntime(event);
   const id = getRouterParam(event, "id");
   if (!id) throw createError({ statusCode: 400, statusMessage: "missing conversation id" });
   const response = await fetch(`${cfg.baseUrl}/v1/conversations/${id}/abort`, {

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

@@ -1,7 +1,7 @@
 import { createError, defineEventHandler, getRouterParam, readBody } from "h3";
 import { agentRuntime, agentRuntimeHeaders } from "../../../utils/agent-runtime.js";
 export default defineEventHandler(async (event) => {
-  const cfg = agentRuntime();
+  const cfg = agentRuntime(event);
   const id = getRouterParam(event, "id");
   if (!id) throw createError({ statusCode: 400, statusMessage: "missing conversation id" });
   const body = await readBody(event).catch(() => ({}));

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

@@ -11,7 +11,7 @@ const PASS_THROUGH_HEADERS = [
   "x-content-type-options"
 ];
 export default defineEventHandler(async (event) => {
-  const cfg = agentRuntime();
+  const cfg = agentRuntime(event);
   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(/\/+$/, "");

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

@@ -4,7 +4,7 @@ import { createError, defineEventHandler, getRouterParam, sendStream, setHeader
 import { agentRuntime } from "../../../../../utils/agent-runtime.js";
 const PASS_THROUGH_HEADERS = ["content-type", "content-length", "content-disposition", "cache-control"];
 export default defineEventHandler(async (event) => {
-  const cfg = agentRuntime();
+  const cfg = agentRuntime(event);
   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(/\/+$/, "");

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

@@ -1,7 +1,7 @@
 import { createError, defineEventHandler, getRouterParam } from "h3";
 import { agentRuntime } from "../../../utils/agent-runtime.js";
 export default defineEventHandler(async (event) => {
-  const cfg = agentRuntime();
+  const cfg = agentRuntime(event);
   const id = getRouterParam(event, "id");
   if (!id) throw createError({ statusCode: 400, statusMessage: "missing conversation id" });
   const response = await fetch(`${cfg.baseUrl}/v1/conversations/${id}/files`, {

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

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

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

@@ -0,0 +1,34 @@
+import { createError, defineEventHandler, getRouterParam, readMultipartFormData } from "h3";
+import { agentRuntime } from "../../../utils/agent-runtime.js";
+export default defineEventHandler(async (event) => {
+  const cfg = agentRuntime(event);
+  const id = getRouterParam(event, "id");
+  if (!id) throw createError({ statusCode: 400, statusMessage: "missing conversation id" });
+  const parts = await readMultipartFormData(event);
+  if (!parts?.length) throw createError({ statusCode: 400, statusMessage: "expected multipart/form-data" });
+  const form = new FormData();
+  for (const part of parts) {
+    if (!part.name) continue;
+    if (part.filename) {
+      const bytes = new Uint8Array(part.data.length);
+      bytes.set(part.data);
+      form.append(part.name, new Blob([bytes], { type: part.type || "application/octet-stream" }), part.filename);
+    } else {
+      form.append(part.name, part.data.toString("utf8"));
+    }
+  }
+  const response = await fetch(`${cfg.baseUrl}/v1/conversations/${id}/files`, {
+    method: "POST",
+    headers: {
+      "X-Agent-Runtime-App-Key": cfg.appKey
+    },
+    body: form
+  });
+  if (!response.ok) {
+    throw createError({
+      statusCode: response.status,
+      statusMessage: await response.text()
+    });
+  }
+  return await response.json();
+});

package/dist/runtime/server/api/conversations/[id]/history.get.js

@@ -1,7 +1,7 @@
 import { createError, defineEventHandler, getRouterParam } from "h3";
 import { agentRuntime } from "../../../utils/agent-runtime.js";
 export default defineEventHandler(async (event) => {
-  const cfg = agentRuntime();
+  const cfg = agentRuntime(event);
   const id = getRouterParam(event, "id");
   if (!id) throw createError({ statusCode: 400, statusMessage: "missing conversation id" });
   const response = await fetch(`${cfg.baseUrl}/v1/conversations/${id}/history`, {

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

@@ -1,7 +1,7 @@
 import { createError, defineEventHandler, getRouterParam, readBody } from "h3";
 import { agentRuntime, agentRuntimeHeaders } from "../../../utils/agent-runtime.js";
 export default defineEventHandler(async (event) => {
-  const cfg = agentRuntime();
+  const cfg = agentRuntime(event);
   const id = getRouterParam(event, "id");
   if (!id) throw createError({ statusCode: 400, statusMessage: "missing conversation id" });
   const body = await readBody(event);

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

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

package/dist/runtime/server/api/conversations/[id]/runs/[runId].get.js

@@ -0,0 +1,19 @@
+import { createError, defineEventHandler, getRouterParam } from "h3";
+import { agentRuntime } from "../../../../utils/agent-runtime.js";
+export default defineEventHandler(async (event) => {
+  const cfg = agentRuntime(event);
+  const id = getRouterParam(event, "id");
+  const runId = getRouterParam(event, "runId");
+  if (!id) throw createError({ statusCode: 400, statusMessage: "missing conversation id" });
+  if (!runId) throw createError({ statusCode: 400, statusMessage: "missing run id" });
+  const response = await fetch(`${cfg.baseUrl}/v1/conversations/${id}/runs/${runId}`, {
+    headers: { "X-Agent-Runtime-App-Key": cfg.appKey }
+  });
+  if (!response.ok) {
+    throw createError({
+      statusCode: response.status,
+      statusMessage: await response.text()
+    });
+  }
+  return await response.json();
+});

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

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

package/dist/runtime/server/api/conversations/[id]/runs.get.js

@@ -0,0 +1,17 @@
+import { createError, defineEventHandler, getRouterParam } from "h3";
+import { agentRuntime } from "../../../utils/agent-runtime.js";
+export default defineEventHandler(async (event) => {
+  const cfg = agentRuntime(event);
+  const id = getRouterParam(event, "id");
+  if (!id) throw createError({ statusCode: 400, statusMessage: "missing conversation id" });
+  const response = await fetch(`${cfg.baseUrl}/v1/conversations/${id}/runs`, {
+    headers: { "X-Agent-Runtime-App-Key": cfg.appKey }
+  });
+  if (!response.ok) {
+    throw createError({
+      statusCode: response.status,
+      statusMessage: await response.text()
+    });
+  }
+  return await response.json();
+});

package/dist/runtime/server/api/conversations/[id]/stream.get.js

@@ -2,7 +2,7 @@ import { Readable } from "node:stream";
 import { createError, defineEventHandler, getRouterParam, sendStream, setHeader } from "h3";
 import { agentRuntime } from "../../../utils/agent-runtime.js";
 export default defineEventHandler(async (event) => {
-  const cfg = agentRuntime();
+  const cfg = agentRuntime(event);
   const id = getRouterParam(event, "id");
   if (!id) throw createError({ statusCode: 400, statusMessage: "missing conversation id" });
   const controller = new AbortController();

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

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

package/dist/runtime/server/api/conversations/[id]/workflow.get.js

@@ -0,0 +1,17 @@
+import { createError, defineEventHandler, getRouterParam } from "h3";
+import { agentRuntime } from "../../../utils/agent-runtime.js";
+export default defineEventHandler(async (event) => {
+  const cfg = agentRuntime(event);
+  const id = getRouterParam(event, "id");
+  if (!id) throw createError({ statusCode: 400, statusMessage: "missing conversation id" });
+  const response = await fetch(`${cfg.baseUrl}/v1/conversations/${id}/workflow`, {
+    headers: { "X-Agent-Runtime-App-Key": cfg.appKey }
+  });
+  if (!response.ok) {
+    throw createError({
+      statusCode: response.status,
+      statusMessage: await response.text()
+    });
+  }
+  return await response.json();
+});

package/dist/runtime/server/api/conversations/[id]/workflows.post.d.ts

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

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

@@ -0,0 +1,27 @@
+import { createError, defineEventHandler, getRouterParam, readBody } from "h3";
+import { agentRuntime, agentRuntimeHeaders } from "../../../utils/agent-runtime.js";
+export default defineEventHandler(async (event) => {
+  const cfg = agentRuntime(event);
+  const id = getRouterParam(event, "id");
+  if (!id) throw createError({ statusCode: 400, statusMessage: "missing conversation id" });
+  const body = await readBody(event);
+  if (!body?.workflow) throw createError({ statusCode: 400, statusMessage: "missing workflow" });
+  const response = await fetch(`${cfg.baseUrl}/v1/conversations/${id}/workflows`, {
+    method: "POST",
+    headers: agentRuntimeHeaders(cfg),
+    body: JSON.stringify({
+      workflow: body.workflow,
+      initialPrompt: body.initialPrompt,
+      requestOptions: body.requestOptions,
+      language: body.language,
+      model: body.model
+    })
+  });
+  if (!response.ok) {
+    throw createError({
+      statusCode: response.status,
+      statusMessage: await response.text()
+    });
+  }
+  return await response.json();
+});

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

@@ -1,7 +1,7 @@
 import { createError, defineEventHandler, getRouterParam, setResponseStatus } from "h3";
 import { agentRuntime } from "../../utils/agent-runtime.js";
 export default defineEventHandler(async (event) => {
-  const cfg = agentRuntime();
+  const cfg = agentRuntime(event);
   const id = getRouterParam(event, "id");
   if (!id) throw createError({ statusCode: 400, statusMessage: "missing conversation id" });
   const response = await fetch(`${cfg.baseUrl}/v1/conversations/${id}`, {

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

@@ -1,8 +1,8 @@
 import { createError, defineEventHandler, readBody } from "h3";
 import { agentRuntime, agentRuntimeHeaders } from "../utils/agent-runtime.js";
 export default defineEventHandler(async (event) => {
-  const cfg = agentRuntime();
   const body = await readBody(event).catch(() => ({}));
+  const cfg = agentRuntime(event, body.appId);
   const response = await fetch(`${cfg.baseUrl}/v1/conversations`, {
     method: "POST",
     headers: agentRuntimeHeaders(cfg),
@@ -10,8 +10,15 @@ export default defineEventHandler(async (event) => {
       appId: cfg.appId,
       env: body.env ?? {},
       model: body.model,
+      chatType: body.chatType,
+      initialPrompt: body.initialPrompt,
+      workflow: body.workflow,
+      parentConversationId: body.parentConversationId,
+      parentContextMode: body.parentContextMode,
       requestOptions: body.requestOptions,
-      language: body.language
+      language: body.language,
+      systemPromptAppend: body.systemPromptAppend,
+      metadata: body.metadata
     })
   });
   if (!response.ok) {

package/dist/runtime/server/utils/agent-runtime.d.ts

@@ -1,12 +1,7 @@
+import { type H3Event } from 'h3';
 import { type AgentRuntimeResolvedConfig } from '../../shared.js';
 /** Resolved server-side configuration for talking to agent-runtime. */
 export type AgentRuntimeRuntime = AgentRuntimeResolvedConfig;
-/**
- * Read the agent-runtime section of `runtimeConfig`, validating that the app key
- * has been provided. Throws a typed Nitro 500 otherwise so the proxy routes
- * surface a clear error instead of silently forwarding an unauthenticated
- * request.
- */
-export declare const agentRuntime: () => AgentRuntimeRuntime;
+export declare const agentRuntime: (event?: H3Event, appId?: string | null) => AgentRuntimeRuntime;
 /** Build the standard JSON request headers, including the app key. */
 export declare const agentRuntimeHeaders: (cfg: AgentRuntimeRuntime, extra?: Record<string, string>) => Record<string, string>;

package/dist/runtime/server/utils/agent-runtime.js

@@ -1,9 +1,17 @@
 import { useRuntimeConfig } from "#imports";
-import { createError } from "h3";
+import { createError, getQuery } from "h3";
 import { createAgentRuntimeRequestHeaders, resolveAgentRuntimeConfig } from "../../shared.js";
-export const agentRuntime = () => {
+const queryAppId = (event) => {
+  if (!event) return void 0;
+  const raw = getQuery(event).appId;
+  if (Array.isArray(raw)) return raw[0] ? String(raw[0]) : void 0;
+  return raw ? String(raw) : void 0;
+};
+export const agentRuntime = (event, appId) => {
   try {
-    return resolveAgentRuntimeConfig(useRuntimeConfig().agentRuntime);
+    return resolveAgentRuntimeConfig(useRuntimeConfig().agentRuntime, {
+      appId: appId || queryAppId(event)
+    });
   } catch (error) {
     throw createError({
       statusCode: 500,

package/dist/runtime/shared.d.ts

@@ -2,6 +2,11 @@ export interface AgentRuntimeConfigInput {
     baseUrl?: string | null;
     appKey?: string | null;
     appId?: string | null;
+    apps?: Record<string, {
+        baseUrl?: string | null;
+        appKey?: string | null;
+        appId?: string | null;
+    }> | null;
 }
 export interface AgentRuntimeResolvedConfig {
     baseUrl: string;
@@ -11,6 +16,7 @@ export interface AgentRuntimeResolvedConfig {
 export declare const normalizeAgentRuntimeBaseUrl: (value: string | null | undefined) => string;
 export declare const createScopeFingerprint: (parts: Array<string | null | undefined>) => string;
 export declare const resolveAgentRuntimeConfig: (config: AgentRuntimeConfigInput | null | undefined, options?: {
+    appId?: string | null;
     defaultAppId?: string;
 }) => AgentRuntimeResolvedConfig;
 export declare const createAgentRuntimeRequestHeaders: (config: Pick<AgentRuntimeResolvedConfig, "appKey">, extra?: Record<string, string>) => Record<string, string>;

package/dist/runtime/shared.js

@@ -5,14 +5,18 @@ export const createScopeFingerprint = (parts) => {
   return createHash("sha256").update(normalized).digest("hex").slice(0, 12);
 };
 export const resolveAgentRuntimeConfig = (config, options) => {
-  const appKey = String(config?.appKey || "").trim();
+  const requestedAppId = String(options?.appId || "").trim();
+  const defaultAppId = String(config?.appId || options?.defaultAppId || "omnisearch").trim();
+  const selectedAppId = requestedAppId || defaultAppId;
+  const appConfig = selectedAppId ? config?.apps?.[selectedAppId] : void 0;
+  const appKey = String(appConfig?.appKey || (!requestedAppId || selectedAppId === config?.appId ? config?.appKey : "") || "").trim();
   if (!appKey) {
-    throw new Error("[agent-runtime] AGENT_RUNTIME_APP_KEY is not configured");
+    throw new Error(`[agent-runtime] AGENT_RUNTIME_APP_KEY is not configured for app "${selectedAppId}"`);
   }
   return {
-    baseUrl: normalizeAgentRuntimeBaseUrl(config?.baseUrl),
+    baseUrl: normalizeAgentRuntimeBaseUrl(appConfig?.baseUrl || config?.baseUrl),
     appKey,
-    appId: String(config?.appId || options?.defaultAppId || "omnisearch")
+    appId: String(appConfig?.appId || selectedAppId)
   };
 };
 export const createAgentRuntimeRequestHeaders = (config, extra = {}) => ({

package/dist/types.d.mts

@@ -1,4 +1,4 @@
-export { type AppAuth, type AppEnvField, type AppInfo, type ChatStatus, type FileEntry, type SendOptions, type UIMessage, type UiAction, type UseAgentRuntime } from '../dist/runtime/composables/useAgentRuntime.js'
+export { type AppAuth, type AppEnvField, type AppInfo, type AppStartField, type AppStartSpec, type ChatStatus, type FileEntry, type RunKind, type RunRecord, type RunStatus, type SendOptions, type UIMessage, type UiAction, type UploadFilesOptions, type UseAgentRuntime, type UseAgentRuntimeOptions, type WorkflowStartOptions } from '../dist/runtime/composables/useAgentRuntime.js'
 
 export { type AgentRuntimeMarkdownRenderOptions } from '../dist/runtime/composables/useAgentRuntimeMarkdown.js'
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d4y/agent-runtime-nuxt",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "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",
@@ -57,20 +57,20 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@nuxt/kit": "^4.4.2",
-    "ai": "^6.0.168",
-    "defu": "^6.1.4",
-    "h3": "^1.15.11",
-    "markdown-it": "^14.1.1"
+    "@nuxt/kit": "4.4.4",
+    "ai": "6.0.175",
+    "defu": "6.1.7",
+    "h3": "1.15.11",
+    "markdown-it": "14.1.1"
   },
   "devDependencies": {
-    "@nuxt/module-builder": "^1.0.2",
-    "@nuxt/schema": "^4.4.2",
-    "@types/markdown-it": "^14.1.2",
-    "nuxt": "^4.4.2",
-    "typescript": "^6.0.2",
-    "vue": "^3.5.32",
-    "vue-tsc": "^3.2.7"
+    "@nuxt/module-builder": "1.0.2",
+    "@nuxt/schema": "4.4.4",
+    "@types/markdown-it": "14.1.2",
+    "nuxt": "4.4.4",
+    "typescript": "6.0.3",
+    "vue": "3.5.34",
+    "vue-tsc": "3.2.8"
   },
   "peerDependencies": {
     "nuxt": "^3.13.0 || ^4.0.0"