@d4y/agent-runtime-nuxt 0.1.0 → 0.1.1

package/dist/module.json

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

package/dist/runtime/frontend.d.ts

@@ -0,0 +1,5 @@
+export type { AgentRuntimeMarkdownRenderOptions } from './composables/useAgentRuntimeMarkdown.js';
+export type { AgentRuntimeFileLike, AgentRuntimeFilePreviewKind } from './utils/files.js';
+export { default as AgentRuntimeArtifactPreview } from './components/AgentRuntimeArtifactPreview.vue.js';
+export { createAgentRuntimeMarkdownRenderer, useAgentRuntimeMarkdown } from './composables/useAgentRuntimeMarkdown.js';
+export { canPreviewAgentRuntimeFileInline, getAgentRuntimeFilePreviewKind, isAgentRuntimeImageMimeType, isAgentRuntimeImagePath, isAgentRuntimePdfMimeType, isAgentRuntimePdfPath, isAgentRuntimeTextMimeType, isAgentRuntimeTextPath, resolveAgentRuntimeWorkspaceUri, toAgentRuntimeWorkspaceRelativePath, } from './utils/files.js';

package/dist/runtime/frontend.js

@@ -0,0 +1,14 @@
+export { default as AgentRuntimeArtifactPreview } from "./components/AgentRuntimeArtifactPreview.vue";
+export { createAgentRuntimeMarkdownRenderer, useAgentRuntimeMarkdown } from "./composables/useAgentRuntimeMarkdown.js";
+export {
+  canPreviewAgentRuntimeFileInline,
+  getAgentRuntimeFilePreviewKind,
+  isAgentRuntimeImageMimeType,
+  isAgentRuntimeImagePath,
+  isAgentRuntimePdfMimeType,
+  isAgentRuntimePdfPath,
+  isAgentRuntimeTextMimeType,
+  isAgentRuntimeTextPath,
+  resolveAgentRuntimeWorkspaceUri,
+  toAgentRuntimeWorkspaceRelativePath
+} from "./utils/files.js";

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

