@firstflow/core 0.0.5

package/dist/index.mjs

@@ -0,0 +1,80 @@
+import {
+  DEFAULT_FIRSTFLOW_BASE_URL,
+  FIRSTFLOW_SERVER_PACKAGE_VERSION,
+  getRuntime,
+  wrapClient
+} from "./chunk-X3T7X4JQ.mjs";
+
+// src/standalone.ts
+function observe(input) {
+  const { firstflowAgentId, sessionId, userId, ...rest } = input;
+  getRuntime().observe({
+    agentId: firstflowAgentId,
+    conversationId: sessionId,
+    userId,
+    ...rest
+  });
+}
+function outcome(input) {
+  getRuntime().outcome({
+    conversationId: input.sessionId,
+    outcome: input.outcome,
+    intent: input.intent,
+    userId: input.userId
+  });
+}
+function feedback(input) {
+  getRuntime().feedback({
+    conversationId: input.sessionId,
+    rating: input.rating,
+    comment: input.comment,
+    messageId: input.messageId,
+    userId: input.userId
+  });
+}
+function track(args) {
+  getRuntime().track(args.firstflowAgentId, args.userId, args.event, args.properties);
+}
+function identify(args) {
+  getRuntime().identify(args.firstflowAgentId, args.userId, args.traits);
+}
+function trace(args) {
+  const { firstflowAgentId, ...input } = args;
+  getRuntime().trace(firstflowAgentId, input);
+}
+
+// src/agents.ts
+async function listAccessibleAgents(opts) {
+  const base = (opts.baseUrl ?? DEFAULT_FIRSTFLOW_BASE_URL).replace(/\/$/, "");
+  const apiKey = opts.apiKey.trim();
+  if (!apiKey) return { agents: [], workspaceId: "", publishableKey: null };
+  const res = await fetch(`${base}/v1/agents/accessible`, {
+    method: "GET",
+    headers: { Authorization: `Bearer ${apiKey}` },
+    cache: "no-store"
+  });
+  if (!res.ok) {
+    const detail = await res.text().catch(() => "");
+    throw new Error(
+      `[Firstflow] listAccessibleAgents: HTTP ${res.status} \u2014 ${detail.slice(0, 200)}`
+    );
+  }
+  const json = await res.json();
+  return {
+    agents: (json.data ?? []).map((a) => ({ id: a.id, name: a.name ?? null })),
+    workspaceId: json.workspaceId ?? "",
+    publishableKey: json.publishableKey ?? null
+  };
+}
+export {
+  DEFAULT_FIRSTFLOW_BASE_URL,
+  FIRSTFLOW_SERVER_PACKAGE_VERSION,
+  feedback,
+  identify,
+  listAccessibleAgents,
+  observe,
+  outcome,
+  trace,
+  track,
+  wrapClient
+};

package/dist/openai.d.mts

@@ -0,0 +1,19 @@
+import RealOpenAI from 'openai';
+
+interface FirstflowRequestFields {
+    /** Agent this call is attributed to (primary routing key). Required to observe. */
+    firstflowAgentId?: string;
+    /** Session / conversation id for this call. Required to observe. */
+    sessionId?: string;
+    /** The end-user this call belongs to. Required to observe. */
+    userId?: string;
+}
+declare module "openai/resources/chat/completions/completions" {
+    interface ChatCompletionCreateParamsBase extends FirstflowRequestFields {
+    }
+}
+
+/** Drop-in `OpenAI` client with Firstflow observability built in. */
+declare const OpenAI: typeof RealOpenAI;
+
+export { OpenAI };

package/dist/openai.d.ts

@@ -0,0 +1,19 @@
+import RealOpenAI from 'openai';
+
+interface FirstflowRequestFields {
+    /** Agent this call is attributed to (primary routing key). Required to observe. */
+    firstflowAgentId?: string;
+    /** Session / conversation id for this call. Required to observe. */
+    sessionId?: string;
+    /** The end-user this call belongs to. Required to observe. */
+    userId?: string;
+}
+declare module "openai/resources/chat/completions/completions" {
+    interface ChatCompletionCreateParamsBase extends FirstflowRequestFields {
+    }
+}
+
+/** Drop-in `OpenAI` client with Firstflow observability built in. */
+declare const OpenAI: typeof RealOpenAI;
+
+export { OpenAI };