@d4y/agent-runtime-nuxt 0.1.0 → 0.1.2

package/dist/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": ">=3.13.0"
   },
-  "version": "0.1.0",
+  "version": "0.1.2",
   "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/api/app.get.d.ts

@@ -1,6 +1,15 @@
+interface AppEnvField {
+    required?: boolean;
+    secret?: boolean;
+    description?: string;
+}
 /**
  * GET `${apiPrefix}/app` — returns the manifest of the configured app
  * (so the client can render its env-schema form generically).
  */
-declare const _default: any;
+declare const _default: import("h3").EventHandler<import("h3").EventHandlerRequest, Promise<{
+    appId: string;
+    name: string;
+    envSchema: Record<string, AppEnvField>;
+}>>;
 export default _default;

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

@@ -1,3 +1,4 @@
+import { createError, defineEventHandler } from "h3";
 import { agentRuntime, agentRuntimeHeaders } from "../utils/agent-runtime.js";
 export default defineEventHandler(async () => {
   const cfg = agentRuntime();

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

@@ -2,5 +2,5 @@
  * POST `${apiPrefix}/conversations/:id/abort` — cancels the in-flight
  * agent run for this conversation. Returns 204 on success.
  */
-declare const _default: any;
+declare const _default: import("h3").EventHandler<import("h3").EventHandlerRequest, Promise<null>>;
 export default _default;

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

@@ -1,3 +1,4 @@
+import { createError, defineEventHandler, getRouterParam, setResponseStatus } from "h3";
 import { agentRuntime, agentRuntimeHeaders } from "../../../utils/agent-runtime.js";
 export default defineEventHandler(async (event) => {
   const cfg = agentRuntime();

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

@@ -6,5 +6,5 @@
  * Triggers any `bootstrap[]` step on the harness side whose `rerunOn` keys
  * intersect the changed set, so this is also how you re-import auth.
  */
-declare const _default: any;
+declare const _default: import("h3").EventHandler<import("h3").EventHandlerRequest, Promise<any>>;
 export default _default;

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

@@ -1,3 +1,4 @@
+import { createError, defineEventHandler, getRouterParam, readBody } from "h3";
 import { agentRuntime, agentRuntimeHeaders } from "../../../utils/agent-runtime.js";
 export default defineEventHandler(async (event) => {
   const cfg = agentRuntime();

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

@@ -7,5 +7,5 @@
  * forwarded verbatim — re-encoding after Nitro's decoding step is fragile
  * for filenames containing spaces or unicode.
  */
-declare const _default: any;
+declare const _default: import("h3").EventHandler<import("h3").EventHandlerRequest, Promise<void>>;
 export default _default;

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

@@ -1,4 +1,6 @@
 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"];
 export default defineEventHandler(async (event) => {

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

@@ -10,5 +10,7 @@ export interface FileEntry {
  * GET `${apiPrefix}/conversations/:id/files` — lists the workspace files
  * the agent has produced (or read in) so the UI can show a side panel.
  */
-declare const _default: any;
+declare const _default: import("h3").EventHandler<import("h3").EventHandlerRequest, Promise<{
+    items: FileEntry[];
+}>>;
 export default _default;

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

@@ -1,3 +1,4 @@
+import { createError, defineEventHandler, getRouterParam } from "h3";
 import { agentRuntime } from "../../../utils/agent-runtime.js";
 export default defineEventHandler(async (event) => {
   const cfg = agentRuntime();

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

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

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

@@ -1,3 +1,4 @@
+import { createError, defineEventHandler, getRouterParam } from "h3";
 import { agentRuntime } from "../../../utils/agent-runtime.js";
 export default defineEventHandler(async (event) => {
   const cfg = agentRuntime();

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

@@ -3,5 +3,5 @@
  * The optional `context` field is forwarded verbatim to agent-runtime, where
  * the agent picks it up as per-turn dynamic context.
  */
-declare const _default: any;
+declare const _default: import("h3").EventHandler<import("h3").EventHandlerRequest, Promise<any>>;
 export default _default;

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

@@ -1,3 +1,4 @@
+import { createError, defineEventHandler, getRouterParam, readBody } from "h3";
 import { agentRuntime, agentRuntimeHeaders } from "../../../utils/agent-runtime.js";
 export default defineEventHandler(async (event) => {
   const cfg = agentRuntime();

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

@@ -5,5 +5,5 @@
  * Closing the client connection aborts the upstream fetch so we don't leave
  * orphaned conversations hanging.
  */
-declare const _default: any;
+declare const _default: import("h3").EventHandler<import("h3").EventHandlerRequest, Promise<void>>;
 export default _default;

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

@@ -1,4 +1,5 @@
 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();

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

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

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

@@ -1,3 +1,4 @@
+import { createError, defineEventHandler, getRouterParam, setResponseStatus } from "h3";
 import { agentRuntime } from "../../utils/agent-runtime.js";
 export default defineEventHandler(async (event) => {
   const cfg = agentRuntime();

package/dist/runtime/server/api/conversations.post.d.ts

@@ -3,5 +3,5 @@
  * configured app, optionally seeded with an `env` map (which the harness
  * uses to populate the workspace environment) and a model override.
  */
-declare const _default: any;
+declare const _default: import("h3").EventHandler<import("h3").EventHandlerRequest, Promise<any>>;
 export default _default;

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

@@ -1,3 +1,4 @@
+import { createError, defineEventHandler, readBody } from "h3";
 import { agentRuntime, agentRuntimeHeaders } from "../utils/agent-runtime.js";
 export default defineEventHandler(async (event) => {
   const cfg = agentRuntime();

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,6 @@
-import { createAgentRuntimeRequestHeaders, resolveAgentRuntimeConfig } from "../../../shared";
+import { useRuntimeConfig } from "#imports";
+import { createError } from "h3";
+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.2",
   "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",
@@ -49,13 +60,13 @@
     "@nuxt/kit": "^4.4.2",
     "ai": "^6.0.168",
     "defu": "^6.1.4",
+    "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",
-    "h3": "^1.15.11",
     "nuxt": "^4.4.2",
     "typescript": "^6.0.2",
     "vue": "^3.5.32",

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