veryfront 0.1.297 → 0.1.299

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.297",
+    "version": "0.1.299",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "workspace": [

package/esm/src/agent/agent-service.d.ts

@@ -18,6 +18,16 @@ export interface AgentServiceServerConfig {
     basePath?: string;
     cors?: boolean;
 }
+export interface AgentServiceRoute {
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS";
+    path: string;
+    handler: (request: Request, params: Record<string, string>) => Promise<Response> | Response;
+}
+export interface AgentServiceRuntime<TStartInput = void, TRun = unknown, TEvent = unknown, TTerminalState = unknown> {
+    readonly contract: NormalizedAgentServiceContract<TStartInput, TRun, TEvent, TTerminalState>;
+    fetch(request: Request): Promise<Response>;
+    setShuttingDown(shuttingDown?: boolean): void;
+}
 export type AgentRegistry = Record<string, Agent>;
 export interface AgentServiceContractBase<TStartInput = void, TRun = unknown, TEvent = unknown, TTerminalState = unknown> {
     serviceName: string;
@@ -55,10 +65,17 @@ export interface NormalizedAgentServiceContract<TStartInput = void, TRun = unkno
  */
 export interface AgentServiceDefinition<TStartInput = void, TRun = unknown, TEvent = unknown, TTerminalState = unknown> {
     contract: NormalizedAgentServiceContract<TStartInput, TRun, TEvent, TTerminalState>;
+    createRuntime(options?: {
+        routes?: AgentServiceRoute[];
+    }): AgentServiceRuntime<TStartInput, TRun, TEvent, TTerminalState>;
 }
 /**
- * Reserve the public hosted agent-service signature before the runtime
- * implementation lands.
+ * Define a hosted agent service and expose a policy-neutral runtime shell.
+ *
+ * The first implementation slice owns contract normalization plus standard
+ * health/readiness behavior. Hosts pass product-specific routes explicitly so
+ * auth, observability, durable sinks, and AG-UI execution policy can keep
+ * migrating in smaller additive seams.
  */
 export declare function defineAgentService<TStartInput = void, TRun = unknown, TEvent = unknown, TTerminalState = unknown>(contract: AgentContract<TStartInput, TRun, TEvent, TTerminalState>): AgentServiceDefinition<TStartInput, TRun, TEvent, TTerminalState>;
 //# sourceMappingURL=agent-service.d.ts.map

package/esm/src/agent/agent-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-service.d.ts","sourceRoot":"","sources":["../../../src/src/agent/agent-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-service.d.ts","sourceRoot":"","sources":["../../../src/src/agent/agent-service.ts"],"names":[],"mappings":"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"}

package/esm/src/agent/agent-service.js

@@ -1,4 +1,3 @@
-const DEFINE_AGENT_SERVICE_STUB_ERROR = "defineAgentService() is a Phase 0 stub. The framework contract is reserved, but the hosted runtime implementation has not landed yet.";
 function getSingleAgentDefaultId(contract) {
     return contract.defaultAgentId ?? contract.agent.id ?? "default";
 }
@@ -21,11 +20,82 @@ function normalizeAgentServiceContract(contract) {
         durableRunSink: contract.durableRunSink,
     };
 }
+function normalizePath(path) {
+    if (path === "")
+        return "/";
+    return path.startsWith("/") ? path : `/${path}`;
+}
+function splitPath(path) {
+    const normalized = normalizePath(path);
+    if (normalized === "/")
+        return [];
+    return normalized.split("/").filter(Boolean);
+}
+function matchRoute(route, request) {
+    if (request.method.toUpperCase() !== route.method) {
+        return undefined;
+    }
+    const routeParts = splitPath(route.path);
+    const requestParts = splitPath(new URL(request.url).pathname);
+    if (routeParts.length !== requestParts.length) {
+        return undefined;
+    }
+    const params = {};
+    for (const [index, routePart] of routeParts.entries()) {
+        const requestPart = requestParts[index];
+        if (requestPart === undefined) {
+            return undefined;
+        }
+        if (routePart.startsWith(":")) {
+            params[routePart.slice(1)] = decodeURIComponent(requestPart);
+            continue;
+        }
+        if (routePart !== requestPart) {
+            return undefined;
+        }
+    }
+    return params;
+}
+function createAgentServiceRuntime(contract, options = {}) {
+    let shuttingDown = false;
+    const routes = options.routes ?? [];
+    return {
+        contract,
+        async fetch(request) {
+            const path = new URL(request.url).pathname;
+            if (request.method === "GET" && path === "/readiness") {
+                return shuttingDown ? new Response("Shutting down", { status: 503 }) : new Response("OK");
+            }
+            if (request.method === "GET" && path === "/liveness") {
+                return new Response("OK");
+            }
+            for (const route of routes) {
+                const params = matchRoute(route, request);
+                if (params) {
+                    return await route.handler(request, params);
+                }
+            }
+            return new Response("Not Found", { status: 404 });
+        },
+        setShuttingDown(next = true) {
+            shuttingDown = next;
+        },
+    };
+}
 /**
- * Reserve the public hosted agent-service signature before the runtime
- * implementation lands.
+ * Define a hosted agent service and expose a policy-neutral runtime shell.
+ *
+ * The first implementation slice owns contract normalization plus standard
+ * health/readiness behavior. Hosts pass product-specific routes explicitly so
+ * auth, observability, durable sinks, and AG-UI execution policy can keep
+ * migrating in smaller additive seams.
  */
 export function defineAgentService(contract) {
-    void normalizeAgentServiceContract(contract);
-    throw new Error(DEFINE_AGENT_SERVICE_STUB_ERROR);
+    const normalized = normalizeAgentServiceContract(contract);
+    return {
+        contract: normalized,
+        createRuntime(options) {
+            return createAgentServiceRuntime(normalized, options);
+        },
+    };
 }

package/esm/src/provider/veryfront-cloud/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/src/provider/veryfront-cloud/provider.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQhD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CA2DvE"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/src/provider/veryfront-cloud/provider.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQhD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAiEvE"}

