Integrate OpenHandoff factory workspace (#212)

factory/packages/backend/src/actors/logging.ts

@@ -0,0 +1,31 @@
+export function resolveErrorMessage(error: unknown): string {
+  if (error instanceof Error) {
+    return error.message;
+  }
+  return String(error);
+}
+
+export function isActorNotFoundError(error: unknown): boolean {
+  return resolveErrorMessage(error).includes("Actor not found:");
+}
+
+export function resolveErrorStack(error: unknown): string | undefined {
+  if (error instanceof Error && typeof error.stack === "string") {
+    return error.stack;
+  }
+  return undefined;
+}
+
+export function logActorWarning(
+  scope: string,
+  message: string,
+  context?: Record<string, unknown>
+): void {
+  const payload = {
+    scope,
+    message,
+    ...(context ?? {})
+  };
+  // eslint-disable-next-line no-console
+  console.warn("[openhandoff][actor:warn]", payload);
+}