@qloo/qloo-harness 0.1.18

package/dist/guided-journey.js

@@ -0,0 +1,223 @@
+import { createRequire as __qlooCreateRequire } from "node:module";
+const require = __qlooCreateRequire(import.meta.url);
+
+// apps/qloo-harness/dist/guided-journey.js
+var QLOO_GUIDED_GOALS = [
+  {
+    id: "ask",
+    label: "Ask Qloo a question",
+    description: "Recommendations, comparisons, trends, places, and cultural context",
+    profile: "explore",
+    starters: [
+      {
+        label: "Find recommendations for an audience",
+        prompt: "Recommend five [things] for [audience] who like [interests], in [place]. Explain how you interpreted my request."
+      },
+      {
+        label: "Compare two tastes",
+        prompt: "Compare the audiences and taste affinities around [first entity] and [second entity]. Explain the strongest differences."
+      },
+      {
+        label: "Explore what is trending",
+        prompt: "What is trending for [category] in [place] during [date range], and what does the result support?"
+      }
+    ]
+  },
+  {
+    id: "audience",
+    label: "Explore an audience or idea",
+    description: "Turn everyday language into Qloo entities, tags, and useful audience signals",
+    profile: "explore",
+    starters: [
+      {
+        label: "Understand an audience",
+        prompt: "Help me understand people in [place] who like [entities or ideas]. Resolve the concepts through Qloo, ask only about choices that would materially change the answer, and summarize the resulting taste profile."
+      },
+      {
+        label: "Ground an aesthetic or concept",
+        prompt: "Show me how Qloo represents the idea \u201C[concept or aesthetic]\u201D. Explain meaningful candidate differences before asking me to choose."
+      },
+      {
+        label: "Find related brands or experiences",
+        prompt: "Find [brands, places, artists, or experiences] associated with people who like [entities, tags, or aesthetics]."
+      }
+    ]
+  },
+  {
+    id: "integrate",
+    label: "Integrate Qloo into my product",
+    description: "Map Qloo inputs and results onto the project in this directory",
+    profile: "plan",
+    starters: [
+      {
+        label: "Design an integration",
+        prompt: "Inspect this project's bounded integration context and design a Qloo integration for [product behavior]. Map our domain fields to Qloo signals and filters, map Qloo results back to our data model, and include auth, errors, retries, pagination, and focused tests."
+      },
+      {
+        label: "Translate an existing use case",
+        prompt: "I currently need to [describe use case]. Inspect this project and show exactly where Qloo fits, including a field-by-field request and response mapping and the safest implementation boundary."
+      },
+      {
+        label: "Review an existing integration",
+        prompt: "Inspect this project's Qloo integration and identify contract, normalization, error-handling, privacy, and test gaps. Start with a read-only assessment."
+      }
+    ]
+  },
+  {
+    id: "diagnose",
+    label: "Diagnose my Qloo setup",
+    description: "Check credentials, endpoint trust, resolution, and network reachability",
+    starters: []
+  },
+  {
+    id: "blank",
+    label: "Start with a blank prompt",
+    description: "Keep the current profile and write your own request",
+    starters: []
+  }
+];
+function clipGuidedLine(text, width) {
+  const characters = [...text];
+  if (characters.length <= width)
+    return text;
+  if (width === 1)
+    return "\u2026";
+  return `${characters.slice(0, width - 1).join("")}\u2026`;
+}
+function qlooStarterIdeaLines(availableWidth) {
+  const width = Math.max(1, Math.floor(availableWidth));
+  const detailed = width >= 96;
+  const goals = QLOO_GUIDED_GOALS.filter(({ id }) => id !== "blank");
+  const title = width >= 42 ? "Start typing, or try one of these:" : "Start typing \u2014 ideas:";
+  const footer = width >= 54 ? "Type anything now \xB7 /start opens guided, editable prompts" : "Type anything \xB7 /start for guided prompts";
+  return [
+    title,
+    ...goals.map((goal) => detailed ? `  \u2022 ${goal.label} \u2014 ${goal.description}` : `  \u2022 ${goal.label}`),
+    footer
+  ].map((line) => clipGuidedLine(line, width));
+}
+var COMMON_SUCCESS_ACTIONS = [
+  {
+    id: "explain",
+    label: "Explain what this result means (and does not mean)",
+    kind: "prompt",
+    value: "Explain the latest Qloo result in plain language. Separate what the data supports from assumptions, and call out important limitations."
+  },
+  {
+    id: "refine",
+    label: "Refine the question or audience",
+    kind: "prompt",
+    value: "Help me refine the latest Qloo question. Suggest the two or three changes most likely to produce a meaningfully different result, without asking me for API parameter names."
+  },
+  {
+    id: "request",
+    label: "Inspect the underlying Qloo request",
+    kind: "command",
+    value: "request"
+  },
+  {
+    id: "integrate",
+    label: "Turn this into an integration plan",
+    kind: "prompt",
+    profile: "plan",
+    value: "Turn the latest Qloo workflow into a project-grounded integration plan. Map application inputs to Qloo signals and filters, and map normalized Qloo results back to the application data model."
+  }
+];
+function operationPrompt(operation) {
+  switch (operation) {
+    case "recommend":
+    case "rank":
+      return {
+        id: "compare",
+        label: "Compare with another audience or signal",
+        kind: "prompt",
+        value: "Run a useful comparison against the latest result by changing one material audience or taste signal. Ask me which signal if the choice is not clear."
+      };
+    case "compare":
+    case "compare_audiences":
+      return {
+        id: "deepen-compare",
+        label: "Explore the strongest difference",
+        kind: "prompt",
+        value: "Take the strongest meaningful difference in the latest comparison and explore it further with the narrowest relevant Qloo workflow."
+      };
+    case "trends":
+      return {
+        id: "trend-window",
+        label: "Try another place or time window",
+        kind: "prompt",
+        value: "Help me rerun the latest trend question for a useful comparison place or time window. Ask for the one missing choice in everyday language."
+      };
+    case "where_popular":
+      return {
+        id: "location-detail",
+        label: "Explore another location",
+        kind: "prompt",
+        value: "Compare where the latest entity is popular with another location. Ask me for the comparison location if needed."
+      };
+    case "describe":
+    case "entity_tags":
+    case "find_tags":
+      return {
+        id: "use-signal",
+        label: "Use this as a taste signal",
+        kind: "prompt",
+        value: "Use the latest resolved Qloo entity or tag as a taste signal in a concrete recommendation. Ask me what kind of output and location I want if those are missing."
+      };
+    case "audience_demographics":
+      return {
+        id: "audience-recommendation",
+        label: "Use this audience in a recommendation",
+        kind: "prompt",
+        value: "Use the latest audience understanding to run a relevant Qloo recommendation. Ask me for the output category if it is not already clear."
+      };
+    default:
+      return void 0;
+  }
+}
+function qlooNextActions(workflow) {
+  const status = workflow.status;
+  if (status === "error" || status === "needs_input") {
+    return [
+      {
+        id: "why",
+        label: "See how Qloo interpreted the request",
+        kind: "command",
+        value: "why"
+      },
+      {
+        id: "doctor",
+        label: "Diagnose credentials and connectivity",
+        kind: "command",
+        value: "doctor network"
+      },
+      {
+        id: "retry",
+        label: "Retry the exact Qloo workflow once",
+        kind: "command",
+        value: "retry"
+      },
+      {
+        id: "rephrase",
+        label: "Rephrase the request in plain language",
+        kind: "prompt",
+        value: "Help me rephrase the latest request using everyday language. Preserve my goal while resolving only the ambiguity or missing information that blocked it."
+      }
+    ];
+  }
+  const specific = operationPrompt(workflow.operation);
+  return specific ? [specific, ...COMMON_SUCCESS_ACTIONS] : [...COMMON_SUCCESS_ACTIONS];
+}
+function findGuidedGoal(label) {
+  return QLOO_GUIDED_GOALS.find((goal) => `${goal.label} \u2014 ${goal.description}` === label);
+}
+function guidedGoalLabel(goal) {
+  return `${goal.label} \u2014 ${goal.description}`;
+}
+export {
+  QLOO_GUIDED_GOALS,
+  findGuidedGoal,
+  guidedGoalLabel,
+  qlooNextActions,
+  qlooStarterIdeaLines
+};