package/esm/src/provider/veryfront-cloud/provider.js

@@ -1,5 +1,5 @@
 import { createError, toError } from "../../errors/veryfront-error.js";
-import { createGoogleModelRuntime } from "../runtime-loader.js";
+import { createAnthropicModelRuntime, createGoogleModelRuntime } from "../runtime-loader.js";
 import { tryResolve } from "../../extensions/contracts.js";
 import { AIProviderRegistryName } from "../../extensions/interfaces/index.js";
 import { createVeryfrontCloudFetch, getVeryfrontCloudGatewayBaseUrl, parseVeryfrontCloudModelId, requireVeryfrontCloudBootstrap, } from "./shared.js";
@@ -21,7 +21,15 @@ export function createVeryfrontCloudModel(modelId) {
                     fetch,
                 });
             }
-            throw new Error("Anthropic provider not installed. Add @veryfront/ext-anthropic to use anthropic/* models via veryfront-cloud.");
+            // Fall back to the built-in runtime-loader when the extension is not
+            // registered.  Keeps Anthropic working until @veryfront/ext-anthropic is
+            // published to npm and adopted by all consumers.
+            return createAnthropicModelRuntime({
+                authToken: apiToken,
+                baseURL,
+                name: "veryfront-cloud",
+                fetch,
+            }, upstreamModelId);
         }
         case "google":
             return createGoogleModelRuntime({

package/esm/src/utils/version-constant.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.297";
+export declare const VERSION = "0.1.299";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.297";
+export const VERSION = "0.1.299";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.297",
+  "version": "0.1.299",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.297",
+  "version": "0.1.299",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "workspace": [

package/src/src/agent/agent-service.ts

@@ -26,6 +26,23 @@ export interface AgentServiceServerConfig {
   cors?: boolean;
 }
 
+export interface AgentServiceRoute {
+  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS";
+  path: string;
+  handler: (request: Request, params: Record<string, string>) => Promise<Response> | Response;
+}
+
+export interface AgentServiceRuntime<
+  TStartInput = void,
+  TRun = unknown,
+  TEvent = unknown,
+  TTerminalState = unknown,
+> {
+  readonly contract: NormalizedAgentServiceContract<TStartInput, TRun, TEvent, TTerminalState>;
+  fetch(request: Request): Promise<Response>;
+  setShuttingDown(shuttingDown?: boolean): void;
+}
+
 export type AgentRegistry = Record<string, Agent>;
 
 export interface AgentServiceContractBase<
@@ -101,11 +118,14 @@ export interface AgentServiceDefinition<
   TTerminalState = unknown,
 > {
   contract: NormalizedAgentServiceContract<TStartInput, TRun, TEvent, TTerminalState>;
+  createRuntime(options?: { routes?: AgentServiceRoute[] }): AgentServiceRuntime<
+    TStartInput,
+    TRun,
+    TEvent,
+    TTerminalState
+  >;
 }
 
-const DEFINE_AGENT_SERVICE_STUB_ERROR =
-  "defineAgentService() is a Phase 0 stub. The framework contract is reserved, but the hosted runtime implementation has not landed yet.";
-
 function getSingleAgentDefaultId(contract: {
   agent: Agent;
   defaultAgentId?: string;
@@ -141,9 +161,96 @@ function normalizeAgentServiceContract<
   };
 }
 
+function normalizePath(path: string): string {
+  if (path === "") return "/";
+  return path.startsWith("/") ? path : `/${path}`;
+}
+
+function splitPath(path: string): string[] {
+  const normalized = normalizePath(path);
+  if (normalized === "/") return [];
+  return normalized.split("/").filter(Boolean);
+}
+
+function matchRoute(
+  route: AgentServiceRoute,
+  request: Request,
+): Record<string, string> | undefined {
+  if (request.method.toUpperCase() !== route.method) {
+    return undefined;
+  }
+
+  const routeParts = splitPath(route.path);
+  const requestParts = splitPath(new URL(request.url).pathname);
+  if (routeParts.length !== requestParts.length) {
+    return undefined;
+  }
+
+  const params: Record<string, string> = {};
+  for (const [index, routePart] of routeParts.entries()) {
+    const requestPart = requestParts[index];
+    if (requestPart === undefined) {
+      return undefined;
+    }
+
+    if (routePart.startsWith(":")) {
+      params[routePart.slice(1)] = decodeURIComponent(requestPart);
+      continue;
+    }
+
+    if (routePart !== requestPart) {
+      return undefined;
+    }
+  }
+
+  return params;
+}
+
+function createAgentServiceRuntime<
+  TStartInput = void,
+  TRun = unknown,
+  TEvent = unknown,
+  TTerminalState = unknown,
+>(
+  contract: NormalizedAgentServiceContract<TStartInput, TRun, TEvent, TTerminalState>,
+  options: { routes?: AgentServiceRoute[] } = {},
+): AgentServiceRuntime<TStartInput, TRun, TEvent, TTerminalState> {
+  let shuttingDown = false;
+  const routes = options.routes ?? [];
+
+  return {
+    contract,
+    async fetch(request) {
+      const path = new URL(request.url).pathname;
+      if (request.method === "GET" && path === "/readiness") {
+        return shuttingDown ? new Response("Shutting down", { status: 503 }) : new Response("OK");
+      }
+      if (request.method === "GET" && path === "/liveness") {
+        return new Response("OK");
+      }
+
+      for (const route of routes) {
+        const params = matchRoute(route, request);
+        if (params) {
+          return await route.handler(request, params);
+        }
+      }
+
+      return new Response("Not Found", { status: 404 });
+    },
+    setShuttingDown(next = true) {
+      shuttingDown = next;
+    },
+  };
+}
+
 /**
- * Reserve the public hosted agent-service signature before the runtime
- * implementation lands.
+ * Define a hosted agent service and expose a policy-neutral runtime shell.
+ *
+ * The first implementation slice owns contract normalization plus standard
+ * health/readiness behavior. Hosts pass product-specific routes explicitly so
+ * auth, observability, durable sinks, and AG-UI execution policy can keep
+ * migrating in smaller additive seams.
  */
 export function defineAgentService<
   TStartInput = void,
@@ -153,6 +260,11 @@ export function defineAgentService<
 >(
   contract: AgentContract<TStartInput, TRun, TEvent, TTerminalState>,
 ): AgentServiceDefinition<TStartInput, TRun, TEvent, TTerminalState> {
-  void normalizeAgentServiceContract(contract);
-  throw new Error(DEFINE_AGENT_SERVICE_STUB_ERROR);
+  const normalized = normalizeAgentServiceContract(contract);
+  return {
+    contract: normalized,
+    createRuntime(options) {
+      return createAgentServiceRuntime(normalized, options);
+    },
+  };
 }

package/src/src/provider/veryfront-cloud/provider.ts

@@ -1,5 +1,5 @@
 import { createError, toError } from "../../errors/veryfront-error.js";
-import { createGoogleModelRuntime } from "../runtime-loader.js";
+import { createAnthropicModelRuntime, createGoogleModelRuntime } from "../runtime-loader.js";
 import { tryResolve } from "../../extensions/contracts.js";
 import type { AIProviderRegistry } from "../../extensions/interfaces/index.js";
 import { AIProviderRegistryName } from "../../extensions/interfaces/index.js";
@@ -30,9 +30,15 @@ export function createVeryfrontCloudModel(modelId: string): ModelRuntime {
           fetch,
         });
       }
-      throw new Error(
-        "Anthropic provider not installed. Add @veryfront/ext-anthropic to use anthropic/* models via veryfront-cloud.",
-      );
+      // Fall back to the built-in runtime-loader when the extension is not
+      // registered.  Keeps Anthropic working until @veryfront/ext-anthropic is
+      // published to npm and adopted by all consumers.
+      return createAnthropicModelRuntime({
+        authToken: apiToken,
+        baseURL,
+        name: "veryfront-cloud",
+        fetch,
+      }, upstreamModelId);
     }
 
     case "google":

package/src/src/utils/version-constant.ts

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.297";
+export const VERSION = "0.1.299";