@@ -1,4 +1,4 @@
-import { type AgentRuntimeResolvedConfig } from '../../../shared.js';
+import { type AgentRuntimeResolvedConfig } from '../../shared.js';
 /** Resolved server-side configuration for talking to agent-runtime. */
 export type AgentRuntimeRuntime = AgentRuntimeResolvedConfig;
 /**

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

@@ -1,4 +1,4 @@
-import { createAgentRuntimeRequestHeaders, resolveAgentRuntimeConfig } from "../../../shared";
+import { createAgentRuntimeRequestHeaders, resolveAgentRuntimeConfig } from "../../shared.js";
 export const agentRuntime = () => {
   try {
     return resolveAgentRuntimeConfig(useRuntimeConfig().agentRuntime);

package/dist/runtime/shared.d.ts

@@ -0,0 +1,16 @@
+export interface AgentRuntimeConfigInput {
+    baseUrl?: string | null;
+    appKey?: string | null;
+    appId?: string | null;
+}
+export interface AgentRuntimeResolvedConfig {
+    baseUrl: string;
+    appKey: string;
+    appId: string;
+}
+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?: {
+    defaultAppId?: string;
+}) => AgentRuntimeResolvedConfig;
+export declare const createAgentRuntimeRequestHeaders: (config: Pick<AgentRuntimeResolvedConfig, "appKey">, extra?: Record<string, string>) => Record<string, string>;

package/dist/runtime/shared.js

@@ -0,0 +1,22 @@
+import { createHash } from "node:crypto";
+export const normalizeAgentRuntimeBaseUrl = (value) => String(value || "").trim().replace(/\/+$/, "");
+export const createScopeFingerprint = (parts) => {
+  const normalized = parts.map((part) => typeof part === "string" && part.trim().length > 0 ? part.trim() : "none").join("|");
+  return createHash("sha256").update(normalized).digest("hex").slice(0, 12);
+};
+export const resolveAgentRuntimeConfig = (config, options) => {
+  const appKey = String(config?.appKey || "").trim();
+  if (!appKey) {
+    throw new Error("[agent-runtime] AGENT_RUNTIME_APP_KEY is not configured");
+  }
+  return {
+    baseUrl: normalizeAgentRuntimeBaseUrl(config?.baseUrl),
+    appKey,
+    appId: String(config?.appId || options?.defaultAppId || "omnisearch")
+  };
+};
+export const createAgentRuntimeRequestHeaders = (config, extra = {}) => ({
+  "X-Agent-Runtime-App-Key": config.appKey,
+  "content-type": "application/json",
+  ...extra
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d4y/agent-runtime-nuxt",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "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",
@@ -12,25 +12,36 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
-  "main": "./src/module.ts",
-  "types": "./src/module.ts",
+  "main": "./dist/module.mjs",
   "exports": {
     ".": {
-      "types": "./src/module.ts",
-      "import": "./src/module.ts"
+      "types": "./dist/module.d.mts",
+      "import": "./dist/module.mjs"
     },
     "./frontend": {
-      "types": "./src/frontend.ts",
-      "import": "./src/frontend.ts"
+      "types": "./dist/runtime/frontend.d.ts",
+      "import": "./dist/runtime/frontend.js"
     },
     "./shared": {
-      "types": "./src/shared.ts",
-      "import": "./src/shared.ts"
+      "types": "./dist/runtime/shared.d.ts",
+      "import": "./dist/runtime/shared.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      ".": [
+        "./dist/module.d.mts"
+      ],
+      "frontend": [
+        "./dist/runtime/frontend.d.ts"
+      ],
+      "shared": [
+        "./dist/runtime/shared.d.ts"
+      ]
     }
   },
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
   "keywords": [
     "nuxt",

package/src/frontend.ts

@@ -1,16 +0,0 @@
-export type { AgentRuntimeMarkdownRenderOptions } from './runtime/composables/useAgentRuntimeMarkdown'
-export type { AgentRuntimeFileLike, AgentRuntimeFilePreviewKind } from './runtime/utils/files'
-export { default as AgentRuntimeArtifactPreview } from './runtime/components/AgentRuntimeArtifactPreview.vue'
-export { createAgentRuntimeMarkdownRenderer, useAgentRuntimeMarkdown } from './runtime/composables/useAgentRuntimeMarkdown'
-export {
-  canPreviewAgentRuntimeFileInline,
-  getAgentRuntimeFilePreviewKind,
-  isAgentRuntimeImageMimeType,
-  isAgentRuntimeImagePath,
-  isAgentRuntimePdfMimeType,
-  isAgentRuntimePdfPath,
-  isAgentRuntimeTextMimeType,
-  isAgentRuntimeTextPath,
-  resolveAgentRuntimeWorkspaceUri,
-  toAgentRuntimeWorkspaceRelativePath,
-} from './runtime/utils/files'

package/src/module.ts

@@ -1,155 +0,0 @@
-import { defineNuxtModule, createResolver, addImportsDir, addServerHandler, addTypeTemplate } from '@nuxt/kit'
-import { defu } from 'defu'
-
-// Re-export the public composable surface so consumers can `import type
-// { UIMessage, AppInfo, … } from '@d4y/agent-runtime-nuxt'` without reaching into
-// `runtime/`. The composable itself is auto-imported via addImportsDir.
-export type {
-  UseAgentRuntime,
-  UIMessage,
-  AppInfo,
-  AppAuth,
-  AppEnvField,
-  FileEntry,
-  UiAction,
-  SendOptions,
-  ChatStatus
-} from './runtime/composables/useAgentRuntime'
-export type { AgentRuntimeMarkdownRenderOptions } from './runtime/composables/useAgentRuntimeMarkdown'
-export type { AgentRuntimeFileLike, AgentRuntimeFilePreviewKind } from './runtime/utils/files'
-
-/**
- * Module options for `@d4y/agent-runtime-nuxt`.
- *
- * Every field is optional at config time — unset values fall back to the
- * matching `AGENT_RUNTIME_*` environment variable at runtime, so the same build
- * artifact works across environments without rebuilding.
- */
-export interface ModuleOptions {
-  /**
-   * Base URL of the agent-runtime HTTP server (no trailing slash required).
-   *
-   * Falls back to `process.env.AGENT_RUNTIME_URL` then `http://127.0.0.1:18791`.
-   */
-  baseUrl?: string
-
-  /**
-   * App key used to authenticate against agent-runtime (`X-Agent-Runtime-App-Key` header).
-   *
-   * **Server-only secret.** Never exposed to the browser; the module only
-   * forwards it from the proxy routes it registers.
-   *
-   * Falls back to `process.env.AGENT_RUNTIME_APP_KEY`. Required at runtime — the
-   * module will throw a 500 from any proxy route if missing.
-   */
-  appKey?: string
-
-  /**
-   * App ID to bind every conversation to (must match an app registered in
-   * the agent-runtime `apps/` directory).
-   *
-   * Falls back to `process.env.AGENT_RUNTIME_APP_ID` then `omnisearch`.
-   */
-  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.
-   *
-   * Default: `/api/agent-runtime`.
-   */
-  apiPrefix?: string
-}
-
-/** Public runtime-config shape exposed to the browser (path data only). */
-export interface PublicAgentRuntimeConfig {
-  /** Same value as `apiPrefix` from module options; needed by `useAgentRuntime` to build URLs. */
-  apiPrefix: string
-  /** App ID, used by the composable to scope `localStorage` keys. */
-  appId: string
-}
-
-/** Private runtime-config shape (server-only). */
-export interface PrivateAgentRuntimeConfig {
-  baseUrl: string
-  appKey: string
-  appId: string
-}
-
-declare module '@nuxt/schema' {
-  interface RuntimeConfig {
-    agentRuntime: PrivateAgentRuntimeConfig
-  }
-  interface PublicRuntimeConfig {
-    agentRuntime: PublicAgentRuntimeConfig
-  }
-}
-
-const DEFAULTS: Required<Pick<ModuleOptions, 'baseUrl' | 'appId' | 'apiPrefix'>> = {
-  baseUrl: 'http://127.0.0.1:18791',
-  appId: 'omnisearch',
-  apiPrefix: '/api/agent-runtime'
-}
-
-export default defineNuxtModule<ModuleOptions>({
-  meta: {
-    name: '@d4y/agent-runtime-nuxt',
-    configKey: 'agentRuntime',
-    compatibility: { nuxt: '>=3.13.0' }
-  },
-  defaults: {},
-  setup(userOptions, nuxt) {
-    const resolver = createResolver(import.meta.url)
-
-    const baseUrl = (userOptions.baseUrl ?? process.env.AGENT_RUNTIME_URL ?? DEFAULTS.baseUrl).replace(/\/+$/, '')
-    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(/\/+$/, '')
-
-    nuxt.options.runtimeConfig.agentRuntime = defu(nuxt.options.runtimeConfig.agentRuntime, {
-      baseUrl,
-      appKey,
-      appId
-    })
-
-    nuxt.options.runtimeConfig.public.agentRuntime = defu(nuxt.options.runtimeConfig.public.agentRuntime, {
-      apiPrefix,
-      appId
-    })
-
-    // Composable auto-import — `useAgentRuntime()` is available everywhere.
-    addImportsDir(resolver.resolve('./runtime/composables'))
-
-    // Generate a `.d.ts` shim that re-exports the public types from the
-    // module so IDEs see them without the consumer touching tsconfig paths.
-    addTypeTemplate({
-      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 { AgentRuntimeMarkdownRenderOptions } from '${resolver.resolve('./runtime/composables/useAgentRuntimeMarkdown')}'`,
-        `export type { AgentRuntimeFileLike, AgentRuntimeFilePreviewKind } from '${resolver.resolve('./runtime/utils/files')}'`,
-        ''
-      ].join('\n')
-    })
-
-    // Register every proxy route under the configured prefix.
-    const route = (suffix: string, handler: string, method?: 'get' | 'post' | 'delete') =>
-      addServerHandler({
-        route: `${apiPrefix}${suffix}`,
-        method,
-        handler: resolver.resolve(`./runtime/server/api/${handler}`)
-      })
-
-    route('/app', 'app.get', 'get')
-    route('/conversations', 'conversations.post', 'post')
-    route('/conversations/:id', 'conversations/[id].delete', 'delete')
-    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/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/raw/**', 'conversations/[id]/files/raw/[...path].get', 'get')
-  }
-})

package/src/nitro-globals.d.ts

@@ -1,8 +0,0 @@
-declare const defineEventHandler: typeof import('h3').defineEventHandler
-declare const createError: typeof import('h3').createError
-declare const getRouterParam: typeof import('h3').getRouterParam
-declare const setHeader: typeof import('h3').setHeader
-declare const sendStream: typeof import('h3').sendStream
-declare const readBody: typeof import('h3').readBody
-declare const setResponseStatus: typeof import('h3').setResponseStatus
-declare const useRuntimeConfig: () => any

package/src/runtime/components/AgentRuntimeArtifactPreview.vue

@@ -1,192 +0,0 @@
-<script setup lang="ts">
-import { computed, onBeforeUnmount, ref, watch } from 'vue'
-import { getAgentRuntimeFilePreviewKind, type AgentRuntimeFileLike } from '../utils/files'
-
-const props = withDefaults(defineProps<{
-  file: AgentRuntimeFileLike
-  src?: string | null
-  resolveSrc?: ((relPath: string) => string | null | undefined) | null
-  textMaxChars?: number
-}>(), {
-  src: null,
-  resolveSrc: null,
-  textMaxChars: 120_000,
-})
-
-const kind = computed(() => getAgentRuntimeFilePreviewKind(props.file))
-const resolvedSrc = computed(() => {
-  if (props.src) {
-    return props.src
-  }
-
-  if (!props.file.relPath || !props.resolveSrc) {
-    return null
-  }
-
-  return props.resolveSrc(props.file.relPath) ?? null
-})
-
-const textContent = ref('')
-const textError = ref<string | null>(null)
-const textLoading = ref(false)
-let textAbortController: AbortController | null = 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()}\n\n…`
-        : 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>
-  <div class="agent-runtime-artifact-preview">
-    <img
-      v-if="kind === 'image' && resolvedSrc"
-      :src="resolvedSrc"
-      :alt="file.name ?? file.relPath ?? 'Preview image'"
-      class="agent-runtime-artifact-preview__image">
-
-    <iframe
-      v-else-if="kind === 'pdf' && resolvedSrc"
-      :src="resolvedSrc"
-      :title="file.name ?? file.relPath ?? 'PDF preview'"
-      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>
-
-    <div v-else class="agent-runtime-artifact-preview__fallback">
-      <p class="agent-runtime-artifact-preview__note">
-        Preview unavailable for this file type.
-      </p>
-      <a
-        v-if="resolvedSrc"
-        :href="resolvedSrc"
-        target="_blank"
-        rel="noopener noreferrer"
-        class="agent-runtime-artifact-preview__link">
-        Open file
-      </a>
-    </div>
-  </div>
-</template>
-
-<style scoped>
-.agent-runtime-artifact-preview {
-  display: block;
-  width: 100%;
-  min-height: 12rem;
-}
-
-.agent-runtime-artifact-preview__image,
-.agent-runtime-artifact-preview__frame {
-  display: block;
-  width: 100%;
-  border: 0;
-  border-radius: 0.875rem;
-  background: rgba(15, 23, 42, 0.04);
-}
-
-.agent-runtime-artifact-preview__image {
-  max-height: min(70vh, 48rem);
-  object-fit: contain;
-}
-
-.agent-runtime-artifact-preview__frame {
-  min-height: min(78vh, 52rem);
-}
-
-.agent-runtime-artifact-preview__text-shell,
-.agent-runtime-artifact-preview__fallback {
-  min-height: 18rem;
-  border-radius: 0.875rem;
-  border: 1px solid rgba(15, 23, 42, 0.1);
-  background: rgba(15, 23, 42, 0.03);
-}
-
-.agent-runtime-artifact-preview__text {
-  margin: 0;
-  max-height: min(72vh, 52rem);
-  overflow: auto;
-  padding: 1rem;
-  font-family: ui-monospace, SFMono-Regular, SFMono-Regular, Menlo, Monaco, Consolas, Liberation Mono, Courier New, monospace;
-  font-size: 0.8rem;
-  line-height: 1.55;
-  white-space: pre-wrap;
-  word-break: break-word;
-}
-
-.agent-runtime-artifact-preview__note {
-  padding: 1rem;
-  font-size: 0.875rem;
-  color: rgba(15, 23, 42, 0.72);
-}
-
-.agent-runtime-artifact-preview__note--error {
-  color: rgb(185, 28, 28);
-}
-
-.agent-runtime-artifact-preview__link {
-  display: inline-flex;
-  margin: 0 1rem 1rem;
-  color: inherit;
-  text-decoration: underline;
-  text-underline-offset: 0.18em;
-}
-</style>