@taskforcehq/taskforce 0.3.324 → 0.3.327

package/dist/TaskforceCore.d.ts

@@ -3,6 +3,7 @@ import type { TaskforceConfig } from './types';
 export interface TaskforceProps {
     config?: Partial<TaskforceConfig>;
     initialTaskId?: string;
+    initialActivityEntryId?: string;
     onTaskCountChange?: (count: number) => void;
     onHeaderMouseDown?: (e: React.MouseEvent) => void;
     isDragging?: boolean;

package/dist/TaskforceCore.js

@@ -10,12 +10,13 @@ import authStyles from './components/views/AuthShell.module.css';
 import { t } from './localization';
 import { resolveWorkspaceLifecycleState } from './utils/workspaceLifecycle';
 import { listBuiltInTaxonomyLibraryPacks } from './shared/taxonomyLibrary.js';
-import logoLight from './assets/branding/logos/logo_light.svg';
-import logoDark from './assets/branding/logos/logo_dark.svg';
+import logoLight from './assets/branding/logos/logo_light_no_bg.svg';
+import logoDark from './assets/branding/logos/logo_dark_no_bg.svg';
 import taskforceBg from './assets/images/taskforce.png';
 import { isLightThemeFamily } from './utils/theme';
 import { Cloud, LaptopMinimal } from 'lucide-react';
 import { getPasswordPolicyGuidance, validatePasswordPolicy } from './shared/passwordPolicy';
+import { TASK_DEEP_LINK_QUERY_KEYS } from './shared/taskDeepLinks';
 function isDebugModeEnabled() {
     const runtimeOverride = globalThis.__DEBUG_MODE__;
     if (typeof runtimeOverride === 'boolean')
@@ -45,9 +46,28 @@ function buildPlansPath(params = {}) {
     }
     return `/?${query.toString()}`;
 }
-function TaskforceCoreWithRouter({ config = {}, initialTaskId, onTaskCountChange, onHeaderMouseDown, isDragging, onClose, mode = 'standalone' }) {
+function appendValidatedNextTarget(path, target) {
+    const normalizedTarget = String(target || '').trim();
+    if (!normalizedTarget.startsWith('/') || normalizedTarget === '/')
+        return path;
+    try {
+        const parsed = new URL(path, 'https://taskforce.local');
+        parsed.searchParams.set('next', normalizedTarget);
+        return `${parsed.pathname}${parsed.search}${parsed.hash}`;
+    }
+    catch {
+        return path;
+    }
+}
+function TaskforceCoreWithRouter({ config = {}, initialTaskId, initialActivityEntryId, onTaskCountChange, onHeaderMouseDown, isDragging, onClose, mode = 'standalone' }) {
     const location = useLocation();
     const routeQuery = useMemo(() => new URLSearchParams(location.search), [location.search]);
+    const requestedWorkspaceId = String(routeQuery.get(TASK_DEEP_LINK_QUERY_KEYS.workspaceId) || '').trim() || undefined;
+    const requestedTaskId = String(initialTaskId || routeQuery.get(TASK_DEEP_LINK_QUERY_KEYS.task) || '').trim() || undefined;
+    const requestedActivityEntryId = String(initialActivityEntryId
+        || routeQuery.get(TASK_DEEP_LINK_QUERY_KEYS.activity)
+        || routeQuery.get(TASK_DEEP_LINK_QUERY_KEYS.comment)
+        || '').trim() || undefined;
     const selectedSignupPlanId = String(routeQuery.get('planId') || '').trim();
     const selectedSignupPlanVersionId = String(routeQuery.get('planVersionId') || '').trim();
     const selectedSignupInterval = String(routeQuery.get('interval') || '').trim();
@@ -110,7 +130,9 @@ function TaskforceCoreWithRouter({ config = {}, initialTaskId, onTaskCountChange
     // Initialize the hook
     const taskforceState = useTaskforce({
         config,
-        initialTaskId,
+        initialTaskId: requestedTaskId,
+        initialActivityEntryId: requestedActivityEntryId,
+        requestedWorkspaceId,
         onTaskCountChange,
         onClose
     });
@@ -630,9 +652,14 @@ function TaskforceCoreWithRouter({ config = {}, initialTaskId, onTaskCountChange
             return false;
         }
     }, [nextPath]);
-    const resolveWorkspaceSetupPath = useCallback(() => (shouldReturnToCloudWorkspaceSelection
-        ? cloudWorkspaceSelectionPath
-        : '/setup?step=workspace'), [shouldReturnToCloudWorkspaceSelection]);
+    const resolveWorkspaceSetupPath = useCallback((returnTarget = nextTarget) => {
+        const setupPath = shouldReturnToCloudWorkspaceSelection
+            ? cloudWorkspaceSelectionPath
+            : '/setup?step=workspace';
+        return shouldReturnToCloudWorkspaceSelection
+            ? setupPath
+            : appendValidatedNextTarget(setupPath, returnTarget);
+    }, [nextTarget, shouldReturnToCloudWorkspaceSelection]);
     const resolvedSignupInterval = selectedSignupInterval === 'year' ? 'year' : 'month';
     const hasCommercialOnboardingGate = useCallback((input) => {
         return Boolean(input?.planSelectionRequired
@@ -642,16 +669,16 @@ function TaskforceCoreWithRouter({ config = {}, initialTaskId, onTaskCountChange
     }, []);
     const resolvePostRegistrationPath = useCallback((input) => {
         if (input?.planSelectionRequired || input?.commercialState === 'pending_plan_selection') {
-            return planSelectionPath;
+            return appendValidatedNextTarget(planSelectionPath, nextTarget);
         }
         if (input?.checkoutPending || input?.commercialState === 'checkout_pending') {
-            return buildPlansPath({
+            return appendValidatedNextTarget(buildPlansPath({
                 gate: 'checkout_pending',
                 checkout: selectedSignupPlanVersionId ? 'start' : null,
                 planId: selectedSignupPlanId || null,
                 planVersionId: selectedSignupPlanVersionId || null,
                 interval: selectedSignupPlanVersionId ? resolvedSignupInterval : null
-            });
+            }), nextTarget);
         }
         return nextTarget;
     }, [
@@ -910,6 +937,8 @@ function TaskforceCoreWithRouter({ config = {}, initialTaskId, onTaskCountChange
         if (isLoginRoute && loginBusy) {
             return;
         }
+        const currentRoute = `${location.pathname}${location.search}${location.hash || ''}`;
+        const setupReturnTarget = isSetupRoute ? nextTarget : currentRoute;
         const shouldBypassWorkspacePendingForAccessGate = runtimeMode === 'cloud'
             && isAuthenticated
             && accountAccessGateResolved
@@ -977,7 +1006,7 @@ function TaskforceCoreWithRouter({ config = {}, initialTaskId, onTaskCountChange
         if (shouldForceAccountAccessGate) {
             if (!isPlansScreen) {
                 const gate = encodeURIComponent(String(accountAccessGate?.gate || 'plan_selection_required'));
-                navigate(`/?screen=plans&gate=${gate}`, { replace: true });
+                navigate(appendValidatedNextTarget(`/?screen=plans&gate=${gate}`, currentRoute), { replace: true });
             }
             return;
         }
@@ -1003,29 +1032,29 @@ function TaskforceCoreWithRouter({ config = {}, initialTaskId, onTaskCountChange
         if (setupGateActive) {
             if (hasSetupReadError) {
                 if (!isSetupRoute || setupStep !== 'error') {
-                    navigate('/setup?step=error', { replace: true });
+                    navigate(appendValidatedNextTarget('/setup?step=error', setupReturnTarget), { replace: true });
                 }
                 return;
             }
             if (needsGlobalSetup) {
                 if (!isSetupRoute || setupStep !== 'global') {
-                    navigate('/setup?step=global', { replace: true });
+                    navigate(appendValidatedNextTarget('/setup?step=global', setupReturnTarget), { replace: true });
                 }
                 return;
             }
             if (needsWorkspaceSetup) {
                 if (!isSetupRoute || setupStep !== 'workspace') {
-                    navigate(resolveWorkspaceSetupPath(), { replace: true });
+                    navigate(resolveWorkspaceSetupPath(setupReturnTarget), { replace: true });
                 }
                 return;
             }
             if (isSetupRoute) {
-                navigate('/', { replace: true });
+                navigateToPostAuthTarget(nextTarget, { replace: true });
             }
             return;
         }
         if (isSetupRoute && setupState && !isCreateWorkspaceIntent) {
-            navigate('/', { replace: true });
+            navigateToPostAuthTarget(nextTarget, { replace: true });
         }
     }, [
         mode,
@@ -1061,7 +1090,9 @@ function TaskforceCoreWithRouter({ config = {}, initialTaskId, onTaskCountChange
         location.search,
         location.hash,
         navigate,
+        navigateToPostAuthTarget,
         nextPath,
+        nextTarget,
         pendingPostAuthRedirect,
         cloudWorkspaceSelectionPath
     ]);
@@ -1076,9 +1107,21 @@ function TaskforceCoreWithRouter({ config = {}, initialTaskId, onTaskCountChange
             return;
         const workspaceId = String(currentWorkspaceId || '').trim().toLowerCase();
         if (!workspaceId || workspaceId === 'default') {
-            navigate('/setup?step=workspace', { replace: true });
+            const currentRoute = `${location.pathname}${location.search}${location.hash || ''}`;
+            navigate(appendValidatedNextTarget('/setup?step=workspace', currentRoute), { replace: true });
         }
-    }, [mode, runtimeMode, bootstrapState.config.loaded, isLoginRoute, isSetupRoute, currentWorkspaceId, navigate]);
+    }, [
+        mode,
+        runtimeMode,
+        bootstrapState.config.loaded,
+        isLoginRoute,
+        isSetupRoute,
+        currentWorkspaceId,
+        location.hash,
+        location.pathname,
+        location.search,
+        navigate
+    ]);
     const handleRetryBootstrap = useCallback(async () => {
         setBootstrapRetryBusy(true);
         try {
@@ -1094,7 +1137,7 @@ function TaskforceCoreWithRouter({ config = {}, initialTaskId, onTaskCountChange
     }, [logout, navigate]);
     // Standalone-first: widget remains opt-in only.
     if (mode === 'widget') {
-        return (_jsx(WidgetView, { ...taskforceState, onHeaderMouseDown: onHeaderMouseDown, isDragging: isDragging, onClose: onClose }));
+        return (_jsx(WidgetView, { ...taskforceState, initialActivityEntryId: requestedActivityEntryId, onHeaderMouseDown: onHeaderMouseDown, isDragging: isDragging, onClose: onClose }));
     }
     if (isPricingRoute) {
         const params = new URLSearchParams(location.search);
@@ -1380,7 +1423,7 @@ function TaskforceCoreWithRouter({ config = {}, initialTaskId, onTaskCountChange
                                                     ? 'Reset Password'
                                                     : (inviteResolution === 'existing_user_signed_out'
                                                         ? 'Sign In to Continue'
-                                                        : (invitePasswordRequired ? 'Create Account and Join' : 'Join Workspace'))) }) }), (authMode === 'login' || authMode === 'register') && availableAuthProviders.length > 0 && (_jsxs("div", { className: authStyles.oauthProviders, children: [_jsx("div", { className: authStyles.oauthDivider, children: _jsx("span", { children: "or continue with" }) }), _jsxs("div", { className: authStyles.oauthButtons, children: [availableAuthProviders.includes('google') && (_jsx("button", { type: "button", className: authStyles.oauthButton, disabled: loginBusy, onClick: () => beginOAuthLogin('google', location.pathname !== '/login' ? location.pathname : '/'), "aria-label": "Continue with Google", children: "Google" })), availableAuthProviders.includes('github') && (_jsx("button", { type: "button", className: authStyles.oauthButton, disabled: loginBusy, onClick: () => beginOAuthLogin('github', location.pathname !== '/login' ? location.pathname : '/'), "aria-label": "Continue with GitHub", children: "GitHub" })), availableAuthProviders.includes('apple') && (_jsx("button", { type: "button", className: authStyles.oauthButton, disabled: loginBusy, onClick: () => beginOAuthLogin('apple', location.pathname !== '/login' ? location.pathname : '/'), "aria-label": "Continue with Apple", children: "Apple" }))] })] })), authMode === 'invite' && inviteResolution === 'new_user' && inviteOAuthProviders.length > 0 && (_jsxs("div", { className: authStyles.oauthProviders, children: [_jsx("div", { className: authStyles.oauthDivider, children: _jsx("span", { children: "or join with" }) }), _jsxs("div", { className: authStyles.oauthButtons, children: [inviteOAuthProviders.includes('google') && (_jsx("button", { type: "button", className: authStyles.oauthButton, disabled: loginBusy, onClick: () => beginOAuthLogin('google', '/', inviteToken), "aria-label": "Join with Google", children: "Google" })), inviteOAuthProviders.includes('github') && (_jsx("button", { type: "button", className: authStyles.oauthButton, disabled: loginBusy, onClick: () => beginOAuthLogin('github', '/', inviteToken), "aria-label": "Join with GitHub", children: "GitHub" })), inviteOAuthProviders.includes('apple') && (_jsx("button", { type: "button", className: authStyles.oauthButton, disabled: loginBusy, onClick: () => beginOAuthLogin('apple', '/', inviteToken), "aria-label": "Join with Apple", children: "Apple" }))] })] })), authMode === 'register' && (_jsxs("p", { className: authStyles.registerConsent, children: ["By creating an account, you agree to the", ' ', _jsx("a", { className: authStyles.registerConsentLink, href: "https://taskforcehq.ai/legal/terms/", target: "_blank", rel: "noopener noreferrer", children: "Terms of Service" }), ' ', "and acknowledge the", ' ', _jsx("a", { className: authStyles.registerConsentLink, href: "https://taskforcehq.ai/legal/privacy/", target: "_blank", rel: "noopener noreferrer", children: "Privacy Policy" }), "."] })), _jsxs("div", { className: authStyles.authSecondaryActions, role: "group", "aria-label": "Authentication navigation", children: [directRegistrationEnabled && (authMode === 'login' || authMode === 'register') && (_jsxs("p", { className: authStyles.authModeSwitch, children: [authMode === 'login' ? 'Need an account?' : 'Already have an account?', ' ', _jsx("button", { className: authStyles.authModeSwitchLink, disabled: loginBusy, "data-testid": "auth-switch-mode-button", onClick: () => {
+                                                        : (invitePasswordRequired ? 'Create Account and Join' : 'Join Workspace'))) }) }), (authMode === 'login' || authMode === 'register') && availableAuthProviders.length > 0 && (_jsxs("div", { className: authStyles.oauthProviders, children: [_jsx("div", { className: authStyles.oauthDivider, children: _jsx("span", { children: "or continue with" }) }), _jsxs("div", { className: authStyles.oauthButtons, children: [availableAuthProviders.includes('google') && (_jsx("button", { type: "button", className: authStyles.oauthButton, disabled: loginBusy, onClick: () => beginOAuthLogin('google', nextTarget), "aria-label": "Continue with Google", children: "Google" })), availableAuthProviders.includes('github') && (_jsx("button", { type: "button", className: authStyles.oauthButton, disabled: loginBusy, onClick: () => beginOAuthLogin('github', nextTarget), "aria-label": "Continue with GitHub", children: "GitHub" })), availableAuthProviders.includes('apple') && (_jsx("button", { type: "button", className: authStyles.oauthButton, disabled: loginBusy, onClick: () => beginOAuthLogin('apple', nextTarget), "aria-label": "Continue with Apple", children: "Apple" }))] })] })), authMode === 'invite' && inviteResolution === 'new_user' && inviteOAuthProviders.length > 0 && (_jsxs("div", { className: authStyles.oauthProviders, children: [_jsx("div", { className: authStyles.oauthDivider, children: _jsx("span", { children: "or join with" }) }), _jsxs("div", { className: authStyles.oauthButtons, children: [inviteOAuthProviders.includes('google') && (_jsx("button", { type: "button", className: authStyles.oauthButton, disabled: loginBusy, onClick: () => beginOAuthLogin('google', '/', inviteToken), "aria-label": "Join with Google", children: "Google" })), inviteOAuthProviders.includes('github') && (_jsx("button", { type: "button", className: authStyles.oauthButton, disabled: loginBusy, onClick: () => beginOAuthLogin('github', '/', inviteToken), "aria-label": "Join with GitHub", children: "GitHub" })), inviteOAuthProviders.includes('apple') && (_jsx("button", { type: "button", className: authStyles.oauthButton, disabled: loginBusy, onClick: () => beginOAuthLogin('apple', '/', inviteToken), "aria-label": "Join with Apple", children: "Apple" }))] })] })), authMode === 'register' && (_jsxs("p", { className: authStyles.registerConsent, children: ["By creating an account, you agree to the", ' ', _jsx("a", { className: authStyles.registerConsentLink, href: "https://taskforcehq.ai/legal/terms/", target: "_blank", rel: "noopener noreferrer", children: "Terms of Service" }), ' ', "and acknowledge the", ' ', _jsx("a", { className: authStyles.registerConsentLink, href: "https://taskforcehq.ai/legal/privacy/", target: "_blank", rel: "noopener noreferrer", children: "Privacy Policy" }), "."] })), _jsxs("div", { className: authStyles.authSecondaryActions, role: "group", "aria-label": "Authentication navigation", children: [directRegistrationEnabled && (authMode === 'login' || authMode === 'register') && (_jsxs("p", { className: authStyles.authModeSwitch, children: [authMode === 'login' ? 'Need an account?' : 'Already have an account?', ' ', _jsx("button", { className: authStyles.authModeSwitchLink, disabled: loginBusy, "data-testid": "auth-switch-mode-button", onClick: () => {
                                                 setLoginError(null);
                                                 setLoginErrorCode(null);
                                                 setLoginNotice(null);
@@ -1683,14 +1726,14 @@ function TaskforceCoreWithRouter({ config = {}, initialTaskId, onTaskCountChange
                                                 if (isCreateWorkspaceIntent) {
                                                     await refreshSetupContext();
                                                     await fetchTasks(true);
-                                                    navigate('/', { replace: true });
+                                                    navigateToPostAuthTarget(nextTarget, { replace: true });
                                                 }
                                             }
                                         }
                                         setSetupBusy(false);
                                     }, children: setupPrimaryActionLabel })) : (_jsx("button", { className: styles.submitBtn, disabled: setupBusy, onClick: refreshSetupContext, children: t('setup.retrySetupCheck') }))] })] }) }) }));
     }
-    return (_jsx(StandaloneLayout, { ...taskforceState, onHeaderMouseDown: onHeaderMouseDown, isDragging: isDragging, onClose: onClose }));
+    return (_jsx(StandaloneLayout, { ...taskforceState, initialActivityEntryId: requestedActivityEntryId, onHeaderMouseDown: onHeaderMouseDown, isDragging: isDragging, onClose: onClose }));
 }
 export function TaskforceCore(props) {
     const inRouterContext = useInRouterContext();

package/dist/annotatedAttachments/AnnotatedAttachmentSessionStore.d.ts

@@ -48,6 +48,7 @@ export declare class AnnotatedAttachmentSessionStore {
     update(input: {
         id: string;
         workspaceId: string;
+        taskId?: string | null;
         title?: string | null;
         globalInstruction?: string | null;
         annotations?: AnnotatedAttachmentAnnotation[];

package/dist/annotatedAttachments/AnnotatedAttachmentSessionStore.js

@@ -259,7 +259,8 @@ export class AnnotatedAttachmentSessionStore {
         const updatedAt = normalizeId(input.updatedAt) || new Date().toISOString();
         this.db.prepare(`
             UPDATE annotated_attachment_sessions
-            SET title = ?,
+            SET task_id = ?,
+                title = ?,
                 global_instruction = ?,
                 annotations_json = ?,
                 updated_by_actor_id = ?,
@@ -268,7 +269,7 @@ export class AnnotatedAttachmentSessionStore {
               AND workspace_id = ?
               AND id = ?
               AND deleted_at IS NULL
-        `).run(input.title === undefined ? existing.title : normalizeNullable(input.title), input.globalInstruction === undefined ? existing.globalInstruction : normalizeNullable(input.globalInstruction), JSON.stringify(input.annotations === undefined ? existing.annotations : input.annotations), input.updatedByActorId === undefined ? existing.updatedByActorId : normalizeNullable(input.updatedByActorId), updatedAt, this.tenantId, normalizeWorkspaceId(input.workspaceId), normalizeId(input.id));
+        `).run(input.taskId === undefined ? existing.taskId : normalizeId(input.taskId), input.title === undefined ? existing.title : normalizeNullable(input.title), input.globalInstruction === undefined ? existing.globalInstruction : normalizeNullable(input.globalInstruction), JSON.stringify(input.annotations === undefined ? existing.annotations : input.annotations), input.updatedByActorId === undefined ? existing.updatedByActorId : normalizeNullable(input.updatedByActorId), updatedAt, this.tenantId, normalizeWorkspaceId(input.workspaceId), normalizeId(input.id));
         return this.get(input.id, input.workspaceId);
     }
     softDelete(sessionIdRaw, workspaceIdRaw, deletedAtRaw) {

package/dist/annotatedAttachments/commandService.d.ts

@@ -0,0 +1,68 @@
+import type { AnnotatedAttachmentAnnotation, AnnotatedAttachmentAnnotationKind, AnnotatedAttachmentSession } from './types.js';
+export declare class AnnotatedAttachmentCommandError extends Error {
+    readonly code: string;
+    readonly statusCode: number;
+    readonly details?: Record<string, unknown>;
+    constructor(message: string, code?: string, statusCode?: number, details?: Record<string, unknown>);
+}
+export interface AnnotatedAttachmentCommandServiceDependencies {
+    getSession(input: {
+        workspaceId: string;
+        sessionId: string;
+    }): AnnotatedAttachmentSession | null;
+    createSession(input: {
+        workspaceId: string;
+        taskId?: string | null;
+        baseImageAssetId: string;
+        title?: string | null;
+        globalInstruction?: string | null;
+        actorId?: string | null;
+    }): AnnotatedAttachmentSession;
+    updateSession(input: {
+        workspaceId: string;
+        sessionId: string;
+        title?: string | null;
+        globalInstruction?: string | null;
+        annotations?: AnnotatedAttachmentAnnotation[];
+        actorId?: string | null;
+    }): AnnotatedAttachmentSession;
+    generateAnnotationId(): string;
+}
+export interface AnnotatedAttachmentCommandContext {
+    workspaceId: string;
+    actorId?: string | null;
+}
+export interface AnnotatedAttachmentCommandMetadata {
+    sessionId: string;
+    imageAssetId: string;
+    taskId: string | null;
+    markerId?: string;
+    markerCount?: number;
+    kind?: AnnotatedAttachmentAnnotationKind;
+    reusedSession?: boolean;
+    toIndex?: number;
+}
+export type AnnotatedAttachmentSessionCommandResult = {
+    session: AnnotatedAttachmentSession;
+    metadata: AnnotatedAttachmentCommandMetadata;
+};
+export type AnnotatedAttachmentMarkerCommandResult = AnnotatedAttachmentSessionCommandResult & {
+    marker: AnnotatedAttachmentAnnotation;
+};
+export type AnnotatedAttachmentMarkersCommandResult = AnnotatedAttachmentSessionCommandResult & {
+    markers: AnnotatedAttachmentAnnotation[];
+};
+export type DeleteAnnotatedAttachmentMarkerCommandResult = AnnotatedAttachmentSessionCommandResult & {
+    deletedMarkerId: string;
+};
+export declare function createAnnotatedAttachmentCommandService(deps: AnnotatedAttachmentCommandServiceDependencies): {
+    reviewImage(context: AnnotatedAttachmentCommandContext, input: Record<string, unknown> & {
+        imageAssetId: string;
+        taskId?: string | null;
+    }): AnnotatedAttachmentMarkersCommandResult;
+    addMarker(context: AnnotatedAttachmentCommandContext, input: Record<string, unknown>): AnnotatedAttachmentMarkerCommandResult;
+    bulkAddMarkers(context: AnnotatedAttachmentCommandContext, input: Record<string, unknown>): AnnotatedAttachmentMarkersCommandResult;
+    updateMarker(context: AnnotatedAttachmentCommandContext, input: Record<string, unknown>): AnnotatedAttachmentMarkerCommandResult;
+    reorderMarker(context: AnnotatedAttachmentCommandContext, input: Record<string, unknown>): AnnotatedAttachmentSessionCommandResult;
+    deleteMarker(context: AnnotatedAttachmentCommandContext, input: Record<string, unknown>): DeleteAnnotatedAttachmentMarkerCommandResult;
+};