@d4y/agent-runtime-nuxt 0.1.4 → 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.4",
+  "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/components/AgentRuntimeMarkdown.d.vue.ts

@@ -4,6 +4,11 @@ type __VLS_Props = {
     streaming?: boolean;
     resolveWorkspacePath?: ((relPath: string) => string | null | undefined) | null;
     resolveWorkspacePreviewPath?: ((relPath: string) => string | null | undefined) | null;
+    previewLinkLabel?: string;
+    downloadLinkLabel?: string;
+    pdfPreviewTitleLabel?: string;
+    htmlPreviewTitleLabel?: string;
+    showPdfEmbedToolbar?: boolean;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     renderedChange: (rendered: boolean) => any;
@@ -11,6 +16,11 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
     onRenderedChange?: ((rendered: boolean) => any) | undefined;
 }>, {
     class: string | Record<string, boolean> | string[];
+    previewLinkLabel: string;
+    downloadLinkLabel: string;
+    pdfPreviewTitleLabel: string;
+    htmlPreviewTitleLabel: string;
+    showPdfEmbedToolbar: boolean;
     streaming: boolean;
     resolveWorkspacePath: ((relPath: string) => string | null | undefined) | null;
     resolveWorkspacePreviewPath: ((relPath: string) => string | null | undefined) | null;

package/dist/runtime/components/AgentRuntimeMarkdown.vue

@@ -8,13 +8,23 @@ const props = defineProps({
   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 }
+  resolveWorkspacePreviewPath: { type: [Function, null], required: false, default: null },
+  previewLinkLabel: { type: String, required: false, default: "Preview" },
+  downloadLinkLabel: { type: String, required: false, default: "Download" },
+  pdfPreviewTitleLabel: { type: String, required: false, default: "PDF preview" },
+  htmlPreviewTitleLabel: { type: String, required: false, default: "HTML preview" },
+  showPdfEmbedToolbar: { type: Boolean, required: false, default: false }
 });
-const { render } = useAgentRuntimeMarkdown({
+const renderer = computed(() => useAgentRuntimeMarkdown({
   resolveWorkspacePath: (relPath) => props.resolveWorkspacePath?.(relPath) ?? null,
-  resolveWorkspacePreviewPath: (relPath) => props.resolveWorkspacePreviewPath?.(relPath) ?? null
-});
-const html = computed(() => props.text ? render(props.text) : "");
+  resolveWorkspacePreviewPath: (relPath) => props.resolveWorkspacePreviewPath?.(relPath) ?? null,
+  previewLinkLabel: props.previewLinkLabel,
+  downloadLinkLabel: props.downloadLinkLabel,
+  pdfPreviewTitleLabel: props.pdfPreviewTitleLabel,
+  htmlPreviewTitleLabel: props.htmlPreviewTitleLabel,
+  showPdfEmbedToolbar: props.showPdfEmbedToolbar
+}));
+const html = computed(() => props.text ? renderer.value.render(props.text) : "");
 const dialogOpen = ref(false);
 const dialogFile = ref(null);
 const dialogPreviewSrc = ref(null);
@@ -57,7 +67,7 @@ watch(rendered, async (value) => {
   <div
     v-if="rendered"
     class="agent-runtime-markdown"
-    :class="[props.class, streaming ? 'agent-runtime-markdown--streaming' : '']"
+    :class="props.class"
     @click="onClick"
     v-html="
   html
@@ -73,5 +83,5 @@ watch(rendered, async (value) => {
 </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)}}
+.agent-runtime-markdown{line-height:1.65}.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%}
 </style>

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

@@ -4,6 +4,11 @@ type __VLS_Props = {
     streaming?: boolean;
     resolveWorkspacePath?: ((relPath: string) => string | null | undefined) | null;
     resolveWorkspacePreviewPath?: ((relPath: string) => string | null | undefined) | null;
+    previewLinkLabel?: string;
+    downloadLinkLabel?: string;
+    pdfPreviewTitleLabel?: string;
+    htmlPreviewTitleLabel?: string;
+    showPdfEmbedToolbar?: boolean;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     renderedChange: (rendered: boolean) => any;
@@ -11,6 +16,11 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
     onRenderedChange?: ((rendered: boolean) => any) | undefined;
 }>, {
     class: string | Record<string, boolean> | string[];
+    previewLinkLabel: string;
+    downloadLinkLabel: string;
+    pdfPreviewTitleLabel: string;
+    htmlPreviewTitleLabel: string;
+    showPdfEmbedToolbar: boolean;
     streaming: boolean;
     resolveWorkspacePath: ((relPath: string) => string | null | undefined) | null;
     resolveWorkspacePreviewPath: ((relPath: string) => string | null | undefined) | null;

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 {};