risicare 0.2.0 → 0.2.2

package/dist/index.d.cts

@@ -502,14 +502,34 @@ declare function session<TArgs extends unknown[], TReturn>(optionsOrResolver: Se
  *   return await llm.invoke(`Decide action: ${analysis}`);
  * });
  */
-/** Wrap a function in a THINK phase context with auto-span. */
-declare function traceThink<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
-/** Wrap a function in a DECIDE phase context with auto-span. */
-declare function traceDecide<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
-/** Wrap a function in an ACT phase context with auto-span. */
-declare function traceAct<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
-/** Wrap a function in an OBSERVE phase context with auto-span. */
-declare function traceObserve<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+/**
+ * Wrap a function in a THINK phase context with auto-span.
+ *
+ * @example traceThink(async () => { ... })
+ * @example traceThink("analyze-data", async () => { ... })
+ */
+declare function traceThink<TArgs extends unknown[], TReturn>(fnOrName: ((...args: TArgs) => TReturn) | string, maybeFn?: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+/**
+ * Wrap a function in a DECIDE phase context with auto-span.
+ *
+ * @example traceDecide(async () => { ... })
+ * @example traceDecide("choose-action", async () => { ... })
+ */
+declare function traceDecide<TArgs extends unknown[], TReturn>(fnOrName: ((...args: TArgs) => TReturn) | string, maybeFn?: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+/**
+ * Wrap a function in an ACT phase context with auto-span.
+ *
+ * @example traceAct(async () => { ... })
+ * @example traceAct("execute-tool", async () => { ... })
+ */
+declare function traceAct<TArgs extends unknown[], TReturn>(fnOrName: ((...args: TArgs) => TReturn) | string, maybeFn?: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+/**
+ * Wrap a function in an OBSERVE phase context with auto-span.
+ *
+ * @example traceObserve(async () => { ... })
+ * @example traceObserve("check-result", async () => { ... })
+ */
+declare function traceObserve<TArgs extends unknown[], TReturn>(fnOrName: ((...args: TArgs) => TReturn) | string, maybeFn?: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
 
 /**
  * Phase context — cognitive phase tracking (THINK/DECIDE/ACT/OBSERVE).

package/dist/index.d.ts

@@ -502,14 +502,34 @@ declare function session<TArgs extends unknown[], TReturn>(optionsOrResolver: Se
  *   return await llm.invoke(`Decide action: ${analysis}`);
  * });
  */
-/** Wrap a function in a THINK phase context with auto-span. */
-declare function traceThink<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
-/** Wrap a function in a DECIDE phase context with auto-span. */
-declare function traceDecide<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
-/** Wrap a function in an ACT phase context with auto-span. */
-declare function traceAct<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
-/** Wrap a function in an OBSERVE phase context with auto-span. */
-declare function traceObserve<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+/**
+ * Wrap a function in a THINK phase context with auto-span.
+ *
+ * @example traceThink(async () => { ... })
+ * @example traceThink("analyze-data", async () => { ... })
+ */
+declare function traceThink<TArgs extends unknown[], TReturn>(fnOrName: ((...args: TArgs) => TReturn) | string, maybeFn?: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+/**
+ * Wrap a function in a DECIDE phase context with auto-span.
+ *
+ * @example traceDecide(async () => { ... })
+ * @example traceDecide("choose-action", async () => { ... })
+ */
+declare function traceDecide<TArgs extends unknown[], TReturn>(fnOrName: ((...args: TArgs) => TReturn) | string, maybeFn?: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+/**
+ * Wrap a function in an ACT phase context with auto-span.
+ *
+ * @example traceAct(async () => { ... })
+ * @example traceAct("execute-tool", async () => { ... })
+ */
+declare function traceAct<TArgs extends unknown[], TReturn>(fnOrName: ((...args: TArgs) => TReturn) | string, maybeFn?: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+/**
+ * Wrap a function in an OBSERVE phase context with auto-span.
+ *
+ * @example traceObserve(async () => { ... })
+ * @example traceObserve("check-result", async () => { ... })
+ */
+declare function traceObserve<TArgs extends unknown[], TReturn>(fnOrName: ((...args: TArgs) => TReturn) | string, maybeFn?: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
 
 /**
  * Phase context — cognitive phase tracking (THINK/DECIDE/ACT/OBSERVE).

package/dist/index.js

@@ -1179,28 +1179,36 @@ function withPhase(phase, fn) {
 }
 
 // src/decorators/phase.ts
-function phaseWrapper(phase, kind, fn) {
+function phaseWrapper(phase, kind, name, fn) {
   return (...args) => {
     const tracer = getTracer2();
     if (!tracer) {
       return fn(...args);
     }
     return withPhase(phase, () => {
-      return tracer.startSpan({ name: `phase:${phase}`, kind }, () => fn(...args));
+      return tracer.startSpan({ name, kind }, () => fn(...args));
     });
   };
 }
-function traceThink(fn) {
-  return phaseWrapper("think" /* THINK */, "think" /* THINK */, fn);
-}
-function traceDecide(fn) {
-  return phaseWrapper("decide" /* DECIDE */, "decide" /* DECIDE */, fn);
-}
-function traceAct(fn) {
-  return phaseWrapper("act" /* ACT */, "tool_call" /* TOOL_CALL */, fn);
-}
-function traceObserve(fn) {
-  return phaseWrapper("observe" /* OBSERVE */, "observe" /* OBSERVE */, fn);
+function traceThink(fnOrName, maybeFn) {
+  const name = typeof fnOrName === "string" ? fnOrName : `phase:think`;
+  const fn = typeof fnOrName === "function" ? fnOrName : maybeFn;
+  return phaseWrapper("think" /* THINK */, "think" /* THINK */, name, fn);
+}
+function traceDecide(fnOrName, maybeFn) {
+  const name = typeof fnOrName === "string" ? fnOrName : `phase:decide`;
+  const fn = typeof fnOrName === "function" ? fnOrName : maybeFn;
+  return phaseWrapper("decide" /* DECIDE */, "decide" /* DECIDE */, name, fn);
+}
+function traceAct(fnOrName, maybeFn) {
+  const name = typeof fnOrName === "string" ? fnOrName : `phase:act`;
+  const fn = typeof fnOrName === "function" ? fnOrName : maybeFn;
+  return phaseWrapper("act" /* ACT */, "tool_call" /* TOOL_CALL */, name, fn);
+}
+function traceObserve(fnOrName, maybeFn) {
+  const name = typeof fnOrName === "string" ? fnOrName : `phase:observe`;
+  const fn = typeof fnOrName === "function" ? fnOrName : maybeFn;
+  return phaseWrapper("observe" /* OBSERVE */, "observe" /* OBSERVE */, name, fn);
 }
 
 // src/decorators/multi-agent.ts